按键说明

在推荐的 ESP32-C3 开发板(如 Pro mini)上,通常板载两个实体按键:RST(复位按键) 和 BOOT(配置按键)。
Bondings Ink 固件利用这两个按键实现了设备重启、模式切换和重新配网等功能。
1. RST 按键(硬件复位)
- 作用:直接切断并恢复芯片电源,执行硬重启。
- 用法:任何时候短按一次 RST 按键,设备都会立即重启。
- 注意:这是硬件级别的重启,不会保存当前状态,通常用于设备死机或需要强制重启时。
2. BOOT 按键(配置按键)
在 Bondings Ink 固件中,BOOT 按键被定义为核心的交互按键(在代码中对应 BUTTON_PIN,通常是 GPIO9)。
短按(单击)
- 动作:按下时间不少于 50ms、少于 2 秒。
- 作用:在 Live(活跃状态) 和 Interval(间歇状态) 之间切换。
- Interval(间歇状态):设备按 Web 配置中的刷新周期工作,刷新完进入深度休眠,最省电,适合日常摆放。
- Live(活跃状态):设备保持联网不休眠,以极短的周期轮询后端更新。适合调试模式或频繁修改配置时使用,能立刻看到变化,但功耗极高。
长按(软重启)
- 动作:长按约 2 秒。
- 作用:屏幕会显示
Restarting提示,随后设备执行软重启。
开机长按(强制进入配网模式)
- 动作:在设备开机(或按 RST 重启)的瞬间,按住 BOOT 键不放。
- 作用:设备会跳过正常的连接流程,强制进入 配置门户(Captive Portal) 模式。
- 适用场景:
- 更换了路由器,需要重新连接新的 Wi-Fi。
- 修改了后端服务器地址。
- 设备无法正常联网,需要救援。
- 提示:如果设备是全新刷机、尚未配置过 Wi-Fi,开机时会自动进入配网模式,无需按住按键。
3. 对应源码位置
- 启动时检测是否强制进入配置门户:
firmware/src/main.cpp - 按键短按 / 长按逻辑:
firmware/src/main.cpp - 长按阈值与短按最小时长:
firmware/src/config.h - 推荐开发板的按键引脚定义:
firmware/src/config.h