跳到主要内容

插件手册

插件手册只说明当前插件特有的参数、地址或模板、变量属性、专用调试页和排障方法。通道、设备、公共变量、转发组、触发、缓存、冗余和启停等通用操作分别见采集配置数据转发

全部采集插件和数据转发插件都列在左侧“插件”菜单下。采集插件按“通用协议与行业标准、PLC 与控制器、机器人与运动控制、仪表/传感器与设备接入、网关与消息接入”分组;知道插件名称时,也可以直接使用右上角搜索。

按任务选择

你的任务选择的插件类型配置入口
从 PLC、仪表、机器人或现场协议读取数据采集插件开发配置 → 采集配置
订阅 MQTT、OPC UA 等服务端数据采集插件开发配置 → 采集配置
把数据发布到 MQTT、Kafka、RabbitMQ、ZeroMQ 或 Web 服务数据转发插件开发配置 → 数据转发
把实时值、历史值或历史报警写入数据库数据转发插件开发配置 → 数据转发
对外提供 Modbus、OPC UA、IEC104 或 IEC61850 服务数据转发插件开发配置 → 数据转发
在 ThingsGateway 节点之间同步数据数据转发插件开发配置 → 数据转发

同一协议可能同时有采集端和服务端插件。例如“Modbus 主站”用于读取设备,“Modbus 服务端”用于向外部系统提供数据。先根据数据流向选择插件类型。

常用采集入口

协议或设备手册入口重点内容
ModbusModbus 主站TCP、RTU、ASCII,寄存器地址和功能码。
Siemens S7Siemens S7PLC 型号、机架槽位和 DB 地址。
OPC UAOPC UA 客户端端点、安全策略、证书和节点。
OPC DAOPC DA 客户端Windows OPC DA 服务和 Item。
MQTTMQTT 采集客户端Broker、Topic、消息解析和变量映射。
Gateway MQTTGateway MQTT 采集客户端ThingsGateway 节点间 MQTT 采集。
IEC104IEC104 主站总召、遥信、遥测、时钟同步和遥控。
IEC61850IEC61850 客户端MMS、RCB、GOOSE 和 SOE。
自定义报文自定义完整报文请求报文、响应解析和专用调试。

其它 PLC、机器人、仪表、扫码器和行业协议请从左侧“采集插件”菜单展开对应设备类别查找。

数据转发插件

数据库存储

插件用途
实时数据存储保存每个变量的最新值。
历史数据存储按变化、定时或条件采样保存历史值。
历史报警存储保存达到指定等级的报警产生和恢复记录。

协议服务

插件用途
Modbus 服务端通过 Modbus TCP、RTU 或 ASCII 提供变量。
OPC UA 服务端通过 OPC UA 节点提供变量、写入和历史查询。
IEC104 服务端提供遥信、遥测、总召和遥控。
IEC61850 服务端提供 MMS 模型、报告、GOOSE 和控制。

消息与 Web 转发

插件用途
MQTT 客户端转发连接外部 Broker 并发布网关数据。
MQTT 服务端转发通过内置 MQTT Server 发布网关数据。
Kafka 生产者发布到 Apache Kafka。
RabbitMQ 生产者发布到 RabbitMQ。
ZeroMQ 生产者通过 ZeroMQ Socket 发布数据。
Webhook通过 HTTP 请求发送到 Web 服务。
ThingsBoard MQTT发送遥测、属性并处理 ThingsBoard RPC。

网关集成

插件用途
同步桥接在 Hub 与 Edge 节点间同步配置和实时变量。

全部插件清单

下表列出当前文档站收录的全部插件手册,按插件类型分组。授权范围用于购买前确认:标准版软件包含标准版插件,专业版插件需要专业版授权。

采集驱动

