正在连接信源…

NavBot-D1 开源四足机器狗 复刻全流程

NavBot-D1 开源四足机器狗 从采购、打印、组装到装软件、标定和训练的 132 个步骤,附物料表、购买链接与官方出处。

整机 4,999 美元(NavBot 官方商店,2026‑11‑03 读取,美元标价):含组装标定好的整机、电池组与充电器,国际运费结账时计算,未写税费。创作者 BOM(bom/BOM.xlsx)合计 4,249.36 美元,其中 12 个 DM‑6248P 电机 2,082 美元、四条腿的 CNC 件 764 美元;BOM 未列 3D 打印件、BMS 板与线材,也不含运费

采购

  • 按功能整理物料清单

    按照图中的功能层级整理核心硬件清单,并让每项物料对应一个验证动作。

  • 订购 NavBot-D1 机器人平台

    订购可用的 NavBot-D1 开源四足机器人平台。该平台为 12 自由度,并提供机械 CAD/CNC、接线、BOM、可打印零件、控制软件和强化学习资源。

  • 获取实际硬件资源文件

    克隆仓库前先安装 Git LFS,以获取 CAD、制造图纸和电子表格等实际二进制文件,而不是指针文件。

打印与加工

  • 访问 EasyEDA 网站

    在浏览器中访问 EasyEDA 网站。

  • 选择在线设计和专业版

    在网站主页上点击“Design online”,然后选择“Pro Edition”。

  • 登录 EasyEDA 账户

    此时需要登录 EasyEDA 账户。

  • 导入 NavBot-EN01 PCB 项目

    依次选择 File、Import、JLCEDA(Professional),然后选择 NavBot-EN01.epro。

组装

  • 检查所有机械零件

    依次检查机架、侧板、上板和底板;四条腿的上腿、下腿和膝关节连接件;轴承、连杆、限位件和支撑柱;全部12个执行器;电池仓、BMS、主板、Jetson、IMU、USB-CAN和布线;最后检查LoRa、遥控器、GPS、图像传输模块和天线。

  • 临时标记执行器位置

    在机械组装前标记每个执行器将安装的腿和关节位置,例如FL-HIP、FL-THIGH和FL-CALF,以便后续写入ID、布置CAN布线和进行零点校准。

  • 固定执行器和主机架

    先固定执行器和主机架,确保机架不会挡住执行器的调试端口。

  • 保持调试端口可访问

    保留执行器调试端口的通路,因为之后可能需要进行ID重写、参数读取或调试。

  • 在关键螺钉上使用螺纹胶

    在执行器、连杆和支撑结构周围的关键螺钉上使用少量螺纹胶,因为四足机器人振动剧烈。

  • 逐层手动检查关节

    每完成一层组装就手动活动该层,不要等到四条腿全部完成后才发现某个关节卡滞。

  • 组装一侧后镜像另一侧

    可以先组装机器人的一侧,再按照相同过程组装另一侧。

  • 逐腿检查关键装配项

    逐条腿检查髋部执行器安装强度、上腿与执行器输出的对齐、膝关节轴承的正确插入、连杆运动是否顺畅,以及防止危险过度旋转的限位件。

  • 安装机械与软件限位

    安装机械限位件,防止关节在软件故障、人工搬运或跌倒时旋转到危险位置;机械限位和软件限位应同时存在,不能只依赖控制策略。

  • 连接电源与信号线

    将电池依次连接到 BMS/电源管理、紧急停止/电源开关,再连接到主板电源输入、Jetson 电源、外部模块电源和执行器电源路径。Jetson 通过 USB 连接 IMU、USB-CAN 适配器和 LoRa/接收模块;首次启动使用 HDMI、键盘和鼠标,并通过以太网或 Wi-Fi 进行 SSH。

  • 布置并固定线缆

    布线时确保线缆在关节运动时不会被拉动,在跌倒或搬运机器人时不会被执行器外壳压坏。保持每根线缆的用途清晰可见,以便日后维护。

  • 在紧固位置少量使用螺纹胶

    在执行器、连杆、支撑柱和机架关节周围少量使用螺纹胶。用量过多会增加日后维护难度,但完全不使用会使紧固件在长时间运动中松动。

  • 固定并布置所有线缆

    固定 CAN、电源、USB 和天线线缆的布线路径,避免它们靠近旋转关节、穿过挤压区域或依靠连接器承受拉力。

  • 保障 Jetson 散热与供电

    为 Jetson 提供适当供电与冷却,因为它会同时运行 ROS 2、驱动和强化学习策略。散热不佳会导致降频,供电不稳定会导致随机重启或外设掉线。

