GCS-NG(下一代地面站框架)

本目录是自包含新工程:可整体复制出去独立构建运行,不依赖仓库内任何 Qt 代码。 设计依据:document/框架升级计划-Vue+Go.md(决策)与 document/新框架设计方案-GCS-NG.md(目标架构蓝图)。

当前状态

里程碑 状态 内容
M0 核心完成 C ABI v1(gcscore.dll):方言编解码 + UDP 链路 + 三语言绑定,
黄金向量测试 + Python/Go 双端到端回环 PASS
M1 壳完成(进行中) Wails 桌面壳 GCS-NG.exe:暗色 UI + 连接面板 + 链路统计 +
在线飞机表(bus/vehicle)+ 实时帧流;Cesium 地图嵌入待做
M2 未开始 四大面板(连接/健康/指令/航线)对拍
M3 未开始 插件 2.0 SDK(双轨)
M4 未开始 仿真内核接入 + 全量切换

多协议模式

  • gcs-dialect(存量自研 MAVLink 方言):已实现(core/src/gcscore.cpp);
  • usoa(FALCON_550 v1.1.5,用户提供的 docx 协议):载荷字典已入库 core/protocols/usoa/usoa_dict.json(182 指令/421 字段 + 27 遥测/657 字段, offset/size 零缺失),由 tools/usoa_extract.py 从 docx 提取——协议改版换 docx 重跑即可; 字典驱动的编解码与帧层待实现(usoa 帧层不在 docx 中,需链路设备侧定义/抓包确认), 设计见 docs/PROTOCOLS.md。

目录结构

gcs-ng/
├── README.md            本文件
├── docs/                设计文档
│   ├── ARCHITECTURE.md  架构总览(分层/数据流/实时性/线程模型)
│   ├── ABI-SPEC.md      C ABI v1 规范(API/错误码/守则/版本策略)★冻结
│   ├── BUS-SPEC.md      GCSBus 统一数据总线(话题/QoS/传输后端)
│   └── MIGRATION.md     旧 Qt 工程 → 新框架迁移对照 + 坑 checklist
├── core/                C++ 核心层 → gcscore.dll(C ABI)
│   ├── include/gcs-ng/  对外唯一头 gcscore_c.h(纯 C,语言无关)
│   ├── src/             实现(方言编解码/X.25 CRC/UDP 链路)
│   └── tests/           C 单元测试(黄金向量 + 往返 + 错误注入)
├── bindings/
│   ├── go/              Go 绑定(syscall.NewLazyDLL,免 cgo)
│   └── python/          Python ctypes 绑定 + 回环验证脚本
├── go.mod               Go module 根(module gcs-ng,覆盖 bindings+orchestrator)
├── orchestrator/
│   ├── cmd/gcstest/     端到端冒烟(Go 控制台;Wails 壳 M1 引入)
│   └── internal/
│       ├── bus/         GCSBus(inproc 后端 v0)
│       └── vehicle/     飞机管理(心跳在线判定)
├── sdk/
│   └── plugin.h         轨道一插件 ABI(v0 占位,M3 冻结)
├── plugins/             插件仓库(M3 起填充)
└── tools/               回归与仿真工具(sim3-go 计划中)

构建

核心层(C++,必须先构建)

cd core
cmake -S . -B build -A x64
cmake --build build --config Release
# 产物: core/build/Release/gcscore.dll + gcscore.lib
# 测试: core/build/Release/test_gcscore.exe(自动被 ctest 或手动运行)

Go 编排层(需 Go ≥ 1.23,未安装时先跳过)

# 安装 Go: https://go.dev/dl/ 或 winget install GoLang.Go
go build ./...          # 编译全部包
go test ./...           # 单元测试
go run ./orchestrator/cmd/gcstest   # 端到端冒烟(加载 gcscore.dll 回环收发)

Python 绑定验证(无需 Go,立即验证 DLL)

python bindings/python/verify_loopback.py   # 双链路互发方言帧端到端

方言权威依据

本工程 mavlink 自定义方言(与标准 common 不同,pymavlink 不可直接编解码)以 旧工程 bin/sim3.py 手工拆帧实现为权威对照:帧格式、X.25 CRC 逐字节算法、 各消息 payload 布局与 CRC extra 表(20:196, 21:60, 22:220, 23:32, 40:127, 43:250, 44:18, 47:108, 51:38, 73:218,心跳 0:50 标准)已原样移植进 core/src/dialect.c,并用黄金向量测试锁定。改动编解码前先读 docs/MIGRATION.md。

线程模型(快速记忆)

  • gcs_link_start 启动独立收包线程;帧回调在收包线程执行:不得阻塞、 不得二次调用本链路 API(死锁)、必须拷贝数据后快速返回;
  • 发送(gcs_link_send_*)线程安全(内部互斥);
  • 错误文本线程局部(gcs_last_error),在出错线程内立即读取。
S
Description
No description provided
Readme
28 MiB
Languages
C 79.8%
Go 17.7%
C++ 0.8%
JavaScript 0.8%
MATLAB 0.3%
Other 0.6%