# Common Resources

Source of common resources used across the Modbus Ethernet Gateways documentation

# Tables

### Specification  


<table border="1" id="bkmrk-redisage-pn-g01-g02-" style="border-collapse: collapse; width: 100%; height: 884.422px;"><colgroup><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col><col style="width: 12.5149%;"></col></colgroup><thead><tr style="height: 35.375px;"><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" colspan="2" data-colwidth="220,148" style="height: 35.375px;">**Redisage PN**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="101" style="height: 35.375px;">**G01**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="96" style="height: 35.375px;">**G02**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="100" style="height: 35.375px;">**G03**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="100" style="height: 35.375px;">**G14**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="102" style="height: 35.375px;">**G15**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="93" style="height: 35.375px;">**G16**

</td></tr></thead><tbody><tr style="height: 35.3906px;"><td data-colwidth="220" rowspan="3" style="height: 106.172px;">Ports

</td><td data-colwidth="148" style="height: 35.3906px;">RS232

</td><td class="align-center" data-colwidth="101" style="height: 35.3906px;">2x

</td><td class="align-center" data-colwidth="96" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">4x

</td><td class="align-center" data-colwidth="102" style="height: 35.3906px;">2x

</td><td class="align-center" data-colwidth="93" style="height: 35.3906px;">-

</td></tr><tr style="height: 35.3906px;"><td data-colwidth="148" style="height: 35.3906px;">RS485

</td><td class="align-center" data-colwidth="101" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="96" style="height: 35.3906px;">1x

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="102" style="height: 35.3906px;">2x

</td><td class="align-center" data-colwidth="93" style="height: 35.3906px;">4x

</td></tr><tr style="height: 35.3906px;"><td data-colwidth="148" style="height: 35.3906px;">RS232/RS485

</td><td class="align-center" data-colwidth="101" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="96" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">2x

</td><td class="align-center" data-colwidth="100" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="102" style="height: 35.3906px;">-

</td><td class="align-center" data-colwidth="93" style="height: 35.3906px;">-

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Microcontroller

</td><td class="align-center" colspan="3" data-colwidth="101,96,100" style="height: 35.375px;">ESP32

</td><td class="align-center" colspan="3" data-colwidth="100,102,93" style="height: 35.375px;">STM32F4

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">WiFi

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">N/A

</td></tr><tr style="height: 35.375px;"><td data-colwidth="220" rowspan="2" style="height: 70.75px;">Power

</td><td data-colwidth="148" style="height: 35.375px;">Voltage

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">12-30 VDC

</td></tr><tr style="height: 35.375px;"><td data-colwidth="148" style="height: 35.375px;">Power

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">&lt; 1 W

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Frame ground connection

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">yes

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Baud rate

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">up to 115200 bps

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">LED indicators

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">communication Tx, Rx and power

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">RS485 termination

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">120 ohm manually enabled

</td></tr><tr style="height: 38.0469px;"><td data-colwidth="220" rowspan="3" style="height: 111.469px;">Connector

</td><td data-colwidth="148" style="height: 38.0469px;">RS232/RS485

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 38.0469px;">8-pin terminal block max. 2.5 mm<sup data-renderer-mark="true">2</sup> wire

</td></tr><tr style="height: 38.0469px;"><td data-colwidth="148" style="height: 38.0469px;">Power

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 38.0469px;">3-pin terminal block max. 2.5 mm<sup data-renderer-mark="true">2</sup> wire

</td></tr><tr style="height: 35.375px;"><td data-colwidth="148" style="height: 35.375px;">Ethernet

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">RJ45

</td></tr><tr style="height: 80.1719px;"><td data-colwidth="220" rowspan="2" style="height: 115.547px;">Transmission  
distance

</td><td data-colwidth="148" style="height: 80.1719px;">RS485

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 80.1719px;">max. 1,200 m at 9.6 kbps; max. 400 m at 115.2 kbps  
(Belden 9841 2P twisted-pair cable, if diﬀerent cables are used,   
the transmission distance may change)

