跳转到内容

AC 调光组件

ac_dimmer 组件允许你将支持相位控制调光的可调光灯具或其他负载 连接到你的 ESPHome 项目中。

市面上有一些现成的与该组件兼容的开发板,例如 RobotDyn dimmer。

RobotDyn 模块。图片由 RobotDyn 提供
# Example configuration entry
output:
- platform: ac_dimmer
id: dimmer1
gate_pin: GPIOXX
zero_cross_pin:
number: GPIOXX
mode:
input: true
light:
- platform: monochromatic
output: dimmer1
name: Dimmable Light
  • gate_pin (必需, Pin): 用于控制 Triac 或 Mosfet 的引脚。

  • zero_cross_pin (必需, Pin): 用于检测 AC 过零事件的引脚,你可以用同一个过零 检测器控制多个调光器,在这种情况下,需要在每个输出上复制 zero_cross_pin 配置。当 这样做时,引脚模式选项 allow_other_uses 必须设置为 true,以 避免由于引脚复用导致的配置错误。

  • zero_cross_interrupt_type (可选): 设置过零中断的中断类型,可以是:

    • FALLING :(默认)在下降沿触发。
    • RISING : 在上升沿触发。
    • ANY : 在任意沿触发。
  • method (可选): 设置调光方法,可以是:

    • leading pulse :(默认)一个短脉冲来触发晶闸管。
    • leading : gate 引脚保持高电平直到检测到过零
    • trailing : gate 引脚从过零开始保持高电平直到调光周期结束,此方法 仅适用于 mosfet 调光器。
  • init_with_half_cycle (可选, boolean): 发送第一个完整的半 AC 周期 请尝试将其用于可调光 LED 灯,它可能有助于在低亮度 级别开启。在白炽灯上可能会显示初始闪烁。默认为 false。

  • id (可选, ID): 手动指定用于代码生成的 ID。

  • 所有其他选项请参见 输出。

使用相位控制调光器可能比较棘手,你的灯具开启的最小级别 可能与其他灯具不同,感知到的光级可能也不会与 设置到灯具的百分比输出相关联,为了尽量减少这些行为,你可以 调整此输出组件中的 min_power 值,以及 单色灯中的 gamma_correct。