安全模式
有时硬件和/或软件不像预期那样运行。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 组件外,所有组件都被禁用。
所有其他组件(例如,显示器和传感器)都被禁用,无法使用。
- 安全模式按钮
- 安全模式开关
- 故障排除 - 用于调试崩溃和启动失败的故障排除指南
- API Reference: safe_mode.h