软件与固件

  • 更新系统并安装 catkin

    运行 apt update,并安装 ros-noetic-catkin。

  • 安装 Eigen 与开发依赖

    安装 Eigen、GLPK、GLFW、pybind11 和 Python catkin tools。

  • 安装文档与仿真工具

    安装 Doxygen、urdfdom、OctoMap、Assimp 和 rqt_multiplot。

  • 安装 ROS 消息依赖

    安装 grid_map_msgs 和 octomap_msgs。

  • 安装读入与串口工具

    安装 libreadline、libcgal、checkinstall、libserialport 和串口开发包。

  • 安装串口与遥控软件

    安装 ros-noetic-serial、ros-noetic-joy 和 ros-noetic-joy-teleop。

  • 准备 OCS2 与其余依赖

    文档列出的其余依赖包括 OCS2、Boost 1.71、Gazebo、RViz 和 SocketCAN。

  • 创建独立的 OCS2 工作区

    在 `~/ocs2_ws/src` 中创建目录并克隆 Pinocchio、hpp-fcl、ocs2_robotic_assets、raisimLib、elevation_mapping_cupy、grid_map 和 OCS2。

  • 克隆剩余的 OCS2 依赖

    在 OCS2 源码工作区中克隆 raisimLib、elevation_mapping_cupy、grid_map 和 OCS2。

  • 首先构建 Raisim

    进入 raisimLib 的 `build` 目录,运行 CMake 和 Make,然后使用 checkinstall 安装。

  • 下载并解压 ONNX Runtime

    下载 ONNX Runtime v1.7.0 的 Linux x64 压缩包,在 `/tmp` 中解压,并创建本地包含、库和 CMake 目录。

  • 安装 ONNX Runtime 文件

    将 ONNX Runtime 的头文件和库同步到 `~/.local/include/onnxruntime` 与 `~/.local/lib`。

  • 设置 ONNX Runtime 环境变量

    向 `~/.bashrc` 添加 `onnxruntime_DIR` 和 `LD_LIBRARY_PATH` 环境变量。

  • 初始化并构建首批 OCS2 包

    从 `~/ocs2_ws` 初始化 catkin,设置 `RelWithDebInfo` 构建类型,并构建 elevation_mapping_cupy 与 grid_map。

  • 构建其余 OCS2 包

    构建 hpp-fcl、pinocchio、ocs2_robotic_assets 和 ocs2。

  • 加载 OCS2 环境

    将 OCS2 的 setup.bash 写入 `~/.bashrc`,然后重新加载 `~/.bashrc`。

  • 创建 Catkin 工作空间

    创建 `~/catkin_ws`,将仓库的 `code/src` 复制到其中,并初始化、配置和构建工作空间。构建完成后,将工作空间的 setup.bash 写入 `~/.bashrc` 并重新加载。

  • 加载仿真控制器

    将 `ROBOT_TYPE` 设为 `d1`,并以 `cheater:=false` 加载腿式控制器。

  • 启动腿式控制器

    调用 `/controller_manager/switch_controller`,启动 `controllers/legged_controller`,不停止其他控制器。

  • 运行 CAN 配置脚本

    在 `src/legged_examples/legged_damiao/5.15` 中运行 `can.sh`,完成 CAN 配置。

  • 启动实机硬件接口

    将 `ROBOT_TYPE` 设为 `d1`,并启动 `legged_damiao_hw.launch`。

  • 加载实机控制器

    将 `ROBOT_TYPE` 设为 `d1`,并以 `cheater:=false` 加载腿式控制器。

  • 启动实机腿式控制器

    调用 `/controller_manager/switch_controller`,启动 `controllers/legged_controller`,不停止其他控制器。

  • 移除临时初始化保护

    确认实机与 RViz 状态一致后,移除 `src/docs/write.png` 所指的临时初始化保护,然后重新构建并重启程序。

  • 安装 Git LFS

    需要实际 CAD、加工文件和表格二进制文件时,先安装 Git LFS,再克隆仓库。

  • 选择正确的软件入口

    软件代码位于独立维护的仓库中;根据导航选择数据生成、策略训练或部署入口,不要在本仓库查找 ROS、训练或部署代码。

  • 准备并验证导出策略

    先选择并验证导出的策略,再使用 D1_rl_sar 仓库进行部署。

  • 按当前 README 安装环境

    打开 D1_rl_sar,按照仓库当前 README 的支持环境和安装步骤进行设置,并遵守其验证门禁与许可证。

  • 配置 Jetson Orin

    按照 D1_rl_sar 的说明配置 Jetson Orin。该仓库负责 Jetson Orin 的部署配置。

  • 配置 USB-CANFD 连接

    按照 D1_rl_sar 的说明设置 USB-CANFD。完成配置后核对 CAN 映射。

  • 设置马达与 IMU 参数

    按照 D1_rl_sar 的说明设置马达参数和 IMU 参数。上电测试前核对 IMU 朝向和参数。

  • 打开策略训练仓库

    打开 NavBotHub/D1_HIMLoco,并遵循其当前 README;这是无需收集新专家数据时训练 D1 运动策略的软件起点。

  • 使用 Isaac Gym 训练策略

    按照仓库 README 使用 Isaac Gym,并选择从零开始、仅加载权重或恢复训练的流程。

  • 导出训练后的策略

    按照 D1_HIMLoco 的工作流将选定的检查点导出为 ONNX。

  • 设置 Jetson Orin 和 USB-CANFD

    按照仓库 README 设置 Jetson Orin,并完成 USB-CANFD 集成。

  • 遵循各仓库的 README

    每个软件仓库都有自己的支持环境、安装步骤、验证门控和许可证;以其当前 README 为准。

  • 从所属仓库获取当前限制

    不要从此落地页推断当前的数据集支持、训练限制或部署限制;这些值会在所属仓库中变化。

  • 使用 SDK Manager 刷写 Jetson

    先将 Jetson 进入恢复模式,再使用 NVIDIA SDK Manager 刷写 JetPack,并将 NVMe 选为目标磁盘。首次启动时连接显示器、键盘和鼠标。

  • 创建账户并验证网络

    首次启动后创建用户账户,并验证桌面和基础网络正常。获取 Jetson 的 IP 地址,以便切换到 SSH。

  • 通过 SSH 远程维护 Jetson

    确认 Jetson 可以通过 SSH 远程维护。

