PlayBot:把 Playdate 掌机变成桌面机器人的开源底座 复刻全流程
PlayBot:把 Playdate 掌机变成桌面机器人的开源底座 从采购、打印、组装到装软件、标定和训练的 86 个步骤,附物料表、购买链接与官方出处。
创作者在硬件 README 中的估算:每台约 100–120 美元,不含运费;不含 Playdate 本身(Panic 官方商店 2026‑11‑04 标价 229.00 美元,当日缺货)。自制电路板约 10 美元一块,但须 5 块起订;HuskyLens 为选配,不在估算内。无官方套件售价
物料 · Hardware
| 零件 | 数量 |
|---|---|
| Custom PCBs | 2 |
| Teensy 4.1 microcontroller | 1 |
| TOF10120 | 2 |
| Low profile headers 12 pins | 1 |
| SG90 servo | 1 |
| ITR20001 | 2 |
采购
- 订购两块定制 PCB
从 JLCPCB 订购两块定制 PCB,并参考 Gerber 文件和 BOM。
- 购买 Teensy 4.1 微控制器
从 PJCRC store 购买一块 Teensy 4.1 微控制器。
- 购买两个 TOF10120
购买两个 TOF10120,文档中列出了 AlliExpress 购买链接。
- 购买 12 针低矮排针
购买一套 12 针低矮排针,文档中提供了 AlliExpress 示例链接。
- 购买一个 SG90 舵机
购买一个 SG90 舵机,文档中提供了 AlliExpress 示例链接。
- 购买机器人零件和工具
按清单准备 1.3 mm 推杆连接器、微型 SD 卡、24 AWG 多色电线,以及可选的 HuskyLens。每个机器人的价格约为 100/120 美元,不含运费;自定义 PCB 每块 10 美元,但必须一次订购 5 块。PlayBot 需要大量焊接和定制连接器与导线,并非即插即用项目。
- 选择定制电源板
使用集成 MCP73831 充电器、TPS61023 5V 升压转换器和 MAX17048 燃料计的定制板。它支持负载共享,机器人运行时也可保持插电,并能在机器人工作时为 Playdate 充电;红灯表示充电,黄灯表示充满。
- 选择主控板
使用连接各种传感器、电机和舵机,并向 Teensy 分配电源的主板。在机壳内安装 Teensy 时需要特殊的低矮型排针。
- 查看DRV8835产品信息
查看Pololu产品页面,以了解该DRV8835板的更多信息。
- 准备 Playdate 主机
准备一台 Panic Inc. 的 Playdate 掌上主机,作为 PlayBot 的机器人大脑和充电底座。
- 获取完整物料清单
打开 hardware 目录,获取完整物料清单和装配说明。
- 购买 Teensy 4.1
使用 Teensy 4.1 微控制器,它为 Playdate 提供 USB hub,并通过串行通信进行通信。
- 购买两个 TOF 传感器
准备两个 TOF 距离传感器。
- 购买 TEMT6000 光传感器
准备一个 TEMT6000 环境光传感器。
- 购买两个红外传感器
准备两个红外传感器。
- 购买带编码器的双电机
准备两个带编码器的电机,用于驱动机器人。
- 购买 MAX1704X 燃料计
准备一个 MAX1704X 燃料计。
- 选配 Huskylens 摄像头
如需视觉 AI,可使用由 Huskylens 供电的附加摄像头。
打印与加工
- 打印外壳和上层框架
使用 Bambu Lab A1 mini 和普通 PLA 打印这些 3D 打印部件。
- 打印下层框架和底座
使用 Bambu Lab A1 mini 和普通 PLA 打印下层框架和底座。
- 打印 PlayBot 机架
PlayBot 的机架完全采用 3D 打印。
组装
- 切断 Teensy 的 USB 电源走线
建议切断 USB 电源走线,以保护使用电池供电的 Teensy。
- 焊接 Teensy 公排针
在 Teensy 的主侧排针和 USB host 排针上焊接公排针。
- 焊接主板低矮型母排针
在 PlayBot 主板上焊接低矮型母排针,使 Teensy 能装入机壳。
- 切平舵机左侧塑料耳
将舵机左侧的塑料耳切至与主体齐平。
- 打开舵机外壳
拆下 4 颗螺丝,打开舵机外壳。
- 切断并识别舵机导线
切断或脱焊导线,并记录颜色:棕色为 GND,红色为 V+,橙色为 signal。
- 更换带 JST SH 的舵机导线
焊接新导线并使用 JST SH 连接器,务必注意舵机连接器的接线顺序。
- 改装并居中舵机舵盘
用烙铁扩大舵盘孔,在舵盘尚软时将其压装到舵机轴上;拧紧前先用测试固件将舵机位置居中。
- 安装顶部框架黄铜嵌件
按照热熔黄铜嵌件教程,在框架顶部加入 5 个黄铜嵌件。
- 安装底部框架黄铜嵌件
在框架底部再加入 4 个黄铜嵌件。
- 固定主控板
使用 4 颗 M2 螺丝,将主板直接固定到框架上。
- 压入框架滚珠轴承
将 2 个滚珠轴承压装到框架中。
- 安装电源开关和 USB-C
将电源开关和 USB-C 输入端焊接到电源管理板。将 USB-C 插头压装到底部框架中,并可用少量热熔胶固定。
- 将电源板固定到底部
用螺丝将电源板固定在框架底部。
- 插入锂电池
将锂电池滑入框架上的专用电池插座。
- 安装4个黄铜嵌件
在中框架上添加4个黄铜嵌件。
- 用双面胶固定DRV8835
使用双面胶将DRV8835板直接固定在零件中部。
- 焊接电机7针JST SH连接器
将MODE、AIN1、AIN2、BIN1、BIN2、VCC和GND引脚焊接到电机连接器用的7针JST SH连接器。
- 制作电机定制插头
为电机制作定制插头。M1和M2从DRV8835板供电,另外4根线用于编码器反馈ENC1和ENC2。
- 用两枚M2螺钉连接框架
在添加电机前,使用2枚M2螺钉将中框架和顶框架连接在一起。
- 制作JST PH电源线束
制作带有JST PH连接器的电源线束,从电源板输出为主板和DRV8835供电。
- 注意主板连接器改动
在最新版本中,主板的PH连接器已被替换为简单的焊接焊盘。
- 安装滚轮脚轮
拆下螺钉,插入滚轮脚轮,然后重新用螺钉固定到框架上。
- 制作USB插头
制作一个连接到4针JST PH连接器的USB插头。
- 用热熔胶固定PH连接器
可以在PH连接器上涂少量热熔胶进行固定。
- 制作PH转SH连接器
制作一个4针PH转SH连接器,用于连接主板上的USERIAL连接器。
- 给USB插头粘上塑料环
USB插头附带小塑料环,可以将塑料环粘到零件上。
- 压装底座磁铁
将磁铁压装到底座中。
- 焊接 TEMT6000 光线传感器的 3 针 JST SH 接头
把 3 针 JST SH 接头焊接到光敏传感器上,使其连接到主板的 TEMT 接口。
- 用螺钉和螺栓固定光线传感器到外壳
将光线传感器用螺钉和螺栓固定在外壳上。
- 用螺钉和螺栓固定 SPDT 开关
将 SPDT 开关用螺钉和螺栓固定在外壳上。
- 焊接 TOF 传感器的 4 针 JST SH 接头
把 4 针 JST SH 接头焊接到 TOF 传感器上,连接主板的 TOF1 和 TOF2;因为使用 2 通道 I²C 多路复用器,可以剪掉 RX/TX 线。
- 用 M2.5x6 螺钉和尼龙螺母固定前后 TOF 传感器
用 M2.5x6 螺钉和尼龙螺母把两个 TOF 传感器固定在外壳的前部和后部。
- 按顺序组装剩余部件
在确认没有报错后,按文档给出的顺序组装剩余部件;由于外壳内部空间紧张,这一步较难。
- 用 M3 螺钉固定屏幕底座
用 M3 螺钉固定屏幕底座,不要拧得过紧。
- 切割 20 mm 舵机拉杆并连到舵机臂
将舵机拉杆切到 20 mm 长,用接头连接到舵机的臂上。
- 装配 PlayBot
按照 hardware 目录中的装配说明组装机器人。
软件与固件
- 创建主程序
创建 PlayBot.ino,包含主程序循环和初始化,协调所有子系统并管理组件之间的通信。
- 实现动画管理器
创建 AnimationManager.h,实现从 SD 卡播放动画、控制舵机运动、协调查询电机并实时处理帧。
- 实现电池管理器
创建 BatteryManager.h,通过 MAX17048 电量计监控电池电压、检测充电状态,并向 Playdate 报告电源状态。
- 实现通信管理器
创建 CommunicationManager.h,通过 USB 串口与 Playdate 通信,解析和路由消息,并处理所有子系统的协议。
- 实现 LED 控制器
创建 LEDController.h,用于控制 WS2812 LED 并显示状态。
- 实现电机控制器
创建 MotorController.h,实现 DRV8835 电机驱动控制、基于 PID 的电机控制、编码器反馈处理以及旋转和移动命令。
- 实现传感器管理器
创建 SensorManager.h,管理 ToF 距离传感器、IR 边缘检测和光照传感器读数。实现碰撞检测、传感器数据聚合与报告。
- 实现存储管理器
创建 StorageManager.h,负责 SD 卡初始化和文件系统管理。
- 创建系统配置
创建 Config.h,定义系统级配置参数、引脚定义、定时常量和传感器阈值。
- 实现调试与日志功能
创建 Debug.h 和 Debug.cpp,实现调试基础设施、错误日志、设置错误跟踪,以及日志缓冲和传输。
- 实现距离追踪器
创建 DistanceTracker.h,追踪总行驶距离、持久保存距离日志并统计移动情况。
- 创建硬件配置
创建 HardwareConfig.h 和 HardwareConfig.cpp,定义硬件专用配置、引脚分配、物理常量,并初始化硬件对象。
- 安装 Teensyduino 和 Arduino IDE
安装 Arduino IDE,并通过文中的链接安装 Teensyduino 附加组件。
- 刷入 PlayBot 固件
使用 Arduino IDE 和 Teensyduino,将 src/PlayBot 目录中的固件刷入机器人。
- 安装 PlayBot 依赖库
安装 USBHost_t36、Encoder、drv8835-motor-shield、SD library、Servo library、MAX1704X、PID_V1、WS2812FX 和 CircularBuffer。
- 侧载 Playdate 配套应用
从单独的 pd-playbot-app 仓库获取使用 Lua 编写的应用,并将其侧载到 Playdate。
- 安装所需库
安装 Encoder、Adafruit_MAX1704X、PCA9540BD、DRV8835MotorShield 和 Servo 库。
- 上传程序到 Teensy
使用 Arduino IDE 将程序上传到 Teensy。
- 把动画文件写入 micro SD 卡
把动画文件写入 micro SD 卡;可借助 MTP_Teensy 库从电脑访问 SD 卡。
标定与测试
- 打开串口监视器
将串口监视器设置为 115200 波特率并打开。
- 开始传感器监控
发送字符 's' 开始监控。
- 测试各个组件
使用文档中的命令测试特定硬件组件。
- 测试前检查连接
在每个步骤前,都应再次检查连接。
- 运行启动顺序测试
连接各组件并测试启动顺序,确认所有部分工作正常。
用起来
- 使用主机内置传感器
PlayBot 使用 Playdate 内置的加速度计和麦克风;主机还会通过串行通信向 Teensy 发送电机控制命令并收集传感器值。
- 使用机器人与充电底座
PlayBot 可作为 Playdate 的充电底座;每次充电可支持约 45 分钟的自主运行。
- 使用自定义 Blender 绑定
使用单独的 Playbot_Rig 仓库中用 Python 编写的自定义绑定和序列导出器,在 Blender 中制作动画、渲染并导出自定义动画序列。
- PlayBot 组装完成
所有部件装配完毕,PlayBot 机器人完成。
物料
- 两块自制电路板(JLCPCB 下单):电源板(MCP73831 充电、TPS61023 5V 升压、MAX17048 电量计)与主板
- Teensy 4.1 微控制器(需低矮排针)与 Pololu DRV8835 双路电机驱动
- 2 个 N20 6V 500RPM 编码器减速电机与 N20 车轮、2 个迷你万向球、2 个 6×3×2.5 法兰轴承
- SG90 舵机、120 mm 舵机推杆与 1.3 mm 推杆接头
- 2 个 TOF10120、TEMT6000 光线传感器、2 个 ITR20001 红外传感器;1S 锂聚合物电池、SPDT 开关、USB‑C 公母头、microSD 卡
- JST SH(建议买预压线)与 JST PH 接插件、24 AWG 线、M2 螺丝与 M2×5 热熔铜螺母、尼龙螺母、M3×40 尼龙螺丝、4 个 6×3 磁铁;5 个打印件(底座、下层、中层、上层框架与外壳)
工具
- 烙铁、助焊剂、热缩管、精密螺丝刀、镊子、带放大镜的焊接辅助夹、剥线钳(20–30 AWG)、Kapton 胶带
- JST PH 压线钳;JST SH 压线钳可选(贵,可改用预压线)
- 3D 打印机(作者用 Bambu Lab A1 mini 打 PLA)
技能
- 细小元件焊接与自制 JST 接插线;改装 SG90 舵机(剪耳、换线、用烙铁扩舵盘孔)
- 用 Arduino IDE 与 Teensyduino 烧录固件,每一步先烧测试固件检查接线
- 把 Lua 应用侧载到 Playdate;可选用 Blender 制作动画
软件
- Teensy 固件(Arduino / Teensyduino):电机 PID、传感器、电量、LED 与动画管理
- pd-playbot-app:Playdate 上的 Lua 应用,基于 Noble Engine 的状态机与行为系统
- Playbot_Rig:Blender 绑定与动画序列导出脚本(Python)