Эта страница является переводом страницы EPSNET. Перевод выполнен на 100%.

---

iRidium для EPSNET

a set of tools for creating interfaces to control Teco and iNELS via the EPSNET protocol

The documentation was updated on 14.8.2023

training:
webinars and video-lessons >>

download:

• Control via EPSNET
• Control via EPSNET + Notifications

Description

iRidium for EPSNET - it is a package of tools for creating interfaces to control houses or offices on the basis of Teco (Tecomat) or iNELS equipment with support of the EPSNET protocol.

Connection

Equipment configuration and settings required for iRidium to control equipment via the EPSNET protocol.

Ways of connection to PLC

Different ways of connection enable local work or work via the Internet:

1. Local connection

2. Internet connection

1. Local connection works only in the local network of the automation object. The UDP protocol is used. The connection is established between the controller and a control panel via the network router.

2. Internet connection enables connection to the controller via the Internet. To work in this mode the network router is required to have a static IP-address or use the DDNS service.

You can add an EPSNET driver by importing from a CSV file or manually filling in the data.

Import from a CSV file (*.csv)

Universal import from CSV File - a capability to import drivers from a table in the CSV format.

You can read more about detailed instructions on creating a CSV file and importing it into IRidium Studio here.

Adding of the EPSNET driver in iRidium

EPSNET does not allow you to form the list of devices you want to control. Add them manually.

Drag the selected driver from DEVICE BASE in PROJECT DEVICE PANEL.

• Host - the controller IP-address
• Port - the UDP control port, 61682
• Update Time (ms) - the frequency of data update

It is convenient to form commands for the EPSNET driver on the basis of the export file in the *.PUB format which is made in Mosaic (TECO) and IDM (iNELS).

1(а). Prepare Mosaic:

if you already generated the *.pub file (compiled the project), remove the previous *.pub file before doing it again. Otherwise, addresses in your projects will be duplicated.

1(b). Prepare IDM iNELS:

Make sure IDM is connected to the controller. Otherwise, the import is not possible.

2. Select variables for export in "Unit/Device Manager". Make sure to indicate the NAMES of exported variables:

3. Open "Project Setup" and indicate the path for saving the export file. The tab can be called '...Of SCADA' or 'RELI':

4. For the *.pub file to be exported to your PC, you need to download the configuration on the controller again:

5. Open the *.pub file in the text editor - it has the list of addresses in the format supported by iRidium:

Commands & Feedbacks

To control EPSNET registers, you are required to transfer data from the *.PUB file in iRidium. Start setting up of registers by parsing strings of the PUB file: one string corresponds to one register:

DAC2_04M_OUT1_ON R B 18237 .1 BOOL PUB_INOUT
	  |			 |    |		|  |		 |
	  |_"Name"	 |	  | 	|  |_"Type"	 | reading only (IN)
				 |    |		|			 |_reading and writing (INOUT)
	  "Register"_|    |_"Address"		  
							|
					  "Bit"_|

EPSNET registers in iRidium Studio:

• Name - the register name
• Type - the data type, see the correspondence table
• Register - the register type
• Address - the register number
• Bit - the bit number in the byte (for Bool)

Add all required registers in the iRidium project selecting properties from the corresponding values of the *.PUB file.

Registers with the property PUB_INOUT can be written and read, create them in the Commands and Feedback tabs.

Registers with the property PUB_IN can be read only, create them in the Feedback tab.

Type (in the PUB file and iRidium Studio):

PUB file	iRidium Studio	Description	Range
BOOL	Bool	Boolean	0…1
SINT	Signed 8 bit	Short integer	-128...127
INT	Signed 16 bit	Integer	-32 768...32767
DINT	Signed 32 bit	Double integer	-2147483648...2147483647
USINT	Unsignеd 8 bit	Unsignеd short integer	0...255
UINT	Unsigned 16 bit	Unsignеd integer	0...65535
UDINT	Unsigned 32 bit	Unsignеd double integer	0...4294967295
REAL	Float 32 bit	Real (single precision)	±2.9E-39… ±3.4E+38
LREAL	Float 64 bit	Long real (double precision)	IEC 559
TIME	Time	Duration	24d 20:31:23.647
DATE	Date	Data (only)	from 1.1.1970 00:00:00
TIME_OF_DAY (TOD)	Time of Day	Time of day (only)	24d 20:31:23.647
DATE_AND_TIME (DT)	Date Time	Data and time of day	from 1.1.1970 00:00:00
STRING	String	String	up to 255 symbols

Commands and feedback channels have to be assigned to project graphic items to control equipment:

• Commands are assigned to graphic items indicating the value to be sent to registers when clicking on the items
• Feedback channels are assigned to graphic items to display the register state

To assign commands or channels to graphic items use the drag&drop method.

for fast creation of Feedback with the same settings with Command, right-click on Command and select the "Create Feedback" option. You can create Feedback for several registers at a time.

Changing the connection settings

You need the possibility to change connection properties when you disconnect from the Wi-Fi network of the automation object and start using 3G or another Wi-Fi network. To maintain control of the object you need to switch from the local to public IP-address of the Internet router.

