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

ParameterDescriptionUnitDefault value
ProfileAnalyzed profile.-P.01
Gorlitz PRM62 ModuleFiles from device Gorlitz PRM62 are analyzed.YES/NONO
Archive Subdirectory Time MaskMask 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.
If numerical addresses are used, the station addresss is then acquired from the value of object with address D000, time stamp is acquired from the value of object with address C001.

YES/NONO
External Command File 1, 2Complete 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,2Call period of the external command file 1 or 2.mi:ss1:00
Call External Command File 1,2 SynchronouslyCall external command file 1 or 2 synchronously.YES/NOYES
Ext. Command File After ActivationComplete 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 FlowShow debug information about processed files.YES/NOYES
Debug Files ContentShow debug information with the content of processed files.YES/NOYES
Debug ValuesShow debug information with measured values of the measure points.YES/NOYES
Files Checking PeriodPeriod of input directory content check (if the input file is a directory).mi:ss1:00
Unknown Files Backup DirectoryFile, 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 FilterTime 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.hours24
History Data FilterTime 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.days31
Abnormal Timestamp Data DirDirectory where the files with ignored data by time filter will be saved (Future Data Filter and History Data Filter).--
After Processing TimeoutTimeout, it is inserted after the file was analyzed.ss.mss0.100
Additional Error LogfileError 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

ParameterDescriptionUnitDefault value
Maximum File TimeoutIf 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.min45
Filename MaskMask 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 addresss is then acquired from the value of object 0.0.0, C.1.0 or ZNR1 (ZNR1 in the past only in case of Gorlitz PRM62 Module, currently also for other types of energy meters).
--
External Command FileComplete 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 PeriodCall period of the external command file.mi:ss1:00

Call Ext. Command File Synchronously

Call external command file synchronously.YES/NOYES

Old Values As New Values

All values from communication (even old ones) go to the system as new values.YES/NONO

PRM62 Status To Flags

The parameter is only used when analyzing files from the Gorlitz PRM62 (see the Gorlitz PRM62 Module line parameter). When enabled, attributes Invalid (invalid value), ShortPeriod (data for the whole measurement period are not available to electrometer), and TimeSet (time has been set during the measurement period) are mapped into flags FA, FB, FC .

YES/NONO

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


flags