4、协议适配核心概念

好，咱们进入正题。这一章讲的是协议适配的核心概念，说白了就是——你手里有两套定位系统，一套用 UWB，一套用 WiFi，怎么让它们「说同一种语言」？

我刚开始做这个方向的时候，觉得不就是个数据格式转换嘛，写个映射表不就完了？后来被现实狠狠教育了一顿。嗯，这里面的坑，比你想的深得多。

4.1 协议适配的定义

协议适配，不是简单的「翻译」。它是在两个或多个通信协议之间，建立一套双向的、语义完整的映射机制。

拿 UWB 和 WiFi 定位来举例：

• UWB 上报的是：TOF（飞行时间）、TDOA（到达时间差）、AOA（到达角）
• WiFi 定位通常输出：RSSI（信号强度）、FTM（往返时间）、CSI（信道状态信息）

这两套数据，物理含义不同、精度不同、更新频率不同、甚至时间戳的基准都不同。协议适配要做的，就是让上层应用能统一调用，而不必关心底层用的是 UWB 还是 WiFi。

4.2 协议适配的必要性

为什么要做适配？直接各跑各的不行吗？

我在一个大型仓储项目里遇到过这种情况：UWB 基站和 WiFi AP 各自独立部署，定位数据分别送到两个后台系统。结果呢？同一个叉车，UWB 说它在 A 区，WiFi 说它在 B 区，调度系统直接懵了。

协议适配的必要性，体现在三个层面：

1. 系统融合：多源定位数据必须统一接入，才能做融合定位。没有适配，就是数据孤岛。
2. 成本优化：不是所有场景都需要 UWB 的高精度。走廊、仓库边缘用 WiFi 覆盖就够了。适配之后，可以按需切换，省成本。
3. 运维简化：统一的数据接口，意味着统一的监控、统一的告警、统一的日志。我见过一个项目，因为没做适配，运维要同时盯着两套控制台，出了故障还得猜是哪边的问题。

4.3 协议适配的层次模型

协议适配不是一锤子买卖。我习惯把它分成三个层次，每一层解决不同的问题。

你看这个图，从下往上，一层比一层抽象。

• 物理层适配：解决「能不能连」的问题。UWB 用 6-8 GHz 频段，WiFi 用 2.4/5 GHz，硬件接口也不一样。这一层把差异屏蔽掉。
• 数据层适配：解决「数据对不对」的问题。UWB 的 TOF 单位是纳秒，WiFi 的 FTM 单位是皮秒，不转换没法用。
• 语义层适配：解决「意思对不对」的问题。UWB 的定位精度是 10-30 cm，WiFi 是 1-3 m，上层应用需要知道这个置信度差异。

4.4 协议适配的关键技术

讲完了模型，咱们聊聊具体怎么干。协议适配涉及的技术点不少，我挑四个最核心的来说。

4.4.1 数据格式转换

这是最基础的一步。UWB 和 WiFi 的数据结构完全不同，需要定义一套中间格式。

// UWB 原始数据示例
{
  "device_id": "UWB_001",
  "timestamp": 1712345678.123,
  "tof_ns": 12.345,
  "aoa_deg": 45.6,
  "rssi_dbm": -65
}

// WiFi 原始数据示例
{
  "mac": "AP_0A:1B:2C:3D:4E:5F",
  "ts": 1712345678123,
  "rssi": -72,
  "ftm_ps": 12345,
  "csi": [0.12, -0.34, 0.56, ...]
}

// 统一中间格式
{
  "source": "uwb",  // 或 "wifi"
  "device_id": "UWB_001",
  "timestamp_unix": 1712345678.123,
  "measurements": {
    "range_m": 3.698,    // 统一为米
    "angle_deg": 45.6,
    "confidence": 0.95   // 统一置信度
  }
}

你想想看，如果没有这个中间格式，每接入一种新设备就要改上层代码，那得多痛苦。

4.4.2 时间同步机制

这个我前面提过，是个大坑。UWB 和 WiFi 的时间基准不同，必须做对齐。

同步方式	精度	适用场景	我踩过的坑
NTP 同步	毫秒级	WiFi 定位	局域网内还行，跨网段延迟抖动大
PTP 同步	微秒级	UWB 基站	需要硬件支持，配置复杂
软件时间戳对齐	取决于网络	混合场景	我常用，但要注意时钟漂移补偿

4.4.3 精度与置信度映射

UWB 说「位置在 (x, y)」，误差 20 cm。WiFi 说「位置在 (x', y')」，误差 2 m。上层融合算法怎么处理？

我的做法是：定义一个统一的置信度字段，取值范围 0.0 到 1.0。

• UWB 定位：置信度 0.85 - 0.98
• WiFi 定位：置信度 0.40 - 0.75
• 信号遮挡/多径严重时：置信度降到 0.1 - 0.3

融合算法拿到这个置信度，就知道该信谁多一点。说白了，这就是给数据「打分」。

4.4.4 异常处理与降级策略

协议适配不能只考虑正常情况。UWB 基站掉线了怎么办？WiFi 信号突然变差了怎么办？

我一般设计三档降级策略：

1. 正常模式：UWB + WiFi 融合定位，精度最高
2. 降级模式：UWB 不可用，纯 WiFi 定位，精度下降但可用
3. 应急模式：所有定位源都不可用，用惯性传感器推算