跳转到内容
ESPHome - 智能家居，简单易用

Shelly 调光器

shelly_dimmer 组件为 Shelly Dimmer 2 中的调光和功率计量功能添加支持。与市电的交互通过 STM32 微控制器完成，该微控制器会自动（配置后）刷入开源固件。 关于 Shelly Dimmer 2 硬件的详细分析在 arendst/Tasmota#6914 中给出。

警告！在撰写本文时，似乎无法恢复到”出厂固件”，因为似乎无法恢复 STM32 协处理器的固件。

此组件的配置示例：

logger:
    baud_rate: 0


uart:
    tx_pin: 1
    rx_pin: 3
    baud_rate: 115200
sensor:


light:
    - platform: shelly_dimmer
      name: Shelly Dimmer 2 Light
      id: thislight
      power:
        name: Shelly Dimmer 2 Light Power
      voltage:
        name: Shelly Dimmer 2 Light Voltage
      current:
        name: Shelly Dimmer 2 Light Current
      max_brightness: 500
      firmware:
        version: "51.6"
        update: true

配置变量

Section titled “配置变量”
  • uart_id (可选, ID): 手动指定 UART 集线器的 ID。

NOTE

目前，仅支持 ESP 的第一个硬件 UART，必须像这样配置：

uart:
    tx_pin: 1
    rx_pin: 3
    baud_rate: 115200

  • leading_edge (可选, 布尔值): 调光模式：true 表示前沿，false 为后沿。默认为 false。

  • min_brightness (可选, 整数): 0..1000 刻度上的最小亮度值，默认为 0。

  • max_brightness (可选, 整数): 0..1000 刻度上的最大亮度值，默认为 1000。

  • warmup_brightness (可选, 整数): 亮度阈值，低于此值调光器在市电电流周期中较晚开启。这可能有助于 LED 调光。值为 0..1000，默认为 0。

  • nrst_pin (可选, 引脚): 与 STM32 的 “NRST” 连接的引脚。默认为 “GPIO5”。

  • boot0_pin (可选, 引脚): 与 STM32 的 “BOOT0” 连接的引脚。默认为 “GPIO4”。

  • current (可选): 以安培为单位的电流传感器。所有选项来自传感器。

  • voltage (可选): 以伏特为单位的电压传感器。仅在连接零线时准确。所有选项来自传感器。

  • power (可选): 以瓦特为单位的有功功率传感器。仅在连接零线时准确。所有选项来自传感器。

  • firmware (可选):

    • version (可选): 微控制器上预期的固件版本字符串。默认为 “51.6”，另一个已知良好的固件是 “51.5”。
    • url (可选, 字符串): 下载固件的 URL。已知固件版本默认为 github。
    • sha256 (可选): 用于与下载的固件进行比较的哈希值。默认为已知固件版本的正确哈希值。
    • update (可选): 如有必要是否更新 STM 的固件？默认为 false。

NOTE

首次使用 esphome 刷写 Shelly Dimmer 时，也需要自动刷写 STM 固件才能使调光器工作，并通过以下配置启用：

firmware:
  version: "51.6" #<-- 在此处设置版本
  update: true

用户无需任何操作即可刷写 STM32。在撰写本文时，无法恢复 STM32 上的出厂固件。

另见

Section titled “另见”