Configure your lighting!

What are outputs?

Outputs are the executive parts of our controller. As dimmer its specialised in controlling lights, we had prepared configurations for few scenarios! You can control:

• 8 single LED strips,
• 4 CCT LED Strips,
• 2 RGBW LED Strips.

Why should you name them?

Naming your outputs will make working with the controller much easier. It's much easier to remember "Bedroom light" than "CHL 01", right?

In our examples, we focus on a part of the configuration, which you can then adjust to your entire configuration.

Let's get started!

Configure outputs

We have prepared three types of configuration files for you. Which one you should choose depends on what you will use as your outputs. In most scenarios - most popular output configuration is 8 single LED Strips, so we prepared a configuration with 8 single LED strips outputs!

8 single LED strips

Below is a part of the default configuration in the file:

boneio-dimmer_gen2_8ch-v0_1.yaml

We are looking for the part with the light: header.

light:
  - platform: monochromatic
    output: chl01
    name: 'CHL 01'
    id: chl_01
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chl02
    name: 'CHL 02'
    id: chl_02
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chl03
    name: 'CHL 03'
    id: chl_03
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chl04
    name: 'CHL 04'
    id: chl_04
    default_transition_length: 2s
    gamma_correct: 0

  - platform: monochromatic
    output: chr01
    name: 'CHR 01'
    id: chr_01
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chr02
    name: 'CHR 02'
    id: chr_02
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chr03
    name: 'CHR 03'
    id: chr_03
    default_transition_length: 2s
    gamma_correct: 0
  - platform: monochromatic
    output: chr04
    name: 'CHR 04'
    id: chr_04
    default_transition_length: 2s
    gamma_correct: 0

• - platform: monochromatic - Defines the component type. monochromatic is used for brightness control of single color LED strip.
• output: chl01 – This links the light to a specific physical output defined elsewhere in the configuration.
• name: 'CHL 04' – This is the friendly name of the output that will be visible in Home Assistant. You can change it freely, for example, to Bedroom Light or CHL_01_Bedroom.
• id: chl_01 – This is a unique identifier used within the ESPHome configuration. It allows you to control this light from automations or other components (e.g., light.toggle: chl_01).
• default_transition_length: 2s - time of the transition on/off.

4 CCT LED Strips

Below is a part of the default configuration in the file:

boneio-dimmer_gen2_4cct-v0_1.yaml

We are looking for the part with the light header :

light:
  - platform: cwww
    name: 'CHL_01_02'
    id: chl_01_02
    cold_white: chl01
    warm_white: chl02
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K
  - platform: cwww
    name: 'CHL_03_04'
    id: chl_03_04
    cold_white: chl03
    warm_white: chl04
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K

  - platform: cwww
    name: 'CHR_01_02'
    id: chr_01_02
    cold_white: chr01
    warm_white: chr02
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K

  - platform: cwww
    name: 'CHR_03_04'
    id: chr_03_04
    cold_white: chr03
    warm_white: chr04
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K

• - platform: cwww - Defines the component type. cwww is used for brightness control, and color temperatoure of the single Cold White / Warm White LED strip.
• name: 'CHL_01_02' – This is the friendly name of the output that will be visible in Home Assistant. You can change it freely, for example, to Bedroom Light or CHL_01_02_Bedroom.
• id: 'chl_01_02' – This is a unique identifier used within the ESPHome configuration. It allows you to control this light from automations or other components (e.g., light.toggle: chl_01).
• cold_white: 'chl01' - This links the light to a specific physical output defined elsewhere in the configuration.
• warm_white: 'chl02' - This links the light to a specific physical output defined elsewhere in the configuration.
• cold_white_color_temperature: - Here you can set specific color temperature of your cold white led strip.
• warm_white_color_temperature: - Here you can set specific color temperature of your warm white led strip.

2 RGBW LED Strips

Below is a part of the default configuration in the file:

boneio-dimmer_gen2_2rgbw-v0_1.yaml

We are looking for the part with the light header:

light:
  - platform: rgbw
    id: rgbw_l
    name: 'RGBW L'
    red: chl01
    green: chl02
    blue: chl03
    white: chl04
    default_transition_length: 2s
    gamma_correct: 0
  - platform: rgbw
    id: rgbw_r
    name: 'RGBW R'
    red: chr01
    green: chr02
    blue: chr03
    white: chr04
    default_transition_length: 2s
    gamma_correct: 0

• - platform: rgbw - Defines the component type. rgbw is used for controling popular RGBW LED strips.
• name: 'RGBW L' – This is the friendly name of the output that will be visible in Home Assistant. You can change it freely, for example, to Bedroom Light or RGBW_L_Bedroom.
• id: 'rgbw_l' – This is a unique identifier used within the ESPHome configuration. It allows you to control this light from automations or other components (e.g., light.toggle: chl_01).
• red: 'chl01' - This links the light color to a specific physical output defined elsewhere in the configuration.
• green: 'chl02' - This links the light color to a specific physical output defined elsewhere in the configuration.
• blue: 'chl03' - This links the light color to a specific physical output defined elsewhere in the configuration.
• white: 'chl0' - This links the light color to a specific physical output defined elsewhere in the configuration.
• default_transition_length: 2s - the time of transition.
• gamma_correct: 0 - Here you can correct gamma of the strip.

Customize it!

Do you have 2 CCT strips and one RGBW strip? No problem, just modify the appropriate part of the yaml file according to your needs!

light:
  - platform: rgbw
    id: rgbw_l
    name: 'RGBW L'
    red: chl01
    green: chl02
    blue: chl03
    white: chl04
    default_transition_length: 2s
    gamma_correct: 0

  - platform: cwww
    name: 'CHR_01_02'
    id: chr_01_02
    cold_white: chr01
    warm_white: chr02
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K
  - platform: cwww
    name: 'CHR_03_04'
    id: chr_03_04
    cold_white: chr03
    warm_white: chr04
    cold_white_color_temperature: 6536 K
    warm_white_color_temperature: 2000 K

What have we done? For the left section of the controller - where we connected the RGBW strip - we applied the configuration from the boneio-dimmer_gen2_2rgbw-v01.yaml file. However, for the right section of the controller, we are connecting 2 CCT strips! How did we configure it? It's simple: we used the part of the configuration from the boneio-dimmer_gen2_4cct-v01.yaml file that is dedicated to the right section of the controller. Thanks to this, a single boneIO Dimmer supports 2 CCT strips and one RGBW strip!