插件授权范围厂商/生态注释手册
自定义完整报文标准版thingsgateway通过自定义完整报文实现设备请求与响应解析自定义完整报文
DL/T 645-1997标准版cn-industry-standardsDL/T 645-1997 电能表通信协议采集驱动DL/T 645-1997
DL/T 645-2007标准版cn-industry-standardsDL/T 645-2007 多功能电能表通信协议采集驱动DL/T 645-2007
Gateway MQTT 采集服务端标准版thingsgateway作为 MQTT 服务端接收 ThingsGateway 网关数据Gateway MQTT 采集服务端
Gateway MQTT 采集客户端标准版thingsgateway作为 MQTT 客户端接入 ThingsGateway 网关数据Gateway MQTT 采集客户端
Modbus 主站标准版modbusModbus TCP、RTU 和 ASCII 主站采集驱动Modbus 主站
MQTT 采集服务端标准版mqtt作为 MQTT Server 接收客户端上报数据MQTT 采集服务端
MQTT 采集客户端标准版mqtt通过 MQTT Client 订阅并采集消息数据MQTT 采集客户端
OPC DA 客户端标准版opc-foundation连接 Windows OPC DA 服务端的采集驱动OPC DA 客户端
OPC UA 客户端标准版opc-foundation连接 OPC UA 服务端的采集驱动OPC UA 客户端
OpcAeMaster标准版opc-foundationWindows OPC AE 事件订阅、条件接收和变量映射驱动OpcAeMaster
Siemens S7标准版siemensSiemens S7 系列 PLC 采集驱动Siemens S7
A3CMaster专业版mitsubishi三菱 A3C 串行协议地址读写、状态和控制驱动A3CMaster
AbbWebApiMaster专业版abb通过 ABB Robot Web Services 读取机器人状态、I/O、关节和日志AbbWebApiMaster
AI-BUS专业版yudianAI-BUS 仪表协议采集驱动AI-BUS
BarcodeIngressMaster专业版barcode-ingress接收扫码器主动 TCP 连接并将连续条码映射为变量BarcodeIngressMaster
BeckhoffAdsMaster专业版beckhoffBeckhoff ADS 符号变量和地址变量读写驱动BeckhoffAdsMaster
CanMaster专业版canCAN 与 CAN FD 帧收发、过滤和变量映射驱动CanMaster
CimonHmiMaster专业版cimonCIMON HMI Ethernet 协议变量读写驱动CimonHmiMaster
CJ/T 188专业版cn-industry-standardsCJ/T 188 城镇建设行业计量协议采集驱动CJ/T 188
ControlLogixMaster专业版allen-bradleyAllen-Bradley ControlLogix EtherNet/IP 标签读写驱动ControlLogixMaster
Dam3601Master专业版dam-3601DAM3601 温度输入模块寄存器采集与温度快照驱动Dam3601Master
DCONMaster专业版dconDCON ASCII 工业 I/O 模块地址读写驱动DCONMaster
DeltaMaster专业版deltaDelta DVP 与 AS 系列 PLC 地址读写驱动DeltaMaster
Df1Master专业版allen-bradleyAllen-Bradley DF1 串行文件表读写驱动Df1Master
DigitronCplMaster专业版yamatakeAzbil Yamatake Digitron CPL 仪表地址读写驱动DigitronCplMaster
Dlt698Master专业版cn-industry-standardsDL/T 698 电能信息采集、主动上报和链路管理驱动Dlt698Master
Dtsu6606Master专业版dtsu6606DTSU6606 电能表寄存器采集与电参量快照驱动Dtsu6606Master
EcFanMaster专业版ec-fanEC 风机转速读取、站号配置和显式控制驱动EcFanMaster
EDPF_NTMaster专业版edpf-ntEDPF-NT UDP 主动上报接收和变量映射驱动EDPF_NTMaster
EfortRobotMaster专业版efortEfort 机器人运行状态和位姿快照采集驱动EfortRobotMaster
EstunRobotMaster专业版estunEstun 机器人状态、寄存器和程序控制驱动EstunRobotMaster
FanucCnc0iMaster专业版fanucFANUC CNC 0i 状态、PMC、宏变量和程序传输驱动FanucCnc0iMaster
FanucRobotInterfaceMaster专业版fanucFANUC Robot Interface 位、字、位姿和任务状态采集驱动FanucRobotInterfaceMaster
FatekProgramMaster专业版fatekFatek PLC 编程口寄存器读写与运行控制驱动FatekProgramMaster
FujiCommandMaster专业版fujiFuji Command Setting 协议 PLC 地址读写驱动FujiCommandMaster
FujiSpbMaster专业版fujiFuji SPB 协议 PLC 地址读写驱动FujiSpbMaster
FujiSphMaster专业版fujiFuji SPH Ethernet PLC 地址读写和 CPU 控制驱动FujiSphMaster
FxLinksMaster专业版mitsubishi三菱 FX Links 串行协议地址读写和 PLC 控制驱动FxLinksMaster
FxSerialMaster专业版mitsubishi三菱 FX 编程口串行协议地址读写和 PLC 控制驱动FxSerialMaster
GeSrtpMaster专业版geGE SRTP PLC 地址读写、状态和时钟诊断驱动GeSrtpMaster
HJ212Master专业版cn-industry-standardsHJ 212 污染物在线监控数据接收和变量映射驱动HJ212Master
HyundaiTrackingMaster专业版hyundaiHyundai 机器人 UDP 跟踪状态和位置增量控制驱动HyundaiTrackingMaster
IEC 61850 托管主站专业版iec61850复用标准 TCP/TLS 通道的纯托管 IEC 61850 MMS 读写和报告驱动IEC 61850 托管主站
Iec104Master专业版iec104IEC 60870-5-104 主站总召唤、遥测接收、时钟同步和遥控驱动Iec104Master
InovanceComputerLinkMaster专业版inovance汇川 Computer Link PLC 地址读写、状态和启停控制驱动InovanceComputerLinkMaster
InovanceConnectedCipMaster专业版inovance汇川连接式 EtherNet/IP CIP 标签读写驱动InovanceConnectedCipMaster
InovanceEasyNetMaster专业版inovance汇川 EasyNet PLC 地址读写驱动InovanceEasyNetMaster
InovanceMaster专业版inovance汇川 PLC Modbus 与专用地址模型采集驱动InovanceMaster
KELID2008Master专业版kelid-2008KELID2008 UDP 主动上报接收和变量映射驱动KELID2008Master
KeyenceDlen1Master专业版keyenceKEYENCE DL-EN1 传感器命令、状态和 I/O 操作驱动KeyenceDlen1Master
KeyenceKvOldMaster专业版keyenceKEYENCE 旧型 KV PLC 地址读写驱动KeyenceKvOldMaster
KeyenceMcAsciiMaster专业版keyenceKEYENCE MC 兼容 3E ASCII 地址读写驱动KeyenceMcAsciiMaster
KeyenceMcBinaryMaster专业版keyenceKEYENCE MC 兼容 3E 二进制地址读写驱动KeyenceMcBinaryMaster
KeyenceNanoMaster专业版keyenceKEYENCE KV Nano Upper Link 地址读写和状态诊断驱动KeyenceNanoMaster
KeyenceSr2000Master专业版keyenceKEYENCE SR-2000 扫码、状态、复位和锁定控制驱动KeyenceSr2000Master
KnxMaster专业版knxKNXnet/IP 隧道组地址读写驱动KnxMaster
KukaControllerTcpMaster专业版kukaKUKA 控制器 TCP 变量读写和程序控制驱动KukaControllerTcpMaster
KukaVariableProxyMaster专业版kukaKUKA KRC4 变量代理读写和程序控制驱动KukaVariableProxyMaster
LKSISMaster专业版lksisLKSIS UDP 主动上报接收和变量映射驱动LKSISMaster
LogixCipMaster专业版allen-bradleyAllen-Bradley Logix EtherNet/IP 标签读写驱动LogixCipMaster
LsisMaster专业版lsisLSIS Cnet 与 Fast Ethernet PLC 地址读写驱动LsisMaster
Mc1E_AsciiMaster专业版mitsubishi三菱 MC 1E ASCII 协议 PLC 地址读写驱动Mc1E_AsciiMaster
Mc1E_BinaryMaster专业版mitsubishi三菱 MC 1E 二进制协议 PLC 地址读写驱动Mc1E_BinaryMaster
Mc3E_AsciiMaster专业版mitsubishi三菱 MC 3E ASCII 协议 PLC 地址读写驱动Mc3E_AsciiMaster
Mc3E_BinaryMaster专业版mitsubishi三菱 MC 3E 二进制协议 PLC 地址读写驱动Mc3E_BinaryMaster
McR_BinaryMaster专业版mitsubishi三菱 iQ-R MC 二进制协议 PLC 地址读写驱动McR_BinaryMaster
MegMeetMaster专业版megmeet麦格米特 MC 系列 PLC 地址读写驱动MegMeetMaster
MicroCipMaster专业版allen-bradleyAllen-Bradley Micro 系列 EtherNet/IP 标签读写驱动MicroCipMaster
MitsubishiCipMaster专业版mitsubishi三菱 EtherNet/IP CIP 标签读写驱动MitsubishiCipMaster
ModbusC1Master专业版modbusModbus C1 扩展协议主站地址读写驱动ModbusC1Master
ModbusC20Master专业版modbusModbus C20 扩展协议主站地址读写和专用调试驱动ModbusC20Master
NanjingDcsMaster专业版nanjing-dcs带连接探测和前置状态帧的南京 DCS Modbus TCP 采集驱动NanjingDcsMaster
OmronCipMaster专业版omronOmron 非连接式 EtherNet/IP CIP 标签读写驱动OmronCipMaster
OmronConnectedCipMaster专业版omronOmron 连接式 EtherNet/IP CIP 标签读写驱动OmronConnectedCipMaster
OmronFinsMaster专业版omronOmron FINS TCP、UDP 和串行地址读写驱动OmronFinsMaster
OmronHostLinkCModeMaster专业版omronOmron Host Link C-Mode 地址读写和 PLC 状态诊断驱动OmronHostLinkCModeMaster
OmronHostLinkMaster专业版omronOmron Host Link 串行协议地址读写驱动OmronHostLinkMaster
OpenProtocolMaster专业版open-protocolAtlas Copco Open Protocol 拧紧结果、命令和主动消息驱动OpenProtocolMaster
OrientalMotorMaster专业版oriental-motorOriental Motor EtherNet/IP 循环 I/O 镜像读写驱动OrientalMotorMaster
PanasonicMcMaster专业版panasonicPanasonic QnA 兼容 MC 3E PLC 地址读写驱动PanasonicMcMaster
PanasonicMewtocolMaster专业版panasonicPanasonic Mewtocol PLC 地址读写和状态诊断驱动PanasonicMewtocolMaster
PCCCMaster专业版allen-bradleyAllen-Bradley PCCC 文件表地址读写驱动PCCCMaster
RKC 温控器专业版rkcRKC CD 和 CH 系列温控器采集驱动RKC 温控器
SamCardMaster专业版sam-card居民身份证安全模块寻卡、选卡和显式读卡驱动SamCardMaster
ScaleStreamMaster专业版scale-stream接收电子秤串口或反向 TCP 连续输出并映射变量ScaleStreamMaster
SECSMaster专业版semiSECS/GEM HSMS 消息收发、事务处理和设备主动消息驱动SECSMaster
SecsSerialMaster专业版semiSECS-I 半双工事务、多块重组和设备主动消息驱动SecsSerialMaster
ShineIn 光源控制器专业版shinein机器视觉光源控制器采集驱动ShineIn 光源控制器
SiemensFetchWriteMaster专业版siemensSiemens Fetch/Write 协议 PLC 地址读写驱动SiemensFetchWriteMaster
SiemensPpiMaster专业版siemensSiemens S7-200 PPI 串行协议地址读写驱动SiemensPpiMaster
SlcEthernetMaster专业版allen-bradleyAllen-Bradley SLC Ethernet 文件表读写驱动SlcEthernetMaster
TIANXINMaster专业版tianxinTIANXIN 仪表协议地址读写驱动TIANXINMaster
ToyoPucMaster专业版toyo-pucToyo PUC 计算机链接地址读写、状态和命令驱动ToyoPucMaster
TS550Master专业版ts550TS550 工业设备地址读写驱动TS550Master
TurckRfidMaster专业版turckTurck RFID 标签内存读取、写入和专用调试驱动TurckRfidMaster
USBScaner专业版usb-scanner本地 USB 扫码器输入监听和变量更新驱动USBScaner
VibrationStreamMaster专业版vibration-stream接收振动传感器实时值和峰值上报并映射变量VibrationStreamMaster
VigorMaster专业版vigor丰炜 PLC 地址读写驱动VigorMaster
XinJeInternalMaster专业版xinje信捷 PLC 内部 TCP 协议二十四位地址读写驱动XinJeInternalMaster
XinJeModbusMaster专业版xinje信捷 XC、XD 和 XL 系列混合 Modbus 地址读写驱动XinJeModbusMaster
YamahaRcxMaster专业版yamahaYamaha RCX 多行命令、机器人状态和运动控制驱动YamahaRcxMaster
YaskawaMemobusMaster专业版yaskawaYaskawa Memobus TCP 与 UDP 地址读写和专用诊断驱动YaskawaMemobusMaster
YokogawaLinkMaster专业版yokogawaYokogawa Link PLC 地址读写、状态、时钟和模块控制驱动YokogawaLinkMaster
Yrc1000Master专业版yaskawaYaskawa YRC1000 文本协议状态、程序、伺服和运动控制驱动Yrc1000Master
YrcHighEthernetMaster专业版yaskawaYaskawa High Speed Ethernet 二进制 UDP 状态、I/O 和运动控制驱动YrcHighEthernetMaster
ZeroMQCollectClient专业版zeromqZeroMQ 订阅接收、主题过滤和变量映射采集驱动ZeroMQCollectClient

