erdi software manual...wdt watch dog timer elektronika naglič d.o.o., erdi software manual...

Elektronika Naglič d.o.o., www.naglic.si

ERDI Software Manual


REVISION: 0v1 140321


Revisions:

Revision Date Changes Notes 0.8 February 2016 Added command RADIO CHN and

Quick start guide

0.4 April 2014 Added description of the modules

0.3 April 2014 Added TCPIP

0.2 March 2014 Added description of firmware (FW)

0.1 March 2014 Initial version


ERDI Software Manual DESCRIPTION ERDI 0v7_eng

(00000002).docx page

4/42

CONTENTS

1 INTRODUCTION ........................................................................................................................................................ 6

1.1 ABBREVIATIONS ......................................................................................................................................................... 6

2 GENERAL INFORMATION ...................................................................................................................................... 7

2.1 PROCESSOR INTERNAL MEMORY ADDRESS SPACE ....................................................................................................... 7

3 RADIO STATION SETTING UP ............................................................................................................................... 8

3.1 GENERAL SETTINGS ................................................................................................................................................... 8 3.2 ACCESSORIES ............................................................................................................................................................. 8 3.3 NETWORK ID SETTINGS – CAI ................................................................................................................................... 9 3.4 CONTACTS AND GROUPS ........................................................................................................................................... 10 3.5 CHANNELS ................................................................................................................................................................ 12

4 DATA TRANSFER .................................................................................................................................................... 14

4.1 OPERATIONAL MODES .............................................................................................................................................. 14 4.2 DATA TRANSFER MODES ........................................................................................................................................... 14

4.2.1 Connection oriented data transfer mode ........................................................................................................ 15 4.2.1.1 Establishing a connection ............................................................................................................................................ 15 4.2.1.2 Closing the connection ................................................................................................................................................ 15

4.2.2 Connectionless data transfer mode ................................................................................................................ 15 4.2.3 MODBUS ASCII and MODBUS RTU data transfer modes ........................................................................... 16 4.2.4 IEC101 data transfer mode ............................................................................................................................ 16 4.2.5 DNP3 data transfer mode .............................................................................................................................. 17

5 COMMANDS .............................................................................................................................................................. 18

5.1 ABAUD – SET TRANSFER RATE ................................................................................................................................ 18 5.2 AUTOLF – TOGGLE AUTOMATIC LINE FEED ............................................................................................................. 18 5.3 AWLEN – SET THE SERIAL INTERFACE DATA PACKET LENGTH ................................................................................ 18 5.4 CHECK – SET THE CONNECTION CHECKING INTERVAL ............................................................................................ 19 5.5 CMDTIME – SET THE TIME DELAY WHEN SWITCHING TO COMMAND MODE ............................................................ 19 5.6 COMMAND – CONFIGURE COMMAND MODE ACTIVATION CONTROL CHARACTER .................................................. 19 5.7 CONMODE – SET THE MODE OF OPERATION. ..................................................................................................... 20 5.8 CONNECT – ESTABLISH CONNECTION WITH THE REMOTE RADIO STATION ............................................................. 20 5.9 CONVERS – SWITCH TO CONVERSATION MODE (DATA AS TEXT) ............................................................................ 20 5.10 CR – ENABLE PACKET SENT CONTROL CHARACTER ............................................................................................. 20 5.11 CSTATUS – DISPLAY CONNECTION STATUS OF ALL CHANNELS .......................................................................... 21 5.12 DIGIPEAT – ENABLE DIGIPEATER FUNCTIONALITIES .......................................................................................... 21 5.13 DISCONNECT – CLOSE CONNECTION ................................................................................................................ 21 5.14 DISPLAY – DISPLAY STATUS DATA .................................................................................................................... 21 5.15 ECHO – ENABLE ECHO ON THE SERIAL INTERFACE.............................................................................................. 22 5.16 EEPROM – STORE ERDI CONFIGURATION PARAMETERS .................................................................................... 22 5.17 FRACK – SET TIME DELAY FOR DATA PACKET RESEND ....................................................................................... 22 5.18 MYALIAS – SET ALTERNATIVE IDENTIFICATION TAG FOR DIGIPEATER ............................................................. 22 5.19 MYCALL – SET RADIO STATION IDENTIFICATION TAG ........................................................................................ 22 5.20 PACLEN – SET THE MAXIMUM DATA PACKET LENGTH ....................................................................................... 23 5.21 PACTIME – SET THE DATA PACKET WAITING TIME ............................................................................................. 23 5.22 PARITY – CONFIGURE SERIAL INTERFACE PARITY CHECKING ............................................................................. 23 5.23 RADIO CHN – CHANGE CHANNEL ON RADIO STATION ....................................................................................... 23 5.24 RESET – RESTORE ERDI CONFIGURATION PARAMETERS (DEFAULT SETTINGS) .................................................. 23 5.25 RESTART – RESTART ERDI ............................................................................................................................... 24 5.26 RETRY – SET THE NUMBER OF SEND RETRIES ..................................................................................................... 24 5.27 SENDPAC – CONFIGURE OUTPUT DATA PACKET CONTROL CHARACTER ............................................................. 24 5.28 TRANS – SWITCH TO CONVERSATION MODE (BINARY DATA) .............................................................................. 24 5.29 STREAMSW – CONFIGURE CHANNEL SWITCH CHARACTER ................................................................................ 24 5.30 USERS – SET THE MAXIMUM NUMBER OF CONNECTED USERS ............................................................................. 25 5.31 _ANR – CONFIGURE VALIDITY TIME OF ANR RECORDS ...................................................................................... 25 5.32 _ASTOP – CONFIGURE THE NUMBER OF STOP BITS ON THE SERIAL INTERFACE ................................................... 26




