...
Protokol EDW LPEX V2.0 je jednoduchý textový súborový protokol. Implementácia protokolu je založená na sekvenčnom spracovaní riadkov súboru. Sú podporené 2 typy súborov:
Súbor LPEX sa Súbor sa skladá z hlavičky a dátovej časti. Hlavička obsahuje popis k poskytovaným dátam, separovaných zadefinovaným separátorom. Tento separátor je použitý aj na oddelenie dát v jednotlivých riadkoch dokumentu.
Telo LPEX súboru môže vyzerať nasledovne:
| LPEX V2.0 |
| Datum;Zeit;Kundennummer;Kundenname;eindeutigeKDNr;GEId;GEKANr;KALINr;Linie;eindeutigeLINr;ZPB;Kennzahl;Einheit;Wandlerfaktor;MPDauer;Werte |
| 15.04.14;00:07:00;;;;;;;;;SK40000041499000000000BESENOVA_T1;AP-M;kWh;1;01;0;00000 |
| 15.04.14;00:07:00;;;;;;;;;SK40000041499000000000BESENOVA_T1;AP+M;kWh;1;01;0;00000 |
| 15.04.14;00:07:00;;;;;;;;;SK40000041499000000000BESENOVA_T2;AP-M;kWh;1;01;27;00000 |
Kde jeden riadok tabuľky zodpovedá jednému riadku v textovom dokumente. Ako je zrejmé, separátorom pre tento dokument bude znak ";", ktorý je možné nastaviť v parametroch stanice ako parameter "Column Delimiter".
...
Pre lepšiu prehľadnosť sú tieto dáta zobrazené v nasledujúcej tabuľke, pričom popis stĺpcov hlavičky je uvedený v parametroch stanice v sekcii Konfigurácia komunikačnej stanice.
| | | | | | | | | | | | | | | | | | | | | | |
|
|
|
|
|
|
|
| ZPB | Kennzahl | Einheit | Wandlerfaktor | MPDauer | Werte | (Flags) |
|---|
| 15.4.2014 | 0:07:00 |
|
|
|
|
|
|
|
| xxx |
| | | xxx | AP-| 00000 |
| 15.4.2014 | 0:07:00 |
|
|
|
|
|
|
|
| yyy | AP+M | kWh | 1 |
10 | | yyy | AP+M | kWh | 1 | 1 | 0 | 0 | | 15.4.2014 | 0:07:00 | | | | | | | | | zzz | AP-M | kWh | 1 | 1 | 27 | 0 |
Súbor MPX je ešte primitívnejší textový súborový protokol, ktorý má iba dátovú časť. Telo MPX súboru môže vyzerať nasledovne:
SK10000022099000000000ETRENCIN_G1;AP-M;1;01;00;0;1805151136;92.4;kWh |
| SK10000022099000000000ETRENCIN_G2;AP-M;1;01;00;0;1805151136;94.8;kWh |
| SK10000022099000000000ETRENCIN_T1;AP-M;1;01;00;0;1805151136;91;kWh |
Pre lepšiu prehľadnosť sú tieto dáta zobrazené v nasledujúcej tabuľke, pričom popis stĺpcov hlavičky je uvedený v parametroch stanice v sekcii Konfigurácia komunikačnej stanice.
| ZPB | Kennzahl | Wandlerfaktor | MPDauer | (Flags) |
| Datum+Zeit | Werte | Einheit |
|---|
| SK10000022099000000000ETRENCIN_G1 | AP-M | 1 | 01 | 00 | 0 | 1805151136 | 92.4 | kWh |
| SK10000022099000000000ETRENCIN_G2 | AP-M | 1 | 01 | 00 | 0 | 1805151136 | 94.8 | kWh |
| SK10000022099000000000ETRENCIN_T1 | AP-M | 1 | 01 | 00 | 0 | 1805151136 | 91 | kWh |
Pokiaľ sú analyzované MPX súbory, je poradie stĺpcov fixné a parametre protokolu, ktoré udávajú názvy stĺpcov v LPEX hlavičke ako aj maximálny počet stĺpcov (Date Column Name, Time Column Name .. Interval Name a Max. Columns Number) sú ignorované. Ignorované sú aj parametre Date Conversion Mask a Time Conversion Mask určujúce formát dátumu a času a predpokladá sa formát yymmddhhmi.
| Kotva |
|---|
| komunikacna_linka |
|---|
| komunikacna_linka |
|---|
|
Konfigurácia komunikačnej linky
...
- Kategória komunikačnej linky: FILE I/O.
- Parameter "Vstupný súbor" je je použitý iba pokiaľ sú nastavené parametre Primary FTP Server a/alebo Secondary FTP Server a parametrom ZIP File Mask je špecifikované, že vstupné súbory sú vo formáte ZIP (*.zip) - vstupné súbory sa sťahujú zo zadaných FTP serverov a ZIP súbory sa hľadajú v adresári, ktorý špecifikuje parameter "Vstupný súbor".
- Parameter "Archívny adresár" špecifikuje adresár na odkladanie spracovaných súborov.
| Kotva |
|---|
| komunikacna_stanica |
|---|
| komunikacna_stanica |
|---|
|
Konfigurácia komunikačnej stanice
...
Dialóg konfigurácia stanice - záložka Parametre protokolu.
Ovplyvňujú niektoré voliteľné parametre protokolu. Môžu byť zadané nasledovné parametre protokolu stanice:
| Parameter | Implicitne nastavená hodnota | Popis |
|---|
| LPEX | Typ spracúvaných súborov - LPEX (*.lpx) alebo MPX (*.mpx). |
| Datum | Názov stĺpca obsahujúci údaje o dátume. |
| Zeit | Názov stĺpca obsahujúci údaje o sčase. |
| ZPB | Názov stĺpca obsahujúci adresu hodnoty. |
| EinHeit | Názov stĺpca obsahujúci jednotky meranej veličiny. |
| Werte | Názov stĺpca obsahujúci hodnoty meranej veličiny. |
| Kennzahl | Názov stĺpca obsahujúceho typ hodnoty (AP+ ,AP- ,AQ+ ,AQ-). |
| MPDauer | Názov stĺpca obsahujúci granularitu merania [ |
s| min]. |
| 30 | Definuje maximálny počet stĺpcov, cez ktoré sa prechádza pri získavaní údajov. |
| ; | Separátor hodnôt v hlavičke a v tele dokumentu. |
| dd.mm.rr | Maska slúžiaca pre konverziu textového dátumu na interný čas. V prípade MPX súborov je maska ignorovaná. |
| hh:mi:ss | Maska slúžiaca pre konverziu textového času na interný čas. V prípade MPX súborov je maska ignorovaná.
Pozn: čas v LPEX aj MPX súbore sa predpokladá v zimnom pásmovom čase. |
|
|
| Adresár, do ktorého sú ukladané dávkové súbory (napr. rozbalenie ZIP archívu). |
|
|
| Iba OpenVMS. Adresár (napr. DKA0:[IFAZD]) obsahujúci dávkové súbory TESTZIP.COM a UNZIP.COM. |
| ftp_download.com | Dávkový súbor pre stiahnutie dát z FTP servera. |
| deltmp.com | Dávkový súbor pre vymazanie dočasných súborov (FTP_DELETECMD, MAKE_TESTZIP.COM, MAKE_UNZIP.COM). |
| GOEONL{rrrr}-{mm}-{dd}-{hh}-{mi}-{ss}.zip* | Časová a dátumová maska pre názov |
.zip súboru| ZIP súboru. Ak je parameter prázdny, predpokladá sa, že v adresári, ktorý špecifikuje parameter Directory for Unzipped files, sa nachádzajú priamo LPEX alebo MPX súbory. |
| GOEONL_{rr}{mm}{dd}{hh}{mi}.lpx* | Časová a dátumová maska pre názov rozbaleného |
.lpx súboru.| LPEX súboru. Pokiaľ sa spracúvajú MPX súbory, ich názov musí vyhovovať maske *{yy}{mm}{dd}{hh}{mi}.mpx alebo aspoň *{yy}{mm}{dd}{hh}{mi}.*, napr. ETREN_03_1805151136.mpx |
Directory for Unzipped files | DKA200:[000000.IFAZD.UNZIPPED] | Adresár, z ktorého sa budú čítať rozbalené |
.lpx . |
| 2Rove | Adresár na FTP serveri, ktorý obsahuje |
.zip | ZIP súbory. |
| 10.11.1.131 | Meno/IP adresa primárneho FTP servera. Ak je parameter prázdny, nesťahujú sa súbory z primárneho FTP servera.
Pozn: ak sú parametre Primary FTP Server aj Secondary FTP Server prázdne, súbory sa hľadajú v adresári, ktorý špecifikuje parameter Directory for Unzipped files. |
| 10.11.1.131 | Meno/IP adresa sekundárneho FTP servera. Ak je parameter prázdny, nesťahujú sa súbory zo sekundárneho FTP servera. |
|
azduser| azdinterface | Meno FTP užívateľa na primárnom aj sekundárnom FTP serveri. |
| *** | Heslo FTP užívateľa na primárnom aj sekundárnom FTP serveri. |
| 30 | V prípade, že operácia sťahovania alebo mazania súborov na FTP serveri trvala dlhšie ako daný parameter, je táto informácia zapísaná do logu KOM procesu. |
Active Energy Tech. Units | MWH | Technické jednotky, na ktoré sa prevádza hodnota aktívnej energie. |
Reactive Energy Tech. Units | MVARH | Technické jednotky, na ktoré sa prevádza hodnota jalovej energie. |
| 1 min | Očakávaný časový interval všetkých hodnôt. Ak je údaj v stĺpci "Interval Name" spracovávaného súboru väčší ako "Expected |
intervalInterval", hodnota sa rovnomerne rozpočíta do niekoľkých intervalov s veľkosťou "Expected Interval".
Hodnota parametra 0 vypína toto chovanie. |
Analyze Archived Files on Startup | YES | KOM proces pri štarte pozrie staré zdroje údajov, aby bolo možné spätne dopočítať hodnotu elektrickej práce. |
| NO | Analyzuje aj súbory staršie ako "Maximum File Age". |
| 3 hod | Ak je prekročený daný interval, hodnoty sa buď ignorujú alebo spracujú ako Old Values. V závislosti od nastavenia parametra "Send Old Values". |
Debug unknown and lost tags |
| NO | Povolenie zobrazovania upozornení o adresách meracích miest, ku ktorým nebol nájdený meraný bod. |
| NO | Všetky hodnoty z komunikácie (aj staré) idú do systému ako nové hodnoty. |
Konfigurácia meraných bodov
...
Adresa meraného bodu je zložená z troch častí.
Prvá časť adresy určuje typ veličiny:
- P - Power (výkon vypočítaný z hodnoty Energie načítanej zo vstupného súboru)
- W - Work (práca vypočítaná integráciou výkonu v aktuálnej hodine)
- E - Energy (energia priamo zo vstupného súboru s prípadným rozpočtom hodnoty podľa veľkosti Intervalu - viď parameter Expected Interval)
, či veličina obsahuje hodnotu práce alebo výkonu . Následne "Primary EAN Code" a "BackupEAN Code" slúži slúžia ako jednoznačný identifikátor veličiny, ktorý sa v zdrojovom súbore nachádza v stĺpci "Address Column Name".
Posledná časť adresy je vymenovaný typ (AP+,AP-,AQ+,AQ-), ktorý sa v zdrojovom súbore nachádza v stĺpci "Value Type Column Name".
Image Removed
Poznámka: v súčasnosti nie je podporená konfigurácia meraných bodov, z ktorých jeden má prvú časť adresy Power a druhý Energy a ďalšie dve časti majú zhodné. Z takýchto bodov bude fungovať vždy iba jeden. Kombinácie Power + Work alebo Work + Energy sú podporené.
Image Added
Existujú aj špeciálne adresy:
- meraný bod s adresou TRIGGER nadobudne hodnotu rovnú počtu spracovaných LPEX alebo MPX súborov ihneď po ich kompletnom spracovaní
- meraný bod s adresou INVALIDS po spracovaní každého súboru nadobudne hodnotu rovnú počtu meraných bodov, pre ktoré sa dáta v súbore nenachádzali
| Kotva |
|---|
| indikacia_chybovych_stavov |
|---|
| indikacia_chybovych_stavov |
|---|
|
Indikácia chybových stavov
...
- čas vyplývajúci zo súboru je starší ako parameter "Maximum File Age" a zároveň je zapnutý parameter "Send Old Values",
- spracúvajú sa dáta mimo aktuálnej hodiny, napríklad, ak v čase 14:03 prišiel záznam s časovou pečiatkou 13:45,
- pre meraný bod prišli staršie dáta, ako už spracoval.
...
- Ver. 1.0 - 23. apríl 2014 - Vytvorenie dokumentu.
- Ver. 1.1 - 17. máj 2018 - Podpora MPX súborov.
...