跳到正文
MasterKontact

产品

MasterGateway,一个程序包含全部协议;十个独立程序,每种协议一个;以及免费的 MasterGateway Diagnostica。全部只读。

MasterGateway:一个程序包含全部协议

  • Windows
  • Linux
  • 终端

一个程序包含十种协议(BACnet、SNMP、Modbus、OPC UA、OPC DA(仅限 Windows)、IEC 60870-5-104、DLMS/COSEM、PROFINET DCP、PROFINET IO 和 PROFINET RT),集中在一个窗口中,另附命令行程序 masterkontact-cli。

  • 顶部是协议列表:点击即可打开该协议的页面,彩色圆点表示其连接状态。可以同时使用多个协议,并在它们之间切换而不会丢失任何内容。
  • 每种协议都具有对应独立程序的相同功能(详见下文)。
  • 硬件页面是顶部栏中的最后一页:网络(适配器、地址、流量、错误)、串口(从不打开)、计算机和进程;复制会将报告放入剪贴板。始终可用,演示模式下也可用,且不计入许可证。
  • 许可证与计算机名称和电脑代码绑定(只更换一个部件时仍然有效),包含已启用的协议和每种协议的最大变量数(许可证)。
  • 面向监控系统的提示:许可证无效或到期,或演示模式结束时,会在 Windows 事件查看器中写入事件,在 Linux 中则写入 syslog(详情)。

masterkontact-cli

可在 Windows 或 Linux 的任何终端中使用相同的只读功能,包括没有图形桌面的服务器:许可证、演示模式和配置文件都与窗口相同。对每种协议:连接、搜索和浏览、单次读取,以及持续监视,在终端中不断更新数值、质量和时间,直到按下 Ctrl+C。结果输出到标准输出,并为脚本提供有文档说明的退出代码。

在所有语言中,命令和选项都是意大利语单词(aiuto、licenza、leggi、monitora…);消息以所选语言显示(--lang zh)。

masterkontact-cli aiuto
masterkontact-cli licenza
masterkontact-cli modbus leggi --host 192.168.1.50 --indirizzo 0 --tipo float32 --quanti 4 --demo
masterkontact-cli snmp monitora Switch --durata 60
masterkontact-cli dlms esplora --host 192.168.1.30 --demo
masterkontact-cli hardware
各协议的命令(masterkontact-cli aiuto <协议>)
协议命令
bacnetprofilo, proprieta, connetti, cerca, esplora, leggi, monitora
snmpprofilo, oid, mib, connetti, cerca, leggi, esplora, tabella, monitora, trap
modbusprofilo, tag, connetti, cerca, leggi, monitora
opcuaprofilo, nodi, endpoint, connetti, esplora, cerca, leggi, monitora, certificati
opcda(仅限 Windows)profilo, item, server, connetti, esplora, proprieta, leggi, monitora
iec104profilo, punti, connetti, esplora, leggi, monitora, trame
dlmsprofilo, oggetti, connetti, esplora, leggi, monitora, curva, trame
pndcpprofilo, attributi, schede, cerca, leggi, monitora, trame
pnioprofilo, campi, connetti, moduli, leggi, diagnosi, porte, registro, monitora, trame
pnrtprofilo, variabili, schede, flussi, allarmi, vicini, anello, monitora, trame

无许可证时,各协议的命令可配合 --demo 使用(与窗口相同的 10 分钟)。masterkontact-cli hardware 会显示“硬件”页面,无许可证时也可使用。masterkontact-cli aiuto codici 会显示退出代码。在 Windows 上,安装程序会将 masterkontact-cli 添加到 PATH;在 Linux 上,install.sh 会在 ~/.local/bin 或 /usr/local/bin 中创建该命令。

MasterGateway Diagnostica

  • Windows
  • Linux
  • 终端
  • 免费

免费的、无需许可证的应用程序,用于连接诊断。它从不读取现场数据。

  • MasterGateway:此电脑上已打开的 MasterGateway 及其连接的实时状态:目标、状态、响应时间、请求数、超时数、错误数、重新连接次数和最近一次错误。从不显示变量的数值。
  • 对某个名称或地址的连接测试:DNS、ping,以及带时间和丢包数的重复 TCP 连接;对 BACnet 为一次 Who-Is,对 SNMP 仅读取 sysUpTime。预设端口:Modbus TCP 502、OPC UA 4840、IEC 104 2404、DLMS 4059、BACnet 47808、SNMP 161、DCOM 135。每次测试只针对一个目标和一个端口,并设有防止扫描的限制。
  • 网络和串口:与 MasterGateway 的“硬件”页面相同的信息。
  • Windows 和 Linux 上的窗口(masterkontact-diagnostica),以及用于终端的命令 masterkontact-diag。

作为单独的程序安装,通常与 MasterGateway 一起安装。在 MasterGateway 中,“硬件”页面上的允许 MasterGateway Diagnostica 访问复选框用于允许或禁止此访问,且仅限同一台电脑和同一用户。

独立程序

每种协议一个程序,有自己的窗口和自己的许可证,与电脑代码绑定。

程序协议系统Linux 命令
Master Protocols (BACnet)BACnet/IP 和 MS/TPWindows, Linuxbacnet-client
Master Protocols (SNMP)SNMP v1、v2c 和 v3Windows, Linuxsnmp-manager
Master Protocols (Modbus)Modbus TCP、RTU 和 ASCIIWindows, Linuxmodbus-master
Master Protocols (OPC UA)OPC UAWindows, Linuxopcua-viewer
Master Protocols (OPC DA)OPC DA 2.0 和 3.0仅限 Windows—
Master Protocols (IEC 60870-5-104)IEC 60870-5-104Windows, Linuxiec104-client
Master Protocols (DLMS/COSEM)DLMS/COSEM (IEC 62056)Windows, Linuxdlms-client
Master Protocols (PROFINET DCP)PROFINET DCPWindows, Linuxprofinet-dcp-client
Master Protocols (PROFINET IO)PROFINET IOWindows, Linuxprofinet-io-client
Master Protocols (PROFINET RT)PROFINET RTWindows, Linuxprofinet-rt-monitor

MasterGateway 还是独立程序

MasterGateway独立程序
协议十种协议集中在一个窗口中(OPC DA 仅限 Windows)每个程序一种
命令行masterkontact-cli—
“硬件”页面和 MasterGateway Diagnostica有—
许可证绑定到计算机名称和电脑代码电脑代码
许可证包含协议、每种协议的最大变量数、有效期和最高版本有效期(永久或有到期日期)
无许可证时10 分钟演示模式10 分钟免费试用
面向监控系统的许可证事件Windows 事件查看器或 syslog—

所有程序共有的功能

  • 只读:程序不包含对设备的写入或控制命令。
  • 保存的连接配置文件。
  • 监视列表,显示每一行的数值、状态和时间;可对选中的行暂停和恢复(在 DLMS 中,恢复称为继续)。
  • 没有响应的项会降低重新读取的频率,而不会拖慢其余项。
  • 数值导出、连续记录,以及以 CSV 导入和导出列表(需要许可证)。
  • 自动重新连接,并始终显示连接状态。
  • 事件日志和用于技术支持的下载日志…(需要许可证)。
  • 内置帮助(F1),界面支持西班牙语、英语、德语、意大利语和中文。
  • 可执行文件一应俱全:无需安装 .NET。

BACnet

  • MasterGateway
  • Master Protocols — 兼容 BACnet
  • Windows
  • Linux

只读的 BACnet 客户端,支持 BACnet/IP(也可通过 BBMD)和 MS/TP。

  • UDP 47808 上的 BACnet/IP(端口可配置),并可在 BBMD 中注册为 Foreign Device,以访问其他子网。
  • RS-485 上的 MS/TP:串口、速率、客户端 MAC 和 Max Master。
  • 通过 Who-Is/I-Am 发现设备,并可按地址添加;支持路由器后的设备、分段响应、旧设备或不支持 ReadPropertyMultiple 的设备。
  • 设备 → 类型 → 对象和属性的树形结构,格式易读:单位、Status_Flags、Priority_Array、State_Text 等。
  • 按名称或标识符搜索(例如 AI 3)。
  • 设备支持时使用 SubscribeCOV 监视,否则采用轮询。
  • 从不使用 WriteProperty 或其他写入或控制服务。

MasterGateway 许可证:一个变量是监视列表中某个对象的一个属性。

SNMP

  • MasterGateway
  • Master Protocols — 兼容 SNMP
  • Windows
  • Linux

只读的 SNMP v1、v2c 和 v3 管理器,可接收 trap 和 inform。

  • SNMP v3,支持 noAuthNoPriv、authNoPriv 和 authPriv;认证算法 MD5、SHA-1、SHA-224、SHA-256、SHA-384 和 SHA-512;加密算法 DES、3DES 和 AES-128/192/256。
  • Get、GetNext、GetBulk 和 walk;读取表(例如 ifTable)。
  • 内置 MIB(SNMPv2-MIB、IF-MIB、HOST-RESOURCES-MIB、ENTITY-MIB、UPS-MIB 等),并可加载厂商的 MIB;MIB 树,以及按名称或 OID 搜索。
  • 通过轮询监视,并计算计数器的速率。
  • 在子网或地址范围内发现设备。
  • 接收 v1/v2c/v3 的 trap 和 inform。
  • 从不发送 Set。

在 Linux 上,低于 1024 的端口需要特权:要在 162 端口接收 trap,请使用高于 1024 的端口,或以管理员身份(sudo)启动该程序;在 MasterGateway 中,请使用高于 1024 的端口(例如 1162)。MasterGateway 许可证:一个变量是被监视列表中的一个 OID。

Modbus

  • MasterGateway
  • Master Protocols — 兼容 Modbus
  • Windows
  • Linux

只读的 Modbus 主站(功能码 FC01、FC02、FC03 和 FC04)。

  • Modbus TCP、RTU over TCP、ASCII over TCP、串口 RTU 和串口 ASCII。
  • 每个连接可有多个从站;地址以 0 或 1 为基数。
  • 类型 Bit、Int16、UInt16、Int32、UInt32、Float32、Float64 和 String;字节顺序 ABCD、CDAB、BADC 和 DCBA;缩放和偏移。
  • 自动按连续块分组读取。
  • 以十六进制显示的 TX/RX 流量监视器,以及诊断计数器(超时、CRC/LRC、Modbus 异常)。

MasterGateway 许可证:一个变量是一个 tag。

OPC UA

  • MasterGateway
  • Master Protocols — 兼容 OPC UA
  • Windows
  • Linux

只读的 OPC UA 客户端,基于 OPC Foundation 的官方协议栈。

  • 搜索 endpoint;安全策略 None、Basic128Rsa15、Basic256、Basic256Sha256、Aes128_Sha256_RsaOaep 和 Aes256_Sha256_RsaPss;模式 None、Sign 和 SignAndEncrypt。
  • 匿名认证、用户名和密码认证,或用户证书(PFX/P12)认证;管理对服务器证书的信任。
  • 浏览节点树,按名称或 NodeId 搜索,并显示节点的所有属性。
  • 标量值、数组、矩阵和结构,也包括自定义结构。
  • 基于订阅的监视,每个变量可设置采样间隔。
  • 从不使用 Write 或 Call。

MasterGateway 许可证:一个变量是监视列表中的一个节点。

OPC DA

  • MasterGateway
  • Master Protocols — 兼容 OPC DA
  • 仅限 Windows

只读的 OPC DA(Data Access 2.0 和 3.0)客户端,适用于本地和远程服务器。

  • 搜索此电脑或远程电脑上的服务器(OpcEnum);也可以手动输入 ProgID 或 CLSID。
  • 通过 DCOM 连接本地或远程服务器。
  • 地址空间树,使用 * 和 ? 过滤器搜索,以及 item 的属性(类型、访问权限、单位、描述、限值)。
  • 监视数值、带说明的 OPC 质量(良好、不确定、不良及其原因)和服务器时间。
  • 无回调:不需要为服务器到电脑的调用配置 DCOM 权限。
  • 从不向服务器写入。

仅适用于 Windows,因为 OPC DA 基于 COM/DCOM。需要 OPC Foundation 的 64 位 OPC Core Components(通常由 OPC 服务器安装)。无法使用 32 位的进程内(DLL)服务器。对于远程服务器,需要在服务器所在电脑上配置 DCOM 权限和防火墙规则。MasterGateway 许可证:一个变量是监视列表中的一个 item。

IEC 60870-5-104

  • MasterGateway
  • Master Protocols — 兼容 IEC 60870-5-104
  • Windows
  • Linux
  • 新

只读的 IEC 60870-5-104 控制站,协议在程序内部自行实现。

  • TCP 连接(端口 2404),支持备用主机和自动重新连接;可配置参数 k、w、t0、t1、t2 和 t3(可一键恢复标准值)、公共地址(CA)、originator,以及 COT、CA 和 IOA 的长度。
  • 33 种监视方向的信息类型:单点和双点信息、步位置信息、位串、归一化值、标度化值和浮点测量值、累计量、保护事件、成组点信息和初始化结束;带质量(IV、NT、SB、BL、OV…)以及 CP56Time2a、CP24Time2a 和 CP16Time2a 时标。
  • 按 CA 和 IOA 列出接收到的对象,并带过滤;监视所选对象,显示数值、质量、站端时间、接收时间和原因,并可选择周期性读取。
  • 以十六进制显示发送和接收的报文及其解码,以及诊断(计数器、错误、t1 超时)。
  • 只发送总召唤(C_IC_NA_1)、不冻结也不清零计数器的计数量召唤(C_CI_NA_1)和读取(C_RD_NA_1):从不发送命令、设定值、时钟同步、参数或文件。

不包含 IEC 60870-5-101(串行)、TLS 连接(IEC 62351-3)和按组召唤。MasterGateway 许可证:一个变量是一个被监视的信息对象(IOA);接收到的对象列表属于浏览,不计入变量。

DLMS/COSEM

  • MasterGateway
  • Master Protocols — 兼容 DLMS/COSEM
  • Windows
  • Linux
  • 新

只读的 DLMS/COSEM(IEC 62056)客户端,适用于电能表,协议在程序内部自行实现。

  • 带 wrapper 的 TCP(端口 4059)、TCP 上的 HDLC 和串口上的 HDLC,也支持光电头(IEC 62056-21,模式 E);HDLC 地址为 1、2 或 4 字节。
  • 以公共客户端、LLS(密码)或 HLS-GMAC(套件 0,AES-GCM-128)建立关联,APDU 可加密或仅认证。
  • 关联的对象列表只读取一次,显示易读的 OBIS 代码(例如 1-0:1.8.0.255)、物理量符号(+A、-A、U L1、I L2…)、类和过滤;可读取任意属性。
  • 监视 Data、Register、Extended Register 和 Demand Register(带换算系数和单位)以及时钟;每 N 秒读取一次。
  • 负荷曲线(Profile Generic):最近 N 行或某个日期范围,有许可证时可导出为 CSV。
  • 以十六进制显示报文及其解码,并提供诊断;密码和密钥始终不可见。
  • 只进行 GET 读取:从不使用 SET 或 ACTION,HLS 的认证步骤除外。

仅支持逻辑名称(LN):不支持按短名称(SN)引用,也不支持安全套件 1 和 2。MasterGateway 许可证:一个变量是一个被监视的 COSEM 属性(类 + OBIS + 属性);对象列表、单次读取和负荷曲线不计入变量。在 MasterGateway 中,电能表的数值在报文中显示为隐藏。

PROFINET DCP

  • MasterGateway
  • Master Protocols — 兼容 PROFINET DCP
  • Windows
  • Linux
  • 新

使用 DCP 搜索 PROFINET 设备,只读,协议在程序内部自行实现。

  • 只使用 Identify(全部设备或按站名)和 Get;从不使用 Set:不更改名称和 IP 地址,不让设备闪烁,也不恢复出厂设置。
  • 设备列表:站名、类型、IP 地址、掩码、网关、MAC、Vendor ID、Device ID 和角色。
  • 监视所选属性以及每台设备是否在线;十六进制帧及其解码,以及诊断。