5/42

5.33 _DPCKACK – TOGGLE DATA PACKET ACKNOWLEDGMENT ................................................................................ 26 5.34 _HELP – LIST COMMANDS ................................................................................................................................... 26 5.35 _INFO – DISPLAY GENERAL INFORMATION.......................................................................................................... 26 5.36 _MBBCSD – MODBUS – CONFIGURE BROADCAST TIME DELAY ....................................................................... 27 5.37 _MBROLE – MODBUS – CONFIGURE ERDI ROLE (MASTER/SLAVE) ................................................................. 27 5.38 _MBSLP – MODBUS – SLP DIGIPEATER SLAVE TABLE ..................................................................................... 27 5.39 _MODE – SET THE OPERATION MODE .................................................................................................................. 29 5.40 _SHOWPCK – DISPLAY DATA TRAFFIC INFORMATION ....................................................................................... 29 5.41 _UNICADDR – TOGGLE DIRECT ADDRESSING ................................................................................................... 29

6 SERVICE COMMANDS ........................................................................................................................................... 30

6.1 DISPLAY STATUS ...................................................................................................................................................... 30 6.2 DISPLAY GENERAL INFORMATION............................................................................................................................. 30 6.3 SELECT DATA PORT .................................................................................................................................................. 30 6.4 NETWORK CONFIGURATION ...................................................................................................................................... 30 6.5 SAVE NEW SETTINGS ................................................................................................................................................. 30 6.6 EXTENDED COMMANDS ............................................................................................................................................ 30

6.6.1 Radio station reset .......................................................................................................................................... 30 6.6.2 ERDI reset ...................................................................................................................................................... 31 6.6.3 Additional status data..................................................................................................................................... 31 6.6.4 Debugging ...................................................................................................................................................... 31 6.6.5 MAC address .................................................................................................................................................. 31

7 QUICK START GUIDE – COM PORT .................................................................................................................. 33

8 QUICK START GUIDE – ETHERNET .................................................................................................................. 37

9 TECHNICAL SPECIFICATIONS ........................................................................................................................... 42




6/42

1 INTRODUCTION

This document provides a detailed description of ERDI (External Radio Data Interface). The device works as communication interface between Motorola' Radio Stations DM3000 or DM4000 and other equipment such as PLC's and SCADA.

1.1 Abbreviations

ANR Address Name Resolution BL Bootloader bps Bits Per Second CR Carriage Return CRC Cyclic Redundancy Check DMA Direct Memory Access FW Firmware IP Internet Protocol ISP In-System Programming OS Operating System OTP One Time Programmable TCP Transaction Control Protocol TEA Tiny Encryption Algorithm XNL Radio Station Transmission Protocol XCMP Radio Station Application Protocol WDT Watch Dog Timer




7/42

2 GENERAL INFORMATION

ERDI software consists of two separate parts: bootloader (BL) and firmware (FW). BL controls the integrity, commissioning, and upgrading of the FW, which in turn provides the software interface for the radio.

2.1 Processor internal memory address space

The processor internal memory address space is divided into two parts: non-erasable FLASH memory and working memory (RAM). FLASH memory stores the BL and FW execution code and the associated configuration data. RAM holds the operating variables, various data interfaces and stacks used by the FW. FLASH memory address space:

Start address

End address

Description Note

0x0000 0000 0x0000 EFFF Bootloader code (BL)

0x0000 F000 0x0000 FFFF Configuration data (BL)

0x0001 0000 0x0006 FFFF Firmware code (FW)

0x0007 0000 0x0007 7FFF Fixed data (OTP - FW)

0x0007 8000 0x0007 FFFF Configuration data (FW)

RAM address space:

Start address

End address

Description Note

0x1000 0000 0x1000 7FFF Working memory (BL)

0x1000 0000 0x1000 7FFF Working memory (FW)

0x2007 C000 0x2007 FFFF Working memory (Ethernet driver - FW)

0x2008 0000 0x2008 3FFF Working memory (USB host driver - FW)




8/42

3 SETTING UP THE RADIO STATION

To use the SPI-08 interface, set up the radio station via CPS. Using an USB cable, connect the MAP

socket on the back of the radio to a PC.

Warning!

When the radio and the PC are connected by an USB cable, you must disconnect the RS232 cable from

the radio front plate.

Set up the following parameters using CPS :

Radio ID

CAI Network – radio IP address