标定与测试

  • 验证 IMU 数据

    通过软件栈读取合理的横滚角、俯仰角、偏航角或原始 IMU 数据。

  • 验证 CAN 通信

    确认适配器已被检测、比特率已配置,并且能够与执行器交换消息。

  • 首次通电前检查电源

    首次通电时不要立即启用执行器。确认 BMS 显示和电池状态正常、紧急停止能够可靠切断危险输出、Jetson 风扇正常启动、主板指示灯正常,并且外设电源轨稳定。

  • 验证 SSH 与重启连接

    通过主机电脑使用 SSH 连接 Jetson,并确认 Jetson 可以访问互联网或本地网络。验证 Jetson 重启后能够重新连接;这些项目稳定后再进行 ROS 2 和驱动程序安装。

  • 准备零位校准

    将机器人机身放平,确保所有四条腿姿态一致。使用水平面或夹具,避免地面不平污染零位。

  • 逐关节测试方向

    一次只测试一个关节,并针对机身坐标系确认运动方向。首次测试应使用低扭矩或安全模式。

  • 验证紧急停止

    在让机器人站立前,先确认紧急停止能立即介入,以应对不安全的执行器输出。

  • 检查执行器编号

    检查每个执行器 ID 是否唯一,并确认前左、前右、后左、后右的软件标签与实体机器人一致。

  • 核对关节与姿态定义

    确认每个关节的正方向符合控制定义,并确认 IMU 姿态与机身朝向一致。

  • 通过校准检查门槛

    只有在上述问题全部得到肯定答案后,才能进入强化学习模式。

  • 逐关节测试执行器方向

    先确认每个关节的 ID,即使 ID 正确,也要用小幅命令独立测试每个关节。方向反转会令策略输出错误的实际运动。

  • 首次使能前验证急停

    在第一次启用执行器之前验证急停功能。四足机器人站立失败时,人通常来不及反应,因此急停不能只作为装饰。

  • 检查 CAN 总线故障

    检查波特率、终端、电缆长度、松动连接器、USB-CAN 驱动行为和设备权限。CAN 总线问题可能表现为间歇性运动丢失或单个关节离线。

  • 每次只更改一个变量

    不要同时更改接线、ID 映射、策略和远程映射,否则难以判断究竟是哪个更改解决了问题。

  • 检测并测试 IMU 与 USB-CAN

    检测并测试 IMU 和 USB-CAN。

  • 追踪全部执行器配置

    确保全部 12 个执行器的 ID、方向和零位都可以追踪。

  • 先复现初始启动流程

    首先复现初始启动流程,不要先修改算法。

  • 先测试单腿再测试整机

    尽可能先使用一条腿或一个执行器,验证 ID、方向、模式和 CAN 通信。

  • 分别记录机械与软件更改

    将腿几何结构、接线、电池或策略参数的更改分别记录。

  • 运行可选的 OCS2 测试

    启动 `legged_robot_ddp.launch` 文件,运行可选的 OCS2 测试。

  • 启动 Gazebo 和 RViz

    将 `ROBOT_TYPE` 设为 `d1`,再启动 `empty_world.launch`,以打开 Gazebo 和 RViz 仿真。

  • 发布速度命令

    运行 `rqt_robot_steering` 并发布速度命令。速度不能为零,否则不会发布命令。

  • 准备实机电机配置

    在实机启用扭矩之前,完成电机 CAN ID、波特率、DM6248P 参数和零位校准。

  • 设置电机 CAN 和主机 ID

    按照接线图为每个电机设置 `can_id` 和 `mst_id`。

  • 设置电机波特率

    将每个电机的波特率设置为 5 Mbps。

  • 配置 DM6248P 电机参数

    配置所需的 DM6248P 电机参数。

  • 校准电机零位

    每条腿的第一个电机是偏航关节,应保持水平;第二个电机是 thigh pitch 关节,应遵循原始零位参考图对齐;第三个电机是 calf pitch 关节,应到达机械限位。

  • 等待 RViz 显示机器人

    等待 RViz 显示机器人,然后手动移动电机和机器人本体。

  • 核对实机与 RViz 状态

    手动移动电机和机器人本体,确认实机状态与 RViz 中显示的状态一致。

  • 评估训练检查点

    按照仓库支持的工作流评估训练检查点。

  • 选择并验证导出的策略

    选择并验证已导出的策略,然后打开 NavBotHub/D1_rl_sar,遵循其当前 README。

  • 运行部署契约检查

    运行仓库提供的部署契约检查,验证导出策略是否符合部署要求。

  • 在 MuJoCo 中验证策略

    按照 D1_rl_sar 的流程在 MuJoCo 中验证策略。

  • 配置电机和 IMU

    使用 D1_rl_sar 提供的配置设置电机和 IMU。

  • 保留各阶段的验证门控

    在各阶段之间保留 QA 和验证门控,不要在运动数据、训练与硬件部署之间跳过验证。

  • 执行契约与仿真验证

    在 D1_rl_sar 中完成部署契约检查和 MuJoCo 验证。真机运行前必须通过这两项检查。

  • 完成真机前置验证

    进入真机控制前,必须完成仿真验证和策略契约检查。真机控制可能导致跌倒、碰撞、执行器损坏或人身伤害。

  • 安全布置首次带电测试

    第一次带电测试时,将机器人悬空或可靠支撑。确保紧急断电装置触手可及。

  • 核对关节与控制配置

    带电测试前核对关节顺序、方向、零位、IMU 朝向、马达 ID、CAN 映射、PD 参数和命令范围。

