学习精选 · AI 工具
Claude 与 Skill

用 ESP32-P4 自制 Stream Deck:触屏宏键盘还能替你审批 Claude Code 的权限请求

DEV Community2026-11-15约 4 分钟读完AI 整理查看原文

作者用 GUITION JC1060P470C(7 寸 1024x600 触屏 + ESP32-P4)做了开源宏键盘 Tessera Deck,面板只负责画界面和上报触摸,动作逻辑全在 PC 端 Python host。最有意思的是接入了 Claude Code hooks:AI 请求权限时直接在触屏上按 Allow/Deny。文章分享了 UI 先在 PC 上原生调试、原地更新控件、图标缓存等具体设计经验。

今天就能做

  • 做嵌入式触屏项目时,先把 UI 用同一套 LVGL 源码在 PC 上原生编译调试,能省掉大量刷机往返
  • 给 Claude Code 加权限审批 hooks 时,务必设置超时回退和“绝不自动允许”原则,避免面板故障卡住工作流
  • 触屏 UI 中被手指按住的控件永远不要重建,改为原地更新属性

架构思路:面板保持“笨”,逻辑放 PC

  • 面板固件只做两件事:绘制界面、上报触摸事件;动作执行和编辑器都由 PC 端 Python host 负责,两者通过 115200 波特的 USB 串口按行通信
  • 每条消息是一行 UTF-8 文本或一个 JSON 对象,按键事件形如 {"type":"deck_event","id":N,"button":N,"hold":true},长按才带 hold 字段
  • 好处是加新动作不用碰固件;代价是面板最多读 1099 字节的行,超长直接丢弃,所以布局按 380 字符分块、图片按 160 字节分块发送
  • PC 关机时面板保留最后布局但按键无效,按键高亮会一直保持到 host 应答为止

UI 先在 PC 上原生编译调试

  • UI 代码用同一套 LVGL 源码在 PC 上原生编译,用脚本喂触摸输入、渲染 1024x600 帧
  • 布局 bug 几秒就能发现,不用刷固件插线板;README 截图也直接由原生构建生成,不用斜着拍屏幕
  • 局限是原生构建覆盖不到显示驱动、触摸控制器和 PSRAM 限制,这些仍要上板验证

触屏 UI 的两条铁律:原地更新 + 图标当缓存

  • 手指按住时如果整个网格重建,触摸事件会落在新对象上丢失,所以标签、颜色、仪表值都在现有 LVGL 对象上原地改,只有页面切换才重建网格
  • 新组件只是 host 端发标题、副标题和进度值,面板统一绘制,不需要新固件
  • 图标太大不能走文本通道,用 AD_IMG_BEGIN/DATA/END 协议传 RGBA 并带 CRC32 校验,损坏时面板回 INVALID 而不是显示坏图
  • 图标缓存在 PSRAM 里占 8 MiB,满了按 LRU 淘汰没被按键显示的图;面板缺图时发 image 请求让 host 重发

让 Claude Code 的权限请求出现在触屏上

  • 安装时向 ~/.claude/settings.json 添加 hooks(先备份、保留已有 hooks),Claude Code 请求权限时面板弹出 Allow/Deny 按钮
  • hook 最多等 25 秒触摸;面板离线、超时或请求太长时,Claude Code 回退到正常对话框
  • Tessera 绝不自动允许任何请求,没人按就回键盘确认,不会卡住工作流
  • agents 页面还能显示 Claude Code、Codex、ZCode 正在哪个项目里做什么

内存规划与已知限制

  • 两个 1024x240 的 PSRAM 部分绘制缓冲、一个软件绘制单元、15 ms 刷新周期;字体压缩存储,6x3 按键网格因形状固定而手工布局
  • 仅支持 Windows 10/11,host 和动作都是 Windows 侧实现
  • 只适配 JC1060P470C 一块板,换板需要移植引脚和屏幕配置
  • 未代码签名,SmartScreen 首次运行会警告,release 附带 SHA256SUMS 供校验;面板无网络,编辑器只监听 127.0.0.1

原文:Building a touchscreen macro deck on an ESP32-P4 with LVGL 9.6

来源:DEV Community · 2026-11-15

查看原文

本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论