MiniGCS

MiniGCS 是一个基于 Qt6 + MAVSDK 的地面控制站（GCS）C++ 共享库（版本 1.0.0）。它提供无人机/飞控的链路管理、状态采集、航线规划及自动驾驶控制等核心能力，可作为库集成到上层 GCS 应用程序中。

依赖项

依赖	版本要求	说明
Qt6	≥ 6.9	Core 模块（对象系统、信号槽、MOC）
MAVSDK	—	MAVLink 协议通信
spdlog	—	高性能日志
CMake	≥ 3.16	构建系统
C++	20	语言标准

Windows 预编译依赖：仓库未包含 Depends/（见 .gitignore）。在 Windows 上构建前，需自行准备第三方库并放到项目根目录，目录布局需与 CMakeLists.txt 一致（见下文「准备 Depends」）。

---

准备 Depends（Windows）

在仓库根目录创建 Depends/，结构示例：

Depends/
├── mavsdk/
│   └── lib/cmake/MAVSDK/    # find_package(MAVSDK) 所需
└── spdlog/
    ├── x64-Debug/lib/cmake/spdlog/
    └── x64-Release/lib/cmake/spdlog/

非 Windows 平台需在系统中安装 MAVSDK、spdlog，并保证 CMake 能通过 find_package 找到它们（当前 CMakeLists.txt 仅在 WIN32 下自动设置上述路径）。

---

构建

前置条件

• 安装 Qt 6.9+（含 Core；运行 Test 还需 Quick、SerialPort、Location、Network）
• 设置环境变量 QTDIR 指向 Qt 工具链，例如 C:/Qt/6.9.0/msvc2022_64
• MSVC 2022 或兼容工具链（Windows 推荐）
• 已按上文准备好 Depends（Windows）或系统级 MAVSDK / spdlog

配置与编译

以 Ninja + 单配置 为例（CMAKE_BUILD_TYPE 会用于选择 Debug/Release 版 spdlog）：

# Release
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build

# Debug（产物为 MiniGCSd.dll / MiniGCSd.lib，见 CMAKE_DEBUG_POSTFIX）
cmake -B build-debug -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build build-debug

使用 Visual Studio 多配置生成器 时，需在配置阶段指定 -DCMAKE_BUILD_TYPE=Release 或 Debug（与 spdlog 路径选择一致），构建时指定 --config：

cmake -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

CMake 选项	默认值	说明
BUILD_TEST	ON	是否同时构建 Test/ 下的 QML 演示程序

构建产物默认位于 build/（或你指定的 -B 目录），例如 build/MiniGCS.dll、build/Test.exe。

安装

cmake --install build --prefix <安装目录>

安装后目录结构：

<prefix>/
  bin/          # MiniGCS.dll
  lib/          # 导入库 + cmake/MiniGCS/
  include/      # 公开头文件（不含 Private 子目录）

---

集成到其他 CMake 项目

安装完成后，在下游项目的 CMakeLists.txt 中：

find_package(MiniGCS REQUIRED)

target_link_libraries(MyApp PRIVATE MiniGCS::MiniGCS)

在同一构建树中开发时，也可直接 add_subdirectory(MiniGCS) 并链接目标 MiniGCS（无需先安装）。

---

快速开始

#include <QCoreApplication>
#include <QDebug>
#include "QGroundControlStation.h"
#include "QGCSConfig.h"
#include "Link/QLinkManager.h"
#include "Plat/QAutopilot.h"

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);

    QGCSConfig::instance()->init();

    QGroundControlStation gcs;
    gcs.Init();

    QObject::connect(&gcs, &QGroundControlStation::newPlatFind, [](QPlat *plat) {
        if (auto *ap = qobject_cast<QAutopilot *>(plat)) {
            qDebug() << "GPS lat:" << ap->gpsPosition().latitude();
        }
    });

    LinkParams params;
    params.port = 14550;
    gcs.linkManager()->addLink(LinkKind::UdpServer, params);

    return app.exec();
}