TX Preamble Duration

contacts – groups

channels

3.1 General Settings

Each radio has an individual ID that uniquely identifies it. Radio ID is used to obtain an IP address.

Figure 1: Radio Station ID

Under General Setting set the parameter »TX Preamble Duration« to 60 ms.




9/42

3.2 Accessories

Set the cable type to »Rear Data Accessory«.

Figure 2: Cable type selection in Accessories settings

3.3 Network ID settings – CAI

Obtain the CAI network ID and the radio ID from the most significant bytes of radio’s network IP

address.

E.g.:

CAI ID 10 and ID 101 from IP address: 10.0.0.101




10/42

Figure 3: CAI Newtork ID

3.4 Contacts and groups

To initialize communication with the radio station, you must first set a group call ID.

It is recommended to use the default value 1.




11/42

Figure 4: Call ID for Group call

Add the defined group to the list of subscribed groups.




12/42

Figure 5: Digital Groups List

3.5 Channels

With ERDI, you must use digital channels. Set the Group list must to “GRP1” and Contact name to

“TEST1”. We suggest to set the Admit Criteria to “Color Code Free”.

You can enable Data Call Confirmed setting if you use data transfer mode 0 (connection oriented mode).

This setting will guarantee the delivery of the data to the other radio station.




13/42

Figure 6:Channel Settings




14/42

4 DATA TRANSFER

ERDI acts as a radio communication interface for various devices. The devices can use serial data port or Ethernet port to connect to the ERDI. Data sent by the connected devices is forwarded to the local radio station through a USB connection. The local radio station then transmits the data to the remote radio station. The latter forwards the data to the ERDI which by using the appropriate communication interface (serial/Ethernet) sends the data to the connected device. Data transfer is packet oriented. A 16-bit CRC value is used to detect data corruption. Data port default settings: Data transfer rate 9600 bps Data packet size 8 bits Number of stop bits 1 stop bit Parity None Flow control None Ethernet port default settings: Data transfer rate 10/100 Mbps, automatic negotiation IP address 192.168.1.100 Gateway address 192.168.1.1 Subnet mask 255.255.255.0 TCP port 3562

4.1 Operational modes

There are two different modes in which ERDI can operate, as follows:

Command mode

Conversation mode On startup ERDI runs in command mode and waits for incoming commands from the connected users/devices. Commands can be transmitted through both, Data or Ethernet port. After 30 seconds ERDI automatically switches to conversation mode, thus enabling data transfers between local and remote devices. The user can switch back to command mode by sending the <CTRL-C> control character (default). Conversation mode can be reestablished manually by issuing a CONVERS (transfer data as text) or TRANS (transfer data in binary form) command. The default setting is to transfer data as text.

4.2 Data transfer modes

There are four types of data transfer modes supported by ERDI, as follows:

0 connection oriented mode 1 connectionless mode 2 MODBUS ASCII




15/42

3 MODBUS RTU 4 IEC101 5 DNP3

The user selects data transfer mode by issuing the _MODE command. By default ERDI uses connection oriented mode. This behaviour can be altered by changing the configuration in the appropriate section of the FLASH memory. This configuration also affects the operational mode of ERDI – if the data transfer mode is set to 0 then ERDI will boot to command mode (default), otherwise it will boot directly into conversation mode.

4.2.1 Connection oriented data transfer mode

In this mode a connection must be established to the remote ERDI unit before any data transfer can take place – this is done using the CONNECT command. To make sure that the connection is alive ERDI will periodically check the connection status depending on the configuration set with the CHECK command. After all the data has been transfered, the user/device can close the connection by issuing the DISCONNECT command. ERDI supports multiple simultaneous communication channels and can also establish a connection through a digipeater.

4.2.1.1 Establishing a connection

To establish a connection with the remote radio station issue the CONNECT command: cmd:CONNECT M17<CR>

***SENDING INFO TO M17

After the connection has been established a yellow LED indicator will switch on and all the incoming data on Ethernet or serial data port will be sent to the remote radio station. A connection can also be established through a digipeater, as follows: cmd:CONNECT M17 via M15-1<CR>

***SENDING INFO TO M17

4.2.1.2 Closing the connection

To close a connection switch to command mode (<CTRL-C>) and issue the DISCONNECT command: <CTRL-C>

cmd:DISCONNECT

***DISCONNECTED

cmd:

4.2.2 Connectionless data transfer mode

In this mode ERDI broadcasts the incoming data to all of the remote radio stations. Digipeater functionality is not supported. To use this mode the following conditions must be met:




16/42

direct addressing must be disabled (_UNICADDR OFF)

acknowledgment of data packets must be disabled (_DPCKACK OFF) If the data is in text form (CONVERS), then ERDI broadcasts the data after it receives the CR (0DH) character from the user/device. If the data is in binary form (TRANS) the broadcast takes place after a certain amount of time has passed without any activity. The PACTIME command regulates this time delay.

4.2.3 MODBUS ASCII and MODBUS RTU data transfer modes

