灯串功能定义

标准功能DP类型

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

灯串标准DP

标准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	只下发	字符型
场景配置	scene_list	只上报	RAW型
场景选择	scene_select	可下发可上报	RAW型
场景循环	scene_combine	可下发可上报	RAW型
场景重置	scene_factory	可下发可上报	RAW型

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用于面板调节过程中实时数据下发

DP51：场景配置

类型：RAW
Value: 0011112222334444400111122223344444…
00：场景编号（场景库中的编号）
1111：亮度
2222：色温
33：速度档位

示例： {“51”:“1e03e801f400000000c007701f401000001603e801f400000000603e801f420000001d02b501f400000000503e801f430000001903e801f400000000003e801f40000000”}
1e:场景编号（涂鸦场景库编号30）
03e8：亮度1000
01f4：色温500
00：速度档位1，00表示速度第一档，10表示速度第二档，20表示速度第三档，30表示速度第四档，01表示1~4档速度依次循环

备注：
设备联网成功后必须首先进行一次dp点上报，面板端会根据上报的场景序号配出相应的场景界面。

DP52：场景选择

类型：RAW
Value: 00111122223344444

示例：
{“52”:1d03e801f40000000”}
1d：场景编号，1d转成进制是29
03e8:亮度（100%）
01f4：色温
00：速度档位1，00表示速度第一档，10表示速度第二档，20表示速度第三档，30表示速度第四档，01表示1~4档速度依次循环

备注：
该DP用于对某个场景进行参数配置，并使设备进入这个场景

DP53：场景循环

类型：RAW
Value: 00112233445566…
00：场景号，11：场景号，选择多少个场景，就下发多少

示例：
{“53”:0c1d0519”}
0c：场景12
1d：场景29
05：场景5
19：场景25

备注：
选择多少个场景进行循环，则设备收到此指令后, 开始按照选定的场景号循环执行各场景

DP54：场景重置

类型：RAW
Value:00
00：场景号

示例：
{“104”:“25”}
25：场景25

备注：
设备收到此指令后, 将对应场景恢复到默认值，并通过DP：场景选择，进行一次主动上报

自定义功能

如果您的产品功能不在标准功能中，您可以添加自定义功能。 功能点是对产品功能的抽象表示，每种功能都可以通过不同功能类型定义。支持布尔型、数值型、枚举型、故障型、字符型、RAW型。

自定义DP不支持第三方语音和第三方云对接，如果您对我们的标准DP扩充有好的建议，建议提交工单，涂鸦尽快帮您创建标准功能点。

DP ID是该功能的代名词，功能名称用于快速区分该功能所代表的作用。
标识名是产品软件中区分功能的唯一身份。
数据类型根据功能的作用选择相应的类型，包含布尔型、数值型、枚举型、故障型、字符型、RAW型。

布尔型：非真即假的二值型变量，如开关功能；

数值型：可线性调节数值型的功能，如温度调节20-40℃。需要设置数值范围、间距、倍数，倍数值支持设置为0、1、2、3并以10的指数转换进行传输，适用于小数

枚举值：自定义的有限集合值，需要设定枚举值并以回车确认，支持支持数字、字母、下划线，如档位的High、Mid、Low；

故障型：专门用于上报和统计故障的功能点，支持多故障，数据只上报；

字符串型：以字符串形式传输的功能点；

透传型：以二进制形式透传的功能点。

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

云功能

云功能：目前支持的云功能包括云定时和网页跳转功能。
云定时功能，包括设定开关时间及周循环，无需硬件嵌入式开发。
网页跳转功能，主要可用于设置产品购买的微商城、产品使用说明等各种页面。