灯带产品功能定义

更新时间:2023-07-17 09:22:53下载pdf

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

标准功能DP类型

DP类型包含布尔型、数值型、枚举型、故障型、字符型、RAW型。
布尔型:非真即假的二值型变量,如开关功能;
数值型:可线性调节数值型的功能,如温度调节20-40℃;
枚举值:自定义的有限集合值,如档位的高、中、低;
故障型:专门用于上报和统计故障的功能点,支持多故障,数据只上报;
字符串型:以字符串形式传输的功能点;
透传型:以二进制形式透传的功能点。

标准DP

功能点 标识符 传输类型 功能点类型 功能点属性 备注
开关 switch_led 可下发可上报 布尔型
模式 work_mode 可下发可上报 枚举型 枚举值:white, colour, scene, music
白光亮度 bright_value 可下发可上报 数值型 数值范围:10-1000, 间距:1, 倍数:0
冷暖值 temp_value 可下发可上报 数值型 数值范围:0-1000, 间距:1, 倍数:0
彩光 colour_data 可下发可上报 字符型
情景 scene_data 可下发可上报 字符型
倒计时 countdown 可下发可上报 数值型 数值范围:0-86400, 间距:1, 倍数:0, 单位:s
音乐律动 music_data 只下发 字符型
实时调节 control_data 只下发 字符型
生物节律 rhythm_mode 可下发可上报 RAW型
灯光助眠 sleep_mode 可下发可上报 RAW型
灯光唤醒 wakeup_mode 可下发可上报 RAW型
断电记忆 power_memory 可下发可上报 RAW型 通电后,灯亮起的状态
停电勿扰 do_not_disturb 可下发可上报 布尔型 适用经常停电区域,开启停电勿扰,通过APP关灯需连续两次上电才会亮灯
麦克风音乐律动 mic_music_data 可下发可上报 字符型 设备的外置麦克风获取环境的声音,灯光律动变化

DP详情说明:

DP20(1):开关(必选)

类型:布尔
Value: true/false 打开/关闭

示例:{“20”:true}

DP21(2):模式(必选)

类型:枚举
Value: ”white”/”colour”/”scene”/”music”
白光模式/彩光模式/场景/音乐灯

示例:{“21”:“scene”}

备注:
白光、彩光、场景、音乐灯的TAB栏,由DP点决定:
“白光”菜单栏:模式和亮度DP共同决定
“彩光”菜单栏:模式和颜色DP共同决定
“场景”菜单栏:模式和情境DP共同决定
“音乐灯”菜单栏:模式和音乐灯DP共同决定
“倒计时”:由倒计时DP点决定
“定时”:由云功能的,云端定时决定

DP22(3):白光亮度

类型:数值
Value:10 – 1000

