插件属性详表
本页用于现场核对“页面上每一个插件属性到底该填什么”。配置时不要从头顺读,先确定采集协议或转发目标类型,再看对应插件小节。地址格式、变量地址写法仍以 插件参考 为准。
已按当前版本页面可配置字段核对:采集插件 30 个,数据转发目标插件 15 个。公共属性只解释一次,各插件小节会说明会显示哪些公共配置,以及额外提供哪些专属配置。
先分清三类属性
| 属性位置 | 现场含义 | 典型排查点 |
|---|---|---|
| 采集插件属性 | 一个采集设备使用该协议时的通讯和协议参数。 | 设备读不到、数值不对、写入慢,优先查这里。 |
| 数据转发组属性 | 决定哪些变量进入转发链路,以及按变化还是按周期触发。 | 变量有值但不转发,先查组范围和触发条件。 |
| 数据转发目标插件属性 | 某个外部系统的连接、上传格式、缓存和变量映射。 | 目标连不上、外部系统收不到、反写不生效,查这里。 |
数据转发组属性
数据转发组不是插件,但它决定变量是否有资格进入任何转发目标。现场判断“为什么没数据发出”时,先按下面顺序确认:变量属于本组、组启用、触发条件满足、目标启用、目标连接成功。
| 配置项 | 现场说明 |
|---|---|
| 名称 | 转发组名称,同一系统内应唯一。建议体现外部系统和范围,例如 MES_关键点位。 |
| 描述 | 写清本组用途、外部系统、验收人或维护边界,便于交接。 |
| 启用 | 关闭后本组下所有目标都不会启动,也不会产生转发数据。 |
| 日志级别 | 控制本组运行日志详细程度。联调可临时用 Debug,稳定后改回 Info。 |
| 排序 | 只影响页面显示顺序,数值越小越靠前。 |
| 变量范围模式 | Manual 手工选择变量;All 全部启用变量;CollectDevice 按采集设备名筛选;CollectGroup 按采集组筛选。 |
| 范围配置 | 选择 CollectDevice 时填设备名,选择 CollectGroup 时填采集组名,多个值用英文逗号分隔。Manual 和 All 通常留空。 |
| 触发模式 | Change 按变量变化触发;Interval 只按周期触发;IntervalOrChange 变化和周期都触发。 |
| 定时转发间隔 | 周期触发时使用。普通周期填毫秒数,例如 1000;固定时刻任务才使用 Cron 表达式。 |
| 仅在线变量 | 开启后离线变量不会进入转发。需要外部系统看到离线前最后值时不要开启。 |
| 批处理模式 | 决定一次触发后如何拆分变量批次,例如不拆分或按数据组拆分。 |
| 最大批量 | 单次批处理最多变量数。外部接口超时、消息体过大或数据库压力大时调小。 |
组内变量属性
这些字段只说明“变量在本组内如何参与转发”,不能替代目标变量属性。
| 配置项 | 现场说明 |
|---|---|
| 变量 | 当前转发组包含的采集变量。Manual 模式下必须先把变量加入本组。 |
| 启用 | 关闭后该变量不参与本组转发。 |
| 数据组 | 用于批处理分组,例如产线、区域、设备组。批处理模式按数据组拆分时会使用。 |
| 更新模式 | 单变量触发方式,可细化组级触发模式。 |
| 参与组触发 | 关闭后该变量仍可随批次上传,但它自己的变化不会唤醒整个组。 |
| 别名 | 上传时使用的外部变量名。为空时通常使用原变量名。 |
| 排序 | 本组内变量输出顺序。 |
采集公共属性
采集重试属性
| 配置项 | 现场说明 |
|---|---|
| 失败重试次数 | 单次读写失败后的重试次数。网络或串口偶发抖动可适当增加;长期故障时过大会拖慢故障反馈。 |
| 读写占空比 | 写入请求较多时,执行若干次写入后穿插一次读取,避免只写不读。 |
| 写优先 | 有写入任务时优先处理写入。适合控制指令需要尽快下发的场景,普通采集保持关闭即可。 |
Foundation 通用读写属性
| 配置项 | 现场说明 |
|---|---|
| 读写超时时间 | 单次读写等待时间,单位毫秒。设备响应慢、链路延迟高时可适当加大。 |
| 帧前时间 | 发送报文前等待时间,单位毫秒。老设备或串口总线需要帧间隔时设置。 |
| 字符串反转字节 | 字符串按字节/字反转解析。字符串顺序不对时再调整。 |
| 数据解析顺序 | 多字节数值的字节序/字序。数值明显偏大、偏小或符号不对时重点核对。 |
打包和 DTU 属性
| 配置项 | 现场说明 |
|---|---|
| 最大打包长度 | 一次合并读取的最大地址长度。点位多时可提高效率;设备不支持大包或经常超时时调小。 |
| DTU ID | DTU 或透传终端编号。直连设备通常留空,通过 DTU 接入时必须和现场终端编号一致。 |
数据转发目标公共属性
目标基础属性
| 配置项 | 现场说明 |
|---|---|
| 名称 | 同一转发组内唯一,用于页面显示、日志和查询目标路径。 |
| 描述 | 记录外部系统、接口负责人、用途或验收说明。 |
| 启用 | 关闭后该目标插件不启动。变量有值但外部系统收不到时必须先确认它已启用。 |
| 插件名称 | 选择具体转发插件,例如 MQTT、Kafka、Webhook、历史数据目标等。 |
| 日志级别 | 目标运行日志详细程度。接口联调时可临时提高。 |
| 目标属性 | 当前插件的连接、缓存、上传格式等配置,详见各目标插件小节。 |
| 启动超时 | 目标启动等待时间,单位秒。外部系统慢、证书校验慢时可适当增加。 |
| 启用冗余 | 启用主备目标切换。只有明确有备用目标时才开启。 |
| 冗余目标 | 当前目标故障时切换到的备用目标,必须在同一转发组内。 |
| 冗余模式 | 按目标离线状态切换,或按脚本返回结果切换。 |
| 冗余扫描间隔 | 检查是否需要切换的周期,单位毫秒。 |
| 冗余切换判断脚本 | 冗余模式为脚本时使用,脚本返回 true 才切换。 |
通道型目标属性
Modbus 从站、IEC104 从站等目标需要监听或连接 TCP/串口/DTU 通道时,会显示这些字段。
| 配置项 | 现场说明 |
|---|---|
| 通道类型 | 选择 TCP 客户端、TCP 服务端、串口、DTU 等通讯模式。 |
| 远程地址 | 客户端模式下连接的对端地址,例如 192.168.1.10:502。 |
| 本地绑定地址 | 服务端模式下监听地址,例如 0.0.0.0:502。 |
| 启用SSL | TCP 通道是否启用 TLS 加密。普通内网协议一般关闭。 |
| SSL目标主机名 | 客户端校验证书时使用的主机名,应和证书一致。 |
| SSL客户端证书 | 客户端模式需要双向证书认证时选择。 |
| SSL服务端证书 | 服务端模式监听时使用的证书。 |
| SSL CA证书 | 用于校验对端证书链的 CA。 |
| 允许不受信任证书 | 调试可临时开启,生产环境建议关闭。 |
| SSL协议 | 指定 TLS 版本。无特殊要求保持默认。 |
| 检查证书吊销 | 是否检查证书吊销状态。内网无吊销服务时开启可能导致连接慢或失败。 |
| 串口 | 串口号,例如 COM1。 |
| 波特率 | 串口速率,必须和对端一致。 |
| 数据位 | 串口数据位,常见为 8。 |
| 校验位 | 串口校验方式,必须和对端一致。 |
| 停止位 | 串口停止位,必须和对端一致。 |
| DtrEnable | 是否启用 DTR 信号。只有现场设备要求硬件控制线时调整。 |
| RtsEnable | 是否启用 RTS 信号。RS485 转换器或特殊设备可能需要。 |
| 异步流 | 串口异步读写方式。串口稳定时保持默认,遇到阻塞或读取不及时再调整。 |
| 握手方式 | 串口硬件/软件握手方式。大多数工业设备保持默认。 |
| 串口输入缓冲区大小 | 串口接收缓冲区大小。报文长或突发量大时可增大。 |
| 串口输出缓冲区大小 | 串口发送缓冲区大小。 |
| 最大并发数 | 同一通道允许同时处理的请求数。顺序要求严格的协议保持 1。 |
| 组包缓存时间 | 粘包/拆包等待窗口,单位毫秒。报文分片明显时可增大。 |
| 连接超时 | 建立连接等待时间,单位毫秒。 |
| 最大连接数 | 服务端模式允许的最大客户端连接数。 |
| 客户端清理时间 | 服务端清理空闲客户端的周期,单位毫秒。 |
| 心跳内容 | 需要主动发送心跳时填写。 |
| 心跳是否Hex | 心跳内容是否按十六进制字符串解析。 |
| 心跳时间 | 心跳发送周期,单位毫秒。 |
| DtuId | DTU 设备标识。通过 DTU 服务端接入时用于区分终端。 |
| DtuId是否Hex | DTU ID 是否按十六进制字符串解析。 |
| Dtu服务类型 | DTU 注册/心跳识别方式,应和 DTU 设备协议一致。 |
离线缓存属性
| 配置项 | 现场说明 |
|---|---|
| 启用离线缓存 | 发送失败时落盘等待补发。历史数据、报警、关键平台上报建议开启。 |
| 缓存文件最大行数 | 单个缓存文件保留行数上限,超出后会清理旧数据。 |
| 上传分片大小 | 每次上传或补发的最大记录数。接口超时或消息体过大时调小。 |
| 内存队列上限 | 内存中允许积压的数据量。超过后优先落盘,无法落盘时旧数据可能被丢弃。 |
| 过滤离线数据 | 开启后不上传离线变量数据。需要外部系统看到最后值时不要开启。 |
| 并发上传数量 | 同一目标同时上传任务数。顺序要求严格时保持 1。 |
上传模板和脚本属性
| 配置项 | 现场说明 |
|---|---|
| 详细日志 | 输出每次转发的详细内容,适合模板、Topic、脚本联调,长期运行建议关闭。 |
| JSON缩进格式化 | 上传 JSON 是否带缩进。调试易读可开启;追求流量小可关闭。 |
| JSON忽略Null | 上传 JSON 是否省略空字段。对方接口要求固定字段时谨慎开启。 |
| 设备列表上传 | 设备数据是否合并为列表上传;关闭后逐条上传。 |
| 变量列表上传 | 变量数据是否合并为列表上传;关闭后逐条上传。 |
| 变量字典上传 | 将变量组织为设备名、变量名到值的字典结构,适合对方按设备对象接收。 |
| 报警列表上传 | 报警数据是否合并为列表上传;关闭后逐条上传。 |
| 报警字典上传 | 将报警组织为字典结构。 |
| 插件事件列表上传 | 插件连接、断开、错误等事件是否合并上传。 |
| 设备Topic模板 | 设备数据发送位置模板,可用 ${Name} 等实体字段。为空表示不上传该类数据。 |
| 变量Topic模板 | 变量数据发送位置模板,例如 MQTT Topic、Kafka Topic、RabbitMQ Routing Key 或 Webhook URL。 |
| 报警Topic模板 | 报警数据发送位置模板。为空表示不上传报警。 |
| 插件事件Topic模板 | 插件事件发送位置模板。为空表示不上传插件事件。 |
| 设备实体脚本 | 改写设备上传实体的脚本,只在对方字段结构特殊时使用。 |
| 变量实体脚本 | 改写变量上传实体的脚本,可补字段、改字段名或改变结构。 |
| 报警实体脚本 | 改写报警上传实体的脚本。 |
| 插件事件实体脚本 | 改写插件事件上传实体的脚本。 |
| 上传模板配置 | 自定义 Payload 模板。配置后用 ${字段名} 替换;留空使用默认 JSON。 |
通用目标变量字段
| 配置项 | 现场说明 |
|---|---|
| 数据1 | 预留外部字段,可用于 Topic、URL 或 Payload 模板。 |
| 数据2 | 预留外部字段,可填外部点位编号、区域或业务编码。 |
| 数据3 | 预留外部字段。 |
| 数据4 | 预留外部字段。 |
| 数据5 | 预留外部字段。 |
| 数据6 | 预留外部字段。 |
| 数据7 | 预留外部字段。 |
| 数据8 | 预留外部字段。 |
| 数据9 | 预留外部字段。 |
| 数据10 | 预留外部字段。 |
MQTT 生产者公共属性
MQTT 客户端生产者和 MQTT 服务端生产者都包含这些字段。
| 配置项 | 现场说明 |
|---|---|
| 连接类型 | 选择 TCP 或 WebSocket。必须和 Broker 或客户端接入方式一致。 |
| 端口 | MQTT 服务端口,常见 TCP 为 1883,TLS 为 8883。 |
| WebSocket路径 | WebSocket 接入路径,仅 WebSocket 模式有效。 |
| 启用SSL | 是否使用 SSL/TLS。启用后证书、主机名和协议版本要一起核对。 |
| CA名称 | 校验对端证书的 CA 证书名称。 |
| 允许不受信任证书 | 调试可临时开启,生产建议关闭。 |
| SSL协议版本 | TLS 协议版本。无特殊要求保持默认。 |
| 检查证书吊销 | 是否检查证书吊销状态。内网环境若无吊销服务可关闭。 |
| 用户名 | MQTT 认证用户名。 |
| 密码 | MQTT 认证密码。 |
| QoS等级 | 发布质量等级。AtMostOnce 性能高但不保证到达;需要确认到达时按平台要求提高。 |
| 保留消息 | 是否让 Broker 保留最后一条消息。普通实时数据通常关闭。 |
| RPC写入Topic | 外部系统反写点位的请求主题前缀,实际会使用 RpcWrite/+ 和 RpcWrite/+/Response。 |
| 历史查询Topic | 外部系统查询历史记录、数值序列和报警的主题前缀,默认 RpcHistory;请求使用 RpcHistory/<32位十六进制请求号>,响应使用 RpcHistory/<请求号>/Response。 |
| 数据请求Topic | 外部系统请求全量数据的主题。收到任意消息后会推送变量、设备、报警等数据。 |
| RPC脚本 | 处理 MQTT RPC 写入请求的脚本,仅在对方请求格式不是默认格式时使用。 |
采集插件逐项核对
Memory
无页面插件属性。该插件用于内存变量,不建立外部通讯链路;仍需维护变量名称、数据类型和计算/写入逻辑。
Modbus 主站
包含采集重试、Foundation 通用读写、Modbus 专用打包规则和 DTU 属性。旧“最大打包长度”不再用于 Modbus 主站。
| 配置项 | 现场说明 |
|---|---|
| Modbus类型 | 选择 Modbus TCP、RTU 等协议形态,必须和通道及设备一致。 |
| 默认站号 | 默认从站地址。变量地址里单独写站号时,以变量地址为准。 |
| FC1 最大读取线圈位数量 | 默认 1600,范围 1~2000。设备不支持较大连续线圈读取时调低。 |
| FC2 最大读取离散输入位数量 | 默认 1600,范围 1~2000。设备不支持较大连续离散量读取时调低。 |
| FC3 最大读取保持寄存器数量 | 默认 100,范围 1~125。按设备每帧保持寄存器能力设置。 |
| FC4 最大读取输入寄存器数量 | 默认 100,范围 1~125。按设备每帧输入寄存器能力设置。 |
| FC15 最大批量写入线圈位数量 | 默认 1968,范围 1~1968。超出时在构造报文前校验失败。 |
| FC16 最大批量写入寄存器数量 | 默认 123,范围 1~123。超出时在构造报文前校验失败。 |
升级后应逐个打开 Modbus 主站设备核对六项规则。旧 MaxPack 不会作为当前配置继续生效,也不应假设旧值会自动映射到六个功能码。
Siemens S7
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| PLC类型 | 选择 S7-200、S7-300、S7-400、S7-1200、S7-1500 等 PLC 类型。 |
| Rack | 机架号,按 PLC 硬件或项目通讯参数填写。 |
| Slot | CPU 插槽号,S7-1200/1500 常见为 1,S7-300 常见为 2,仍以现场为准。 |
| LocalTSAP | 本地 TSAP。只有现场明确要求 TSAP 时填写,否则保持默认。 |
DLT645-2007
包含采集重试、Foundation 通用读写和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| 默认地址 | 12 位电表地址。变量地址未指定表地址时使用。 |
| 密码 | 电表写入或特殊读取需要的密码;只读场景通常留空。 |
| 操作员代码 | 电表操作员代码,写表或受控读取时按表计资料填写。 |
| 前导符报文头 | 报文前导字节,默认 FEFEFEFE;只有表计要求不同时调整。 |
OPC UA 客户端
包含采集重试属性。
| 配置项 | 现场说明 |
|---|---|
| 连接Url | OPC UA 服务端地址,例如 opc.tcp://192.168.1.10:49320。 |
| 登录账号 | 服务端要求账号认证时填写。 |
| 登录密码 | 与登录账号配套填写。 |
| 数据变化触发条件 | 订阅模式下哪些变化触发上报,通常保持默认。 |
| 安全策略 | 是否启用安全策略。启用后必须配置证书并确认服务端信任。 |
| 名称标识 | OPC UA 客户端应用名称,用于服务端识别和证书匹配。 |
| 证书 | 客户端证书名称,从证书管理中选择。 |
| 是否使用SourceTime | 使用服务端源时间作为采集时间;需要按网关接收时间记录时关闭。 |
| 加载服务端数据类型 | 启动时读取服务端数据类型,便于类型匹配;服务端慢时可能增加启动时间。 |
| 激活订阅 | 开启后使用订阅接收变化;关闭后按轮询读取。 |
| 更新频率 | 订阅更新周期,单位毫秒。 |
| 死区 | 数值变化超过死区才触发,适合减少模拟量抖动上报。 |
| 最大组大小 | 单个订阅组最大节点数。服务端限制较小时调小。 |
| 心跳频率 | OPC UA 会话心跳周期,单位毫秒。 |
OPC DA 客户端
包含采集重试属性。
| 配置项 | 现场说明 |
|---|---|
| OPC服务器IP | OPC DA 服务器所在主机。远程 DA 还要确认 DCOM 权限。 |
| OPC服务器名称 | OPC DA ProgID,例如 Kepware.KEPServerEX.V6。 |
| 服务端时间 | 使用 OPC 服务器源时间;需要网关接收时间时关闭。 |
| 订阅模式 | 开启后通过 DA 订阅更新;关闭后按周期读取。 |
| CheckRate | 检测重连频率,单位分钟。 |
| 死区 | 数值变化死区,用于过滤小幅抖动。 |
| 最大组大小 | 单个 OPC 组最大点数。服务端压力大或订阅失败时调小。 |
| 订阅更新频率 | OPC DA 订阅更新周期,单位毫秒。 |
MQTT 采集客户端
该插件自己管理 MQTT 连接,不使用采集公共读写属性。
| 配置项 | 现场说明 |
|---|---|
| 连接类型 | 选择 TCP 或 WebSocket,必须和 Broker 一致。 |
| IP地址 | MQTT Broker 地址。 |
| 端口 | MQTT Broker 端口。 |
| WebSocket路径 | WebSocket 连接路径,仅 WebSocket 模式有效。 |
| 启用SSL | 是否使用 SSL/TLS。 |
| SSL目标主机名 | 证书校验使用的主机名。 |
| 客户端证书名称 | 双向证书认证时选择客户端证书。 |
| CA名称 | 校验 Broker 证书的 CA。 |
| 允许不受信任证书 | 调试可临时开启,生产建议关闭。 |
| SSL协议版本 | TLS 协议版本。 |
| 检查证书吊销 | 是否检查证书吊销。 |
| 客户端ID | MQTT ClientId。多客户端不能重复。 |
| 用户名 | MQTT 认证用户名。 |
| 密码 | MQTT 认证密码。 |
| 保活时间 | MQTT KeepAlive,单位秒。 |
| 清除会话 | 断线重连后是否清除会话。需要保留离线订阅时关闭。 |
| MQTT协议版本 | MQTT 版本,需和 Broker 支持情况一致。 |
| QoS等级 | 订阅/收发质量等级。 |
| 详细日志 | 输出详细 MQTT 收发日志,联调用,稳定后关闭。 |
| 连接超时时间 | 建立连接等待时间,单位毫秒。 |
| 检查清除时间 | 清理无效连接或状态的周期,单位毫秒。 |
MQTT 采集服务端
该插件在网关内启动 MQTT 服务端,不使用采集公共读写属性。
| 配置项 | 现场说明 |
|---|---|
| 连接类型 | 选择 TCP 或 WebSocket。 |
| 端口 | 网关监听的 MQTT 端口。 |
| WebSocket路径 | WebSocket 监听路径。 |
| 启用SSL | 是否启用 SSL/TLS 监听。 |
| 服务器证书名称 | 服务端证书名称,启用 SSL 时必须配置。 |
| CA名称 | 校验客户端证书时使用的 CA。 |
| 允许不受信任证书 | 调试可临时开启,生产建议关闭。 |
| SSL协议版本 | TLS 协议版本。 |
| 检查证书吊销 | 是否检查证书吊销。 |
| 允许连接ID前缀 | 只允许指定 ClientId 前缀的客户端接入;为空表示不按前缀限制。 |
| 用户名 | 客户端连接认证用户名。 |
| 密码 | 客户端连接认证密码。 |
| 详细日志 | 输出详细连接和消息日志,联调用。 |
| 检查清除时间 | 清理无效客户端状态的周期,单位毫秒。 |
CAN 主站
包含采集重试和 Foundation 通用读写属性。
| 配置项 | 现场说明 |
|---|---|
| 端点地址 | CAN 适配器和通道地址,例如虚拟通道或 ZLG 设备通道。 |
| 波特率 | 仲裁段波特率,必须和总线一致。 |
| 数据相位波特率 | CAN FD 数据段波特率,仅 CAN FD 模式有效。 |
| 协议模式 | 选择 CAN2.0 或 CAN FD。 |
| 启用BRS | CAN FD 是否启用数据段变速率。普通 CAN2.0 无效。 |
| 内部终端电阻 | 是否启用适配器内部终端电阻,按现场总线接线选择。 |
| 硬件滤波器CANID列表 | 只接收指定 CAN ID;为空表示不过滤。 |
Allen-Bradley ControlLogix
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| Slot | ControlLogix CPU 插槽号。 |
| Backplane | 背板寻址参数,按 PLC 机架通讯路径填写。 |
Allen-Bradley PCCC
包含采集重试、Foundation 通用读写和打包属性;无额外页面插件属性。该插件构造时默认 数据解析顺序 为 DCBA、最大打包长度 为 150,现场重点核对变量地址格式。
DCON 主站
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| Station | DCON 站号,必须和模块地址一致。 |
EDPF_NT
无页面插件属性。该插件不显示采集重试或 Foundation 字段,现场重点核对通道、设备和变量地址配置。
HJ212 主站
包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对 HJ212 地址字段、MN、CN、ST 等变量地址内容和链路参数。
IEC 61850 客户端
包含采集重试属性。
| 配置项 | 现场说明 |
|---|---|
| IED IP地址 | 被采集 IED 的 IP 地址。 |
| IED 端口 | MMS 端口,常见为 102。 |
| ConnectTimeout | 建立连接超时,单位毫秒。 |
| 最大打包数量 | 一次批量读取的最大数量。IED 响应慢或报文过大时调小。 |
| UpdateRate | 轮询或订阅处理周期,单位毫秒。 |
| SCL 配置文件路径 | SCL/ICD/SCD 文件路径,用于导入或生成变量模型。 |
| 启用 RCB 报告订阅 | 使用报告订阅代替轮询。IED 报告配置正确时开启。 |
| RCB 报告 ID | 报告 ID,需和 IED 报告控制块一致。 |
| RCB 引用列表 | 报告控制块引用列表,多个值可用逗号、分号或换行分隔。为空时按常见约定自动推导。 |
| ReportBufTime | 报告缓冲时间,单位毫秒。 |
| ReportIntgPd | 完整性报告周期,单位毫秒。 |
| RCB TrgOps | 报告触发选项位图,按 IED 报告配置填写。 |
| RCB OptFlds | 报告可选字段位图,按 IED 报告配置填写。 |
| RCB单请求写入 | 写 RCB 参数时是否使用单请求方式。部分 IED 兼容性问题时调整。 |
| ReportReservationTimeSeconds | BRCB 预留时间,单位秒;0 表示不主动写入预留。 |
| BRCB清空缓冲 | 启用 BRCB 前是否清空缓冲区。 |
| 启用 GOOSE 订阅 | 是否订阅 GOOSE 报文。 |
| GOOSE 控制块引用 | 订阅的 GOOSE 控制块引用。 |
| GOOSE 网络接口 ID | 接收 GOOSE 的网卡标识。Linux 常见 eth0,Windows 按接口索引或 GUID。 |
| GOOSE APP-ID | GOOSE APP-ID 过滤值;0 表示不过滤。 |
| 使用 URCB(非缓冲报告) | 使用 URCB 替代 BRCB。对方只配置非缓冲报告时开启。 |
| IED 认证密码 | IED 要求认证时填写。 |
| RequestTimeout | MMS 请求超时,单位毫秒。 |
| 最大 PDU 大小 | MMS PDU 大小限制;0 使用默认值。部分 IED 限制较小时填写。 |
| 启用 TLS 加密连接 | MMS 是否启用 TLS。 |
| TLS 客户端证书 | TLS 客户端证书名称。 |
| TLS CA 证书 | 校验 IED 服务端证书的 CA。 |
| TLS 链式验证 | 是否启用证书链验证。 |
| TLS 仅允许已知证书 | 是否只允许证书库中已知证书连接。 |
| SOE事件记录配置 | SOE 事件记录设置,按项目是否需要事件追溯配置。 |
变量辅助属性:
| 变量配置项 | 现场说明 |
|---|---|
| 对象引用(辅助) | 仅作为对象引用显示和校验辅助;实际读写地址仍填写在变量地址栏。 |
| 功能约束(辅助) | IEC 61850 FC 辅助字段;实际 FC 通常在变量地址中用 ;FC=XX 或 [XX] 指定。 |
| 允许写入 | 是否允许该 IEC 61850 变量执行写入。控制点才建议开启。 |
汇川 Inovance
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| ModbusType | 底层 Modbus 通讯形态,按通道和设备选择。 |
| InovanceType | 汇川协议或设备类型,按 PLC/控制器型号选择。 |
| Station | 站号,必须和设备地址一致。 |
KELID2008
包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对变量地址和通道参数。
LKSIS
无页面插件属性。现场重点核对设备地址、变量地址和链路参数。
三菱 1E
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| PLCID | 三菱 1E PLC 站号,按 PLC 通讯设置填写。 |
三菱 3E
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| NetWorkID | 三菱网络号。 |
| IOModuleStation | IO 模块站号。 |
| IOModuleID | IO 模块编号,按通讯路径填写。 |
| PLCID | PLC 站号。 |
ModbusC1
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| ModbusType | Modbus 协议形态。 |
| Station | 默认站号。 |
ModbusC20
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| ModbusType | Modbus 协议形态。 |
| Station | 默认站号。 |
Omron FINS
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| ICF | FINS 报文控制字段,通常保持默认。 |
| GCT | 网络层信息,通常保持默认 0x02。 |
| DNA | 目标网络地址。 |
| DA2 | 目标单元地址。 |
| SNA | 源网络地址。 |
| SA2 | 源单元地址。 |
| SID | 服务 ID。 |
OPC AE
包含采集重试属性。
| 配置项 | 现场说明 |
|---|---|
| OpcAeUrl | OPC AE 服务连接地址,例如 opcae://localhost/Kepware.KEPServerEX_AE.V6。 |
| CheckRate | 检测重连频率,单位分钟。 |
SECS
包含采集重试、Foundation 通用读写和打包属性。
| 配置项 | 现场说明 |
|---|---|
| DeviceID | SECS 设备标识,必须和设备通讯配置一致。 |
TIANXIN
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| Station | 站号,按设备地址填写。 |
TS550
包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对变量地址和通道参数。
USBScaner
无页面插件属性。该插件用于 USB 扫码枪输入,现场重点核对扫码枪接入、变量映射和数据触发。
Vigor
包含采集重试、Foundation 通用读写、打包和 DTU 属性。
| 配置项 | 现场说明 |
|---|---|
| Station | 站号,按设备地址填写。 |
ZeroMQ 采集客户端
该插件自己管理 ZeroMQ 连接,不使用采集公共读写属性。
| 配置项 | 现场说明 |
|---|---|
| 连接地址 | ZeroMQ 地址,例如 tcp://127.0.0.1:5555。 |
| Socket类型 | ZeroMQ Socket 类型,默认订阅模式。 |
| 绑定模式 | true 表示 Bind 作为服务端;false 表示 Connect 作为客户端。 |
| 订阅主题前缀 | SUB 模式订阅前缀;空字符串表示订阅全部。 |
| 高水位标记 | ZeroMQ 队列高水位,数据积压超过后可能丢弃或阻塞。 |
| 详细日志 | 输出详细收发日志,联调用。 |
| 检查清除时间 | 清理状态的周期,单位毫秒。 |
数据转发目标插件逐项核对
Modbus 从站
包含目标基础属性和通道型目标属性。
| 目标配置项 | 现场说明 |
|---|---|
| Modbus类型 | 对外提供的 Modbus 协议形态,例如 TCP 或 RTU。 |
| 默认站号 | 外部主站未指定或变量未覆盖时使用的从站地址。 |
| 数据解析顺序 | 对外提供多字节数值时使用的字节序/字序。 |
| 字符串反转字节 | 字符串字节顺序是否反转。 |
| 多站点模式 | 是否允许多个站号。外部主站按不同站号访问时开启。 |
| 允许RPC写入 | 目标级写入开关。关闭后外部 Modbus 主站不能反写网关变量。 |
| 立即写入内存 | 收到写入后是否立即更新网关内存值。 |
| 发送延时时间 | 回复发送前延时,单位毫秒。对方设备处理慢或链路需要间隔时设置。 |
| 客户端权限列表 | 限制允许连接的客户端 IP 和写入权限;为空表示不限制。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| 从站变量地址 | 该变量暴露给外部 Modbus 主站访问的地址。 |
| 数据类型 | 对外显示的数据类型,需和外部主站解析方式一致。 |
| 允许RPC写入 | 变量级写入开关。目标级和变量级都允许时才可写。 |
MQTT 客户端生产者
包含目标基础属性、离线缓存属性、上传模板和脚本属性、MQTT 生产者公共属性。
| 目标配置项 | 现场说明 |
|---|---|
| IP地址 | MQTT Broker 地址。 |
| SSL目标主机名 | 证书校验使用的主机名。 |
| 客户端证书名称 | 双向证书认证时选择客户端证书。 |
| 客户端ID | MQTT ClientId,必须避免和其他客户端重复。 |
| 保活时间 | MQTT KeepAlive,单位秒。 |
| 清除会话 | 是否清除会话。需要保留离线订阅或会话状态时关闭。 |
| MQTT协议版本 | MQTT 协议版本,需和 Broker 支持情况一致。 |
变量属性包含通用目标变量字段 数据1 到 数据10,并增加:
| 变量配置项 | 现场说明 |
|---|---|
| 允许RPC写入 | 允许外部 MQTT RPC 请求反写该变量。只有目标级、Topic 和脚本配置都正确时才生效。 |
MQTT 服务端生产者
包含目标基础属性、离线缓存属性、上传模板和脚本属性、MQTT 生产者公共属性。
| 目标配置项 | 现场说明 |
|---|---|
| 服务器证书名称 | 网关作为 MQTT 服务端启用 SSL 时使用的证书。 |
| 允许连接ID前缀 | 只允许指定 ClientId 前缀接入;为空表示不按前缀限制。 |
变量属性包含通用目标变量字段 数据1 到 数据10,并增加:
| 变量配置项 | 现场说明 |
|---|---|
| 允许RPC写入 | 允许接入该 MQTT 服务端的外部客户端反写该变量。 |
ThingsBoard 客户端生产者
包含目标基础属性和离线缓存属性。该目标按 ThingsBoard Gateway 约定上传到固定主题。
| 目标配置项 | 现场说明 |
|---|---|
| 连接类型 | 选择 TCP 或 WebSocket。 |
| IP地址 | ThingsBoard MQTT 接入地址。 |
| 端口 | ThingsBoard MQTT 端口。 |
| WebSocket路径 | WebSocket 接入路径。 |
| 启用SSL | 是否使用 SSL/TLS。 |
| SSL目标主机名 | 证书校验主机名。 |
| 客户端证书名称 | 双向证书认证时选择客户端证书。 |
| CA名称 | 校验服务端证书的 CA。 |
| 允许不受信任证书 | 调试可临时开启,生产建议关闭。 |
| SSL协议版本 | TLS 协议版本。 |
| 检查证书吊销 | 是否检查证书吊销。 |
| 客户端ID | MQTT ClientId。 |
| 用户名 | ThingsBoard Access Token 或用户名,按平台认证方式填写。 |
| 密码 | 平台要求密码认证时填写。 |
| 保活时间 | MQTT KeepAlive,单位秒。 |
| 清除会话 | 是否清除会话。 |
| MQTT协议版本 | MQTT 协议版本,默认 MQTT 5。 |
| QoS等级 | 发布质量等级。 |
| 保留消息 | 是否保留消息。实时遥测通常关闭。 |
| 详细日志 | 输出详细上传日志,联调用。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| 允许RPC写入 | 允许 ThingsBoard RPC 反写该变量。 |
OPC UA 服务端
包含目标基础属性。
| 目标配置项 | 现场说明 |
|---|---|
| 服务地址 | OPC UA 服务监听地址,多个地址用分号分隔。 |
| 名称标识 | OPC UA 服务端应用名称,客户端会看到该名称。 |
| 安全策略 | 是否启用 OPC UA 安全策略。启用后证书和账号要同步配置。 |
| 允许RPC写入 | 目标级写入开关。关闭后 OPC UA 客户端不能写网关变量。 |
| 用户名 | OPC UA 客户端账号用户名。 |
| 密码 | OPC UA 客户端账号密码。 |
| 服务端证书名称 | OPC UA 服务端证书名称。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| 数据类型 | OPC UA 客户端看到的节点数据类型。类型不匹配会导致客户端写入或解析失败。 |
| 允许RPC写入 | 变量级写入开关。目标级和变量级都允许时才可写。 |
Kafka 生产者
包含目标基础属性、离线缓存属性、上传模板和脚本属性。
| 目标配置项 | 现场说明 |
|---|---|
| 服务地址 | Kafka Bootstrap Servers,通常为 主机:端口,多个 Broker 按 Kafka 约定填写。 |
| 发布超时时间 | 单次发布等待时间,单位毫秒。 |
| 用户名 | SASL 认证用户名。未启用 SASL 时留空。 |
| 密码 | SASL 认证密码。未启用 SASL 时留空。 |
| 安全协议 | Kafka 安全协议,例如明文、SASL 或 SSL 组合,必须和集群一致。 |
| SASL机制 | SASL 机制,例如 Plain、ScramSha256、ScramSha512。 |
变量属性为通用目标变量字段 数据1 到 数据10。
RabbitMQ 生产者
包含目标基础属性、离线缓存属性、上传模板和脚本属性。变量、设备、报警和插件事件的 Topic 模板在 RabbitMQ 中作为 Routing Key 使用。
| 目标配置项 | 现场说明 |
|---|---|
| IP地址 | RabbitMQ 服务地址。 |
| 端口 | RabbitMQ 端口,常见为 5672。 |
| 用户名 | RabbitMQ 认证用户名。 |
| 密码 | RabbitMQ 认证密码。 |
| 声明队列 | 是否由网关自动声明队列。队列由平台统一创建时关闭。 |
| 声明交换机 | 是否由网关自动声明交换机。账号无创建权限时关闭。 |
| 启用发布确认 | 等待 Broker 发布确认。可靠性要求高时开启。 |
| 要求路由成功 | 要求消息至少路由到一个队列。Routing Key 未命中时会按失败处理。 |
| 交换机类型 | RabbitMQ 交换机类型,例如 topic、direct、fanout。 |
| 发布超时时间 | 发布等待时间,单位毫秒。 |
| 虚拟主机 | RabbitMQ Virtual Host,必须和账号权限一致。 |
| 交换机名称 | 发布使用的交换机名称。 |
变量属性为通用目标变量字段 数据1 到 数据10。
历史数据目标
包含目标基础属性和离线缓存属性。
| 目标配置项 | 现场说明 |
|---|---|
| 数据库类型 | 历史数据写入的数据库类型。连接字符串必须与数据库类型匹配。 |
| 自定义SQL模式 | 使用自定义 SQL 宽表写入。不了解目标表结构时保持关闭。 |
| 分表策略 | 数据量大或保留周期长时用于按时间等策略拆表。 |
| 连接字符串 | 数据库连接信息,包含服务器、端口、库名、账号、密码和加密策略。 |
| 数值历史表名 | 数值变量写入的历史表名。 |
| 字符串历史表名 | 字符串变量写入的历史表名。 |
| 保留天数 | 历史数据保留周期。设置前评估追溯要求和磁盘容量。 |
| 历史表脚本 | 自定义建表或写入脚本。只有对接已有表结构或特殊规则时使用。 |
| 时区偏移 | 写入时间的时区偏移,例如 +08:00。 |
| 强制插入 | 收到数据即写入,不按采样策略减少记录量。点位多或周期短时会显著增加数据库压力。 |
| 默认采样策略 | 未配置变量属性时使用。变化采样适合状态量,间隔采样适合趋势,条件采样适合按工况记录。 |
| 默认采样间隔 | 默认采样策略为间隔时使用,单位毫秒。 |
| 默认条件表达式 | 默认采样策略为条件时使用,表达式满足时才入库。 |
| 自定义模板配置 | 自定义 SQL 宽表字段模板。字段名和数据类型必须与目标库一致。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| 采样策略 | 该变量在当前历史目标中的入库方式。 |
| 采样间隔 | 间隔采样时使用,单位毫秒。 |
| 条件表达式 | 条件采样时使用,表达式满足才记录。 |
实时数据目标
包含目标基础属性和离线缓存属性。
| 目标配置项 | 现场说明 |
|---|---|
| 数据库类型 | 实时数据写入的数据库类型。 |
| 连接字符串 | 实时数据库连接信息,账号需具备建表、更新和写入权限。 |
| 实时表名 | 保存变量最新值的表名。 |
| 实时表脚本 | 自定义实时表结构或写入逻辑时使用。 |
| 时区偏移 | 写入时间使用的时区。 |
无目标变量属性。变量范围和触发方式由数据转发组决定。
历史报警目标
包含目标基础属性和离线缓存属性。
| 目标配置项 | 现场说明 |
|---|---|
| 数据库类型 | 历史报警写入的数据库类型。 |
| 分表策略 | 报警量大或保留周期长时使用。 |
| 连接字符串 | 历史报警数据库连接信息。 |
| 历史报警表名 | 保存报警事件的表名。 |
| 保留天数 | 历史报警保留周期。 |
| 历史报警表脚本 | 自定义报警表结构或写入逻辑时使用。 |
| 时区偏移 | 报警事件时间写入时使用的时区。 |
| 最小报警等级 | 只保存该等级及以上报警。需要完整追溯时保持较低等级。 |
无目标变量属性。报警是否写入由转发组范围、报警状态和最小报警等级共同决定。
Webhook
包含目标基础属性、离线缓存属性、上传模板和脚本属性。变量 Topic 模板在 Webhook 中作为最终请求 URL 使用。
| 目标配置项 | 现场说明 |
|---|---|
| 签名密钥 | 钉钉机器人加签 Secret。企业微信、飞书或普通 HTTP 接口不需要时留空。 |
| 自定义请求头 | JSON 格式请求头,例如 {"Authorization":"Bearer token"}。格式错误会导致请求失败。 |
| 消息格式 | Raw 直接发送 JSON 或模板内容;Text/Markdown 适配机器人消息格式。 |
| 请求超时(秒) | HTTP 请求等待时间,单位秒。接口慢时可增加,过大会拖慢失败重试。 |
变量属性为通用目标变量字段 数据1 到 数据10。
SyncBridge
包含目标基础属性。该目标用于两个 ThingsGatewayRuntime 之间同步配置和变量数据。
| 目标配置项 | 现场说明 |
|---|---|
| IsServer | 开启后作为服务端等待连接;关闭后作为客户端连接 ServerUri。 |
| IsMaster | 开启后作为主端发起同步。双端部署时通常只让一端为主端。 |
| UpdateChange | 是否同步变量变化事件。只同步配置时关闭,需要实时同步变量值时开启。 |
| ServerUri | 客户端模式下连接的服务端地址,例如 192.168.1.10:7777。 |
| VerifyToken | 连接校验令牌。两端必须一致,生产环境建议改成强口令。 |
| HeartbeatInterval | 心跳间隔,单位毫秒,最小 3000。 |
无目标变量属性。同步范围由数据转发组变量范围决定。
IEC104 从站
包含目标基础属性和通道型目标属性。
| 目标配置项 | 现场说明 |
|---|---|
| IsWithTimeInfo | 是否带时标信息。对方主站要求遥测/遥信带时标时开启。 |
| Station | IEC104 公共地址/站号,必须与主站配置一致。 |
| DeviceRpcEnable | 目标级写入开关,控制主站是否允许反写。 |
| SendDelayTime | 发送延迟时间,单位毫秒。链路需要报文间隔时设置。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| StartAddress | IEC104 信息体起始地址。 |
| DataType | IEC104 数据类型,例如遥测、遥信等,必须和主站点表一致。 |
| VariableRpcEnable | 变量级写入开关。目标级和变量级都允许时才可写。 |
IEC 61850 服务端
包含目标基础属性。
| 目标配置项 | 现场说明 |
|---|---|
| IED 名称 | 对外暴露的 IED 名称。 |
| IED 端口 | MMS 服务端口,常见为 102。 |
| 厂商名称 | 服务端模型中的厂商名称。 |
| 允许写入 | 目标级写入开关。 |
| 回调超时(ms) | 写入或控制等待网关 RPC 结果的最长时间,超时会拒绝本次请求。 |
| SCL 配置文件路径 | SCL/ICD/SCD 文件路径,用于从文件构建数据模型。 |
| GOOSE 网卡接口 | 发布 GOOSE 使用的网卡标识;留空自动选择并在日志列出。 |
| 启用 GOOSE 发布 | 是否发布 GOOSE。 |
| 报告DataSet名称 | 默认报告 DataSet 名称。 |
| URCB名称 | 默认非缓冲报告控制块名称。 |
| BRCB名称 | 默认缓冲报告控制块名称。 |
| 报告ConfRev | 报告配置版本号。模型变化时应同步更新。 |
| 报告TrgOps | 报告触发选项位图。按站控层系统要求配置。 |
| 报告OptFlds | 报告可选字段位图。 |
| 报告BufTime | 报告缓冲时间,单位毫秒。 |
| 报告IntgPd | 报告完整性周期,单位毫秒。 |
| GOOSEDataSet名称 | GOOSE 数据集名称。 |
| GOOSE控制块名称 | GOOSE 控制块名称。 |
| GOOSE控制块AppID | GOOSE 控制块 appID 字符串;为空时按逻辑设备名称生成。 |
| GOOSEConfRev | GOOSE 配置版本号。 |
| GOOSE固定偏移 | 是否使用固定偏移。对方严格按 SCD 偏移解析时按要求配置。 |
| GOOSE最小时间 | GOOSE 最小重发时间,单位毫秒。 |
| GOOSE最大时间 | GOOSE 最大重发时间,单位毫秒。 |
| GOOSE VLAN优先级 | GOOSE VLAN 优先级,范围 0 到 7。 |
| GOOSE VLAN ID | GOOSE VLAN ID。 |
| GOOSE APPID | GOOSE 物理 APPID。 |
| GOOSE目标MAC | GOOSE 目标组播 MAC,例如 01-0C-CD-01-00-01。 |
| SOE事件记录配置 | SOE 事件记录配置。需要事件顺序追溯时配置。 |
| IEC 61850 版本 | 标准版本:0 为 Edition1,1 为 Edition2,2 为 Edition2.1。 |
| 最大连接数 | 最大 MMS 客户端连接数。 |
| 启用动态数据集 | 是否允许客户端创建动态数据集。 |
| 启用文件服务 | 是否启用 MMS 文件服务。 |
| 启用日志服务 | 是否启用日志服务。 |
| 报告缓冲区大小 | BRCB 报告缓冲区大小。 |
| BRCB包含ResvTms | BRCB 是否包含预留时间字段。部分客户端需要,部分客户端不兼容。 |
| RCB包含Owner | RCB 是否包含 Owner 字段。 |
| 文件服务路径 | 启用文件服务时的基础路径。 |
| 启用 TLS 加密连接 | MMS 是否启用 TLS。 |
| TLS 服务器证书 | TLS 服务端证书名称。 |
| TLS CA 证书 | 校验客户端证书的 CA。 |
| TLS 链式验证 | 是否启用证书链验证。 |
| TLS 仅允许已知证书 | 是否只允许证书库中已知证书连接。 |
变量属性:
| 变量配置项 | 现场说明 |
|---|---|
| 对象引用 | IEC 61850 对象引用,例如逻辑设备/逻辑节点/数据对象路径。 |
| 数据类型 | 对外暴露的数据对象类型,例如 MV、SPS、SPC 等。 |
| 允许写入 | 变量级写入开关。 |
| 控制模型 | 控制点使用的控制模型:状态只读、直接控制、选择后执行等。 |
| GOOSE 发布 | 是否把该变量加入 GOOSE 发布数据集。 |
ZeroMQ 生产者
包含目标基础属性、离线缓存属性、上传模板和脚本属性。
| 目标配置项 | 现场说明 |
|---|---|
| 连接地址 | ZeroMQ 地址,例如 tcp://127.0.0.1:5555。 |
| Socket类型 | ZeroMQ Socket 类型,默认发布模式。 |
| 绑定模式 | true 表示 Bind 作为服务端;false 表示 Connect 作为客户端。 |
| 高水位标记 | ZeroMQ 队列缓存上限,数据积压超过后可能阻塞或丢弃。 |
变量属性为通用目标变量字段 数据1 到 数据10。