Skip to main content

插件属性详表

本页用于现场核对“页面上每一个插件属性到底该填什么”。配置时不要从头顺读,先确定采集协议或转发目标类型,再看对应插件小节。地址格式、变量地址写法仍以 插件参考 为准。

核对口径

已按当前版本页面可配置字段核对:采集插件 30 个,数据转发目标插件 15 个。公共属性只解释一次,各插件小节会说明会显示哪些公共配置,以及额外提供哪些专属配置。

先分清三类属性

属性位置现场含义典型排查点
采集插件属性一个采集设备使用该协议时的通讯和协议参数。设备读不到、数值不对、写入慢,优先查这里。
数据转发组属性决定哪些变量进入转发链路,以及按变化还是按周期触发。变量有值但不转发,先查组范围和触发条件。
数据转发目标插件属性某个外部系统的连接、上传格式、缓存和变量映射。目标连不上、外部系统收不到、反写不生效,查这里。

数据转发组属性

数据转发组不是插件,但它决定变量是否有资格进入任何转发目标。现场判断“为什么没数据发出”时,先按下面顺序确认:变量属于本组、组启用、触发条件满足、目标启用、目标连接成功。

配置项现场说明
名称转发组名称,同一系统内应唯一。建议体现外部系统和范围,例如 MES_关键点位
描述写清本组用途、外部系统、验收人或维护边界,便于交接。
启用关闭后本组下所有目标都不会启动,也不会产生转发数据。
日志级别控制本组运行日志详细程度。联调可临时用 Debug,稳定后改回 Info
排序只影响页面显示顺序,数值越小越靠前。
变量范围模式Manual 手工选择变量;All 全部启用变量;CollectDevice 按采集设备名筛选;CollectGroup 按采集组筛选。
范围配置选择 CollectDevice 时填设备名,选择 CollectGroup 时填采集组名,多个值用英文逗号分隔。ManualAll 通常留空。
触发模式Change 按变量变化触发;Interval 只按周期触发;IntervalOrChange 变化和周期都触发。
定时转发间隔周期触发时使用。普通周期填毫秒数,例如 1000;固定时刻任务才使用 Cron 表达式。
仅在线变量开启后离线变量不会进入转发。需要外部系统看到离线前最后值时不要开启。
批处理模式决定一次触发后如何拆分变量批次,例如不拆分或按数据组拆分。
最大批量单次批处理最多变量数。外部接口超时、消息体过大或数据库压力大时调小。

组内变量属性

这些字段只说明“变量在本组内如何参与转发”,不能替代目标变量属性。

配置项现场说明
变量当前转发组包含的采集变量。Manual 模式下必须先把变量加入本组。
启用关闭后该变量不参与本组转发。
数据组用于批处理分组,例如产线、区域、设备组。批处理模式按数据组拆分时会使用。
更新模式单变量触发方式,可细化组级触发模式。
参与组触发关闭后该变量仍可随批次上传,但它自己的变化不会唤醒整个组。
别名上传时使用的外部变量名。为空时通常使用原变量名。
排序本组内变量输出顺序。

采集公共属性

采集重试属性

配置项现场说明
失败重试次数单次读写失败后的重试次数。网络或串口偶发抖动可适当增加;长期故障时过大会拖慢故障反馈。
读写占空比写入请求较多时,执行若干次写入后穿插一次读取,避免只写不读。
写优先有写入任务时优先处理写入。适合控制指令需要尽快下发的场景,普通采集保持关闭即可。

Foundation 通用读写属性

配置项现场说明
读写超时时间单次读写等待时间,单位毫秒。设备响应慢、链路延迟高时可适当加大。
帧前时间发送报文前等待时间,单位毫秒。老设备或串口总线需要帧间隔时设置。
字符串反转字节字符串按字节/字反转解析。字符串顺序不对时再调整。
数据解析顺序多字节数值的字节序/字序。数值明显偏大、偏小或符号不对时重点核对。

