Skip to content

Light

Lights are integrated by using the LUT (Look Up Table) strategy. This strategy is used to calculate the power consumption of the light based on the brightness / color levels.

JSON

Example model.json:

{
    "standby_power": 0.4,
    "calculation_strategy": "lut"
}

Note

Required fields are omitted in this example for brevity. For the full list of required fields see the model structure

Measure

To generate a LUT you'll need to use the measure utility. This will fully automate the process and generate the required CSV files and model.json.

LUT data files

Depending on the supported color modes of the light the integration expects one or more CSV files. You can check the supported modes in HA Developer Tools.

  • hs.csv.gz (hue/saturation, colored lamps)
  • color_temp.csv.gz (color temperature)
  • brightness.csv.gz (brightness only lights)

Some lights support two color modes (both hs and color_temp), so there must be two CSV files. When your light supports xy color mode, you just need to provide the hs CSV file.

The files must be gzipped to keep the repository footprint small.

Example directory structure:

- signify
  - LCT010
    - model.json
    - hs.csv.gz
    - color_temp.csv.gz

Expected file structure

  • The file MUST contain a header row.
  • Watt value decimal point must be a . not a ,. i.e. 18.4
  • The data rows in the CSV files MUST have the following column order:

hs.csv

bri,hue,sat,watt

color_temp.csv

bri,mired,watt

brightness.csv

bri,watt

*Ranges*:

  • brightness (0-255)
  • hue (0-65535)
  • saturation (0-255)
  • mired (0-500) min value depending on min mired value of the light model