示例:{“22”:670 "}

备注:
亮度值10-1000,对应实际亮度1%-100%,最低亮度显示为1%

DP23(4):冷暖值

类型:数值
Value: 0-1000

示例:{“23”:797"}

备注:
色温范围0-1000,对应实际色温0%-100%,分别对应最暖和最冷的范围取值,实际的色温值依赖于硬件的灯珠规格,比如2700K-6500K

DP24(5):彩光

类型:字符
Value: 000011112222
0000:H(色度:0-360,0X0000-0X0168)
1111:S (饱和:0-1000, 0X0000-0X03E8)
2222:V (明度:0-1000,0X0000-0X03E8)

示例:{“24”:“00DC004B004E”}

HSV (H,S,V): (HEX)(00DC, 004B,004E),转换为(DEC)为(220度,75%,78%)

备注:
颜色按照HSV体系传输,也可以通过算法转换为RGB颜色体系参考网址
可以获得RGB (R,G,B): (HEX)(32,64,C8),(DEC)(50,100,200)

DP25(6):情景

类型:字符
Value: 0011223344445555666677778888
00:情景号
11:单元切换间隔时间(0-100)
22:单元变化时间(0-100)
33:单元变化模式(0静态 1跳变 2渐变)
4444:H(色度:0-360,0X0000-0X0168)
5555:S (饱和:0-1000, 0X0000-0X03E8)
6666:V (明度:0-1000,0X0000-0X03E8)
7777:白光亮度(0-1000)
8888:色温值(0-1000)
注:数字1-8的标号对应有多少单元就有多少组

示例:{“25”:“010b0a02000003e803e8000000000b0a02007603e803e8000000000b0a0200e703e803e800000000”}

01:情景号01
0b:单元切换间隔时间(0)
0a:单元变化时间(10)
02:单元变化模式:渐变
0000:H(色度:0X0000)
03e8:S (饱和:0-1000, 0X0000-0X03E8)
03e8:V (明度:0-1000,0X0000-0X03E8)
0000:白光亮度(0-1000)
0000:色温值(0-1000)

DP26(7):倒计时

类型:数值
Value: 0-86400
数据单位秒,对应一分钟取值60,最大设置86400=23小时59分钟
0表示关闭

示例:{“26”:“120”}
120秒,即2分钟

备注:
该功能点决定是否出现倒计时功能

DP27(8):音乐律动

类型:字符串
Value: 011112222333344445555
0: 变化方式,0表示直接输出,1表示渐变
1111:H(色度:0-360,0X0000-0X0168)
2222:S (饱和:0-1000, 0X0000-0X03E8)
3333:V (明度:0-1000,0X0000-0X03E8)
4444:白光亮度(0-1000)
5555:色温值(0-1000)

示例:{“27”:“1007603e803e800120025”}

0: 变化方式,0表示直接输出,1表示渐变
示例说明:
1: 变化方式, 1表示渐变
0076:H(色度: 0X0076)
03e8:S (饱和:0X03e8)
03e8::V (明度: 0X03e8)
0012:亮度(18%)
0025:色温(37%)

备注:
该功能点和模式功能点一起,决定是否显示音乐灯

DP28(9):实时调节

类型:字符串
Value: 011112222333344445555
0: 变化方式,0表示直接输出,1表示渐变
1111:H(色度:0-360,0X0000-0X0168)
2222:S (饱和:0-1000, 0X0000-0X03E8)
3333:V (明度:0-1000,0X0000-0X03E8)
4444:白光亮度(0-1000)
5555:色温值(0-1000)

示例:{“28”:“1007603e803e800120025”}

1: 变化方式, 1表示渐变
0076:H(色度: 0X0076)
03e8:S (饱和:0X03e8)
03e8::V (明度: 0X03e8)
0012:亮度(18%)
0025:色温(37%)

备注:
该DP用于面板调节过程中实时数据下发

DP30 :生物节律

类型:RAW型

协议字段设计如下

版本号 任务开关 选择模式 日期设定 节点数 节点1 节点N
1byte:0x00 1byte 1byte 1byte 1byte 9byte 9byte

注:0x01版本协议增加1个字节"参数模式"字段

版本号 任务开关 选择模式 日期设定 参数模式 节点数 节点1 节点N
1byte:0x01 1byte 1byte 1byte 1byte:
0x01:仅含BT
0x02:仅含HSV
0x03:含HSVBT
1byte 5~9byte 5~9byte

协议字段说明

字段 序号 节点 长度 数据代表说明
版本号 1 / 1byte 0x00:初始版本
任务开关 2 / 1byte 0x00:任务关闭,0x01:任务打开
模式选择 3 / 1byte 0x00:两节点之间一直渐变,0x0F:到达节点时间后开始渐变,渐变完成时间为该字段值。最小允许值15。如:0x0F表示节点时间到达后15分钟完成渐变
日期设定 4 / 1byte 解析具体的字节位,某天生效,相应位置1,见后文日期说明
节点个数 5 / 1byte 0x01:1个节点。范围允许值1~8
节点开关 6 节点1 1byte 节点开关优先级低于任务开关,只有任务开关开启的情况下才判断节点开关的状态。0x00:节点禁能,不生效;0x01:节点使能,生效
小时 6 节点1 1byte 0x10:hex码,16点,范围允许值0~23
分钟 6 节点1 1byte 0x10:hex码,16分,范围允许值0~59
色调 6 节点1 2byte 0x03, 0x10:hex码。大端格式,第一个字节表示百位,第二个字节表示十位,个位。实际值表示316,范围允许值0~360
饱和度百分比 6 节点1 1byte 0x10:hex码,16%;范围允许值0~100
明度百分比 6 节点1 1byte 0x10:hex码,16%;范围允许值1~100
亮度百分比 6 节点1 1byte 0x10:hex码,16%;范围允许值1~100
色温百分比 6 节点1 1byte 0x10:hex码,16%;范围允许值0~100
/ 7 节点2 / /
/ 13 节点8 / /

日期说明
如果全0,表示单次模式,只生效一次;否则为循环模式,判断相应位是否置1,位置1表示当天生效。如0x42表示任务在星期六和星期一生效(注意必须保证相应的任务开关是处于开启状态)

保留 星期六 星期五 星期四 星期三 星期二 星期一 星期日
bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0

DP31 :灯光助眠

协议字段说明

字段 序号 节点 长度 数据代表说明
版本号 1 / 1byte 0x00:初始版本
任务节点数 2 / 1byte 0x01:1个节点;0x02:2个节点;0x03:3个节点;0x04:4个节点
任务开关 3 节点1 1byte 0x00:任务关闭;0x01:任务打开
日期设定 3 节点1 1byte 解析具体的字节位,某天生效,相应位置1,见后文日期说明
渐变步进值 3 节点1 1byte 0x10:hex码,5分钟一个步进,16*5=90分钟渐变时长。范围允许值1~24
起始小时 3 节点1 1byte 0x10:hex码,16点。范围允许值0~23
起始分钟 3 节点1 1byte 0x10:hex码,16分。范围允许值0~59
色调 3 节点1 2byte 0x03, 0x10:hex码。大端格式,第一个字节表示百位,第二个字节表示十位,个位。实际值表示316,范围允许值0~360
饱和度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值0~100
明度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值1~100
亮度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值1~100
色温百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值0~100
/ 4 节点2 / /
/ 6 节点4 / /

日期说明
如果全0,表示单次模式,只生效一次;否则为循环模式,判断相应位是否置1,位置1表示当天生效。如0x42表示任务在星期六和星期一生效(注意必须保证相应的任务开关是处于开启状态)

保留 星期六 星期五 星期四 星期三 星期二 星期一 星期日
bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0

DP32 :灯光唤醒

协议字段说明

字段 序号 节点 长度 数据代表说明
版本号 1 / 1byte 0x00:初始版本
任务节点数 2 / 1byte 0x01:1个节点;0x02:2个节点;0x03:3个节点;0x04:4个节点
任务开关 3 节点1 1byte 0x00:任务关闭;0x01:任务打开
日期设定 3 节点1 1byte 解析具体的字节位,某天生效,相应位置1,见后文日期说明
渐变步进值 3 节点1 1byte 0x10:hex码,5分钟一个步进,16*5=90分钟渐变时长。范围允许值1~24
起始小时 3 节点1 1byte 0x10:hex码,16点。范围允许值0~23
起始分钟 3 节点1 1byte 0x10:hex码,16分。范围允许值0~59
色调 3 节点1 2byte 0x03, 0x10:hex码。大端格式,第一个字节表示百位,第二个字节表示十位,个位。实际值表示316,范围允许值0~360
饱和度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值0~100
明度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值1~100
亮度百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值1~100
色温百分比 3 节点1 1byte 0x10:hex码,16%;范围允许值0~100
维持时间 3 节点1 1byte 0x10:hex码,5分钟一个步进。渐变完成后再持续该时间后关灯。范围允许值 0~24, 0 表示不关灯,24表示120分钟后关灯
/ 4 节点2 / /
/ 6 节点4 / /

日期说明
如果全0,表示单次模式,只生效一次;否则为循环模式,判断相应位是否置1,位置1表示当天生效。如0x42表示任务在星期六和星期一生效(注意必须保证相应的任务开关是处于开启状态)

保留 星期六 星期五 星期四 星期三 星期二 星期一 星期日
bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0

DP33:断电记忆

协议字段设计如下

字段 长度 数据代表说明
版本号 1byte 0x00:初始版本
模式 1byte 0x00 初始默认值,0x01 恢复记忆值,0x02 用户定制
H 2byte Hue
S 2byte Saturation
V 2byte Value
Bright 2byte Brightness
Temperature 2byte Temperature

DP34:停电勿扰

类型:布尔
Value: true/false 打开/关闭

示例:{“34”:true}

DP42:麦克风音乐律动

类型:字符
Value: 0011223344556666777766667777…66667777
00:版本
11:0-关闭,1-打开
22 模式编号,自定义从201开始
33 变换方式:0 - 呼吸模式,1 -跳变模式 , 2 - 经典模式
44 变化速度
55 灵敏度
6666:颜色1-色相
7777:颜色1-饱和度
数字6和7的标号对应有多少单元就有多少组

示例:{“42”:“000100016432000003e8007803e800f003e8003c03e800b403e8012c03e8”}

00:版本0
01:打开
00:模式编号0
01:变换方式为跳变模式
64:变化速度100%
32:灵敏度50%
0000:颜色1-色相
03e8:颜色1-饱和度
0078:颜色2-色相
03e8:颜色2-饱和度

012c:颜色6-色相
03e8:颜色6-饱和度

自定义功能

如果你的产品功能不在标准功能中,你可以添加自定义功能。 功能点是对产品功能的抽象表示,每种功能都可以通过不同功能类型定义。支持布尔型、数值型、枚举型、故障型、字符型、RAW型。
自定义DP不支持第三方语音和第三方云对接,如果您对我们的标准DP扩充有好的建议,建议提交工单,涂鸦尽快帮您创建标准功能点。
灯带产品功能定义
DP ID是该功能的代名词,功能名称用于快速区分该功能所代表的作用。
标识名是产品软件中区分功能的唯一身份。
数据类型根据功能的作用选择相应的类型,包含布尔型、数值型、枚举型、故障型、字符型、RAW型。
布尔型:非真即假的二值型变量,如开关功能;
灯带产品功能定义
数值型:可线性调节数值型的功能,如温度调节20-40℃。需要设置数值范围、间距、倍数,倍数值支持设置为0、1、2、3并以10的指数转换进行传输,适用于小数
灯带产品功能定义
枚举值:自定义的有限集合值,需要设定枚举值并以回车确认,支持支持数字、字母、下划线,如档位的High、Mid、Low;
灯带产品功能定义
故障型:专门用于上报和统计故障的功能点,支持多故障,数据只上报;
灯带产品功能定义
字符串型:以字符串形式传输的功能点;
灯带产品功能定义
透传型:以二进制形式透传的功能点。
灯带产品功能定义

数据传输类型分为可下发可上报、只上报、只下发,根据产品功能以及面板需要展现的内容进行选择。
可下发可上报:指令数据可以下发给设备,设备数据可以上报给云端;
只上报:数据只支持从设备上报;
只下发:数据只支持从云端下发。

灯带产品功能定义

云功能

云功能:目前支持的云功能包括云定时和网页跳转功能。
云定时功能,包括设定开关时间及周循环,无需硬件嵌入式开发。
网页跳转功能,主要可用于设置产品购买的微商城、产品使用说明等各种页面。
![image.png](https://airtake-public-data-1254153901.cos.ap-shanghai.myqcloud.com/goat/20200520/b57b8379ba6240119f73c89e98134