开关产品功能定义

更新时间:2023-07-06 05:53:24下载pdf

定义产品功能,是产品开发的第一步。

您现在正在阅览的,是一篇不完全公开的文档,这表示该文档内容的适用性有一定的限制,文档或目录所描述的内容适用于旧版本 SDK、API、工具、平台等。
如果您需要更准确的技术文档,请访问 涂鸦 IoT 开发平台,然后自行搜索。

产品功能由三部分组合完成,包括标准功能、自定义功能及云功能。

标准功能

标准功能 :是指该类别下提供的常用且标准化后的功能。

DP ID 功能点 标识符 数据传输类型 功能点类型 功能点属性 备注
1 开关 switch_1 可下发可上报 布尔型
2 开关2 switch_2 可下发可上报 布尔型
3 开关3 switch_3 可下发可上报 布尔型
4 开关4 switch_4 可下发可上报 布尔型
5 开关5 switch_5 可下发可上报 布尔型
6 开关6 switch_6 可下发可上报 布尔型
7 开关1倒计时 countdown_1 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
8 开关2倒计时 countdown_2 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
9 开关3倒计时 countdown_3 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
10 开关4倒计时 countdown_4 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
11 开关5倒计时 countdown_5 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
12 开关6倒计时 countdown_6 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
:仅Zigbee协议的数值范围为0-43200
13 总开关 可下发可上报 布尔型
14 上电状态设置 relay_status 可下发可上报 枚举型 枚举值off, on, memory
15 指示灯状态设置 light_mode 可下发可上报 枚举型 枚举值none, relay, pos
16 背光开关 switch_backlight 可下发可上报 布尔型
17 循环定时 cycle_time 可下发可上报 字符型 字符型仅适用于Wi-Fi和Wi-Fi+BLE协议
Zigbee协议请使用RAW类型系统DP209
18 随机定时 random_time 可下发可上报 字符型 字符型仅适用于Wi-Fi和Wi-Fi+BLE协议
Zigbee协议请使用RAW类型系统DP210
19 点动开关 switch_inching 可下发可上报 字符型
20 增加电量 add_ele 可下发可上报 数值型 数值范围:0-50000, 间距:100, 倍数:3, 单位:kwh
21 当前电流 cur_current 只上报 数值型 数值范围:0-30000, 间距:1, 倍数:0, 单位:mA
22 当前电压 cur_voltage 只上报 数值型 数值范围:0-5000, 间距:1, 倍数:1, 单位:V
23 当前功率 cur_power 只上报 数值型 数值范围:0-50000, 间距:1, 倍数:1, 单位:W
24 产测结果位 test_bit 只上报 数值型 数值范围:0-5, 间距:1, 倍数:0, 单位:
25 电压校准系数 voltage_coe 只上报 数值型 数值范围:0-1000000, 间距:1, 倍数:0, 单位:
26 电流校准系数 electric_coe 只上报 数值型 数值范围:0-1000000, 间距:1, 倍数:0, 单位:
27 功率校准系数 power_coe 只上报 数值型 数值范围:0-1000000, 间距:1, 倍数:0, 单位:
28 电量校准系数 electricity_coe 只上报 数值型 数值范围:0-1000000, 间距:1, 倍数:0, 单位:
29 开关1上电状态设置 relay_status_1 可下发可上报 枚举型 枚举值off, on, memory
30 开关2上电状态设置 relay_status_2 可下发可上报 枚举型 枚举值off, on, memory
31 开关3上电状态设置 relay_status_3 可下发可上报 枚举型 枚举值off, on, memory
32 开关4上电状态设置 relay_status_4 可下发可上报 枚举型 枚举值off, on, memory
33 开关5上电状态设置 relay_status_5 可下发可上报 枚举型 枚举值off, on, memory
34 开关6上电状态设置 relay_status_6 可下发可上报 枚举型 枚举值off, on, memory
209 循环定时 cycle_timing 可下发可上报 RAW型 系统DP
210 随机定时 random_timing 可下发可上报 RAW型 系统DP

