跳转到内容

安全模式

有时硬件和/或软件不像预期那样运行。ESPHome 支持”安全模式”以帮助从重复启动失败/重启循环中恢复。在指定次数(默认为十次)的启动失败后,安全模式可能会被调用;在此模式下,除串行日志、网络(Wi-Fi 或以太网)和 OTA 组件外,所有组件都被禁用。在大多数情况下,这将暂时缓解问题,让您有机会纠正它,也许通过上传新的二进制文件。

您还可以通过配置专用的 按钮开关 组件和/或通过在开发板上重复按 num_attempts 次(见下文)重置按钮来强制调用安全模式。

# 示例配置项
safe_mode:
  • disabled (Optional, boolean): 设置为 true 以禁用 safe_mode。Ota 自动设置安全模式;这允许在不想要时禁用它。

  • boot_is_good_after (Optional, Time): 启动被认为成功后的时间量。默认为 1min

  • num_attempts (Optional, int): 在调用安全模式之前必须发生的启动失败尝试次数。默认为 10

  • reboot_timeout (Optional, Time): 在安全模式下重新启动前等待的时间量。默认为 5min

  • on_safe_mode (Optional, Automation): 调用安全模式时执行一次的动作。

WARNING

on_safe_mode 自动化 仅用于恢复操作。

如上所述,在安全模式下,除串行日志、网络(Wi-Fi 或以太网)和 OTA 组件外,所有组件都被禁用。

所有其他组件(例如,显示器和传感器)都被禁用,无法使用。