Light

If the device definition from Zigbee2MQTT contains one or more exposes entries of type light that at least have a feature named state (i.e. on/off), a Lightbulb service will be created. The table below shows how the different features within this exposes entry are mapped to characteristics.

Name	Required access	Characteristic	Remarks
state	published, set	On	Required
brightness	published, set	Brightness
color_temp	published, set	Color Temperature
color_hs	published, set	Hue and Saturation	Requires nested features hue and saturation. Preferred over color_xy.
color_xy	published, set	Hue and Saturation	Requires nested features x and y. Values translated by plugin.

Converter specific configuration (light)

• adaptive_lighting: Set to true to enable Adaptive Lighting. Apple requires a home hub for Adaptive Lighting to work. This feature is only available for lights that expose a Color Temperature characteristic. Additionally you can also configure the following options for Adaptive Lighting:
  • only_when_on: Only update the color temperature when the light is on. Defaults to true.
  • transition: Transition time to send along with the color temperature change when the light is on. If not defined, transition will not be send.

{
  "converters": {
    "light": {
      "adaptive_lighting": {
        "only_when_on": true,
        "transition": 0.5
      }
    }
  }
}