正在连接信源…

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 数据采集、训练与评估流程

文档