Rdzleo/Dzbj_ESP32-S3_Key
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Dzbj_ESP32-S3_Key/原C3按键版点击吧唧功能规划.md
Rdzleo 75586b3744 ESP32-S3按键版电子吧唧功能完整实现 
1、按键驱动重构：从GPIO中断改为iot_button组件，支持BOOT/KEY2的单击/双击/长按6种事件；
2、新增按键导航管理器(key_nav)：9种上下文状态机，统一分发按键事件到对应界面业务逻辑；
3、BLE模块改造：广播默认关闭由按键触发，新增设备间图片传输(GATT Client)，支持扫描配对→MTU协商→分包发送；
4、新增6个UI界面：配对(Peiwang)、更新(Update)、发送等待(ImageShar)、接收等待(ImageReception)、发送中(Sharing)、接收中(Receiving)；
5、新增电池指示器组件(battery_ui)：支持多界面真实电量显示，3秒渐隐效果；
6、Home界面重构：移除手势事件，改为airhub背景图+电池指示器；
7、Img界面重构：移除触摸事件，新增删除二次确认边框机制；
8、禁用ScreenSet/ScreenChar界面（保留文件），禁用触摸初始化（保留代码可恢复）；
9、sleep_mgr简化：移除ScreenSet亮度UI依赖，按键唤醒由key_nav统一处理；
10、新增9张图片资源（airhub背景、配对、传输状态、电池图标等）；

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-26 17:35:05 +08:00

3.7 KiB
Raw Blame History

按键版电子吧唧功能规划

硬件按键

  • BOOT按键 (GPIO9)：确认/执行/返回
  • KEY按键 (GPIO8)：导航/切换

按键驱动

采用 ESP-IDF 官方 iot_button 组件，原生支持单击、双击、长按检测，替代原有自定义 GPIO 中断驱动。

全局规则

操作 功能
双击BOOT 任何界面/模式下→返回Home
任意键按下 熄屏状态→唤醒屏幕（仅唤醒，不触发业务）

各界面按键功能

1. Home界面

操作 功能
KEY单击 切换到Img界面（图片浏览）
BOOT单击 切换到Set界面（设置）
BOOT双击 无操作（已在Home）

2. Img界面（图片浏览）

正常浏览模式

操作 功能
KEY单击 显示下一张图片（循环）
BOOT单击 返回Home界面
BOOT双击 返回Home界面

删除模式（从Set界面进入，显示ContainerDle）

操作 功能
BOOT单击 确认删除当前图片，顺位显示下一张
KEY单击 取消删除，隐藏ContainerDle，回到正常浏览模式
BOOT双击 返回Home界面

3. Set界面（设置）

焦点导航

进入Set界面默认无焦点选中。KEY单击按顺序轮询选中功能图标：

无选中 → 节能 → 应援灯 → 删除 → 亮度 → 无选中（循环）
  • 选中的图标显示蓝色加粗边框
  • 切换到下一个图标时，上一个取消边框
  • 离开Set界面或返回Home后，边框状态全部清除
  • 下次进入Set界面默认无选中

未选中状态

操作 功能
KEY单击 选中第一个图标（节能）
BOOT单击 返回前一界面（Home或Img）
BOOT双击 返回Home界面

已选中图标但未激活功能

操作 功能
KEY单击 切换到下一个图标
BOOT单击 激活当前选中图标的功能
BOOT双击 返回Home界面

各功能详细操作

1）节能模式

  • BOOT单击激活：切换节能模式开/关
  • 激活后立即生效，焦点保持在节能图标
  • 继续KEY单击→移到下一个图标

2）应援灯（手电筒）

  • BOOT单击激活：进入应援灯全屏模式
  • 进入后按键上下文切换为应援灯模式：
操作 功能
BOOT单击 切换颜色（红→绿→蓝循环）
KEY单击 退出应援灯，返回Set界面
BOOT双击 退出应援灯，返回Home界面

3）删除图片

  • BOOT单击激活：跳转Img界面，显示删除容器（ContainerDle）
  • 进入删除模式后按键行为见上方「Img界面-删除模式」

4）亮度调节

  • BOOT单击激活：进入亮度调节模式
  • 进入后按键行为：
操作 功能
KEY单击 亮度-10%（最低10%）
BOOT单击 亮度+10%（最高100%）
KEY长按2秒 退出亮度调节，继续焦点轮询
BOOT双击 返回Home界面

实施步骤

  1. 添加 iot_button 组件依赖，替代自定义按键驱动
  2. 新建按键导航管理器（key_nav模块），管理界面上下文和焦点状态
  3. 改造各界面：移除触摸手势，添加按键驱动的导航逻辑
  4. Set界面添加蓝色边框高亮样式
  5. 适配休眠管理器

设计说明

  1. 取消触摸芯片：本次改版取消触摸芯片以降低成本，所有交互通过两个物理按键实现
  2. iot_button组件：使用ESP官方组件，自带去抖、单击/双击/长按检测，稳定可靠
  3. 上下文隔离：不同界面/模式的按键行为完全独立，通过导航管理器统一调度
  4. 双击BOOT全局返回：任何状态下双击BOOT都能回Home，用户不会"迷路"