TuYa TYZS1L
Model | TYZS1L |
Vendor | TuYa |
Description | Led strip controller HSB |
Exposes | light (state, color_hs), linkquality |
Picture | ![]() |
Notes
Limitations
This device has various limitations:
- Changing brightness is not supported
- On/off and color transition is not supported
- Color can only be set via hue/saturation, example payload
{"color":{"h": 360, "s": 100}}
.
Options
How to use device type specific configuration
color_sync
: When enabled colors will be synced, e.g. if the light supports both color x/y and color temperature a conversion from color x/y to color temperature will be done when setting the x/y color (default true). The value must betrue
orfalse
Exposes
Light
This light supports the following features: state
, color_hs
.
state
: To control the state publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"state": "ON"}
,{"state": "OFF"}
or{"state": "TOGGLE"}
. To read the state send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"state": ""}
.color_hs
: To control the hue/saturation (color) publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"color": {"hue": HUE, "saturation": SATURATION}}
(e.g.{"color":{"hue":360,"saturation":100}}
). To read the hue/saturation send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"color":{"hue":"","saturation":""}}
. Alternatively it is possible to set the hue/saturation via:- HSB space (hue, saturation, brightness):
{"color": {"h": H, "s": S, "b": B}}
e.g.{"color":{"h":360,"s":100,"b":100}}
or{"color": {"hsb": "H,S,B"}}
e.g.{"color":{"hsb":"360,100,100"}}
- HSV space (hue, saturation, brightness):
{"color": {"h": H, "s": S, "v": V}}
e.g.{"color":{"h":360,"s":100,"v":100}}
or{"color": {"hsv": "H,S,V"}}
e.g.{"color":{"hsv":"360,100,100"}}
- HSL space (hue, saturation, lightness)
{"color": {"h": H, "s": S, "l": L}}
e.g.{"color":{"h":360,"s":100,"l":100}}
or{"color": {"hsl": "H,S,L"}}
e.g.{"color":{"hsl":"360,100,100"}}
- HSB space (hue, saturation, brightness):
Transition
For all of the above mentioned features it is possible to do a transition of the value over time. To do this add an additional property transition
to the payload which is the transition time in seconds. Examples: {"brightness":156,"transition":3}
, {"color_temp":241,"transition":1}
.
Moving/stepping
Instead of setting a value (e.g. brightness) directly it is also possible to:
- move: this will automatically move the value over time, to stop send value
stop
or0
. - step: this will increment/decrement the current value by the given one.
The direction of move and step can be either up or down, provide a negative value to move/step down, a positive value to move/step up. To do this send a payload like below to zigbee2mqtt/FRIENDLY_NAME/set
{
"hue_move": 40, // Starts moving hue up at 40 units per second, will endlessly loop (allowed value range: -255 till 255)
"hue_step": -90, // Decrease hue by 90 (allowed value range: -255 till 255)
"saturation_move": -55, // Starts moving saturation down at -55 units per second (allowed value range: -255 till 255)
"saturation_step": 66, // Increase saturation by 66 (allowed value range: -255 till 255)
}
2
3
4
5
6
Linkquality (numeric)
Link quality (signal strength). Value can be found in the published state on the linkquality
property. It's not possible to read (/get
) or write (/set
) this value. The minimal value is 0
and the maximum value is 255
. The unit of this value is lqi
.