BACnet 字符串首字节不是正文：怎样核对字符集与字节长度

BACnet CharacterString 内容的第一字节是字符集编号，不是正文。先取编号再选择解码器；本题只支持编号0的UTF-8，其他编号保留原字节并标未支持，不能无条件用UTF-8替换乱码后继续显示。

适用版本与输入范围

依据维护者 bacnet-stack 固定标签 bacnet-stack-1.4.0 的下列源码解释公开实现子集。该参考不是 ASHRAE 标准全文；涉及具体楼控设备时仍需记录型号、固件和对象支持范围。 本文所有输入均为原创合成数据，未接真实设备。

让标签长度与文本长度各自有定义

本附件输入已经剥离应用标签和长度，只保留字符集字节加文本内容。00 E5 89 8D E5 8E 85表示编号0和“前厅”，文本占六字节，整段内容占七字节；中文字符数量二不能代替协议里的字节长度。若从完整报文提取，应先按应用标签的长度边界截取，再进入本程序，不能以字符串终止符或第一个零来决定截断位置，因为最前面的00恰好就是合法字符集编号。

按明确支持范围处理编号

维护者实现区分多种字符编码，本题只承诺UTF-8子集。对编号5的输入，程序输出supported=false、encoding=5和raw_hex，不根据正文是否“看着像中文”猜编码，也不声称其他编号不存在。工程中若要支持更多字符集，必须单独核对编号、端序、变换规则和测试输入，不能简单把所有未知编号转交系统默认编码。保留原字节有助于后续添加正确转换而不丢证据。

非法字节序列作为数据负例

JSON文件本身是有效UTF-8，负例通过payload_hex字段存放C3 28这组不能严格解为UTF-8的内容字节。程序必须报告UTF8内容非法，而不是errors=replace生成带问号的名称。替换字符看似能让界面继续运行，却可能使两个不同设备名碰撞，或让点位匹配指向错误对象。合法ASCII正例也通过UTF-8路径，证明不需要另猜“纯英文编码”才能读取AHU-1。

名字可读不代表标识可替代

ObjectName或Description通常用于人读，不能代替对象类型、实例号及设备上下文。字符解码成功只保证字符串在指定编码下有效，不证明中文名称对应现场设备，也不保证厂商一定采用本题子集。报告同时给编码号和正文实际字节数，便于与上层长度记录核对。此次没有读取楼控网络，未评估特定厂商控制器对字符集的支持；如果项目要求统一中文命名，应将原始编码和目标规范一起纳入交接。

下载与复跑

将输入 fixture.json与独立程序 verify.py放在同一目录，用 Python 3.12 执行 python verify.py，无需安装第三方包。程序从自身目录读取输入并写入 report.json，不要求当前终端恰好位于下载目录。也可查看本次实跑报告和复跑说明。

本次实际运行通过 4 条输入断言，包括标有“显式负例”的记录；负例以JSON字段承载，不会把下载文件本身做成损坏编码。supported=false时只保留raw_hex，不产生猜测文本；text_bytes不包含字符集编号字节。 修改输入后应同时审查期望结果，不能只改断言数字让测试变绿。

对象或字段的基础关系可回到BACnet 对象与服务入门核对，更多接口入口在设备协议库。若需要把已确认的数据点接入展项编排，可了解SoftControl 展厅中控；具体接入能力以项目确认和实际测试为准。

一级依据

• characterstring_init / characterstring_encoding

来源核对日期：2026-10-24。离线结果只证明给定输入的解析或计算行为；现场兼容性、响应时间、硬件准确度和具体产品支持均未测量。