打包和 DTU 属性

配置项现场说明
最大打包长度一次合并读取的最大地址长度。点位多时可提高效率;设备不支持大包或经常超时时调小。
DTU IDDTU 或透传终端编号。直连设备通常留空,通过 DTU 接入时必须和现场终端编号一致。

数据转发目标公共属性

目标基础属性

配置项现场说明
名称同一转发组内唯一,用于页面显示、日志和查询目标路径。
描述记录外部系统、接口负责人、用途或验收说明。
启用关闭后该目标插件不启动。变量有值但外部系统收不到时必须先确认它已启用。
插件名称选择具体转发插件,例如 MQTT、Kafka、Webhook、历史数据目标等。
日志级别目标运行日志详细程度。接口联调时可临时提高。
目标属性当前插件的连接、缓存、上传格式等配置,详见各目标插件小节。
启动超时目标启动等待时间,单位秒。外部系统慢、证书校验慢时可适当增加。
启用冗余启用主备目标切换。只有明确有备用目标时才开启。
冗余目标当前目标故障时切换到的备用目标,必须在同一转发组内。
冗余模式按目标离线状态切换,或按脚本返回结果切换。
冗余扫描间隔检查是否需要切换的周期,单位毫秒。
冗余切换判断脚本冗余模式为脚本时使用,脚本返回 true 才切换。

通道型目标属性

Modbus 从站、IEC104 从站等目标需要监听或连接 TCP/串口/DTU 通道时,会显示这些字段。

配置项现场说明
通道类型选择 TCP 客户端、TCP 服务端、串口、DTU 等通讯模式。
远程地址客户端模式下连接的对端地址,例如 192.168.1.10:502
本地绑定地址服务端模式下监听地址,例如 0.0.0.0:502
启用SSLTCP 通道是否启用 TLS 加密。普通内网协议一般关闭。
SSL目标主机名客户端校验证书时使用的主机名,应和证书一致。
SSL客户端证书客户端模式需要双向证书认证时选择。
SSL服务端证书服务端模式监听时使用的证书。
SSL CA证书用于校验对端证书链的 CA。
允许不受信任证书调试可临时开启,生产环境建议关闭。
SSL协议指定 TLS 版本。无特殊要求保持默认。
检查证书吊销是否检查证书吊销状态。内网无吊销服务时开启可能导致连接慢或失败。
串口串口号,例如 COM1
波特率串口速率,必须和对端一致。
数据位串口数据位,常见为 8。
校验位串口校验方式,必须和对端一致。
停止位串口停止位,必须和对端一致。
DtrEnable是否启用 DTR 信号。只有现场设备要求硬件控制线时调整。
RtsEnable是否启用 RTS 信号。RS485 转换器或特殊设备可能需要。
异步流串口异步读写方式。串口稳定时保持默认,遇到阻塞或读取不及时再调整。
握手方式串口硬件/软件握手方式。大多数工业设备保持默认。
串口输入缓冲区大小串口接收缓冲区大小。报文长或突发量大时可增大。
串口输出缓冲区大小串口发送缓冲区大小。
最大并发数同一通道允许同时处理的请求数。顺序要求严格的协议保持 1。
组包缓存时间粘包/拆包等待窗口,单位毫秒。报文分片明显时可增大。
连接超时建立连接等待时间,单位毫秒。
最大连接数服务端模式允许的最大客户端连接数。
客户端清理时间服务端清理空闲客户端的周期,单位毫秒。
心跳内容需要主动发送心跳时填写。
心跳是否Hex心跳内容是否按十六进制字符串解析。
心跳时间心跳发送周期,单位毫秒。
DtuIdDTU 设备标识。通过 DTU 服务端接入时用于区分终端。
DtuId是否HexDTU 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 硬件或项目通讯参数填写。
SlotCPU 插槽号,S7-1200/1500 常见为 1,S7-300 常见为 2,仍以现场为准。
LocalTSAP本地 TSAP。只有现场明确要求 TSAP 时填写,否则保持默认。

