03-读懂一张厂商点表
2.3 读懂一张厂商点表
本节摘要：点表是设备与主站之间的"合同"。本节给出一张仿真的变频器点表，带着小周从头到尾读一遍：哪些列必须看、哪些坑藏在注释里、如何用调试器验证一两个点。位置：2.1、2.2 建立了数据模型与地址换算，本节把它们用在一张真实点表上。（本节点表为教学样例，不代表任何真实产品。）
一张变频器点表（节选）
| PLC 地址 | 偏移 | 名称 | 类型 | 读/写 | 说明 |
|---|---|---|---|---|---|
| 40001 | 0 | 运行状态字 | uint16 | R | 位0=运行中，位1=故障，位2=正转 |
| 40002 | 1 | 设定频率 | float32(0.01Hz) | R/W | 40002 高字+40003 低字 |
| 40003 | 2 | （频率低字） | — | — | 与 40002 组成 32 位 |
| 40004 | 3 | 输出频率 | float32 | R | 高字 40004 + 低字 40005 |
| 40006 | 5 | 输出电流 | uint16×0.1A | R | 如 325 = 32.5A |
| 41001 | 1000 | 控制命令字 | uint16 | W | 1=启动 2=停止 3=急停 |
| 41002 | 1001 | 运行方向 | uint16 | R/W | 0=正转 1=反转 |
三处要读出"言外之意"：第一，40002 是 float32 且高字在前——写设定频率必须一次写两个寄存器（功能码 16 写 4 字节），并注意字序；第二，40001 是状态字不是数值——它由位组成，读回来要按位拆；第三，41001 的"控制命令字"与 40002"设定频率"是可写的，其余只读——任何写只读寄存器的尝试都会得到异常应答。
读点表的三步验证法
拿到一张新点表，别急着写整段代码，先做三步验证：
第一步：选两个已知值验证 读 40006（输出电流），设备面板显示 32.5A，报文应回 325（0x0145） 若回 0x4501 → 字节序反了；若回 3250 → 缩放率理解错了 第二步：读一个"可写"寄存器验证只读保护 尝试写 40006，应收到异常码 02 或 03，写通则说明点表标注有误 第三步：边界值试探 读地址 0 与地址上限各一次，确认设备对越界地址返回异常而非沉默
三步做完，点表的"读"路径基本可信，再进入批量轮询与业务代码。
点表注释里的高频陷阱
点表里最值得警惕的注释词："缩放"——如 ×0.1A、×0.01Hz，报文原始值与工程值差一个比例，漏乘是数据错一两个数量级的头号原因；"高字/低字"——32 位数据的字序说明，漏看则浮点全乱；"保留"——标保留的地址不要乱写，写错可能触发设备异常行为；"Bit X"——表示该字按位使用，按整数值处理会把多个开关量糊成一个数。
点表之外的第三张表：量程与诊断
完整设备文档通常不止点表一张：量程表告诉每个模拟量的上下限与单位（读回 325 表示 32.5A，量程 0-100A）；诊断表列出只读的状态/故障字，每个 bit 一种故障（过压、过流、过热各占一位）；设置表是可写的参数。三张表配合使用才能写完整套驱动：量程表用于缩放，诊断表用于告警，设置表用于配置。漏了量程表，读数会"看起来对但单位错"。
一张点表的读法七步
拿到陌生设备点表，按七步走完就不会漏：
1. 找"数据格式"说明：字节序、字序、缩放基准 2. 确认四类对象的地址范围与支持的功能码 3. 圈出"业务必须读"的寄存器，标注偏移与长度 4. 圈出"业务必须写"的寄存器，确认读写属性 5. 查每个模拟量的量程与单位，建立缩放表 6. 查状态字/故障字的位定义，建立位解析表 7. 选 2-3 个已知值做验证实验（见前文三步验证法）
七步产出四张表：数据格式、读取清单、缩放表、位解析表——这就是驱动开发的完整输入。
点表版本与固件版本
点表不是一成不变的：厂商固件升级可能移动寄存器地址、改变数据类型、新增功能码。点表版本与固件版本必须配套记录——升级设备固件前先核对点表是否变化，变了要同步更新驱动与缩放表。生产环境"升级固件后数据全乱"的事故，多半就是点表变了而驱动没跟上。
易错点补充
- 点表 PDF 与固件实际不符：老设备被厂家悄悄升级过固件，点表是旧版，用调试器读几个关键地址实测核对；
- 缩放率只在"说明"列里：缩放藏在备注里最容易漏，把缩放率单独建列，别依赖肉眼；
- 新文档设备按旧逻辑写：不同厂商对"状态字"的定义习惯不同，别拿 A 厂商的位定义套 B 厂商的设备。
易错点清单
- 只抄 PLC 地址不记偏移：写驱动用偏移，抄错一位就错读整片；
- 忽略缩放率：把 325 直接当 325A 写进报表，比真实值大 10 倍；
- 不验证就批量开发：点表是厂商写的，也会写错；先验证两三个点再铺开，是省一周调试的唯一办法。
要点回顾：点表三读——读出言外之意（字序、位含义、读写属性）、三步验证（已知值、只读保护、边界）、警惕注释陷阱（缩放、高/低字、保留）。点表读懂了，下一章看真正干活的报文——功能码。
实战复盘：点表版本号救了整个调试组
某项目调试变频器时，速度设定"怎么写都不生效"。调试组排查两天无果，最后是老师傅看了一眼设备固件版本，又翻了翻厂商官网——该固件版本把"速度设定"从偏移 1 挪到了偏移 3，而项目用的点表是旧版。更新点表后一次写入成功。复盘教训：调试前第一件事不是看代码，是核对设备固件版本与点表版本。厂商官网的"固件发布说明"通常会列出点表变更，把"点表版本 + 固件版本 + 驱动版本"三个版本号记在同一张表里，是工业调试的基本台账。
从点表到自测用例
专业团队会把点表转成自动化的自测用例：对每个关键寄存器定义"读回值应在合理范围"、"写保护寄存器应拒绝写入"、"越界地址应返回异常码 02"三类断言，接入产线测试或 CI。这样设备换固件、换批次时，跑一遍用例就能发现点表变化，而不是等现场出事故。自测用例的投资回报率极高——一次设备批量更换导致的点表漂移事故，成本远超写用例的那几天时间。
小结：点表是设备与主站的合同；读表七步、验证三步、版本台账三件事缺一不可；调试前先核对固件与点表版本。