Claude 桌面助手—— Claude Desktop Buddy 从 M5StickC Plus 移植到 ESP32-S3
Claude Desktop Buddy 是 Anthropic 官方开源的硬件项目,本质上是一个桌面电子宠物。它通过蓝牙连接 Claude 桌面客户端,能够实时显示 AI 的工作状态:当 Claude 执行任务时显示忙碌动画,有工具调用需要审批时提醒用户,并支持直接在设备上点击批准或拒绝。原版项目指定使用 M5StickC Plus 开发板,但其价格较高且购买不便。本文介绍将该固件移植至成本更低、性能更强的通用 ESP32-S3 开发板的全过程,涵盖硬件选型、接线方案、软件移植逻辑及使用方法。
01硬件选型与成本对比
| 组件名称 | 推荐型号/规格 | 参考成本 | 功能说明 |
|---|---|---|---|
| 主控板 | ESP32-S3-N16R8 | 约 20 元 | 16MB Flash,8MB PSRAM,蓝牙 5.0,性能优于原版 |
| 显示屏 | 1.14寸 ST7789 TFT (135x240) | 约 10 元 | 分辨率与原版一致,需注意驱动芯片为 ST7789 |
| 触摸传感器 | TTP223B 电容触摸模块 | 几 元 | 替代原版物理按键,支持单击、长按、超长按 |
| 六轴模块 (可选) | MPU6050 | 几 元 | 支持摇晃触发晕眩效果,面朝下触发小睡 |
移植方案所需硬件清单及成本估算(不含杜邦线)
主控平台方案对比
M5StickC Plus
官方原生支持,开箱即用
集成度高,包含屏幕、电池、IMU
价格较高(国内约 100 元以上)
货源紧张,常需预约购买


ESP32-S3-N16R8
成本显著降低,开发板仅需约 20 元
16MB Flash 容量大,可存储更多 GIF 资源
通用性强,市面上易于购买
需自行接线及配置底层驱动
02移植核心思路与技术难点
软件层面移植的核心在于引入硬件抽象层(HAL)。通过创建 HAL.h 头文件,定义了按钮、背光、电源、IMU、时钟、蜂鸣器、LED 等所有硬件接口,并在 hal_s3.cpp 中针对 ESP32-S3 进行逐一实现。代码逻辑上,将原版依赖的 M5.LCD 替换为 TFT_eSPI 库调用,M5.BtnA/M5.BtnB 替换为触摸检测逻辑,M5.Power 替换为 ESP32 的深度睡眠控制,RTC 则替换为软件时钟。蓝牙协议方面,原版使用的经典 BLE 库被替换为对 ESP32-S3 兼容性更好的 NimBLE 库,但保留了 Nordic UART Service (NUS) 的 UUID 和通信协议,确保无需修改 Claude 桌面端即可直接连接。
屏幕配置是移植过程中的主要技术难点。ST7789 的 135x240 面板需要正确设置 SPI Mode 3、开启显示反转、设置 BGR 颜色顺序以及配置 CRAM 偏移量。若缺少任何一项配置,屏幕将无法正常显示。这些参数通常需要参考 M5StickC Plus 的源码或显示屏数据手册进行精确匹配。
03接线与编译烧录
- 屏幕接线 (ST7789)
采用标准 SPI 接法。连接 VCC、GND、SCL、SDA、RES、DC、CS 及 BLK 背光引脚至 ESP32 对应 IO 口。 - 触摸模块接线 (TTP223B)
连接 VCC、GND 及信号引脚(SIG)至指定 IO 口,用于检测用户交互。 - IMU 模块接线 (MPU6050)
使用 I2C 接口,连接 VCC、GND、SCL、SDA。 - 编译环境
推荐使用 PlatformIO 进行编译。首次编译会自动下载工具链和依赖库,后续增量编译可在 1 分钟内完成。编译结果显示 Flash 占用约 24%,RAM 占用约 20%,资源剩余充足。
04配对与操作指南
- 开启开发者模式
在 Claude 桌面端进入设置,找到 Help & Troubleshooting,开启“Developer Mode”。 - 进入 Hardware Buddy
在 Developer 菜单中点击“Open Hardware Buddy” - 蓝牙配对
点击 Connect,在列表中选择前缀为“Claude”的设备。输入屏幕上显示的六位配对码进行确认。配对成功后,设备将自动连接,无需重复操作。 - 交互逻辑
单击触摸键:切换屏幕或确认;长按:翻页或拒绝审批;超长按:打开菜单。当 Claude 有权限请求时,设备会显示审批提示,单击即可批准,长按拒绝。
当前文章无评论,是时候发表评论了