跳到主要内容

插件配置详表

本页把每个插件的变量地址、寄存器字符串和特有属性放在同一小节。配置时不要从头顺读,直接搜索插件名;先复制并核对“变量地址”,再填写该插件的属性。公共属性只解释一次,插件用途和调试入口参见插件参考

核对口径

当前版本目录包含采集插件 107 个、数据转发目标插件 15 个。本页逐项展开全部插件的变量地址和页面字段。公共属性只解释一次,各插件小节只保留地址、特有属性和必要限制,避免在多个页面来回查找。

先分清三类属性

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

数据转发组属性

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

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

组内变量属性

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

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

采集公共属性

采集重试属性

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

Foundation 通用读写属性

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

打包和 DTU 属性

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

地址通用转换后缀

按原始字节解析的采集插件可在寄存器地址末尾追加以下参数。具体插件不支持某项时,以该插件地址说明和变量编辑器校验结果为准。

后缀现场说明示例
data=ABCD/BADC/CDAB/DCBA四字节数据顺序。数值地址正确但高低字节颠倒时调整。40001;data=CDAB
len=N字符串或定长字节长度。$PRO_NAME[];len=32
arraylen=N连续数组元素数量。D100;arraylen=8
bcd=C8421/C5421/C2421/C3/GrayBCD 或 Gray 编码方式。D100;bcd=C8421
encoding=UTF-8字符串编码,也可按设备使用 ASCIIDefaultUnicode 等。$PRO_NAME[];len=32;encoding=UTF-8
s=N覆盖默认站号或设备地址;含义和范围由插件决定。s=2;D100

数据转发目标公共属性

目标基础属性

配置项现场说明
名称同一转发组内唯一,用于页面显示、日志和查询目标路径。
描述记录外部系统、接口负责人、用途或验收说明。
启用关闭后该目标插件不启动。变量有值但外部系统收不到时必须先确认它已启用。
插件名称选择具体转发插件,例如 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
历史读取RPC Topic外部系统查询历史记录、数值序列和报警的主题前缀,默认 RpcHistory;请求使用 RpcHistory/<32位十六进制请求号>,响应使用 RpcHistory/<请求号>/Response
数据请求Topic外部系统请求全量数据的主题。收到任意消息后会推送变量、设备、报警等数据。
RPC脚本处理 MQTT RPC 写入请求的脚本,仅在对方请求格式不是默认格式时使用。

采集插件逐项核对