DLT645-2007

包含采集重试、Foundation 通用读写和 DTU 属性。

配置项现场说明
默认地址12 位电表地址。变量地址未指定表地址时使用。
密码电表写入或特殊读取需要的密码;只读场景通常留空。
操作员代码电表操作员代码,写表或受控读取时按表计资料填写。
前导符报文头报文前导字节,默认 FEFEFEFE;只有表计要求不同时调整。

OPC UA 客户端

包含采集重试属性。

配置项现场说明
连接UrlOPC UA 服务端地址,例如 opc.tcp://192.168.1.10:49320
登录账号服务端要求账号认证时填写。
登录密码与登录账号配套填写。
数据变化触发条件订阅模式下哪些变化触发上报,通常保持默认。
安全策略是否启用安全策略。启用后必须配置证书并确认服务端信任。
名称标识OPC UA 客户端应用名称,用于服务端识别和证书匹配。
证书客户端证书名称,从证书管理中选择。
是否使用SourceTime使用服务端源时间作为采集时间;需要按网关接收时间记录时关闭。
加载服务端数据类型启动时读取服务端数据类型,便于类型匹配;服务端慢时可能增加启动时间。
激活订阅开启后使用订阅接收变化;关闭后按轮询读取。
更新频率订阅更新周期,单位毫秒。
死区数值变化超过死区才触发,适合减少模拟量抖动上报。
最大组大小单个订阅组最大节点数。服务端限制较小时调小。
心跳频率OPC UA 会话心跳周期,单位毫秒。

OPC DA 客户端

包含采集重试属性。

配置项现场说明
OPC服务器IPOPC 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 协议版本。
检查证书吊销是否检查证书吊销。
客户端IDMQTT 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。
启用BRSCAN FD 是否启用数据段变速率。普通 CAN2.0 无效。
内部终端电阻是否启用适配器内部终端电阻,按现场总线接线选择。
硬件滤波器CANID列表只接收指定 CAN ID;为空表示不过滤。

Allen-Bradley ControlLogix

包含采集重试、Foundation 通用读写和打包属性。

配置项现场说明
SlotControlLogix CPU 插槽号。
Backplane背板寻址参数,按 PLC 机架通讯路径填写。

Allen-Bradley PCCC

包含采集重试、Foundation 通用读写和打包属性;无额外页面插件属性。该插件构造时默认 数据解析顺序 为 DCBA、最大打包长度 为 150,现场重点核对变量地址格式。

DCON 主站

包含采集重试、Foundation 通用读写、打包和 DTU 属性。

配置项现场说明
StationDCON 站号,必须和模块地址一致。

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 兼容性问题时调整。
ReportReservationTimeSecondsBRCB 预留时间,单位秒;0 表示不主动写入预留。
BRCB清空缓冲启用 BRCB 前是否清空缓冲区。
启用 GOOSE 订阅是否订阅 GOOSE 报文。
GOOSE 控制块引用订阅的 GOOSE 控制块引用。
GOOSE 网络接口 ID接收 GOOSE 的网卡标识。Linux 常见 eth0,Windows 按接口索引或 GUID。
GOOSE APP-IDGOOSE APP-ID 过滤值;0 表示不过滤。
使用 URCB(非缓冲报告)使用 URCB 替代 BRCB。对方只配置非缓冲报告时开启。
IED 认证密码IED 要求认证时填写。
RequestTimeoutMMS 请求超时,单位毫秒。
最大 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三菱网络号。
IOModuleStationIO 模块站号。
IOModuleIDIO 模块编号,按通讯路径填写。
PLCIDPLC 站号。

ModbusC1

包含采集重试、Foundation 通用读写、打包和 DTU 属性。

配置项现场说明
ModbusTypeModbus 协议形态。
Station默认站号。

ModbusC20

包含采集重试、Foundation 通用读写、打包和 DTU 属性。

