Blossom 手工开源社交机器人 复刻全流程
Blossom 手工开源社交机器人 从采购、打印、组装到装软件、标定和训练的 158 个步骤,附物料表、购买链接与官方出处。
不出售。重制版文档称 Dynamixel 方案元件总价不到 200 美元,微型舵机加 Arduino 方案约 50 美元(GitHub blsm.md,2026‑10‑31);原版物料单只列零件不列价格
物料 · Parts
| 零件 | 数量 | ANY |
|---|---|---|
| blsm_A · Part runner · Print | 1 | |
| blsm_B · Part runner · Print | 2 | |
| blsm_C · Part runner · Print | 2 | |
| blsm_D · Part runner · Print | 1 | |
| blsm_E · Part runner · Print | 3 | |
| blsm_F · Part runner · Print | 3 | |
| blsm_M · Part runner · Print | 4 | |
| blsm_SR · *S*lip *R*ing for rotating the upper body · Print the static non-rotating 'dummy' model, or use the actual 12-wire slip ring to enable continuous rota | 1 | USD 22 |
| String · String for actuating the head · Purchase (e.g. fishing line, twine) | 1 | USD 5 |
| Rubber bands, 4mm diameter · Rubber bands for hanging the head platform · Purchase e.g. black rubber bands | 6 | USD 8 |
物料 · Motors and electronics
| 零件 | 数量 | ANY |
|---|---|---|
| Arduino (or clone) · Microcontroller and cable · Purchase | 1 | USD 15 |
| Micro servo · Small servos with basic position control · Purchase | 4 | USD 10 |
| Dynamixel U2D2 · Motor controller · Purchase | 1 | USD 32 |
采购
- 选择 Dynamixel 标准配置
为完整功能版本选择 Dynamixel 智能舵机;它们支持位置或速度控制模式、速度和加速度曲线以及 PID 调整。
- 选择低成本 Arduino 配置
使用 Arduino 和微型舵机,成本约为 50 美元,相当于一个 Dynamixel;运动更嘈杂且不够平滑,左右偏航旋转限于 ±90°。
- 准备 USB 电源断线器和线缆
Dynamixel 和 Arduino 配置都需要用于供电的 USB 断线器以及一些线缆。
- 购买 M2 最小硬件套装
M2 所需的最小硬件全部包含在所链接的套装中,价格为 10 美元。
- 查阅 Blossom 建造指南
按建造指南制作自己的 Blossom;文档还说明,运行机器人前需要完成上述基础软件设置。
打印与加工
- 下载 Blossom STL 文件
从所列目录下载完整 runner STL(如 blsm_A)或单独的零件 STL(如 A1)。
- 打印 Blossom 零件
使用入门级 Creality Ender 3 打印下载的零件。
- 使用 Cura 配置文件切片
在 Cura 中打开 STL 文件,并使用文档提供的 blsm-020.curaprofile 配置文件进行切片。
- 打印或激光切割模块化零件
将重新设计拆分为较小零件,单独打印或像注塑模型套件一样打印成“runner”;若用木材激光切割,需要调整公差。
组装
- 按照指南组装机器人
按照链接的 Blossom PDF 装配说明组装打印出的机器人。
- 连接 U2D2 控制器和外部电源
按照接线文档设置 Dynamixel 配置,将 U2D2 控制器连接到外部电源。
- 按指定顺序排列电机
从上到下依次为:4 是底座电机,3 是机器人左电机,2 是机器人右电机,1 是机器人前电机。
- 连接 Pico 与 Zero 的 UART
在拔下 USB 后,将 Pico 的 UART 引脚连接到 Pi Zero。
- 连接电机到 Pico
将电机连接到 Pico。
- 连接 5V 电源
将电机连接到 5V 电源。
- 插入 microSD 卡
将 microSD 卡插入 Pi Zero。
- 断开 Pico 连接
将 Pico 从计算机断开。
- 连接 Pico 与 Zero
按照接线图,将 Pico 的电源引脚和 UART 引脚连接到 Zero。
- 连接舵机供电与 GPIO
按照接线图,将舵机连接到 Pico 的 GPIO 引脚和独立电源。
- 为舵机接入五伏 USB 电源
XL-330 的标称工作电压为5V,可从任意USB电源方便取电。
软件与固件
- 克隆 r0b0 仓库及子模块
在计算机上克隆 r0b0 仓库,并包含其子模块。
- 连接 Pico 的 USB
将 Pico 连接到计算机的 USB。
- 加载 Pico 固件
将固件加载到开发板。
- 构建并加载 C++ 固件
在计算机上构建 C++ 固件并将其加载到开发板。
- 复制固件文件
将所需文件从计算机复制到 Pico,然后拔下 USB。
- 下载 Raspberry Pi Imager
在计算机上下载文档中称为“Raspbery Pi Imager”的 Raspberry Pi Imager。
- 备份项目镜像
备份项目的镜像。
- 将镜像写入 microSD 卡
使用 Raspberry Pi Imager 将镜像写入 microSD 卡。
- 连接 Zero 的数据 USB 接口
通过 USB 连接 Pi Zero;必须使用 Zero 的 USB 数据接口,而不是 PWR 接口。
- 在 Zero 上克隆仓库
在 Pi Zero 上克隆项目仓库。
- 安装 Docker
在 Pi Zero 上安装 Docker。
- 启用串行通信
在 Pi Zero 上启用串行通信。
- 构建容器
在 Pi Zero 上构建项目容器。
- 配置开机自动运行服务
配置服务,使其在启动时自动运行。
- 重启 Pi Zero
重启 Pi Zero。
- 克隆固件仓库
在本地计算机上克隆 micropython-servo 仓库,不要在 Zero 上操作。切换到 msgtn/251210 分支并进入 cpp 目录。
- 连接 Pico
通过 USB 端口将 Pico 连接到计算机,然后按所列说明安装 Pico SDK、构建固件并加载固件。
- 安装 Pico SDK
克隆 raspberrypi/pico-sdk 仓库并初始化其子模块。将 PICO_SDK_PATH 设置为计算机上 pico-sdk 的实际路径。
- 安装构建依赖
安装 cmake、gcc-arm-none-eabi、libnewlib-arm-none-eabi 和 picotool。
- 配置并编译固件
进入 cpp 目录,创建 build 目录,并运行 CMake 配置与构建。默认构建配置用于 PWM 舵机。
- 完成固件构建
进入 build 目录,并使用四个并行任务运行 make。
- 加载 Pico 固件
将 Pico 置于 BOOTSEL 模式,然后加载 servo_controller.uf2。
- 重启进入应用模式
固件加载完成后,重启 Pico,使其进入应用模式。
- 下载 Raspberry Pi Imager
下载 Raspberry Pi Imager。
- 连接 microSD 卡
将 microSD 卡连接到计算机。
- 将系统映像写入 SD 卡
打开 Raspberry Pi Imager,并将映像写入 SD 卡。
- 选择 Zero 2W 系统映像
选择 Pi Zero 2W 的 Bookworm 64-bit 映像。该选项可能隐藏在 “other” 或 “legacy” 部分中。
- 配置本地网络
将 Zero 配置为连接本地网络。
- 设置 Zero 用户名
将 Zero 的用户名设置为 blsm。启动服务需要使用此用户名。
- 启用 SSH
在 Raspberry Pi Imager 中启用 ssh。
- 连接到 Zero
通过 SSH 使用 blsm 账户登录 Zero 的 IP 地址。
- 安装依赖并测试 Docker
进入顶层 r0b0 目录,安装包括 WiFi 接入点配置器在内的依赖,然后运行 hello-world 测试 Docker。
- 构建 Blossom 容器
在 r0b0 顶层目录中构建 Blossom 容器。
- 配置 WiFi 接入点
启动 WiFi 接入点配置工具,并保存输出的 SSID 和密码。
- 启用串口设备
编辑 /boot/firmware/config.txt,在文件末尾添加 enable_uart=1,然后按 Ctrl-X 并按 Y 保存退出。
- 设置开机启动服务
运行服务脚本,使 blsm 容器在启动时自动运行。
- 重启 Zero
重启 Zero,使 /dev/serial0 的启用配置生效。
- 安装 Expo Client
通过 Expo Client 应用在 Android 或 iOS 上安装 Blossom App。
- 安装构建工具
要自行构建应用,电脑上必须安装 npm 或 yarn。
- 在 OSX 安装 watchman
在 OSX 上,使用 brew 安装 watchman。
标定与测试
- 配置 Zero 无线接入点
在 Pi Zero 上配置无线接入点。
- 命令电机进入校准位置
通过控制界面命令所有电机移动到校准位置。
- 按配置方向重新安装舵机
将舵机重新安装或安装到校准配置所要求的方向。
- 拆下车轮
如果车轮已经安装在舵机上,请先将其拆下。
- 打开校准界面
在界面中点击 `Calibration`,或访问 `https://{ip-address}:8080/blsm_calib`。
- 重置到校准位置
点击 `Reset to Calibration Position`,使所有电机移动到校准位置。
- 重新安装车轮
重新安装车轮,使字符串朝下,或使舵机舵盘与舵机机身对齐。
- 设置 XL330 电机目标位置
将电机 2 的目标位置设为 1000;塔使用 1000,底座使用 2000。
- 设置 XL320 电机目标位置
将电机 2 的目标位置设为 700;塔使用 700,底座使用 500。
- 停止位置设定脚本
按 Ctrl+D 停止脚本。
- 校准其余两个电机
对电机 ID 3 和电机 ID 4 重复上述目标位置设置。
- 修复端口权限错误
如果打开端口时出现错误,将 /dev/ttyACM0 的权限改为 777。也可以使用管理员权限重新运行所有步骤。
- 设置串口访问权限
If the “could not open port” error appears, run the example permission command on the port.
- 指定 Linux 的实际 IP 地址
如果 Linux 默认使用回环 IP `127.0.1.1`,必须使用 `-i` 指定 IP 地址。
- 读取启动提示中的 IP 地址
从启动提示框中读取 Blossom 显示的 IP 地址和端口;示例地址为 `10.132.3.171:8000`,实际地址会不同。
- 连接并启用机器人控制
在 `Host` 字段中输入 IP 地址,然后开启 `Control robot`。
- 更新编辑器的 IP 地址
在编辑器中输入 IP 地址,然后按 `Update IP Address`。
- 调整动作幅度和姿态
调整播放速度、夸张幅度以及向前或向后倾斜的姿态。
- 设置调整乘数
在“multiply by”块中输入乘数,将该块连接到 Adjustment 块;一次只能使用一个调整块。
- 创建 docker 组
某些 Linux 发行版通过包管理器安装 Docker Engine 时会自动创建该组,此时无需手动创建。
- 将用户加入 docker 组
使用 `usermod` 将当前用户加入 `docker` 组。
- 重新登录以更新组权限
退出登录后重新登录以重新评估组成员身份。在 Linux 虚拟机中,必要时重启虚拟机;也可运行 `newgrp docker` 激活组权限变更。
- 验证无需 sudo 运行 Docker
运行 `docker run hello-world`。该命令下载测试镜像并在容器中运行;容器运行后会打印消息并退出。
- 修复 Docker 配置权限
如果此前使用 `sudo` 运行 Docker CLI 导致 `~/.docker/` 权限错误,可删除该目录,系统会自动重建,但自定义设置会丢失;也可更改该目录的所有权和权限。
- 验证用户与 Docker 组
确认用户 ID 未改变,主组为 `docker`,并通过运行 `hello-world` 测试 Docker 访问。该 shell 中启动的命令和应用会继承 Docker socket 访问权限。
- 确认原始 Shell 的组列表
在原始 shell 中运行 `id -nG`,确认组列表不再包含 `docker`。
- 输入主机 IP 地址
输入运行 `start.py` 时显示在“Starting server on *IP_address*:8000”下的主机 IP 地址,也可以通过其他方式查找。
- 启用机器人控制
输入 IP 地址后,返回控制器并开启 `Control Robot`。
- 恢复 Android 应用焦点
如果 Android 上起初无法控制 Blossom,请让应用失去焦点,然后重新获得焦点。
采数据与训练
- 连接 USB 摄像头
将 USB 摄像头连接到电脑。
- 打开广播控制页面
保持 start.py 和 ngrok 隧道脚本运行,在控制机器人的台式机或笔记本电脑上打开广播页面。
- 选择摄像头视频源
在下拉菜单中选择已连接的摄像头,页面上应开始显示视频。
- 打开移动端转发地址
在移动设备浏览器(例如 Safari)中打开 ngrok 转发 URL。
- 处理自签名证书警告
浏览器可能显示隐私警告;可按照文档链接的指南绕过该警告,因为开发是在本地进行的。
- 确认视频画面
移动端页面应显示从广播页面所选摄像头传来的视频。
- 水平持握手机
将手机向前平伸,就像直接拍摄前方物体一样。
- 启用头部姿态控制
切换 head 开关以启用控制,并开始向机器人发送手机方向数据。
- 确认电机命令正在发送
电机控制器应开始闪烁蓝灯,表示正在发送电机命令。
用起来
- 运行点头动作序列
输入 `s`,按 Enter,然后输入 `yes`,让 Blossom 点头。
- 查看可用命令
输入 `l` 可列出可用的动作序列。
- 执行指定动作序列
输入 `s`,按 Enter,再输入序列名称。
- 循环运行动作序列
用 `=` 分隔两个序列名称;例如输入 `s`、按 Enter、输入 `yes=no`,会先播放 `yes`,然后无限循环 `no`,直到播放其他序列。
- 退出命令行界面
输入 `q` 退出 CLI。
- 访问 Blossom 图形界面
启动 CLI 时若未指定 `-b`,可通过 `localhost:8000` 或显示的 IP 地址加 `:8000` 访问 GUI;否则 CLI 会打印服务器 URL。
- 控制机器人姿态和高度
移动手机控制机器人的俯仰、偏航和横滚姿态,并使用滑块调节高度。
- 设置机器人的默认朝向
默认情况下,机器人会完全模仿手机的朝向,因此机器人应背对你。
- 镜像手机朝向
将 `Mirror` 切换为 `On`,机器人就会面向你,并注视手机顶部。
- 打开视频编辑器
在新终端中运行适用于 Ubuntu 或 Mac 的命令,然后按 Enter,打开视频编辑器。
- 加载要观看的视频
将视频 URL 粘贴到字段中,然后点击 `Update Video`。
- 添加手势起始块
在视频编辑器左侧使用 Gesture 块,输入起始时间和手势名称。
- 连接手势块
将各块一起连接到初始块,才能触发相应手势。
- 创建并重新载入手势
使用手机应用创建新手势,然后在视频编辑器中按 `Reload Gestures` 使用它们。
- 设置动作循环
勾选 `Loop`,让动作持续重复,直到下一个手势开始。
- 连接 Zero 的无线接入点
从计算机连接到 Zero 的无线接入点。
- 打开 Zero 的控制界面
访问地址为 192.168.90.1:8080 的控制界面。
- 从局域网访问接口
通过与 SSH 相同的 IP 地址访问 https://{ip-address}:8080;必须使用 https,http 无法工作。
- 绕过自签名证书警告
访问接口时绕过安全警告,因为其证书是自签名证书。
- 连接 Zero 接入点
连接 Zero 启动的接入点。SSID 可能类似 raspberrypi-someNumbersAndLetters,密码是运行 sudo wifi-ap-sta start 后打印的密码。
- 通过接入点访问接口
连接接入点后,通过 https://192.168.90.1:8080 访问接口,无论 Zero 的本地 IP 地址是什么。
- 仅在 Shell 中执行 Docker 操作
仅将该 shell 用于 Docker 相关命令,或者验证所创建文件的组所有权。该 shell 中创建的文件和目录通常归 `docker` 组所有。
- 控制 Blossom 姿态与高度
移动手机可控制机器人的俯仰、偏航和横滚姿态;滑块可控制中心高度和耳朵。
常见问题
物料
- 原版:Dynamixel XL‑320 ×5(3 个塔柱电机牵线控制头部、1 个底座转向、1 个头部配件电机),USB2AX 或 USB2Dynamixel 控制器,5V 电源
- 原版结构:12″×12″ 6 mm 与 3 mm 工艺胶合板激光切割、1.5 mm 亚克力滑轮、3D 打印中心支架、轴承、#32 橡皮筋 ×6、钓鱼线
- 重制版电机:Dynamixel XL330‑M288 ×4 + U2D2(约 132 美元),或 Arduino + 4 个微型舵机(约 25 美元)
- 重制版结构:A–F 与 M 板件(可打印或激光切割)、可选 12 线滑环实现 360° 以上连续旋转(约 22 美元)、4 mm 橡皮筋 ×6、M2 螺丝
- 2026 年控制方案:树莓派 Zero 2 W + 树莓派 Pico(C++ PWM 舵机固件)
- 外壳:自行针织或钩织布套(wiki 提供尺寸示例)
工具
- 原版:12″×12″ 激光切割机与小型 3D 打印机、螺丝刀、钳子、木工胶与强力胶;延长舵机线需焊接与热缩
- 重制版:入门级 3D 打印机(作者用 Creality Ender 3 与附带的 Cura 配置)、斜口钳、5V 3A(15 W)以上 USB 电源
技能
- Python 与命令行(Linux/macOS),舵机 ID 设置与校准
- 针织或钩织外套与配件制作
- 重制版可选:树莓派镜像、Docker 与 ROS 2
软件
- hrc2/blossom-public:Python 命令行与网页界面、React Native 手机 App、Blockly 视频编舞编辑器
- msgtn/r0b0:Flask‑SocketIO 消息中间件,移动网页体感遥控、WebRTC 图传、动作录制回放与 llm 库对话;2026 年加入 ROS 2 节点与 Docker 开机服务
- msgtn/micropython-servo:树莓派 Pico 舵机固件(MIT)