概览#
先定位错误发生在源码获取、构建、Python加载、任务选择还是策略加载阶段,再核对该阶段依赖。先检查构建产物和文件路径,再进入设备运行阶段。
构建与Python扩展#
| 现象 | 检查方向 |
|---|---|
install/setup.bash 不存在 |
首次构建是否完成;此文件是生成物 |
| 找不到ROS包或扩展 | 当前终端是否加载ROS 2与工作空间环境 |
ModuleNotFoundError: imu_py/motors_py/robot_py |
构建产物路径、当前Python与环境 |
.so 导入失败 |
CPU架构、Python ABI、链接依赖;不要混用不同镜像产物 |
| 运行IMU完整例程缺SciPy | 在同一Python环境中准备例程所需的SciPy依赖 |
| ONNX Runtime构建失败 | 平台选择的归档、版本和CMake报错;保留第一条实际错误 |
构建与环境加载顺序见 获取与构建。SDK模块使用工作空间构建产物。
训练任务与资产#
找不到Isaac Lab相关import时,核对当前Python是否为Isaac Lab环境、robolab与rsl_rl是否在同一环境安装。list_envs.py 只筛选RPO名称。检查RP1.3时查看 任务定义。
RP1_train包含RPO资产子模块,批量任务导入还可能受到它影响。保留具体缺失路径或import异常,不因目录为空就更换RP1几何或套用RPO任务。
策略资源#
| 配置 | 已知缺件 |
|---|---|
28动作 rp1/default |
models/policy.onnx |
24动作 rp1_24dof/ufo |
FBcprAuxModel.onnx、latents/zs_66.npz |
存在 policy.onnx 文件名也不足以证明I/O、外部数据和关节映射匹配。部署实现检查单输入与输入元素数;观测字段、历史布局、normalizer与顺序仍按 I/O约定 核对。
配置报错时同时检查 model_names、obs_layouts、frame_stacks、obs_stack_orders 的数量与对应关系,以及history tap范围。输入尺寸与权重的I/O约定保持一致。