典型初始化顺序：QGCSConfig::instance()->init() → 创建 QGroundControlStation → Init() → 通过 linkManager() 添加链路。

---

模块说明

核心入口

类	头文件	说明
QGroundControlStation	QGroundControlStation.h	GCS 核心：链路管理器、飞控对象生命周期、newPlatFind 等信号
QGCSConfig	QGCSConfig.h	配置单例（INI）：系统/组件 ID、日志级别、MAV 扩展消息等

链路管理（Link）

类/结构	说明
QLinkManager	统一管理通信链路
QDataLink	单条链路抽象，负责数据收发
LinkKind	TcpServer / TcpClient / UdpServer / UdpClient / Serial / Raw
LinkParams	链路参数（端口、主机名、串口名、波特率）

QLinkManager *lm = gcs.linkManager();

LinkParams params;
params.port = 14550;
lm->addLink(LinkKind::UdpServer, params);

平台 / 飞控（Plat）

类	说明
QPlat	平台基类：固件版本、连接状态等
QAutopilot	自驾仪：GPS/NED/Home、姿态、航向、飞行模式、解锁/起飞等
QAutopilotStatus	电池、飞行模式、解锁状态等
QAutopilotFixedwing	固定翼扩展状态
QAutoVehicleType	载具与自驾仪类型枚举

航线管理（AirLine）

类	说明
QAirLineManager	多条航线管理（支持 QML）
QAirLine	单条航线及航点列表
QGpsPosition	GPS 坐标（经纬度、高度）
QNEDPosition	NED 坐标

外部接口（Extern）

类	说明
XmlToMavSDK	XML 任务文件 → MAVSDK 任务项
AsyncSendMavLink	异步 MAVLink 发送队列

---

日志与配置

• 日志由 spdlog 输出，并通过 QGCSConfig::qtLogHandler 接管 Qt 的 qDebug / qWarning 等。
• 默认日志文件（相对当前工作目录）：data/log/minigcs.log（按日滚动，保留 7 天）。
• 配置文件路径：<可执行文件目录>/Config/<applicationName>.ini（applicationName 为空时使用 MiniGCS.ini）。

常用 INI 键（节名以代码为准）：

键	默认值	说明
GCS/SystemId	246	地面站 MAVLink 系统 ID
GCS/ComponentId	191	地面站组件 ID
Logging/Level	debug	trace / debug / info / warn / error / critical / off
MavMessage/Extension	ardupilotmega.xml	MAV 消息扩展定义
TimeSync/Enabled	true	是否启用时间同步

可通过继承 QGCSConfig 并在首次 instance() 前调用 QGCSConfig::setInstance() 注入自定义配置（Test 工程中的 QTestGCSConfig 即如此，并额外支持多链路配置）。

---

Test 演示程序

默认随库一起构建（BUILD_TEST=ON）。Test 为 Qt Quick 示例，依赖 Qt 模块：Core、Quick、SerialPort、Location、Network。

cmake --build build --target Test
# 运行前将 MiniGCS.dll、Qt 运行时与 MAVSDK 依赖置于 PATH 或 exe 同目录
./build/Test.exe

程序从 QTestGCSConfig 读取链路列表并自动 addLink，QML 界面见 Test/qml/Main.qml。

---

目录结构

MiniGCS/
├── CMakeLists.txt
├── MiniGCSConfig.cmake.in     # 安装后的 CMake 包配置模板
├── Depends/                   # Windows 第三方库（本地准备，不入库）
├── Inc/                       # 公开头文件
│   ├── QGroundControlStation.h
│   ├── QGCSConfig.h
│   ├── QGCSLog.h
│   ├── MiniGCSExport.h
│   ├── AirLine/
│   ├── Link/
│   ├── Plat/
│   └── Extern/
├── Src/                       # 实现
└── Test/                      # QML 演示与 QTestGCSConfig
    ├── CMakeLists.txt
    ├── main.cpp
    └── qml/Main.qml

---

许可证

MIT License — Copyright (c) 2025 杨天宇