QGroundControl（QGC）是开源无人机地面站软件，由 Dronecode 基金会维护，是 PX4 和 ArduPilot 生态系统的核心组件。QGC 提供了完整的飞行规划、实时监控、传感器校准和数据分析功能，支持桌面端（Windows/macOS/Linux）和移动端（Android/iOS）。本章将基于 ZP_H743 飞控板配合 PX4 固件，全面讲解 QGroundControl 的配置与使用。

14.1 QGroundControl 安装与连接

14.1.1 软件获取与安装

QGroundControl 可从官方网站（https://qgroundcontrol.com/downloads）下载最新版本。

安装步骤（Windows）：

1. 下载 Windows 版本的 .exe安装程序。

2. 双击安装程序，按照向导完成安装。

3. 安装完成后从桌面快捷方式或开始菜单启动 QGC。

4. 首次启动时，QGC 会要求选择界面语言——建议选择中文（简体）以获得最佳体验。

移动端安装：

• Android：从 Google Play 商店搜索"QGroundControl"下载安装。

• iOS：从 App Store 搜索"QGroundControl"下载安装。

• 移动端功能与桌面端基本一致，但界面布局针对触屏进行了优化。

14.1.2 连接飞控板

QGroundControl 支持多种连接方式：

USB 直连步骤：

1. 使用 USB Type-C 线缆将 ZP_H743 飞控板连接至计算机。

2. 系统自动识别并安装驱动（如第 13 章所述 STM32 VCP 驱动）。

3. 启动 QGroundControl，软件会自动检测并连接飞控板。

4. 连接成功后，QGC 主界面左上角将显示载具图标和固件版本信息。

5. 界面顶部状态栏显示"Connected"状态和 MAVLink 心跳信号指示。

数传电台连接：

1. 将地面端数传电台通过 USB 连接至计算机。

2. 将机载端数传电台连接至飞控板的遥测 UART 端口。

3. QGC 会自动检测串口并建立 MAVLink 连接。

4. 默认波特率为 57600 bps（MAVLink 标准遥测速率）。

14.2 载具设置（Vehicle Setup）

载具设置是 QGC 的核心配置模块，位于主界面的齿轮图标"Vehicle Setup"区域。

14.2.1 Summary 概览页

进入 Vehicle Setup 后首先看到的是 Summary 概览页，以卡片形式展示飞控系统的整体健康状态：

• 固件信息：显示当前固件版本（如 PX4 v1.14.0）、Git 哈希值和编译日期。

• 传感器状态：各传感器（加速度计、陀螺仪、磁力计、气压计、GPS）的校准状态，绿色对勾表示已校准，红色叉号表示需要校准。

• 电池状态：电池电压和容量信息。

• 遥控器状态：遥控器连接状态和通道映射信息。

• 飞行时间：累计飞行时间和飞行次数统计。

14.2.2 Airframe 机架类型选择

在"Airframe"设置页面中，选择与飞行器匹配的机架类型：

选择正确的机架类型后，PX4 固件会自动加载对应的默认参数集（混控器、PID 初始值、安全限制等），大幅简化后续配置。

14.2.3 Actuator 输出配置

在"Actuators"设置页面中配置电机和舵机的输出映射：

1. 电机通道映射：确认每个电机对应正确的 PWM/DShot 输出通道。

2. 电机方向测试：点击每个电机的"Test"按钮，确认旋转方向正确（根据机架类型，部分电机正转，部分反转）。

3. DShot 配置（如使用 DShot ESC）：

• 在"Actuator Output"中选择 DShot 协议。

• 可选 DShot150 / DShot300 / DShot600 / DShot1200。

• ZP_H743 推荐使用 DShot600，兼顾速度和稳定性。

4.PWM 频率配置（如使用 PWM ESC）：

• 标准 PWM：400Hz（适用于大多数电调）。

• OneShot125：适用于支持 OneShot 的电调。

14.3 传感器校准

传感器校准是确保飞行安全和导航精度的关键步骤。QGC 提供了图形化的校准引导流程。

14.3.1 加速度计校准

加速度计校准需要用户在 QGC 引导下将飞行器置于 6 个标准姿态：

1. 点击"Accelerometer"校准按钮。

2. QGC 显示当前加速度计校准状态，点击"Start"开始校准。

3. 按照屏幕上的 3D 模型指示，依次将飞行器放置于以下 6 个姿态：

