BACnetCodec4cj APDU/PDU结构剖析:8种PDU数据单元编解码完全指南

原创2026-09-23 13:51:291,996 阅读
文章标签:通信物联网

BACnetCodec4cj APDU/PDU结构剖析:8种PDU数据单元编解码完全指南

BACnetCodec4cj 是一个使用仓颉(Cangjie)语言编写的 BACnet 通讯协议编解码库,参照 ISO 16484-5:2022 标准实现。本指南带你快速看懂 BACnet 协议中的 APDU/PDU 结构,掌握 8 种 PDU 数据单元的定义、字段含义与源码位置,帮助你在楼宇自控与 HVAC 设备开发中少走弯路 🎯

一、什么是 APDU?APDU 与 PDU 是什么关系?

在 BACnet 协议中,两个概念经常被混淆,先理清它们:

概念 全称 角色 通俗理解
APDU Application Protocol Data Unit(应用协议数据单元) 外层框架 信封:含 PDU 类型、分段信息、APDU 长度等头部信息
PDU Protocol Data Unit(协议数据单元) 实际载荷 信纸:真正要传递的服务请求或响应内容

BACnet 规定 APDU 只能承载 8 种 PDU 之一,它们通过一个 ASN.1 CHOICE 结构 BACnetPDU 来区分,编号 0~7。理解这 8 个编号,是看懂 BACnet 报文的钥匙 🔑

二、8 种 PDU 类型速查表:一张表看懂全部数据单元

BACnet 的 8 种 PDU 按功能可分为四类:

编号 PDU 类型 功能分类 一句话说明 源码文件
0 Confirmed Request PDU 请求 确认服务请求,带分段与窗口参数 Confirmed_Request_Pdu.cj
1 Unconfirmed Request PDU 请求 非确认服务请求,结构简单 Unconfirmed_Request_Pdu.cj
2 Simple ACK PDU 响应 简单确认应答,不含服务数据 SimpleACK_Pdu.cj
3 Complex ACK PDU 响应 复杂确认应答,携带完整服务数据 ComplexACK_Pdu.cj
4 Segment ACK PDU 分段 分段消息的窗口确认 SegmentACK_Pdu.cj
5 Error PDU 异常 服务执行出错,携带错误原因 Error_Pdu.cj
6 Reject PDU 异常 拒绝请求,携带拒绝原因 Reject_Pdu.cj
7 Abort PDU 异常 中止当前会话/事务 Abort_Pdu.cj

如何快速记忆 8 种 PDU?

  • 请求类(0/1):Confirmed 要应答、Unconfirmed 不用应答,二者字段差异很大
  • 响应类(2/3):Simple 只回一个"收到",Complex 回完整数据
  • 分段类(4):大消息拆分成多个 segment 传输时用来做窗口确认
  • 异常类(5/6/7):Error 是"业务出错",Reject 是"请求被拒",Abort 是"直接中止"

三、PDU 类型编号如何映射?看 BACnet_PDU_Type_Choice 枚举

8 种 PDU 的编号与类型映射,由枚举 BACnet_PDU_Type_Choice 统一维护:

  • 编号 0~7 与 confirmed_request_pdu、unconfirmed_request_pdu、simple_ack_pdu、complex_ack_pdu、segment_ack_pdu、error_pdu、reject_pdu、abort_pdu 一一对应
  • 提供 fromUInt8 与 toUInt8 双向转换,编解码时根据首字节标签就能识别 PDU 类型
  • 遇到 0~7 之外的标签值会抛出 DecodeException,见 BACnet_PDU_Type_Choice.cj

四、父类 BACnet_APDU:所有 PDU 的共同骨架

所有 8 种 PDU 都继承自公共父类 BACnet_APDU,它只持有核心成员 pdu_Type(BACnet PDU 类型选择),并提供三种构造方式:

  1. 默认构造:pdu_Type 默认为 0(Confirmed Request PDU)
  2. 枚举构造:直接传入 BACnet_PDU_Type_Choice 成员
  3. 整型构造:传入 UInt8 标签值自动转换

这种"一个父类 + 8 个子类"的面向对象设计,让解码器可以统一按父类处理报文,再按类型分发到具体子类,逻辑清晰、易于扩展 ✨

五、逐类精讲:每种 PDU 的字段要点

1. Confirmed Request PDU(编号 0)——功能最丰富的请求