自定义完整报文(CustomPacketMaster

变量地址: ReadCommand@ByteOffset[.BitOffset][;write=WriteCommand]。例如 ReadTemp@4;write=SetTemp;偏移相对于响应有效载荷。

包含采集重试、Foundation 通用读写和 DTU 属性。页面上的“协议配置”包含分帧、命令、响应匹配、校验和调试限制,未被当前模式使用的字段应留空。

配置项现场说明
Frame.FrameType分帧模式:固定包头长度字段、起止码、结束符或固定长度。只选择一种。
Frame.HeaderLength固定包头模式首次解析所需的包头字节数;其他模式保持默认。
Frame.HeaderMatchHex / HeaderMaskHex固定包头的十六进制特征和可选掩码;无需特征重同步时留空。
Frame.LengthFieldOffset长度字段相对完整帧起点的字节偏移。
Frame.LengthFieldSize长度字段字节数,只允许 1、2 或 4。
Frame.LengthFieldEndian长度字段字节序,选择大端或小端。
Frame.LengthAdjustment长度字段值换算为完整帧长度时增加的字节数,可为 0。
Frame.StartCodeHex / EndCodeHex起止码模式的起始码和结束码十六进制文本;其他模式留空。
Frame.TerminatorHex结束符模式的结束符十六进制文本;其他模式留空。
Frame.FixedLength固定长度模式的完整帧字节数;其他模式保持默认。
Frame.MinFrameLength起止码或结束符模式允许的最小完整帧长度。
Frame.MaxPackageSize最大完整帧字节数,默认 65536;应覆盖最大合法响应但不要无边界放大。
Commands[].Name命令唯一名称,也是变量地址引用的命令名,不能为空或重复。
Commands[].ReadRequestHex读取时发送的完整十六进制请求;只写命令可留空。
Commands[].ReadResponse读取响应的归属、成功判断、校验和有效载荷规则;只写命令可留空。
Commands[].WriteRequestHexTemplate写请求十六进制模板,只能包含一个值占位符;只读命令留空。
Commands[].WriteResponse需要等待写响应时配置;发送后不等待响应时留空。
Commands[].WriteSendOnly开启后写请求发送成功即完成,不再等待响应。
Commands[].RequestChecksum请求校验规则;请求无校验时留空。
MatchSegments[].Offset / ExpectedHex / MaskHex响应匹配段的字节偏移、期望十六进制值和可选掩码;精确匹配时掩码留空。
Response.SuccessSegments判断协议成功的匹配段;无状态码或任意归属响应均成功时留空。
Response.PayloadOffset / PayloadLength有效载荷起始偏移和长度;长度留空表示截取到帧末尾。
Checksum.Algorithm选择 None、Sum8、Xor8、Lrc8 或对应 CRC16 算法。
Checksum.CalculationOffset / CalculationLength校验计算范围;长度留空时计算到校验字段或帧末尾。
Checksum.ValueOffset / Endian / Placement校验字段偏移、字节序以及覆盖或追加方式。
TextEncoding原始调试文本编码,默认 UTF-8;仅按设备文本编码调整。
MaxDebugRequestBytes单次原始调试请求上限,单位字节,默认 65536。

Modbus 主站(ModbusMaster

变量地址: 00001 线圈、10001 离散输入、30001 输入寄存器、40001 保持寄存器。可追加 s=N 覆盖站号、.N 读取寄存器位、f=N 指定读取功能码、w=6/16 指定写入功能码,例如 s=2;40001.3

包含采集重试、Foundation 通用读写、Modbus 专用打包规则和 DTU 属性。旧“最大打包长度”不再用于 Modbus 主站。

配置项现场说明
Modbus类型选择 Modbus TCP、RTU 或 ASCII,必须和通道及设备一致。ModbusAscii 仅支持 SerialPortTcpClientTcpService 流式通道,不支持 UdpSession
默认站号默认从站地址。变量地址里单独写站号时,以变量地址为准。
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 不会作为当前配置继续生效,也不应假设旧值会自动映射到六个功能码。

Modbus ASCII 使用连续字节流解析 : 起始、十六进制字符、LRC 和 CRLF 结束的帧,因此只能绑定串口、TCP 客户端或 TCP 服务通道;UDP 数据报不提供所需的流式帧边界。该能力仅适用于 Modbus 主站,Modbus 从站仍只支持 TCP 和 RTU。

Siemens S7(SiemensS7Master

变量地址: 使用 IQMDBV 区,例如 DB1.DBX0.0DB1.DBW0DB1.DBD0M10.0VW100

包含采集重试、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(Dlt645_2007Master

变量地址: 两字节或四字节数据标识,例如 02010100;多块电表共用通道时追加 s=12位表地址,例如 02010100;s=111111111111

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

配置项现场说明
默认地址12 位电表地址。变量地址未指定表地址时使用。
密码电表写入或特殊读取需要的密码;只读场景通常留空。
操作员代码电表操作员代码,写表或受控读取时按表计资料填写。
前导符报文头报文前导字节,默认 FEFEFEFE;只有表计要求不同时调整。
控制命令有效期拉合闸控制命令的有效分钟数,默认 5 分钟,范围 1~60;只影响控制命令生成,不改变普通读写超时。

OPC UA 客户端(OpcUaMaster

变量地址: OPC UA NodeId 原文,例如 ns=2;s=Devices/Line1/Temperature。以服务端节点浏览结果为准,不追加 Modbus 地址参数。

包含采集重试属性。

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

OPC DA 客户端(OpcDaMaster

变量地址: OPC DA ItemId,例如 Channel1.Device1.Temperature。以 OPC 服务端浏览结果为准。

包含采集重试属性。

配置项现场说明
OPC服务器IPOPC DA 服务器所在主机。远程 DA 还要确认 DCOM 权限。
OPC服务器名称OPC DA ProgID,例如 Kepware.KEPServerEX.V6
服务端时间使用 OPC 服务器源时间;需要网关接收时间时关闭。
订阅模式开启后通过 DA 订阅更新;关闭后按周期读取。
CheckRate检测重连频率,单位分钟。
死区数值变化死区,用于过滤小幅抖动。
最大组大小单个 OPC 组最大点数。服务端压力大或订阅失败时调小。
订阅更新频率OPC DA 订阅更新周期,单位毫秒。

MQTT 采集客户端(MqttCollectClient

变量地址: 固定八段格式 订阅Topic;JSONPath1||JSONPath2;条件脚本;发布Topic;载荷模式;Retain;RPC响应Topic;超时毫秒。只读示例 device/data;$.Temperature,只写示例 ;;;device/set;Json;false。RPC 发布和响应 Topic 的末级必须各包含一次 {RequestId}

该插件自己管理 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 采集服务端(MqttCollectServer

变量地址: 与 MQTT 采集客户端相同,使用八段 Topic/JSONPath/控制路由格式,例如 device/data;$.Temperature。JSONPath 支持候选路径、数组下标、过滤器 [?()]、通配符、递归选择;详细规则见插件参考

该插件在网关内启动 MQTT 服务端,不使用采集公共读写属性。

配置项现场说明
连接类型选择 TCP 或 WebSocket。
端口网关监听的 MQTT 端口。
WebSocket路径WebSocket 监听路径。
启用SSL是否启用 SSL/TLS 监听。
服务器证书名称服务端证书名称,启用 SSL 时必须配置。
CA名称校验客户端证书时使用的 CA。
允许不受信任证书调试可临时开启,生产建议关闭。
SSL协议版本TLS 协议版本。
检查证书吊销是否检查证书吊销。
允许连接ID前缀只允许指定 ClientId 前缀的客户端接入;为空表示不按前缀限制。
用户名客户端连接认证用户名。
密码客户端连接认证密码。
QoS等级控制消息和 RPC 回执的 MQTT 投递质量。AtMostOnce 延迟低但可能丢失,AtLeastOnce 可能重复,ExactlyOnce 开销最高。
详细日志输出详细连接和消息日志,联调用。
检查清除时间清理无效客户端状态的周期,单位毫秒。

Gateway MQTT 专用采集客户端(GatewayMqttCollectClient

变量地址: 固定为 RemoteKey/RemoteVariableId,例如 edge-a/temperature-01。不要填写普通 MQTT Topic 或 JSONPath。

该插件通过一条共享 Broker 连接采集多个边缘 Gateway,不使用普通 MQTT Topic/JSONPath 变量地址。变量地址固定为 RemoteKey/RemoteVariableId。完整配置步骤参见 Gateway MQTT 专用采集

属性现场说明
Topic根固定协议的 Topic 根,默认 ThingsGateway/Gateway;边缘 Producer 和中心采集必须一致。
允许远程写入是否接受边缘 Producer 发起的变量 RPC 写入;涉及控制权限时必须同时打开目标变量写入权限。
快照间隔(秒)周期请求完整变量快照,范围 10~3600。
请求超时(秒)快照和 RPC 等待时间,范围 1~600。
离线超时(秒)来源无合法协议消息后的离线阈值,必须大于快照间隔且不超过 86400。
远端来源上限单设备最多配置的 RemoteKey 数,范围 1~128。
快照并发上限同时执行来源快照的数量,范围 1~32。
入站载荷字节上限单条 MQTT 入站载荷上限,范围 4096~16777216 字节。
每秒消息上限全部来源每秒进入解析器的消息数上限,范围 1~100000。
入站处理并发上限JSON 入站处理并发数,范围 1~64。
JSON深度上限协议载荷允许的最大 JSON 嵌套深度,范围 8~256。
单来源目录上限单个来源变量目录条目上限,范围 1~1000000。
目录总上限全部来源目录条目上限,必须覆盖单来源上限且不超过 3000000。
RPC等待上限同时等待的远端 RPC 批次数,范围 1~4096。
详细日志记录不含敏感字段和完整载荷的协议摘要。

连接属性:连接类型IP地址端口WebSocket路径启用SSLSSL目标主机名客户端证书名称CA名称允许不受信任证书SSL协议版本检查证书吊销客户端ID用户名密码保活时间清除会话MQTT协议版本连接超时

远端来源字段现场说明
RemoteKey1~64 位 ASCII 字母、数字、连字符或下划线;必须唯一,并参与 Topic、地址和请求关联。
DisplayName仅用于页面和调试显示,不能为空。
Enable是否订阅、同步目录、请求快照和接受 RPC。
QoS等级该来源固定协议的订阅和发布 QoS。

Gateway MQTT 专用采集服务端(GatewayMqttCollectServer

变量地址: 固定为 RemoteKey/RemoteVariableId,例如 edge-a/temperature-01。地址中的 RemoteKey 必须与远端来源配置完全一致。

该插件在一个端口接入多个边缘 Gateway。设备级容量、快照、权限和变量地址与 Client 模式一致;监听属性如下。

属性现场说明
连接类型TCP 或 WebSocket,必须与边缘 Producer 的接入方式一致。
端口MQTT 监听端口。启用 WebSocket 时还要配置 WebSocket 路径。
WebSocket路径WebSocket 监听路径,默认 /mqtt
启用SSL是否启用 TLS;启用后必须配置服务端证书。
服务端证书名称网关证书管理中的服务端证书。
CA名称双向证书校验时使用的 CA。
允许不受信任证书是否接受不受信任的客户端证书;生产环境建议关闭。
SSL协议版本TLS 协议版本。
检查证书吊销是否检查客户端证书吊销状态。
远端来源字段现场说明
RemoteKey / DisplayName / Enable / QoS等级含义与 Client 模式一致。RemoteKey 必须唯一。
AllowedClientId必须与边缘 Producer 的 MQTT ClientId 精确匹配,并在本监听实例内唯一。
用户名 / 密码该来源独立的 MQTT 认证凭据,不能与其他来源混用。
ClientCertificateSha256可选的小写 SHA-256 客户端证书指纹;启用指纹绑定时,全部启用来源都必须填写且唯一。

CAN 主站(CanMaster

变量地址: 0xCANID[.起始字节][;R=0x响应ID][;L=数据长度][;E=1],例如 0x123.20x123;R=0x456;L=4;E=1

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

配置项现场说明
端点地址CAN 适配器和通道地址,例如虚拟通道或 ZLG 设备通道。
波特率仲裁段波特率,必须和总线一致。
数据相位波特率CAN FD 数据段波特率,仅 CAN FD 模式有效。
协议模式选择 CAN2.0 或 CAN FD。
启用BRSCAN FD 是否启用数据段变速率。普通 CAN2.0 无效。
内部终端电阻是否启用适配器内部终端电阻,按现场总线接线选择。
硬件滤波器CANID列表只接收指定 CAN ID;为空表示不过滤。

Allen-Bradley ControlLogix(ControlLogixMaster

变量地址: CIP Tag Name,例如 Motor.Speed;数组元素使用 Tank.Level[2]

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

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

Allen-Bradley PCCC(PCCCMaster

变量地址: 文件表格式 O/I/S/B/T/C/R/N/F/ST/A/L{DbBlock}:{Address},例如 O1:10N7:0ST10:100

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

DCON 主站(DCONMaster

变量地址: [BitIndex][;W=WriteLength],例如 03;W=2。位索引和写入长度按 DCON 模块命令表填写。

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

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

EDPF_NT(EDPF_NTMaster

变量地址: 十进制点号[;TYPE=N],例如 100101;TYPE=1102;TYPE=2。省略 TYPE 时为 00 为 Single,1 为 Int32,2 为 Int16,3 为 Int32。

无页面插件属性。该插件不显示采集重试或 Foundation 字段,现场重点核对通道、设备和变量地址配置。

HJ212 主站(HJ212Master

变量地址: CN=XXX;MN=XXX;ST=XXX,例如 CN=2011;MN=123456;ST=32。分别对应命令编码、设备唯一标识和系统编码。

包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对 HJ212 地址字段、MN、CN、ST 等变量地址内容和链路参数。

IEC 61850 客户端(IEC61850Master

变量地址: LD/LN.DO.DA;FC=XX,例如 LD0/LLN0.GGIO1.Ind1.stVal;FC=ST。功能约束按模型使用 STMXCO 等值。

包含采集重试属性。

配置项现场说明
IED IP地址被采集 IED 的 IP 地址。
IED 端口MMS 端口,常见为 102。
连接超时(ms)建立连接超时,单位毫秒。
最大打包数量一次批量读取的最大数量。IED 响应慢或报文过大时调小。
更新频率(ms)轮询或订阅处理周期,单位毫秒。
SCL 配置文件路径SCL/ICD/SCD 文件路径,用于导入或生成变量模型。
启用 RCB 报告订阅使用报告订阅代替轮询。IED 报告配置正确时开启。
RCB 报告 ID报告 ID,需和 IED 报告控制块一致。
RCB 引用列表报告控制块引用列表,多个值可用逗号、分号或换行分隔。为空时按常见约定自动推导。
RCB 缓冲时间(ms)报告缓冲时间,单位毫秒。
RCB 完整性周期(ms)完整性报告周期,单位毫秒。
RCB TrgOps报告触发选项位图,按 IED 报告配置填写。
RCB OptFlds报告可选字段位图,按 IED 报告配置填写。
RCB单请求写入写 RCB 参数时是否使用单请求方式。部分 IED 兼容性问题时调整。
BRCB预留时间(秒)BRCB 预留时间,单位秒;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 要求认证时填写。
请求超时(ms)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(InovanceMaster

变量地址: 按 PLC 系列使用 AM/H3U/H5U 软元件,例如 Q0.0IX0.0MW0MD0M0D0;可用 s=2;D0 覆盖站号。

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

配置项现场说明
ModbusType底层 Modbus 通讯形态,按通道和设备选择。
InovanceType汇川协议或设备类型,按 PLC/控制器型号选择。
Station站号,必须和设备地址一致。

KELID2008(KELID2008Master

变量地址: 主动上报通道编号,例如 1 表示通道 1。变量按报文通道映射,不使用 Modbus 地址。

包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对变量地址和通道参数。

LKSIS(LKSISMaster

变量地址: 十进制点号[;TYPE=点类型],例如 123;TYPE=0456;TYPE=1。TYPE 为 0 或省略时表示 AI,1 表示 DI;变量由 UDP 主动上报更新。

无页面插件属性。现场重点核对设备地址、变量地址和链路参数。

三菱 1E(Mc1E_BinaryMaster

变量地址: X/Y/M/F/V/B/D/W/TS/TC/TN/CS/CC/CN/S 等 1E 软元件,例如 D100M10X20

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

配置项现场说明
PLCID三菱 1E PLC 站号,按 PLC 通讯设置填写。

三菱 3E(Mc3E_BinaryMaster

变量地址: X/Y/M/L/F/V/B/D/W/TS/TC/TN/CS/CC/CN/SM/SD/DX/DY 等 3E 软元件,例如 D100D100.3X10。WORD 区布尔变量需显式位号。

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

配置项现场说明
NetWorkID三菱网络号。
IOModuleStationIO 模块站号。
IOModuleIDIO 模块编号,按通讯路径填写。
PLCIDPLC 站号。

ModbusC1(ModbusC1Master

变量地址: 使用 Modbus C1 对应的 0/1/3/4 区地址,例如 40001s=2;40001.0

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

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

ModbusC20(ModbusC20Master

变量地址: 使用 Modbus C20 对应的 0/1/3/4 区地址,例如 40001s=2;40001.0

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

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

Omron FINS(OmronFinsMaster

变量地址: D/CIO/W/H/A/E/TIM/CNT/IR/DR/CF,例如 D0CIO0W0E0.0TIM0CF1.1

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

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

OPC AE(OpcAeMaster

变量地址: OPC AE SourceID,例如 Channel1.Device1.AlarmHigh。多个变量可以订阅同一个 SourceID。

包含采集重试属性。

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

SECS(SECSMaster

变量地址: s=N;f=N[;w][;SECS-II XML],例如 s=1;f=3;ws=6;f=11s=1;f=13;w;<List Length="0" />

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

配置项现场说明
会话标识HSMS 会话标识,范围 0~65534;必须和设备通讯配置一致,65535 保留给控制消息。
数据事务 T3主消息等待应答的超时,单位毫秒,默认 45000。
控制事务 T6HSMS 控制事务响应超时,单位毫秒,默认 5000。
选择会话 T7连接后等待选择会话的超时,单位毫秒,默认 10000。
分片接收 T8网络分片接收超时,单位毫秒,默认 5000。

TIANXIN(TIANXINMaster

变量地址: 天信数据类型,可追加 S=站号;,例如 FlowRateTotalAmountTempS=2;Pressure

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

配置项现场说明
Station站号,按设备地址填写。

TS550(TS550Master

变量地址: 主动上报通道编号,例如 1 表示通道 1。变量按协议帧中的通道映射。

包含采集重试和 Foundation 通用读写属性;无额外页面插件属性。现场重点核对变量地址和通道参数。

USBScaner(USBScaner

变量地址: 无周期寄存器地址。扫码内容由 USB 输入事件更新,使用插件调试功能验证。

无页面插件属性。该插件用于 USB 扫码枪输入,现场重点核对扫码枪接入、变量映射和数据触发。

Vigor(VigorMaster

变量地址: 位区 X/Y/M/SM/S/T/C,字区 D/SD/R/T/C,例如 M100D100s=2;D100。C0~C199 为 16 位,C200~C255 为 32 位。

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

配置项现场说明
Station站号,按设备地址填写。

ZeroMQ 采集客户端(ZeroMQCollectClient

变量地址: ${zmq_topic};${payload_item};${Condition},例如 device/data;Temperaturedevice/data;Status;TemperatureGreaterThan20

该插件自己管理 ZeroMQ 连接,不使用采集公共读写属性。

配置项现场说明
连接地址ZeroMQ 地址,例如 tcp://127.0.0.1:5555
Socket类型ZeroMQ Socket 类型,默认订阅模式。
绑定模式true 表示 Bind 作为服务端;false 表示 Connect 作为客户端。
订阅主题前缀SUB 模式订阅前缀;空字符串表示订阅全部。
高水位标记ZeroMQ 队列高水位,数据积压超过后可能丢弃或阻塞。
详细日志输出详细收发日志,联调用。
检查清除时间清理状态的周期,单位毫秒。

扩展采集插件逐项核对

以下小节补全扩展采集插件的页面属性。“无专属页面插件属性”表示除已列出的公共属性组外不再显示额外字段,不代表设备、通道或变量无需配置。

Dlt645_1997Master

变量地址: 两字节数据标识,例如 B6-11;可用 s=站号; 指定电表地址,例如 s=1;B6-11

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

配置项现场说明
默认地址默认 12 位电能表地址;变量地址已指定表地址时由变量配置覆盖。
前导符报文头请求前发送的 FE 前导字节,默认 FEFEFEFE;表计不需要前导时留空。

Df1Master

变量地址: 文件表地址 N7:0B3:0F8:0ST9:0;Boolean 使用 N7:0/3N7:0.3

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

配置项现场说明
StationDF1 链路站号,按串行网络规划填写。
DestinationNode目标 PLC 节点号,必须与设备配置一致。
SourceNode网关在 DF1 链路中的源节点号,不能与其他节点冲突。
ChecksumKindDF1 帧尾校验方式,默认 CRC16;仅在设备明确使用其他校验时调整。

LogixCipMaster

变量地址: CIP Tag Name,例如 Motor.Speed;数组元素使用 Tank.Level[2]

包含采集重试、Foundation 通用读写和打包属性,并继承 Micro CIP 路由字段。

配置项现场说明
Slot目标控制器插槽号,按 EtherNet/IP 路由填写。
Backplane背板路由端口,默认 1;直达或非标准路由时按控制器资料调整。

MicroCipMaster

变量地址: CIP Tag Name,例如 Motor.Speed;数组元素使用 Tank.Level[2]

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

配置项现场说明
Slot目标控制器插槽号。
Backplane背板路由端口,默认 1

SlcEthernetMaster

变量地址: 文件表地址 N7:0B3:0F8:0ST9:0;Boolean 使用 N7:0/3N7:0.3

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。文件表地址和节点信息在变量地址中配置。

BeckhoffAdsMaster

变量地址: 字节地址 M100/I100/Q100,布尔地址 M100.0,显式地址 ig=0x4020;io=100,符号地址 s=MAIN.Variable

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

配置项现场说明
SourceAmsNetId网关侧 AMS Net ID,必填,必须与 ADS 路由中的本地标识一致。
SourceAdsPort网关侧 ADS 逻辑端口,范围 1~65535;按本地 ADS 路由填写。
TargetAmsNetIdPLC 侧 AMS Net ID,必填,必须与目标控制器一致。
TargetAdsPortPLC 侧 ADS 逻辑端口,范围 1~65535;按目标运行时端口填写。

CimonHmiMaster

变量地址: X/Y/M/L/K/F/D/S/TC/TS/CC/CS,例如 D1D1.15X10。布尔量使用 WORD地址.位号,位号范围 0~15。

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

配置项现场说明
CpuModelPLC CPU 型号,用于校验设备区地址边界。
FrameNumber七位线协议帧号,范围 0x000x7F,必须与 PLC 或虚拟服务器一致。

DeltaMaster

变量地址: DVP 可用 X0Y0M0D0.0;AS300 可用 SM0SR0HC0D0。X/Y 使用八进制,可追加 s=2;

包含 Modbus 主站的全部属性。

配置项现场说明
PLC 系列选择台达 PLC 系列,决定地址区到 Modbus 地址的映射方式。

FatekProgramMaster

变量地址: 位区 X/Y/M/S/T/C;WORD 区 WX/WY/WM/WS/WT/WC/RT/RC/R/D/F,例如 X50WY8RT12R100

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

配置项现场说明
StationPLC 站号,协议范围 01HFEH
MaxDiscretePack单次连续读取的最大离散点数,范围 1~256;设备响应不稳定时调小。

FujiCommandMaster

变量地址: B/M/K/F/A/D/S/TS/TR/CS/CR/BD/WL/W9W21W125,例如 D100W21.200

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。连接号等路由信息按变量地址和设备通讯配置确定。

FujiSpbMaster

变量地址: Y/X/M/L/TC/CC/TN/CN/D/R/W,例如 D100TN20D10.12

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

配置项现场说明
Station请求使用的 PLC 站号,默认 1;必须与设备站号一致。

FujiSphMaster

变量地址: WORD 区 I/Q/M1/M3/M10,布尔地址追加 .0..15,例如 I0Q20M3.1000.12

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

配置项现场说明
ConnectionId目标 CPU 或链路模块连接号,默认 0xFE;按 PLC 网络配置填写。

GeSrtpMaster

变量地址: I/Q/M/T/SA/SB/SC/S/G 支持位或字节,AI/AQ/R 为 WORD,例如 M1Q100R1AI100。地址从 1 开始。

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。地址区和数据格式通过变量及公共属性配置。

InovanceComputerLinkMaster

变量地址: 汇川 Computer Link 软元件地址,例如 D100;可用 s=2;D100 覆盖默认站号。

包含采集重试、Foundation 通用读写和打包属性,并沿用 FX Links 链路字段。

配置项现场说明
Station默认目标站号;变量地址显式指定站号时由变量配置覆盖。
WaitingTime报文等待时间,单位为 10 毫秒;设备处理慢时适当增加。
SumCheck是否启用累加和校验,必须与 PLC 端帧设置一致。
Format选择格式 1 或格式 4,必须与 PLC Computer Link 帧格式一致。

InovanceConnectedCipMaster

变量地址: 汇川连接式 CIP Tag Name,例如 Motor.SpeedTank.Level[2]

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

配置项现场说明
SlotPLC 插槽号。
Backplane背板路由号,默认 1

InovanceEasyNetMaster

变量地址: W/D/R/X/Y/M/S/B/U/UB/UW,例如 D100X10。X/Y 使用八进制,U 类使用十六进制。

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。PLC 型号、站号和地址按变量地址规则填写。

KeyenceKvOldMaster

变量地址: 接点使用 R字.位T/C/CTH/CTC,WORD 使用 DM/TM/AT/CTH/CC/CT/TC/T,例如 R10.3DM100T1

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。PLC 型号、站号和地址在变量配置中确定。

KeyenceMcAsciiMaster

变量地址: 位区 X/Y/B 使用十六进制,M/L/SM/TS/TC/CS/CC 使用十进制;WORD 区 SD/D/R/TN/CN 使用十进制,ZR/W 使用十六进制。示例 D100.3

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

配置项现场说明
NetWorkIDMC 路由网络编号。
IOModuleStation目标模块站号。
IOModuleID目标模块 I/O 编号,默认 0x03FF
PLCID目标 PLC 编号,默认 0xFF

KeyenceMcBinaryMaster

变量地址: 位区 X/Y/B 使用十六进制,M/L/SM/TS/TC/CS/CC 使用十进制;WORD 区 SD/D/R/TN/CN 使用十进制,ZR/W 使用十六进制。示例 D100.3

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

配置项现场说明
NetWorkIDMC 路由网络编号。
IOModuleStation目标模块站号。
IOModuleID目标模块 I/O 编号,默认 0x03FF
PLCID目标 PLC 编号,默认 0xFF

KeyenceNanoMaster

变量地址: 接点 R/CR/MR/LR字.位B/VB;WORD 视图追加 .U,DWORD 当前值追加 .D,例如 R10.3R10.0.UT1.DB10.U

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

配置项现场说明
Station多分支链路站号,范围 0~99。
UseStationCR 连接命令是否携带两位站号;直连且设备不要求站号时关闭。

LsisMaster

变量地址: 设备区 P/M/L/K/F/T/C/D/S/Q/I/N/U/Z/R。Boolean 使用 MX103MX10.3;非 Boolean 使用 MB100DW100DD100DL100

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

配置项现场说明
ProtocolMode选择 Cnet 或 Fast Ethernet,必须与通道和 PLC 模块一致。
StationCnet 默认站号,范围 00H1FH;仅 Cnet 模式使用。
CpuSeriesFast Ethernet CPU 系列;仅 Fast Ethernet 模式使用。
BaseNumberFast Ethernet 模块基座号;Cnet 模式不使用。
SlotNumberFast Ethernet 模块槽号,默认 3;Cnet 模式不使用。
CompanyId八字符公司标识,默认 LSIS-XGT;仅对端要求不同标识时修改。

MegMeetMaster

变量地址: MC80/100/200/280/200E 使用 X/Y/M/SM/S/T/C/D/R,例如 X0D0.0R0s=2;D0。X 为八进制且只读。

包含 Modbus 主站的全部属性;无专属页面插件属性。PLC 系列对应的地址写法以变量地址规则为准。

Mc1E_AsciiMaster

变量地址: X/Y/M/F/V/B/D/W/TS/TC/TN/CS/CC/CN/S 等 1E 软元件,例如 D100M10X20

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

配置项现场说明
PLCID目标 PLC 编号,默认 0xFF;按 1E 网络规划填写。

Mc3E_AsciiMaster

变量地址: X/Y/M/S/L/F/V/B/SM/SB/DX/DY/TS/TC/SS/SC/CS/CC 位区及 D/SD/W/SW/R/Z/ZR/TN/SN/CN WORD 区,例如 D100.3

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

配置项现场说明
NetWorkIDMC 网络编号。
IOModuleStation目标模块站号。
IOModuleID目标模块 I/O 编号,默认 0x03FF
PLCID目标 PLC 编号,默认 0xFF

A3CMaster

变量地址: 位区 X/Y/M/S/L/F/V/B/SM/SB/DX/DY/TS/TC/SS/SC/CS/CC,WORD 区 D/SD/W/SW/R/Z/ZR/TN/SN/CN;可用 s=2;D100

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

配置项现场说明
Station默认站号;变量地址含 s= 时由变量配置覆盖。
SumCheck是否在请求和响应中使用累加和校验,必须与 PLC 一致。
Format选择 A3C 格式 1~4,必须与 PLC/CPU 通讯设置一致。

FxLinksMaster

变量地址: 位区 M/X/Y/S/TS/CS,WORD 区 D/R/TN/CN,例如 D100M35s=2;D100。X/Y 使用八进制。

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

配置项现场说明
Station默认目标站号。
WaitingTime报文等待时间,单位为 10 毫秒。
SumCheck是否启用累加和校验。
Format选择格式 1 或格式 4。

FxSerialMaster

变量地址: WORD 区 D/TN/CN,位区 M/S/X/Y/TS/TC/CS/CC,例如 D100X10。X/Y 使用八进制。

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

配置项现场说明
IsNewVersion是否使用新版命令前缀和内部地址映射;按 PLC 型号选择,读写失败时重点核对。

MitsubishiCipMaster

变量地址: 三菱 CIP Tag Name,例如 Motor.SpeedTank.Level[2]

包含采集重试、Foundation 通用读写和打包属性,并继承 Micro CIP 路由字段。

配置项现场说明
Slot目标控制器插槽号。
Backplane背板路由端口,默认 1

McR_BinaryMaster

变量地址: MC R 系列软元件;除普通 MC 区外支持 LST/LSC/LT/LTC/ST/SC 位区、LTN/STN WORD 区等,例如 LST10LTN10

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

配置项现场说明
NetWorkIDMC 网络编号。
IOModuleStation目标模块站号。
IOModuleID目标模块 I/O 编号,默认 0x03FF
PLCID目标 PLC 编号,默认 0xFF

NanjingDcsMaster

变量地址: 标准 Modbus 区地址,例如 40001s=2;40001.3。连接探测和六字节状态帧由插件自动处理。

包含 Modbus 主站的全部属性;无专属页面插件属性。连接探测和前置状态帧由插件自动处理。

OmronCipMaster

变量地址: Omron CIP Tag Name;数组局部访问使用 Tag[索引],例如 Tank.Level[2]

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

配置项现场说明
Slot目标控制器插槽号。
Backplane背板路由端口,默认 1

OmronConnectedCipMaster

变量地址: Omron 连接式 CIP Tag Name;数组局部访问使用 Tag[索引],例如 Tank.Level[2]

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

配置项现场说明
Slot目标控制器插槽号。
Backplane背板路由端口,默认 1
ConnectionTimeoutMultiplier连接无通信超时倍率,默认 2;链路延迟高时适当增大。

OmronHostLinkMaster

变量地址: D/CIO/C/W/H/A/E区号.地址/TIM/CNT,例如 D100CIO20E1.100TIM0;可用 s=2;D100

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

配置项现场说明
PLC 站号默认 PLC 站号。
信息控制字段Host Link ICF 字段,按网络路由要求填写。
目标单元地址目标 CPU 单元地址。
源单元地址网关使用的源单元地址。
服务标识请求服务标识,需与响应匹配。
响应等待字符协议响应等待时间字符,默认 0;仅设备明确要求时调整。

OmronHostLinkCModeMaster

变量地址: D/DM/C/CIO/LR/H/HR/A/AR/TIM/CNT/E区号.地址,例如 D100CNT20E1.100;可用 s=2;D100

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

配置项现场说明
PLC 站号默认 PLC 站号,必须与 Host Link C-Mode 设备一致。

PanasonicMcMaster

变量地址: 位区 X/Y/L/R/TS/CS/SM,WORD 区 DT/LD/TN/CN/SD,例如 R10.ADT100D100.3。WORD 位号为 .0..15

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

配置项现场说明
NetWorkIDMC 网络编号。
PLCID目标 PLC 编号,默认 0xFF
IOModuleID目标模块 I/O 编号,默认 0x03FF
IOModuleStation目标模块站号。

PanasonicMewtocolMaster

变量地址: 位区 X/Y/R/L 使用 WORD.十六进制位,T/C 使用接点号;WORD 区 DT/LD/F/T/C/K/SD/IX/IY/ID,例如 R10.AT100DT100

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

配置项现场说明
Station默认目标站号,默认 0xEE
MaxBitPack连续位读取单包最大点数,默认 400;设备不支持大包时调小。

SiemensFetchWriteMaster

变量地址: I/Q/M/DB/T/C,数值为十进制字节起点,例如 DB20.100M100.3。Boolean 必须显式使用 字节.位

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。PLC 站号和地址在变量地址中配置。

SiemensPpiMaster

变量地址: V/AI/AQ/T/C/SM/I/Q/M/DB,例如 M100DB1.DBW0s=2;M100

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

配置项现场说明
PLC 站号PPI 目标 PLC 站号,默认 2

ToyoPucMaster

变量地址: 基础/扩展程序区 K/V/T/C/L/X/Y/M/S/N/R/D/BEK/EV/ET/EC/EL/EX/EY/EM/ES/EN/EB/H/U/GX/GY/GM,例如 M10.Aprg=1;D100。数值使用十六进制。

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。CPU、站号和地址按变量地址规则填写。

XinJeInternalMaster

变量地址: 位区 X/Y/M/SM/T/C/CM/ET/HM/HS/HT/HC,WORD 区 D/SD/TD/CD/HD/FD/ETD/HTD/HCD/HSD/ID/QD,例如 X0D0s=2;D0。不支持 WORD 位地址。

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

配置项现场说明
默认站号变量地址未显式指定时使用,范围 1~247,默认 1

XinJeModbusMaster

变量地址: XC/XD/XL 混合软元件,例如 D0HD0X0D0.0s=2;D0。X/Y 使用八进制,地址区由 PLC 系列决定。

包含 Modbus 主站的全部属性。

配置项现场说明
PLC 系列选择 XC、XD、XL 等 PLC 系列,决定混合 Modbus 地址映射。

YaskawaMemobusMaster

变量地址: 位区 C/X;WORD 区 H/R/EH/EI/M/G/I/O/S,符号 WORD 位必须写 .位号,例如 M100.3。可用 to=2;from=1;H0 覆盖 CPU 路由。

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

配置项现场说明
目标 CPU 编号报文目标 CPU 编号,默认 2
源 CPU 编号网关使用的源 CPU 编号,默认 1
最大位打包数量单次连续位读取上限,默认 2000;设备或链路不稳定时调小。

YokogawaLinkMaster

变量地址: 位区 X/Y/I/E/M/T/C/L,WORD 区 D/B/F/R/V/Z/W/TN/CN,例如 Y100D100cpu=2;D100

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

配置项现场说明
默认 CPU 编号变量地址未指定 CPU 时使用,默认 1
最大位打包数量单次连续位读取上限,默认 256。

AiBusMaster

变量地址: 十进制参数代号 0255,可用 s=站号; 覆盖默认站号,例如 s=2;0

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

配置项现场说明
默认站号仪表站号,范围 0~80;变量地址含 s= 时由变量配置覆盖。

BarcodeIngressMaster

变量地址: barcode 取得条码正文,source 取得来源标识。该插件没有周期寄存器。

不显示采集公共属性,只提供来源过滤字段。

配置项现场说明
来源 IP只接受该远端 IP 上送的条码;留空接受当前通道上的全部来源。

Cjt188Master

变量地址: 两或三字节数据标识,例如 90-1F;可追加 s=14位地址域;,例如 s=12345678901234;90-1F

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

配置项现场说明
默认地址默认 14 位仪表地址,变量地址未指定表地址时使用。
仪表类型CJ/T 188 仪表类型字节,按水表、燃气表或热量表资料填写。
启用前导符开启后发送两个 FE 前导字节;对端不要求时关闭。
匹配响应地址开启后严格校验响应地址;存在代理转发或特殊表计时才考虑关闭。

Dam3601Master

变量地址: 标准 Modbus 地址,例如 40001s=2;40001。温度寄存器以设备点表为准。

包含 Modbus 主站的全部属性;无专属页面插件属性。站号和温度寄存器按设备点表配置。

Dlt698Master

变量地址: 四字节 OAD,例如 20-00-02-00;可追加 s=ca=sat=logic=,例如 s=149100007290;ca=0;20-00-02-00

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

配置项现场说明
服务器地址必填,填写 1~16 字节服务器地址的十六进制文本,不能留空。
客户机地址主站客户机地址,按表计安全和链路配置填写。
启用 FE 前导开启后每个请求前发送四个 FE 字节;对端不要求时关闭。
原生 TCP 生命周期TCP 客户端是否执行登录和应用连接流程;仅直连原生 DL/T 698 TCP 设备时开启。

Dtsu6606Master

变量地址: 标准 Modbus 地址,例如 40001s=2;40001。电参量寄存器以表计说明为准。

包含 Modbus 主站的全部属性;无专属页面插件属性。站号和电参量寄存器按表计说明配置。

EcFanMaster

变量地址: 固定字段 emergencyminimummaximum,分别读取应急模式、最低速度和最高速度。

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

配置项现场说明
风机站号风机地址,范围 1~30,默认 1

KeyenceDlen1Master

变量地址: 无通用周期寄存器地址。传感器命令、状态和 I/O 通过专用调试/动态方法执行。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。该插件以显式命令和 I/O 操作为主,不配置周期寄存器变量。

KeyenceSr2000Master

变量地址: 无通用周期寄存器地址。扫码、复位和锁定通过专用调试/动态方法执行。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。扫码、复位和锁定通过专用调试操作执行。

RkcMaster

变量地址: 两字符标签,例如 M1AAER;可用 s=2;M1 指定站号。

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

配置项现场说明
默认站号两位 ASCII 站号,范围 0~99;变量地址已指定站号时由变量配置覆盖。

SamCardMaster

变量地址: 无通用周期寄存器地址。模块检测、寻卡、选卡和读卡使用专用调试/动态方法。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。寻卡、选卡和读卡应通过显式操作执行。

ScaleStreamMaster

变量地址: weighttareunitnetpositiveoutofrangestableprinttenfoldvalidextendedtaretypesource

不显示采集公共属性,仅提供连续流校验和来源过滤字段。

配置项现场说明
启用校验字节是否要求回车符后附带校验字节,必须与电子秤输出格式一致。
来源 IP只接受该远端 IP 的数据;串口或不限制 TCP 来源时留空。

ShineInMaster

变量地址: Color/Light/LightDegree/WorkMode/Address/PulseWidth/Channel,可用 c=2;Light 覆盖 1~8 的读取通道。

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

配置项现场说明
默认通道变量地址未包含 c= 时使用,范围 1~8,默认 1

TurckRfidMaster

变量地址: 十进制标签字节位置,例如 08120;Boolean 使用 BYTE.位,例如 10.3,位号范围 0~7。

包含采集重试、Foundation 通用读写和打包属性;无专属页面插件属性。标签字节地址和长度在变量或专用操作中指定。

VibrationStreamMaster

变量地址: actual.x/y/zpeak.accelerationx/y/zpeak.speedx/y/zpeak.offsetx/y/zpeak.temperaturepeak.voltagepeak.intervaladdress

不显示采集公共属性,仅提供传感器寻址字段。

配置项现场说明
站号传感器站号,范围 1~65535,默认 1

DigitronCplMaster

变量地址: 十进制 WORD 位置,例如 010065520;可用 s=2;100 覆盖站号。不支持 Boolean 位地址。

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

配置项现场说明
默认站号请求默认站号,范围 0~255,默认 1

AbbWebApiMaster

变量地址: 固定 API 字段名,例如 CtrlStateErrorStatejointtargetrobtargetioiniooutServoEnableRapidExecutionRapidTasks

包含采集重试属性,不使用 Foundation 通讯字段。

配置项现场说明
机器人主机必填,只填主机名或 IP 地址,不包含协议、端口或路径。
Web API 端口范围 1~65535,HTTP 常用 80,HTTPS 常用 443。
使用 HTTPS启用后使用 HTTPS 连接,并同步核对服务端证书。
用户名HTTP 认证用户名;机器人未启用认证时留空。
密码与用户名配套;用户名留空时也应留空。
请求超时毫秒单次 HTTP 请求超时,范围 1~600000 毫秒。
允许无效服务端证书仅联调自签名证书时临时开启,生产环境应关闭。
最大响应字节数单次响应正文上限,范围 1 字节~16 MiB,默认 1 MiB。

EfortRobotMaster

变量地址: 无寄存器变量地址。使用“读取机器人状态”专用调试/动态方法。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。重点核对 TCP 通道、超时和发送节拍。

EstunRobotMaster

变量地址: 机器人 Modbus 寄存器映射,例如 40001。实际寄存器以 Estun 控制器点表为准。

包含 Modbus 主站的全部属性;无专属页面插件属性。机器人寄存器映射和控制状态按设备资料配置。

FanucCnc0iMaster

变量地址: PMC 字节区 G/F/Y/X/A/R/T/K/C/D/E,例如 R0D100。系统状态、报警、程序和目录通过专用方法读取。

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

配置项现场说明
操作路径多路径机床的操作路径,范围 1~32767,默认 1
文本编码报警、程序名和目录使用的编码,必填;按 CNC 语言环境填写,如 GB2312
最大 PMC 打包字节数单次周期采集 PMC 字节上限,范围 1~65535,默认 1024。
最大程序字节数单次程序上传或下载上限,范围 1 字节~256 MiB,默认 16 MiB。

FanucRobotInterfaceMaster

变量地址: WORD 区 D/AI/AQ/GI/GO/R1..R10/SR1..SR6,位区 I/Q/M/SDO/SDI/RDI/RDO/UI/UO/SI/SO,例如 D1R1M1UI1。地址从 1 开始。

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

配置项现场说明
客户端编号连接请求中的客户端编号,默认 1024;同一控制器上的客户端应避免冲突。
文本编码快照定长文本编码,默认 GB2312;中文或符号乱码时核对。
最大字区打包长度周期采集单次合并的最大 WORD 数,默认 6130。
最大位区打包长度周期采集单次合并的最大位数,默认 8192。

HyundaiTrackingMaster

变量地址: trackingsourcecommandstatecountxyzrxryrz,变量由 UDP 跟踪帧更新。

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

配置项现场说明
机器人来源 IP只允许该机器人 IP 建立 UDP 跟踪会话;留空接受任意来源。

KukaControllerTcpMaster

变量地址: KUKA 控制器变量名,例如 $POS_ACT;字符串必须追加长度和编码,例如 $PRO_NAME[];len=32;encoding=UTF-8

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。程序名和变量名在显式操作或变量地址中提供。

KukaVariableProxyMaster

变量地址: KUKA 变量代理名称,例如 $POS_ACT;字符串使用 $PRO_NAME[];len=32;encoding=UTF-8。每个变量独立请求。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。变量代理地址和程序控制参数在调用时提供。

OrientalMotorMaster

变量地址: inputinput[字节偏移]outputoutput[字节偏移],例如 inputoutput[4]。只有 output 可写。

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

配置项现场说明
Run/Idle 头输出数据报的四字节 Run/Idle 头,默认 1;按适配器装配参数设置。
RPI 时间双向循环 I/O 请求包间隔,范围 1~4294967 毫秒,默认 100 毫秒。
连接超时Forward Open 超时,范围 1~256 秒且必须为 2 的幂,默认 2 秒。

YamahaRcxMaster

变量地址: 无通用周期寄存器地址。状态和控制参数通过专用调试/动态方法读写。

包含采集重试和 Foundation 通用读写属性;无专属页面插件属性。响应超时和发送节拍使用公共字段,控制参数由专用操作提供。

Yrc1000Master

变量地址: 控制器状态字段由专用方法返回;无通用寄存器字符串。按设备属性选择六轴或七轴布局。

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

配置项现场说明
控制器类型选择六轴或七轴位置字段布局,必须与实际 Yaskawa 控制器型号一致。

YrcHighEthernetMaster

变量地址: 专用命令字段;处理分区 1 用于机器人控制,2 用于文件控制。无通用周期寄存器字符串。

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

配置项现场说明
处理分区1 为机器人控制,2 为文件控制;普通状态、I/O 和运动控制使用 1

Iec104Master

变量地址: ca=N;type=N;ioa=N,例如 ca=1;type=9;ioa=100。分别表示公共地址、信息体类型和信息体地址。

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

配置项现场说明
公共单元地址默认公共地址,范围 1~65534,必须与从站一致。
发送窗口 K未确认 I 帧发送窗口,范围 1~32767,默认 12。
接收确认阈值 W收到多少个 I 帧后发送 S 帧,范围 1~32767,默认 8,通常应小于 K。
确认延迟 T2未达到 W 时发送 S 帧的等待时间,单位毫秒,默认 10000。
空闲测试间隔 T3空闲链路发送 TESTFR 的间隔,单位毫秒,默认 20000。

KnxMaster

变量地址: KNX 组地址 主/中/子,例如 1/2/3;主组 0~31,中组 0~7,子组 0~255。

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

配置项现场说明
KeepAliveIntervalMilliseconds成功通信后再次校验 KNX/IP 隧道状态的间隔,单位毫秒,默认 60000。

OpenProtocolMaster

变量地址: mid=N;response=N;revision=N[;station=N;spindle=N]subscribe=N,例如 mid=10;response=11;revision=1subscribe=61

包含采集重试和 Foundation 通用读写属性,其中读写超时以“问答超时”显示。

配置项现场说明
登录修订号MID 0001 修订号,范围 0~999,默认 1
问答超时请求等待响应的时间,范围 1~65535 毫秒,默认 5000。
分片接收超时网络分片缓存等待时间,单位毫秒,默认 5000。
启用心跳是否周期发送 MID 9999;长期连接建议开启。
心跳间隔MID 9999 发送间隔,单位毫秒,默认 10000。
确认全部主动消息开启后忽略 No Ack Flag 并确认全部已映射主动消息;仅对端要求时开启。
自定义主动确认格式为 主动MID:确认MID,多项用逗号或分号分隔;无需额外映射时留空。

SecsSerialMaster

变量地址: s=N;f=N[;w][;SECS-II XML],例如 s=1;f=3;ws=6;f=11s=1;f=13;w;<List Length="0" />

包含采集重试和 Foundation 通用读写属性,其中主事务超时以 T3 语义使用。

配置项现场说明
设备标识SECS-I Device ID,必须与设备端一致。
字节间隔 T1同一块内相邻字节的最大等待时间,单位毫秒,默认 10000。
线路响应 T2ENQ/EOT/ACK/NAK 等线路响应等待时间,单位毫秒,默认 5000。
主事务 T3主事务回复等待时间,单位毫秒,默认 45000。
多块间隔 T4多块消息相邻块等待时间,单位毫秒,默认 10000。
NAK 重试次数收到 NAK 或块发送失败后的最大重试次数,默认 3。
碰撞优先方主机和设备同时发送 ENQ 时的优先方,必须与现场链路约定一致。

数据转发目标插件逐项核对

Modbus 从站(ModbusSlave

目标变量地址: 外部主站访问的 Modbus 地址,例如 400013000100001.0。同时配置数据类型,避免不同变量占用相同寄存器范围。

包含目标基础属性和通道型目标属性。

目标配置项现场说明
Modbus类型对外提供的 Modbus 协议形态,例如 TCP 或 RTU。
默认站号外部主站未指定或变量未覆盖时使用的从站地址。
数据解析顺序对外提供多字节数值时使用的字节序/字序。
字符串反转字节字符串字节顺序是否反转。
多站点模式是否允许多个站号。外部主站按不同站号访问时开启。
允许RPC写入目标级写入开关。关闭后外部 Modbus 主站不能反写网关变量。
立即写入内存收到写入后是否立即更新网关内存值。
发送延时时间回复发送前延时,单位毫秒。对方设备处理慢或链路需要间隔时设置。
客户端权限列表限制允许连接的客户端 IP 和写入权限;为空表示不限制。

变量属性:

变量配置项现场说明
从站变量地址该变量暴露给外部 Modbus 主站访问的地址。
数据类型对外显示的数据类型,需和外部主站解析方式一致。
允许RPC写入变量级写入开关。目标级和变量级都允许时才可写。

MQTT 客户端生产者(MqttClientProducer

目标变量映射: 使用 数据1数据10 和“允许RPC写入”,在 Topic 或 Payload 模板中引用;留空时使用默认变量实体。

包含目标基础属性、离线缓存属性、上传模板和脚本属性、MQTT 生产者公共属性。

目标配置项现场说明
IP地址MQTT Broker 地址。
SSL目标主机名证书校验使用的主机名。
客户端证书名称双向证书认证时选择客户端证书。
客户端IDMQTT ClientId,必须避免和其他客户端重复。
保活时间MQTT KeepAlive,单位秒。
清除会话是否清除会话。需要保留离线订阅或会话状态时关闭。
MQTT协议版本MQTT 协议版本,需和 Broker 支持情况一致。

变量属性包含通用目标变量字段 数据1数据10,并增加:

变量配置项现场说明
允许RPC写入允许外部 MQTT RPC 请求反写该变量。只有目标级、Topic 和脚本配置都正确时才生效。

MQTT 服务端生产者(MqttServerProducer

目标变量映射: 使用 数据1数据10 和“允许RPC写入”,在 Topic 或 Payload 模板中引用;留空时使用默认变量实体。

包含目标基础属性、离线缓存属性、上传模板和脚本属性、MQTT 生产者公共属性。

目标配置项现场说明
服务器证书名称网关作为 MQTT 服务端启用 SSL 时使用的证书。
允许连接ID前缀只允许指定 ClientId 前缀接入;为空表示不按前缀限制。

变量属性包含通用目标变量字段 数据1数据10,并增加:

变量配置项现场说明
允许RPC写入允许接入该 MQTT 服务端的外部客户端反写该变量。

ThingsBoard 客户端生产者(ThingsBoardClientProducer

目标变量映射: Topic 由 ThingsBoard 协议固定;变量属性主要配置外部名称和“允许RPC写入”。

包含目标基础属性和离线缓存属性。该目标按 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 服务端(OpcUaServer

目标变量地址: OPC UA NodeId/外部变量名,例如 ns=2;s=Line1/Temperature;同时配置数据类型和“允许RPC写入”。

包含目标基础属性。

目标配置项现场说明
服务地址默认 opc.tcp://127.0.0.1:48410。OPC UA 服务监听地址,多个地址用分号分隔。
名称标识OPC UA 服务端应用名称,客户端会看到该名称。
安全策略是否启用 OPC UA 安全策略。启用后证书和账号要同步配置。
允许证书登录是否发布 X509 用户证书登录策略。使用用户证书登录时开启。
客户端证书信任模式ManualTrustList 由管理员维护四个 issuer/trusted 库;SpecifiedCA 按指定 CA 校验客户端应用证书和用户证书。
受信客户端CASpecifiedCA 使用。选择后只信任该 CA 签发的客户端证书;留空时自动信任有效客户端证书。
允许RPC写入目标级写入开关。关闭后 OPC UA 客户端不能写网关变量。
历史数据目标稳定的历史数据目标名称。留空时不开放 OPC UA 历史数据读取。
历史报警目标支持历史报警查询的目标名称。留空时不开放 OPC UA 历史事件读取。
用户名OPC UA 客户端账号用户名。
密码OPC UA 客户端账号密码。
服务端证书名称OPC UA 服务端证书名称。
服务端签发CA服务端证书由 CA 签发时选择对应 CA,用于发送完整证书链。

证书库的实际维护步骤、五类证书库的读写范围和权限要求见设备调试手册

变量属性:

变量配置项现场说明
数据类型OPC UA 客户端看到的节点数据类型。类型不匹配会导致客户端写入或解析失败。
允许RPC写入变量级写入开关。目标级和变量级都允许时才可写。

Kafka 生产者(KafkaProducer

目标变量映射: 使用 数据1数据10 在 Topic、Key 或 Payload 模板中携带外部字段;留空时使用默认变量实体。

包含目标基础属性、离线缓存属性、上传模板和脚本属性。

目标配置项现场说明
服务地址Kafka Bootstrap Servers,通常为 主机:端口,多个 Broker 按 Kafka 约定填写。
发布超时时间单次发布等待时间,单位毫秒。
用户名SASL 认证用户名。未启用 SASL 时留空。
密码SASL 认证密码。未启用 SASL 时留空。
安全协议Kafka 安全协议,例如明文、SASL 或 SSL 组合,必须和集群一致。
SASL机制SASL 机制,例如 PlainScramSha256ScramSha512

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

RabbitMQ 生产者(RabbitMQProducer

目标变量映射: 使用 数据1数据10 在交换机、Routing Key 或 Payload 模板中携带外部字段;留空时使用默认变量实体。

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

目标配置项现场说明
IP地址RabbitMQ 服务地址。
端口RabbitMQ 端口,常见为 5672。
用户名RabbitMQ 认证用户名。
密码RabbitMQ 认证密码。
声明队列是否由网关自动声明队列。队列由平台统一创建时关闭。
声明交换机是否由网关自动声明交换机。账号无创建权限时关闭。
启用发布确认等待 Broker 发布确认。可靠性要求高时开启。
要求路由成功要求消息至少路由到一个队列。Routing Key 未命中时会按失败处理。
交换机类型RabbitMQ 交换机类型,例如 topicdirectfanout
发布超时时间发布等待时间,单位毫秒。
虚拟主机RabbitMQ Virtual Host,必须和账号权限一致。
交换机名称发布使用的交换机名称。

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

历史数据目标(HisDataForwardTarget

目标变量映射: 一般使用变量名和组内别名,无独立寄存器字符串;采样模式、死区等在目标变量属性中配置。

包含目标基础属性和离线缓存属性。

目标配置项现场说明
数据库类型历史数据写入的数据库类型。连接字符串必须与数据库类型匹配。
自定义SQL模式使用自定义 SQL 宽表写入。不了解目标表结构时保持关闭。
分表策略数据量大或保留周期长时用于按时间等策略拆表。
连接字符串数据库连接信息,包含服务器、端口、库名、账号、密码和加密策略。
数值历史表名数值变量写入的历史表名。
字符串历史表名字符串变量写入的历史表名。
变量信息表名当前目标变量静态配置的独立表名,默认 variableInfo。仅 SqlServer、MySql、Sqlite、PostgreSql 会创建和更新该表;QuestDB、TDengine 不创建。
保留天数历史数据保留周期。设置前评估追溯要求和磁盘容量。
历史表脚本自定义建表或写入脚本。只有对接已有表结构或特殊规则时使用。
时区偏移写入时间的时区偏移,例如 +08:00
强制插入收到数据即写入,不按采样策略减少记录量。点位多或周期短时会显著增加数据库压力。
默认采样策略未配置变量属性时使用。变化采样适合状态量,间隔采样适合趋势,条件采样适合按工况记录。
默认采样间隔默认采样策略为间隔时使用,单位毫秒。
默认条件表达式默认采样策略为条件时使用,表达式满足时才入库。
自定义模板配置自定义 SQL 宽表字段模板。字段名和数据类型必须与目标库一致。

历史目标在启动或重新初始化时,用当前转发范围中的变量更新独立变量信息表。该表保存变量、设备、通道、单位、类型和读写设置等静态信息,不保存每次采样值;变量或设备配置变更后,重新启用目标或重启 GatewayRuntime 可刷新这些信息。

变量属性:

变量配置项现场说明
采样策略该变量在当前历史目标中的入库方式。
采样间隔间隔采样时使用,单位毫秒。
条件表达式条件采样时使用,表达式满足才记录。

实时数据目标(RealDataForwardTarget

目标变量映射: 一般使用变量名和组内别名,无独立寄存器字符串;表名和字段结构由目标属性决定。

包含目标基础属性。

目标配置项现场说明
数据库类型实时数据写入的数据库类型。
连接字符串实时数据库连接信息,账号需具备建表、更新和写入权限。
实时表名保存变量最新值和静态变量信息的表名。首次初始化为当前目标范围中的全部变量建立完整记录,后续更新只写入实时字段。
实时表脚本自定义实时表结构或写入逻辑时使用。
时区偏移写入时间使用的时区。

实时目标不另建 variableInfo 表;变量、设备、通道、单位、类型和读写设置保存在实时表记录中。开启“过滤离线数据”后,后续离线变量的变化值不会写入,但首次初始化仍会保留离线变量的静态信息和当前状态。变量或设备配置变更后,重新启用目标或重启 GatewayRuntime,才能刷新实时表中的静态信息。

无目标变量属性。变量范围和触发方式由数据转发组决定。

历史报警目标(HisAlarmForwardTarget

目标变量映射: 该目标保存报警实体,无独立采集寄存器字符串;变量范围由数据转发组决定。

包含目标基础属性和离线缓存属性。

目标配置项现场说明
数据库类型历史报警写入的数据库类型。
分表策略报警量大或保留周期长时使用。
连接字符串历史报警数据库连接信息。
历史报警表名保存报警事件的表名。
保留天数历史报警保留周期。
历史报警表脚本自定义报警表结构或写入逻辑时使用。
时区偏移报警事件时间写入时使用的时区。
最小报警等级只保存该等级及以上报警。需要完整追溯时保持较低等级。

无目标变量属性。报警是否写入由转发组范围、报警状态和最小报警等级共同决定。

Webhook(Webhook

目标变量映射: 使用 数据1数据10 在 URL 或 Payload 模板中携带外部字段;留空时使用默认变量实体。

包含目标基础属性、离线缓存属性、上传模板和脚本属性。变量 Topic 模板在 Webhook 中作为最终请求 URL 使用。

目标配置项现场说明
签名密钥钉钉机器人加签 Secret。企业微信、飞书或普通 HTTP 接口不需要时留空。
自定义请求头JSON 格式请求头,例如 {"Authorization":"Bearer token"}。格式错误会导致请求失败。
消息格式Raw 直接发送 JSON 或模板内容;Text/Markdown 适配机器人消息格式。
请求超时(秒)HTTP 请求等待时间,单位秒。接口慢时可增加,过大会拖慢失败重试。

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

SyncBridge(SyncBridge

目标变量映射: 一般使用变量 ID、变量名和组内别名进行同步,无独立寄存器字符串。

包含目标基础属性。该目标用于一个 Hub 汇聚多个 Edge 的配置和实时变量值。

目标配置项现场说明
Role选择 HubServerEdgePublisher
LocalPeerId当前节点稳定且唯一的身份。
ListenUri / RemoteUriHub 的监听地址 / Edge 连接的 Hub 地址。
VerifyTokenTLS 后的第二层握手密钥,不能使用公开默认值。
TransportCertificateName / TransportCaCertificateName当前节点证书和验证对端证书的私有 CA。
TransportTargetHostEdge 校验 Hub 证书使用的主机名。
TransportSslProtocols / CheckCertificateRevocationTLS 协议和证书吊销检查。
HeartbeatIntervalMs认证心跳周期,默认 5000 毫秒。
RealtimeFlushIntervalMs / RealtimeAckTimeoutMs实时值合并窗口和应用确认超时。
MaxRealtimeBatchVariables / MaxRealtimeBatchBytes单个实时批次上限。
MaxConfigChunkBytes单个配置块字节上限。
ConfigSyncModeEdge 在重连和范围变化时的自动同步策略。
MaxConcurrentConfigurationSyncPeersHub 请求多个 Edge 配置时的并发上限。
AllowRemoteRpc桥级反向写入总开关。

无目标变量属性。同步范围由数据转发组变量范围决定,完整操作参见 SyncBridge 网关同步

IEC104 从站(IEC104Slave

目标变量地址: 在变量属性的 StartAddress 填十进制信息体地址,例如 100;公共地址使用目标属性 Station,信息体类型使用变量属性 DataType,不要把三项拼成主站地址字符串。

包含目标基础属性和通道型目标属性。

目标配置项现场说明
IsWithTimeInfo是否带时标信息。对方主站要求遥测/遥信带时标时开启。
StationIEC104 公共地址/站号,必须与主站配置一致。
DeviceRpcEnable目标级写入开关,控制主站是否允许反写。
SendDelayTime发送延迟时间,单位毫秒。链路需要报文间隔时设置。

变量属性:

变量配置项现场说明
StartAddressIEC104 信息体起始地址。
DataTypeIEC104 数据类型,例如遥测、遥信等,必须和主站点表一致。
VariableRpcEnable变量级写入开关。目标级和变量级都允许时才可写。

IEC 61850 服务端(IEC61850Server

目标变量地址: LD/LN.DO.DA;FC=XX,例如 LD0/LLN0.GGIO1.Ind1.stVal;FC=ST;对象引用通常由模型导入生成。

包含目标基础属性。

目标配置项现场说明
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 生产者(ZeroMQProducer

目标变量映射: 使用 数据1数据10 在主题或 Payload 模板中携带外部字段;留空时使用默认变量实体。

包含目标基础属性、离线缓存属性、上传模板和脚本属性。

目标配置项现场说明
连接地址ZeroMQ 地址,例如 tcp://127.0.0.1:5555
Socket类型ZeroMQ Socket 类型,默认发布模式。
绑定模式true 表示 Bind 作为服务端;false 表示 Connect 作为客户端。
高水位标记ZeroMQ 队列缓存上限,数据积压超过后可能阻塞或丢弃。

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