简体中文
简体中文
English
联系我们
注册
登录

涂鸦 IoT 开发平台

layout空间导航

照明产品功能定义

更新时间:2022-03-02 02:05:53下载pdf

标准功能 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

    自定义功能

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

    云功能

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

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