KJX ENGINEERING GUIDE · 09
Autoware 规划仿真环境与可复现实验
先建立不连接真实车辆的 Planning Simulator 基线,锁定容器、地图、车辆参数和场景,交付可复现日志与实验结果。
参考流程 · 仿真环境与任务待验证
进阶
参考学习时长 按工作站和场景规模评估
核查 2026-10-03
Autoware / 官方支持的 ROS 2 与容器版本待锁定
公开资料核对,不使用未经确认的整机照片。
适用说明:本手册用于 项目指定 Autoware/ROS 2 版本及 Planning Simulator;不代表实车线控、道路测试或其他仿真器已适配。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。
准备与目标
适用范围项目指定 Autoware/ROS 2 版本及 Planning Simulator;不代表实车线控、道路测试或其他仿真器已适配
实施方式参考流程 · 仿真环境与任务待验证;按目标硬件执行并记录结果
开始前准备
- 符合所选发行版要求的工作站
- 许可明确的容器、地图和场景
- 固定的车辆模型参数
- 独立实验环境和可存储日志的空间
完成后应得到
- 将环境和场景固定到可复现状态
- 分层排查初始化/定位/规划问题
- 区分仿真结果与实车能力
01 · 环境与物料冻结
先查所选 release 支持矩阵,再采购工作站。
- 记录 Autoware release/commit、ROS 发行版、系统、容器标签与镜像 digest;不把 main 文档自动视为旧版本说明。
- 按官方要求和目标场景列 CPU、RAM、磁盘、显卡及驱动需求,GPU 非必需的任务不强行增加采购。
- 地图、车辆模型、示例数据和容器分别核对使用权限,记录下载来源与校验值。
✓ 版本组合受支持✓ 硬件需求有依据✓ 资料来源可追溯
02 · 最小规划场景
先跑一个官方支持场景,不接真实车辆网络。
- 按固定版本官方说明准备环境,记录实际运行命令、依赖和日志,不复制其他发行版参数。
- 仅加载一套地图与车辆参数,依次核对初始化、定位、路线和规划状态。
- 检查地图坐标、初始姿态、车辆尺寸及碰撞包络;规划失败时保存状态信息而不是反复随机改参数。
✓ 最小场景可重复✓ 坐标和车辆参数明确✓ 状态失败可定位
停止条件:实验环境不得连接真实车辆控制接口;仿真指令不是实车控制授权。
03 · 场景与故障回放
每次只改变一个条件,保留成功和失败。
- 固定起终点与场景种子,记录规划耗时、轨迹、碰撞/越界和任务完成条件。
- 逐项测试无路径、障碍、定位异常与节点重启,记录故障注入和恢复条件。
- 如果引入其他仿真器或传感回放,先确认桥接、时间同步、消息版本及资源开销,不默认互换。
✓ 失败样本留存✓ 指标定义一致✓ 桥接单独验收
04 · 复现包与范围说明
交付的是实验基线,不是自动驾驶成品。
- 归档环境清单、地图/场景哈希、车辆参数、实际命令、日志索引与已知限制。
- 由另一位工程师在相同条件重复运行,记录冷启动到目标场景的步骤和结果。
- 后续实车、线控、安全或道路测试单独立项;本资料包不包含其许可与验收结论。
✓ 接手者可复现✓ 文件与结果同版本✓ 仿真与实车界限清楚
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 环境启动但不能生成路线 | 地图、初始定位、车辆参数或规划状态不满足前置条件 | 按定位、地图、路线、规划顺序核对状态与日志,保留失败场景而不是一次性替换所有参数。 |
验收与归档
- 环境版本与镜像固定
- 至少一个约定场景可复现
- 异常与恢复有记录
- 没有把仿真通过写成实车完成
建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。