采数据与训练

  • 录制机器人运动数据

    使用 D1_Legged_mpc_amp,在 Gazebo 中结合 NMPC 和 WBC 录制运动数据。

  • 使用审核后的 AMP 数据集

    工作流使用经过审核的 61 维命令条件化 AMP 数据集。

  • 训练并导出机器人策略

    使用 D1_HIMLoco,在 Isaac Gym 中进行训练、检查点评估和 ONNX 导出。

  • 检查现有数据是否足够

    检查 D1_HIMLoco 随附的已审核数据集是否已经满足训练需求;如果满足,可以跳过运动数据阶段。

  • 打开运动数据仓库

    打开 NavBotHub/D1_Legged_mpc_amp,遵循其当前 README,记录或重新生成专家运动。

  • 收集专家运动

    使用仓库提供的 Gazebo/NMPC/WBC 收集流程获取专家运动。

  • 应用运动质量门控

    在运动数据工作流中保留稳态轨迹质量门控,不要把记录到的运动自动视为训练数据集。

  • 导出经过验证的运动数据

    导出 HIMLoco 原生的 61-D 命令条件化 NPZ 数据,并保留 QA、清单、溯源信息和校验和。

  • 使用已发布的 D1 AMP 数据集

    使用 D1_HIMLoco 提供的已发布 D1 AMP 数据集。

  • 进入强化学习运动测试

    确认机械装配、电源、Jetson、ROS 2、IMU、CAN 和执行器映射均通过验证后,再进入强化学习运动测试。

  • 准备开阔平坦场地

    将机器人放在开阔、平坦的地面上,然后开机并等待 Jetson 和 ROS 2 节点启动。连接遥控器或 LoRa 控制端。

  • 安全进入站立模式

    按照安全顺序进入站立模式,确认四条腿均匀承载载荷,且没有明显抖动。

  • 启动强化学习运动模式

    在站立测试通过后进入强化学习运动模式。

  • 逐步测试运动指令

    先缓慢执行前进和后退指令,再测试小幅左右偏航指令,最后逐渐提高速度。

  • 记录每次测试状态

    每次运行后记录电池百分比和电压变化、执行器温度及警告、Jetson CPU/GPU 负载和温度、ROS 2 节点超时或消息丢弃、CAN 总线通信错误,以及最容易引发不稳定的运动。

  • 每次测试都保留日志

    每次测试都保留日志;当机器人摔倒或抖动时,日志比直觉更可靠。

  • 生成专家动作数据集

    在 D1_Legged_mpc_amp 中使用 Gazebo/NMPC/WBC 采集专家动作,执行稳态 trajectory 质量门禁,并导出 HIMLoco-native 61-D command-conditioned NPZ、QA、manifest、provenance 和 checksum。

  • 检查是否跳过数据采集

    如果 D1_HIMLoco 已包含满足训练需求的已审核 dataset,则跳过动作数据生成阶段。

  • 训练并导出运动策略

    在 D1_HIMLoco 中使用已发布的 D1 AMP dataset 进行 Isaac Gym 训练,可选择 scratch、weights-only 或 resume,并执行 checkpoint 评估和 ONNX 导出。

