RUTXR1 DNP3

From Teltonika Networks Wiki
Main Page > RUTX Routers > RUTXR1 > RUTXR1 Manual > RUTXR1 WebUI > RUTXR1 Services section > RUTXR1 DNP3

The information in this page is updated in accordance with firmware version RUTX_R_00.07.01.

Summary[edit | edit source]

Distributed Network Protocol 3 (DNP3) is a set of communications protocols used between components in process automation systems. It is primarily used for communications between a master station and Remote Terminal Units (RTUs) or Intelligent Electronic Devices (IEDs).

This manual page provides an overview of the DNP3 functionality in RUTXR1 devices.

Note: DNP3 is additional software that can be installed from the Services → Package Manager page.

DNP3 Parameters[edit | edit source]

DNP3 parameters are held within indexes. The index numbers and corresponding system values are described in the table below:

required value index group type
Uptime 0 Counter
Signal Strength 1 Octet String
Modem temperature (in 0.1 °C) 2 Octet String
Hostname 3 Octet String
Operator 4 Octet String
Router Serial Number 5 Octet String
LAN MAC Address 6 Octet String
Router name 7 Octet String
Currently active SIM card slot 8 Octet String
Network state 9 Octet String
Connection state 10 Octet String
Mobile data received today (SIM1) 20 Counter
Mobile data sent today (SIM1) 21 Counter
Mobile data received this week (SIM1) 22 Counter
Mobile data sent this week (SIM1) 23 Counter
Mobile data received this month (SIM1) 24 Counter
Mobile data sent this month (SIM1) 25 Counter
Mobile data received last 24h (SIM1) 26 Counter
Mobile data sent last 24h (SIM1) 27 Counter
Mobile data received last week (SIM1) 28 Counter
Mobile data sent last week (SIM1) 29 Counter
Mobile data received last month (SIM1) 30 Counter
Mobile data sent last month (SIM1) 31 Counter
Mobile data received today (SIM2) 32 Counter
Mobile data sent today (SIM2) 33 Counter
Mobile data received this week (SIM2) 34 Counter
Mobile data sent this week (SIM2) 35 Counter
Mobile data received this month (SIM2) 36 Counter
Mobile data sent this month (SIM2) 37 Counter
Mobile data received last 24h (SIM2) 38 Counter
Mobile data sent last 24h (SIM2) 39 Counter
Mobile data received last week (SIM2) 40 Counter
Mobile data sent last week (SIM2) 41 Counter
Mobile data received last month (SIM2) 42 Counter
Mobile data sent last month (SIM2) 43 Counter

External Modem Parameters


If you are using an external modem on your device, use these index numbers for corresponding system values:

required value index group type
Modem VID and PID 100 + 50 * modem_number Octet String
Mobile data received today (SIM1) 101 + 50 * modem_number Counter
Mobile data sent today (SIM1) 102 + 50 * modem_number Counter
Mobile data received this week (SIM1) 103 + 50 * modem_number Counter
Mobile data sent this week (SIM1) 104 + 50 * modem_number Counter
Mobile data received this month (SIM1) 105 + 50 * modem_number Counter
Mobile data sent this month (SIM1) 106 + 50 * modem_number Counter
Mobile data received last 24h (SIM1) 107 + 50 * modem_number Counter
Mobile data sent last 24h (SIM1) 108 + 50 * modem_number Counter
Mobile data received last week (SIM1) 109 + 50 * modem_number Counter
Mobile data sent last week (SIM1) 110 + 50 * modem_number Counter
Mobile data received last month (SIM1) 111 + 50 * modem_number Counter
Mobile data sent last month (SIM1) 112 + 50 * modem_number Counter
Mobile data received today (SIM2) 113 + 50 * modem_number Counter
Mobile data sent today (SIM2) 114 + 50 * modem_number Counter
Mobile data received this week (SIM2) 115 + 50 * modem_number Counter
Mobile data sent this week (SIM2) 116 + 50 * modem_number Counter
Mobile data received this month (SIM2) 117 + 50 * modem_number Counter
Mobile data sent this month (SIM2) 118 + 50 * modem_number Counter
Mobile data received last 24h (SIM2) 119 + 50 * modem_number Counter
Mobile data sent last 24h (SIM2) 120 + 50 * modem_number Counter
Mobile data received last week (SIM2) 121 + 50 * modem_number Counter
Mobile data sent last week (SIM2) 122 + 50 * modem_number Counter
Mobile data received last month (SIM2) 123 + 50 * modem_number Counter
Mobile data sent last month (SIM2) 124 + 50 * modem_number Counter
Modem temperature (in 0.1 °C) 125 + 50 * modem_number Octet String
Operator 126 + 50 * modem_number Octet String
Network state 127 + 50 * modem_number Octet String
Connection state 128 + 50 * modem_number Octet String
Signal Strength 129 + 50 * modem_number Octet String

