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
Kotva | ||||
---|---|---|---|---|
|
...
This protocol analyzes the files containing measurement data about measurement according to the IEC 62056 international standard IEC 62056.
Kotva | ||||
---|---|---|---|---|
|
...
- Communication line category File I/O (communication by via files).
Communication line configuration parameters File I/O communication line configuration parameters:
Input file - complete path to the file or directory with data.Kotva inputfile inputfile
In the case of analyzing the a particular file, its size is tested with a 1 second period 1 sec. If the file does not increase in size during two consecutive periods, it is processed.
If a directory is entered (in the case of a Win32 platform Win32 with reverse solidus a backslash (\) at the end), all files that match the mask are processed (see station Station protocol parameters).
- Archive directory -path to the directory, where the processed files are archived. If the directory is not setspecified, the processed files will be cancelleddeleted.
Kotva | ||||
---|---|---|---|---|
|
...
Dialog window communication line configuration - Protocol parameters tab Protocol parameters, select the protocol "IEC62056-21:2002 File I/O" protocol.
Table 1
Parameter | Description | Unit | Default value | ||||||
---|---|---|---|---|---|---|---|---|---|
| Analyzed profile. | - | P.01 | ||||||
Gorlitz PRM62 Module | Files from device Gorlitz PRM62 are analyzed. | YES/NO | NO | ||||||
| Mask for generation of creating subdirectories in the main archive directory according to time of file processing or time stamp timestamp of the file (if the Input file is the entered parameter specifies a directory). | - | rrrrmmdd | ||||||
| Numerical addresses of I/O tags are used according to the specification of standard the IEC62056-21 standard, Annex C. | YES/NO | NO | ||||||
| Complete The complete path to a periodically called external command file (.cmd). It is used only if a non-empty value has been configured. It is possible to configure two independently executed command files with different periods. | - | - | ||||||
| Call period of the external command file 1 or 2. | mi:ss | 1:00 | ||||||
| Call external command file 1 or 2 synchronously. | YES/NO | YES | ||||||
| Complete The complete path to the external command file wich which is launched at on change of redundancy status to HS. It is called only once and always synchronously. It is used only if a non-empty value has been configured. | - | - | ||||||
| Show debug information about processed files. | YES/NO | YES | ||||||
| Show debug information with the content of processed files. | YES/NO | YES | ||||||
| Show debug information with measured values of the measure points. | YES/NO | YES | ||||||
| Period of input directory content check (if the input Input file is parameter specifies a directory). | mi:ss | 1:00 | ||||||
| File, where unknown files are saved (if the input Input file is a directory). If it is not written, the files will be cancelledcanceled. The unknown files are the files inconvenient to not-matching the configured mask (see station Station protocol parameters) or the station with the required device number was not found. | - | - | ||||||
| Time data filter. If the time stamp timestamp of acquired values is different newer from the current time by more than stated the configured number of hours in future, they are ignored. Enter 0 (zero) to ignore the time filter. | hours | 24 | ||||||
| Time data filter. If the time stamp timestamp of acquired values is different older from the current time by more than stated the configured number of hours in past, they are ignored. Enter 0 (zero) to ignore the time filter. | days | 31 | ||||||
| Directory where the files with ignored data by time filter will be saved (Future Data Filter and History Data Filter). | - | - | ||||||
| TimeoutA delay, it which is inserted after the file was analyzed. | ss.mss | 0.100 | ||||||
| Error file to write information about errors during processing (unknown file in directory, too old or too new values). Empty An empty value means that this error file will not be created. | - | - |
...
- Communication protocol "IEC62056-21:2002 File I/O".
- Station address - the station address is ignored if the input Input file is is the particular file. If the directory is entered, the device number (electrometer) must be entered to assign the processed file to a particular station. If the station with this number does not exist, the file is considered to be unknown (see communication line protocol parameter Unknown files backup directory).
...
Parameter | Description | Unit | Default value | ||||||
---|---|---|---|---|---|---|---|---|---|
| If the input Input file is is a particular file, after this timeout passes without a file being processed, then the station value is transferred to Station goes to a communication error. | min | 45 | ||||||
| Mask for the name testing of the processed files. The following digit placeholder can be used: {N} - electrometer number, beware of mind the number of figurefigures, 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 If a timestamp can be obtained from the file name (if , it is possible) is used at for saving the file saving to the archive directory (see communication Communication line protocol parametersparameter Archive subdirectory time mask). If the electrometer number is gainedcan be obtained, it is used for searching for the proper station. In case of not using the mask is not used, leave the parameter should be empty. The station addresss address is then acquired from the value of object 0.0.0, C.1.0, or ZNR1 (previously, ZNR1 was previously used only in the past only in case ofGorlitz PRM62 Module, currently it is used also for other types of energy meters). | - | - | ||||||
| Complete The complete path to a periodically called external command file (.cmd). The command file is called before accessing the input file. It is used only if a non-empty value has been configured. | - | - | ||||||
| Call period Period of calling the external command file. | mi:ss | 1:00 | ||||||
| Call the external command file synchronously. | YES/NO | YES | ||||||
| All values from communication (even old ones) go to the system as new values. | YES/NO | NO | ||||||
| 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/NO | NO |
...
Kotva | ||||
---|---|---|---|---|
|
...
Address The address of the I/O tag corresponds to standard IEC 62056-61:2002 Object Identification system System (OBIS), "Annex A - Code presentation".
The I/O tag with an address starting with %IGNORE will be ignored.
The shortened Shortened address format is supported: C.D[.E][*F]
...
- C - Value group C (number within the range of 0..99 or symbols 'C', 'F', 'L' or 'P').
- D - Value group D (number within the range of 0..99 or symbols 'C', 'F', 'L' or 'P').
- E - Value group E (number within the range of 0..255).
- F - Value group F (number within the range of 0..255).
A special I/O tag with the address "$SW" acquires the value of the profile status word.
Note: if the D2000 KOM process is required to send all values from the file (even recurring ones), it is necessary to set the New time => new value parameter in the Filter tab.
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) !
...
P.01 - profile
(041022094500) - the time stamp timestamp 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 The next rows contain the values of measurement.
...