用起来

  • 依据记录优化机器人

    积累足够的测试记录后,再调整策略、机械结构、参数或步态行为。目标是建立可重复的测试程序,而不是首次运行就追求高速。

  • 选择合适的遥控通信方式

    LoRa 适合开阔环境中的较长距离运行,但不要假定长距离链路在封闭或杂乱环境中稳定。室内或短距离调试通常使用本地遥控器或 ROS 2 控制接口更方便。

  • 安全启用强化学习行走模式

    让机器人安全上电、站立,并切换到 RL 行走模式。

  • 测试远程移动指令

    使用远程输入测试前进、后退、转向和更快的移动。

  • 先进行室内短距离测试

    首次启动测试应从室内短距离开始,再进行室外长距离测试。

  • 安全措施优先于新功能

    急停、机械限位、低速测试和电源管理是动态机器人开发的基础。

  • 选择机器人步态

    等待模型在 RViz 中加载并站立,然后返回控制器终端,列出可用选项并选择 `trot`。

  • 使用手柄控制

    按仿真部分相同的方式启动仿真和控制器,并按照 `src/docs/handle.png` 中的映射使用手柄。

  • 验证并部署到真机

    通过 D1_rl_sar 工作流使用 MuJoCo 验证策略,并面向 Jetson/CANFD 和真机部署。

  • 按安全流程运行真机

    完成仿真、契约检查和首次带电核对后,按照 D1_rl_sar 中的完整安全流程运行真机。

  • 验证并部署实机策略

    将经过验证的策略和部署契约用于 D1_rl_sar,通过 MuJoCo 验证,并使用 Jetson/CANFD 部署到实机。

  • 运行真实机器人程序

    在部署契约检查、MuJoCo 验证以及硬件配置完成后,运行真实机器人程序。

