光源产品面板 DP 交互

更新时间:2023-06-15 09:44:30下载pdf

本文介绍光源产品面板 DP(Data Point)交互时,面板下发和设备上报的相关 DP Code 和数据说明。

开关灯

在开关灯时,面板会等待上报后才做出反应。

操作 DP Code 数据 备注
面板下发 switch_led
  • 开灯为:true
  • 关灯为:false
-
设备上报 switch_led
  • 开灯为:true
  • 关灯为:false
-

切换到白光模式

切换到白光时,只会下发模式数据,不会下发白光亮度 DP 及色温 DP。

操作 DP Code 数据 备注
面板下发 work_mode white -
设备上报 work_mode white -

切换到彩光模式

切换到彩光时,只会下发模式数据,不会下发彩光 DP 数据。

操作 DP Code 数据 备注
面板下发 work_mode colour -
设备上报 work_mode colour -

切换到情景模式

切换到情景时,只会下发模式数据,不会下发情景 DP 数据。

操作 DP Code 数据 备注
面板下发 work_mode scene -
设备上报 work_mode scene -

切换到音乐模式

切换到情景时,只会下发模式数据。

操作 DP Code 数据 备注
面板下发 work_mode scene -
设备上报 work_mode scene -

调节白光亮度

可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据,滑动结束时下发亮度 DP。

  • 滑动过程中时:

    操作 DP Code 数据 备注
    面板下发 control_data 例如 100000000000003e803e8 如果产品不支持色温时,色温值面板一般会下发 1000
    设备上报 - - 不需要上报
  • 滑动结束时:

    操作 DP Code 数据 备注
    面板下发 bright_value 例如 1000 -
    设备上报 bright_value 1000 -

单击调节

单击调节会直接下发亮度 DP。

操作 DP Code 数据 备注
面板下发 bright_value 例如 1000 -
设备上报 bright_value 1000 -

调节白光色温

可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据,滑动结束时下发色温 DP。

  • 滑动过程中时:

    操作 DP Code 数据 备注
    面板下发 control_data 例如 100000000000003e803e8 -
    设备上报 - - 不需要上报
  • 滑动结束时:

    操作 DP Code 数据 备注
    面板下发 temp_value 例如 1000 -
    设备上报 temp_value 1000 -

单击调节

单击调节会直接下发色温 DP。

操作 DP Code 数据 备注
面板下发 temp_value 例如 1000 -
设备上报 temp_value 1000 -

调节彩光

彩光 DP 以 颜色模型 HSV 格式下发,可分别进行色度、饱和度、亮度三个分量的调节,每一个分量的调节可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据,滑动结束时下发彩光 DP。

  • 滑动过程中时:

    操作 DP Code 数据 备注
    面板下发 control_data 例如 1000003e803e800000000 -
    设备上报 - - 不需要上报
  • 滑动结束时:

    操作 DP Code 数据 备注
    面板下发 colour_data 例如 000003e803e8 -
    设备上报 colour_data 000003e803e8 -

单击调节

单击调节会直接下发色温 DP。

操作 DP Code 数据 备注
面板下发 colour_data 例如 000003e803e8 -
设备上报 colour_data 000003e803e8 -

切换情景

当页面切换到场景列表页面时,可以进行切换情景操作。

操作 DP Code 数据 备注
面板下发 scene_data 例如 00323200000003e803e800000000 -
设备上报 scene_data 00323200000003e803e800000000 -

在蓝牙 Mesh 下,切换场景时,面板只会下发情景号。

编辑情景

一般可支持用户编辑情景名称、调节模式、调节速度、修改颜色、添加颜色、删除颜色等操作。

在修改颜色时,面板会实时下发调节 DP 以使用户可以预览到灯光的效果,除此之外的其他操作会下发情景 DP,以使用户可以在编辑过程中就可以预览场景的效果。

修改颜色时

操作 DP Code 数据 备注
面板下发 control_data 例如
  • 修改彩光 1000003e803e800000000
  • 修改白光 100000000000003e803e8
-
设备上报 - - 不需要上报

其他操作

操作 DP Code 数据 备注
面板下发 scene_data 例如 00323200000003e803e800000000 -
设备上报 scene_data 00323200000003e803e800000000 -

音乐功能

当面板切换到音乐模式后,有些面板可能会直接打开麦克风,而有些面板会需要用户单击 开始按钮 打开麦克风。在打开麦克风后,当手机接收到有声源输入,则 App 会将声音转为颜色后,下发给设备。

操作 DP Code 数据 备注
面板下发 music_data 例如
  • 彩光 1000003e803e800000000
  • 白光 100000000000003e803e8
-
设备上报 - - 不需要上报

倒计时功能

倒计时功能的作用为在倒计时结束时将灯的开关状态取反。

面板在下发倒计时后,为了保证面板数据与设备同步,一般不会进行倒计时效果处理,设备需要每 30 秒上报一次倒计时数据。

如果在倒计时过程中,设备的开关状态被取反了,则此时设备需要结束倒计时,并上报 0 数值,以使面板展示结束倒计时。

由于蓝牙 Mesh 的特殊性,蓝牙 Mesh 设备在倒计时过程中不需要上报数据,而是面板处理倒计时效果。在倒计时过程中面板不会同步更新设备上报的倒计时。

倒计时设定

操作 DP Code 数据 备注
面板下发 countdown 例如 240 -
设备上报 countdown 240 -

倒计时过程中设备上报

操作 DP Code 数据 备注
设备上报 countdown 210 -

倒计时过程中开关灯

操作 DP Code 数据 备注
设备上报 countdown_data 0 -
设备上报 switch_led true 或 false -