DP详情说明

一、开关(必选):DP ID 1~6

开关,支持6路,布尔型DP,0:关,1:开

二、倒计时(必选):DP ID 7~12

开关倒计时,支持6路,数值型DP,Wi-Fi和蓝牙通讯协议支持时间范围为0-24小时、Zigbee通讯协议支持时间范围为0-12小时

三、总开关(可选):DP ID 13

支持开关全开全关,布尔型DP,0:关,1:开

四、上电状态设置(可选):DP ID 14

开关断电上电状态设置,总控功能(不支持每路开关分控),枚举值DP,枚举值:off、on、memory

off——断电:设备断电重新上电后,默认处于断电状态

on——通电:设备断电重新上电后,默认处于通电状态

memory——断电记忆:设备断电重新上电后,通/断电状态与断电前保持一致

五、指示灯状态设置(可选):DP ID 15

指示灯状态设置,总控功能(不支持每路开关分控),枚举值DP,枚举值:none、relay、pos

none——指示灯关闭:默认指示灯关闭

relay——指示灯指示开关状态:开关开、指示灯亮,开关关、指示灯灭,开关和指示灯状态同步

pos——指示灯指示设备位置:开关开、指示灯灭,开关关、指示灯亮,开关和指示灯状态相反,用于在黑暗环境下提示开关所在位置

六、背光开关(可选):DP ID 16

背光开关,控制背光灯开启或关闭,总控功能(不支持每路开关分控),布尔型DP,0:关,1:开

七、循环定时(可选):DP ID 17

循环定时,设置一段总的时间,在此时间段内可以设置开启时间段和关闭时间段,之后将以此时间循环开启和关闭。循环定时主要用于解放劳动力,用于循环浇灌、投食、灯光场景控制等。

Wi-Fi和Wi-Fi+BLE:string类型DP,蓝牙和Zigbee:raw类型DP

八、随机定时(可选):DP ID 18

随机定时,设置一段总的时间,在此时间段内随机开启和关闭设备。随机定时主要用于防盗,当不在家时,通过随机控制室内开关灯来模拟人在家场景,达到防贼的目的。

Wi-Fi和Wi-Fi+BLE:string类型DP,蓝牙和Zigbee:raw类型DP

九、点动开关(可选):DP ID 19

点动开关,设置一个时间段,执行每次开启设备后运行设置的时长后自动关闭的自动化场景,避免频繁设置倒计时。点动开关主要用于走廊、楼道等公共场合。如设置为点动模式(一分钟⾃动关闭)的墙壁开关连接了了⼀盏走廊灯,用户每次经过走廊的时候只需要开灯,一分钟后这个墙壁开关会自动把它关闭,不再需要专门设置倒计时或者手动关灯。

string类型DP

十、电量统计(可选):DP ID 20~28

电量统计功能,总控功能(不支持每路开关分别统计电量)

十一、上电状态设置(可选):DP ID 29~34

开关1~6断电上电状态设置,分控功能(支持每路开关分控),枚举值DP,枚举值:off、on、memory

off——断电:设备断电重新上电后,默认处于断电状态

on——通电:设备断电重新上电后,默认处于通电状态

memory——断电记忆:设备断电重新上电后,通/断电状态与断电前保持一致

自定义功能

自定义功能:如果你的产品功能不在标准功能中,你可以添加自定义功能。 功能点是对产品功能的抽象表示,每种功能都可以通过不同功能类型定义。
开关产品功能定义

云功能

云功能 :目前支持的云功能包括云定时和网页跳转功能。

云定时功能 ,包括设定开关时间及周循环,无需硬件嵌入式开发。

网页跳转功能,主要可用于设置产品购买的微商城、产品使用说明等各种页面。

其他

您可以根据页面指引和产品需求依次完成产品的功能定义。详细介绍如下:

1、标准功能介绍

2、自定义功能介绍

3、云功能介绍