配置项现场说明
ModbusTypeModbus 协议形态。
Station默认站号。

Omron FINS

包含采集重试、Foundation 通用读写和打包属性。

配置项现场说明
ICFFINS 报文控制字段,通常保持默认。
GCT网络层信息,通常保持默认 0x02
DNA目标网络地址。
DA2目标单元地址。
SNA源网络地址。
SA2源单元地址。
SID服务 ID。

OPC AE

包含采集重试属性。

配置项现场说明
OpcAeUrlOPC AE 服务连接地址,例如 opcae://localhost/Kepware.KEPServerEX_AE.V6
CheckRate检测重连频率,单位分钟。

SECS

包含采集重试、Foundation 通用读写和打包属性。

配置项现场说明
DeviceIDSECS 设备标识,必须和设备通讯配置一致。

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目标主机名证书校验使用的主机名。
客户端证书名称双向证书认证时选择客户端证书。
客户端IDMQTT 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 协议版本。
检查证书吊销是否检查证书吊销。
客户端IDMQTT 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 机制,例如 PlainScramSha256ScramSha512

变量属性为通用目标变量字段 数据1数据10

RabbitMQ 生产者

包含目标基础属性、离线缓存属性、上传模板和脚本属性。变量、设备、报警和插件事件的 Topic 模板在 RabbitMQ 中作为 Routing Key 使用。

目标配置项现场说明
IP地址RabbitMQ 服务地址。
端口RabbitMQ 端口,常见为 5672。
用户名RabbitMQ 认证用户名。
密码RabbitMQ 认证密码。
声明队列是否由网关自动声明队列。队列由平台统一创建时关闭。
声明交换机是否由网关自动声明交换机。账号无创建权限时关闭。
启用发布确认等待 Broker 发布确认。可靠性要求高时开启。
要求路由成功要求消息至少路由到一个队列。Routing Key 未命中时会按失败处理。
交换机类型RabbitMQ 交换机类型,例如 topicdirectfanout
发布超时时间发布等待时间,单位毫秒。
虚拟主机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是否带时标信息。对方主站要求遥测/遥信带时标时开启。
StationIEC104 公共地址/站号,必须与主站配置一致。
DeviceRpcEnable目标级写入开关,控制主站是否允许反写。
SendDelayTime发送延迟时间,单位毫秒。链路需要报文间隔时设置。

变量属性:

变量配置项现场说明
StartAddressIEC104 信息体起始地址。
DataTypeIEC104 数据类型,例如遥测、遥信等,必须和主站点表一致。
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控制块AppIDGOOSE 控制块 appID 字符串;为空时按逻辑设备名称生成。
GOOSEConfRevGOOSE 配置版本号。
GOOSE固定偏移是否使用固定偏移。对方严格按 SCD 偏移解析时按要求配置。
GOOSE最小时间GOOSE 最小重发时间,单位毫秒。
GOOSE最大时间GOOSE 最大重发时间,单位毫秒。
GOOSE VLAN优先级GOOSE VLAN 优先级,范围 0 到 7。
GOOSE VLAN IDGOOSE VLAN ID。
GOOSE APPIDGOOSE 物理 APPID。
GOOSE目标MACGOOSE 目标组播 MAC,例如 01-0C-CD-01-00-01
SOE事件记录配置SOE 事件记录配置。需要事件顺序追溯时配置。
IEC 61850 版本标准版本:0 为 Edition1,1 为 Edition2,2 为 Edition2.1。
最大连接数最大 MMS 客户端连接数。
启用动态数据集是否允许客户端创建动态数据集。
启用文件服务是否启用 MMS 文件服务。
启用日志服务是否启用日志服务。
报告缓冲区大小BRCB 报告缓冲区大小。
BRCB包含ResvTmsBRCB 是否包含预留时间字段。部分客户端需要,部分客户端不兼容。
RCB包含OwnerRCB 是否包含 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