Similarly to the connectionless mode, ERDI broadcasts the data to all of the radio stations. The following prerequisites must be met to use these two modes:

the data packet format must be fully configured for the serial data interface (number of data bits, parity, number of stop bits) and must match the data packet format on the connected device,

the correct data transfer mode must be set (2 - MODBUS ASCII, 3 - MODBUS RTU),

MODBUS device must be configured as SLAVE or MASTER,

the identification tag of ERDI must be set to M - MASTER (default) if the connected device is configured as master; or it must match the device ID if the device is configured as slave,

direct addressing must be disabled (_UNICADDR OFF),

acknowledgment of data packets must be disabled (_DPCKACK OFF).

To switch from conversation mode to command mode the user/device must send three consecutive (<CTRL-C> default) control characters. The CMDTIME command is used to configure the timing parameters of a mode switch. Transmission of a data packet in mode 3 is controlled through the idle time parameter, which can be configured using the PACTIME command. It is possible to use a digipeater in both modes (2 and 3), however the following conditions must be met:

the identification tag of ERDI and the connected device must be set to MASTER,

the identification tag of the digipeater must be set to match the identification tag of the slave MODBUS device connected to the digipeater,

A record must be added to the SLP table for every slave device reachable through the digipeater (see _MBLS command),

The time delay between consecutive MODBUS broadcast packets must be set (see _MBBCSD command).

4.2.4 IEC101 data transfer mode

In this mode the data is transferred using the IEC 60870-5-101 protocol. ERDI supports fixed length, ACK/NACK, and dynamic length frames. Unknown or broken data frames are ignored. ERDI boots into conversation mode and broadcasts incoming data frames to all radio stations. Digipeater functionality is not supported. The following prerequisites must be met to use this mode:




17/42

the data packet format must be fully configured for the serial data interface (number of data bits, parity, number of stop bits)

the correct data transfer mode must be set (4 – IEC101),



To switch from conversation mode to command mode the user/device must send three consecutive (<CTRL-C> default) control characters. The CMDTIME command is used to configure the timing parameters of a mode switch.

4.2.5 DNP3 data transfer mode

In this mode the data is transferred using the DNP3 protocol. ERDI boots into conversation mode and broadcasts incoming data frames to all radio stations. Unknown or broken data frames are ignored. Digipeater functionality is not supported. The following prerequisites must be met to use this mode:

the data packet format must be fully configured for the serial data interface (number of data bits, parity, number of stop bits)

the correct data transfer mode must be set (5 – DNP3),



To switch from conversation mode to command mode the user/device must send three consecutive (<CTRL-C> default) control characters. The CMDTIME command is used to configure the timing parameters of a mode switch.




18/42

5 COMMANDS

This chapter describes the commands which the user can issue through serial or Ethernet data port. ERDI must be operating in command mode to successfully execute the commands. Most of them have a shorter form (mnemonic). Commands issued without an argument display the current value. The changes made to the configurable parameters of ERDI persist until the unit is powered off or a reset has occurred. To make the changes permanent they must be saved using the EEPROM command. The user can list all of the available commands by executing the _help command.

5.1 ABAUD – set transfer rate

Sets the transfer rate of the serial interface.

Command: ABAUD mnemonic: AB default: 9600 bps

ABAUD <val><ENTER>

<val> Valid transfer rates: 150, 300, 600, 1200, 4600, 9600, 19200, 38400, 57600 and 115200 bps.

Changes have to be saved using the EEPROM command. The new transfer rate will come into effect at the next boot of ERDI.

5.2 AUTOLF – toggle automatic line feed

Toggles the automatic output of the line feed character (LF, 0AH) on the serial interface.

Command: AUTOLF mnemonic: AU default: OFF

AUTOLF <val><ENTER>

<val> ON The line feed character (LF, 0AH) is automatically appended when the command

line is activated (ENTER). OFF automatic output of the line feed character is disabled.

5.3 AWLEN – set the serial interface data packet length

Sets the serial interface data packet length.

Command: AWLEN mnemonic: AW default: 8

AWLEN <val><ENTER>

<val> Valid data packet lengths: 7 or 8 bits.




19/42

5.4 CHECK – set the connection checking interval

Sets the time interval for checking the status of a connection.

Command: CHECK mnemonic: CH default: 30

CHECK <val><ENTER>

<val> Check interval - from 0 to 250 in 10 second steps. Connection checking is performed if there is no other traffic present. Setting the interval to 0 disables connection checking.

5.5 CMDTIME – set the time delay when switching to command mode

Sets the time delay between <CTRL-C> characters when switching from conversation mode to command mode.

Command: CMDTIME mnemonic: CM default: 5

CMDTIME <val><ENTER>

<val> time delay - from 1 (100 ms) to 250 (25 s) Switching from conversation mode to command mode (N is the time delay in seconds):

wait N seconds

press <CTRL-C> three times; the time delay between key presses must be less than N seconds.

wait N seconds – ERDI will switch to command mode

5.6 COMMAND – configure command mode activation control

character

Configures the control character for switching from conversation mode to command mode.

