mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-25 02:07:15 +00:00
light/mqqt_json: document brightness scaling (#4403)
This commit is contained in:
parent
52ff7978c0
commit
78d5d83468
@ -63,6 +63,11 @@ brightness:
|
|||||||
required: false
|
required: false
|
||||||
type: boolean
|
type: boolean
|
||||||
default: false
|
default: false
|
||||||
|
brightness_scale:
|
||||||
|
description: "Defines the maximum brightness value (i.e. 100%) of the MQTT device."
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
default: 255
|
||||||
color_temp:
|
color_temp:
|
||||||
description: Flag that defines if the light supports color temperature.
|
description: Flag that defines if the light supports color temperature.
|
||||||
required: false
|
required: false
|
||||||
@ -191,6 +196,29 @@ light:
|
|||||||
brightness: true
|
brightness: true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### {% linkable_title Brightness Scaled %}
|
||||||
|
|
||||||
|
To enable a light using a brightness scale other than 8bit the `brightness_scale` option may be added to denote the "fully on" value:
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
light:
|
||||||
|
- platform: mqtt_json
|
||||||
|
name: mqtt_json_light_1
|
||||||
|
state_topic: "home/light"
|
||||||
|
command_topic: "home/light/set"
|
||||||
|
brightness: true
|
||||||
|
brightness_scale: 4095
|
||||||
|
```
|
||||||
|
|
||||||
|
Home Assistant will then convert its 8bit value in the message to and from the device:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"brightness": 4095,
|
||||||
|
"state": "ON",
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### {% linkable_title Implementations %}
|
### {% linkable_title Implementations %}
|
||||||
|
|
||||||
- A full example of custom lighting using this platform and an ESP8266 microcontroller can be found [here](https://github.com/corbanmailloux/esp-mqtt-rgb-led). It supports on/off, brightness, transitions, RGB colors, and flashing.
|
- A full example of custom lighting using this platform and an ESP8266 microcontroller can be found [here](https://github.com/corbanmailloux/esp-mqtt-rgb-led). It supports on/off, brightness, transitions, RGB colors, and flashing.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user