← - ESP-IDF framework C guide and examples. | Contents | Next: Tasmota Configuration →

ESPHome Component

The ac_dimmer component allows you to connect a dimmable light or other load that supports phase control dimming to your ESPHome project.

Example Configuration

# Example configuration entry
output:
  - platform: ac_dimmer
    id: dimmer1
    gate_pin: 7
    zero_cross_pin:
      number: 6
      mode:
        input: true
      inverted: yes
light:
  - platform: monochromatic
    output: dimmer1
    name: Dimmerized Light

Configuration Variables

Required Parameters

• gate_pin (Required, Pin): The pin used to control the Triac or Mosfet
• zero_cross_pin (Required, Pin): The pin used to sense the AC Zero cross event. You can have several dimmers controlled with the same zero cross detector. In such cases, duplicate the zero_cross_pin config on each output

Optional Parameters

• method (Optional): Set the method for dimming, which can be:
• leading pulse (default): A short pulse to trigger a TRIAC
• leading: Gate pin driven high until the zero-cross is detected

• trailing: Gate pin is driven high from zero-cross until dimming period. This method is suitable for MOSFET dimmers only

• init_with_half_cycle (Optional, boolean): Will send the first full half AC cycle. Try to use this for dimmable LED lights, it might help to turn on at low brightness levels. On gas (halogen) lamps it might show an initial flicker. Defaults to false

• id (Optional, ID): Manually specify the ID used for code generation

• All other options from Output

Connection Table

Fine-Tuning Dimming Behavior

Additional Resources

Links to Examples

• ESPHome Feature Request #278
• MQTT AC Dimmer ESPHome Discussion

← - ESP-IDF framework C guide and examples. | Contents | Next: Tasmota Configuration →