main
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),在出错线程内立即读取。
Languages
C
79.8%
Go
17.7%
C++
0.8%
JavaScript
0.8%
MATLAB
0.3%
Other
0.6%