• Level（水平）：飞行器正常放置，水平朝上

• Left Side（左侧朝下）：飞行器向左侧翻转 90°

• Right Side（右侧朝下）：飞行器向右侧翻转 90°

• Nose Down（机头朝下）：飞行器向前翻转 90°

• Nose Up（机头朝上）：飞行器向后翻转 90°

• Back（背部朝下）：飞行器翻转 180°，底部朝上

4. 每个姿态放置稳定后，点击"Next"确认。QGC 会采集当前姿态的加速度数据。

5. 6 个姿态全部完成后，QGC 计算校准参数并写入飞控板。

6. 校准完成后，Summary 页面的加速度计状态变为绿色。

【提示】：校准时确保飞行器放置稳固，每个姿态之间切换时避免

剧烈晃动。ZP_H743 搭载的 ICM-42688-P 加速度计具有出色的温度稳定性，校准后在正常工作温度范围内（-10°C ~ 50°C）不需要重新校准。

14.3.2 陀螺仪校准

陀螺仪校准相对简单：

1. 点击"Gyroscope"校准按钮。

2. 将飞行器放置在水平且稳定的平面上，确保没有任何振动源。

3. 点击"Start"开始校准。

4. 校准过程中飞行器必须保持完全静止（约 5-10 秒）。

5. QGC 自动采集陀螺仪零偏数据并计算校准参数。

6. 校准完成后显示成功提示。

【提示】：陀螺仪零偏会随温度变化，PX4 固件内置了温度补偿机制。建议在飞行环境温度下重新校准陀螺仪以获得最佳性能。

14.3.3 磁力计（罗盘）校准

磁力计校准需要在三维空间中旋转飞行器以采集地磁数据：

1. 点击"Compass"校准按钮。

2. 点击"Start"开始校准。

3. QGC 显示一个进度条和三维旋转引导动画。

4. 按照引导在三维空间中缓慢旋转飞行器，确保覆盖所有方向：

• 水平旋转（偏航方向）360°

• 俯仰方向旋转 360°

• 横滚方向旋转 360°

5. 旋转过程中 QGC 实时显示数据采集进度，覆盖的区域以绿色显示在球面上。

6. 当进度达到 100% 时校准自动完成。

7. 校准结果会显示"Fit Quality"（拟合质量）评分，建议达到"Good"或"Excellent"。

【提示】：校准时远离大型金属物体、电磁设备和钢筋混凝土建筑。ZP_H743 建议同时安装外部磁力计（如 Matek M10Q-5883 集成的 QMC5883L），远离电机和电调的电磁干扰。

14.3.4 电机校准

⚠️安全前提：拆下螺旋桨，防止意外转动伤人

• 确认机架构型：当前为四轴 X 构型（CCW），电机编号、转向与实物保持一致。
• 电调协议统一：MAIN1~4 选择 DSHOT300，不要混用 PWM/DSHOT 协议。
• 转向校验：使用Set Spin Direction按钮，对照示意图确认旋转方向，反向电机勾选对应反转复选框。
• 单独测试：拖动 Actuator Testing 滑块，逐个验证每个电机正常响应，无卡顿、异响。
• 禁止带电触碰电机转轴，测试完成后关闭执行器滑块，再安装桨叶。
• 若电调首次使用，需提前完成电调油门行程校准。

14.4 遥控器校准与飞行模式映射

14.4.1 遥控器校准流程

1. 在 QGC 的"Radio"设置页面点击"Start"开始校准。

2. 按照引导依次操作遥控器各通道：

• 右摇杆（副翼/横滚）：左推到底 → 居中 → 右推到底

• 右摇杆（升降/俯仰）：上推到底 → 居中 → 下拉到底

• 左摇杆（油门）：推至最高 → 拉至最低

• 左摇杆（方向/偏航）：左推到底 → 居中 → 右推到底

3. QGC 自动检测各通道的最小值、中位值和最大值。

4. 校准完成后显示各通道的校准数据，确认数值合理（中位值接近 1500μs，行程范围约 1000-2000μs）。

14.4.2 飞行模式映射

PX4 使用遥控器通道映射飞行模式，与 INAV 的方式有所不同：

1. 在"Flight Modes"设置页面，选择用于模式切换的遥控器通道（通常为 AUX1/CH5 或 AUX2/CH6）。

2. PX4 支持将通道行程划分为最多 6 个档位，每个档位对应一个飞行模式：

