IoT DC3 概念解读：位号——工业数据的最小语义单元

一台电机接入平台之后被订阅、被计算、被存储的并不是这台电机本身而是它的转速、电压、电流、温度、振动这一组量。平台要管理这些量需要一个最小单元既标识这是哪类设备的哪个量又携带这个量怎么读、怎么算、怎么存的全部约定。在 IoT DC3 中这个单元叫位号Point表dc3_point中的一行记录就是一个位号。位号的定义与别称位号是一类设备身上要采集或写入的一个具体的量是平台中数据的最小语义单元。一个位号对应设备的一个可读或可写的参数携带名称、编码、数据类型、读写标志、单位与换算、采集配置定义归属于某个模板与租户。这个概念在不同系统里各有名字SCADA 与 DCS 称 Tag标签PLC 编程语境称 Variable变量OPC UA 称 Node节点信号处理语境称 Signal信号中文资料里常见数据点、测点、点位。名称不同所指一致设备数据世界里不能再细分的那一格。DC3 统一用 Point。两个边界需要先划清。其一位号不等于位号值PointValue。位号是定义回答叫什么、什么类型、能不能写、单位是什么稳定不变位号值是某台设备某时刻的瞬时取值随采集不断变化。借用官方文档的类比模板是一张表格的表头位号是其中一列位号值是某台设备填进这一列的单元格。其二位号不等于命令Command。位号是量命令是动作重启、校准、切换模式属于命令一个位号能不能写唯一取决于它自身的读写标志与命令表无关。位号的四要素一个位号的语义由四组字段决定均取自dc3_point的实际结构。数据类型pointTypeFlag。八种string、byte、short、int、long、float、double、boolean不显式配置时默认 string。类型不是展示格式而是读取管线的转换契约驱动读到原始字节或字符串后按声明类型换算与校验类型不匹配在读取阶段报错不会把脏值送进存储。读写标志rwFlag。三档r 只读默认、w 只写、rw 读写。转速反馈是 r目标转速给定是 w既可读回又可下发的量是 rw。这一标志是写路径的闸门写命令下发前要经过读写标志校验只读位号收到的写请求会被直接拒绝。单位、精度与换算unit、valueDecimal、baseValue、multiple。unit 是工程单位的自由文本valueDecimal 声明小数位数浮点值按此保留默认 6 位baseValue基值默认 0与 multiple倍率默认 1构成线性换算工程值 原始值 × multiple baseValue。现场仪表上报的常是裸值温度变送器寄存器读数 2531配 multiple 0.01、valueDecimal 2存入的就是 25.31 ℃。换算配置在位号上调整量程不必改任何驱动代码。采集配置。位号本体回答是什么怎么读由驱动的位号级属性与配置值共同决定驱动在dc3_point_attribute表声明需要哪些位号级属性编码、类型、默认值具体值存在dc3_point_attribute_config表粒度为租户 设备 位号 属性。以 Modbus TCP 驱动为例每个位号需配 slaveId从站号、functionCode功能码、offset偏移量功能码 1–4 分别读取线圈、离散输入、保持寄存器、输入寄存器写入走功能码 1 与 3。另有 pointExt 扩展字段承载协议映射、约束、采集策略等附加配置。四要素凑齐一个位号才真正可用类型与换算让它成为数读写标志决定方向采集配置告诉驱动去设备上的哪里取。数据流向从设备读取到应用消费一个位号值的旅程是一条单向链路各段职责分明。驱动按调度读取。驱动服务内的定时任务周期扫描设备设备内逐位号串行、设备之间并行一台设备可读的条件是已启用、已绑定模板、位号集合非空、驱动级与位号级配置齐全。Virtual 仿真驱动是这条链路的最小演示字符串位号产生随机串布尔位号产生随机真假值数值位号在 0 到 100 之间取随机数。类型决定值的形态其余链路完全一致。读取结果经换算后进入消息总线。位号值以统一语义发布到消息主题由驱动发往数据中心消息中间件本身可插拔六种适配器支撑同一套消息语义更换 broker 不改业务代码。数据中心批量消费。数据中心按吞吐导向的批量模式消费位号值完成校验处理后保存消费受阻时按缓冲与背压机制处理不无限堆积。时序存储。位号值最终写入时序数据库四款适配器可插拔手记系列第 05 篇。历史表dc3_point_value同时保留 raw_value原始值与 cal_value换算后的工程值以设备 位号 时间组织历史查询按位号检索。应用消费。监控看板按位号实时展示告警规则挂在位号上趋势分析与 AI 赋能的分析工具同样以位号为句柄访问数据。写路径与读路径对称应用的写命令经数据中心校验读写标志后下发到驱动驱动按采集配置写入设备。位号定义本身变更时元数据变更事件经消息总线广播到各驱动实例驱动刷新本地缓存采集端与应用端始终面对同一个定义。四个应用场景实时监控。电机的转速与电流持续刷新到看板操作人员看到的是有名称、有单位、有精度的物理量而非一串寄存器地址。类型与换算配置保证了上屏的数可以直接读。报警管理。温度位号挂上阈值规则超过 100 ℃ 触发高温报警。规则只需声明哪个位号、什么条件不必关心这个位号来自 Modbus 还是 OPC UA。报警语义建立在位号层与协议解耦。趋势分析。转速位号的历史曲线用于分析工况与优化控制升速阶段的爬坡形态、稳态时的波动幅度都来自同一位号的时序数据。分析结论落到控制上目标转速位号的写值就是执行通道。预测维护。振动位号的采样数据用于检测轴承磨损磨损加剧时振动幅值的变化先于停机故障出现。预测模型的输入是位号历史序列输出是维护建议。AI 辅助分析处置仍需人工确认。四个场景分别对应展示、告警、分析与预测四类消费方式共同点是只面对位号不面对设备与协议细节。一台电机的位号表以编号 MOTOR_001 的电驱动机为例一组典型位号定义如下位号编码名称类型读写单位用途MOTOR_001_SPEED转速floatrRPM运行转速反馈MOTOR_001_TARGET_SPEED目标转速floatwRPM控制给定值MOTOR_001_VOLTAGE电压floatrV端电压MOTOR_001_CURRENT电流floatrA定子电流MOTOR_001_TEMPERATURE温度floatr℃绕组温度MOTOR_001_VIBRATION振动floatrmm/s轴承振动速度MOTOR_001_FAULT_CODE故障代码stringr—变频器故障码七个位号构成这台电机的完整数据面监控看板订阅前六个报警规则挂在温度与振动上趋势分析消费转速历史预测维护聚焦振动故障代码支撑停机归因。若设备经 Modbus TCP 接入每个位号再各自配上从站号、功能码、偏移量。语义与连接至此分离换成另一种协议的同型电机位号表原样保留只有采集配置换一套。这正是手记系列第 02 篇协议可以碎接入模型不能碎落到单个位号上的形态。适用范围与限制位号必须归属于模板。dc3_point的 profileId 为必填不存在脱离模板的位号位号编码在租户与模板内唯一跨模板可重名模板机制见本系列下一篇换算只覆盖线性关系。基值与倍率仅做线性映射查表、分段、曲线标定类的量需在设备侧或自定义驱动内完成字符串位号不参与数值换算。精度与换算仅作用于数值与布尔类型字符串位号原样透传不适用于趋势图等数值消费场景默认类型是字符串。新建位号不配置时按 string、只读、无换算处理采集数值量需显式改为对应类型并配置换算否则按字符串原样存储。结语工业数据的价值不在数量而在每个数都有确切的语义。位号把是什么、什么类型、什么方向、什么单位、去哪里读压缩进一个可管理的单元让监控、报警、分析与预测维护建立在同一个句柄之上。理解位号就理解了 DC3 数据链路的起点位号如何被批量定义、一次变更全局生效答案在模板——本系列下一篇的主题。IoT DC3· GitHub | Gitee | 文档 docs.dc3.site | 在线书 book.dc3.site | 演示 demo.dc3.site | 官网 dc3.site