|
| 1 | +--- |
| 2 | +title: "TuYa TS0601_dimmer_1 control via MQTT" |
| 3 | +description: "Integrate your TuYa TS0601_dimmer_1 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway." |
| 4 | +addedAt: 2022-10-01T07:36:39 |
| 5 | +pageClass: device-page |
| 6 | +--- |
| 7 | + |
| 8 | +<!-- !!!! --> |
| 9 | +<!-- ATTENTION: This file is auto-generated through docgen! --> |
| 10 | +<!-- You can only edit the "Notes"-Section between the two comment lines "Notes BEGIN" and "Notes END". --> |
| 11 | +<!-- Do not use h1 or h2 heading within "## Notes"-Section. --> |
| 12 | +<!-- !!!! --> |
| 13 | + |
| 14 | +# TuYa TS0601_dimmer_1 |
| 15 | + |
| 16 | +| | | |
| 17 | +|-----|-----| |
| 18 | +| Model | TS0601_dimmer_1 | |
| 19 | +| Vendor | TuYa | |
| 20 | +| Description | Zigbee smart dimmer | |
| 21 | +| Exposes | light (state, brightness, min_brightness, max_brightness), power_on_behavior, countdown, light_type, linkquality | |
| 22 | +| Picture |  | |
| 23 | + |
| 24 | + |
| 25 | +<!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. --> |
| 26 | + |
| 27 | + |
| 28 | +<!-- Notes END: Do not edit below this line --> |
| 29 | + |
| 30 | + |
| 31 | + |
| 32 | +## Exposes |
| 33 | + |
| 34 | +### Light |
| 35 | +This light supports the following features: `state`, `brightness`, `min_brightness`, `max_brightness`. |
| 36 | +- `state`: To control the state publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"state": "ON"}`, `{"state": "OFF"}` or `{"state": "TOGGLE"}`. To read the state send a message to `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"state": ""}`. |
| 37 | +- `brightness`: To control the brightness publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"brightness": VALUE}` where `VALUE` is a number between `0` and `254`. To read the brightness send a message to `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"brightness": ""}`. |
| 38 | + |
| 39 | +#### Transition |
| 40 | +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. |
| 41 | +Examples: `{"brightness":156,"transition":3}`, `{"color_temp":241,"transition":1}`. |
| 42 | + |
| 43 | +#### Moving/stepping |
| 44 | +Instead of setting a value (e.g. brightness) directly it is also possible to: |
| 45 | +- move: this will automatically move the value over time, to stop send value `stop` or `0`. |
| 46 | +- step: this will increment/decrement the current value by the given one. |
| 47 | + |
| 48 | +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. |
| 49 | +To do this send a payload like below to `zigbee2mqtt/FRIENDLY_NAME/set` |
| 50 | + |
| 51 | +**NOTE**: brightness move/step will stop at the minimum brightness and won't turn on the light when it's off. In this case use `brightness_move_onoff`/`brightness_step_onoff` |
| 52 | +````js |
| 53 | +{ |
| 54 | + "brightness_move": -40, // Starts moving brightness down at 40 units per second |
| 55 | + "brightness_move": 0, // Stop moving brightness |
| 56 | + "brightness_step": 40 // Increases brightness by 40 |
| 57 | +} |
| 58 | +```` |
| 59 | + |
| 60 | +### Power_on_behavior (enum) |
| 61 | +Controls the behavior when the device is powered on. |
| 62 | +Value can be found in the published state on the `power_on_behavior` property. |
| 63 | +It's not possible to read (`/get`) this value. |
| 64 | +To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"power_on_behavior": NEW_VALUE}`. |
| 65 | +The possible values are: `off`, `on`, `previous`. |
| 66 | + |
| 67 | +### Countdown (numeric) |
| 68 | +Countdown to turn device off after a certain time. |
| 69 | +Value can be found in the published state on the `countdown` property. |
| 70 | +It's not possible to read (`/get`) this value. |
| 71 | +To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"countdown": NEW_VALUE}`. |
| 72 | +The minimal value is `0` and the maximum value is `43200`. |
| 73 | +The unit of this value is `s`. |
| 74 | + |
| 75 | +### Light_type (enum) |
| 76 | +Type of light attached to the device. |
| 77 | +Value can be found in the published state on the `light_type` property. |
| 78 | +It's not possible to read (`/get`) this value. |
| 79 | +To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"light_type": NEW_VALUE}`. |
| 80 | +The possible values are: `led`, `incandescent`, `halogen`. |
| 81 | + |
| 82 | +### Linkquality (numeric) |
| 83 | +Link quality (signal strength). |
| 84 | +Value can be found in the published state on the `linkquality` property. |
| 85 | +It's not possible to read (`/get`) or write (`/set`) this value. |
| 86 | +The minimal value is `0` and the maximum value is `255`. |
| 87 | +The unit of this value is `lqi`. |
| 88 | + |
0 commit comments