The modem_number of the external modem is 0 (internal modem is skipped).

To get the exact index of a parameter, use the formula in the table above. For example, the index of an external modem operator is 126. Formula is: 126 + 50 * 0.

TCP Master[edit | edit source]

A master in DNP3 is a component that communicates (requests data) with a single outstation via a communication channel. By default, the master list is empty. To add a new master, click the 'Add' button.

Networking rutos manual dnp3 tcp master add button.png

After clicking 'Add' you will be redirected to the newly added master's configuration page.

TCP Master Configuration[edit | edit source]


The TCP Master Configuration section is used to configure the parameters of a DNP3 Outstation that the Master (this RUTXR1 device) will be querying with requests. The figure below is an example of the TCP Master Configuration and the table below provides information on the fields contained in that section:

Networking rutos manual dnp3 tcp master tcp master configuration.png

Field Value Description
Enable off | on; default: off Turns communication with the outstation device on or off.
Name string; default: none Name of the TCP master, used for easier management purposes.
IP address ip; default: none DNP3 Outstation IP address.
Port integer [0..65535]; default: none DNP3 Outstation Port.
Local Address integer [0..65535]; default: none Master Link-Layer address.
Remote Address integer [0..65535]; default: none Outstation Link-Layer address.
Period integer [1..60]; default: none Interval at which requests are sent to the outstation device.
Timeout integer [1..60]; default: none Maximum response wait time.

Requests Configuration[edit | edit source]


A DNP3 request is a way of obtaining data from DNP3 Outstations. The master sends a request to an outstation specifying the function codes to be performed. The outstation then sends the requested data back to the DNP3 master.

The Request Configuration list is empty by default. To add a new Request Configuration look to the Add New Instance section. Enter a custom name into the 'New Configuration Name' field and click the 'Add' button:

Networking rutos manual dnp3 tcp master tcp master configuration requests configuration add new instance v2.png

The new Request Configuration should become visible in the list:

Networking rutos manual dnp3 tcp master requests configuration.png

Field Value Description
Name string; default: Unnamed Name of this Request Configuration. Used for easier management purposes.
Start Index integer [0..65535]; default: none Start index of the data subarray.
End Index integer [0..65535]; default: none End index of the data subarray.
Data Type Binary | Double Binary | Counter | Frozen Counter | Analog | Octet String | Analog Output Status | Binary Output Status; default: Binary Data object group of the requested index(-es).
off/on slider off | on; default: off Turns the request on or off.


DNP3 Outstation[edit | edit source]

An outstation in DNP3 is a component that communicates with a single master via a communication channel. It makes measurements of the physical world and then sends them to a master upon request (solicited) or on its own accord (unsolicited). Occasionally a master requests that it do something by sending it a control. This provides the user with the possibility to get system parameters.

The figure below is an example of the DNP3 Outstation window section and the table below provides information on the fields contained in that window:

Networking rutos manual dnp3 dnp3 outstation.png

Field Value Description
Enable off | on; default: off Turns DNP3 Outstation on or off.
Local Address integer [0..65535]; default: none Outstation Link-Layer address.
Remote Address integer [0..65535]; default: none Master Link-Layer address.
Unsolicited enabled off | on; default: none Enables the transmission of unsolicited messages.
Protocol TCP | UDP; default: TCP Protocol used for DNP3 communications.
Port integer [0..65535]; default: 502 Port used for DNP3 communications.
UDP response address ipv4; default: none UDP response address.
UDP response port integer [0..65535]; default: none UDP response port.
Allow Remote Access off | on; default: off Allows remote DNP3 connections by adding an exception to the device's firewall on the port specified in the field above.