QGroundControlQGC是开源无人机地面站软件由 Dronecode 基金会维护是 PX4 和 ArduPilot 生态系统的核心组件。QGC 提供了完整的飞行规划、实时监控、传感器校准和数据分析功能支持桌面端Windows/macOS/Linux和移动端Android/iOS。本章将基于 ZP_H743 飞控板配合 PX4 固件全面讲解 QGroundControl 的配置与使用。14.1 QGroundControl 安装与连接14.1.1 软件获取与安装QGroundControl 可从官方网站https://qgroundcontrol.com/downloads下载最新版本。安装步骤Windows1.下载 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 bpsMAVLink 标准遥测速率。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•标准 PWM400Hz适用于大多数电调。•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 1RTL阈值建议设为电池容量的 30%。• Level 2紧急级COM_LOW_BAT_ACT 2Land阈值建议设为电池容量的 15%。• Critical危险级COM_LOW_BAT_ACT 3Terminate阈值建议设为电池容量的 5%。14.5.2 Return-to-LaunchRTL 返航配置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 中格式为 .ulgULog 格式。日志下载步骤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 WidgetsQGC 允许用户自定义 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 固件的 NSHNuttX Shell或系统命令行交互1.在Analyze菜单中选择MAVLink Console。2.Shell 终端连接到飞控板的命令行接口。3.常用 NSH 命令uORB 话题监听PX4 使用 uORBmicro Object Request Broker作为内部进程间通信机制。通过 MAVLink Shell 可以实时监听各模块的数据交换# 监听传感器融合输出listener estimator_status# 监听 GPS 数据listener vehicle_gps_position# 监听电池状态listener battery_status# 监听遥控器输入listener manual_control_input14.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 动作。建议仅在受控环境中使用虚拟摇杆。SITLSoftware 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_irisSITL 仿真器启动后在本地 UDP 端口 14540 上提供 MAVLink 接口。QGC 连接 SITL1.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.014.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 的使用是进行专业无人机飞行操作的必要技能。