物料

  • 12 × 达妙 DM6248P 关节电机
  • Jetson Orin Nano Super 核心板与边缘计算载板
  • DM‑IMU‑L1 IMU 与达妙 DM‑USB2CANFD_Dual 双路 USB‑CAN FD
  • 6S 5000 mAh 45C XT60 锂聚电池;自研 BMS 板(EasyEDA Pro,STM32F1 固件)
  • 铝合金关节支座、腿部 CNC 件、铝管、玻纤电路板支架与钣金机身,另有 3D 打印件(STL)
  • LoRa + GPS + 图传模块、图传显示屏加充电宝、LoRa 遥控器
  • 螺丝与轴承包(AXK1024 推力滚针轴承、6800ZZ 深沟球轴承等)

工具

  • 按 STEP 与 PDF 图纸外协 CNC 与钣金加工,或在官方商店买零件
  • 3D 打印机
  • NVIDIA SDK Manager 刷 JetPack 6.2.2(Windows 主机需 WSL2 与 usbipd)
  • 首次通电测试用的悬吊或支撑架,以及随手可及的急停断电

技能

  • Jetson 刷机、Ubuntu 22.04 与 ROS 2 Humble
  • CAN FD 配置与电机 ID、方向、零位标定
  • Isaac Gym(HIMLoco)训练、MuJoCo 验证与 ONNX 部署;可选 Gazebo + NMPC/WBC 录制专家动作

软件

  • D1_rl_sar:Jetson 上的 ROS 2 Humble 部署(基于 rl_sar,v1.0 平地稳定版,2026‑07‑30)
  • D1_HIMLoco:Isaac Gym 训练、检查点评估与 ONNX 导出,附 D1 AMP 数据集
  • D1_Legged_mpc_amp:Gazebo + NMPC + WBC 专家动作录制(改自 legged_control)
  • D1_SDK:SDK 与示例

文档