# 12.2 DNP 3.0 Master Default group and variation sets are used to send commands. If slave devices support different groups and variations, they can be adjusted in Excel configuration. For more information check section Excel configuration. #### Configuring datapoints To use DNP3 Master in WCC Lite, it has to be configured via an Excel configuration. This configuration contains two Excel sheets where parameters have to be filled in Devices and Signals. ##### DNP3 Master parameters for Devices tab

Parameter	Type	Description	**Required	Default value (when not specified)	Range
Parameter	Type	Description	**Required	Default value (when not specified)	Min	Max
name	string	User-friendly device name	Yes
description	string	Description of a device	No
device\_alias	string	Alphanumeric string to identify a device	Yes
enable	boolean	Enabling/disabling of a device	No	1	0	1
protocol	string	Protocol to be used (”dnp3 serial”/”dnp3 tcp” (case insensitive))	Yes
mode	string	Choosing between TCP, TLS and SERIAL modes . If protocol provided DNP3 TCP mode defaults to tcp and if DNP3 serial is provided mode defaults to serial	No	TCP or SERIAL	TCP, SERIAL
ip	string	IP address of TCP slave device	Yes (for TCP).
bind\_address	string	IP address of network adapter used to connect to slave device	No (for TCP)	0.0.0.0
port	integer	TCP communication port	No (for TCP)	20000
device	integer	Communication port (”PORT1” or ”PORT2”)	Yes (for SERIAL)
baudrate	integer	Communication speed, bauds/s	No (for SERIAL)	9600	300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600,115200
databits	integer	Data bit count for communication	No (for SERIAL)	8	6	9
stopbits	integer	Stop bit count for communication	No (for SERIAL)	1	0	2
parity	string	Communication parity option	No (for SERIAL)	none	none, even, odd
flowcontrol	string	Communication device flow control option.	No (for SERIAL)	none	none
tls	boolean	Enable/disable use of TLS	Yes (for TLS)	0	0	1
tls\_local\_certificate	string	Local certificate for TLS connection	Yes (for TLS)
tls\_peer\_certificate	string	Certificate authority file for TLS connection	No (for TLS)
tls\_private\_key	string	File consisting of private key for TLS connection	No (for TLS)
max\_rx\_frag\_size	integer	Maximum size of a received fragment.	No	2048	0	2048
destination\_address	integer	Address of a master station	No	1	0	65535
source\_address	integer	Address of a slave (local) station.	No	1	0	65535
unsol\_disable	bool	Disables unsolicited messages on startup. Overrides unsol\_classes parameter.	No	0	0	1
unsol\_classes	string	Defines which classes will have unsolicited actions on startup. Can be overriden with unsol\_disable. (Example: "1,3,2")	No	no class	1	3
groups\_scan\_mask	integer	Bitmask for enabling separate group scans with x06 qualifier (all objects): 0 - Binary, 1 - Doublebit Binary, 2 - Binary Output Status, 3 - Counter, 4 - Frozen Counter, 5 - Analog, 6 - Analog Output Status, 7 - Octet String	No	0	0	7
groups\_scan\_interval	integer, string	Time between separate groups scans intervals in seconds. Set to 0 to disable.	No	0	0
exception\_scan\_interval	integer, string	Time between exception scan (classes 1,2,3) intervals in seconds. Set to 0 to disable.	No	0	0
integrity\_scan\_interval	integer, string	Time between integrity scan (classes 0,1,2,3) intervals in seconds (general interrogation). Set to 0 to disable.	No	0	0
timesync\_mode	string	Will override masters default setting for choosing timesync procedure	No	NON-LAN(for Serial) LAN (for tcp)	LAN, NON-LAN
time\_sync\_interval\_sec	integer, string	Periodic time sync interval in seconds. If 0 < - time syncs are forced and periodic. If = 0 - time syncs react to IIN bits from slave. If < 0 - time syncs are disabled.	No	0	0
select\_ms	integer	Select command timeout. Valid for all signals.	No	10000
timeout\_ms	integer	Response timeout in milliseconds	No	2000
keep\_alive\_timeout	integer	Time interval for sending a keep alive packet in milliseconds.	No	60

