Jump to content
  • EN

DNP3 TCP Client Configuration example: Difference between revisions

DNP3 TCP Client Configuration example (view source)

Revision as of 11:44, 22 October 2024

31 bytes removed ,  22 October
no edit summary
VisualWikitext
No edit summary
No edit summary
Line 1: Line 1:
==Summary==
==Summary==
'''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).
'''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 “Client station” and Remote Terminal Units (RTUs) or Intelligent Electronic Devices (IEDs).


This example provides an Step by Step instructions on how to configure DNP3 functionality in RUTX11 device. In this RutX11 is configured as the TCP Master and DNP3 outstation to send data to a remote HTTPS server.
This example provides an Step by Step instructions on how to configure DNP3 functionality in RUTX11 device. In this RUTX11 is configured as the TCP Client and DNP3 outstation to send data to a remote HTTPS server.


==INSTALLING DNP3 PACKAGE==
==INSTALLING DNP3 PACKAGE==


DNP3 can be installed using the package manager
DNP3 can be installed using the package manager.


Open the ‘Services’ tab and click the ‘Package Manager’ button. On DNP3 click the ‘+’ button to install DNP3 package.
Go to your devices '''WebUI → System → Package Manager''' and install the '''DNP3''' package.
[[File:Networking rutx11 example DNP3 installing dnp3 package v1.png|border| class=tlt-border]]


After that navigate to Services→DNP3
[[File:Networking_RutOS_configuration_example_dnp3_2.png|border|class=tlt-border|alt=|1100px]]


[[File:Networking rutx11 example DNP3 service features v1.png|border|class=tlt-border]]


==DNP3 TCP Client==


DNP3 Protocol contains two features. TCP MASTER and DNP3 OUTSTATION.
TCP Client requests specific information from DNP3 outstation through the communication channel.


==DNP3 TCP MASTER==
After the installation of '''DNP3''' package, navigate to '''Services → DNP3 → DNP3 TCP Client''' and click on '''Add''' button to add a new DNP3 instance.


TCP Master requests specific information from DNP3 outstation through the communication channel.
[[File:Networking_RutOS_configuration_example_dnp3_1.png|border|class=tlt-border|alt=|1100px]]


To setup TCP MASTER click on the TCP Master Button and click ‘ADD’ to add a new master.
===TCP Configuration===
[[File:Network rutx example DNP3 TCP master overview.png|border|class=tlt-border|alt=|900x900px]]


===TCP Configuration===
On this section we configure the parameters of the DNP3 Outstation that the Client will be querying with requests:


On this section we configure the parameters of the DNP3 Outstation that the Master will be querying with requests.
#'''Enable''' the instance;
#Choose your desired '''Name''';
#Choose the '''IP address''' - in this case we used routers LAN IP address;
#Choose the '''Port''' via which the communication will be done;
#Choose the '''Local Address''';
#Choose the '''Remote Address''';
#Choose the '''Period''';
#Choose the '''Timeout''';


[[File:Networking rutx11 example DNP3 tcp master configuration v1.png|border|class=tlt-border|alt=|924x924px]]
[[File:Networking_RutOS_configuration_example_dnp3_3.png|border|class=tlt-border]]


===Requests Configuration===
===Requests Configuration===


To obtain data from DNP3 Outstation configure a DNP3 instance. The DNP3 Master will send a request to DNP3 outstation specifying the function codes to be sent. The outstation then sends the requested data back to the DNP3 Master.
To obtain data from DNP3 Outstation, we will need to configure a DNP3 instance. The DNP3 Client will send a request to the DNP3 outstation specifying the function codes to be sent. The outstation then sends the requested data back to the DNP3 Client.


