状态 LED

status_led 会钩入所有 ESPHome 组件，并可以指示设备的状态。具体而言，它会：

• 当 警告 处于活动时缓慢闪烁（大约每秒一次）。当例如读取传感器值暂时失败、Wi-Fi/MQTT 连接中断，或包含了原生 API 组件但没有客户端连接时，就会触发警告。

• 当 错误 处于活动时快速闪烁（每秒多次）。错误表示 ESPHome 在设置过程中发现了错误。在大多数情况下，ESPHome 仍会尝试从错误中恢复，并继续执行所有其他操作。

• 其他时候保持关闭。

# 示例配置条目
status_led:
  pin: GPIOXX

NOTE

如果你的设备只有一个需要共享的 LED，请使用 status_led 灯平台。

配置变量

• pin (必选, Pin Schema): 用于控制状态 LED 的 GPIO 引脚。

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

NOTE

如果你的 LED 处于低电平有效模式（即输出为启用时 LED 点亮），请使用 Pin Schema 的 inverted 选项：

status_led:
  pin:
    number: GPIOXX
    inverted: true

参见

• 状态 LED 灯
• API 参考：status_led.h