Command: COMMAND mnemonic: COM default: 03H(CTRL-C)

COMMAND <val><ENTER>

<val> Character code - from 0 to 7FH.




20/42

5.7 CONMODE – set the mode of operation.

Sets the mode of operation when ERDI reaches CONNECTED state

Command: CONMODE mnemonic: CONM default: CONVERS

CONMODE <mode><ENTER>

<mode> CONVERS Enter conversation mode and treat data as text. TRANS Enter conversation mode and treat data as binary.

5.8 CONNECT – establish connection with the remote radio station

Establishes a connection with the remote station – directly or through a digipeater.

Command: CONNECT mnemonic: C

Establish a direct connection:

CONNECT <call_id><ENTER>

Establish a connection through one or multiple digipeaters:

CONNECT <call_id> via <rpt_id1>[, rpt_id2, rpt_id3, rpt_id4]<ENTER>

<call_id> Identification tag of the remote station. <rpt_id1 - 4> Identification tag of the digipeater. After the connection has been established, ERDI will immediately switch to conversation mode.

5.9 CONVERS – switch to conversation mode (data as text)

Switches to conversation mode and treats data as text.

Command: CONVERS mnemonic: K

CONVERS<ENTER>

5.10 CR – enable packet sent control character

Toggles appending of the control character <CR> at the end of the data packet being sent.

Command: CR mnemonic: CR defualt: ON

CR <val><ENTER>

<val> ON Control character <CR> is appended to the data packet. OFF Control character is ommited.




21/42

5.11 CSTATUS – display connection status of all channels

Displays connection status of all channels.

Command: CSTATUS mnemonic: CS

CSTATUS<ENTER>

Currently active channel is marked with I/O.

5.12 DIGIPEAT – enable digipeater functionalities

Enables ERDI to provide digipeater functionalities.

Command: DIGIPEAT mnemonic: DIG default: ON

DIGIPEAT <val><ENTER>

<val> ON Digipeater functionalities are enabled. OFF Digipeater functionalities are disabled.

5.13 DISCONNECT – close connection

Closes connection to the remote station.

Command: DISCONNECT mnemonic: D

DISCONNECT<ENTER>

5.14 DISPLAY – display status data

Displays status data and ERDI configuration parameters.

Command: DISPLAY mnemonic: DISP

DISPLAY[ <class>]<ENTER>

<class> A Display data about the serial interface. C Display control characters. H Display system counters. I Display identification data. L Display connection status. T Display timing data.




22/42

5.15 ECHO – enable echo on the serial interface

Toggles echo on the serial interface.

Command: ECHO mnemonic: E default: OFF

ECHO <val><ENTER>

<val> ON Enable echo. OFF Disable echo.

5.16 EEPROM – store ERDI configuration parameters

Permanently stores the configuration parameters to the programmamble ROM.

Command: EEPROM mnemonic:

EEPROM <ENTER>

5.17 FRACK – set time delay for data packet resend

Sets the waiting time before the data packet is resent in case of transmission error.

Command: FRACK mnemonic: FR default: 15 s

FRACK <val><ENTER>

<val> Time delay - from 1 to 30 seconds.

5.18 MYALIAS – set alternative identification tag for digipeater

Sets an alternative radio station identification tag when it is also being used as a digipeater.

Command: MYALIAS mnemonic: MYA

MYALIAS <call_id><ENTER>

<call_id> Identification tag – maximum of 6 characters.

5.19 MYCALL – set radio station identification tag

Sets radio station identification tag.

Command: MYCALL mnemonic: MY default: M

MYCALL <call_id><ENTER>




23/42

<call_id> Identification tag – maximum of 6 characters.

5.20 PACLEN – set the maximum data packet length

Sets the maximum data packet length.

Command: PACLEN mnemonic: P default: 128

PACLEN <val><ENTER>

<val> Maximum data packet length - from 0 to 255 characters.

5.21 PACTIME – set the data packet waiting time

Set the time delay before data packet is sent.

Command: PACTIME mnemonic: PACT default: 10

PACTIME AFTER <val><ENTER>

<val> Time delay before data packet is sent – from 1 (100 ms) to 250 (25 s).

5.22 PARITY – configure serial interface parity checking

Configures parity checking on the serial interface.

Command: PARITY mnemonic: PAR default: 0

PARITY <val><ENTER>

<val> 0 No parity checking

1 Odd parity 2 No parity checking 3 Even parity

5.23 RADIO CHN – change channel on radio station

Changes the radio channel on the radio station

Command: RADIO CHN mnemonic:

RADIO CHN <val><ENTER>

<val> radio channel number.




24/42

5.24 RESET – restore ERDI configuration parameters (default settings)

Restores the default configuration of ERDI.

Ukaz: RESET mnemonic:

RESET<ENTER>

All values are restored exept the ABAUD setting (transfer rate).

5.25 RESTART – restart ERDI

Restarts ERDI.

Command: RESTART mnemonic:

RESTART<ENTER>

5.26 RETRY – set the number of send retries

Sets the number of times ERDI tries to resend a data packet in case an error occurs.

