Sonoff D1 调光器

sonoff_d1 灯光平台为 Sonoff D1 调光器中的硬件创建一个简单的仅亮度灯。也支持使用 Sonoff RM433 433MHz 无线遥控器的安装。使用此组件将 Sonoff D1 调光器集成到 ESPHome / Home Assistant 生态系统中。

Sonoff D1 使用另一个 MCU 进行灯光调光和处理无线命令。它通过 UART 总线连接到 ESP8266，在 ESP8266 端使用默认的 RX / TX 引脚。ESP8266 和 MCU 之间实现了双向对称请求/响应协议。sonoff_d1 组件实现了此协议，并在 HA 灯光命令和串口消息之间进行转换。

要用 ESPHome 替换出厂固件，您需要找到 GPIO0 引脚和串口。下面的照片应该有所帮助。

使用此组件之前请确保：

开发板配置为 esp8285
UART 总线配置为使用默认 RX / TX 引脚和 9600 波特率
串口的记录器通过将 baud_rate 设置为 0 来禁用
如果您需要在开机时恢复灯光状态，请确保在 ESP8266 平台中将 restore_from_flash 设置为 true

此组件对于 Sonoff D1 调光器以外的设备无用。

# 配置示例
esphome:
  name: my-d1-dimmer

# 如果您想在开机时保持最后状态，请从闪存恢复
esp8266:
  board: esp8285
  restore_from_flash: true

# 确保您的 WiFi 能连接
wifi:
  ssid: "ssid"
  password: "password"

# 确保记录器不使用串口
logger:
  baud_rate: 0

# 启用 Home Assistant API
api:

# 确保您可以 OTA 上传新固件
ota:
  platform: esphome

# D1 调光器在默认引脚上使用硬件串口 @ 9600 bps
uart:
  rx_pin: RX
  tx_pin: TX
  baud_rate: 9600

# 最后是灯光组件
# 伽马校正等于零提供线性刻度，
# 正是此设备所需的
light:
  - platform: sonoff_d1
    use_rm433_remote: False
    name: Sonoff D1 Dimmer
    restore_mode: RESTORE_DEFAULT_OFF
    gamma_correct: 0.0
    default_transition_length: 1s

配置变量

use_rm433_remote (可选, 布尔值): 如果您的设置使用 Sonoff RM433 或任何其他无线遥控器，请设置为 True。正确设置此参数允许平台识别如何处理传入的 UART 命令。已知 RF 芯片如果未与真正的遥控器配对会捕获随机命令（所谓的幽灵命令）。即使使用出厂固件也会观察到此问题，很可能是 MCU 固件或 RF 芯片固件中的错误。将此设置为 False 指示平台正确忽略此类命令，从而防止意外切换或灯光强度变化。
min_value (可选, 整数): 允许的最低调光值。您设置的可接受值取决于实际安装的灯泡及其数量。从默认值开始，检查灯泡可以呈现的最小亮度是多少。注意，对于某些可调光 LED 灯，最小开启亮度将高于如果您只是在灯已开启时降低亮度的最小可达到亮度。默认为 0。
max_value (可选, 整数): 允许的最高调光值。使用此选项为您的设置硬性限制灯光强度。对于某些灯泡，此参数也可能有助于防止高亮度值下的闪烁。默认为 100。
所有其他选项来自灯光组件。

Sonoff D1 调光器

配置变量

另见