1. 拨动遥控器开关，确认 QGC 中显示的当前模式与预期一致。

2. 可设置额外的开关用于以下辅助功能：

• Kill Switch（紧急停机）：映射到独立开关，一旦触发立即关闭所有电机。

• Return Switch（返航开关）：映射一个专用开关用于触发 RTL。

• Loiter Switch（悬停开关）：快速切换到 Position Hold 模式。

14.5 安全设置（Failsafe / Return-to-Launch / GeoFence）

安全设置是飞行操作中最重要的配置环节，直接关系到飞行器、人员和财产的安全。

14.5.1 Failsafe（失控保护）配置

PX4 的 Failsafe 系统覆盖了多种异常场景：

低电量阈值设置：

• Level 1（警告级）：COM_LOW_BAT_ACT = 1（RTL），阈值建议设为电池容量的 30%。

• Level 2（紧急级）：COM_LOW_BAT_ACT = 2（Land），阈值建议设为电池容量的 15%。

• Critical（危险级）：COM_LOW_BAT_ACT = 3（Terminate），阈值建议设为电池容量的 5%。

14.5.2 Return-to-Launch（RTL 返航）配置

PX4 的 RTL 系统与 INAV 的 RTH 类似，但参数命名和策略有所不同：

RTL 流程（多旋翼）：

1. 触发 RTL 后，飞行器记录当前位置和航向。

2. 爬升至 RTL_RETURN_ALT高度（如果当前高度更高则保持）。

3. 沿直线飞向 Home 点（或指定 RTL 着陆点）。

4. 到达后下降至 RTL_DESCEND_ALT高度悬停。

5. 等待 RTL_LAND_DELAY秒后执行自动降落。

14.6 日志下载与分析

14.6.1 飞行日志管理

PX4 固件将每次飞行的完整数据记录在飞控板的 SD 卡或内部 Flash 中，格式为 .ulg（ULog 格式）。

日志下载步骤：

1. 在 QGC 中点击"Analyze"→"Log Download"。

2. QGC 列出飞控板中存储的所有日志文件，显示文件名、日期、大小和飞行时长。

3. 选择需要下载的日志文件，点击"Download"。

4. 下载完成后日志文件保存在本地指定目录。

14.6.2 日志分析工具

QGC 内置了基础的日志分析功能：

• Log Browser：在"Analyze"→"Log Browser"中加载 .ulg日志文件，以图表形式显示各通道的飞行数据。

• 可调取的数据通道：加速度、角速度、姿态角、GPS 位置、气压高度、电机输出、PID 误差、电池电压/电流、遥控输入等。

专业分析工具推荐：

14.6.3 振动分析

日志分析的一个重要应用是振动诊断：

1. 下载包含 IMU 原始数据的飞行日志。

2. 在 Flight Review 中查看"Vibration"分析图表。

3. 关注以下指标：

• 加速度计振动：正常值 < 1.0 m/s² RMS，超过 2.0 m/s² 需要检查机架结构。

• 陀螺仪振动：正常值 < 0.05 rad/s RMS。

• 频谱分析：如果特定频率出现明显峰值，可能指示电机不平衡或螺旋桨损坏。

14.7 QGC 特色功能专项

14.7.1 MAVLink 实时数据流监控与自定义仪表盘

MAVLink 协议概述：

MAVLink 是 PX4/ArduPilot 与地面站之间的标准通信协议。QGC 通过 MAVLink 接收飞行器的全部遥测数据。MAVLink 2.0 支持加密和身份验证，提升了通信安全性。

MAVLink Inspector（数据流监控器）：

QGC 提供了内置的 MAVLink Inspector 工具，用于实时监控 MAVLink 消息流：

1. 在"Analyze"菜单中选择"MAVLink Inspector"。

2. 界面左侧显示所有活跃的 MAVLink 消息类型及其接收频率。

3. 点击任意消息类型，右侧显示该消息的所有字段及其当前值。

4. 常见 MAVLink 消息类型：

自定义仪表盘（Custom Telemetry Widgets）：

QGC 允许用户自定义 Fly View 中的遥测数据显示：

1. 在 Fly View 中右键点击遥测数据区域，选择"Edit"。

2. 进入仪表盘编辑模式，可添加以下类型的 Widget：

• Value Widget：显示单个数值（如电压、速度）。

• Gauge Widget：以仪表形式显示数值（带刻度和指针）。

