什么值得买App下载 App ›
连续签到专享现金活动

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接线与编译烧录
  1. 屏幕接线 (ST7789)
    采用标准 SPI 接法。连接 VCC、GND、SCL、SDA、RES、DC、CS 及 BLK 背光引脚至 ESP32 对应 IO 口。
  2. 触摸模块接线 (TTP223B)
    连接 VCC、GND 及信号引脚(SIG)至指定 IO 口,用于检测用户交互。
  3. IMU 模块接线 (MPU6050)
    使用 I2C 接口,连接 VCC、GND、SCL、SDA。
  4. 编译环境
    推荐使用 PlatformIO 进行编译。首次编译会自动下载工具链和依赖库,后续增量编译可在 1 分钟内完成。编译结果显示 Flash 占用约 24%,RAM 占用约 20%,资源剩余充足。
04配对与操作指南
  1. 开启开发者模式
    在 Claude 桌面端进入设置,找到 Help & Troubleshooting,开启“Developer Mode”。
  2. 进入 Hardware Buddy
    在 Developer 菜单中点击“Open Hardware Buddy”
  3. 蓝牙配对
    点击 Connect,在列表中选择前缀为“Claude”的设备。输入屏幕上显示的六位配对码进行确认。配对成功后,设备将自动连接,无需重复操作。
  4. 交互逻辑
    单击触摸键:切换屏幕或确认;长按:翻页或拒绝审批;超长按:打开菜单。当 Claude 有权限请求时,设备会显示审批提示,单击即可批准,长按拒绝。

评论

评论区空态插画

当前文章无评论,是时候发表评论了