感应灯产品功能定义

标准功能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	只下发	字符型
gamma调试	debug_data	只下发	字符型		适用于gamma校准
生物节律	rhythm_mode	可下发可上报	RAW型
灯光助眠	sleep_mode	可下发可上报	RAW型
灯光唤醒	wakeup_mode	可下发可上报	RAW型
设备模式	device_mode	可下发可上报	枚举型	枚举值: auto, manual	auto：PIR主控，App辅控；manual：App操控，PIR无效
感应状态	pir_state	只上报	枚举型	枚举值: pir, none	pir：有人；none：无人
光敏参数	cds	可下发可上报	枚举型	枚举值: 2000lux, 300lux, 50lux, 10lux, 5lux, now	2000lux：白天；300lux：黄昏；50lux：傍晚；10lux：晚上；5lux：黑夜；now：记录当下环境值（当下电压）
灵敏度	pir_sensitivity	可下发可上报	枚举型	枚举值: low, middle, high	pir感应的灵敏度，不同的灵敏度的直观感受是感应的距离远近与范围大小
感应延时	pir_delay	可下发可上报	数值型	数值范围: 5-3600, 间距: 1, 倍数: 0, 单位: s	当检测到有人后，从有人状态跳变为无人状态算起所持续的时间，延时范围为5s~1h
感应开关	switch_pir	可下发可上报	布尔型		auto模式下：点击某一开关操作可以切换PIR触发状态（禁止PIR触发；允许PIR触发）
伴亮延时	standby_time	可下发可上报	数值型	数值范围: 1-480, 间距: 1, 倍数: 0, 单位: min	从感应延时结束开始算起所持续的时间，延时范围为1min~8h
伴亮亮度值	standby_bright	可下发可上报	数值型	数值范围: 0-1000, 间距: 1, 倍数: 0	在半亮延时状态期间，PIR感应灯的亮度，当值为0%时，表示无半亮
组内感应同步	sensorgroup_sync	可下发可上报	布尔型
微亮常亮开	standby_on	可下发可上报	布尔型

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

DP29(10)：gamma调试

类型：字符串
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）

示例：{“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~72
起始小时	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~72
起始小时	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

感应功能说明

功能点	功能说明
设备模式	APP：手动模式，此模式下不进行感应灯控，灯光调节使用APP进行操控。 AUTO_SENSE：感应模式，该模式进行PIR感应灯控，主控灯及报警铃、报警灯根据PIR感应状态实时输出（备注：当前环境光低于感应灯光设定阈值） ON_WITH_SENSE：灯常亮，亮度默认值100%，8小时后转AUTO_SENSE模式。灯常亮时上报相应dp点模式为APP，常亮结束后上报AUTO_SENSE。灯常亮时可以使用APP手动调光，调光后强改灯控模式为APP模式，8小时计时不再执行。该模式不需要掉电记忆，断电重启后的灯控模式根据断电前灯的状态进行设置，断电前常亮为APP，否则为AUTO_SENSE。（8小时制度是为节能而设计，更多是用于 红外遥控器上的功能） OFF_WITH_SENSE：灯长灭，8小时后转AUTO_SENSE模式。该模式不需要掉电记忆，断电重启后的灯控模式根据断电前灯的状态进行设置，断电前常灭为APP，否则为AUTO_SENSE。
感应状态	PIR感应状态分为预热状态，检测状态，感应恢复状态。 预热状态：PIR传感器上电后，需要经过20s预热，预热阶段，灯光亮度100%，输出的感应信号无效，预热结束后，进入检测状态；（每次上电都需要预热） 检测状态：检测状态下，持续进行PIR感应检测，当PIR由低电平跳变为高电平时识别为有人经过。经过感应时间重新变为低电平时，识别为人离开，常态低电平时，识别为无人经过。 感应恢复状态：在感应状态下，可以强制进行禁止PIR出发，并进入感应恢复倒计时，倒计时每1分钟上报一次，倒计时为0时，重新进入检测状态。
光敏参数	当前光照大于设定阈值时PIR感应无输出，否则输出端跟随PIR感应状态变化。当检测到有人，灯控在感应延时阶段时，光控检测无效，灯光亮度不受当前光线变化的影响。进入半亮延时阶段及无人状态后，光控检测生效，灯光亮度重新受CDS光照阈值设定影响，如果超出设定阈值，半亮延时时间未到，半亮持续5分钟后关闭主控灯光。 CDS光照阈值主要分为如下几档： 白天：<2000LUX 黄昏：<300LUX 傍晚：<50LUX 晚上：<10LUX 黑夜：<5LUX
灵敏度	灵敏度通常表现为感应距离的 远近。通常影响该性能的主要几个因素：主控模块的灵敏度参数、探头感应元的分类、探头窗口的面积、菲尼尔透镜的选型。 目前APP可设定 高、中、低三档灵敏度 参数； 高（100%）：低电平 ； — 8~10M 中（75%）：PWM占空比7%，频率1KHz — 5~7M 低（50%）：PWM占空比16%，频率1KHz— 3~5M PS: 环境温度在 27 ℃下。
感应延时	当检测到有人后，从有人状态跳变为无人状态算起所持续的时间，延时时间可调范围为5s~1h。（可连续触发）
感应开关	在APP模式下，始终不上报，在 PIR 感应模式下，满足感应条件，且触发后，上报有人。人离开后，上报无人。 在无人状态下，主控灯关闭/半亮状态（APP手动模式除外），报警灯及报警铃无输出。 在有人状态下，主控灯打开，报警灯及报警铃有输出，当有人状态变化为无人状态后，在感应延时结束后，上报无人。
伴亮延时	从感应延时结束，进入半亮模式开始算起所持续的时间，延时时间可调范围为1min~8h。
伴亮亮度	在半亮延时状态时PIR感应主控灯的亮度，亮度可调范围为0%，10%~30%，当值为0%时，表示无半亮，感应延时结束后主控灯直接熄灭。

自定义功能

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

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

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

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

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

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

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

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

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

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

云功能

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