##### DNP3 Master parameters for Signals tab

Parameter	Type	Description	**Required	Default value (when not specified)	Range
Parameter	Type	Description	**Required	Default value (when not specified)	Min	Max
signal\_name	string	User-friendly signal name	Yes
device\_alias	string	Device alias from a Devices tab	Yes
signal\_alias		Unique alphanumeric name of the signal to be used	Yes
enable	boolean	Enabling/disabling a device	No	1	0	1
index	integer	Index of a signal.	Yes		0	65535
log	boolean	Enable logging in the event log	No	0	0
signal\_type	string	DNP3 signal type. (case insensitive)	Yes		”BINARY”, ”ANALOG”, ”DOUBLEBITBINARY” ”BINARYOUTPUTSTATUS”, ”COUNTER”, ”FROZENCOUNTER”, ”ANALOGOUTPUTSTATUS, ”OCTETSTRING”, ”TIMEANDINTERVAL”, ”BINARYOUTPUTCOMMAND”, ”ANALOGOUTPUTCOMMAND”
command\_variation	integer	DNP3 command variation. Supported variations depend on signal type and are provided in the table below	No	0	0	4
static\_variation	integer	DNP3 command variation (). Supported variations depend on signal type and are provided in the table below.	No		0, 1, 2, 3, 4, 5, 6, 9, 10
event\_variation	integer	DNP3 command variation. Supported variations depend on signal type and are provided in the table below.	No		0	8
control\_code	integer	DNP3 control model code of CROB signal. TripClose and Pulse control model requires PulseOn/off times to be set	No		LATCH, PULSE, TRIPCLOSE
pulse\_on\_time\_ms	integer	Pulse ON time in milliseconds, when using Pulse or TripClose control models must be set	No
pulse\_off\_time\_ms	integer	Pulse OFF time in milliseconds, when using Pulse or TripClose control models must be set	No
class\_num	integer	Class assignment of this signal.	No	0	0	3
operate\_type	integer		No	1	-1	1
job\_todo	string	The device status signal can be configured by providing one of the given values.	No		COMMUNICATION\_STATUS, DEVICE\_RUNNING, DEVICE\_ERROR, UNKNOWN\_ERROR

#### Debugging the DNP3 Master service If configuration for DNP3 devices is set up, handler for protocol will start automatically. If configuration is missing or contains errors, protocol will not start. It is done intentionally decrease unnecessary memory usage. DNP3 protocol runs a service called **dnp3-master**. If DNP3 does not work properly (e.g. no communication between devices, data is corrupted, etc.), a user can launch a debug session from command line interface and find out why link is not functioning properly. To launch a debugging session, a user should stop **dnp3-master** process and run **dnp3-master** command with respective flags as in the table given below. Procedure for DNP3 Master protocol service debugging: - **Step 1**: Service must be stopped by entering the following command into the wcclite: **/etc/init.d/dnp3-master stop** - **Step 2**: After service is stopped it must be started with the preferred configuration file (JSON files found in /etc/ folder) and a debug level 7: **dnp3-master -c /etc/dnp3-master/dnp3master.json -d7**Additional output forming options described in the table below. - **Step 3**: Once the problem is diagnosed normal operations can be resumed with the following command: **/etc/init.d/dnp3-master start** dnp3-master command line debugging options

Option	Description
-h \[ –help \]	Display help information
-V \[ –version \]	Show version
-p \[ –port \]	Show output for one port only
-d <debug level>	Set debugging level
-c \[ –config \]	Config path
-a \[ –app \]	Show application layer data
–l \[ –link \]	Show link layer data
–t \[ –transport \]	Show transport layer data
-r \[ –redis \]	Show Redis messages
-R \[ –readyfile \]	Ready notification file