LeLamp 开源表情机器人台灯 复刻全流程
LeLamp 开源表情机器人台灯 从采购、打印、组装到装软件、标定和训练的 102 个步骤,附物料表、购买链接与官方出处。
不出售,无套件。作者 BOM 表按美国参考价合计 310.64 美元(2026‑11‑01 读取,含 3D 打印件 30 美元,不含工具、运费与税);README 另写约 260 美元。作者注明 BOM 中的购买链接仅供参考
采购
- 确认技能与建造时间
确认具备电子焊接与电路理解、元件识别、3D 打印操作与后处理、命令行及 SSH 使用、Linux 基础管理、热熔螺母安装和舵机固定等经验。计划在 2–3 天内完成,预计总耗时 8–12 小时。
- 准备电子工具
准备 15–25W 温控烙铁、60/40 松香芯焊锡(0.6–0.8mm)、剥线钳、小号螺丝刀、连续性测试万用表和防静电腕带。
- 准备机械工具
准备热熔螺母专用烙铁头或工具、M2 和 M3 内六角扳手、小号尖嘴钳、剪线钳或斜口钳,以及用于尺寸核验的数字卡尺。
- 查阅 LeLamp 物料清单
在 LeLamp 物料表中查阅完整物料清单。表内链接仅供参考,不必从这些链接购买,应尽可能寻找所在地区的最优惠价格;美国预计总成本为 310.64 美元。
- 准备 3D 打印机或打印服务
开始前,确保可以使用 3D 打印机或打印服务。
- 准备 Pi 配置用计算机
开始前,确保有可用于 Raspberry Pi 设置和舵机配置的计算机。
- 准备 Pi 连接用 WiFi
开始前,确保有可供 Raspberry Pi 连接的 WiFi 网络。
- 下载并阅读全部文档
下载并阅读所有文档,以便完成后续准备、打印和装配工作。
- 采购所有组件
根据物料清单采购所有组件,并确认各组件工作正常。
- 准备工具与舵机组件
准备电脑、舵机驱动板、USB 线缆、5 个 STS3215 舵机和舵机驱动板。
- 准备所需组件
准备树莓派、ReSpeaker Hat、扬声器、LED 矩阵、SD 卡和舵机驱动板。
- 准备所需硬件
准备 Raspberry Pi、SD 卡,以及电脑、USB 数据线和 SD 卡读卡器。
- 登记购买套件意向
通过文档中的 Google 表单登记购买套件的意向。
打印与加工
- 获取 LeLamp 打印文件
在仓库的 `/3D/` 文件夹中找到 LeLamp 的全部 `.3mf` 打印文件;也可以查看文档中的 OnShape 设计。
- 打印灯座
打印 1 个 Lamp Base。它包含舵机驱动板和一台普通的 pi。
- 打印灯座盖
打印 1 个 Lamp Base Cover,用于覆盖灯座。
- 打印底座至肘部灯臂
打印 1 个 LampArm(Base to Elbow)。它包含底座俯仰舵机和肘部俯仰舵机。
- 打印肘部至腕部灯臂
打印 1 个 LampArm(Elbow to Wrist)。它包含肘部俯仰舵机和腕部滚转舵机。
- 打印两个俯仰灯臂
打印 2 个 LampArm(Pitch)。该部件包含底座俯仰舵机或腕部俯仰舵机。
- 打印灯头
打印 1 个 Lamp Head。它包含 LED 矩阵和扬声器。
- 打印灯头扩散罩
打印 1 个 Lamp Head - Diffuser,用于扩散 LED 矩阵的光线。
- 参考最佳打印方向和顺序
按照 Print Plate 图片所示的打印方向和零件打印顺序进行打印。
- 设置打印参数
使用所选打印机的默认设置,并采用这些参数:PLA 耗材、0.2mm 层高、15% 填充密度、启用支撑、树状支撑。
- 设置 3D 打印要求
使用最小打印空间为 200×200×150mm 的打印机,推荐 PLA+,也可使用 PETG。标准层高为 0.2mm,关键部件为 0.15mm;填充率至少 20%,结构部件使用 30%,部分零件需要支撑。
- 打印所有 3D 零件
使用 3D 打印机或打印服务打印全部零件。
组装
- 准备以太网线
剥去以太网线的绝缘层,露出其中的独立导线。
- 焊接扬声器和 LED 矩阵
将每根以太网线焊接到扬声器和 LED 矩阵的焊盘上,并记录每根线连接的对应焊盘。
- 参考 WS2812B 接线教程
如果不熟悉 WS2812B LED 的接线方式,请参阅文档中的教程链接。
- 可选用独立电线
也可以用独立电线代替以太网线,但每根电线至少需要 50 cm 长,以便从头部连接到底座。
- 安装底座电子设备
按照图示将电机驱动板和 Raspberry Pi 固定在底座内部。
- 连接驱动板与 Raspberry Pi
使用 USB Type-C 线连接电机驱动板和 Raspberry Pi。
- 焊接 ReSpeaker Hat 排针
按照图示在 ReSpeaker Hat 上焊接排针。
- 连接 ReSpeaker Hat
按照下方图示的方向连接 ReSpeaker Hat。
- 连接灯头与扬声器线路
在来自灯头的以太网线另一端,将母排线连接器焊接到每根线,并将 JST2.0 公头焊接到扬声器线。按照原理图将每根线匹配到 ReSpeaker Hat 的对应引脚,JST2.0 扬声器可直接连接 ReSpeaker Hat 的扬声器端口。
- 通电前检查所有连接
通电前仔细检查所有连接;接线错误可能损坏元件。
- 参照 OnShape 组装灯体
打开 OnShape Assembly,在组装电机和灯具部件之前查看完整章节,并参考每个电机和部件的准确方向与位置。
- 遵守机械安全要求
热熔螺母工具温度会超过 200°C,应使用适当工具。操作带张力的舵机角时佩戴护目镜,并注意小零件造成的窒息危险。
- 焊接排针和连接器
为电子部件焊接排针和连接器。
- 安装热熔螺母
将热熔螺母安装到 3D 打印零件中。
- 将舵机安装到打印件中
使用打印件中的安装位固定舵机。
- 将布线穿过机身
将电子布线穿过机身并整理到预定位置。
- 装配头部组件
将 LeLamp 的头部组件组合安装。
- 拆开舵机并平放在桌上
拆开舵机包装,并将舵机平放在桌面上。
- 标记五个舵机的预定位置
给5个舵机贴上其预定位置标签。
- 连接树莓派和舵机驱动
通过 USB 端口将树莓派连接到舵机驱动器。
软件与固件
- Flash Raspberry Pi OS Lite
Use Pi Imager to flash Raspberry Pi OS Lite (64-bit) onto the Raspberry Pi.
- 通过 SSH 连接 Raspberry Pi
刷写完成后,使用用户名和本地主机名通过 SSH 连接到 Raspberry Pi。
- 克隆 LeLamp Runtime
下载 humancomputerlab 的 lelamp_runtime 仓库。
- 安装 uv
运行安装脚本,为 LeLamp Runtime 安装 uv。
- 安装音频依赖
使用 apt-get 安装 portaudio19-dev 音频依赖。
- 同步运行时依赖
进入 lelamp_runtime 目录,并使用 hardware 额外依赖运行 uv sync。
- 安装 ReSpeaker 设备树覆盖
获取 ReSpeaker 2-Mics Pi HAT (V2.0) 的 DTS,编译为 DTBO,然后安装并复制设备树覆盖文件。
- 编辑 Raspberry Pi 启动配置
在 /boot/firmware/config.txt 中启用 ReSpeaker 2-Mics Pi HAT V2.0 覆盖和 i2s-mmap。
- 编辑 sudo 声音配置
编辑 /etc/asound.conf,为 sudo 配置声音设置。
- 配置 Seeed 2-Mic 默认音频设备
将默认采集和播放设备设为 Seeed 2-Mic,音频硬件为 hw:3,0;默认控制卡片设为 3。
- 重启设备
重启设备,使默认音频设备配置生效。
- 查找 uv 的完整路径
如果以 root 身份找不到 uv,运行 which uv 查看其位置。
- 将 uv 路径加入 sudo 安全路径
运行 sudo visudo,并将 /home/pi/.local/bin 添加到 sudo 的 secure_path。
- 设置 sudo secure_path
按示例设置 Defaults secure_path,并将 <your_user_name_here> 替换为实际用户名。
- 下载并设置 LeLamp 运行时
在个人电脑上使用 CLI 终端克隆 LeLamp Runtime 仓库,进入仓库目录,安装 uv,然后运行 uv sync 设置运行时。
- 将舵机ID配置为1至5
将舵机ID正确配置为1至5,并确保每个ID唯一。
- 完成电机设置脚本
运行电机设置脚本并确认其成功完成。
- 解决权限错误
遇到权限错误时,可能需要使用`sudo`,或将用户添加到dialout组。
- 解决舵机ID冲突
如果舵机ID冲突,请确保每个舵机都有唯一的ID。
- 获取 LeLamp Runtime 仓库
开始前,确保可以访问 LeLamp Runtime 仓库。仓库地址为 https://github.com/humancomputerlab/lelamp_runtime。
- 设置软件环境
在准备阶段设置好 LeLamp 所需的软件环境。
- 设置 Raspberry Pi OS
在电子准备阶段安装并设置 Raspberry Pi OS。
标定与测试
- 配置 Raspberry Pi 设置
设置 Wifi SSID 和密码、用户名和密码、主机名,并启用 SSH。
- 检查音频设备是否启用
运行 aplay -l;预期输出会列出 seeed2micvoicec 及其 tlv320aic3x-hifi 子设备。
- 调整 Seeed 2-Mic 音量
在 alsamixer 中按 F6 选择 seeed2micvoicec,编辑 Line、Line DAC 和 PCM 设置。首次尝试时将音量设为 100;若 Line 默认静音,选中 Line 后按 M 取消静音。
- 运行 RGB 功能测试
使用 sudo 运行 lelamp.test.test_rgb 模块来测试 RGB。
- 使用 uv 的完整路径测试 RGB
用 which uv 输出的路径替换 uv,例如运行 sudo /home/pi/.local/bin/uv run -m lelamp.test.test_rgb。
- 测试麦克风和扬声器
运行音频测试命令,检查 LeLamp 的麦克风和扬声器。
- 查找舵机驱动端口
运行端口查找命令。查找过程中需要拔掉 USB;舵机最可能连接到 `/dev/ttyACM0`。
- 拔掉 USB 确认端口
在查找舵机所连接端口的过程中,拔掉 USB。
- 测试舵机是否可用
使用灯名称和舵机驱动器端口运行电机测试,检查舵机是否可用。
- 验证所有测试
完成灯的设置后,确认所有上述测试均通过。
- 运行 LeLamp 校准脚本
在 LeLamp 中进入 `lelamp_runtime`,运行校准命令,并把 `--id` 后的名称替换为此前面使用的灯具名称。
- 完成跟随者和领导者两次校准
按照 CLI 中的步骤操作,依次完成灯具作为跟随者和领导者时的两次校准。
- 将 LeLamp 摆到零位
按照脚本提示,将 LeLamp 摆到零位;零位可在文档链接的 3D 模型中查看。
- 校准时安全旋转各关节
将每个关节充分旋转,但不要充分旋转底座第一台电机或灯头第二台电机;这两个偏航舵机只能从中心位置分别顺时针和逆时针旋转约 90°。
- 测试所有舵机运动
运行电机测试命令,检查所有舵机运动。
- 测试 LED 环
运行 RGB 测试命令,测试 LED 环。
- 测试音频输入输出
运行音频测试命令,测试音频输入输出。
- 测试摄像头
运行摄像头测试命令,测试相机。
- 检查电气安全条件
接线时始终断开电源,并采取防静电措施保护 Pi 和舵机驱动板。连接前确认主电源为 5V,上电前再次检查极性。
- 逐一测试所有组件
电子准备阶段,逐个测试所有组件。
- 配置舵机 ID
为 LeLamp 的各个舵机配置唯一 ID。
- 完成整体集成与测试
完成全部组件集成后,对整个机器人进行最终测试。
- 核对构建前检查清单
确认所有组件均已采购并验证可用、3D 零件已打印和后处理、工具与工作区已准备好、软件与账户已就绪、安全设备齐备,并预留充足时间且不要匆忙操作。
- 运行电机设置脚本
在 lelamp_runtime 中使用灯的名称和舵机驱动板端口运行电机设置脚本,并按要求连接舵机。记住设置的灯名称,之后还要再次使用。
- 测试所有舵机的命令响应
确认所有舵机都能正确响应命令。
- 排查未检测到的舵机
如果未检测到舵机,请检查USB连接和端口。
采数据与训练
- 录制运动
在运行时运行录制命令,并使用 your_lamp_name、your_port 和 rotation 作为参数。
- 结束并保存录制
录制运动时,按住 CTRL + C 即可结束并保存录制。
- 回放运动
在运行时运行回放命令,指定 your_lamp_name、your_port 和 rotation。
- 列出已录制的运动
在运行时运行列表命令,查看指定 your_lamp_name 的所有已录制运动。
- 安全放置 LeLamp
将 LeLamp 放置在安全的工作区域,并确保其具有完整的运动范围。
- 录制简单运动
录制一个简单运动,用于测试系统。
- 回放运动并验证准确性
回放刚才录制的运动,以验证动作的准确性。
- 保存成功的录制
保存成功的录制,供以后使用。
用起来
- 确认 LeLamp 功能正常
确认现在拥有一台功能正常的 LeLamp。
物料
- 飞特 STS3215 串行总线舵机 ×5:底座转向、底座俯仰、肘部俯仰、腕部横滚、腕部俯仰(BOM 每个 23.99 美元)+ 微雪串行总线舵机驱动板
- 树莓派 4(BOM 注明可换 3B/4/5)与 32 GB microSD;ReSpeaker 2-Mics Pi HAT V2.0
- 灯头:8×5 WS2812B LED 点阵与 4 Ω 3 W 扬声器,经剥开的网线与底座相连
- 两路电源:5V 2A DC 电源给舵机,5V 2A USB‑C 充电器给树莓派
- 8 个 PLA 打印件:底座、底座盖、两段灯臂、两个俯仰件、灯头与扩散罩(15% 填充、树状支撑)
- M3 16 mm 与 M2 4 mm 螺丝、M2/M3 热熔螺母、排针与杜邦线
工具
- 3D 打印机,热床至少 200×200×150 mm(或代打印服务)
- 温控烙铁(15–25 W)与热熔螺母烙铁头、剥线钳、万用表
- M2/M3 内六角、尖嘴钳、斜口钳、数显卡尺、小螺丝刀
- 用于烧录系统与设置舵机的电脑、SD 读卡器
技能
- 焊接与接线:WS2812B、ReSpeaker 排针、延长舵机线
- 树莓派 OS Lite、SSH 与 Linux 命令行,uv 管理 Python 环境
- 舵机 ID 设置与校准(基于 LeRobot 的脚本),可选配置 LiveKit 与 OpenAI 语音代理
软件
- lelamp_runtime(Python,LeRobot + 飞特舵机 SDK):舵机设置、校准、动作录制与回放,内置 11 段预录动作
- 示例语音代理:LiveKit Agents + OpenAI Realtime,按对话调用动作与灯光
- simulation/ 目录内 URDF 与 MuJoCo 模型;Onshape 公开 CAD 与装配体