Command: RETRY mnemonic: RE default: 1

RETRY <val><ENTER>

<val> Number of retries - from 0 to 15.

5.27 SENDPAC – configure output data packet control character

Configures the control character used to output a data packet when operating in conversation mode.

Command: SENPAC mnemonic: SE default: 0DH(CR)

SENDPAC <val><ENTER>

<val> character code - from 0 to 7FH.

5.28 TRANS – switch to conversation mode (binary data)

Switches to conversation mode and sends data in binary form.

Command: TRANS mnemonic: T

TRANS <ENTER>




25/42

5.29 STREAMSW – configure channel switch character

Configures the control character used to perform a channel switch.

Command: STREAMSW mnemonic: STR default: 7CH(|)

STREAMSW <val><ENTER>

<val> Character code - from 0 to 7FH.

5.30 USERS – set the maximum number of connected users

Sets the maximum number of channels within a connection.

Command: USERS mnemonic: US default: 1

USERS <val><ENTER>

<val> 0 Establish connection on all channels. 1 Establish connection on channel A. 2 Establish connection on channel A and B. 3 Establish connection on channels A, B, and C.

4 Establish connection on channels A, B, C, and D.

5.31 _ANR – configure validity time of ANR records

Displays and configures the validity time of ANR records.

Command: _ANR mnemonic: default: 120 minutes

Display ANR table:

_ANR<ENTER>

M1 10.0.0.1 427

M2 10.0.0.2 579

M3 10.0.0.3 589

Aging timeout[min]: 10

1. column: identification tag of the remote radio station 2. column: IP address of the remote radio station 3. column: remaining time until the record is invalidated The last row shows the configured validity time in minutes. Configure validity time of the records:

_ANR TIMO <val><ENTER>




26/42

<val> Validity time in minutes - from 0 to 1092. A value of 0 disables ageing of ANR records - records can only be deleted by issuing the _ANR CLR command. Deleting all ANR records:

_ANR CLR<ENTER>

5.32 _ASTOP – configure the number of stop bits on the serial interface

Sets the number of stop bits on the serial interface.

Command: _ASTOP mnemonic: _AS default: 1

_ASTOP <val><ENTER>

<val> Number of stop bits: 1 or 2.

5.33 _DPCKACK – toggle data packet acknowledgment

Enables or disables acknowledgment of data packets.

Command: _DPCKPACK mnemonic: default: ON

_DPCKACK <val><ENTER>

<val> ON Acknowledgemnt enabled. OFF Acknowledgment disabled.

5.34 _HELP – list commands

Displays the list of all commands supported by ERDI.

Command: _HELP mnemonic: default:

_ HELP <ENTER>

5.35 _INFO – display general information

Displays general information about ERDI.

Command: _INFO mnemonic: default:




27/42

Display general information:

_INFO<ENTER>

Display connection status information:

_INFO CONN [<conn_id>]<ENTER>

5.36 _MBBCSD – MODBUS – configure broadcast time delay

Configures the time delay between consecutive broadcasts when operating in MODBUS. This command is effective only when using digipeaters.

Command: _MBBCSD mnemonic: default: 10

_MBBCSD <val><ENTER>

<val> Time delay - from 1 (100 ms) to 250 (25 s).

5.37 _MBROLE – MODBUS – configure ERDI role (master/slave)

Configures ERDI role when in MODBUS mode – master or slave.

Command: _MBROLE mnemonic: default: SLAVE

_MBROLE <role><ENTER>

<role> MASTER – ERDI is the MODBUS master. SLAVE – ERDI is the MODBUS slave. There can be only one master device!

5.38 _MBSLP – MODBUS – SLP digipeater slave table

Manages the SPL digipeater table of the MODBUS slaves.

Command: _MBSLP mnemonic: default:

_MBSLP <role><ENTER>

Display SLP table:

_MBSLP<ENTER>

Example: cmd:_mbslp




28/42

1 4 3

2 6- 8 10

3 21 3 15

1. column record identification number 2. column slave address (one value) or address space (first – last, e.g. 6- 8) 3. column first digipeater – slave address 4. column second digipeater – slave address 5. column third digipeater – slave address 6. column fourth digipeater – slave address

Adding a record to the SLP table:

_MBSLP <slave> <digip1>[ <digip2> <digip3> <digip4>]<ENTER>

<slave> Slave address – value from 1 to 247 or slave address space in the format <first –

last>. <digip1> 1. digipeater slave address <digip2> 2. digipeater slave address (optional) <digip3> 3. digipeater slave address (optional) <digip4> 4. digipeater slave address (optional) Example:

cmd: _ MBSLP 21 3 15

The command adds a record which tells ERDI that the slave device 21 is reachable through digipeaters 3 and 15. cmd: _mbslp 6-8 10 The commands adds a record which tells ERDI that the slave devices 6-8 are reachable through digipeater 10. Deleting SLP records:

_MBSLP <rec1>[ <rec2> <rec3> ...]<ENTER>

or

_MBSLP ALL<ENTER>

<recx> Record identification number. ALL Delete all records. Example:

cmd: _mbslp 2

Deletes record number 2.




29/42

After adding or deleting SLP records the new table must be stored using EEPROM command. Important! SLP table can only be used if ERDI is operating as the master device. Identification tag of ERDI must be set to M - MASTER. Slave devices used as digipeaters must have valid identification tags.

5.39 _MODE – set the operation mode

Sets ERDI operation mode.

Command: _MODE mnemonic: default: 0

_MODE <val><ENTER>

<val> 0 – Connection oriented mode.

1 – Connectionless mode. 2 – MODBUS ASCII. 3 – MODBUS RTU. 4 – IEC101 5 – DNP3

5.40 _SHOWPCK – display data traffic information

Enables or disables the display of data traffic information – number of received broadcast packets.

Command: _SHOWPCK mnemonic: default: OFF

_SHOWPCK <val><ENTER>

<val> ON Enable display. OFF Disable display.

5.41 _UNICADDR – Toggle direct addressing

Enables or disables direct addressing using IPs of remote radio stations.

Command: _UNICADDR mnemonic: default: ON

_UNICADDR <val><ENTER>

<val> ON Enable direct addressing – IP addresses are stored in the ANR table. OFF Disable direct addressing – uses group IP (broadcast).




30/42

6 SERVICE COMMANDS

This chapter describes the commands which can be used when connected to the service port. Character ‘h’ lists all available commands. Default configuration of the service serial interface: 115200 bps 8-bit data packet 1 stop bit No parity No flow control

6.1 Display status

Status of the ERDI unit and the connection status can be obtained by sending character ‘s’.

6.2 Display general information

Sending character ‘i’ displays FW version and type of the data port. In case Ethernet/TCP port is used it also displays network configuration.

6.3 Select data port

Character ‘d’ selects the type of data port. There are two options: serial port – 1 or Ethernet/TCP – 2. To apply the new settings save them using character ‘a’ and reset ERDI.

6.4 Network configuration

Character ‘e’ can be used to configure network settings of ERDI. It is possible to change the IP address, gateway address, and subnet mask. To apply the new settings save them using character ‘a’ and reset ERDI.

6.5 Save new settings

To save the configuration data to programmable ROM send character ‘a’. In most cases a reset of ERDI is required to make the changes come into effect.

6.6 Extended commands

Character 'x' is used to enable extended commands. Additional commands are activated using applicable characters 'd', 'r', etc.

6.6.1 Radio station reset

Radio station reset can be initiated by sending character 'r'.




31/42

6.6.2 ERDI reset

ERDI reset can be initiated by sending character 'R'.

6.6.3 Additional status data

Additional status data is displayed by sending character 's'. The data includes ERDI uptime,

status of the connection to the radio station (RS status – negative value indicates an error),

amount of free RAM (Free), and information about running tasks (name, state, priority, amount

of free stack memory, task ID). Example: Example: 150174 s

RS status: -1610

Free: 4072 B

Task info:

Name State Prior. Stack Task ID

SERVICE R 1 720 3

IDLE R 0 232 2

RADIO B 2 344 5

MNGWDT B 4 864 1

TCPIP B 3 672 6

MODEM B 2 1344 4

6.6.4 Debugging

Character 'd' controls debugging output on the service port. It allows debugging of individual software modules: 'r' Radio module 'x' XNL module 'm' Modem module Debugging output is enabled by sending character '1', and disabled by sending '0'. Example: 'x' + 'd' + 'x' + '1' This character sequnece enables the debugging of the XNL module.

6.6.5 MAC address

Character ‘M’ is used to assign a MAC address to ERDI. After confirming the change, MAC address is saved to the OTP region. The new address will come in to effect when ERDI is reset. Important!




32/42

Every ERDI unit must have a unique MAC address. The default MAC address must not be used in production. OTP data can only be written once! If the data needs to be changed a command for erasing the OTP region must be issued ('x' + 'O').




33/42

7 QUICK START GUIDE – COM PORT

This example will show how to configure two sets of Motorola radio stations and ERDI units to

communicate with each other.

First open Motorola CPS and configure the radio station accordingly to chapter 3 in this guide. Choose

different Radio IDs for each radio station.

Disconnect the programming cable from the radio station, power off the radio station, connect ERDI12-

USB cable to the radio station and ERDI and power on the radio station.

Warning: It is crucial to power on the radio station AFTER you connect the ERDI12-USB cable.

To configure ERDI, connect RS232 DATA port to PC using serial cable or Serial<->USB converter.

You can use any terminal program to configure the unit. Settings for the terminal program are the

following: Baud rate: 9600, Data: 8 bit, Parity: none, Stop: 1 bit, Flow control: none.

Figure 7: Serial port setup

At power on, ERDI responds with the software version.




34/42

Figure 8: ERDI respond after power on

Next we will use the »my« command to set up ERDI's address. To set up ERDI's address to 1 you must

type »my 1«. We can check the address if we issue »my« command. ERDI responds with »MYCALL

1«. Using command »eeprom« we save all settings into the memory.

