Generic Light Bulb Template

Last Updated on : 2021-04-22 10:21:16Copy for LLMView as MarkdownDownload PDF

This topic describes the specific functions of classic light bulb templates and how to use these templates. For more information, see the GitHub repository.

Note: This project depends on TYSdk.mobile.mobileInfo.appRnVersion v5.28 or later. If the earlier application version is used, go to Tuya Panel-RN to download the required version.

Overview

The template project is a JavaScript basic template based on React Native 0.59 and can be used to create one to five-way light bulbs with a few simple steps. The template project supports the following functions:

Colored light
White light
Scenes
Musical rhythm
Countdown timer setting
Cloud timing
Custom scene attributes

The template project supports the following protocols:

Wi-Fi
Bluetooth
Bluetooth mesh
Zigbee

Directories

Note: This topic only describes the directories related to the scaffold. For more information about the general directory structure, see RN 0.59 TS.

├── src
 │   ├── api // Includes multiple types of cloud API operations that are used to run the project.
 │   ├── components // Includes reusable functional components that are used to run the project.
 │   ├── composeLayout.tsx // Encapsulates `device events` and `device information` that are required on the panel.
 │   ├── config // Includes common configuration files that are used on the panel.
 │   ├── containers // Includes page-level components of the project.
 │   ├── i18n // Includes configuration files to support multiple languages.
 │   ├── main.tsx // The project entry files that are inherited from `NavigatorLayout`. Rewrite the `hookRoute` method to define necessary configurations, such as the background and topbar. Rewrite the `renderScene` method to control routing jump. │   ├── redux // Includes the code of redux.
 │   ├── res // Includes local resources, such as pictures and SVG path.
 │   └── utils // Includes common tools and methods that are used on the panel.

Service process and UI interaction

Open the panel and tap the light bulb icon on the homepage to turn on or off the light bulb.
Tap the bottom navigation pane on the homepage to switch the device mode. You can configure the top navigation pane based on the required data points (DPs).
On the White page, you can drag the brightness and color temperature sliders to adjust the brightness and color temperature.
On the Color page, you can configure the hue, saturation, and value (HSV) model. For example, drag the circular slider to modify the hue and drag the rectangle saturation and brightness sliders to modify the saturation and brightness.
On the Scene page, you can configure eight default scenes, and support custom parameters.
On the music page, you can make the lights move in rhythm with the music.
On the Timer page, you can configure the timing settings to switch on or off the device at the specified time.
The countdown button at the bottom can set the device countdown.

DP protocol

Switch (required)

Parameter	Value
id	20
code	switch_led
type	bool
mode	Can be reported and sent.
value	{"type":"bool"}
description	Turns on and off the light bulb.

Mode (required)

Parameter	Value
id	21
code	work_mode
type	enum
mode	Can be reported and sent.
value	{"range":["white","colour","scene","music"],"type":"enum"}
description	Controls the White, Color, and Scene modes of the light bulb. The enumeration value of the DP cannot be modified. The Music function is not available on the panel.

Brightness value

Parameter	Value
id	22
code	bright_value
type	value
mode	Can be reported and sent.
value	{"min":10,"max":1000,"scale":0,"step":1," type":"value"}
description	Controls the brightness value of the light bulb. The value of the DP cannot be modified, increased, or decreased.

Temperature value

Parameter	Value
id	23
code	temp_value
type	value
mode	Can be reported and sent.
value	{"min":0,"max":1000,"scale":0,"step":1," type":"value"}
description	Controls the temperature value of the light bulb. The value of the DP cannot be modified, increased, or decreased.

Colored light

Parameter	Value
id	24
code	colour_data
type	string
mode	Can be reported and sent.
value	{"type":"string","maxlen":255}
description	Controls the colored light of the light bulb. The length of the value is set to 12 bits. The HSV model is supported. Example: {"24":"000011112222"} 0000: H (hue: 0–360, 0X0000–0X0168) 1111: S (saturation: 0–1000, 0X0000–0X03E8) 2222: V (value: 0–1000, 0X0000–0X03E8)

Scene (required)

Parameter	Value
id	25
code	scene_data
type	string
mode	Can be reported and sent.
value	{"type":"string","maxlen":255}
description	The scene DP. All scene parameters are included. Example: {"25":"0011223344445555666677778888"} 00: the scene No. 11: the unit switch interval (0–100) 22: the unit change time (0–100) 33: the unit change mode: 0: static 1: jump 2: gradient 4444: H (hue: 0–360, 0X0000–0X0168) 5555: S (saturation: 0–1000, 0X0000–0X03E8) 6666: V (value: 0–1000, 0X0000–0X03E8) 7777: white light brightness (0–1000) 8888: temperature value (0–1000) Note: Each digit that ranges from 1 to 8 in the preceding example specifies a unit and a group.

Adjustment (required)

Parameter	Value
id	28
code	control_data
type	string
mode	Can only be sent.
value	{"type":"string","maxlen":255}
description	Controls the stepless dimming of white light and colored light of the light bulb. Example: {"28":"011112222333344445555"} 0: the change mode 0: the direct output 1: the gradient mode 1111: H (hue: 0–360, 0X0000–0X0168) 2222: S (saturation: 0–1000, 0X0000–0X03E8) 3333: V (value: 0–1000, 0X0000–0X03E8) 4444: the white light brightness (0–1000) 5555: the temperature value (0–1000)

Music

Parameter	Value
id	28
code	control_data
type	string
mode	Can only be sent.
value	{"type":"string","maxlen":255}
description	Controls the stepless dimming of white light and colored light of the light bulb. Example: {"28":"011112222333344445555"} 0: the change mode 0: the direct output 1: the gradient mode 1111: H (hue: 0–360, 0X0000–0X0168) 2222: S (saturation: 0–1000, 0X0000–0X03E8) 3333: V (value: 0–1000, 0X0000–0X03E8) 4444: the white light brightness (0–1000) 5555: the temperature value (0–1000)