正在连接信源…

Blossom 手工开源社交机器人 复刻全流程

Blossom 手工开源社交机器人 从采购、打印、组装到装软件、标定和训练的 158 个步骤,附物料表、购买链接与官方出处。

不出售。重制版文档称 Dynamixel 方案元件总价不到 200 美元,微型舵机加 Arduino 方案约 50 美元(GitHub blsm.md,2026‑10‑31);原版物料单只列零件不列价格

物料 · Parts

零件数量ANY
blsm_A · Part runner · Print1
blsm_B · Part runner · Print2
blsm_C · Part runner · Print2
blsm_D · Part runner · Print1
blsm_E · Part runner · Print3
blsm_F · Part runner · Print3
blsm_M · Part runner · Print4
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 rota1USD 22
String · String for actuating the head · Purchase (e.g. fishing line, twine)1USD 5
Rubber bands, 4mm diameter · Rubber bands for hanging the head platform · Purchase e.g. black rubber bands6USD 8

物料 · Motors and electronics

零件数量ANY
Arduino (or clone) · Microcontroller and cable · Purchase1USD 15
Micro servo · Small servos with basic position control · Purchase4USD 10
Dynamixel U2D2 · Motor controller · Purchase1USD 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 姿态与高度

    移动手机可控制机器人的俯仰、偏航和横滚姿态;滑块可控制中心高度和耳朵。

常见问题

  • 电机ID修改与校准脚本无法成功运行 #1 #39 #91 #93
  • Blossom的Expo SDK及安装发布工具无法正常使用 #4 #32
  • 缺少Python依赖模块导致安装失败 #31
  • 序列接口异常导致网页手势控制无法使用 #2
  • 指定紧固件与木材缺货或尺寸不兼容 #6 #8 #9
  • 装配文档及六毫米模板存在错误和缺件 #12 #92

物料

  • 原版: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)

文档