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

配置变量

• uart_id（可选，ID）：手动指定 UART 中心的 ID。

NOTE

目前，仅支持 ESP 的第一个硬件 UART，需要按如下方式配置：

uart:
    tx_pin: 1
    rx_pin: 3
    baud_rate: 115200

• leading_edge（可选，boolean）：调光模式：true 表示前缘，false 为后缘。默认为 false。

• min_brightness（可选，int）：0..1000 量程上的最小亮度值，默认为 0。

• max_brightness（可选，int）：0..1000 量程上的最大亮度值，默认为 1000。

• warmup_brightness（可选，int）：亮度阈值，低于此值时调光器会在市电周期中更晚地切换开启。这有助于调光 LED。值从 0..1000，默认为 0。

• nrst_pin（可选，Pin）：连接到 STM32 “NRST” 的引脚。默认为 “GPIO5”。

• boot0_pin（可选，Pin）：连接到 STM32 “BOOT0” 的引脚。默认为 “GPIO4”。

• current（可选）：以安培为单位的电流传感器。 Sensor 的所有选项。

• voltage（可选）：以伏特为单位的电压传感器。仅在中性线连接时准确。Sensor 的所有选项。

• power（可选）：以瓦特为单位的有功功率传感器。仅在中性线连接时准确。Sensor 的所有选项。

• firmware（可选）：

  • version（可选）：将在微控制器上期望的固件 版本字符串。默认为 “51.6”，另一个已知良好的固件为 “51.5”。
  • url（可选，string）：下载固件的 URL。已知固件版本默认为 github。
  • sha256（可选）：用于与下载固件比较的哈希值。默认为已知固件版本的正确哈希。
  • update（可选）：如果需要，是否更新 STM 的固件？默认为 false。

NOTE

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

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

用户无需执行任何动作即可刷写 STM32。在撰写本文时，没有方法将 STM32 恢复为原厂固件。

• 来自 Light 的所有其他选项。

参见

• Light 组件
• API 参考：shelly_dimmer.h