To contribute to this page, edit the following file
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}}
. hue_correction
: (optional) Corrects hue values based on a correction map for matching color rendition to other lights. Provide a minimum of 2 data sets in the correction map. To build a map:- choose one of your other lights to be the color reference
- send a sample color to both lights (reference and non-reference)
- modify hue value for non-reference light until it color matches the reference light
- take note of the in and out values, where
in
is the hue value you sent to your reference lightout
is the hue value you had to dial your non-reference light to
- repeat with a few other sample colors (4-5 should suffice)
Example correction map:
hue_correction: - in: 28 out: 45 - in: 89 out: 109 - in: 184 out: 203 - in: 334 out: 318
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":0.5}
.
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)
}
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
.
Manual Home Assistant configuration #
Although Home Assistant integration through MQTT discovery is preferred, manual integration is possible with the following configuration:
light:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
brightness: false
color_temp: false
xy: false
hs: true
schema: "json"
command_topic: "zigbee2mqtt/<FRIENDLY_NAME>/set"
brightness_scale: 254
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "lqi"
value_template: "{{ value_json.linkquality }}"
icon: "mdi:signal"