正在连接信源…

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 与装配体

文档