无人机智能硬件【免费下载链接】qgroundcontrolCross-platform ground control station for drones (Android, iOS, Mac OS, Linux, Windows)项目地址https://gitcode.com/gh_mirrors/qg/qgroundcontrol点击查看免费下载QGroundControlQGC作为跨平台无人机地面站需要同时兼容 PX4、ArduPilot 等不同飞控固件。由于 MAVLink 规范在诸多细节上留白、且并未统一飞控参数集QGC 采用了一套以FirmwarePlugin、AutoPilotPlugin、QGCCorePlugin为核心的插件架构把固件相关代码与通用代码彻底隔离。读完本文你将理解这套分层设计背后的动机、三个插件的接口职责与源码实现细节并掌握如何通过自定义构建Custom Build进一步扩展 QGC。为什么 QGC 需要插件架构MAVLink 规范虽然定义了与飞控通信的标准协议但协议中大量细节留给固件开发者自行解释这导致三个层面的问题同一任务、不同实现对同样一个操作不同固件可能有细微差异的通信方式命令集子集不同每个固件只实现 MAVLink 命令集合中的一个子集参数体系完全未标准化MAVLink 规范不覆盖飞控配置也没有公共参数集。因此所有涉及飞控设置、或需要引用具体参数的代码天然就是固件相关的。如果把这些差异直接散落在主代码中代码库就会退化成满地 if/then/else——每一处逻辑都要根据当前飞控固件类型分叉既难以维护也无法扩展。QGC 的解法是插件架构将固件特定代码从对所有固件通用的代码中隔离出来隔离的边界由三个主要插件界定其中FirmwarePlugin与AutoPilotPlugin承担固件差异化职责QGCCorePlugin则负责应用层面的特性定制也服务于自定义构建。从源码结构看这套边界在仓库中体现得非常清晰固件相关代码集中在 src/FirmwarePlugin 与 src/AutoPilotPlugins 两个目录其下按 PX4、APM 等固件分子目录而 Vehicle、MissionManager 等核心模块保持与固件无关。三个插件的分工总览插件职责关联代码目录FirmwarePlugin为 MAVLink 中普遍未标准化的部分提供统一接口飞行模式、guided 命令、能力探测等src/FirmwarePluginAutoPilotPlugin提供 Vehicle Setup飞控设置的用户界面VehicleComponent 集合与完成状态src/AutoPilotPluginsQGCCorePlugin以标准接口暴露 QGC 应用本身与 Vehicle 无关的特性供自定义构建调整功能集src/API/QGCCorePlugin.ccFirmwarePlugin统一非标准化的 MAVLink 行为FirmwarePlugin是固件差异化代码的唯一归宿。基类 FirmwarePlugin.h 的注释明确写道这是 QGroundControl 源码中唯一允许存放飞行栈特定代码的地方其余代码对通用 MAVLink 实现保持中立基类实现支持mavlink 通用固件派生类通过覆写虚函数实现固件特定行为。基类在 FirmwarePlugin.cc 中的默认实现通常是不支持——例如 guided 系列方法默认弹出 Guided mode not supported by Vehicle. 提示guided_mode_not_supported_by_vehicle见 FirmwarePlugin.cc派生固件按需覆写。飞行模式映射从 HEARTBEAT 到位名飞行模式是各固件差异最大的部分之一。基类提供双向转换能力flightMode(uint8_t base_mode, uint32_t custom_mode)把 HEARTBEAT 中的base_mode/custom_mode解析为人类可读、且可被语音朗读的模式名。基类实现先处理base_mode 0PreFlight再依据MAV_MODE_FLAG_CUSTOM_MODE_ENABLED标志走 custom mode 查表查不到时显示Custom:0x%1否则把 Manual/Stabilize/Guided/Auto/Test 等标志位拼接成模式名见 FirmwarePlugin.ccsetFlightMode(...)反向把模式名写回base_mode/custom_mode用于 SET_MODE 消息基类默认不支持并发出警告FirmwarePlugin.cc。模式名到枚举的映射由_setModeEnumToModeStringMapping(FlightModeCustomModeMap)与_updateFlightModeList(FlightModeList)维护FirmwarePlugin::updateAvailableFlightModes()是固件上报可用模式后的统一入口。FirmwareFlightMode结构FirmwarePlugin.h记录了mode_name、standard_mode、custom_mode以及canBeSet用户能否主动设置该模式、advanced高级模式、fixedWing/multiRotor机型归属等属性。基类还以大量虚函数返回各语义场景的模式名pauseFlightMode()、missionFlightMode()、rtlFlightMode()、smartRTLFlightMode()、landFlightMode()、takeOffFlightMode()、motorDetectionFlightMode()、stabilizedFlightMode()、takeControlFlightMode()、gotoFlightMode()、followFlightMode()等派生固件只需逐一声明我这里的 Pause 对应哪个模式名Fly 视图即可获得一致的交互语义。Guided 模式命令族FirmwarePlugin同时封装了受控guided飞行下的整套命令接口pauseVehicle(Vehicle*)原地悬停/暂停guidedModeRTL(Vehicle*, bool smartRTL)一键返航含 Smart RTLguidedModeLand(Vehicle*)原地降落guidedModeTakeoff(Vehicle*, double takeoffAltRel)按相对高度起飞minimumTakeoffAltitudeMeters()默认返回 3.048 米约 10 英尺guidedModeGotoLocation(Vehicle*, const QGeoCoordinate, double forwardFlightLoiterRadius)飞往指定位置guidedModeChangeAltitude / ChangeGroundSpeed / ChangeEquivalentAirspeed高度、地速、等效空速调整guidedModeChangeHeading与guidedModeROI航向变更与兴趣点ROI。其中guidedModeROI的基类实现展示了典型的 MAVLink 适配思路若飞控声明了MAV_PROTOCOL_CAPABILITY_COMMAND_INT能力则发送MAV_CMD_DO_SET_ROI_LOCATION的 COMMAND_INT 版本否则退回普通MAV_CMD版本_sendROICommandFirmwarePlugin.cc。另外_armVehicleAndValidate()与_setFlightModeAndValidate()FirmwarePlugin.cc展示了带轮询验证的执行模式前者只尝试一次解锁并等待 1.5 秒心跳确认后者最多重试 3 次等待模式切换生效。FirmwareCapabilities能力位探测enum FirmwareCapabilitiesFirmwarePlugin.h以位掩码声明固件可选能力SetFlightMode、PauseVehicle、GuidedMode、OrbitMode、TakeoffVehicle、ROIMode、ChangeHeading、GuidedTakeoff、VTOLMulticopterTakeoff。isCapable(const Vehicle*, FirmwareCapabilities)供 UI 据此显示/隐藏对应控件。仓库还配套了运行时命令支持探测机制FirmwarePluginInstanceDataFirmwarePlugin.h缓存各MAV_CMD的 SUPPORTED/UNSUPPORTED/UNKNOWN 三态结果避免反复往返飞控探测。参数名重映射与参数元数据固件升级时常会重命名参数。FirmwarePlugin提供了一套按版本迭代的重映射机制FirmwarePlugin.hremapParamNameMap_tnew_name - old_name的单版本映射remapParamNameMinorVersionRemapMap_t按固件小版本组织映射remapParamNameMajorVersionMap_t按固件大版本组织映射。调用方统一使用最新参数名ParameterManager::_remapParamNameToVersion()从最高已知小版本向下遍历到飞控实际固件版本逐步把新名翻译回旧名未命中任何映射表时原样透传因此重映射总是安全的。若需绕过重映射例如探测某个新旧具体参数名以决定单位换算可在参数名前加noremap.前缀。参数元数据方面loadParameterMetaData()通过_createParameterMetaData()虚函数创建解析器再加载_cachedParameterMetaDataFile()选定的元数据 JSONFirmwarePlugin.cc。缓存逻辑会对比内置元数据与ParameterMetaData缓存目录CacheLocation/ParameterMetaData中同名大版本的版本号选择较新者并拒绝非 JSON 内容例如旧版 PX4 镜像中的 XML见 FirmwarePlugin.cc。PX4 与 APM 的元数据解析器分别在 src/FirmwarePlugin/PX4/PX4ParameterMetaData.cc 与 src/FirmwarePlugin/APM/APMParameterMetaData.cc配套的离线编辑参数文件如 src/FirmwarePlugin/PX4/V1.4.OfflineEditing.params、src/FirmwarePlugin/APM/Copter.OfflineEditing.params。MAVLink 消息修正钩子为了让基础代码保持 MAVLink 通用插件可以在消息处理前后介入adjustIncomingMavlinkMessage(Vehicle*, mavlink_message_t*)Vehicle 处理任何入站消息前被调用返回false可丢弃消息adjustOutgoingMavlinkMessageThreadSafe(Vehicle*, LinkInterface*, mavlink_message_t*)出站消息前被调用接口要求线程安全。此外还有任务相关的差异化点sendHomePositionToVehicle()决定是否把列表首项QGC 内部固定为 home 位置发送给飞控通用栈默认不发送并调整序列号supportedMissionCommands()与missionCommandOverrides()决定各机型支持的任务指令集后者返回 JSON 覆盖文件——PX4 使用 src/FirmwarePlugin/PX4/PX4-MavCmdInfoCommon.json 等文件APM 对应 src/FirmwarePlugin/APM/APM-MavCmdInfoCommon.json 等文件。其他扩展点FirmwarePlugin还暴露了丰富的可选扩展点toolIndicators()工具栏指示器基类提供 GPS、遥测 RSSI、RC RSSI、电池、云台、电调、摇杆等默认列表见 FirmwarePlugin.cc、vehicleImageOpaque()/vehicleImageOutline()深浅地图下飞机图标、createCameraManager()/createCameraControl()相机、createAutotune()、factGroups()、batteryConsumptionData()、hasGimbal()、hasGripper()、autoDisarmParameter()、getHobbsMeter()、versionCompare()固件版本比较、checkIfIsLatestStable()下载官方版本文件并比对提醒见 FirmwarePlugin.cc、multiRotorCoaxialMotors()/multiRotorXConfig()共轴/十字配置以及defaultJoystickTXMode()默认遥控器模式 2等。工厂与注册机制插件通过工厂创建。FirmwarePluginFactoryFirmwarePluginFactory.h定义两个纯虚函数firmwarePluginForAutopilot(MAV_AUTOPILOT, MAV_TYPE)与supportedFirmwareClasses()。FirmwarePluginFactoryRegister维护全局工厂列表工厂构造时自动注册FirmwarePluginFactory.cc。具体固件的工厂展现了不同的分派策略PX4单实例、单类型。firmwarePluginForAutopilot()仅在MAV_AUTOPILOT_PX4时返回单例PX4FirmwarePlugin见 src/FirmwarePlugin/PX4/PX4FirmwarePluginFactory.ccArduPilotAPM按机型细分。同一MAV_AUTOPILOT_ARDUPILOTMEGA下依据MAV_TYPE分派到 ArduCopter多旋翼、ArduPlane固定翼与 VTOL、ArduRover地面车与水面船、ArduSub潜水器四个插件实例见 src/FirmwarePlugin/APM/APMFirmwarePluginFactory.cc。对应实现位于 src/FirmwarePlugin/APM/ArduCopterFirmwarePlugin.cc、src/FirmwarePlugin/APM/ArduPlaneFirmwarePlugin.cc 等文件。AutoPilotPluginVehicle Setup 的界面提供者AutoPilotPluginsrc/AutoPilotPlugins/AutoPilotPlugin.h是一个抽象基类注释同样声明它是 AutoPilot 特定代码的唯一归宿。它通过vehicleComponents()虚函数返回一组VehicleComponent驱动 Vehicle Setup 界面。核心概念包括KnownVehicleComponent枚举AutoPilotPlugin.hRadio遥控器、FlightModes飞行模式、Sensors传感器、Safety安全、Power动力、Joystick摇杆、ESC、以及UnknownVehicleComponent固件特有的组件。QML 侧可通过knownVehicleComponentAvailable()/findKnownVehicleComponent()查询某个已知组件在当前固件下是否可用prerequisiteSetup(component)返回某组件必须先完成设置的前置组件名用于强制设置顺序例如先校准传感器再设置飞行模式setupComplete属性全部组件就绪后置真驱动 UI 的完成状态_recalcSetupComplete()在组件变化时重算。VehicleComponent的通用实现见 src/AutoPilotPlugins/VehicleComponent.hPX4 与 APM 的组件集合分别在 src/AutoPilotPlugins/PX4 与 src/AutoPilotPlugins/APM 目录APM 下还细分了 Copter/Plane/Rover/Sub 的独立组件实现。另外基类FirmwarePlugin::autopilotPlugin()的默认实现返回GenericAutoPilotPluginFirmwarePlugin.cc对应通用固件的默认设置界面。QGCCorePlugin应用级特性定制QGCCorePluginsrc/API/QGCCorePlugin.h是非固件相关的应用级扩展点它不随飞控类型变化而是让自定义构建整体调整 QGC 的功能集。其头文件注释明确区分了边界——按固件类型变化的行为属于FirmwarePlugin而需要整体修改 QGC 的行为新增/替换 UI 页面、Flight Map 元素、工具栏指示器、视频管线组件、计划文件钩子等属于QGCCorePlugin。基类以 QML 属性暴露大量可覆写行为analyzePages()Analyze 菜单页面列表、toolBarIndicators()、defaultSettings()、options()返回QGCOptions、overrideSettingsGroupVisibility()控制设置组的显示/隐藏、showAdvancedUI、customMapItems等。自定义构建通过子类化QGCCorePlugin并在QGCApplication启动前注册来生效。自定义构建实战custom-example 中的三层扩展仓库根目录的 custom-example 是官方提供的自定义构建示例完整演示了三层插件的用法。应用层CustomPlugin 覆写 QGCCorePluginsrc/API/QGCCorePlugin.cc 的派生类 custom-example/src/CustomPlugin.cc 演示了自定义设置组registerCustomSettings()向SettingsManager注册customSettings组对应 custom-example/src/Settings/CustomSettings离线编辑默认值adjustSettingMetaData()把offlineEditingFirmwareClassName默认值设为 PX4、offlineEditingVehicleClassName设为 MultiRotor 并隐藏选项——让未连接飞控时创建计划始终按目标机型工作调色板覆写paletteOverride()逐色板条目替换明/暗主题颜色QML 覆盖拦截器CustomOverrideInterceptor继承QQmlAbstractUrlInterceptor把所有qrc:路径重定向到:/Custom%1存在对应资源时从而在不改动上游 QML 的前提下替换任意内置页面见 custom-example/src/CustomPlugin.cc自定义复杂任务项complexMissionItemNames()追加 PerimeterScan 条目、createComplexMissionItem()与planCreators()注入 PerimeterScan 的实现与计划创建器。固件层CustomFirmwarePlugin 收窄飞行模式custom-example/src/FirmwarePlugin/CustomFirmwarePlugin.cc 演示了对FirmwarePlugin的定制构造时遍历_flightModeList把除 Pause、RTL、Mission 之外的所有模式canBeSet置为 false——用户只能设置这三个模式覆写toolIndicators()先调用基类拿到上游默认列表保证未来新增指示器自动同步再移除 RC RSSI 指示器覆写hasGimbal()声明该机型支持 pitch/yaw 云台覆写updateAvailableFlightModes()结合px4_custom_mode.h中的PX4CustomMode::AUTO_LOITER / AUTO_RTL / AUTO_MISSION枚举收紧可设置模式随后调用PX4FirmwarePlugin::updateAvailableFlightModes()复用基类的机型分类逻辑。与之配套的 custom-example/src/FirmwarePlugin 还包含CustomFirmwarePlugin.h声明以及 custom-example/src/AutoPilotPlugin 目录下的CustomAutoPilotPlugin对应CustomFirmwarePlugin::autopilotPlugin()返回的自定义设置界面完整展示三个插件如何协同构成一套定制构建。构建配置见 custom-example/CMakeLists.txt 与 custom-example/cmake/CustomOverrides.cmake。总结一条清晰的代码隔离边界QGC 的插件架构本质上是按是否随固件变化这一维度划定的代码隔离边界随固件变化的通信细节、飞行模式、guided 命令、参数体系 →FirmwarePlugin随固件变化的设置界面与组件流 →AutoPilotPlugin与应用整体相关、供自定义构建调整的功能集 →QGCCorePlugin。这种设计让通用模块Vehicle、任务规划、飞控无关的 UI得以保持MAVLink 通用的实现避免了大规模 if/then/else 分叉同时为 PX4、ArduPilot 乃至第三方固件和商业定制构建提供了对等的扩展入口。对于想要深度定制 QGC 的开发者理解这三个插件的边界与覆写点就是掌握整个项目扩展能力的第一步。赞分享无人机智能硬件【免费下载链接】qgroundcontrolCross-platform ground control station for drones (Android, iOS, Mac OS, Linux, Windows)项目地址https://gitcode.com/gh_mirrors/qg/qgroundcontrol点击查看免费下载相关推荐QGroundControl 固件插件架构深度解析FirmwarePlugin、AutoPilotPlugin 与 QGCCorePlugin 扩展机制QGroundControl 固件插件架构深度解析FirmwarePlugin、AutoPilotPlugin 与 QGCCorePlugin 扩展机制 导读无人机智能硬件QGroundControl 自定义构建插件体系FirmwarePlugin / AutoPilotPlugin / QGCCorePlugin 深度定制指南QGroundControl 自定义构建插件体系FirmwarePlugin / AutoPilotPlugin / QGCCorePlugin 深度定制指南无人机智能硬件QGroundControl 自定义构建插件体系全解析QGCCorePlugin、FirmwarePlugin 与 AutoPilotPlugin 定制指南QGroundControl 自定义构建插件体系全解析QGCCorePlugin、FirmwarePlugin 与 AutoPilotPlugin 定制指南无人机智能硬件上一篇终极指南如何配置Conda命令行补全Bash、Zsh与Fish完整教程下一篇7个i3-gaps浮动窗口实用技巧打破平铺规则的最佳实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考