On this page
General-SceneFunction IntroductionDP protocolHow to developNotesRelated materials

General-Scene

Function Introduction

  • Scene capability is a very important part of intelligent lighting. It can enrich the lighting gameplay and realize various lighting effects. It is divided into two scene modes: standard scene and customer-defined scene.

DP protocol

  • dpCode: dreamlight_scene_mode Details (applicable to fantasy scene)
Serial numberNameLengthTypeAttributeRemarks
1Version number1Value0-25 5Default 1
2Scene mode number1Value0-255None
3Transformation mode1Value0-255None
4Unit switching interval time1Value0-100None
5Unit change time1Value0-100None
6Setting item A1BitBit0: Reserved flag: null10: Reserved 1: Reserved Bit1: Reserved flag: null20: Reserved 1: Reserved Bit2: Extension flag: extra10: Mode 1: Mode Bit3: Extension flag: extra20: Mode 1: Mode Bit4: Direction flag: direction0: Clockwise 1: Counterclockwise Bit5: Reserved flag: null30: Reserved 1: Reserved Bit6: Reserved flag: null40: Reserved 1: Reserved Bit7: Segment flag: segment0: Full segment 1: SegmentedNone
7Setting item B1BitBit0: Reserved flag: null50: Reserved 1: ReservedBit1: Reserved flag: null60: Reserved 1: ReservedBit2: Reserved flag: null70: Reserved 1: ReservedBit3: Reserved flag: null80: Reserved 1: ReservedBit4: Reserved flag: null90: Reserved 1: ReservedBit5: Reserved flag: null100: Reserved 1: ReservedBit6: Reserved flag: null110: Reserved 1: ReservedBit7: Reserved flag: null120: Reserved 1: ReservedNone
8Setting item C1BitBit0: Reserved flag: null50: Reserved 1: ReservedBit1: Reserved flag: null60: Reserved 1: ReservedBit2: Reserved flag: null70: Reserved 1: ReservedBit3: Reserved flag: null80: Reserved 1: ReservedBit4: Reserved flag: null90: Reserved 1: ReservedBit5: Reserved flag: null100: Reserved 1: ReservedBit6: Reserved flag: null110: Reserved 1: ReservedBit7: Reserved flag: null120: Reserved 1: ReservedNone
9Brightness1Value0-100None
10Chroma2Value0-360None
11Saturation1Value0-100None
  • General dpCode scene_data protocol details
Serial numberNameNumber of charactersFlagData typeField attributeField description
1Scene ID2scene_idValueMaximum value: 255 Minimum value: 0 Step: 1 Multiple: 0Scene ID: 0~255 0x00 - 0xff
2Unit switching interval2transition_intervalValueMaximum value: 100 Minimum value: 0 Step: 1 Multiple: 0Unit switching interval: 0 - 100, 0X00 - 0X64
3Unit change time2durationValueMaximum value: 100 Minimum value: 0 Step: 1 Multiple: 0Unit change time: 0 - 100, 0X00 - 0X64
4Unit change mode2change_modeEnumerationStatic: 0 Jump: 1 Gradient: 2
5Hue (H)4HValueMaximum: 360 Minimum: 0 Step: 1 Multiple: 0Hue: 0~360, 0X0000 - 0X0168
6Saturation (S)4SValueMaximum: 1000 Minimum: 0 Step: 1 Multiple: 0Saturation: 0~1000, 0X0000 - 0X03E8
7Brightness (V)4VValueMaximum: 1000 Minimum: 0 Step: 1 Multiple: 0Brightness: 0~1000, 0X0000 - 0X03E8
8White light brightness4BValueMaximum: 1000 Minimum: 0 Step: 1 Multiple: 0White light brightness: 0~1000, 0X0000 - 0X03E8
9Color temperature value4TValueMaximum value: 1000 Minimum value: 0 Step: 1 Multiple: 0Color temperature value: 0~1000, 0X0000-0X03E8

How to develop

  • Monitor and report DP according to UI interaction

  • Specific monitoring and reporting examples

  • Furthermore, we provide extension plug-ins on Tuya MiniApp IDE to assist development. Click Extension Management to see Panel IDE Lighting Scenario Library Extension. After downloading, follow the instructions on the extension to use it.

Notes

  • Limitation on the number of custom scenarios:
  • Due to the limited embedded memory space, the number of custom scenarios added during operation is generally limited, usually not exceeding 10