跳转至

XGL 文档

XGL 是面向资源受限 MCU 的生产级多节点可靠协议栈。它提供 v2 wire format、多 PHY 路由、可靠传输、ACK range/SACK、认证、分片重组预算和低功耗运行时 deadline。

当前能力

  • 24-byte 固定 wire header,所有字段手动按 offset 编解码。
  • 16-bit 节点地址和 32-bit packet number。
  • TLV 扩展头支持 session、ACK range、SACK、fragment、security 和 route 元数据。
  • 可靠传输以 target_id + connection_id + session_epoch 隔离 peer state。
  • 生产配置要求认证 provider;zero-copy 路径遵守认证要求。
  • xgl_next_deadline_ms() 支持 bare-metal/RTOS 低功耗调度。

能力边界

  • 单帧 payload 长度仍由 uint16_t payload_len 限制。
  • 大消息通过 FRAGMENT_EXT 分片重组。
  • 压缩和加密是 reserved codec capability,当前生产路径拒绝直接启用。
  • broadcast/multicast 地址段保留,当前可靠路径以单播为主。

推荐阅读路径

SDK 使用者

  1. 快速开始
  2. 配置
  3. Send API
  4. Zero-Copy
  5. 低功耗运行时

协议维护者

  1. 架构设计
  2. 实现映射
  3. 状态机
  4. Wire Format
  5. TLV 扩展
  6. 可靠传输
  7. 安全模型
  8. 验证矩阵

MCU 交付负责人

  1. 移植
  2. 资源模型
  3. 生产检查表
  4. 发布验证
  5. 静态分析