</td></tr><tr style="height: 35.375px;"><td style="height: 35.375px;">RS232

</td><td colspan="6" style="height: 35.375px;">max. 15 m at 115.2 kbps

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Mounting and enclosure

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">DIN rail, plastic PA - UL 94 V0, black/green

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Temperatures

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">-40°C to +75°C operating and storage

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">Humidity

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">10 - 90% RH, non-condensing

</td></tr><tr style="height: 35.375px;"><td colspan="2" data-colwidth="220,148" style="height: 35.375px;">ESD protection

</td><td class="align-center" colspan="6" data-colwidth="101,96,100,100,102,93" style="height: 35.375px;">±4 kV contact discharge / ±8 kV air discharge

</td></tr><tr style="height: 32.375px;"><td colspan="2" data-colwidth="68,50" style="height: 32.375px;">Certification

</td><td class="align-center" colspan="6" data-colwidth="102,101" style="height: 32.375px;">CE, RoHS, EMC, LVD

</td></tr><tr style="height: 58.9844px;"><td colspan="2" style="height: 58.9844px;">Norms

</td><td colspan="6" style="height: 58.9844px;">61000-6-2 - Immunity standard for industrial environments

61000-6-4 - Emission standard for industrial environments

</td></tr></tbody></table>

### Pin assignments

<table border="1" id="bkmrk-g01-g02-g03-g14-g15-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr><td class="align-center">**G01**