数据转发插件

插件授权范围厂商/生态注释手册
历史报警存储标准版thingsgateway将历史报警记录写入配置的数据库历史报警存储
历史数据存储标准版thingsgateway将变量历史数据写入配置的数据库历史数据存储
实时数据存储标准版thingsgateway将变量实时数据写入配置的数据库实时数据存储
同步桥接标准版thingsgateway在 ThingsGateway Hub 和 Agent 之间同步运行数据同步桥接
Kafka 生产者标准版apache-kafka将网关数据发布到 Apache KafkaKafka 生产者
Modbus 服务端标准版modbus通过 Modbus Server 或从站对外提供网关数据Modbus 服务端
MQTT 服务端转发标准版mqtt通过内置 MQTT Server 对外发布网关数据MQTT 服务端转发
MQTT 客户端转发标准版mqtt作为 MQTT Client 发布网关数据MQTT 客户端转发
OPC UA 服务端标准版opc-foundation通过 OPC UA Server 对外提供网关数据OPC UA 服务端
RabbitMQ 生产者标准版rabbitmq将网关数据发布到 RabbitMQRabbitMQ 生产者
ThingsBoard MQTT标准版thingsboard通过 MQTT 将网关数据转发到 ThingsBoardThingsBoard MQTT
Webhook标准版generic-web通过 HTTP Webhook 将网关数据发送到通用 Web 服务Webhook
IEC 61850 托管服务端专业版iec61850复用标准 TCP/TLS 服务通道的纯托管 IEC 61850 数据转发服务端IEC 61850 托管服务端
IEC104Slave专业版iec104IEC 60870-5-104 服务端点表、总召唤、主动上送和控制回写目标IEC104Slave
ZeroMQProducer专业版zeromq通过 ZeroMQ 发布变量、设备、报警和插件事件的数据转发目标ZeroMQProducer

使用方法

  1. 先看“插件用途”和“选择入口”,确认数据流向正确。
  2. 按“插件参数”配置当前插件特有字段。
  3. 需要变量级映射时,再配置“目标变量属性”或地址规则。
  4. 保存并启用对象后,进入“设备调试”或“目标调试”查看专用面板。
  5. 按专题的操作步骤完成一次读取、发布或写库,并在对应结果页核对数值。

涉及写入、RPC、遥控、启停、复位、运动或原始报文的操作,必须使用测试点并遵守现场安全规程。

找不到插件

  1. 进入“开发配置 → 插件管理”,清空搜索和厂商筛选。
  2. 按协议缩写、厂商或插件名称搜索。
  3. 确认插件已启用,并检查授权、平台和 AOT 限制。
  4. 安装或更新插件后执行“同步插件”,再回到配置页重新选择。