• Bar Widget：以条形图形式显示百分比或范围值。

• Compass Widget：罗盘方位显示。

• Plot Widget：实时曲线图，显示数值的历史变化。

1. 每个 Widget 可选择绑定的 MAVLink 数据源。

2. 调整 Widget 大小和位置后保存布局。

QGC 内置了完整的视频流接收和显示功能，支持多种流媒体协议。

14.7.2 离线地图与任务预规划

离线地图功能：

QGC 支持预下载地图瓦片以供离线使用，适用于无网络连接的野外作业环境：

1. 在 QGC 设置中选择"Offline Maps"。

2. 点击"Create New Set"创建新的离线地图集。

3. 在地图上框选需要下载的区域。

4. 选择缩放级别范围（建议 Level 1-18 覆盖从全局到细节）。

5. QGC 估算需要下载的瓦片数量和磁盘空间。

6. 确认下载，等待完成。

7. 离线地图自动保存在本地缓存中，离线环境下自动加载。

支持的地图源：

任务预规划工作流：

在离线环境下进行任务预规划的完整流程：

1. 在有网络的环境下，下载目标区域的离线地图。

2. 在 Plan View 中基于离线地图规划航线。

3. 设置地形跟随（Terrain Follow）模式时，需预先下载 DEM 高程数据。

4. 将任务保存为 .plan文件。

5. 到达作业现场后，连接飞控板，上传 .plan文件执行任务。

14.7.3 QGC 与 PX4 固件的深度配合（参数树 / MAVLink Shell）

参数树（Parameter Tree）管理：

PX4 固件包含数百个可调参数，QGC 提供了完整的参数管理界面：

1. 在 Vehicle Setup 中选择"Parameters"进入参数管理页面。

2. 参数按功能分组显示：

1. 每个参数提供：

• 名称和描述。

• 当前值和默认值。

• 允许值范围和单位。

• 是否需要重启才能生效的提示。

参数修改后点击"Save"写入飞控板，部分参数需要重启飞控板后生效。

参数批量管理：

• 导出参数文件：将所有参数导出为 .params文件，用于备份或在同型号飞行器间复制配置。

• 导入参数文件：从 .params文件批量加载参数，节省逐项配置时间。

• 参数对比：将当前参数与默认值对比，快速识别已修改的参数。

• 参数搜索：通过搜索框快速定位目标参数。

MAVLink Shell（命令行控制台）：

QGC 内置了 MAVLink Shell 功能，允许操作者直接与 PX4 固件的 NSH（NuttX Shell）或系统命令行交互：

1. 在"Analyze"菜单中选择"MAVLink Console"。

2. Shell 终端连接到飞控板的命令行接口。

3. 常用 NSH 命令：

uORB 话题监听：

PX4 使用 uORB（micro Object Request Broker）作为内部进程间通信机制。通过 MAVLink Shell 可以实时监听各模块的数据交换：

# 监听传感器融合输出

listener estimator_status

# 监听 GPS 数据

listener vehicle_gps_position

# 监听电池状态

listener battery_status

# 监听遥控器输入

listener manual_control_input

14.7.4 Joystick 虚拟摇杆控制与 SITL 仿真对接

Joystick 虚拟摇杆控制：

QGC 支持通过 USB 游戏手柄或专业遥控器作为虚拟摇杆直接控制飞行器，适用于以下场景：

• 在没有物理遥控器的情况下进行测试飞行。

• 使用计算机上的飞行模拟设备进行训练。

• 通过自定义控制器实现特殊操控需求。

配置步骤：

1. 将 USB 游戏手柄（如 Xbox 手柄、PS 手柄）连接至计算机。

2. 在 QGC 设置中选择"Joystick"。

3. QGC 自动检测已连接的手柄设备。

4. 按照引导完成轴映射校准：

• 移动左摇杆的横滚轴，QGC 自动检测对应轴号。

• 移动左摇杆的俯仰轴，QGC 自动检测对应轴号。

• 移动右摇杆的油门轴，QGC 自动检测对应轴号。

• 移动右摇杆的偏航轴，QGC 自动检测对应轴号。

1. 配置按钮映射：将手柄按钮映射到 Arm、Disarm、RTL、Mode Switch 等功能。

2. 设置死区和指数曲线，使操控手感更自然。

安全提醒：虚拟摇杆控制依赖计算机与飞控板之间的数据链路。如果链路中断，飞行器将执行 Failsafe 动作。建议仅在受控环境中使用虚拟摇杆。