**[![7a36a230-516d-413d-a5b2-aeb9c4044bb0.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/7a36a230-516d-413d-a5b2-aeb9c4044bb0.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/7a36a230-516d-413d-a5b2-aeb9c4044bb0.png)**

</td><td class="align-center">**G02**

**[![27b5fe0a-d8ca-451b-a20d-2f1678d04547.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/27b5fe0a-d8ca-451b-a20d-2f1678d04547.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/27b5fe0a-d8ca-451b-a20d-2f1678d04547.png)**

</td><td class="align-center">**G03**

**[![54ec2665-7a15-484f-bdf2-6917b054595c.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/54ec2665-7a15-484f-bdf2-6917b054595c.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/54ec2665-7a15-484f-bdf2-6917b054595c.png)**

</td></tr><tr><td class="align-center">**G14**

**[![3194e998-4094-4387-8062-f44a1ae1bc9d.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/3194e998-4094-4387-8062-f44a1ae1bc9d.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/3194e998-4094-4387-8062-f44a1ae1bc9d.png)**

</td><td class="align-center">**G15**

**[![a9bf9b11-bebf-45e5-a3d8-81d001bb0c78.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/a9bf9b11-bebf-45e5-a3d8-81d001bb0c78.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/a9bf9b11-bebf-45e5-a3d8-81d001bb0c78.png)**

</td><td class="align-center">**G16**

**[![1bbc9a2e-ce07-44af-9ad1-3fcfe6685a3b.png](https://doc.redisage.com/uploads/images/gallery/2024-03/scaled-1680-/1bbc9a2e-ce07-44af-9ad1-3fcfe6685a3b.png)](https://doc.redisage.com/uploads/images/gallery/2024-03/1bbc9a2e-ce07-44af-9ad1-3fcfe6685a3b.png)**

</td></tr></tbody></table>

### Configuration by the Web Page

#### Ports page

<table border="1" id="bkmrk-item-description-int" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.2608%;"></col><col style="width: 21.508%;"></col><col style="width: 57.2311%;"></col></colgroup><thead><tr><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" colspan="2" data-colwidth="118,109">**Item**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="661">**Description**

</td></tr></thead><tbody><tr><td colspan="2" data-colwidth="118,109">Internal Modbus Address

</td><td data-colwidth="661">Internal Modbus Address is qualified by the Gateway/Router as a request for internal resources. The Internal Modbus Address has a higher priority than the Gateway Slave Address.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Idle Time \[s\]

</td><td data-colwidth="661">Determine a time thread waits for the TCP connection. If time expired, the connection and thread are closed. **Used only in Gateway Mode.**

</td></tr><tr><td data-colwidth="118" rowspan="3">UART Mode

</td><td data-colwidth="109">Gateway

</td><td data-colwidth="661">Define the port's role in the system. In the Gateway Mode the port is used to communicate with Modbus Slave.

</td></tr><tr><td data-colwidth="109">Router

</td><td data-colwidth="661">Define the port's role in the system. In the Router Mode the port is used to communicate with Modbus Master. Note the Routing Configuration section below if the Router Mode is chosen.

</td></tr><tr><td data-colwidth="109">Disabled

</td><td data-colwidth="661">Disable the port.

</td></tr><tr><td colspan="2" data-colwidth="118,109">UART Protocol

</td><td data-colwidth="661">Determine a protocol used for a communication.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Gateway Slaves

</td><td data-colwidth="661">Addresses of Modbus Slave Devices connected to Gateway UART ports. Multiple addresses can be written in one field, e.g. *9;11;14-17;80*. This field is available only in the Gateway Mode. Use \* to select all not assigned addresses.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Slaves Response Timeout \[ms\]

</td><td data-colwidth="661">Specify how long the device will wait for response from Modbus Slave.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Baud Rate

</td><td data-colwidth="661">Determine the port's transmission speed over the data channel.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Data Bits

</td><td data-colwidth="661">Determine the number of data bits in the port's message frame.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Parity

</td><td data-colwidth="661">Enable/disable the parity check in the port's message frame.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Stop Bits

</td><td data-colwidth="661">Determine the number of stop bits in the port's message frame.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Termination

</td><td data-colwidth="661">Enable/disable termination on RS line.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Routing Slaves

</td><td data-colwidth="661">Addresses of Modbus Slaves connected to Modbus Router. Multiple addresses can be written in one field, e.g. 9;11;14-17;80. Use \* to select all not assigned addresses.

</td></tr><tr><td colspan="2" data-colwidth="118,109">Slaves Response Timeout \[ms\]

</td><td data-colwidth="661">Specify how long the device will wait for response from Modbus Slave.

</td></tr><tr><td colspan="2" data-colwidth="118,109">IP/Hostname

</td><td data-colwidth="661">Determine IP address or Hostname of Modbus Slave.

</td></tr><tr><td colspan="2" data-colwidth="118,109">TCP Port

</td><td data-colwidth="661">Determine TCP port of Modbus Slave.

</td></tr></tbody></table>

#### Network page

<table border="1" id="bkmrk-item-description-hos" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><thead><tr><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Item**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Description**

</td></tr></thead><tbody><tr><td data-colwidth="340">Hostname

</td><td data-colwidth="340">Label that is assigned to the device.

</td></tr><tr><td data-colwidth="340">Configuration Method

</td><td data-colwidth="340">Enable/disable the DHCP server. If the DHCP server is disabled, the IP address of the device has to be set manually.

</td></tr><tr><td data-colwidth="340">IP Address

</td><td data-colwidth="340">IP address of the device.

</td></tr><tr><td data-colwidth="340">Netmask

</td><td data-colwidth="340">Netmask associated with the IP address.

</td></tr><tr><td data-colwidth="340">Gateway

</td><td data-colwidth="340">Gateway address currently used by the device.

</td></tr><tr><td data-colwidth="340">DNS Address

</td><td data-colwidth="340">Domain Name System used by the device.

</td></tr><tr><td data-colwidth="340">MAC Settings

</td><td data-colwidth="340">Allow setting the default MAC address or typing it manually.

</td></tr><tr><td data-colwidth="340">MAC Address

</td><td data-colwidth="340">Allow changing the physical address of the device.

</td></tr><tr><td data-colwidth="340">HTTP Port

</td><td data-colwidth="340">Determine the port of the control panel.

</td></tr><tr><td data-colwidth="340">Telnet Port

</td><td data-colwidth="340">Allow connection with the device via Telnet.

</td></tr><tr><td data-colwidth="340">Modbus TCP Listening Port

</td><td data-colwidth="340">Used as an entry point for new Modbus TCP connections.

</td></tr></tbody></table>

#### Device page

<table border="1" id="bkmrk-item-description-fir" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><thead><tr><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Item**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Description**

</td></tr></thead><tbody><tr><td data-colwidth="340">Firmware Update

</td><td data-colwidth="340">Update firmware.

</td></tr><tr><td data-colwidth="340">Factory Reset

</td><td data-colwidth="340">Restore default ports settings and default network configuration.

</td></tr><tr><td data-colwidth="340">Reboot

</td><td data-colwidth="340">Reboot the device.

</td></tr><tr><td data-colwidth="340">About

</td><td data-colwidth="340">Basic information about the device.

</td></tr></tbody></table>

### Configuration by the Serial Console

#### List of all commands

<table border="1" id="bkmrk-command-description-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><thead><tr><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Command**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="340">**Description**

</td></tr></thead><tbody><tr><td data-colwidth="340">help

</td><td data-colwidth="340">Print the help.

</td></tr><tr><td data-colwidth="340">conn

</td><td data-colwidth="340">Print active TCP connections.

</td></tr><tr><td data-colwidth="340">net\_stat

</td><td data-colwidth="340">Print lwIP statistics.

</td></tr><tr><td data-colwidth="340">eth\_mac

</td><td data-colwidth="340">Print or change MAC address.

</td></tr><tr><td data-colwidth="340">ipconfig

</td><td data-colwidth="340">Print or change the network configuration.

</td></tr><tr><td data-colwidth="340">http\_port

</td><td data-colwidth="340">Print or change default http port.

</td></tr><tr><td data-colwidth="340">telnet\_port

</td><td data-colwidth="340">Print or change default telnet port.

</td></tr><tr><td data-colwidth="340">modbus\_tcp\_port

</td><td data-colwidth="340">Print or change modbus port.

</td></tr><tr><td data-colwidth="340">ping

</td><td data-colwidth="340">Check internet connection with the desired host.

</td></tr><tr><td data-colwidth="340">restart

</td><td data-colwidth="340">Restart the system.

</td></tr><tr><td data-colwidth="340">user

</td><td data-colwidth="340">Print or change user configuration.

</td></tr><tr><td data-colwidth="340">sys\_heap\_usage

</td><td data-colwidth="340">Print current heap usage.

</td></tr><tr><td data-colwidth="340">modbus

</td><td data-colwidth="340">Print or changes modbus settings.

</td></tr><tr><td data-colwidth="340">modbus\_ports

</td><td data-colwidth="340">Print or changes modbus ports settings.

</td></tr><tr><td data-colwidth="340">modbus\_routing

</td><td data-colwidth="340">Print or change modbus routing settings.

</td></tr><tr><td data-colwidth="340">exit

</td><td data-colwidth="340">Exit console.

</td></tr></tbody></table>

#### List of commands in the service mode  


<table border="1" id="bkmrk-command-description--1" style="border-collapse: collapse; width: 100%; height: 357.563px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="379" style="height: 29.7969px;">**Command**

</td><td aria-sort="Brak" class="ak-renderer-tableHeader-sortable-column__wrapper align-center" data-colwidth="378" style="height: 29.7969px;">**Description**

</td></tr></thead><tbody><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">help

</td><td data-colwidth="378" style="height: 29.7969px;">Print the help.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">credits

</td><td data-colwidth="378" style="height: 29.7969px;">Print current credits value for this device.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">dev\_ident

</td><td data-colwidth="378" style="height: 29.7969px;">Print the device identification value.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">restart

</td><td data-colwidth="378" style="height: 29.7969px;">Restart the system.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">serial\_num

</td><td data-colwidth="378" style="height: 29.7969px;">Print the serial number of this device.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">version

</td><td data-colwidth="378" style="height: 29.7969px;">Display the bootloader version.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">xmodem

</td><td data-colwidth="378" style="height: 29.7969px;">Download image to the internal flash using xmodem.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">defaults

</td><td data-colwidth="378" style="height: 29.7969px;">Reset application variables to defaults.

</td></tr><tr style="height: 29.7969px;"><td data-colwidth="379" style="height: 29.7969px;">ipconfig

</td><td data-colwidth="378" style="height: 29.7969px;">Print or change the network configuration.

</td></tr></tbody></table>

<p class="callout warning">In the service mode, the “ipconfig” command can only show a last static IP address.</p>

# New Page



# New Page



# Commands

##### Modbus ports configuration commands

- **modbus**
    - **modbus help**  
        Print command help.
    - **modbus int\_addr VALUE**  
        Set internal Modbus address.  
          
        Example:  
        modbus int\_addr 5
    - **modbus idlet VALUE**  
        Show or set the idle TIME (in seconds) of the TCP connection after which the TCP connection is terminated by the converter and the TCP socket is released.  
          
        Example:  
        modbus idlet 720  
          
        If a subcommand that normally sets a value is not given an argument, it will print the current value.  
          
        Example:  
        modbus idlet  
        Set idle time is 5000
- **modbus\_ports**
    - **modbus\_ports help**  
        Print command help, does not require com\_number.
    - **modbus\_ports PORT\_NUMBER add\_slaves \[SLAVE\_ADDR ;/- SLAVE\_ADDR, \*\]**  
        Set all addresses of slaves connected to com\_port. A star in value means fill rest free slaves. It means all slaves that are not set to other ports will be set to this one.  
          
        Example:  
        modbus\_ports 1 addslaves 124  
          
        Example:  
        modbus\_ports 1 addslaves 12-124  
          
        Example:  
        modbus\_ports 1 addslaves 12;14;18  
          
        Example:  
        modbus\_ports 1 addslaves 12;14-17;150-200  
          
        Example:  
        modbus\_ports 1 addslaves 12;14-17;150-200, \*
    - **modbus\_ports PORT\_NUMBER show\_slaves**  
        Show addresses of slaves connected to com\_port.  
          
        Example:  
        modbus\_ports 1 showslaves
    - **modbus\_ports PORT\_NUMBER mode \[ascii/rtu\]**  
        Set Modbus port mode to ASCII or RTU.  
          
        Example:  
        modbus\_ports 2 mode ascii
    - **modbus\_ports PORT\_NUMBER baud \[RATE\]**  
        Set the baud rate to RATE. For a list of acceptable baud rates, please refer to the manual.  
          
        Example:  
        modbus\_ports 1 baud 9600
    - **modbus\_ports PORT\_NUMBER bits \[CPS\]**  
        Set bit count to C, parity to P, and stop bits to S. Valid values are:  
        C: 7, 8 or 9  
        P: N, E or O (N- none, E- even, O- odd)  
        S: 1 or 2  
          
        Example:  
        modbus\_ports 1 bits 8N1  
          
        Example:  
        modbus\_ports 2 bits 7O1
    - **modbus\_ports PORT\_NUMBER state \[GATEWAY/ROUTER/DISABLE\]**  
        Enable or disable uart functionality.   
          
        Example:  
        modbus\_ports 1 state GATEWAY  
          
        Example:  
        modbus\_ports 2 state DISABLE
    - **modbus\_ports PORT\_NUMBER termination \[on/off\]**  
        Enable or disable termination on RS485 port.   
          
        Example:  
        modbus\_ports 1 termination on
    - **modbus\_ports PORT\_NUMBER slave\_response\_timeout TIMEOUT**  
        Set response timeout (serial slave) in ms. When this timeout expires, delayed frames are dropped.  
          
        Example:  
        modbus\_ports 1 slave\_response\_timeout 2000  
          
        If a subcommand that normally sets a value is not given an argument, it will print the current value.  
          
        Example:  
        modbus\_ports 2 baud  
        Set baud rate is 115200

<p class="callout info">PORT\_NUMBER is a number of ports in modbus gateway and it is counted from 0.</p>

- **modbus\_routing**
    - **modbus\_routing help**  
        Print routing's help.
    - **modbus\_routing show**  
        Display all active routing table in system.  
        \[LP\]: \[SLAVES NUMBERS\] \[IP/HOSTNAME\] \[PORT\] \[TIMEOUT\]
    - **modbus\_routing add SLAVE\_ADDR HOSTNAME PORT TIMEOUT**  
        SLAVE\_ADDR with HOSTNAME PORT is used by uarts working in Modbus router mode. TIMEOUT (in ms) is used to close the connection if a slave is not responding. The maximum records is 8. One record for one address/ip.  
          
        Example:  
        modbus\_routing add 18 192.168.0.10 502 2000  
          
        Example:  
        modbus\_routing add 18;25 192.168.0.10 502 2000  
          
        Example:  
        modbus\_routing add 18-25 192.168.0.10 502 2000  
          
        Example:  
        modbus\_routing add 18-25;\* 192.168.0.10 502 2000  
          
        Example:  
        modbus\_routing add 18-25 modbus.local 502 2000
    - **modbus\_routing remove \[HOSTNAME\_NUMBER/all\]**  
        Remove Modbus Routing Table record. HOSTNAME\_NUMBER is line number from /show/ command.  
          
        Example:  
        modbus\_routing remove 2  
          
        Example:  
        modbus\_routing remove all

##### Network settings

The following commands might be helpful to change network settings according to target LAN parameters,

- **ipconfig**
    - **ipconfig addr ADDRESS**  
        Set IP address to ADDRESS.  
          
        Example:  
        ipconfig addr 192.168.0.10
    - **ipconfig mask NETMASK**  
        Set subnet mask to NETMASK (in dot-decimal format).  
          
        Example:  
        ipconfig mask 255.255.255.0
    - **ipconfig mask BIT\_COUNT**  
        Set subnet mask to BIT\_COUNT bits.  
          
        Example:  
        ipconfig mask 24
    - **ipconfig gateway GATEWAY\_IP**  
        Set network gateway to GATEWAY\_IP.  
          
        Example:  
        ipconfig gateway 192.168.0.1
    - **ipconfig dhcp \[enable/disable\]**  
        Enable or disable DHCP client.  
          
        Example:  
        ipconfig dhcp enable
    - **ipconfig dns1 ADDRESS**  
        Set primary DNS to ADDRESS, disable getting DNS from DHCP if enabled.  
          
        Example:  
        ipconfig dns1 192.168.100.1
    - **ipconfig dns2 ADDRESS**  
        Set secondary DNS to ADDRESS, disable getting DNS from DHCP if enabled.  
          
        Example:  
        ipconfig dns2 1.1.1.1
- **eth\_mac**
    - **eth\_mac help**  
        Print the help message.
    - **eth\_mac default**  
        Set device’s MAC address to factory-default one.
    - **eth\_mac set MAC\_ADDR**  
        Set device’s MAC address to MAC\_ADDR. Accepts both dash and colon-separated formats.  
          
        Example:  
        eth\_mac set 01-02-03-04-05-06  
          
        Example:  
        eth\_mac set 01:02:03:04:05:06
- **http\_port**
    - **http\_port help**  
        Print the help message.
    - **http\_port PORT\_NUMBER**  
        Set http port to PORT\_NUMBER. A PORT\_NUMBER value must be in range: 1-65535.  
          
        Example:  
        http\_port 80
    - **http\_port status**  
        Print current http port.  
          
        Example:  
        http\_port status  
        A current http port is 80
- **telnet\_port**
    - **telnet\_port help**  
        Print the help message.
    - **telnet\_port PORT\_NUMBER**  
        Set Telnet port to PORT\_NUMBER. A PORT\_NUMBER value must be in range: 1-65535.  
          
        Example:  
        telnet\_port 23
    - **telnet\_port status**  
        Print current Telnet port.  
          
        Example:  
        telnet\_port status  
        A current telnet port is 23
- **modbus\_tcp\_port**
    - **modbus\_tcp\_port help**  
        Print the help message.
    - **modbus\_tcp\_port PORT\_NUMBER**  
        Set http port to PORT\_NUMBER. A PORT\_NUMBER value must be in range: 1-65535.  
          
        Example:  
        modbus\_tcp\_port 502
    - **modbus\_tcp\_port status**  
        Print current Modbus port.  
          
        Example:  
        modbus\_tcp\_port status  
        A current modbus port is 502

##### Changing username or password

To change username or password, use user command. Available commands:

- **user help**  
    Print the help message.
- **user mod\_name USER\_NAME NEW\_NAME**  
    Change the user name to NEW\_NAME. It fails if the name is used by another user.  
      
    Example:  
    user mod\_name admin NEW\_NAME
- **user passwd USER\_NAME**  
    Change USER\_NAME's password.  
      
    Example:  
    user passwd admin  
    \*\*\*\*\*\* &lt;- here is entered password, but '\*' appears instead  
      
    Note: Everyone can change the password for themselves.

# Procedures

### Configuration by the Serial Console  


#### Procedure to enter serial console mode on G01 - G03

- Turn off the power of the device.
- Connect Ethernet converter to the dedicated USB/UART converter via the microUSB port.
- Connect the USB/UART converter to the PC.
- Open the serial console (default baud rate is 115200 bps).
- Press and hold the S1 button.
- Turn on the power.
- Wait until the ST indicator (<span style="color: rgb(230, 126, 35);">orange </span>LED) lights up (it should light up after red light - service mode).
- Release the S1 button.
- Login using user’s personal credentials or default login details.
- If the process is successful, configuration command can be typed into the terminal.

#### Procedure to enter serial console mode on G14 - G16

- Install STM32 Virtual COM Port Driver.
- Turn off the power of the device.
- Connect Ethernet converter directly to the PC (the dedicated USB/UART converter is not obligatory).
- Open the serial console (default baud rate is 115200 bps).
- Press and hold the S1 button.
- Turn on the power.
- Wait until the ST indicator (<span style="color: rgb(241, 196, 15);">yellow </span>LED) lights up.
- Release the S1 button.
- Login using user’s personal credentials or default login details.
- If the process is successful, configuration command can be typed into the terminal.

### Service mode

#### Procedure to enter service mode for G01 - G03 gateways

- Turn off the power of the device.
- Connect Ethernet converter to the dedicated USB/UART converter via the microUSB port.
- Connect the USB/UART converter to the PC.
- Open the serial console (default baud rate is 115200 bps).
- Press and hold the S1 button.
- Turn on the power.
- Wait until the ST indicator (<span style="color: rgb(224, 62, 45);">red </span>LED) lights up.
- Release the S1 button.
- If the process is successful, service commands can be typed into the terminal.

#### Procedure to enter service mode for G14 - G16 gateways

- Install STM32 Virtual COM Port Driver (if it was not done before).
- Turn off the power of the device.
- Connect Ethernet converter directly to the PC (the dedicated USB/UART converter is not obligatory).
- Open the serial console (default baud rate is 115200 bps).
- Press and hold the S1 button.
- Turn on the power.
- Wait until the ST indicator (<span style="color: rgb(224, 62, 45);">red </span>LED) lights up.
- Release the S1 button.
- If the process is successful, service commands can be typed into the terminal.

# Introduction

## Modbus Ethernet Gateways (G01 - G03 &amp; G14 - G16)

Modbus gateways allow data transmission between LAN hosts and serial devices by converting Modbus protocols (Modbus TCP and Modbus RTU/ASCII). They are intended to be used in industrial networks especially in the field of Industry 4.0 but not only. Apart from extending the capabilities of industrial devices, they can be also adapted up to user’s requirements and needs.

Transmission is carried out by two modes: Gateway and Router. In the Gateway mode, the port is used to communicate with Slave devices, but in the Router mode with Master devices. It is also possible to set up different modes on every port. Block diagrams below describe how each of these modes works.

<div drawio-diagram="1358"><img src="https://doc.redisage.com/uploads/images/drawio/2025-07/drawing-29-1753771775.png" alt=""/></div>

<p class="callout warning">The device has max 20 sockets open in Gateway mode and max 8 in Router mode. It is possible to increase this value at client's request.</p>