Robbi 复刻全流程
Robbi 从采购、打印、组装到装软件、标定和训练的 62 个步骤,附物料表、购买链接与官方出处。
Robbi 是一款配有 facial display、摄像头、语音功能和两个带编码器轮子的微型 Raspberry Pi 伴侣机器人。该仓库提供可打印的外壳零件、自制 PCB、物料清单、接线与装配指南,以及安装和运行机器人所需的软件。
物料 · Individual printable parts
| 零件 | 数量 |
|---|---|
| Main chassis · Chassis · 01 · Supplied side down; motor axes vertical; bed-only tree/organic supports. | 1 |
| Rear electronics cover · Rear cover · 02 · Outside face down, Pi rails up; normal supports under raised end lips. | 1 |
| Side panels · Battery side · GPIO side · 03, both panels · Outside faces down; no supports. Preserve the 0.8 mm pocket skins. | 1 each |
| New front-fastened motor clip · Clip · 11 · Broad side down; no supports; four walls, 40% configured infill, 26 top and 26 bottom layers make this small part so | 1 |
| 11 mm stack spacers · One spacer · 04, four spacers · Upright; no supports. STL = one spacer; 3MF = four. | 4 |
| Button rocker · Nominal rocker · 06 · PETG, 0.16 mm, bearing axis vertical, bed-only tree supports. | 1 |
| Button keeper and split pivot pin · Keeper · Pin · 07, both parts · PETG, 0.16 mm, no supports; keeper flat, pin horizontal. Pin-only 3 mm outer brim, zero gap. | 1 each |
| Fixed head carrier and hollow neck · Head carrier · 08 · Front bezel down, rear open upward; normal supports from bed only. | 1 |
| Head rear service cover · Head cover · 09 · Outside rear face down, posts up; no supports; reference outer-wall speed 40 mm/s. | 1 |
采购
- 先阅读原型机的已知限制
在订购零件或开始组装之前,阅读当前原型机的已知限制。
- 查阅零件清单
使用 bom.csv 查看零件数量、变体和购买链接。
- 订购 Robbi 零件
按照链接的零件清单获取 Robbi 所需的组件。
打印与加工
- 使用匹配的 2026-10-13 文件
一起使用 2026-10-13 文件夹中的所有文件。不要混入旧版底盘、面板、电机夹具或头部零件。
- 以 100% 比例导入 STL
STL 模型已经按打印方向摆放。以 100% 比例导入,不要缩放。
- 配置并切片打印
选择你实际使用的打印机、喷嘴、耗材和打印热床。参考项目使用 Bambu A1 和 0.4 mm 喷嘴;然后重新检查并切片模型。
- 将 3MF 文件视为打印项目
提供的 3MF 文件包含模型和切片设置,并不是可直接运行的 G 代码;请根据所选设置生成 G 代码。
- 应用默认参考设置
默认参考设置为 PLA、0.20 mm 层高、三层壁和 15% 填充率。这些设置尚未经过实体打印验证。
- 将小零件打印为实心
按钮参考设置使用三层壁、15% 配置填充率,以及顶部 20 层、底部 20 层,使这些小零件打印为实心。
- 小心移除叉形件支撑裙边
支撑住叉形件,同时轻轻剪除其裙边。
- 保持按钮孔和销钉尺寸
保留柔性摇臂片、压保持弹簧和开口销。不要扩大 2.4 mm 的按钮孔,也不要打磨掉 2.30 mm 销钉的工作直径。
- 上传并检查 Gerber 文件
原样上传 Gerber ZIP,并对照主板照片检查渲染外形、层分配、钻孔对位和预览图。
- 填写 PCB 制造设置
使用四层板、75 × 45 mm 外形、1.6 mm FR-4、外层 1 oz 铜和内层 0.5 oz 铜、绿色阻焊、白色丝印及无铅喷锡。确认制造商对过孔处理的解释,并确认其会制作所需的装配工艺边。
- 上传装配清单和贴片文件
申请 PCB 装配服务,并一起上传匹配的 BOM 和贴片坐标 CSV 文件。如果系统提示,请选择 UTF-8 和制表符分隔符,然后检查导入的零件映射。
- 按厂商编号匹配零件
使用指定的制造商零件编号和供应商零件编号匹配零件。不要让自由文本链接字段指向的无关产品覆盖 MPN/LCSC 的选择。
- 检查 PCB 装配预览
在装配预览中检查极性电容、USB-C 方向和底面连接器。下单前,应根据预期封装和电气功能确认所有替换件。
- 确认 U6 插座装配范围
U6 is a 2 × 20 female socket on the bottom side marked “HAND SOLDER BACK SIDE”. Agree whether the manufacturer fits it or whether it is supplied for hand assembly; do not fit it twice or on the top side.
- 检查可选装配元件
确认 BAT、LCD、H1/H2、编码器、扬声器/舵机排针、测试针和开关是否包含在装配服务中或单独提供。当指南不使用时,保持可选已装连接器的电气连接未用状态。
- 准备打印版本文件
使用打印文件中的配套独立 STL、参考 3MF 项目、修订紧固件和机械装配顺序。
- 使用相互匹配的 PCB 与打印版本
使用指南中列出的 PCB 版本与打印版本。
- 准备 PCB 制造文件
使用链接中的 PCB 制造文件获取 Gerber、BOM、布局文件、原理图 PDF 和可编辑的 EasyEDA 源文件。
- 使用外壳模型
使用 hardware/prints/README.md 中链接的外壳模型。
- 准备打印工具和零件
制作打印零件前,按照链接中的打印和工具准备指南进行准备。
组装
- 放置 PCB
将电路板元件面朝上,USB-C 接口朝左,LCD 和 H1 排针位于顶边。
- 识别连接器 1 脚端
在顶视图中,LCD、H1 和两个电机连接器的 1 脚均位于左端。
- 识别 H2 并保持空置
在此视图中,H2 的 1 脚位于上端;本次构建中 H2 保持空置。
- 识别电池极性
BAT 的 1 脚是右侧焊盘,连接电池正极;2 脚为负极。
- 识别扬声器连接器
SPEAKER/H3 的 1 脚位于左侧。H3 是制造文件中的名称,SPEAKER 是电路板丝印名称。
- 安装 U6 插座
母式 40 针插座安装在电路板底面。识别铜焊盘时不要镜像此顶视图。
- 接线前断开电源
进行接线和通断检查前,务必断开电池和 USB。
- 预接 LCD 和编码器
插入电路板组件前预连接 LCD 和 MENCODER_L,并让远端保持自由以便布线。
- 分别布设显示器外壳
将每个显示器外壳分别穿过直径 12 毫米的颈部开口。
- 保持舵机输出未使用
本次构建中不要使用 H2 和舵机输出。
- 连接 LCD 显示屏
按印刷的信号名称匹配:显示屏前两针为 GND、VCC,而 PCB 前两针为 VCC、GND。不要使用未经确认的直通线束;该显示屏的 SDA 和 SCL 是 SPI 数据与时钟,不是 ToF 传感器的 I²C 总线。
- 连接前向距离传感器
按照传感器印刷的标签,而不是物理从左到右的顺序,连接 VCC、GND、SDA、SCL 和 XSHUT。H1 第 5 针没有布线连接,H1 第 6 针连接树莓派物理针脚 33 / BCM13;空闲的 H2 连接器使用物理针脚 32 / BCM12 作为 XSHUT。
- 连接左侧电机编码器
按照 MENCODER_L 表格连接左侧六线电机电缆。编码器 VCC 为 3.3 V,电机电源是独立电路。
- 连接右侧电机编码器
按照 MENCODER_R 表格连接右侧六线电机电缆。编码器 VCC 为 3.3 V,电机电源是独立电路。
- 端接配套电机电缆
在编码器板上使用配套电机电缆,并将另一端按照对应接线表端接。左右始终以 Robbi 向前观察时的视角为准。
- 通电前识别电机针脚
现有参考资料尚未确定电机电缆的准确颜色分配。通电前应识别电机厂商的针脚标签,不要根据线缆颜色猜测编码器电源。
- 组装电子设备并安装机身
先在工作台上组装电子设备,再将它们装入打印的机器人机身。
- 识别电机与轮组
使用电机与车轮视频识别元件并参考一般组装技巧。修订后的电机夹具未在旧视频中演示。
- 识别头部组件
使用头部组装视频识别元件并参考一般技巧。由于旧视频没有展示固定头部和修订后的堆叠插入顺序,应按照书面修订版操作。
- 完成试装检查
在粘合机壳或给机器人通电之前完成所有试装检查。仅有 CAD 配合检查和切片检查不能证明实物配合或强度。
- 保持未使用的接口不连接
此构建不使用第二个 ToF 接口和舵机输出。
- 使用接线参考
使用 WIRING.md 查看俯视接口图、编号引脚、显示屏电源引脚交换和电源测试点。
- 组装期间断开电源
在更改接线或安装零件时,保持电源断开。
- 组装机器人机械和电子部件
安装电机、夹扣、支架和按钮,然后插入电子组件。按照 2026 年 10 月 13 日打印设计的组装指南,在插入电子组件后再安装固定头部。
软件与固件
- 开始首次安装向导
按照完整首次安装向导配置 `software/` 中的可复用运行环境。
- 通过 SSH 安装运行环境
当树莓派可通过 SSH 连接后,运行文档提供的安装命令。
- 配置终端安装向导
在终端向导中输入自己的 API 密钥,并选择模型、声音、仪表板密码、Wi-Fi 设置和可选的 Telegram 配置。正常运行随后会进入仪表板。
- 按照一键安装指南操作
按照 03-software.md 完成最简终端设置、自动启动和配置生成。
- 设置右编码器针脚
此 PCB 应设置 `hardware.right_encoder_b_pin: 16`。GPIO7 仅用于修复原机器人故障的树莓派,因此不要连接 GPIO7 和 GPIO16。
- 安装 Raspberry Pi 软件
Prepare Raspberry Pi OS Bookworm Lite 64-bit and connect to the Raspberry Pi by SSH. Follow the linked first setup guide.
标定与测试
- 观看元件识别与测试指南
使用该 4K 静音建造视频识别元件、进行电子测试并参考一般组装技巧。视频展示的是较早的机壳,因此应按照 2026 年 10 月 13 日打印版本的书面步骤操作。
- 执行最终检查
使用最终检查视频中展示的程序完成最终检查。同时注意尚未解决的轮子与胎面打印设置、紧固件、电机线缆识别以及实测功率和负载限制。
- 先完成台架测试再安装外壳电子设备
在将电子设备安装到外壳中之前,先完成台架测试。
- 记录构建版本和测试结果
使用 build-record.csv 记录版本、测量值和测试结果。
- 抬起两个车轮进行电机检查
首次进行通电电机检查时,抬起两个车轮。
- 在安全区域进行地面测试
地面测试应使用远离边缘的平坦空旷区域,因为前向 ToF 传感器不提供悬崖检测。
- 在工作台上测试电子设备
先将裸 PCB 接入 Raspberry Pi 前进行验证。使用链接中的工作台测试检查每个外设。
- 校准 Robbi 并执行最终检查
按照链接的校准指南完成 IMU 和电机校准以及语音测试。如果检查失败,使用故障排除指南。
- 检查方形 1 脚焊盘
当已安装的连接器遮住 1 脚轮廓时,请检查方形铜焊盘。