照明产品功能定义

标准功能 DP 类型

DP 类型包含布尔型、数值型、枚举型、故障型、字符型、RAW 型，详细信息请参考 数据类型。

标准 DP

功能点	标识符	传输类型	功能点类型	功能点属性	备注
开关	switch_led	可下发可上报	布尔型	/	/
模式	work_mode	可下发可上报	枚举型	枚举值：white，colour，scene，music
白光亮度	bright_value	可下发可上报	数值型	取值范围：10~1000 间距：1 倍数：0
冷暖值	temp_value	可下发可上报	数值型	取值范围：10~1000 间距：1 倍数：0	/
彩光	colour_data	可下发可上报	字符型	/	/
情景	scene_data	可下发可上报	字符型	/	/
倒计时	countdown	可下发可上报	数值型	取值范围：0~86400 间距：1 倍数：0 单位：s	/
音乐律动	music_data	只下发	字符型	/	/
实时调节	control_data	只下发	字符型	/	/
gamma 调试	debug_data	只下发	字符型	/	适用于 gamma 校准
生物节律	rhythm_mode	可下发可上报	RAW 型	/	/
灯光助眠	sleep_mode	可下发可上报	RAW 型	/	/
灯光唤醒	wakeup_mode	可下发可上报	RAW 型	/
断电记忆	power_memory	可下发可上报	RAW 型	/	通电后，灯亮起的状态
停电勿扰	do_not_disturb	可下发可上报	布尔型	/	适用于经常停电区域。开启停电勿扰后，通过 App 关灯后需连续两次上电才会亮灯
循环定时	cycle_timing	可下发可上报	RAW 型	/	灯光循环亮灭满足植物照明等场景
随机定时	random_timing	可下发可上报	RAW 型	/	灯光随机亮灭模拟有人在家的场景

DP 详情说明：

DP20(1)：开关（必选）

数据类型	取值范围	示例
布尔型	true：打开 false：关闭	{“20”:true}

DP21(2)：模式（必选）

数据类型	取值范围	示例
枚举型	white：白光模式 colour：彩光模式 scene：场景 music：音乐灯	{“21”:“scene”}

注意事项
白光、彩光、场景、音乐灯的菜单栏由 DP 点决定：

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

DP22(3)：白光亮度

数据类型	取值范围	示例
数值型	10~1000 说明：亮度值 10~1000 对应实际亮度为 1%-100%，且最低亮度显示为 1%。	{“22”:670 "}

DP23(4)：冷暖值

数据类型	取值范围	示例
数值型	0~1000 说明：色温范围 0~1000，对应实际色温 0%~100%。色温值分别对应最暖和最冷的范围取值，实际的色温值依赖于硬件的灯珠规格，比如 2700K-6500K。	{“23”:797"}

DP24(5)：彩光

数据类型	取值范围	示例
字符型	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)：情景

数据类型	取值范围	示例
数值型	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） 注意：情景号 00 后的一串数字 11223344445555666677778888 代表一个颜色单元数据，出现连续多少串数字代表有多少个颜色单元数据。	{“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)：倒计时

数据类型	取值范围	示例
数值型	0~86400，单位为秒。 对应一分钟取值为 60，最大值 86400 等于 23 小时 59 分钟。	{“26”:“120”}

DP27(8)：音乐律动

数据类型	取值范围	示例
字符串	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”} 1：变化方式，1 表示渐变 0076：H（色度： 0X0076） 03e8：S (饱和：0X03e8) 03e8：：V (明度： 0X03e8) 0012：亮度（18%） 0025：色温（37%）

说明：该功能点和模式功能点共同决定是否显示音乐灯。

DP28(9)：实时调节

数据类型	取值范围	示例
字符串	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 用于面板调节过程中实时数据下发

DP29(10)：gamma 调试

数据类型	取值范围	示例
字符串	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）	{“29”:“1007603e803e800120025”} 1：变化方式， 1 表示渐变 0076：H（色度： 0X0076） 03e8：S (饱和：0X03e8) 03e8：：V (明度： 0X03e8) 0012：亮度（18%） 0025：色温（37%）

说明：该 DP 用于 gamma 调试，需配合 gamma 调试专用面板使用。

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：停电勿扰

数据类型	取值范围	示例
布尔型	true：打开 false：关闭	{“34”:true}

DP209 ：循环定时

协议字段说明

序号	字段	节点	长度（byte）	描述
1	版本号	/	1	0x00: 初始版本
2	节点长度	/	1	单个节点的数据长度, 最大值为 255
3	开关+通道号	节点 1	1	bit0: 本节点开关 bit1~bit7：本节点影响的通道 举例: 0x03----0000 0011 ----通道/节点 1 处于 打开/有效 状态
4	星期	节点 1	1	某天生效，相应位置 1。具体的字节位参照 日期说明
5	起始时间	节点 1	2	以 1min 为单位时间，最大值 1439
6	结束时间	节点 1	2	以 1min 为单位时间，最大值 1439
7	开启时长	节点 1	2	以 1min 为单位时间，最大值 1439
8	关闭时长	节点 1	2	以 1min 为单位时间，最大值 1439
9	色调（H）	节点 1	2	0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360
10	饱和度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
11	明度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
12	亮度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
13	色温百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
…	…	…	…	…

注意：如果有多个节点，则序号 3～13 字段重复。

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

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

DP210 ：随机定时

协议字段说明

序号	字段	节点	长度（byte）	描述
1	版本号	/	1	0x00: 初始版本
2	节点长度	/	1	单个节点的数据长度, 最大值为 255
3	开关+通道号	节点 1	1	bit0: 本节点开关 bit1~bit7：本节点影响的通道 举例: 0x03----0000 0011 ----通道/节点 1 处于 打开/有效 状态
4	星期	节点 1	1	某天生效，相应位置 1。具体的字节位参照 日期说明
5	起始时间	节点 1	2	以 1min 为单位时间，最大值 1439
6	结束时间	节点 1	2	以 1min 为单位时间，最大值 1439
7	色调（H）	节点 1	2	0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360
8	饱和度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
9	明度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
10	亮度百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
11	色温百分比	节点 1	1	0x10：hex 码，16%；取值范围：0~100
…	…	…	…	…

注意：如果有多个节点，则序号 3～13 字段重复。

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

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

自定义功能

如果你的产品功能不在标准功能中，你可以添加自定义功能，详情请参考 产品智能化 - 自定义功能。

云功能

目前支持的云功能包括云定时和网页跳转功能，详情请参考 产品智能化 - 云功能。

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