airsim 与 px4 联合仿真中，因图像处理导致控制指令中断超时，触发 px4 默认的 `com_of_loss_t`（遥控/通信丢失超时）机制，从而激活失效保护；调整该参数并确保控制循环及时性即可稳定运行。
在 AirSim + PX4 的协同仿真环境中，当 Python 脚本引入计算机视觉（CV）逻辑（如调用 simGetImages() 获取帧、解码、推理等）后，控制指令发送频率显著下降，极易导致 PX4 判定“外部控制信号丢失”，进而触发 Failsafe activated —— 这并非硬件故障或飞控异常，而是 PX4 安全机制对通信超时的正常响应。
核心原因在于：PX4 默认参数 COM_OF_LOSS_T（即 Offboard Loss Timeout）设为 1 秒（单位：毫秒？实际为 1000 ms），表示若连续 1 秒未收到有效的 Offboard 控制指令（如 SET_POSITION_TARGET_LOCAL_NED 或 SET_ATTITUDE_TARGET），飞控将自动进入失效保护模式（通常表现为悬停冻结、强制降落或返航，取决于 COM_FAIL_ACT 设置）。
你的脚本中关键隐患点如下：
- client.moveToZAsync(z, 1).join() 后插入了 time.sleep(1)，直接造成 1 秒无控制指令输出；
- CV 处理（图像解码、模型推理等）若耗时超过 COM_OF_LOSS_T，同样会中断控制流；
- AirSim 的 LockStep: true 模式虽提升同步精度，但也放大了单步延迟的影响。
✅ 正确解决方案分两步：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
-
永久性放宽通信超时阈值（推荐）
在 settings.json 的 Vehicles.PX4.Parameters 中添加或修改以下参数："COM_OF_LOSS_T": 5000, // 单位：毫秒（5秒），建议 3000–10000 范围内按需调整 "COM_FAIL_ACT": 0 // 0=悬停（最安全），1=返航，2=降落，避免意外动作
⚠️ 注意：COM_OF_LOSS_T 必须大于你脚本中最长单次控制间隔（含 CV 处理时间）。实测中 5000（5秒）可覆盖多数轻量级 CV 推理（如 YOLOv5s CPU 推理约 100–300ms）。
-
优化控制循环结构，避免阻塞
❌ 错误写法（阻塞式、低频控制）：client.moveToZAsync(-5, 1).join() # 阻塞等待完成 time.sleep(1) # 此处已超时！ for i in range(TRACKING_STEPS): img = get_image_from_drone_as_np_array(client) # ... CV processing (may take >1s)✅ 正确写法（异步+心跳保活）：
# 起飞后立即进入高频控制循环（最小化空闲） client.takeoffAsync().join() client.hoverAsync().join() # 确保稳定悬停 # 启动保活控制循环（例如 10Hz） import threading import time def keep_alive(): while True: client.moveByVelocityAsync(0, 0, 0, 0.1).join() # 微小零速指令维持连接 time.sleep(0.1) # 启动后台保活线程 alive_thread = threading.Thread(target=keep_alive, daemon=True) alive_thread.start() # 主线程专注 CV 处理（不阻塞控制） for i in range(TRACKING_STEPS): img = get_image_from_drone_as_np_array(client) # ... CV logic (ensure < 500ms if possible) time.sleep(0.05) # 可选微调，避免过载
? 额外验证建议：
- 使用 QGroundControl 实时查看 MAVLink → Messages 中 HEARTBEAT 和 STATUSTEXT，确认 OFFBOARD 模式是否持续激活；
- 检查 PX4 日志中 WARN [failsafe] Failsafe activated 前是否有 WARN [commander] Offboard control lost 提示；
- 若使用 WSL2，确保 ControlIp / ControlPort 在 Windows 主机与 WSL2 间网络互通（推荐使用 host.docker.internal 或宿主机 IP，避免 localhost 解析问题）。
通过合理配置 COM_OF_LOSS_T 并保障控制指令的持续性，即可彻底规避非预期失效保护，让 CV 导航、目标跟踪等高级功能在 AirSim+PX4 环境中稳定运行。
