IEC62056-21:2002 File I/O communication protocol

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

Supported device types and versions


This protocol analyzes the files containing data about measurement according to international standard IEC 62056.

Communication line configuration


Communication line configuration parameters File I/O:

In case of analyzing the particular file, its size is tested with a period 1 sec. If file does not increase during two consecutive periods, it is processed.

If directory is entered (in case of a platform Win32 with reverse solidus (\) at the end), all files that match the mask are processed (see station protocol parameters).

Communication line protocol parameters


Dialog window communication line configuration - tab Protocol parameters, select the protocol "IEC62056-21:2002 File I/O".

Table 1

Parameter Description Unit Default value
Profile Analyzed profile. - P.01
Gorlitz PRM62 Module Files from device Gorlitz PRM62 are analyzed. YES/NO NO
Archive Subdirectory Time Mask Mask for generation of subdirectories in main archive directory according to time of file processing or time stamp of file (the Input file is the entered directory). - rrrrmmdd
Formatted Codes (Annex C) Numerical addresses of I/O tags are used according to specification of standard IEC62056-21, Annex C. YES/NO NO
External Command File 1, 2 Complete path to periodically called external command file (.cmd). It is used only if non-empty value has been configured. It is possible to configure two independently executed command files with different periods. - -
External Command File Period 1,2 Call period of the external command file 1 or 2. mi:ss 1:00
Call External Command File 1,2 Synchronously Call external command file 1 or 2 synchronously. YES/NO YES
Ext. Command File After Activation Complete path to the external command file wich is launched at change of redundancy status to HS. It is called only once and always synchronously. It is used only if non-empty value has been configured. - -
Debug Files Flow Show debug information about processed files. YES/NO YES
Debug Files Content Show debug information with the content of processed files. YES/NO YES
Debug Values Show debug information with measured values of the measure points. YES/NO YES
Files Checking Period Period of input directory content check (if the input file is a directory). mi:ss 1:00
Unknown Files Backup Directory File, where unknown files are saved (if the input file is directory). If it is not written, the files will be cancelled. The unknown files are the files inconvenient to mask (see station protocol parameters) or the station with required device number was not found. - -
Future Data Filter Time data filter. If the time stamp of acquired values is different from current time more than stated number of hours in future, they are ignored. Enter 0 (zero) to ignore time filter. hours 24
History Data Filter Time data filter. If the time stamp of acquired values is different from current time more than stated number of hours in past, they are ignored. Enter 0 (zero) to ignore time filter. days 31
Abnormal Timestamp Data Dir Directory where the files with ignored data by time filter will be saved (Future Data Filter and History Data Filter). - -
After Processing Timeout Timeout, it is inserted after the file was analyzed. ss.mss 0.100
Additional Error Logfile Error file to write information about errors during processing (unknown file in directory, too old or too new values). Empty value means that this error file will not be created. - -

Communication station configuration


Station protocol parameters


Dialog window station configuration - tab Protocol parameters.
They influence some optional protocol parameters. The following station protocol parameters can be entered:

Table 2

Parameter Description Unit Default value
Maximum File Timeout If the input file is a particular file, after this timeout passes without a file being processed, then the station value is transferred to communication error. min 45
Filename Mask Mask for the name testing of the processed files. The following digit placeholder can be used:
{N} - electrometer number, beware of number of figure, e.g.{NNNNNNNN},
{yy} or {yyyy} - year,
{mm} - month,
{dd} - day,
{hh} - hour,
{mi} - minute,
{ss} - second.
Exmple of mask: "Meter_{NNNNNNNN}{yy}{mm}{dd}{hh}{mi}.abl".
Time stamp gained from the file name (if it is possible) is used at file saving to archive directory (see communication line protocol parameters Archive subdirectory time mask).
If the electrometer number is gained, it is used for searching the proper station.
In case of not using the mask, the parameter should be empty. The station is, then, searched by acquired object value 0.0.0, C.1.0 or ZNR1 in case of Gorlitz PRM62.
- -
External Command File Complete path to periodically called external command file (.cmd). The command file is called before accessing the input file. It is used only if non-empty value has been configured. - -
External Command File Period Call period of the external command file. mi:ss 1:00
Call Ext. Command File Synchronously Call external command file synchronously. YES/NO YES

I/O tag configuration


Supported value types of I/O tags: Ai, Ci, TxtI.

I/O address


Address of I/O tag corresponds to standard IEC 62056-61:2002 Object Identification system (OBIS), "Annex A - Code presentation".

Shortened address format is supported: C.D[.E][*F]

where is

A special I/O tag with address "$SW" acquires the value of profile status word.

File example


[HEADER]
PROT = 0
ZNR1 = 00359487
TIME = 10:02:05
DATE = 22.10.04

[PDATA]
/EMH4\@01QJKB0660L0C1
0.0.0(00359487)
0.0.1(00359487)
0.9.1(100208)
0.9.2(041022)
F.F(00000000)
P.01(041022094500)(00000000)(15)(4)(1.5)(MW)(2.5)(MW)(3.5)(Mvar)(4.5)(Mvar)
(00.000)(00.000)(00.000)(00.000)
(00.000)(00.000)(00.000)(00.000)
!

where is:

P.01 - profile
(041022094500) - the time stamp of the first row with values
(00000000) - the profile status word
(15) - period of measurement in minutes
(4) - number of channels
(1.5) - first channel, 1 = Value Group C = Reactive power+, 5 = Value Group D = Last average 1
(MW) - unit of the first channel
etc.

Next rows contain the values of measurement.

Literature


Changes and modifications


-

Document revisions


Communication protocols