On the ‘ADD NEW INSTANCE SECTION’ type the name of the instance. In this example we want to read the serial number, so we type ‘serial’.
Refer to [[RUTX11 DNP3#DNP3 Parameters|DNP3 Parameters]] for which parameters you want to read.
[[File:Requests config.png|border|class=tlt-border|alt=|900x900px]]


On the '''ADD NEW INSTANCE SECTION''' type the name of the instance. In this example, we want to read the serial number, so we will use the name '''Serial''':


Refer to [[RUTX11 DNP3#DNP3 Parameters|DNP3 Parameters]] and set the serial parameter.
#Specify the '''name''' of request;
#Click on '''Add''' button;
#Write the '''Start Index''' value;
#Write the '''End Index''' value;
#Choose the '''Data type''';
#'''Enable''' the request;
#Click on '''Save & Apply''' button once you are done configuring;


The serial parameter is '5' with the group type 'octet string' and then ‘SAVE & APPLY’
[[File:Networking_RutOS_configuration_example_dnp3_4.png|border|class=tlt-border|alt=|1100px]]
[[File:Networking rutx example DNP3 Instance settings v1.png|border|class=tlt-border|alt=|900x900px]]


TCP MASTER should look like this.
----
[[File:Networking rux11 example DNP3 tcp master configurdv1.png|border|class=tlt-border]]


DNP3 OUTSTATION
TCP Client should look like this:
[[File:Networking_RutOS_configuration_example_dnp3_5.png|border|class=tlt-border|1100px]]


A DNP3 Outstation component communicates with a single master via a communication channel.
==DNP3 OUTSTATION==


To configure the DNP3 Outstation Go to Services→ DNP3→ DNP3 OUTSTATION
A DNP3 Outstation component communicates with a single Client via a communication channel.
 
To configure the DNP3 Outstation Go to '''Services → DNP3 → DNP3 OUTSTATION'''


===DNP3 Outstation Configuration===
===DNP3 Outstation Configuration===
[[File:Networks rutx example DNP3 outstation config v1.png|border|class=tlt-border|alt=|900x900px]]


#'''Enable''' the instance;
#Write the '''Local Address''';
#Write the '''Remote Address''';
#Write the '''Port''' via which the communication should be done;
#'''Enable Allow Remote Access''' if you wish to communicate externally;


'''NOTE: Th'''e Local Address and the Remote Address configuration in TCP Master and DNP3 Outstation are configured in reverse such that the Local address in TCP Master is the Remote address in the DNP3 Outstation and vice versa.
[[File:Networking_RutOS_configuration_example_dnp3_6.png|border|class=tlt-border]]


==TESTING DNP3==


To test DNP3 protocol set up an account with the [https://beeceptor.com/ beeceptor] and create an endpoint.
'''NOTE:''' The Local Address and the Remote Address configuration in TCP Client and DNP3 Outstation are configured in reverse such that the Local address in TCP Client is the Remote address in the DNP3 Outstation and vice versa.
[[File:Networking rutx11 example DNP3 endpoint creating beeceptor v1.png|border|class=tlt-border]]


==TESTING DNP3==


Create the DNP3 Testing endpoint and copy the generated endpoint link as shown below.
To test DNP3 protocol, we can go to '''Services → DNP3 → DNP3 TCP Client''' and edit the TCP client that we had set up:
[[File:Networking rutx11 example DNP3 dnp3testing endpoint v1.png|border|class=tlt-border]]
 
===Data to Server===
 
Navigate to Services → Data to Server and set up the server.
 
Set the JSON according to the kind of data you want to include. For this example, we will use.
 
{"Date": "%d", "Remote IP": %r, "Data": %o}
[[File:Networks rutx example DNP3 data to server v1.png|border|class=tlt-border|alt=|925x925px]]
 


Proceed to [https://beeceptor.com/ beeceptor] to check the results
[[File:Networking_RutOS_configuration_example_dnp3_8.png|border|class=tlt-border|alt=|1100px]]
----


[[File:Networking rutx11 example DNP3 dnp3testing beeceptor post v1.png|border|class=tlt-border]]
Then scroll down to the '''Request configuration testing''' section and choose the request you want to test and click on '''Test''' button. It should show you the output of your request:


[[File:Networking_RutOS_configuration_example_dnp3_7.png|border|class=tlt-border|alt=|1100px]]


Click on POST to check the results. You should see results like this.
[[File:Networking rutx11 example DNP3 dnp3testing results v1.png|border|class=tlt-border]]


[[Category:DNP3]]
[[Category:DNP3]]
Retrieved from "https://wiki.teltonika-networks.com/view/Special:MobileDiff/134645"