主题
飞控适配
模块通过 UART 串口从飞控获取飞行数据。本章面向装机与适配人员，说明接口约定、数据需求与调试方法。
串口约定
| 项 | 约定 |
|---|---|
| 接口 | UART（TTL 电平） |
| 波特率 | 115200 bps |
| 数据方向 | 飞控 → 模块单向输出飞行数据；模块不向飞控注入控制指令 |
| 线序 | TX / RX / GND 交叉连接（见快速上手 · 固定与接线） |
模块需要的数据
运行识别 21 项内容中，以下各项来自飞控（其余由模块自产或平台侧配置）：
| 数据 | 用途 | 对应上报项 |
|---|---|---|
| 位置（经纬度） | 无人机位置、起飞点 | (08) 航空器经纬度、(05)(06) 遥控站位置 |
| 高度（相对 / 几何 / 气压） | 高度类上报 | (11)(13)(14) |
| 地速 / 垂直速度 / 航迹角 | 速度类上报 | (09)(10)(12) |
| 定位精度信息 | 精度分档 | (17)(18)(19) |
| 解锁 / 飞行状态 | 航次起止判定、运行状态 | (15) |
| 时间基准 | 报文时间戳 | (20) |
个别项暂时拿不到时，模块按国标**「未知」专用编码**上报（联调阶段占比 ≤10%）——不影响其他项的正常报送。
数据协议与字段映射以随货《适配接口说明》为准（待补充）。
适配机型
| 飞控 | 适配状态 | 说明 |
|---|---|---|
| 待补充 | 待补充 | 各机型配置步骤将逐条补充 |
通用配置路径：在飞控地面站中启用对应串口（TELEM 类型）、设置波特率 115200、打开上述数据输出——具体参数以各机型条目为准。
调试
| 途径 | 说明 |
|---|---|
| 串口日志 | 模块侧日志输出 4G 连接、数据解析与上报状态（波特率见规格书） |
| 用户平台 | 设备「在线状态 + 最近上报时间」是链路是否打通的最直接判据 |
| 航次轨迹 | 首飞后在平台查看轨迹，确认位置数据正确 |
排查流程
设备在平台不在线时，按下面顺序定位：
常见数据问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 在线但无航次 | 飞控串口未开启 / 线序错误 | 地面站确认串口输出；核对 TX/RX 交叉 |
| 轨迹漂移或跳点 | GPS 未锁定即起飞 | 起飞前等待定位锁定（精度档位稳定） |
| 高度恒为未知 | 飞控未输出对应高度源 | 检查飞控高度数据配置 |
| 航次时间偏差 | 飞控时间基准异常 | 校准飞控时间 / GPS 授时 |
判通标准
设备在平台显示在线、上报时间持续刷新、首飞后轨迹完整——三条全满足即说明全链路（飞控 → 模块 → 云端 → UOM）已通。