字段最多,核心成员包括(见 Confirmed_Request_Pdu.cj):

  • 分段三兄弟:segmented_message、more_follows、segmented_response_accepted,控制是否分段传输
  • 窗口参数:max_segments_accepted(0..7)、max_apdu_length_accepted(0..15)
  • 会话标识:invoke_id(0..255),用于请求-响应对应
  • 服务选择:service_choice 使用 ConfirmedService_Enum 指定要调用哪个确认服务
  • 服务载荷:service_request 为可选的 Confirmed_Service_Request_Choice,承载真正的服务参数

2. Unconfirmed Request PDU(编号 1)——最轻量的请求

只有 4 个字段(见 Unconfirmed_Request_Pdu.cj):PDU 类型、保留位、service_choice(UnconfirmedService_Enum)与 service_request(Unconfirmed_Service_Request_Choice)。无需应答,常用于 I-Am、Who-Is、COV 通知等"广播式"场景 📡

3. Simple ACK PDU(编号 2)——最精简的应答

仅 4 个字段:PDU 类型、保留位、invoke_id、service_ack_choice(见 SimpleACK_Pdu.cj)。它告诉请求方"你的服务已被处理,且没有返回数据",例如 Read-Property 读取成功但无值可返回时。

4. Complex ACK PDU(编号 3)——携带完整数据的应答

与 Simple ACK 的区别在于多了 segmented_message、sequence_number、proposed_window_size 等分段字段,以及 service_ack 载荷字段(见 ComplexACK_Pdu.cj)。当服务返回数据(如 Read-Property 的返回值)时使用。

5. Segment ACK PDU(编号 4)——分段传输的"窗口管理器"

字段包括 negative_ack(负确认)、server(方向标识)、original_invoke_id、sequence_number 与 actual_window_size(1..127,见 SegmentACK_Pdu.cj)。它管理大报文分段传输时的滑动窗口,类似 TCP 的确认机制 🔄

6. Error PDU(编号 5)——业务层出错

携带 original_invoke_id(对应哪个请求出错)、error_choice(哪个服务出错)与 error(错误详情,见 Error_Choice)。注意 Error 表示"服务被处理了,但业务结果失败",与 Reject 有本质区别。

7. Reject PDU(编号 6)——请求被直接拒绝

携带 original_invoke_id 与 reject_reason(见 RejectReason_Enum)。常见于"设备忙、APDU 超长、不支持分段"等协议层问题,请求根本没进入业务处理。

8. Abort PDU(编号 7)——彻底中止会话

比 Reject 更"重",多了一个 server 布尔位标识中止方向,abort_reason 见 AbortReason_Enum。当分段传输失败、窗口协商破裂等场景时,直接放弃整次事务 🛑

六、项目源码组织:APDU 相关文件在哪里?

BACnetCodec4cj 的 APDU/PDU 源码集中在 src/BACnet/Types/APDU_Definitions/ 目录,配合两个支撑目录:

  • PDU 定义:APDU_Definitions/ 下 8 个 PDU 类 + 父类 BACnet_APDU,每个文件头部保留了 ISO 16484-5:2022 第 21 章(Page 866~868)的 ASN.1 原文注释,方便对照标准核对
  • 类型选择:src/BACnet/Choice/ 存放 31 个 ASN.1 CHOICE(如服务请求选择、错误选择)
  • 服务枚举:src/BACnet/Enum/ 存放 73 个 ASN.1 ENUMERATED(如确认服务、拒绝原因、中止原因)
  • 字节缓冲:ByteBuf 是编解码操作的底层支撑
  • 异常分层:BACnetCodecException 提供 DecodeException、EncodeException 等分类异常

更多项目进展与结构说明,可查阅 README.md 与 CHANGELOG.md。

七、小结:3 步上手 BACnet APDU 编解码

  1. 认编号:看到 APDU 首字节标签 0~7,查 BACnet_PDU_Type_Choice 确定 PDU 类型
  2. 看骨架:8 种 PDU 都是"类型标签 + 控制字段 + 服务/错误载荷"三段式结构,请求看 invoke_id,异常看 original_invoke_id
  3. 对源码:每个 PDU 一个文件、附协议原文注释,对照 ISO 16484-5:2022 第 21 章即可逐字段核对

掌握这 8 种 PDU 数据单元,就掌握了 BACnet 应用层报文的"骨架"。后续项目将持续完善各 SEQUENCE 的编解码实现,欢迎持续关注 🚀

登录后查看全文
BACnetCodec4cj