SITL（Software In The Loop）仿真对接：

QGC 可以无缝对接 PX4 的 SITL 仿真环境，无需真实硬件即可进行飞控算法验证和任务测试。

SITL 环境搭建：

1. 安装 PX4 开发环境（参考 PX4 官方文档）。

2. 在终端中启动 SITL 仿真：

# 启动四旋翼 SITL 仿真（使用 Gazebo 模拟器）

make px4_sitl gazebo-classic_iris

# 启动固定翼 SITL 仿真

make px4_sitl gazebo-classic_plane

# 仅启动 SITL（不启动 3D 可视化）

make px4_sitl none_iris

SITL 仿真器启动后，在本地 UDP 端口 14540 上提供 MAVLink 接口。

QGC 连接 SITL：

1. QGC 默认监听 UDP 14550 端口，SITL 默认连接 UDP 14540/14550。

2. 启动 SITL 后，QGC 会自动检测到仿真飞行器并建立连接。

3. 在 QGC 中看到的界面与连接真实飞控板完全一致。

4. 可以在 SITL 环境中进行：

• 完整的传感器校准流程（仿真数据）。

• 任务规划和执行测试。

• PID 调参验证。

• Failsafe 场景模拟。

• 飞行模式切换测试。

SITL 仿真中的故障注入：

通过 MAVLink Shell 可以在仿真中注入各种故障，测试系统的容错能力：

# 模拟 GPS 信号丢失

param set EKF2_GPS_CTRL 0

# 模拟电机故障

failure inject --type motor --id 1 --state off

# 模拟风速突变

wind set 10 5 2 # 设置风速 10m/s 北向 5m/s 东向 2m/s 上升

# 模拟电池电压下降

param set SIM_BAT_MIN 10.0

14.7.5 QGC 移动端（Android / iOS）使用指南

QGroundControl 移动端应用提供了与桌面端几乎一致的功能，是外场飞行的便携解决方案。

移动端功能对比：

移动端连接方式：

1. USB OTG 连接：使用 USB OTG 转接线将飞控板直接连接到手机/平板的 USB 端口。Android 设备会自动识别串口设备。iOS 设备需要 Apple Camera Adapter。

2. WiFi 连接：如果飞控板通过 WiFi 模块（如 ESP8266/ESP32 WiFi 桥接）提供网络连接，手机连接同一 WiFi 后 QGC 自动发现飞行器。

3. 蓝牙连接：部分蓝牙数传模块（如 Holybro Telemetry Radio）支持与移动端蓝牙连接。

移动端界面优化：

• 移动端 QGC 针对触屏操作进行了界面优化：

• 按钮和控件更大，便于手指操作。

• 支持双指缩放地图。

• 支持长按地图弹出上下文菜单。

• 侧边栏菜单通过滑动手势展开/收起。

• 横屏模式下显示更多飞行数据。

移动端任务规划技巧：

1. 在 WiFi 环境或离线环境下，使用手指在地图上点触设置航点。

2. 双指缩放查看航线细节和地形。

3. 利用离线地图功能在无网络的野外环境预规划任务。

4. 保存的任务文件可通过手机存储或云存储备份。

移动端外场飞行建议：

• 使用平板电脑（如 iPad Pro 12.9"）代替手机，更大的屏幕提供更好的地图和数据显示。

• 搭配遮阳罩使用，避免强光下屏幕反光导致看不清数据。

• 确保移动设备电量充足，建议配备充电宝。

• 开启飞行模式以节省电量并避免来电/通知干扰。

• 预先下载离线地图，避免现场网络不稳定影响使用。

• 移动端作为辅助操控工具使用，建议同时配备物理遥控器作为主操控设备。

本章小结

本章详细讲解了 QGroundControl 地面站的安装连接、载具设置、传感器校准、任务规划、飞行监控、日志分析等核心功能，并深入探讨了 MAVLink 数据流监控、视频流集成、多载具管理、QML 界面扩展、离线地图、PX4 参数管理、Joystick 控制和 SITL 仿真等特色功能。QGC 作为 PX4/ArduPilot 生态的核心地面站工具，其强大的功能和灵活的扩展性为 ZP_H743 飞控板的调试和飞行操作提供了全面支持。掌握 QGC 的使用，是进行专业无人机飞行操作的必要技能。