跳转到内容

AC 调光器组件

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

有几款现成的板子与此组件兼容,例如 RobotDyn dimmer

RobotDyn 模块。图片由 RobotDyn 提供
# 示例配置条目
output:
- platform: ac_dimmer
id: dimmer1
gate_pin: GPIOXX
zero_cross_pin:
number: GPIOXX
mode:
input: true
inverted: yes
light:
- platform: monochromatic
output: dimmer1
name: Dimmable Light
  • gate_pin (必填, Pin):用于控制 Triac 或 Mosfet 的引脚。

  • zero_cross_pin (必填, Pin):用于检测交流过零事件的引脚,您可以使用同一个过零检测器控制多个调光器,在这种情况下,在每个输出上复制 zero_cross_pin 配置。这样做时,allow_other_uses 引脚架构选项必须设置为 true,以避免因引脚复用导致的配置错误。

  • method (可选):设置调光方法,可以是:

    • leading pulse:(默认)短脉冲触发可控硅。
    • leading:门极引脚保持高电平直到检测到过零
    • trailing:门极引脚从过零开始保持高电平直到调光周期结束,此方法仅适用于 mosfet 调光器。
  • init_with_half_cycle (可选, 布尔值):将发送第一个完整的半交流周期。 对于可调光 LED 灯,尝试使用此选项,可能有助于在低亮度级别时开启。在卤素灯上可能会显示初始闪烁。默认为 false

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

  • 所有其他选项来自 Output

使用相位控制调光可能比较棘手,您的灯开启的最低电平可能与其他灯不同,感知的亮度级别也可能与设置给灯的百分比输出不相关,为了尽量减少这些行为,您可以调整此输出组件的 min_power 值以及单色灯的 gamma_correct 值。