ReferenceDriverModbusConnect Server

Connect to a Modbus Server

Connect to a Modbus server using Synnax.

The first step to acquiring data from your Modbus server is to establish a connection to the server.

Prerequisites

Before you can connect to a Modbus server, you’ll need to have the following configured:

  1. A Synnax Core running on your network.
  2. The Synnax Console installed on your machine.
  3. A Modbus server running on your network. This server must be reachable by the Core.

We’ll use the Console’s configuration workflow to connect to your server. To kick things off, open the Console and click on the Search and Command Palette at the top. You can also open this palette with Ctrl+Shift+P (Windows) / Cmd+Shift+P (macOS).

In command mode (enabled when the first character in the input is >), type “Modbus”. You’ll see an option called “Connect a Modbus Server”. Select this option to open the server configuration dialog.

The dialog will prompt you to enter the connection parameters to your server. Here’s a reference for each of the fields you’ll need to fill:

FieldDescription
Name

A name for your Modbus server. We’ll use this to identify and manage the server in the Console.

Connect From

The Synnax driver that will connect to the Modbus server.

Host

The IP address or hostname of your Modbus server. This should be its reachable address on the network (e.g., 192.168.1.100 or localhost).

Port

The TCP port for the Modbus server. The default Modbus port is 502.

Swap Bytes

Enable byte swapping for 16-bit values. This is used to handle different endianness between the server and Synnax. Only applicable for register types (Holding Registers and Input Registers).

Swap Words

Enable word swapping for 32-bit and 64-bit values. This reorders 16-bit words within multi-register values to handle different word ordering conventions. Only applicable for 32-bit and 64-bit data types in registers.

You can use the “Connect” button to verify that the server is reachable from the Core. When you are ready to connect the server, click “Connect”. The connection will be saved and you can now create read and write tasks for this server.