AhaRobot 低成本开源双臂移动操作机器人(Astra 硬件) 复刻全流程
AhaRobot 低成本开源双臂移动操作机器人(Astra 硬件) 从采购、打印、组装到装软件、标定和训练的 80 个步骤,附物料表、购买链接与官方出处。
创作者估算:网站称硬件成本 1,000–2,000 美元(1,000 美元不含算力,2,000 美元含 RTX 4060 Mini‑ITX 电脑),价格表硬件小计 826.1 美元、含算力合计 1,950.8 美元。文档零件清单合计:底座、升降架与电源加双臂和头部云台 990 美元(7,132.57 元),算力与算力电源 1,124 美元(8,098 元),RoboPilot 遥操作 33 美元(239 元);零件多从淘宝购买,铝型材按 MISUMI 型号在嘉立创 FA 订购,清单未写运费。购买表单只列加价项(整机组装 +100 美元、电脑与电池 +1,500 美元),未写基础价
采购
- 联系销售获取零件包
销售团队按成本价提供零件包,只需另付运费和税费。
- 购买 ITX PC 计算单元
购买 1 台 ITX PC(RTX 5060),单价 5999 元人民币。也可选择树莓派等较低配置;此配置用于在本地运行模型,也支持远程推理。
- 购买 Jackery 电源站
购买 1 台 Jackery Explorer 600Plus 220V 800W 便携式电源站,单价 2099 元人民币,用于为主计算机供电。
- 克隆 PyAV 仓库
如果尚未克隆 PyAV,使用指定的分支克隆仓库。
打印与加工
- 打印标记页
下载 PDF 文件,并使用双面打印,以 100% 缩放打印标记。
组装
- 查看 Astra.STEP 安装方向
打开 Astra.STEP 文件以确定准确的安装方向和位置;如果未安装 CAD 软件,建议使用 Autodesk Fusion 查看。
- 组装并固定底架
使用铝型材组装底架,并用 M8*30 内六角圆柱头螺钉牢固固定框架。
- 安装电机和光电开关
先将电机和光电开关安装在导轨上。
- 将导轨安装到底架
使用两个扁平铝制角码将导轨安装到底架上。确保步进电机顶面与 3060 铝型材齐平,导轨前表面与型材相距 20.3 mm;安装时暂时不要完全拧紧螺钉。
- 安装连接块和前部加强结构
继续使用角码安装两个连接块,然后安装前部 30120 铝型材加强结构,并用 M8 螺栓固定。安装后确保 3090 铝型材与 30120 铝型材形成直角关系。
- 安装驱动轮
将组装好的机器人放倒,然后安装驱动轮。先安装轮毂电机前叉支架,再安装电机。
- 安装计算机支撑结构
按照图片安装相应的型材,并使用 M8 螺钉和平角连接件完成安装与固定。
- 安装肩部双电机模块
将舵机固定到结构件上,使用统一规格的十字沉头螺钉。使用合适的 M3 螺钉连接舵机舵盘和机构。
- 安装肘部双电机模块
按照文档图片完成肘部双电机模块的安装。
- 组装上臂和下臂
将已组装的双电机模块连接到型材,完成上臂和下臂。左臂的安装步骤与右臂相同。
- 顺序安装手腕
以右腕为例,一次串联连接一个关节。在舵机与下一个结构件之间安装 AXK2035 推力针 roller bearing,以承受非轴向力矩。
- 安装夹爪机构
先安装导轨,再将两个夹爪头安装到夹爪上。确保齿条与小齿轮正确连接。
- 安装头部云台单元
参照手腕的顺序安装步骤,完成头部水平转动和俯仰单元的安装。
- 完成夹爪和机器人总装
将夹爪安装到手臂上,再将手臂和头部云台单元安装到升降平台上,完成全部安装。
- 沿虚线裁剪
沿虚线裁剪打印好的标记页。
- 安装右手柄标记
右手柄使用 ID 0–16 的标记,忽略标记 ID 17。从顶部开始逆时针贴附标记,并使用双面胶以获得最佳效果。
- 安装左手柄标记
左手柄使用 ID 18–30 的标记。从顶部开始逆时针贴附标记,并使用双面胶以获得最佳效果。
- 查阅 Notion 硬件装配指南
文档未给出装配细节,请参阅项目的 Notion 硬件装配指南页面。
软件与固件
- 克隆 astra_ws 工作区
克隆 astra_ws 项目及其子模块,然后进入 astra_ws 目录。
- 优化 Docker 下载速度
如果下载速度较慢,可以在 Dockerfile 中配置 APT 镜像,或通过 http(s)_proxy 环境变量设置 HTTP(S) 代理。
- 安装 Python 包并配置 ROS
从源代码安装 AhaRobot 维护的若干修补版 Python 包,以启用机器人功能。使用 Docker 时,在容器内部执行后续命令。不要将 ROS 与 Conda 一起安装。
- 更新软件包索引
在项目根目录执行 apt 和 rosdep 更新。
- 安装 ROS 依赖
根据 src 中的包安装 ROS 依赖。
- 安装 aiortc
进入 non_ros_src/aiortc,安装所需系统开发包并以可编辑模式安装 aiortc。
- 安装 pyribbit
进入 non_ros_src/pyribbit,固定 setuptools 版本并以可编辑模式安装 pyribbit。
- 安装 urchin
进入 non_ros_src/urchin,并以可编辑模式安装 urchin。
- 安装 MR URDF 加载器
进入 non_ros_src/mr_urdf_loader,并以可编辑模式安装 mr_urdf_loader。
- 安装 ModernRobotics Python 包
进入 ModernRobotics 的 Python 包目录,更新 packaging 并以可编辑模式安装该包。
- 安装 astra_teleop
进入 non_ros_src/astra_teleop,并以可编辑模式安装 astra_teleop。
- 安装 astra_teleop_web
进入 non_ros_src/astra_teleop_web,并以可编辑模式安装 astra_teleop_web。
- 构建 PyAV 依赖
进入 non_ros_src/PyAV,安装构建依赖,设置 PYAV_LIBRARY,激活环境并构建 PyAV。
- 安装支持 libsvtav1 的 FFmpeg
添加 Ubuntu PPA 仓库并安装 FFmpeg,以支持 libsvtav1。
- 安装 lerobot
进入 non_ros_src/lerobot,安装 lerobot 并将 huggingface_hub 固定在 0.25 以下版本。
- 安装 odrive-can
进入 non_ros_src/odrive-can,安装 can-utils 并以可编辑模式安装 odrive-can。
- 安装串口和 CAN Python 库
安装 pyserial 和 python-can。
- 构建 ROS 2 工作空间
在当前 ROS 2 工作空间中构建所有包,并将其安装到该工作空间。
- 在项目根目录构建 ROS 工作区
在项目根目录使用 colcon 构建 ROS 工作区,然后加载生成的环境设置。
- 在宿主机启动 CAN 总线
在 Docker 外运行命令,将 can0 以 250000 位速率启动,并将发送队列长度设为 100。需要重置时,可先关闭 can0。
- 查找 USB 设备的 KERNEL 值
运行 udevadm 或 lsusb 获取 /dev/video0 对应设备的 KERNEL 值,因为 Linux 每次重启后都会更改 USB 设备名称。
- 绑定 USB 设备端口
按照 99-astra-fixed-port.rules 文件的格式,将 USB 设备绑定到 /etc/udev/rules.d/99-astra-fixed-port.rules。示例中的 1-6.2:1.0 表示设备 tty_puppet_left。
- 配置 ODrive 的 udev 规则
下载 ODrive 的 udev 规则文件,并将其安装为 /etc/udev/rules.d/91-odrive.rules。
- 重新加载 udev 配置
重新加载 udev 规则并触发 udev,以应用修改后的配置。
- 克隆固件项目及子项目
克隆 AstraFirmwares 项目及其所有子项目。
- 打开手臂控制器源码目录
使用 VSCode 或 Cursor 打开 AstraFirmwares/AstraArmController 固件源代码目录。
- 安装 PlatformIO 插件
在 VSCode 或 Cursor 中安装 PlatformIO 插件。
- 编译并刷写右臂控制器
编译项目,并将固件刷写到右臂控制器。
- 刷写左臂控制器固件
在 platformio.ini 中将 upload_port 修改为 /dev/tty_puppet_left 并保存,然后像右臂一样编译项目并刷写左臂控制器固件。
- 打开升降控制器固件
使用 VSCode/Cursor 打开升降控制器固件源代码目录,然后编译项目并首先刷写右侧升降控制器固件,方式与机械臂控制器类似。
- 配置左侧升降控制器
在 main.cpp 中取消右侧的 STEPPER_CORRECT_DIR 定义,并启用左侧的反向定义。将 platformio.ini 的 upload_port 修改为 /dev/tty_puppet_lift_left,保存编译项目并刷写左侧升降控制器固件。
- 刷写头部控制器固件
使用 VSCode/Cursor 打开头部控制器固件源代码目录,然后编译项目并刷写头部控制器固件。
- 刷写踏板控制器固件
使用 VSCode/Cursor 打开踏板控制器固件源代码目录。由于刷写时踏板控制器只暂时连接到车载计算机,需要在 /dev 目录中通过插拔设备查找其文件路径。在 platformio.ini 末尾添加 upload_port=/dev/ttyUSB{YOUR_PATH_HERE},保存编译项目并刷写踏板控制器固件。
标定与测试
- 忽略非法霍尔状态错误
将 axis0 编码器配置为忽略非法霍尔状态错误。
- 配置轴1电机和编码器
以相同方式设置轴1电机和编码器,包括限流、极对数、编码器模式、CPR 和带宽。
- 完成轴1校准参数配置
设置轴1的电阻校准最大电压、校准范围、校准扫描距离、电流控制带宽,并忽略非法霍尔状态错误。
- 保存配置并重启
等待上下位机之间的通信完成 1 秒,然后保存配置并重启。
- 开始轴0编码器校准
将轴0请求状态设置为完整校准序列,开始编码器校准。
- 让轴0电机完成旋转校准
驱动板会发出蜂鸣声;确保电机不接触地面。电机随后会自行旋转数次,等待其停止。
- 保存轴0校准参数并重启
电机停止后,将轴0编码器和电机标记为已预校准,等待 1 秒,保存校准参数并重启。
- 开始轴1编码器校准
以相同方式开始另一个电机的校准,将轴1请求状态设置为完整校准序列。
- 预校准轴 1 并保存配置
将 axis1 的编码器和电机设为已预校准,等待 1 秒后保存配置并重启 ODrive。
- 设置 Axis 0 位置控制参数
将 axis0 设为位置控制模式,位置增益设为 20,速度增益设为 0.10,速度积分增益设为 0。
- 设置 Axis 0 梯形运动限制
为 axis0 设置梯形轨迹输入模式,速度限制为 20,加速度限制为 1,减速度限制为 1。
- 设置 Axis 1 位置控制参数
用同样的方法将 axis1 设为位置控制模式,位置增益设为 20,速度增益设为 0.10,速度积分增益设为 0。
- 设置 Axis 1 梯形运动限制
为 axis1 设置梯形轨迹输入模式,速度限制为 20,加速度限制为 1,减速度限制为 1。
- 可选启动闭环控制并测试
文档提供可选的闭环启动设置:请求 axis0 进入闭环控制状态并启用启动闭环控制。
- 准备标定板
下载 calibration_board.png,并将其贴在平面上。
- 安装遥操作依赖项
克隆 astra_teleop 仓库,并使用 pip 安装该软件包。
- 采集相机标定图像
从 /dev/video0 采集标定图像,并将其保存到 ./calibration_images。
- 移动标定板至相机前
将标定板移动到相机前方。
- 处理标定图像
处理 ./calibration_images 中的标定图像,并生成相机矩阵和畸变系数。
- 查看标定结果
结果保存在 calibration_images/teleoperation_calibration_results_{%Y%m%d%H%M%S}.yaml 中,包含相机内参和畸变系数。
- 测试底盘和升降平台
按照“Flashing Firmware”章节进行初始测试。测试轮毂电机时抬起车架,并确认光电开关已正确安装且连接到 ESP32。
采数据与训练
- 训练模型
使用已采集的数据集训练 ACT 策略,并将结果输出到指定目录。
- 在真实环境中评估模型
在 Astra Joint 机器人上以 30 FPS 运行训练后的模型,执行拾取地面玩具并放到桌面上的任务。
用起来
- 启动机器人和网页遥操作界面
启动 AhaRobot 控制器及网页遥操作用户界面。
物料
- 26 个 Feetech STS3215 磁编码总线舵机(每臂 12 个,肩与肘为双电机模块;头部云台 2 个),3 块微雪 ESP32 舵机驱动板;文档提醒舵机易损、建议多备
- 升降:左右两套 GT45‑1200 滑台配 57115 步进电机与光电开关,DM542 驱动器,ESP32 转发 USB‑TTL 指令
- 底盘:两只 HB‑139 轮毂无刷电机由 ODrive 3.6 驱动,加 5 英寸万向轮;MISUMI 3030、3060、30120 铝型材框架
- 手臂:2040 铝型材连杆、MGN7C 直线导轨驱动夹爪开合、AXK2035 推力滚针轴承,结构件建议用 PETG‑CF 打印
- 视觉:3 个 USB 摄像头(顶部与双腕),UGREEN USB 3.0 集线器与延长线
- 电源:24V 20,000 mAh 电池配 3A 充电器、24V 转 12V 30A 模块、急停开关;可选 Jackery Explorer 600 Plus 电源站给电脑供电
- RoboPilot:4 个霍尔踏板接 ESP32,3D 打印的 26 面标记手柄,可选摄像头
工具
- 3D 打印机(文档用 Bambu Lab P1P,不建议 A1 等 i3 结构,打印高重心零件易倾倒)、硬化钢喷嘴(PETG‑CF 需要)与防翘边胶;也可向团队购买打印好的零件
- 烙铁(压入热熔螺母)、螺丝刀套装、内六角扳手、尖嘴钳;导轨安装最好两人配合
- Autodesk Fusion 等 CAD 软件查看 Astra.STEP 确认装配方位
技能
- 铝型材框架与导轨装配;测试轮毂电机时把车架架空
- 为臂、升降、头部与踏板控制器刷 ESP32 固件,配置 ODrive 电机参数并校准编码器
- Ubuntu 24.04、Docker 与 ROS 2 Humble;用 LeRobot 采集数据集、训练与推理(VLA 推理需 NVIDIA 显卡,最低 RTX 2060)
软件
- astra_ws:ROS 2 工作区,astra_controller 与固件通信、做逆运动学并启动网页遥操作,含 URDF 与 Nav2 导航仿真
- AstraFirmwares:臂、升降、头部与踏板四个控制器固件
- astra_teleop(MIT)与 astra_teleop_web:RoboPilot 标记识别与 PnP 位姿估计(Python 与 WebAssembly 版)
- LeRobot 数据采集、训练与评估流程