跳转到内容

状态 LED

status_led 连接到所有 ESPHome 组件,可以指示设备的状态。具体来说,它会:

  • 警告处于活动状态时缓慢闪烁(约每秒一次)。当例如临时读取传感器值失败、WiFi/MQTT 连接中断,或本机 API 组件已包含但没有客户端连接时,警告处于活动状态。

  • 错误处于活动状态时快速闪烁(每秒多次)。错误表示 ESPHome 在设置时发现了错误。在大多数情况下,ESPHome 仍会尝试从错误中恢复并继续所有其他操作。

  • 否则保持熄灭。

# 示例配置项
status_led:
pin: GPIOXX

NOTE

如果您的设备有一个需要共享的单个 LED,请改用 status_led 灯光平台

  • pin (Required, Pin Schema): 用于操作状态 LED 的 GPIO 引脚。

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

NOTE

如果您的 LED 处于低电平有效模式(当输出启用时它点亮),请使用 Pin Schemainverted 选项:

status_led:
pin:
number: GPIOXX
inverted: true