设备接入与点位表

三级建模：通道（连接）→ 产品（物模型）→ 设备（实例）。点位是产品的属性定义，也是采集与下行控制的单元。

通道

一条到设备的物理或逻辑连接。通道只管连通性：协议、端点地址、超时、采集周期默认值。

协议	端点示例	说明
Modbus TCP	192.168.1.10:502	电表、PLC、开关量模块
Modbus RTU	rtu:///dev/ttyUSB0	RS485 总线，配置波特率/校验位
OPC UA	opc.tcp://127.0.0.1:4840	PLC、数控设备
MQTT	tcp://broker:1883	IoT 设备接入
自定义 HTTP	服务地址	私有 HTTP/JSON 协议（可配解析函数）

S7、EtherNet/IP、SNMP、DL/T645、IEC 104、BACnet 等工业协议族按发行档位编入；私有协议除自定义通道外，也可经规则链的脚本节点做解析适配。

产品与点位

产品定义一类设备的物模型。每个属性点位包含：

• 地址：协议相关（Modbus 用 Modicon 编号 40001+ / 30001+ / 10001+ / 1+；OPC UA 用节点 ID）
• 类型：FLOAT32 / INT16 / BOOL 等（FLOAT32 占 2 个寄存器，下一点位从 40003 起）
• 缩放系数：scale 与 offset，原始值 × scale + offset 得到工程量（驱动在组装数据时应用，walk 型多值按点位配置应用于全部返回值）
• 读写：r 只读 / rw 可读写（可写点位支持界面下发与规则链控制）
• 数据规格：单位、量程（用于界面展示与校验）

同一产品下可按属性分组配不同采集周期：温度 1s、电量 60s、铭牌 1h。

点位表：从图纸 Excel 直接到配置

设备点表通常已经在图纸或台账 Excel 里，不必逐条手敲：

• Excel 导入：按「地址 + 名称」列识别点位表，类型 / 缩放列自动带入
• 批量生成：连续地址区间一次生成（如 40001~40040 每 2 格一个 FLOAT32）
• 导出：当前点位表导出为 Excel，交回设计院或用于下一台设备
• 模板：常用点型存模板，新产品从模板起步

支持点位表的协议：modbus、s7、opcua、eip、mc、fins、dlt645、bacnet、snmp、iec104 等；部分协议（如 snmp / iec104 读点位）类型由响应自带，无需填类型列。

设备

产品在通道上的实例：从站号（Modbus）、设备名、启用开关。设备级可覆盖产品的属性绑定（propertyBindings），同一产品接不同接线方式的设备时不必复制产品。

发现与探测

• SNMP：支持网段发现，发现的设备一键建通道开始采集
• Modbus 探测：对已知地址探测从站与寄存器布局，辅助建点表

数据质量

每个点位每次采集带质量标记：

标记	含义
good	本轮采集成功
bad	采集失败（离线 / 异常）
stale	保留的最后一次已知值（已过期）
timeout	采集超时

界面、大屏、规则链、北向上报看到的是同一份带质量标记的数据——不会把断线后陈旧值当新鲜值用。