Panel DP Description

This topic describes the DP data that is required to implement the interaction with a lighting product. During the interaction, a panel sends a DP command. The target device acts on the command and reports the DP status that is reflected on the panel.

Turn on/off light

After a DP command is sent to turn on/off a light, the panel can reflect the reported DP status only after the DP status is received.

Operation	Identifier	Data	Remarks
Cloud-to-device	switch_led	true: Turn on the light false: Turn off the light	-
Device-to-cloud	switch_led	true: Turn on the light false: Turn off the light	-

Switch to white light mode

To switch to the white light mode, only the DP work_mode is sent. The DPs to control brightness and color temperature are not sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	work_mode	white	-
Device-to-cloud	work_mode	white	-

Switch to colored light mode

To switch to the colored light mode, only the DP work_mode is sent. Other DPs to control colored light are not sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	work_mode	colour	-
Device-to-cloud	work_mode	colour	-

Switch to scene mode

To switch to the scene mode, only the DP work_mode is sent. Other DPs to control the scene mode are not sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	work_mode	scene	-
Device-to-cloud	work_mode	scene	-

Switch to music mode

To switch to the scene mode, only the DP work_mode is sent. Other DPs to control the scene mode are not sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	work_mode	scene	-
Device-to-cloud	work_mode	scene	-

Adjust brightness of white light

The brightness can be adjusted by sliding and tapping.

By sliding

The adjustment DP is sent at an interval of 300 ms during the sliding process. At the end of sliding, the brightness DP is sent.

• During sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	control_data	Example: 100000000000003e803e8	If the product does not support color temperature, the color temperature panel sends the DP value 1000 in most cases.
  Device-to-cloud	-	-	Send only

• At the end of sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	bright_value	Example: 1000	-
  Device-to-cloud	bright_value	1000	-

By tapping

The brightness DP is sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	bright_value	Example: 1000	-
Device-to-cloud	bright_value	1000	-

Adjust color temperature of white light

The brightness can be adjusted by sliding and tapping.

By sliding

The adjustment DP is sent at an interval of 300 ms during the sliding process. At the end of sliding, the color temperature DP is sent.

• During sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	control_data	Example: 100000000000003e803e8	-
  Device-to-cloud	-	-	Send only

• At the end of sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	temp_value	Example: 1000	-
  Device-to-cloud	temp_value	1000	-

By tapping

The color temperature DP is sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	temp_value	Example: 1000	-
Device-to-cloud	temp_value	1000	-

Adjust colored light

The colored light DP is sent in the format of the hue, saturation, and value (HSV) color model. The hue, saturation, and value are respectively adjusted with the DP by sliding and tapping.

By sliding

The adjustment DP is sent at an interval of 300 ms during the sliding process. At the end of sliding, the colored light DP is sent.

• During sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	control_data	Example: 1000003e803e800000000	-
  Device-to-cloud	-	-	Send only

• At the end of sliding

  Operation	Identifier	Data	Remarks
  Cloud-to-device	colour_data	Example: 000003e803e8	-
  Device-to-cloud	colour_data	000003e803e8	-

By tapping

The color temperature DP is sent.

Operation	Identifier	Data	Remarks
Cloud-to-device	colour_data	Example: 000003e803e8	-
Device-to-cloud	colour_data	000003e803e8	-

Switch between scenes

Users can switch between scenes when they are navigated to the list of scenes.

Operation	Identifier	Data	Remarks
Cloud-to-device	scene_data	Example: 00323200000003e803e800000000	-
Device-to-cloud	scene_data	00323200000003e803e800000000	-

Edit scene

In most cases, users can edit the scene name, adjust the mode and speed, and modify, add, or delete colors.

When users modify colors, the panel sends the adjustment DP in real time to let users preview the light effect. In other operations, the scene DP is sent to let users preview the scene effect during the editing process.

Modify colors

Operation	Identifier	Data	Remarks
Cloud-to-device	control_data	Example: Modify the colored light: 1000003e803e800000000 Modify the white light: 100000000000003e803e8	-
Device-to-cloud	-	-	Send only

More operations

Operation	Identifier	Data	Remarks
Cloud-to-device	scene_data	Example: 00323200000003e803e800000000	-
Device-to-cloud	scene_data	00323200000003e803e800000000	-

Music mode

After the music DP is sent, for some panels, the microphone is automatically turned on. For some other panels, users are asked to tap Start to turn on the microphone. After the microphone is turned on and receives music input, the app syncs music with light colors.

Operation	Identifier	Data	Remarks
Cloud-to-device	music_data	Example: Colored light: 1000003e803e800000000 White light: 100000000000003e803e8	-
Device-to-cloud	-	-	Send only

Countdown timer

A countdown timer can be used to automatically turn a light on or off after a certain amount of time.

After the countdown DP is sent, to sync panel data with the device data, the countdown effect is not implemented. The device reports the countdown DP status every 30 seconds.

If the switch state on the device is reversed during the countdown, the countdown timer is stopped and the device reports 0, so the panel displays the finished countdown.

Set countdown timer

Operation	Identifier	Data	Remarks
Cloud-to-device	countdown	Example: 240	-
Device-to-cloud	countdown	240	-

Report device status during countdown

Operation	Identifier	Data	Remarks
Device-to-cloud	countdown	210	-

Turn light on or off during countdown

Operation	Identifier	Data	Remarks
Device-to-cloud	countdown_data	0	-
Device-to-cloud	switch_led	true or false	-