按键说明

QQ Group

在推荐的 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