BACnetCodec4cj APDU/PDU结构剖析:8种PDU数据单元编解码完全指南
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 类型选择),并提供三种构造方式:
- 默认构造:
pdu_Type默认为 0(Confirmed Request PDU) - 枚举构造:直接传入
BACnet_PDU_Type_Choice成员 - 整型构造:传入 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 编解码
- 认编号:看到 APDU 首字节标签 0~7,查
BACnet_PDU_Type_Choice确定 PDU 类型 - 看骨架:8 种 PDU 都是"类型标签 + 控制字段 + 服务/错误载荷"三段式结构,请求看
invoke_id,异常看original_invoke_id - 对源码:每个 PDU 一个文件、附协议原文注释,对照 ISO 16484-5:2022 第 21 章即可逐字段核对
掌握这 8 种 PDU 数据单元,就掌握了 BACnet 应用层报文的"骨架"。后续项目将持续完善各 SEQUENCE 的编解码实现,欢迎持续关注 🚀