Skip to content

feat(rov): ROV 水下载具支持(MuJoCo 位姿桥接 + 水动力学) - #51

Open
Syysean wants to merge 8 commits into
OpenHUTB:mainfrom
Syysean:feat/rov-mujoco-bridge
Open

Syysean wants to merge 8 commits into
OpenHUTB:mainfrom
Syysean:feat/rov-mujoco-bridge

Conversation

@Syysean

@Syysean Syysean commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

内容

  • 水动力学(AirLib):Fossen 六自由度模型、浮力回复力矩、水深边界兜底
  • 位姿桥接(UE 插件):MuJoCo 为唯一物理源,每帧把 ROV 位姿同步给 Pawn,AirSim 侧关闭该载具的物理与碰撞
  • 辅助:三层级联洋流、定深 PID、水动力学单元测试

说明

推力与力矩通过 UMjPhysicsEngine 的 PreStepCallbacks 在 mj_step 前写入
控制量在游戏线程计算、物理线程按 500 Hz 读取,指令超时自动归零

兼容性

默认配置保持 Multirotor,ROV 仅在 SimMode = Rov 时启用,不影响现有载具

测试

UE 4.26 编辑器 Development 编译通过;集成环境静置 120 s 倾角 0.1°,定深误差 < 1 cm

从 hutb PR #3732 拆出的 AirSim 侧改动:
- 新增 URovMuJoCoBridge:把 MuJoCo 的推力/浮力/洋流/定深/姿态控制映射到 ROV 刚体
- ARovPawn 改为纯位姿跟随(ExternalPoseProvider),关闭自身物理与碰撞,消除双物理所有权
- RovPawnSimApi 暴露键盘 PWM 与位姿接口
- AirSim.Build.cs 增加 MuJoCo/URLab 依赖
- PawnSimApi.h 增加外部位姿提供者接口

对应 hutb PR: OpenHUTB/hutb#3732
把 hutb 分支 feat/holocean-runtime 里属于 AirSim 的实现同步回来,
让 hutb 后续可以直接引用本仓库、不必再往 hutb 里塞 AirSim 源码。

- MuJoCoBridge.cpp/.h
  * 级联姿态控制(姿态 P → 期望角速度 → 机体系角速度 P)
  * 机械臂按真实排水体积加浮力(ArmBuoyancyVolume = 12.1 L,UR5e 七连杆
    OBJ 散度定理实测 11.73 L + 2F85 约 0.35 L)
  * 浮力作用点由艇体质心改为整机合成质心(Data->subtree_com)
  * 指令新鲜度淡出 + 物理线程兜底控制器:修复打包版首帧卡顿 10 秒期间
    旧力矩被冻结施加、ROV 5 秒内被甩翻 159° 的问题
  * EffInertia 延迟到 t>0.2 s 计算(qM 未就绪时读到垃圾值)
  * 姿态积分步长改用实际仿真时间,消除帧率依赖
- RovUnderwaterPhysics.h
  * 三层级联洋流 + 定深 PID;**本文件之前缺失**,导致 hutb 里
    MuJoCoBridge.h:31 编译失败(setup.bat -l 报 C1083)
- RovPawnEvents.cpp/.h:事件定义更新
- RovApiBase.hpp:新增 setMotorPWMs,桥接可直接写电机 PWM
- settings_rov.json:新增深度夹紧(ZBed/EnableDepthClamp/Bed*)、
  中性浮力、水动力阻尼参数

注意:settings_rov.json 仍是「显式选择 ROV 模式」才生效,
默认 settings.json 保持普通无人机配置不变。
现象:ROV 相关源码的注释里带有日期、内部文档路径、调研结论与历史对比,
属于项目内部信息,不适合作为对外代码的说明,也增加维护成本。

解决:注释只保留单位、坐标系、限幅值、回退行为等外部读者需要的信息,
删除版本叙事、内部引用与设计论证。无逻辑改动,净减约 150 行注释。

验证:文件与 hutb 仓库同源,已在 CarlaUE4Editor 下编译通过。
@donghaiwang

Copy link
Copy Markdown
Member

代码风格检查 和AirLib编译 没过,
报错信息:

D:\a\air\air\AirLib\include\vehicles\rov\RotorTiltableParams.hpp(27,30): error C2220: the following warning is treated as an error [D:\a\air\air\AirLibUnitTests\AirLibUnitTests.vcxproj]

现象:在只同步 Vehicles/Rov 目录的工程里编译 RovPawnSimApi.cpp 报
      "setMotorPWMs" 不是 "msr::airlib::RovApiBase" 的成员。

原因:RovApiBase.hpp 位于 AirLib 目录,该目录默认不入库;
      消费方拿到的副本缺少 setMotorPWMs 包装,而 cpp 里在调用它。

处理:把该头文件纳入版本管理,保证同步后接口完整。
现象:同步后编译 RovStatusHUD.cpp 报 FRovStatusSnapshot 未定义、
      GetStatusSnapshot 不是 URovMuJoCoBridge 的成员。

原因:状态面板、外形参数、障碍场景等改动只更新了 hutb 侧的 AirSim 源码,
      air 侧仍是旧版;两边同步时头文件被覆盖回旧版,与新的 cpp 不匹配。

处理:把已验证的 17 个 ROV 源文件与 AirSim.Build.cs(新增 Json 依赖)
      同步到 air,保证任一侧同步后都能编译。
@donghaiwang

Copy link
Copy Markdown
Member

- 对 PR 变更的 C/C++ 文件按仓库 .clang-format(clang-format 11)重新格式化
- AirLibUnitTests 的 Debug 配置补充屏蔽 4244/4305/4189/4267:
  ROV 相关头文件里的 double 到 float 字面量、未使用变量属历史写法,
  在单元测试工程开启 /WX 后会被当作编译错误

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants