Skip to content
MasterKontact

Products

MasterGateway, with all the protocols in one program; ten standalone programs, one per protocol; and MasterGateway Diagnostica, free of charge. All of them read-only.

MasterGateway: all the protocols in one program

  • Windows
  • Linux
  • Terminal

One program with ten protocols (BACnet, SNMP, Modbus, OPC UA, OPC DA (Windows only), IEC 60870-5-104, DLMS/COSEM, PROFINET DCP, PROFINET IO and PROFINET RT) in a single window, plus the masterkontact-cli command-line program.

  • At the top, the list of protocols: a click opens the protocol's page and a colored dot shows the status of its connection. You can use several protocols at once and switch from one to another without losing anything.
  • For each protocol, the same functions as the corresponding standalone program (details below).
  • Hardware page, the last one on the top bar: network (adapters, addresses, traffic, errors), serial ports (never opened), machine and process; Copy puts the report on the clipboard. Always available, also in demo mode, and it does not count towards the license.
  • License bound to the computer name and the PC code (if a single part changes it remains valid), with the enabled protocols and the maximum number of variables for each one (Licenses).
  • Alerts for monitoring systems: if the license is not valid or expires, or if the demo mode ends, an event is written to the Windows Event Viewer or to syslog on Linux (details).

masterkontact-cli

The same read-only functions from any Windows or Linux terminal, also on servers without a graphical desktop: the same license, the same demo mode and the same profiles as the window. For each protocol: connection, search and browsing, single read and continuous monitoring with value, quality and time updated in the terminal until Ctrl+C. Results on standard output and documented exit codes for scripts.

The commands and options are Italian words in all languages (aiuto, licenza, leggi, monitora…); the messages appear in the chosen language (--lang en).

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
Commands for each protocol (masterkontact-cli aiuto <protocol>)
ProtocolCommands
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 only)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

Without a license, the protocol commands work with --demo (the same 10 minutes as the window). masterkontact-cli hardware shows the Hardware page, also without a license. masterkontact-cli aiuto codici shows the exit codes. On Windows, the installer adds masterkontact-cli to the PATH; on Linux, install.sh creates the command in ~/.local/bin or in /usr/local/bin.

MasterGateway Diagnostica

  • Windows
  • Linux
  • Terminal
  • Free

Free application, with no license, for diagnosing connections. It never reads plant data.

  • MasterGateway: the MasterGateway instances open on this PC and the live status of their connections: target, status, response times, requests, timeouts, errors, reconnections and last error. Never the values of the variables.
  • Connection test to a name or an address: DNS, ping and repeated TCP connection with times and lost packets; for BACnet a Who-Is and for SNMP only sysUpTime. Default ports: Modbus TCP 502, OPC UA 4840, IEC 104 2404, DLMS 4059, BACnet 47808, SNMP 161, DCOM 135. A single target and a single port per test, with limits against scanning.
  • Network and serial ports: the same information as the Hardware page of MasterGateway.
  • Window on Windows and Linux (masterkontact-diagnostica) and the masterkontact-diag command for the terminal.

It is installed as a separate program, normally together with MasterGateway. In MasterGateway, the Access for MasterGateway Diagnostica checkbox on the Hardware page allows or blocks this access, only from the same PC and the same user.

Standalone programs

One program for each protocol, with its own window and its own license, bound to the PC code.

ProgramProtocolSystemsCommand on Linux
Master Protocols (BACnet)BACnet/IP and MS/TPWindows, Linuxbacnet-client
Master Protocols (SNMP)SNMP v1, v2c and v3Windows, Linuxsnmp-manager
Master Protocols (Modbus)Modbus TCP, RTU and ASCIIWindows, Linuxmodbus-master
Master Protocols (OPC UA)OPC UAWindows, Linuxopcua-viewer
Master Protocols (OPC DA)OPC DA 2.0 and 3.0Windows only—
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 or standalone programs

MasterGatewayStandalone programs
ProtocolsAll ten in one window (OPC DA on Windows only)One per program
Command linemasterkontact-cli—
Hardware page and MasterGateway DiagnosticaYes—
License bound toComputer name and PC codePC code
The license specifiesProtocols, maximum number of variables for each one, duration and maximum versionDuration (perpetual or with an expiry date)
Without a license10-minute demo mode10-minute free trial
License events for monitoring systemsWindows Event Viewer or syslog—

In all the programs

  • Read-only: the programs contain no write or control commands for the devices.
  • Saved connection profiles.
  • Watch list with the value, status and time of each row; Pause and Resume the selected rows.
  • Anything that does not respond is read again less often, without slowing down the rest.
  • Export of values, continuous logging, and import and export of the lists in CSV (with a license).
  • Automatic reconnection and the connection status always visible.
  • Event log and Download logs… for technical support (with a license).
  • Built-in help (F1) and interface in Spanish, English, German, Italian and Chinese.
  • Self-contained executables: there is no need to install .NET.

BACnet

  • MasterGateway
  • Master Protocols — compatible with BACnet
  • Windows
  • Linux

Read-only BACnet client for BACnet/IP (also through a BBMD) and MS/TP.

  • BACnet/IP on UDP 47808 (configurable port) and registration as a Foreign Device with a BBMD to reach other subnets.
  • MS/TP on RS-485: serial port, speed, client MAC and Max Master.
  • Discovery with Who-Is/I-Am and adding by address; devices behind routers, segmented responses, old devices or devices without ReadPropertyMultiple.
  • Device → types → objects and properties tree in a readable format: units, Status_Flags, Priority_Array, State_Text and more.
  • Search by name or by identifier (for example AI 3).
  • Monitoring with SubscribeCOV where the device supports it, or by polling.
  • It never uses WriteProperty or other write or control services.

MasterGateway license: a variable is a property of an object in the watch list.

SNMP

  • MasterGateway
  • Master Protocols — compatible with SNMP
  • Windows
  • Linux

Read-only SNMP v1, v2c and v3 manager, with reception of traps and informs.

  • SNMP v3 with noAuthNoPriv, authNoPriv and authPriv; MD5, SHA-1, SHA-224, SHA-256, SHA-384 and SHA-512 authentication; DES, 3DES and AES-128/192/256 encryption.
  • Get, GetNext, GetBulk and walk; reading of tables (for example ifTable).
  • Built-in MIBs (SNMPv2-MIB, IF-MIB, HOST-RESOURCES-MIB, ENTITY-MIB, UPS-MIB and others) and loading of the vendors' MIBs; MIB tree and search by name or OID.
  • Monitoring by polling with the rate of the counters.
  • Device discovery on a subnet or an address range.
  • Reception of v1/v2c/v3 traps and informs.
  • It never sends Set.

On Linux, ports below 1024 require privileges: to receive traps on port 162, use a port above 1024 or start the program as administrator (sudo); in MasterGateway use a port above 1024 (for example 1162). MasterGateway license: a variable is an OID in the monitored list.

Modbus

  • MasterGateway
  • Master Protocols — compatible with Modbus
  • Windows
  • Linux

Read-only Modbus master (functions FC01, FC02, FC03 and FC04).

  • Modbus TCP, RTU over TCP, ASCII over TCP, serial RTU and serial ASCII.
  • Several slaves per connection; base-0 or base-1 addresses.
  • Types Bit, Int16, UInt16, Int32, UInt32, Float32, Float64 and String; byte order ABCD, CDAB, BADC and DCBA; scale and offset.
  • Reads automatically grouped into contiguous blocks.
  • TX/RX traffic monitor in hexadecimal and diagnostic counters (timeouts, CRC/LRC, Modbus exceptions).

MasterGateway license: a variable is a tag.

OPC UA

  • MasterGateway
  • Master Protocols — compatible with OPC UA
  • Windows
  • Linux

Read-only OPC UA client based on the official OPC Foundation stack.

  • Endpoint discovery; security policies None, Basic128Rsa15, Basic256, Basic256Sha256, Aes128_Sha256_RsaOaep and Aes256_Sha256_RsaPss; modes None, Sign and SignAndEncrypt.
  • Anonymous authentication, with user name and password or with a user certificate (PFX/P12); management of trust in the server certificates.
  • Browsing of the node tree, search by name or NodeId and all the node's attributes.
  • Scalar values, arrays, matrices and structures, including custom ones.
  • Monitoring with subscriptions and sampling intervals per variable.
  • It never uses Write or Call.

MasterGateway license: a variable is a node in the watch list.

OPC DA

  • MasterGateway
  • Master Protocols — compatible with OPC DA
  • Windows only

Read-only OPC DA (Data Access 2.0 and 3.0) client for local and remote servers.

  • Discovery of the servers on this PC or on a remote PC (OpcEnum); ProgID or CLSID can also be entered by hand.
  • Connection to local or remote servers through DCOM.
  • Address space tree, search with * and ? filters, item properties (type, access rights, unit, description, limits).
  • Monitoring with value, explained OPC quality (good, uncertain, bad and the reason) and server time.
  • No callbacks: the DCOM permissions for calls from the server to the PC are not needed.
  • It never writes to the server.

Windows only because OPC DA is based on COM/DCOM. It requires the 64-bit OPC Core Components from the OPC Foundation (normally installed by the OPC server). 32-bit in-process (DLL) servers cannot be used. For remote servers, the DCOM permissions and the firewall rules are needed on the server PC. MasterGateway license: a variable is an item in the watch list.

IEC 60870-5-104

  • MasterGateway
  • Master Protocols — compatible with IEC 60870-5-104
  • Windows
  • Linux
  • New

Read-only IEC 60870-5-104 control station, with the protocol implemented in the program itself.

  • TCP connection (port 2404) with backup host and automatic reconnection; configurable parameters k, w, t0, t1, t2 and t3 (with the standard values one click away), common address (CA), originator and sizes of COT, CA and IOA.
  • 33 monitoring information types: single and double points, step positions, bitstrings, normalized, scaled and floating-point measured values, integrated totals, protection events, packed points and end of initialization; with quality (IV, NT, SB, BL, OV…) and CP56Time2a, CP24Time2a and CP16Time2a time tags.
  • List of the received objects by CA and IOA, with a filter; monitoring of the chosen objects with value, quality, station time, reception time and cause, and optional cyclic read.
  • Frames sent and received in hexadecimal with their decoding, and diagnostics (counters, errors, t1 timeouts).
  • It sends only general interrogation (C_IC_NA_1), counter interrogation without freezing or resetting the counters (C_CI_NA_1) and read (C_RD_NA_1): never commands, setpoints, clock synchronization, parameters or files.

It does not include IEC 60870-5-101 (serial), TLS connections (IEC 62351-3) or group interrogations. MasterGateway license: a variable is a monitored information object (IOA); the list of received objects is browsing and does not count.

DLMS/COSEM

  • MasterGateway
  • Master Protocols — compatible with DLMS/COSEM
  • Windows
  • Linux
  • New

Read-only DLMS/COSEM (IEC 62056) client for energy meters, with the protocol implemented in the program itself.

  • TCP with wrapper (port 4059), HDLC over TCP and HDLC over a serial port, also with an optical probe (IEC 62056-21, mode E); 1-, 2- or 4-byte HDLC addresses.
  • Association as a public client, with LLS (password) or with HLS-GMAC (suite 0, AES-GCM-128), with encrypted or authenticated-only APDUs.
  • Association object list read once, with a readable OBIS code (for example 1-0:1.8.0.255), quantity symbol (+A, -A, U L1, I L2…), class and filter; reading of any attribute.
  • Monitoring of Data, Register, Extended Register and Demand Register with scaler and unit, and of the clock; read every N seconds.
  • Load profiles (Profile Generic): last N rows or a date range, in CSV with a license.
  • Frames in hexadecimal with their decoding and diagnostics; passwords and keys never visible.
  • GET reads only: never SET or ACTION, except for the HLS authentication step.

Logical names (LN) only: no short-name (SN) references and no security suites 1 and 2. MasterGateway license: a variable is a monitored COSEM attribute (class + OBIS + attribute); the object list, the single read and the load profiles do not count. In MasterGateway, the meter values appear hidden in the frames.

PROFINET DCP

  • MasterGateway
  • Master Protocols — compatible with PROFINET DCP
  • Windows
  • Linux
  • New

Read-only discovery of PROFINET devices with DCP, with the protocol implemented in the program itself.

  • Only Identify (all devices or by station name) and Get; never Set: it does not change names or IP addresses, does not make devices flash and does not reset to factory settings.
  • Device list with station name, type, IP address, mask, gateway, MAC, Vendor ID, Device ID and role.
  • Monitoring of the chosen attributes and of the presence of each device; frames in hexadecimal with their decoding, and diagnostics.

At most one Identify every 2 seconds. It uses the network adapter directly: on Windows it requires Npcap, installed by the user; on Linux the program must be started as root. MasterGateway license: a variable is a monitored attribute of a device. Tested on Linux with a third-party software PROFINET device (p-net) and with real traffic captures from the Wireshark project; not yet with real PROFINET equipment or on Windows with Npcap.

PROFINET IO

  • MasterGateway
  • Master Protocols — compatible with PROFINET IO
  • Windows
  • Linux
  • New

Read-only acyclic reading of the records of PROFINET IO devices, with the protocol implemented in the program itself.

  • Only endpoint lookup and Read Implicit (RPC over UDP, port 34964): it opens no relation with the device; never Connect, Write, Control or Release.
  • Records I&M0 to I&M4, modules and submodules, diagnosis, ports and neighbors (topology), port statistics and logbook.
  • Monitoring of the chosen fields of a record, read every N seconds; frames with their decoding, and diagnostics.

The device is given by its IPv4 address: Npcap is not required. MasterGateway license: a variable is a monitored field of a record. Tested on Linux with a third-party software PROFINET device (p-net) and with real traffic captures from the Wireshark project; not yet with real PROFINET equipment.

PROFINET RT

  • MasterGateway
  • Master Protocols — compatible with PROFINET RT
  • Windows
  • Linux
  • New

Passive listening to PROFINET RT traffic: it never transmits anything.

  • Cyclic streams by source MAC and FrameID: cycle time, lost and repeated frames, and data status.
  • Monitoring of items of the cyclic frames, alarms with channel diagnosis, LLDP neighbors and MRP ring state.
  • From a mirror port of the switch or a TAP, or from a pcap or pcapng capture file.

To listen on the network adapter: on Windows it requires Npcap, installed by the user; on Linux the program must be started as root. IRT frames (class 3) are visible only if the adapter delivers them. MasterGateway license: a variable is a monitored item of a cyclic frame or the data status. Tested on Linux with a third-party software PROFINET device (p-net) and with real traffic captures from the Wireshark project; not yet with real PROFINET equipment or on Windows with Npcap.

System requirements

SystemProgramsNotes
Windows 10 or 11, 64-bit (x64) MasterGateway (ten protocols, with masterkontact-cli), MasterGateway Diagnostica and the ten standalone programs SetupMasterKontact.exe installer. There is no need to install .NET.
Linux x86-64 with a desktop MasterGateway (without 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) and Master Protocols (PROFINET RT) X11, or Wayland through XWayland. Libraries present in desktop installations: libicu, fontconfig, libX11, libICE, libSM. For Chinese, a CJK font (for example fonts-noto-cjk).
Linux x86-64 without a desktop (server) masterkontact-cli and masterkontact-diag Installed from the same archive (install.sh). They require libicu.
  • No Internet is needed: neither to use the programs nor to verify the licenses.
  • Serial ports on Linux (BACnet MS/TP, Modbus RTU/ASCII, DLMS over HDLC or optical probe): the user must belong to the dialout group.
  • PROFINET DCP and PROFINET RT (standalone programs and MasterGateway) use the network adapter directly: on Windows they require Npcap, installed by the user (not included in the installer); on Linux the program must be started as root, because the installation does not give network permissions to the programs. PROFINET IO does not need this.
  • On Linux, passwords, keys and communities are not saved in the profiles: they are typed at each start.
  • On Windows, at the first start the firewall may ask for permission for the networks the devices are on.