最多每 2 秒发送一次 Identify。程序直接使用网卡:在 Windows 上需要由用户自行安装 Npcap;在 Linux 上必须以 root 身份启动程序。MasterGateway 许可证:一个变量是设备的一个被监视的属性。已在 Linux 上使用第三方 PROFINET 软件设备(p-net)以及 Wireshark 项目的真实流量抓包进行测试;尚未使用真实的 PROFINET 设备测试,也未在 Windows 上配合 Npcap 测试。

PROFINET IO

  • MasterGateway
  • Master Protocols — 兼容 PROFINET IO
  • Windows
  • Linux
  • 新

非循环读取 PROFINET IO 设备的记录,只读,协议在程序内部自行实现。

  • 只进行端点查找和 Read Implicit(基于 UDP 的 RPC,端口 34964):不与设备建立任何关系;从不使用 Connect、Write、Control 或 Release。
  • 记录 I&M0 至 I&M4、模块和子模块、诊断、端口和邻居(拓扑)、端口统计和日志。
  • 监视记录中所选的字段,每 N 秒读取一次;帧及其解码,以及诊断。

设备通过 IPv4 地址指定:不需要 Npcap。MasterGateway 许可证:一个变量是记录中一个被监视的字段。已在 Linux 上使用第三方 PROFINET 软件设备(p-net)以及 Wireshark 项目的真实流量抓包进行测试;尚未使用真实的 PROFINET 设备测试。

PROFINET RT

  • MasterGateway
  • Master Protocols — 兼容 PROFINET RT
  • Windows
  • Linux
  • 新

被动监听 PROFINET RT 流量:从不发送任何数据。

  • 按源 MAC 和 FrameID 区分的循环数据流:循环时间、丢失和重复的帧,以及数据状态。
  • 监视循环帧中的数据、带通道诊断的报警、LLDP 邻居和 MRP 环网状态。
  • 来自交换机的镜像端口或 TAP,或来自 pcap 或 pcapng 抓包文件。

在网卡上监听时:在 Windows 上需要由用户自行安装 Npcap;在 Linux 上必须以 root 身份启动程序。只有网卡交付 IRT 帧(3 类)时才能看到它们。MasterGateway 许可证:一个变量是循环帧中一个被监视的数据或数据状态。已在 Linux 上使用第三方 PROFINET 软件设备(p-net)以及 Wireshark 项目的真实流量抓包进行测试;尚未使用真实的 PROFINET 设备测试,也未在 Windows 上配合 Npcap 测试。

系统要求

系统程序说明
Windows 10 或 11,64 位 (x64) MasterGateway(十种协议,含 masterkontact-cli)、MasterGateway Diagnostica 和十个独立程序 安装程序 SetupMasterKontact.exe。无需安装 .NET。
带桌面的 Linux x86-64 MasterGateway(不含 OPC DA)、MasterGateway Diagnostica、Master Protocols (BACnet)、Master Protocols (SNMP)、Master Protocols (Modbus)、Master Protocols (OPC UA)、Master Protocols (IEC 60870-5-104)、Master Protocols (DLMS/COSEM)、Master Protocols (PROFINET DCP)、Master Protocols (PROFINET IO) 和 Master Protocols (PROFINET RT) X11,或通过 XWayland 运行的 Wayland。桌面安装中已有的库:libicu、fontconfig、libX11、libICE、libSM。使用中文时需要 CJK 字体(例如 fonts-noto-cjk)。
无桌面的 Linux x86-64(服务器) masterkontact-cli 和 masterkontact-diag 使用同一个压缩包安装(install.sh)。需要 libicu。
  • 无需互联网:使用程序和验证许可证都不需要。
  • Linux 上的串口(BACnet MS/TP、Modbus RTU/ASCII、通过 HDLC 或光电头的 DLMS):用户必须属于 dialout 组。
  • PROFINET DCP 和 PROFINET RT(独立程序和 MasterGateway)直接使用网卡:在 Windows 上需要由用户自行安装 Npcap(安装程序不包含);在 Linux 上必须以 root 身份启动程序,因为安装过程不会给程序授予网络权限。PROFINET IO 不需要。
  • 在 Linux 上,密码、密钥和 community 不会保存在配置文件中:每次启动时都需要输入。
  • 在 Windows 上,首次启动时防火墙可能会请求对设备所在网络的访问许可。