Supported device types and versions
Communication line configuration
Communication station configuration
I/O tag configuration
Literature
Changes and modifications
Document revisions


Supported device types and versions



Generic User Protocol is intended to support an application-level implementation of simple and lightweight communication protocols directly in the D2000 Event process via an ESL script or Java code. It supports several types of lines including line-redundant and system-redundant ones. Data read from the communication are published into input I/O tags (IN) without waiting for any confirmation from the ESL script's side, therefore it is recommended to implement data handling via Server Event using the action ON CHANGE, eventually by a trigger event with a request queue configured, eventually by enabling multiple executions of the script (action ENABLE) so that all the published data is handled even under heavier load.


Communication line configuration



Category of communication line:


For both the "Input file" and "Archive" parameters, the symbolic constant #APPDIR# can be used to indicate the application directory (e.g. "#APPDIR#\input.txt").


Communication line protocol parameters



Configuration line dialog box - tab Protocol parameters.
They influence some of the optional protocol parameters. The following line parameters can be set:


Table 1


KeywordFull name

Description

UnitDefault value

TS

TCP Server

Activates server mode on the TCP/IP-TCP line. In this mode, the D2000 KOM process listens to the client connection. After the client is connected, the D2000 KOM process communicates with it (i.e., it is a single-server implementation handling a single client). After the client is disconnected, the D2000 KOM process listens again.
In server mode, the entered server name is interpreted as the name/IP address of the interface on which the D2000 KOM process listens. It is also possible to enter symbolic names * resp. ALL (listening on all interfaces for IPv4 protocol), or [*] resp. [ALL] (listening on all IPv6 interfaces).

-False

RT

Read Wait TimeoutWaiting between individual data readouts from the communication. If no data was received during this period and previously some data was read, it will be published as a value of input I/O tag IN.
If some data was received during this period, it will be appended to a buffer, until a timeout occurs or the buffer becomes full (see a parameter Read Size). If a parameter Log Each Read is set to True, data will be published immediately regardless of the value of the parameter Read Wait Timeout.
sec.mss1.000

CE

Character encoding

The method for text encoding/decoding for writing/reading. Implemented are:

  • UTF-8
  • ISO_8859_1
  • Windows_1250
  • Windows_1251
  • Windows_1252
  • KZ_1048

Note: ISO_8859_1 mode is suitable for the transmission of 8-bit ASCII characters and implementation of binary protocols.
Note: if invalid data is read (e.g. for UTF-8 encoding), the input I/O tag will be invalidated.

-ISO_8859_1
RS
Read SizeMaximum size (in bytes) of input data. Longer data will be published in several chunks.-1024

FRM

File Read Mode

Method of reading data from a file:

  • Read one row - values are read and published to the input I/O tag (IN) one row at a time
  • Read whole file - the whole file is loaded and published to the input I/O tag (IN) at once
-Read one row
LE
Log Each ReadIf this parameter is set to True, data will be published immediately regardless of the value of the parameter Read Wait Timeout.-False
LF
Log FormatFormat of data traces in log files: "0 - Hexa log" or "1 - Text log".
Setting the correct format helps to make a communication log file more readable depending on whether the specific protocol is text-oriented or binary by dumping the data in text or hexadecimal format.
-0 - Hexa log
SL
Single LogSetting this parameter to True will make all logs to be written to a single file on redundant lines.
Setting this parameter to False means that two log files will be created for the primary/secondary line (Serial Line Redundant, SerialOverUDP Line Redundant, TCP/IP-TCP Redundant), or four log files will be created for the primary/secondary line of the A/B system (Serial System&Line Redundant, SerialOverUDP System&Line Redundant).
-False


Communication station configuration



  • Communication protocol Generic User.
  • The station address is not configured; it is recommended to configure a single station per line, but multiple stations are supported too. In this case, when data is received from the communication, it will be published via input I/O tags IN on all configured stations. Likewise, it will be possible to use output I/O tags OUT on any configured station.


I/O tag configuration



Possible value types of I/O tag: TxtI, TxtO.


Input I/O tags:



Output I/O tags:



Note: it is possible to configure and use an I/O tag with the address IN and I/O tags IN_A, IN_B, IN_C, IN_D on a single station at the same time.
In a similar way, it is possible to configure and use an I/O tag with the address OUT and I/O tags OUT_A, OUT_B, OUT_C, OUT_D on a single station at the same time.


Literature





Changes and modifications



-


Document revisions



  • Ver. 1.0 - October 15, 2015 - Creating the document.
  • Ver. 1.1 - December 12, 2021 - Implementation of TCP Server and Character Encoding parameters.


Write a comment...