Qubit 复刻全流程
Qubit 从采购、打印、组装到装软件、标定和训练的 43 个步骤,附物料表、购买链接与官方出处。
Qubit 是一款双臂桌面机器人,由两只 SO-100 机械臂组成,带 16×16 LED 表情眼睛、氛围 RGB 灯管和树莓派大脑。仓库提供可 3D 打印的结构件(STL/3MF)、完整物料清单、布线图、打印设置以及用于遥操作、视觉、表情动画和网页面板的 Python 代码。
物料 · bill of materials — per SO-100 arm
| 零件 | 数量 | CN | US |
|---|---|---|---|
| STS3215 Servo (C001, 1/345 gear) · $14 · €13 · ¥97.72 | 6 | ||
| Motor Control Board · $11 · €12 · ¥27 | 1 | ||
| USB-C Cable 2-pack · $7 · €7 · ¥23.90 | 1 | ||
| Power Supply (7.5V DC) · $10 · €13 · ¥22.31 | 1 | ||
| Table Clamp 2-pack · $5 · €8 · ¥7.80 | 1 | ||
| Screwdriver Set · $6 · €10 · ¥14.90 | 1 | ||
| per arm · $123 · €128 · ¥682 | |||
| 2 arms total · $246 · €256 · ¥1,364 |
采购
- 购买两个 SO-100 机械臂
每个 Qubit 使用 2× SO-100 机械臂,机械臂数量乘以 2。
- 选择遥操作领臂舵机
可选的 SO-101 遥操作领臂需要 6× STS3215,具体为 3× C046、2× C044、1× C001。该组合在 Alibaba 上有售。
- 核对齿比和电源规格
订购前核对齿比;从动臂全部使用 1/345(C001)。每个机械臂的电源必须输出 7.4–7.5V DC,最低 5A。
- 按完整系统清单采购
按照完整系统 BOM 采购其余组件。美国的完整构建成本估算约为 700–800 美元,具体取决于采购来源。
打印与加工
- 打印结构部件
使用 Bambu Lab A1 打印所有结构部件,材料可使用 PLA+ 或 PETG。
- 设置打印参数
层高设置为 0.2mm,填充设置为 40% Gyroid,机械臂关节支架需要支撑。
- 选择受力部件材料
主体框架和肩部支架使用 PETG,因为它们承受最大的扭矩应力。PLA+ 可用于外观外壳。
组装
- 连接树莓派与外设
用 USB-A 将 Raspberry Pi 5 连接到左、右机械臂的电机板,并用 USB-C 连接 5V/5A 电源。GPIO/BLE 连接 16×16 LED 矩阵,GPIO PWM 连接左右 WS2812B LED 灯管,CSI/USB 连接可选的 Pi Camera。
- 连接电机板和舵机总线
每个电机板通过 USB-C 连接专用 7.5V DC 电源,并通过串联总线连接 6× STS3215 舵机。切勿通过树莓派的 USB 端口为舵机板供电,以免电压下降和损坏舵机。
软件与固件
- 安装 Raspberry Pi OS
Prepare Raspberry Pi OS Bookworm 64-bit, Python 3.10+, and Git. Download Raspberry Pi OS from the linked Raspberry Pi website.
- 克隆量子机器人代码
克隆 GitHub 上的 qubit 仓库并进入 qubit 目录。
- 创建并激活虚拟环境
使用 Python 3 创建 .venv 虚拟环境,并在当前终端中激活它。
- 安装项目依赖
在已激活的虚拟环境中安装 requirements.txt 中列出的依赖。
- 安装遥操作支持
如果需要遥操作支持,可安装 lerobot。
- 创建并编辑配置文件
将 config/config.example.yaml 复制为 config/config.yaml,然后用 nano 编辑配置文件。
- 设置开机运行空闲循环
在 Raspberry Pi 上运行脚本,以在后台启动空闲行为循环。
- 编辑或预览 LED 表情
使用网页控制面板内置的表情编辑器,或在本地运行 emote_preview.py 进行预览。
- 启用蓝牙
启用 Bluetooth 服务。
- 安装 OpenCV
安装无界面的 OpenCV Python 软件包。
- 启用摄像头
运行 `sudo raspi-config`,进入 Interface Options,然后选择 Camera 以启用摄像头。
标定与测试
- 配置机械臂舵机
在配置文件中设置左右机械臂的串口和舵机 ID:左臂为 /dev/ttyUSB0 与 1–6,右臂为 /dev/ttyUSB1 与 7–12。
- 配置 LED 矩阵
将 LED 矩阵类型设置为 idotmatrix,尺寸设置为 16,连接方式设置为 bluetooth,并将 mac_address 替换为自己的地址。
- 配置 LED 灯带
设置 LED 灯带的左侧引脚为 18、右侧引脚为 19,像素数量为 30。
- 配置摄像头
摄像头默认关闭;设备编号为 0,分辨率为 640×480。
- 映射机械臂串口
运行 ls /dev/ttyUSB* 查找串口,并通过分别插拔每个机械臂来确定端口对应关系。
- 检查舵机端口
运行 `ls /dev/ttyUSB*` 检查端口分配。
- 验证电源规格
确认每个机械臂的电源为 7.4–7.5V、5A 以上。
- 运行舵机诊断
运行诊断脚本并检查全部机械臂。
- 扫描舵机 ID
运行扫描工具查找舵机 ID。
- 配对 LED 矩阵
打开 `bluetoothctl`,扫描设备,然后使用 LED 矩阵的 MAC 地址进行配对。
- 核对配置文件中的 MAC
确认 `config.yaml` 中的 MAC 地址与 LED 矩阵一致。
- 重新校准左臂
运行校准脚本重新校准左臂。
- 检查机械卡滞
检查机械臂是否卡住;首次打印的尺寸公差可能造成此问题。
- 降低舵机轮询频率
在 `config.yaml` 中将 `teleop.hz` 设置为 `50`。
- 确认 Python 和虚拟环境
确认使用 Python 3.10 或更高版本,并且虚拟环境已激活。
采数据与训练
- 录制右臂挥动演示
运行录制脚本,并将右臂运动保存到 demos/wave.json。
- 移动手臂完成录制
录制开始后,物理移动手臂以采集动作。
- 循环回放挥动演示
读取 demos/wave.json,并将挥动演示循环播放3次。
用起来
- 启动网页控制面板
运行 dashboard.py 启动网页控制面板。
- 打开本地仪表板地址
在浏览器中打开 http://qubit.local:5000。
- 播放单个 LED 表情
使用 led_matrix.py 播放名为 happy 的单个表情。表情存放在 /emotes 中,并描述16×16像素帧序列。
- 播放 LED 表情序列
按 startup、happy、blink 的顺序播放一组 LED 表情。
- 无限循环 LED 表情
持续循环播放名为 sleep 的 LED 表情。