正在连接信源…

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 so1
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 脚轮廓时,请检查方形铜焊盘。

文档