Figure 9: Setting up ERDI's address and saving settings to eeprom

Do the same procedure on the other units, but choose different addresses (eg. 2).




35/42

Figure 10: Setting up second ERDI's address and saving setting to eeprom

Both ERDIs are now configured and ready to establish connection with each other. On ERDI with

address 1 type the following command: »connect 2«. This command will establish a connection with the

other ERDI. When the connection is established ERDI will respond with »*** SENDING INFO TO 2«

and the ERDI with address 2 will respond with »*** SENDING INFO TO 1«. Yellow LED on radio

stations will light up. Now we can type data to both consoles and ERDIs will send data to each other.

To disconnect press CTRL-C rapidly 3 times. ERDI will respond with »cmd:«. Then type »disconnect«.

Both ERDIs respond with »*** DISCONNECTED«.




36/42

Figure 11: Estabilishing a connection from ERDI 1 to ERDI 2, sending data and disconnecting




37/42

8 QUICK START GUIDE – ETHERNET

This example will show how to configure two sets of Motorola radio stations and ERDI units to

communicate with each other.

Ethernet on ERDI acts like a COM < -- > Ethernet converter. All commands on Ethernet interface are

the same.

If you've already done the quick start guide – com port, you can leave one ERDI configured to COM

port and configure just the other one.

First open Motorola's CPS and configure the radio station accordingly to chapter 3 in this guide. Choose

different Radio IDs for each radio station.

Disconnect the programming cable from the radio station, power it off, connect ERDI12-USB cable to

the radio station and ERDI and power it back on.

Warning: It is crucial to power on the radio station AFTER you connect the ERDI12-USB cable.

To configure ERDI, connect RS232 SERVICE port to a PC using serial cable or Serial<->USB

converter. You can use any terminal program to configure the unit. The settings for the terminal program

are the following: Baud rate: 115200, Data: 8 bit, Parity: none, Stop: 1 bit, Flow control: none.

Warning: Make sure that you configured your terminal to send CR as the new line character.

Figure 12: Serial port setup




38/42

When ERDI unit is powered on ERDI respond with version of software.

Figure 13: ERDI's respond on SERVICE com port

First we must configure IP settings for ERDI. Press 'e' key to set up the IP address and then type in the

IP address and the gateway address. In our example we will leave the gateway address on the default

value.

Figure 14: Setting up ERDI's IP address to 192.168.1.100




39/42

We can select Ethernet interface by pressing 'd' followed by '2'.

Figure 15: Selecting Ethernet interface

Finally, save the settings by pressing 'a' and restart ERDI. ERDI will now act as TCP/IP server on the

configured IP address, port 3562. Configure the terminal program to connect to ERDI's IP and port.

Figure 16: Configuration for TCP/IP connection to ERDI




40/42

We can now enter commands as in the COM PORT example:

Figure 17: Setting ERDI's address thru Ethernet connection

We will use command »my« to set up ERDI's address. To set up ERDI's address to 1, enter »my 1«. We

can check the address by issuing the »my« command. ERDI responds with »MYCALL 1«. By using

the »eeprom« command we save all settings into the memory.

You can reconfigure the second ERDI or leave it configured as in the COM PORT example. ERDIs are

now configured and ready to establish a connection between each other. On ERDI with address 1 type

following command: »connect 2«. This command will establish a connection with the other ERDI. When

the connection is established ERDI will respond with »*** SENDING INFO TO 2« and the second

ERDI, with address 2, will respond with »*** SENDING INFO TO 1«. Yellow LED on radio stations

will light up. Now we can type data to both consoles and ERDIs will send data to each other. To

disconnect press CTRL-C rapidly 3 times. ERDI will respond with »cmd:«. Then type »disconnect«.

Both ERDIs respond with »*** DISCONNECTED«.




41/42

Figure 18: Figure 11: Estabilishing a connection from ERDI 1 to ERDI 2, sending data and

disconnecting




42/42

9 TECHNICAL SPECIFICATIONS

Core frequency 100 MHz Peripheral interface frequency 50 MHz USB interface frequency 48 MHz WDT timeout 2500 ms Operating system FreeRTOS version 7.6.0 Serial interface Minimum transfer rate 150 bps Maximum transfer rate 115200 bps Data packet format 7 or 8 bits Number of stop bits 1 or 2 Parity no parity, odd parity, even parity Flow control none Number of channels 4 Number of digipeaters 4 Data packet length default 128 characters

maximum 256 characters ANR table Table capacity 64 records Default record validity time 120 minutes Minimal record validity time 1 minute (0 – ageing disabled) Maximum record validity time 1092 minutes Ethernet transfer rate 10/100Mbps, automatic negotiation Default MAC address 00:11:12:13:14:15 Default IP address 192.168.1.100 Default gateway address 192.168.1.1 Default subnet mask 255.255.255.0 Default TCP port 3562 TCP connection control time 30 minutes Number of simultaneous TCP connections 1 TCPIP stack lwIP

erdi software manual...wdt watch dog timer elektronika naglič d.o.o., erdi software manual...

Documents