代码清单

本书配套的全部代码、脚本与配置,按仓库路径索引。所有代码以仓库 book-dev 分支为准。

A.1 仿真与训练代码(software/training/)

文件用途对应章节
mjlab/actuators/bam_actuator.pyBAM 舵机模型(HD1910 参数)BAM 执行器建模与辨识
assets/robots/microduck_feetech.xml飞特版 MJCF 模型Onshape→MJCF 自动化建模、MuJoCo-Warp 仿真环境
train_ppo.pyPPO 训练主脚本(含域随机化)域随机化、PPO 多任务训练
export_onnx.py导出 ONNX 策略PPO 多任务训练
test_env.py仿真环境自检MuJoCo-Warp 仿真环境
requirements.txt / requirements-lock.txt依赖清单MuJoCo-Warp 仿真环境

A.2 标定与系统辨识(scripts/calibration/)

文件用途对应章节
hd1910_bench_data_process.py台架CSV→BAM参数拟合舵机与 IMU 标定、BAM 执行器建模与辨识
system_id_fit.py真机数据→惯性参数辨识Sim2Real 闭环迭代

A.3 CAD 导出(scripts/cad2mjcf/)

文件用途对应章节
onshape_config.jsonOnshape 装配配置Onshape→MJCF 自动化建模
export_mjcf.pyonshape-to-robot 一键导出Onshape→MJCF 自动化建模
validate_mjcf.pyMJCF 惯性/限位校验Onshape→MJCF 自动化建模

A.4 校验脚本(scripts/validation/)

文件用途对应章节
check_bam_params.pyBAM 参数物理合理性校验BAM 执行器建模与辨识
check_obs_act_space.py仿真↔板端观测空间比对RK3566 镜像与固件、策略部署与板端推理
mass_inertia_check.py整机质量/惯性校验3D 打印、装配与公差

A.5 容器与配置(docker/)

文件用途对应章节
DockerfileGPU 训练环境镜像MuJoCo-Warp 仿真环境
docker-compose.yml一键启动MuJoCo-Warp 仿真环境

A.6 实验配置示例(experiments/)

目录用途对应章节
exp01_standup/config.yaml站立训练配置最小仿真示例
exp02_walk_flat/config.yaml平地行走配置PPO 多任务训练
exp03_domain_rand/config.yaml域随机化消融域随机化
exp04_curriculum/config.yaml课程学习配置域随机化

A.7 板端固件(software/firmware/)

Rust 多守护进程:robotd(主控制环)、configd(配置)、busd(总线)、webui(调试界面)。对应第 7 章。