The switch is not automatic. You have to select the connection mode. For remote acces you have to make ports for controlling the automation system public. In order to do that you have o set up the Port Forwarding service on your Internet router. VPN can provide protected connection.

1 Download the template (*.js) (right-click button: "Save object as ..."), add the template in the script editor with the button (+) Add Script from file

2 Set up script properties as it is shown in the example:

function Internal_1() {

IR.GetDevice("EPSNET (UDP)").SetParameters({Host: "192.168.0.100", Port: 61682, UpdateTime: 1000});

}

function External_1() {

IR.GetDevice("EPSNET (UDP)").SetParameters({Host: "215.110.10.10", Port: 61682, UpdateTime: 1000});

}

Copy the driver name from Projeсt Device Panel - the list of properties has to be copied from the example.

3 Select the button which will be responsible for the switch of Internal and External properties. Open Macros Editor for the Press event (Object Properties > Programming), select the Script Call command and add it by double-clicking on it. Select the name of the function which will be activated by the button:

Now each pressing on the button will apply the corresponding connection properties.

Control of Equipment

To control equipment it is required to set commands (Commands) and feedback channels (Feedbacks). To send a command, drag'n'drop it on a graphic item and enter a value to send. To display feedback value drag'n'drop a feedback channel on a graphic item and choose how to output or display a value.

Read more about work with graphic items in the "Types of graphic items" article.

Possible settings of commands and feedback channels are given below:

BOOL

Registers with the BOOL (Bool) type are controlled by logical zero and one. The specific feature of its setting up is that besides the number you need to select the controlled bit of the register.

Command:

Type	Value *
Bool	0...1	the data type - BOOL and the value for writing
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number
Bit	0...7	the bit number in the byte

*Value - indicate when dragging the command on graphic items

Feedback:

Type	Bool	the data type - BOOL
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number
Bit	0...7	the bit number in the byte
Value *	0...1	the bit state

* Value - it comes to the feedback channel, use it for displaying on items

SINT, INT, DINT, USINT, UINT, UDINT

Information 8-, 16-, 32-bit registers are controlled by the range of values:

Command:

Type	Value *
Signed 8 bit	-128...127	the data type - SINT and the value for writing
Signed 16 bit	-32 768...32767	the data type - INT
Signed 32 bit	-2147483648...2147483647	the data type - DINT
Unsigned 8 bit	0...255	the data type - USINT
Unsigned 16 bit	0...65535	the data type - UINT
Unsigned 32 bit	0...4294967295	the data type - UDINT
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

*Value - indicate when dragging the command on graphic items

Feedback:

Type	Value *
Signed 8 bit	-128...127	the data type - SINT and the possible value
Signed 16 bit	-32 768...32767	the data type - INT
Signed 32 bit	-2147483648...2147483647	the data type - DINT
Unsigned 8 bit	0...255	the data type - USINT
Unsigned 16 bit	0...65535	the data type - UINT
Unsigned 32 bit	0...4294967295	the data type - UDINT
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

* Value - it comes to the feedback channel, use it for displaying on items

REAL, LREAL

Information 32- and 64-bit registers with floating point are controlled by the range of values. The difference from integer-valued registers is that you can send fraction values to them (and receive fraction values from the controller):

Command:

Type	Value *
Float 32 bit	±2.9E-39… ±3.4E+38	the data type - REAL and the value for writing
Float 64 bit	in accordance with IEC 559	the data type - LREAL
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

*Value - indicate when dragging the command on graphic items

Feedback:

Type	Value *
Float 32 bit	±2.9E-39… ±3.4E+38	the data type - REAL and possible value
Float 64 bit	in accordance with IEC 559	the data type - LREAL
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

* Value - it comes to the feedback channel, use it for displaying on items

TIME, DATE, TIME_OF_DAY, DATE_AND_TIME

Date and time are available for writing and reading. The format of writing must correspond to the preset one. It is recommended to set up time and date using the means of the controller. The application in this case will only display the received data.

Command:

Type	Value *
Time	24d 20:31:23.647	the data type - TIME
Date	1.1.1970 00:00:00	the data type - DATE
Time of Day	24d 20:31:23.647	the data type - TIME_OF_DAY (TOD)
Date Time	1.1.1970 00:00:00	the data type - DATE_AND_TIME (DT)
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

* Value - indicate it when dragging the command on graphic items

Feedback:

Type	Value *
Time	24d 20:31:23.647	the data type - TIME
Date	1.1.1970 00:00:00	the data type - DATE
Time of Day	24d 20:31:23.647	the data type - TIME_OF_DAY (TOD)
Date Time	1.1.1970 00:00:00	the data type - DATE_AND_TIME (DT)
Register	X, Y, S, R, E, D0, D1, D2, Unknown	the register type from the *.PUB table
Address	0...n	the register number

* Value - it comes to the feedback channel, use it for displaying on items

With the help of JavaScript you can form the value of date and time on the basis of the current time of the control panel