射灯产品功能定义

更新时间:2022-03-02 02:05:41下载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 校准

DP详情说明:

DP20(1):开关(必选)

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

DP21(2):模式(必选)

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

模式 DP 说明

白光、彩光、场景、音乐灯在面板中的 Tab 栏,由 DP 点决定:

  • “白光”菜单栏:模式 DP 和亮度 DP 共同决定
  • “彩光”菜单栏:模式 DP 和颜色 DP 共同决定
  • “场景”菜单栏:模式 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)
    说明:1~8 这一串数据表示一个颜色单元的数据,如果有多组颜色,就会有多组 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):倒计时

数据类型 取值范围 示例
数值型 0~86400
  • 0:表示关闭
  • 其他数值:单位为秒,最大取值 86400 等于 23 小时 59 分钟
{“26”:“120”}
120 秒,即 2 分钟

说明:该功能点决定是否出现倒计时功能。

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:表示渐变
  • 0076:H(色度: 0X0076)
  • 03e8:S (饱和:0X03e8)
  • 03e8:V (明度: 0X03e8)
  • 0012:亮度(18%)
  • 0025:色温(37%)

说明:该 DP 和模式 DP 共同决定是否显示音乐灯。

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)
{“27”:“1007603e803e800120025”}
  • 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)
{“27”:“1007603e803e800120025”}
  • 1:表示渐变
  • 0076:H(色度: 0X0076)
  • 03e8:S (饱和:0X03e8)
  • 03e8:V (明度: 0X03e8)
  • 0012:亮度(18%)
  • 0025:色温(37%)

说明:该 DP 用于 Gamma 调试,需配合 Gamma 调试专用面板使用。

自定义功能

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

云功能

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

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