LookDet Dispečerský systém Návod na obsluhu Administrátor Verze 1.06 lookdet_a_g_cz_106
AMiT, spol. s r. o. nepřejímá žádné záruky, pokud se týče obsahu této publikace a vyhrazuje si právo měnit obsah dokumentace bez závazku tyto změny oznámit jakékoli osobě či organizaci. Tento dokument může být kopírován a rozšiřován za následujících podmínek: 1. Celý text musí být kopírován bez úprav a se zahrnutím všech stránek. 2. Všechny kopie musí obsahovat označení autorského práva společnosti AMiT, spol. s r. o. a veškerá další upozornění v dokumentu uvedená. 3. Tento dokument nesmí být distribuován za účelem dosažení zisku. V publikaci použité názvy produktů, firem apod. mohou být ochrannými známkami nebo registrovanými ochrannými známkami příslušných vlastníků. AMiT je registrovaná ochranná známka. Copyright (c) 2016, AMiT, spol. s r. o. Výrobce: AMiT, spol. s r. o. Naskové 1100/3, 150 00 Praha www.amit.cz Technická podpora: support@amit.cz lookdet_a_g_cz_106 2/153
Obsah Historie revizí... 6 Související dokumentace... 6 1 Úvod... 7 1.1 Licencování... 7 2 Obsluha dispečerského systému... 9 2.1 Vyhrazené znaky... 9 2.2 Přihlášení administrátora... 9 2.3 Výchozí obrazovka... 10 3 Administrace systému... 12 3.1 Stránka administrace dispečerského systému... 12 3.1.1 Nástrojová lišta stránky administrátora... 13 3.1.2 Nástrojová lišta zvolené sekce... 15 3.1.3 Seznam položek... 15 3.1.4 Editační panel... 16 3.2 Správa lokalit... 16 3.2.1 Založení nové lokality... 18 3.2.2 Editace stávající lokality... 19 3.2.3 Vymazání stávající lokality... 20 3.3 Správa ovladačů... 21 3.3.1 Založení nové definice ovladače... 23 3.3.2 Editace stávající definice ovladače... 25 3.3.3 Vymazání definice stávajícího ovladače... 26 3.3.4 Systémové ovladače... 27 3.4 Správa stanic... 28 3.4.1 Založení nové stanice... 29 3.4.2 Editace stávající stanice... 31 Diagnostika spojení... 33 Definice cyklického čtení... 34 Definice poruch... 38 Import textů provozního deníku... 43 Definice zpětného čtení archívů... 45 3.4.3 Vymazání stávající stanice... 51 3.5 Správa kanálů... 51 3.5.1 Přiřazení kanálů ke stanici... 55 3.5.2 Nastavení / editace parametrů kanálu... 56 Vymazání hodnoty ze seznamu kanálu... 60 3.5.3 Manuální vytvoření kanálu v lokalitě... 60 3.5.4 Kanál typu text... 62 3.5.5 Export/Import parametrů kanálu... 63 3.5.6 Vymazání stávajícího kanálu... 63 3.6 Správa náhledů... 64 3.6.1 Založení nového náhledu... 65 3.6.2 Editace parametrů stávajícího náhledu... 65 Klonování vytvořeného náhledu... 67 Export grafické podoby náhledu... 68 Import grafické podoby náhledu... 68 3/153 lookdet_a_g_cz_106
Stažení starší verze náhledu... 68 Vymazání stávajícího náhledu... 69 3.6.3 Editace grafické podoby náhledu... 69 3.6.4 Přiřazení funkcí ke grafickým objektům... 69 Uložení přiřazených funkcí k objektům náhledu... 70 Nástrojová lišta náhledu... 71 3.6.5 Přehled funkcí pro parametrizaci objektů... 72 Uživatelské funkce... 73 3.6.6 Ostrý náhled... 73 3.6.7 Šablony a podřízené náhledy... 73 Speciální funkce šablon... 76 3.7 Správa uživatelů... 77 3.7.1 Založení nového uživatele / skupiny... 78 3.7.2 Editace stávajícího uživatele / skupiny... 80 Klonování vytvořeného uživatele / skupiny... 81 3.7.3 Vymazání stávajícího uživatele / skupiny... 82 3.8 Nastavení práv uživatelům / skupině... 82 3.8.1 Administrativní práva... 84 3.8.2 Dostupné stanice... 86 3.8.3 Operace na stanicích... 86 3.8.4 Dostupné náhledy... 88 3.9 Lokalizace (jazykové mutace)... 88 3.9.1 Založení nové lokalizace... 89 3.9.2 Editace stávající lokalizace... 90 Export lokalizačních textů... 92 Import lokalizačních textů... 92 3.9.3 Vymazání stávající lokalizace... 92 3.10 Správa systému... 93 3.10.1 Panel pro aktualizaci LookDet... 94 3.10.2 Panel pro správu licence... 95 3.10.3 Panel pro zálohování... 96 3.10.4 Panel s informacemi o stavu serveru... 97 3.10.5 Panel pro restart serveru... 97 3.10.6 Panel pro příkaz Ping... 97 3.10.7 Panel TCP DUMP... 98 3.10.8 Panel s logem administrace... 99 3.10.9 Systémové náhledy... 99 Náhled Stav aplikací (APP STATUS)... 100 Náhled Stav systému (SYSTEM STATUS)... 101 3.11 Odhlášení administrátora... 103 4 Funkce pro objekty v náhledech... 104 4.1 Práce s barvami u jednotlivých funkcí... 104 4.1.1 Nastavení sytosti zvolené barvy... 105 4.1.2 Posuvník pro rychlý výběr barvy... 105 4.1.3 Zadání barvy číselně nebo prostřednictvím posuvníků... 106 4.1.4 Uložení barvy pro příští použití... 106 4.2 Reakce na kliknutí... 107 4.2.1 Na kliknutí nic nedělat... 107 4.2.2 Na kliknutí zobrazit graf... 108 4.2.3 Na kliknutí zobrazit tabulku... 109 lookdet_a_g_cz_106 4/153
4.3 Práce s maskou u bitových funkcí... 110 4.4 Práce s více hodnotami v jedné funkci... 110 4.5 Zobrazení číselné hodnoty... 111 4.6 Zobrazení času... 112 4.7 Barva podle hodnoty... 113 4.8 Barva podle bitu... 114 4.9 Text a barva podle bitu... 114 4.10 Viditelnost podle bitu... 114 4.11 Zobrazení textu... 115 4.12 Ukazatel průběhu... 115 4.13 Graf pro ¼ hod maximum... 116 4.14 Nastavení parametrů (editace dat ve stanici)... 118 4.15 Nastavení časových plánů... 123 4.16 Nastavení křivky (interpol)... 124 4.17 Nastavení křivky (EqLine)... 124 4.18 Lokalizace lokalizační label... 125 4.19 Zobrazení trendů... 125 4.20 Stav obnovy... 125 4.21 Nový náhled v okně... 126 4.22 Provozní deník... 126 5 Dodatek A... 127 5.1 Parametrizace funkcí pro nastavení hodnot ve stanici... 127 5.1.1 Zadání hodnoty... 127 5.1.2 Zadání binární hodnoty... 129 5.1.3 Výběr jedné z několika hodnot... 134 5.1.4 Zadání textu... 135 5.1.5 Zápis konstanty... 137 6 Dodatek B... 140 6.1 HTTP POST... 140 6.1.1 Základní údaje... 140 6.1.2 Základní formát dotazu... 140 6.1.3 Možné varianty get tvar dotazu a odpovědi... 141 6.1.4 Možné varianty put tvar dotazu a odpovědi... 142 6.1.5 Tvar datového bloku... 143 6.1.6 Šifrování... 144 6.1.7 Chybové zprávy... 145 7 Dodatek C... 146 7.1 M-Bus TCP (UDP)... 146 Vynucená komunikační rychlost... 147 Pevná komunikační rychlost... 147 7.1.1 Získání dat... 148 7.1.2 Licence... 150 8 Dodatek D... 151 8.1 Modbus/TCP master... 151 8.1.1 Získání dat... 152 5/153 lookdet_a_g_cz_106
Historie revizí Jméno dokumentu: lookdet_a_g_cz_106.pdf Verze Datum Autor změny Změny 100 30. 08. 2013 Říha Zbyněk Nový dokument. 101 24. 02. 2014 Říha Zbyněk Aktualizace dokumentu dle chování LookDet v 2.0. 102 27. 06. 2014 Říha Zbyněk Aktualizace dokumentu dle chování LookDet v 2.3.3. 103 13. 08. 2014 Říha Zbyněk Úprava informací o provozním deníku v kapitolách 3.4.1, 3.5.2 a 4.17. 104 09. 03. 2015 Říha Zbyněk Aktualizace dokumentu dle chování LookDet v 2.4.4. 105 16. 07. 2015 Říha Zbyněk Aktualizace dokumentu dle chování LookDet v 2.5.5. 106 07. 09. 2016 Říha Zbyněk Aktualizace dokumentu dle chování LookDet v 2.6.6. 29. 11. 2016 Mlejnek J. Aktualizace šablony. Související dokumentace 1. LookDet Dispečerský systém Návod na obsluhu Uživatel soubor: lookdet_u_g_cz_xxx.pdf 2. Nápověda k části PseDet, vývojového prostředí DetStudio soubor: Psedet_cs.chm 3. Nápověda k části EsiDet, vývojového prostředí DetStudio soubor: Esidet_cs.chm 4. Aplikační poznámka AP0006 Komunikace v síti Ethernet soubor: ap0006_cz_xx.pdf lookdet_a_g_cz_106 6/153
1 Úvod Tento dokument je rozšířením základního návodu na obsluhu dispečerského systému LookDet pro uživatele. Popisuje možnosti administrátora systému. Možnosti systému Možnosti administrátora Poznámka Poznámka Zobrazení hodnot Zobrazení grafů Možnost editace Ke každé hodnotě je možno v závislosti na nastavení zobrazit graf s historií Zobrazované hodnoty jsou v závislosti na nastavení automaticky archivovány Zvýraznění hodnot mimo nastavený rozsah Možnost nastavení práv uživatelům Správa ovladačů Správa stanic a poruch Správa kanálů Správa náhledů Správa uživatelů Správa lokalit Správa systému Nastavení práv uživatelům Pro účely běžného přístupu k serveru je nutné: umožnit přístup na port 80 serveru pro zobrazení webových stránek, umožnit přístup periferiím, které poskytují dispečerskému systému LookDet data, na porty nastavené při jeho parametrizaci. Pro účely údržby serveru / servisu dispečerského systému LookDet je nutné umožnit SSH přístup na server (implicitně TCP port 22) s právy uživatele ROOT (SUDO). Pro přístup k dispečerskému systému LookDet je doporučeno využívat protokol HTTPS, který mimo jiné umožňuje zabezpečit spojení mezi webovým prohlížečem a webovým serverem před odposloucháváním. Pro takovýto způsob komunikace by měl majitel serveru, na kterém je LookDet provozován, vlastnit digitální certifikát. Certifikát vytváří certifikační autorita a může být placený. Výchozí maximální velikost jakéhokoliv souboru, který lze na server s dispečerským systémem LookDet nahrát je 2 MB. Toto omezení je dáno výchozím nastavením OS Ubuntu, kde dispečerský systém LookDet běží. PHP limit 2 MB může změnit pouze administrátor OS Ubuntu. 1.1 Licencování Jedna licence dispečerského systému je vázána vždy na jeden hardware a není uživatelsky přenositelná mezi různým hardware bez předchozí domluvy s poskytovatelem licence. Porušení licence může vést až ke ztrátě dat! 7/153 lookdet_a_g_cz_106
Systém LookDet neobsahuje žádnou funkci umožňující autorům systému přístup k datům zákazníka bez jeho souhlasu a vědomí. Autoři projektu nemonitorují ani neshromažďují data běžících LookDet serverů. Jediná data přenášená ze serveru systému LookDet jsou informace o aktuální verzi a licenční klíč potřebný k ověření platnosti licence příslušného serveru. I tato data jsou však přenášena pouze v případě aktualizace systému LookDet. lookdet_a_g_cz_106 8/153
2 Obsluha dispečerského systému Pro použití dispečerského systému je na klientské stanici třeba: připojení k Internetu, podpora zobrazení/editace grafického formátu SVG, spuštěný webový prohlížeč. Doporučený nástroj pro editaci SVG je program Inkscape (zdarma ke stažení na http://inkscape.org/). Doporučené prohlížeče jsou Chrome nebo Firefox. Na ostatních prohlížečích se může obsah zobrazovat rozdílně. Do adresního řádku prohlížeče je třeba zadat IP adresu nebo jmennou adresu vizualizačního serveru. 2.1 Vyhrazené znaky Při parametrizaci systému není v současné době možné použití některých znaků v názvech a textech. Jsou to: _ (podtržítko), " (uvozovky), ' (apostrof), # (mřížka), ; (středník), $ (dolar). 2.2 Přihlášení administrátora Po zadání adresy http(s)://<ip adresa nebo DNS jméno>/lookdet je zobrazen přihlašovací dialog: Obr. 1 Přihlašovací dialog 1 Přihlašovací jméno 2 Heslo 3 Tlačítko pro přihlášení 9/153 lookdet_a_g_cz_106
Administrátor zadá přidělené přihlašovací jméno a své heslo. Výchozí přihlašovací údaje pro první přihlášení jsou: Jméno: admin Heslo: admin Po prvním přihlášení důrazně doporučujeme změnit výchozí přihlašovací údaje! Informace o změně uživatelských údajů lze nalézt v kapitole 3.7.2 Editace stávajícího uživatele / skupiny. 2.3 Výchozí obrazovka Po zadání správných přihlašovacích údajů je administrátor přesměrován na výchozí obrazovku, stejně jako běžný uživatel (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Obr. 2 Hlavní stránka uživatelské části 1 Lišta uživatelem definovaných záložek 2 Pracovní plocha 3 Tlačítko pro zavření náhledu lookdet_a_g_cz_106 10/153
4 Tlačítko pro zobrazení seznamu poruch 5 Tlačítko pro vyvolání menu 6 Uživatelem zvolené náhledy stanic Aktualizace dat, zobrazovaných v jednotlivých náhledech, je dána četností jejich aktualizace řídicím systémem, vnitřním mechanismem LookDetu a obnovou okna prohlížeče (manuální nebo automatická). Vnitřní mechanismus LookDetu přitom může zpozdit aktualizaci dat maximálně o 30 s. Práci s pracovní plochou popisuje návod na obsluhu (lookdet_u_g_cz_xxx.pdf). 11/153 lookdet_a_g_cz_106
3 Administrace systému Systém rozlišuje dva typy administrátorů: Globální administrátor má neomezená práva, Administrátor lokality má přístup pouze do administrace lokality (vyhrazené oblasti nadefinované v dispečerském systému). Pokud má přihlášený uživatel nastavena práva administrátora, bude mu administrace systému dostupná z menu, pomocí položky Administrace systému. Obr. 3 Položka pro vstup do administrace systému Po výběru položky je administrátor přesměrován na stránku administrace systému. 3.1 Stránka administrace dispečerského systému Stránka administrace se skládá z: nástrojové lišty stránky administrátora, nástrojové lišty zvolené sekce, seznamu položek ve zvolené sekci, editačního panelu. lookdet_a_g_cz_106 12/153
Obr. 4 Stránka administrace 1 Nástrojová lišta stránky administrátora 2 Nástrojová lišta zvolené sekce 3 Seznam položek 4 Editační panel 3.1.1 Nástrojová lišta stránky administrátora Nástrojová lišta stránky administrátora obsahuje dvě skupiny tlačítek: tlačítka pro přepínání mezi sekcemi správy systému, administrátorská tlačítka. Obr. 5 Nástrojová lišta administrátora lokality 1 Tlačítka pro přepínání mezi sekcemi správy systému 2 Administrátorská tlačítka Tlačítka pro správu systému Množství sekcí pro správu systému se liší v závislosti na přihlášeném administrátorovi (globální administrátor / administrátor lokality). Jak globální administrátor, tak administrátor lokality může v sekcích pro správu systému provádět: výběr použitých jazykových mutací v lokalitě, nastavení hesla lokality pro HTTP POST, 13/153 lookdet_a_g_cz_106
správu ovladačů, správu stanic a poruch, správu kanálů, správu náhledů, správu uživatelů, nastavení práv uživatelům. Globální administrátor, může navíc provádět: správu lokalit, lokalizaci (jazykové mutace prostředí), správu systému. Níže jsou uvedeny sekce dostupné globálnímu administrátorovi. Obr. 6 Sekce dostupné globálnímu administrátorovi Vybraná sekce je od ostatních barevně odlišena. Obr. 7 Barevné odlišení sekcí 1 Vybraná sekce 2 Nevybraná sekce Admin. tlačítka Administrátorská tlačítka se zobrazují vždy, nezávisle na typu přihlášeného administrátora. Význam tlačítek je patrný z následujícího obrázku: Obr. 8 Administrátorská tlačítka 1 Tlačítko pro přepnutí barevného schématu 2 Tlačítko pro návrat na výchozí obrazovku 3 Tlačítko pro odhlášení administrátora lookdet_a_g_cz_106 14/153
3.1.2 Nástrojová lišta zvolené sekce Nástrojová lišta obsahuje vždy vyhledávací / filtrovací pole, název sekce (případně název editované lokality dle typu přihlášeného administrátora) a skupinu tlačítek pro práci s vybranou sekcí. Obr. 9 Nástrojová lišta zvolené sekce 1 Pole pro zadání vyhledávacího filtru 2 Název zvolené sekce, případně název editované lokality 3 Tlačítko (tlačítka) pro práci s vybranou sekcí Použití vyhledávacího filtru Filtrování je možné provádět zadáním hledaných znaků do pole vyhledávacího filtru. Okamžitě po zadání jakéhokoliv znaku bude automaticky provedeno filtrování již nadefinovaných položek editované sekce v závislosti na tom, zda obsahují zadaný znak nebo nikoliv. 3.1.3 Seznam položek Seznam položek obsahuje seznam již nadefinovaných položek ve vybrané sekci. Při umístění kurzoru myši na položku dojde k jejímu zvýraznění a případnému zobrazení tlačítek pro práci s vybranou položkou. Obr. 10 Seznam položek 1 Zvýrazněná položka seznamu s kurzorem myši a tlačítky 2 Nezvýrazněná položka seznamu Kliknutím na položku seznamu dojde k zobrazení zadaných dat dané položky v editačním panelu. Pak je možné provádět editaci vybrané položky. 15/153 lookdet_a_g_cz_106
3.1.4 Editační panel 3.2 Správa lokalit Slouží pro editaci již vytvořených položek nebo pro zadávání parametrů nově vytvářeným položkám. Lokalita je oblast, která v sobě sdružuje skupinu dat z libovolného množství řídicích systémů. Každá lokalita může mít k dispozici také libovolné množství uživatelů, kteří mohou pracovat pouze s daty dané lokality, případně s daty z vybraných řídicích systémů, které jsou do lokality přiřazeny. Poznámka Omezení množství řídicích systémů a uživatelů v lokalitách je dáno pouze výkonem hardware serveru. Množství nadefinovaných řídicích systémů a uživatelů v lokalitě, stejně jako množství použitelných lokalit je dáno zakoupenou licencí. Počet lokalit je také závislý na výpočetním výkonu serveru a počtu připojených řídicích systémů. Pro správu lokalit slouží sekce Lokality. Administrátorovi lokality umožňuje: výběr dostupné lokalizace (viz kapitola 3.9 Lokalizace ), zadání / úpravu hesla pro HTTP POST (viz kapitola 6.1 HTTP POST ). Globálnímu administrátorovi umožňuje sekce Lokality navíc: založení nové lokality, úpravu stávající lokality včetně jejího popisu, vymazání stávající lokality. V případě přihlášeného globálního administrátora obsahuje sekce seznam lokalit, které byly v systému nadefinovány, včetně jejich ID, které je automaticky generováno pro účely použití komunikace prostřednictvím HTTP POST (viz kapitola 6.1 HTTP POST ) a tlačítko pro založení nové lokality. lookdet_a_g_cz_106 16/153
Obr. 11 Sekce pro správu lokalit 1 Seznam lokalit 2 ID pro komunikaci pomocí HTTP POST 3 Tlačítko pro založení nové lokality Každá lokalita má samostatné ovladače, data, kanály a je naprosto nezávislá na všech ostatních lokalitách. Pokud je do systému LookDet přihlášen globální administrátor a chce pracovat s již vytvořenou lokalitou, musí vždy provést výběr (kliknutím levým tlačítkem myši) jedné z již nadefinovaných lokalit. Veškeré další sekce pak budou zobrazovat data právě pro takto vybranou lokalitu. V případě, že by nedošlo k výběru požadované lokality, bude globálnímu administrátorovi při snaze o zobrazení jiné sekce nabídnuto okno s výběrem lokality. Obr. 12 Okno s výběrem lokality 17/153 lookdet_a_g_cz_106
Stejné okno s výběrem lokality může globální administrátor vyvolat z jiných sekcí pomocí tlačítka pro výběr lokality z nástrojové lišty vybrané sekce. Obr. 13 Nástrojová lišta globálního administrátora v jiných sekcích 1 Tlačítko pro vyvolání okna s výběrem lokalit 3.2.1 Založení nové lokality Založení nové lokality lze provést stiskem tlačítka + v nástrojové liště sekce Lokality. V editačním panelu dojde k zobrazení parametrů, nutných pro založení nové lokality. Obr. 14 Parametry pro založení nové lokality 1 Parametry lokality 2 Výběr dostupných jazykových mutací 3 Tlačítko pro potvrzení vytvoření lokality Význam jednotlivých parametrů je následující: Popis lokality textový popis, zobrazovaný v seznamu lokalit (dostupné pouze globálnímu administrátorovi). lookdet_a_g_cz_106 18/153
Heslo lokality heslo pro šifrování datového bloku při komunikaci pomocí HTTP POST (viz kapitola 6.1 HTTP POST ). Lokalizace lokality dostupné jazykové mutace (viz kapitola 3.9 Lokalizace (jazykové mutace) ). Výběr jazykové mutace lze provést kliknutím levým tlačítkem myši na odpovídající zatržítka v sekci Lokalizace lokality Zrušení vybrané jazykové mutace lze učinit opětovným kliknutím levým tlačítkem myši na odpovídající zatržítka s vybranou lokalizací. Založení nové lokality proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu zadávání parametrů nové lokality ke kliknutí na název již vytvořené lokality nebo k přechodu do jiné sekce, nebude nově vytvářená lokalita založena a její údaje budou ztraceny. 3.2.2 Editace stávající lokality Editaci lokality lze provést v editačním panelu po kliknutí na požadovanou lokalitu v seznamu lokalit. Význam jednotlivých položek je stejný jako při zakládání nové lokality (viz kapitola 3.2.1 Založení nové lokality ). Obr. 15 Výběr lokality se zobrazenými tlačítky 1 Vybraná lokalita 2 Údaje vybrané lokality 3 Tlačítko pro uložení změn 19/153 lookdet_a_g_cz_106
Potvrzení provedených změn v lokalitě proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu úpravy parametrů stávající lokality ke kliknutí na název již vytvořené lokality nebo k přechodu do jiné sekce, nebudou provedené změny uloženy a dojde k jejich ztrátě. Po najetí kurzoru myši na již vytvořenou lokalitu, je nabízeno tlačítko, které umožňuje vymazání stávající lokality. Obr. 16 Zvýraznění lokality 1 Zvýraznění lokality najetím kurzoru myši 2 Nezvýrazněná lokalita 3 Tlačítko pro vymazání lokality 3.2.3 Vymazání stávající lokality Vymazání stávající lokality lze provést pomocí tlačítka se symbolem popelnice, který se zobrazí u názvu lokality v případě, kdy je kurzor myši umístěn na název lokality v seznamu lokalit. Obr. 17 Zobrazení tlačítka pro vymazání lokality 1 Zvýrazněná lokalita 2 Kurzor myši 3 Tlačítko pro vymazání lokality lookdet_a_g_cz_106 20/153
Po jeho stisku dojde k otevření okna pro vymazání lokality. Obr. 18 Okno pro vymazání lokality 1 Tlačítko pro potvrzení vymazání lokality a zavření okna 2 Tlačítka pro zavření okna bez vymazání lokality Potvrzením vymazání lokality dojde k zobrazení upozornění o nenávratném zrušení lokality. Obr. 19 Okno s potvrzením nenávratného zrušení 1 Tlačítka pro zavření okna bez zrušení lokality 2 Tlačítko pro potvrzení nenávratného zrušení lokality a zavření okna Druhým potvrzením vymazání dojde nevratnému zrušení lokality včetně všech souvisejících dat a kanálů přiřazených k lokalitě. Vymazání lokality je tedy nutné dvakrát potvrdit. 3.3 Správa ovladačů Vymazání lokality může provést pouze globální administrátor. Ovladač je prostředek, pomocí kterého: jsou do systému LookDet předávána data z připojených periferií, LookDet zasílá požadovaná data do připojených periferií. 21/153 lookdet_a_g_cz_106
Pro správu ovladačů slouží sekce Ovladače, kde je možné pro vybranou lokalitu: zakládat nové definice ovladače, spustit / zastavit stávající definici ovladače, upravovat vlastnosti stávajících definicí ovladačů, vymazat stávající definice ovladače. Obr. 20 Sekce pro správu ovladačů 1 Seznam definic ovladačů ve vybrané lokalitě 2 Tlačítka sekce správy ovladačů V jedné lokalitě obecně postačí definovat jeden ovladač pro jeden typ komunikačního protokolu. Význam jednotlivých položek na řádku s definicí ovladače, je patrný z následujícího obrázku. Obr. 21 Význam položek jednoho řádku seznamu 1 Logo ovladače 2 Popis a nastavení ovladače 3 Indikátor stavu ovladače 4 Tlačítko pro změnu stavu ovladače aktivovat / deaktivovat Význam ikon v indikátoru stavu je uveden v následující tabulce: Vzhled Význam Ovladač běží Ovladač stojí lookdet_a_g_cz_106 22/153
Význam vzhledu tlačítka pro aktivaci / deaktivaci ovladače je uveden v následující tabulce: Vzhled Význam Spustit ovladač Zastavit ovladač V nástrojové liště správy ovladačů je dostupné tlačítko s ikonou žárovka. Po stisku tlačítka je zobrazen seznam aktuálně připojených řídicích systémů, které používají pro komunikaci dynamickou IP adresu. Obr. 22 Přehled připojených stanic s dynamickými IP adresami Je zobrazen čas poslední identifikace, počet sekund od poslední identifikace, IP adresa a port, ze kterého stanice navázala spojení. Seznam je automaticky obnovován. Záznamy, které nejsou obnoveny alespoň 1 za 5 minut zešednou. Záznamy neobnovené 1 hodinu se automaticky odstraňují. Poznámka Tato funkce je dostupná pouze pro produkty firmy AMiT, které umožňují komunikaci na dynamické IP adrese. Obnovu dynamické IP adresy ze strany produktů firmy AMiT je doporučeno provádět každých 60 s. 3.3.1 Založení nové definice ovladače Založení nové definice ovladače lze provést stiskem tlačítka + v nástrojové liště sekce Ovladače. V editačním panelu dojde k zobrazení parametrů, nutných pro založení nového ovladače. 23/153 lookdet_a_g_cz_106
Obr. 23 Zobrazení údajů pro založení nového ovladače 1 Údaje ovladače 2 Tlačítko pro uložení parametrů nového ovladače Údaje ovladače: Popis ovladače uživatelská identifikace ovladače (zobrazuje se v seznamu správy ovladačů). Typ ovladače výběr typu ovladače. Číslo portu naslouchací port ovladače v rozsahu 10000 až 65000. Na tento port budou zapisovat připojené řídicí systémy. V případě snahy o použití již obsazeného portu je administrátor upozorněn dialogovým oknem s požadavkem na použití jiného portu. Číslo stanice číslo stanice, pod kterým bude k dispozici zakládaný ovladač v systému DB-Net/IP. Toto číslo musí být uvedeno v SW vzdálených řídicích systémů jako číslo stanice, do které vzdálené řídicí systémy zapisují. Heslo stanice heslo, které musí být uvedeno v SW vzdálených řídicích systémů jako heslo stanice, do které vzdálené řídicí systémy zapisují. Automatický start určuje, zda po restartu bude tento ovladač aktivní, nebo nikoliv. Založení nové definice ovladače proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu zadávání parametrů nové definice ovladače ke kliknutí na název již vytvořené definice ovladače nebo k přechodu do jiné sekce, nebude nově vytvářená definice ovladače založena a její údaje budou ztraceny. Po založení definice ovladače se tato zobrazí v seznamu dostupných definic ovladačů. lookdet_a_g_cz_106 24/153
3.3.2 Editace stávající definice ovladače Editaci definice ovladače lze provést v editačním panelu po kliknutí na požadovanou definici ovladače v seznamu. Význam jednotlivých položek je stejný jako při zakládání nové definice ovladače (viz kapitola 3.2.1 Založení nové lokality ). Obr. 24 Editace ovladače 1 Vybraná definice ovladače v lokalitě 2 Údaje vybrané definice ovladače 3 Tlačítko pro uložení změn Potvrzení provedených změn v definici ovladače proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu úpravy parametrů stávající definice ovladače ke kliknutí na název již vytvořené definice nebo k přechodu do jiné sekce, nebudou provedené změny uloženy a dojde k jejich ztrátě. Po najetí kurzoru myši na již vytvořenou definici ovladače, je nabízeno tlačítko, které umožňuje vymazání stávající definice ovladače. 25/153 lookdet_a_g_cz_106
Obr. 25 Zobrazení tlačítka pro vymazání definice ovladače 1 Zvýraznění definice ovladače najetím kurzoru myši 2 Tlačítko pro smazání definice ovladače 3 Nezvýrazněná definice ovladače 3.3.3 Vymazání definice stávajícího ovladače Vymazání definice stávajícího ovladače lze provést pomocí tlačítka se symbolem popelnice, který se zobrazí u názvu definice ovladače v případě, kdy je kurzor myši umístěn na název definice ovladače v seznamu. Po jeho stisku dojde k otevření okna pro vymazání definice ovladače. Obr. 26 Okno pro vymazání definice ovladače 1 Tlačítko pro potvrzení vymazání definice ovladače a zavření okna 2 Tlačítka pro zavření okna bez vymazání definice ovladače Potvrzením vymazání definice ovladače dojde k zobrazení upozornění o nenávratném vymazání ovladače. lookdet_a_g_cz_106 26/153
Obr. 27 Okno s potvrzením nenávratného vymazání 1 Tlačítka pro zavření okna bez vymazání definice ovladače 2 Tlačítko pro potvrzení nenávratného vymazání definice ovladače a zavření okna Druhým potvrzením vymazání dojde nenávratnému vymazání definice ovladače. Vymazání definice ovladače je tedy nutné dvakrát potvrdit. Veškerá data a kanály přiřazené k definici ovladače budou nenávratně vymazány. 3.3.4 Systémové ovladače Kromě dynamicky definovaných ovladačů (ovladače typu: AMiT naslouchání na portu xxx ) obsahuje systém vždy také ovladače systémové. Tyto ovladače není možné nijak parametrizovat, pouze aktivovat / deaktivovat. Aktivaci / deaktivaci může v sekci pro správu ovladačů provádět pouze globální administrátor, který je v dané sekci vidí v seznamu Systémové ovladače. Administrátor lokality nemá seznam systémových ovladačů zobrazen. Obr. 28 Seznam systémových ovladačů 27/153 lookdet_a_g_cz_106
3.4 Správa stanic Dostupné systémové ovladače: Cyklické čtení AMiT slouží ke čtení dat z řídicích systémů AMiT, které aktivně nezapisují data do serveru. Měřiče tepla MBus získává data z měřičů tepla za převodníkem DM-MB2ET (DM-DI4MB2ET) z produkce firmy AMiT (viz DODATEK C). Modbus master TCP získává data ze zařízení MODBUS protokolem TCP (viz DODATEK D). Poruchové stavy zajišťuje hlášení poruch a jejich šíření na připojená zařízení. Provozní deník AMiT zajišťuje možnost čtení aplikačních provozních deníků z produktů firmy AMiT. Sekundový periodický spouštěč CRON zajišťuje řízení cyklických operací (nevhodná administrace operačního sytému může tuto část deaktivovat systém LookDet vyžaduje pro svou funkčnost, aby byl tento ovladač vždy spuštěn!). Stanice je: Periferie, která poskytuje systému LookDet data: řídicí systém z produkce firmy AMiT, regulátor typu AMREG s ethernetovým rozhraním, převodník DM-MB2ET (DM-DI4MB2ET) z produkce firmy AMiT, periferie komunikující pomocí Modbus/TCP (pouze slave/server), periferie komunikující pomocí HTTP POST. Samotný Lookdet specifický typ stanice s omezenými možnostmi a bez komunikačních parametrů. Slouží pro práci s lokálními kanály, které je možno zpracovávat v náhledech systému LookDet nebo do kterých lze zapisovat z připojených periferií. Čtení lokálních kanálů systému LookDet z připojených periferií není možné. Počet stanic je dán počtem zakoupených rozšíření licence (mimo stanice typu LookDet). V případě použití převodníku Ethernet na M-Bus se licence nevztahuje na počet převodníků, ale na počet zařízení, připojených k převodníku (tzv. počet cyklických čtení viz níže). Počtem zakoupených rozšíření licence je tedy (u komunikace M-Bus) dán počet cyklických čtení. Pro správu stanic slouží sekce Stanice, kde je možné: definovat nové stanice, editovat stávající stanice, definovat tzv. cyklické čtení (viz dále), definovat poruchy, definovat provozní deník (v případě použití řídicích systémů AMiT), definovat čtení zpětných archívů ze stanic po výpadku (v případě použití řídicích systémů AMiT), exportovat parametry již nadefinovaných stanic, importovat parametry exportovaných stanic, mazat stávající stanice. lookdet_a_g_cz_106 28/153
Obr. 29 Panel se správou stanic a poruch 1 Seznam nadefinovaných stanic v lokalitě 2 Tlačítko pro přidání nové stanice 3 Tlačítka pro import / export stanic Význam jednotlivých položek v řádcích se seznamem stanic, je patrný z následujícího obrázku. Obr. 30 Význam položek jednoho řádku seznamu stanic 1 Logo typu stanice 2 Popis stanice 3 IP adresa stanice 4 Číslo portu stanice 3.4.1 Založení nové stanice Založení nové stanice lze provést stiskem tlačítka + v nástrojové liště sekce Stanice. V editačním panelu dojde k zobrazení parametrů, nutných pro založení nové stanice. 29/153 lookdet_a_g_cz_106
Obr. 31 Zobrazení údajů pro nově zakládanou stanici 1 Údaje nové stanice 2 Tlačítko pro potvrzení vytvoření nové stanice Údaje stanice: Česky český popis stanice (povinný), který se zobrazuje v seznamu stanic. Je následovaný případnými lokalizovanými názvy (nepovinné). Počet názvů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Typ stanice určuje způsob připojení stanice. Ze seznamu je třeba vybrat odpovídající způsob. Adresa stanice IP adresa stanice (v číselném či jmenném formátu), nebo jeho identifikace v případě využívání dynamických IP adres u produktů firmy AMiT. Na tuto adresu se snaží připojit komunikační jádro v případě požadavku na změnu parametrů, nebo systém cyklického čtení. Poznámka V případě použití dynamických IP adres u produktů firmy AMiT lze pro zadání adresy využít tlačítko (lupa), které vyvolá dialog se seznamem textových identifikátorů, zasílaných do systému LookDet (viz Obr. 22). Číslo stanice číslo vzdálené stanice, na které je směrována odchozí komunikace (zápis parametrů, cyklické čtení). lookdet_a_g_cz_106 30/153
Číslo portu číslo portu vzdálené stanice, na který je směrována odchozí komunikace (implicitně 59, možný rozsah 0 až 65535). U dynamických IP je parametr ignorován. Timeout komunikace parametr určující maximální dobu (v ms) pro odpověď stanice komunikačnímu jádru. Heslo stanice heslo vzdálené stanice (výchozí hodnota je 0). Offline po [sec] kontrola dostupnosti stanice. Maximální interval mezi zápisy určeného kanálu do hlášení poruchy nekomunikuje viz definice poruch. Aktivní stanice aktivace / deaktivace komunikace se stanicí. Pokud je komunikace se stanicí neaktivní, nejsou hlášeny její poruchy (např. rozpad komunikace). Deaktivaci komunikace lze tedy s výhodou využít v případech, kdy na stanici probíhá servis a je odpojena od komunikační sítě. Synchronizovat čas aktivace / deaktivace synchronizace času. Pokud je volba aktivní, bude se čas ve stanici synchronizovat se systémem LookDet. Pokud volba aktivní není, systém LookDet synchronizaci času provádět nebude. Časové pásmo výběr časového pásma, dle kterého se bude provádět synchronizace času. Provozní deník počet buněk matice aplikačního provozního deníku ve stanici. Po vložení hodnoty do editačního pole se za ním v závorce zobrazí počet uživatelsky využitelných hlášení. Poznámka Výše uvedený seznam parametrů se zobrazuje v případě zvoleného typu stanice AMiT. V případě volby jiného typu stanice se může počet položek lišit. Parametrizaci jiného typu stanice řeší dodatky v závěru tohoto dokumentu. Založení nové stanice proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu zadávání parametrů nové stanice ke kliknutí na název již vytvořené stanice nebo k přechodu do jiné sekce, nebude nově vytvářená stanice založena a její údaje budou ztraceny. 3.4.2 Editace stávající stanice Editaci stávající stanice lze provést v editačním panelu, po kliknutí na požadovanou stanici v seznamu stanic. Význam jednotlivých položek je stejný jako při zakládání nové stanice (viz kapitola 3.4.1 Založení nové stanice ). 31/153 lookdet_a_g_cz_106
Obr. 32 Editace stanice 1 Vybraná stanice 2 Údaje vybrané stanice Potvrzení provedených změn ve stanici proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu úpravy parametrů stávající stanice ke kliknutí na název jiné stanice nebo k přechodu do jiné sekce, nebudou provedené změny uloženy a dojde k jejich ztrátě. Tlačítka, která jsou nabízena po najetí kurzoru myši na již vytvořenou stanici, umožňují: diagnostiku spojení, definici cyklického čtení, definici poruch, import textů provozního deníku pro jednotlivé lokalizace, definici zpětného čtení archívů po výpadku, smazání stávající stanice. lookdet_a_g_cz_106 32/153
Obr. 33 Možnosti stanice 1 Zvýraznění stanice najetím kurzoru myši 2 Nezvýrazněná stanice 3 Tlačítka pro další parametrizaci stanice Význam tlačítek pro nastavení dalších možností stanice je patrný z následující tabulky. Tlačítko Význam Diagnostika spojení Definice cyklického čtení Definice poruch Import textů provozního deníku Definice zpětného čtení archívu Smazání stávající stanice Diagnostika spojení Diagnostika spojení umožňuje ověření, že dispečerský systém dokáže navázat spojení s nadefinovanou stanicí. Po kliknutí na tlačítko Diagnostika spojení dojde k otevření dialogového okna, kde lze nalézt informace o: Výsledku příkazu ping na zadanou stanici. IP adrese stanice, na které komunikuje. Čas stanice (pouze u řídicí systémy firmy AMiT). 33/153 lookdet_a_g_cz_106
Obr. 34 Okno diagnostiky spojení Po přihlášení globálního administrátora je v dialogovém okně k dispozici také tlačítko TCPdump, které přesměruje administrátora do sekce Systém, kde bude automaticky spuštěn TCPdump pro danou stanici (viz kapitola 3.10 Správa systému ). Definice cyklického čtení Pokud není možné, aby připojená periferie aktivně zapisovala data do serveru, na kterém běží systém LookDet (blokování firewallem, cizí stanice apod.), lze nadefinovat seznam kanálů (viz kapitola 3.5 Správa kanálů ), které budou vyčítány z připojené periferie v nastaveném intervalu. Cyklické čtení se typicky používá při použití protokolů Modbus/TCP či M- Bus TCP (UDP). Počet kanálů cyklického čtené je omezen pouze velikostí databáze na serveru. Cyklické čtení je nutné využít v případě připojení zařízení, které neumožňují komunikaci protokolem DB-Net/IP. V případě použití zařízení, které komunikují protokolem DB-Net/IP se tento způsob komunikace využívá spíše jako nouzové řešení, protože je pomalejší a značně náročnější na vizualizační server, než přímý zápis řídicím systémem do komunikačního jádra. Další nevýhoda cyklického čtení se projeví při výpadku komunikace jedné ze stanic lokality, což má za následek prodlužování nastaveného intervalu čtení ostatních stanic, i přesto, že se komunikační jádro snaží tento interval v maximální míře dodržovat. Zpoždění se samozřejmě týká pouze cyklického čtení, nemá žádný vliv na přímý zápis řídicími systémy. lookdet_a_g_cz_106 34/153
Po kliknutí na druhé tlačítko z nabídky stanice je zobrazen aktuální seznam kanálů cyklického čtení vybrané stanice. Pokud není žádný kanál vytvořen, je panel prázdný. Obr. 35 Prázdný seznam cyklicky čtených kanálů 1 Tlačítko pro přidání cyklicky čteného kanálu 2 Tlačítko pro import seznamu cyklicky čtených kanálů z CSV souboru 3 Tlačítko pro export cyklicky čtených kanálů do CSV souboru Pozor Cyklické čtení nelze využít u stanic firmy AMiT, které mají dynamickou IP adresu! Pro vytvoření nového kanálu cyklického čtení slouží tlačítko Přidat ve spodní části seznamu. Po kliknutí na tlačítko dojde k zobrazení okna s potřebnými údaji, pro založení cyklicky vyčítaného kanálu. Okno má různý vzhled v závislosti na typu ovladače, který je pro cyklické čtení využíván. 35/153 lookdet_a_g_cz_106
Obr. 36 Založení cyklicky čteného kanálu pro ovladač typu AMiT 1 Údaje nového cyklického čtení 2 Tlačítko pro uložení nově definovaného cyklického čtení a zavření okna 3 Tlačítko pro zavření okna bez uložení nově definovaného cyklic. čtení Cyklicky čtený kanál, v případě typu stanice AMiT (ostatní typy stanice jsou řešeny v rámci dodatků), má následující parametry: Popis kanálu uživatelský popis kanálu. Číslo kanálu WID proměnné, která je cyklicky čtena ze vzdálené stanice. Typ kanálu typ proměnné, která je cyklicky čtena ze vzdálené stanice. Kanál na serveru číslo kanálu, ve kterém bude na serveru dostupná hodnota proměnné. Interval čtení [sec] perioda čtení vzdálené proměnné (lze zadat 5 s a výše). Příští čtení nastavení času, kdy se mají začít číst data. Čtení aktivní aktivace / deaktivace cyklického čtení vzdálené proměnné. Údaje, zadané cyklicky vyčítanému kanálu, je nutné uložit pomocí tlačítka Uložit. Kanály, které jsou v seznamu kanálů cyklického čtení zvýrazněny, mají cyklické čtení neaktivní, ostatní kanály mají cyklické čtení aktivní. lookdet_a_g_cz_106 36/153
Obr. 37 Seznam cyklicky čtených kanálů 1 Kanál s aktivním cyklickým čtením 2 Kanál s neaktivním cyklickým čtením Pro editaci již nadefinovaného cyklicky čteného kanálu slouží panel, který se zobrazí po kliknutí na požadovaný kanál nebo po kliknutí na tlačítko se symbolem tužka, které se zobrazí po najetí kurzorem myši na požadovaný kanál v pravé části řádku. Panel je totožný s panelem pro definici nového cyklicky čteného kanálu. Pro vymazání kanálu cyklického čtení slouží tlačítko se symbolem popelnice, které se zobrazí po najetí kurzorem myši na požadovaný kanál v pravé části řádku. Obr. 38 Tlačítka cyklického čtení 1 Tlačítko pro editaci kanálu cyklického čtení 2 Tlačítko pro smazání kanálu cyklického čtení Pozor Cyklické čtení pro řídicí systémy firmy AMiT bude prováděno pouze tehdy, pokud bude aktivní systémový ovladač, určený pro cyklické čtení dat ze systémů firmy AMiT (dostupný globálnímu administrátorovi ve správci ovladačů pod jménem Cyklické čtení AMiT ). 37/153 lookdet_a_g_cz_106
Pomocí tlačítek Import a Export v okně Seznam cyklicky čtených kanálů lze provádět hromadnou úpravu cyklicky čtených kanálů. Import a export využívá data ve formátu CSV (textový soubor, sloupce odděleny středníkem). Pro hromadnou úpravu je doporučen následující postup: provést export, upravit získaný soubor, provést import. Výše uvedeným postupem se předejde případným problémům s formátem dat, který systém kontroluje. Import neplatného souboru systém neprovede. Pozor Import zruší veškeré aktuálně definované čtení vybrané stanice a nahradí jej importovaným souborem! Definice poruch Pro definici poruch, o kterých má být uživatel informován, slouží druhé tlačítko z nabídky stanice, které vyvolá seznam již nadefinovaných poruch, aktuálně zvolené stanice. Obr. 39 Seznam nadefinovaných poruch 1 Seznam nadefinovaných poruch 2 Tlačítko pro definici nové poruchy Pro definici nové poruchy slouží tlačítko Nová porucha ve spodní části seznamu. Po kliknutí na tlačítko dojde k zobrazení okna s potřebnými údaji, pro definici nové poruchy. lookdet_a_g_cz_106 38/153
Počet poruch je omezen pouze velikostí databáze na serveru. Pro editaci již nadefinované definice poruchy slouží panel, který se zobrazí po kliknutí na požadovaný kanál nebo po kliknutí na tlačítko se symbolem tužka, které se zobrazí po najetí kurzorem myši na požadovanou definici poruchy v pravé části řádku. Panel je totožný s panelem pro definici nové poruchy. Pro vymazání definice poruchy slouží tlačítko se symbolem popelnice, které se zobrazí po najetí kurzorem myši na požadovanou definici poruchy v pravé části řádku. Obr. 40 Tlačítka cyklického čtení 1 Tlačítko pro editaci definice poruchy 2 Tlačítko pro smazání definice poruchy Po stisku tlačítka dojde k úplnému vymazání zvolené poruchy z databáze (archívu) a nebude tedy možné dohledat, zda ke zvolené poruše v minulosti došlo. V závislosti na četnosti výskytu zvolené poruchy v databázi (v historii poruch) může operace mazání trvat delší dobu. Pozor Kontrola poruch bude prováděna pouze tehdy, pokud bude aktivní systémový ovladač, určený pro poruchy (dostupný globálnímu administrátorovi ve správci ovladačů pod jménem Poruchové stavy ). Pomocí tlačítek Import a Export lze provádět hromadnou úpravu poruch. Import a export využívá data ve formátu CSV (textový soubor, sloupce odděleny středníkem). Pro hromadnou úpravu je doporučen následující postup: provést export, upravit získaný soubor, provést import. Výše uvedeným postupem se předejde případným problémům s formátem dat, který systém kontroluje. Import neplatného souboru systém neprovede. Pozor Import zruší veškeré aktuálně definované poruchy vybrané stanice a nahradí jej importovaným souborem! Pokud byla importem některá porucha, vázaná na stanici, odstraněna, zůstane zachována v historii poruch (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). 39/153 lookdet_a_g_cz_106
Systém aktuálně rozlišuje 2 základní druhy poruch: Standardní porucha (rozlišuje analogovou a binární poruchu) Binární porucha vyhodnocení stavu jednoho bitu. V seznamu nadefinovaných poruch je zobrazena s ikonou. Analogová porucha porovnání analogového stavu se zadanou mezí v nastavené hysterezi. V seznamu nadefinovaných poruch je zobrazena s ikonou. Výpadek komunikace (zkosené písmo) systém porovnává čas poslední změny zadaného kanálu se zadaným intervalem, v případě překročení limitu je hlášena porucha stanice nekomunikuje. V seznamu nadefinovaných poruch je zobrazena s ikonou. BINÁRNÍ PORUCHA Obr. 41 Definice nové binární poruchy 1 Údaje nové binární poruchy 2 Tlačítko pro uložení nově definované poruchy a zavření okna 3 Tlačítko pro zavření okna bez uložení nově definované poruchy Údaje binární poruchy: Typ poruchy volba mezi standardní poruchou a poruchou komunikace. Změna typu poruchy automaticky mění parametry požadované dialogem. Pro binární poruchu je nutné nastavit typ Standardní porucha. Česky český (povinný) popis a lokalizace popisu poruchy (nepovinné) viz kapitola 3.2.1 Založení nové lokality. Popis se zobrazí v seznamu poruch. lookdet_a_g_cz_106 40/153
Kanál poruchy číslo kanálu v databázi systému, který bude vyhodnocován. Řádek poruchy řádek v datech v databázi systému. Sloupec poruchy sloupec v datech v databázi systému. Binární porucha rozhoduje, zda se jedná o vyhodnocení bitu (binární porucha), nebo porovnání hodnot (analogová porucha), změna se okamžitě projeví na vzhledu formuláře. Další popis řeší případ nastavení parametru Binární porucha na zatrženo. Aktivní stav (1/0) porucha je hlášena, pokud se testovaný bit rovná této hodnotě (1/0). Vyhodnocený bit číslo bitu (ne váha), který je vyhodnocován (0 až 15 pro typ INT, 0 až 31 pro typ LONG). Začátek platnosti čas, od kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Konec platnosti čas, do kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Zpoždění hlášení zpoždění hlášení o vzniku poruchy. Poznámka Čas začátku a konce platnosti není nutné zadávat. Pokud nejsou časy zadány, je porucha vyhodnocována stále. ANALOGOVÁ PORUCHA Obr. 42 Definice nové analogové poruchy 1 Údaje nové analogové poruchy 2 Tlačítko pro uložení nově definované poruchy a zavření okna 3 Tlačítko pro zavření okna bez uložení nově definované poruchy 41/153 lookdet_a_g_cz_106
Údaje analogové poruchy: Typ poruchy volba mezi standardní poruchou a poruchou komunikace. Změna typu poruchy automaticky mění parametry požadované dialogem. Pro analogovou poruchu je nutné nastavit typ Standardní porucha. Česky český (povinný) popis a lokalizace popisu poruchy (nepovinné) viz kapitola 3.2.1 Založení nové lokality. Popis se zobrazí v seznamu poruch. Kanál poruchy číslo kanálu v databázi systému, který bude vyhodnocován. Řádek poruchy řádek v datech v databázi systému. Sloupec poruchy sloupec v datech v databázi systému. Binární porucha rozhoduje, zda se jedná o vyhodnocení bitu (binární porucha), nebo porovnání hodnot (analogová porucha), změna se okamžitě projeví na vzhledu formuláře. Další popis řeší případ nastavení parametru Binární porucha na nezatrženo. Minimální hranice minimální hranice analogové hodnoty pro vznik poruchy. Maximální hranice maximální hranice analogové hodnoty pro vznik poruchy. Dolní hystereze hystereze spodní hranice poruchy pro její ukončení / opakovaný vznik. Horní hystereze hystereze horní hranice poruchy pro její ukončení / opakovaný vznik. Začátek platnosti čas, od kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Konec platnosti čas, do kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Zpoždění hlášení [sec] zpoždění hlášení o vzniku poruchy. Poznámka Příklad parametrizace Čas začátku a konce platnosti není nutné zadávat. Pokud nejsou časy zadány, je porucha vyhodnocována stále. Po zadání následujících parametrů: Minimální hranice 10, Maximální hranice 50, Dolní hystereze 2, Horní hystereze 2, se porucha bude hlásit poté, co hodnota proměnné klesne pod 10 tak dlouho, dokud nepřekročí hodnotu 12 a poté, co bude hodnota proměnné větší jak 50 a neklesne pod hodnotu 48. lookdet_a_g_cz_106 42/153
PORUCHA VÝPADKU KOMUNIKACE Obr. 43 Definice nové poruchy komunikace 1 Údaje nové poruchy rozpadu komunikace 2 Tlačítko pro uložení nově definované poruchy a zavření okna 3 Tlačítko pro zavření okna bez uložení nově definované poruchy Údaje poruchy výpadku komunikace: Typ poruchy volba mezi standardní poruchou a poruchou komunikace. Změna typu poruchy automaticky mění parametry požadované dialogem. Pro poruchu výpadku komunikace je nutné nastavit typ Stav komunikace. Česky český (povinný) popis a lokalizace popisu poruchy (nepovinné) viz kapitola 3.2.1 Založení nové lokality. Popis se zobrazí v seznamu poruch. Kanál poruchy číslo kanálu v databázi systému, podle kterého bude vyhodnocován výpadek komunikace, automaticky se uvažuje řádek i sloupec 0. Začátek platnosti čas, od kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Konec platnosti čas, do kterého je porucha vyhodnocována (ve formátu hh:mm:ss). Zpoždění hlášení [sec] zpoždění hlášení o vzniku poruchy. Poznámka Čas začátku a konce platnosti není nutné zadávat. Pokud nejsou časy zadány, je porucha vyhodnocována stále. Import textů provozního deníku Při komunikaci s produkty firmy AMiT umožňuje LookDet vyčítání jejich aplikačních provozních deníků (pokud tuto funkčnost podporují). Jedním z nutných kroků pro správnou definici aplikačních provozních deníků na straně systému LookDet je import textů. 43/153 lookdet_a_g_cz_106
Pro import textů provozního deníku slouží čtvrté tlačítko z nabídky stanice, které zobrazí panel pro správu importovaných CSV souborů (textový soubor, sloupce odděleny středníkem) pro aktuálně zvolenou stanici. Obr. 44 Panel správy provozního deníku Pomocí tlačítka Import lze do systému LookDet importovat CSV soubory, které vzniknou exportem z prostředí DetStudio, uložené v kódování UTF-8. Zároveň je nutné vybrat, pro jakou lokalizaci jsou texty určeny. Každé jazykové mutaci tedy odpovídá jeden CSV soubor. Obr. 45 Okno pro import lokalizace provozního deníku 1 Pole pro výběr CSV souboru exportovaného z prostředí DetStudio 2 Výběr lokalizace, pro kterou je importovaný CSV soubor určen (nabízí se pouze aktivní lokalizace dané lokality) 3 Tlačítko pro potvrzení importu a zavření okna 4 Tlačítko pro zavření okna bez provedení importu V panelu pro správu provozních deníků se importované soubory zobrazují pod názvem lokalizace, která byla při importu vybrána. lookdet_a_g_cz_106 44/153
Obr. 46 Panel správy provozního deníku s importovanými CSV 1 Seznam importovaných lokalizací provozního deníku 2 Tlačítko pro import další lokalizace provozního deníku 3 Tlačítko pro export vybrané lokalizace provozního deníku 4 Tlačítko pro odstranění lokalizace provozního deníku Pozor Provozní deník bude vyčítán pouze tehdy, pokud bude aktivní systémový ovladač, určený pro čtení aplikačních provozních deníků, ze systémů firmy AMiT (dostupný globálnímu administrátorovi ve správci ovladačů pod jménem Provozní deník AMiT ). Definice zpětného čtení archívů Při komunikaci s produkty firmy AMiT umožňuje LookDet (po rozpadu a obnovení komunikace se stanicí) doplnění historických dat konkrétního kanálu (viz kapitola 3.5 Správa kanálů ). Při použití této funkčnosti je tedy zaručeno, že i v případě rozpadu komunikace se stanicí bude mít systém LookDet, do určité doby po obnovení komunikace, k dispozici také historická data, z doby výpadku komunikace. Aby bylo možné tuto funkcionalitu využít, musí: být na straně stanice naprogramovány tzv. zpětné archívy, stanice aktivně zasílat sytému LookDet hodnotu tzv. indexu archívu, být u příslušné stanice nadefinována porucha Rozpad komunikace (viz kapitola Definice poruch ), být porucha Rozpad komunikace vyhodnocována pomocí kanálu, který obsahuje index archívu, archivace v řídicím systému probíhat minimálně se stejnou periodou, jako je nastavena minimální perioda archivace u příslušného kanálu (viz kapitola 3.5.2 Nastavení / editace parametrů kanálu ). Zpětné archívy jsou ve stanici definovány pomocí: matice časů (ML) obsahuje časy (v tzv. formátu DB-Net) kdy došlo k archivaci, matice hodnot obsahuje hodnoty, které byly v daném čase archivovány, indexu archívu určuje index v matici hodnot a časů, kam bude zapsán další vzorek. Bližší informace o parametrizaci archívů v řídicích systémech firmy AMiT lze nalézt v nápovědě k prostředí DetStudio. 45/153 lookdet_a_g_cz_106
Pro definici zpětného čtení archívů slouží čtvrté tlačítko z nabídky stanice, které vyvolá panel správce archívů, definovaných ve vybrané stanici. Obr. 47 Panel pro správu archívů Pomocí tlačítka Nový archiv lze ve správci archívů nadefinovat archív, který je v produktech firmy AMiT a který bude využíván v případě rozpadu komunikace. Obr. 48 Definice nového archívu 1 Parametry archívu 2 Tlačítko pro uložení zadaných parametrů lookdet_a_g_cz_106 46/153
Parametry archívu: Popis archívu textový popis archívu, který se bude zobrazovat v seznamu archívů. Kanál indexu archívu kanál (viz kapitola 3.5 Správa kanálů ), do kterého řídicí systém zasílá hodnotu indexu archívu lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek indexu v kanálu řádek kanálu, na kterém je index archívu k dispozici, pokud je hodnota indexu zasílána v matici. V případě, že je kanál skalární hodnota, je nutné zadat hodnotu 0. Sloupec indexu v kanálu sloupec kanálu, na kterém je index archívu k dispozici, pokud je hodnota indexu zasílána v matici. V případě, že je kanál skalární hodnota, je nutné zadat hodnotu 0. WID časů archívu WID matice časů v řídicím systému. WID hodnot archívu WID matice hodnot v řídicím systému. Typ hodnot archívu typ matice hodnot, ve které jsou v řídicím systému uložena archivní data. Hloubka archívu v ŘS počet sloupců archivní matice v ŘS. Pro vytvoření archívu se zadanými parametry je nutné vše potvrdit tlačítkem Uložit. Uložením archívu dojde k jeho zobrazení v podobě položky seznamu v levé části panelu. Obr. 49 Panel správce archívů s jedním nadefinovaným archívem 1 Archív v seznamu archívů 2 Editační panel Po vytvoření archívu je nutné jeho jednotlivé řádky přiřadit ke konkrétním kanálům, pro které se budou archivní hodnoty doplňovat po výpadku komunikace. Toto lze učinit pomocí tlačítka Nový záznam v editačním panelu (po vybrání již nadefinovaného archívu v seznamu). 47/153 lookdet_a_g_cz_106
Obr. 50 Editace archívu 1 Vybraný archív 2 Parametry vybraného archívu 3 Tlačítko pro přiřazení kanálu zvolenému řádku archivní matice Po kliknutí na tlačítko Nový záznam lze nadefinovat kanál, ke kterému bude řádek archívu přiřazen. lookdet_a_g_cz_106 48/153
Obr. 51 Přiřazení řádku archívu konkrétnímu kanálu 1 Parametry pro přiřazení archívu ke kanálu 2 Tlačítko pro uložení parametrů a zavření okna 3 Tlačítko pro zavření okna bez uložení Parametry pro přiřazení archívu: Index řádku v ŘS Index řádku v archivní matici řídicího systému, kde jsou uložena historická data pro vybranou hodnotu kanálu kanál. Kanál kanál (viz kapitola 3.5 Správa kanálů ) systému LookDet, kterému se budou z odpovídajícího řádku archívu v řídicím systému doplňovat data v případě rozpadu komunikace. Kanál lze zadat manuálně nebo lze vybrat ze seznamu dostupných kanálů v lokalitě kliknutím na ikonu (Lupa). Řádek řádek kanálu zvoleného v poli kanál. Sloupec sloupec kanálu zvoleného v poli kanál. Po uložení nadefinovaných parametrů bude pro každou přiřazenou hodnotu kanálu k řádku archívu zobrazena v sekci Položky archívu z ŘS jedna položka seznamu. 49/153 lookdet_a_g_cz_106
Obr. 52 Definice archívu včetně přiřazení hodnoty kanálu 1 Vybraný archív 2 Přiřazení archívu ke kanálu Význam informací, uvedených u jedné položky seznamu, v sekci Položky archívu z ŘS je patrný z následujícího obrázku. Obr. 53 Položka seznamu s přiřazením archívu k hodnotě kanálu 1 Popis archívu (generuje se automaticky z názvu přiřazené hodnoty kanálu) 2 Index řádku archívu v řídicím systému 3 Číslo kanálu, ke kterému je řádek archívu přiřazen 4 Řádek a sloupec kanálu, ke kterému je přiřazen archív 5 Tlačítko pro vymazání přiřazení řádku archívu ke kanálu lookdet_a_g_cz_106 50/153
3.4.3 Vymazání stávající stanice 3.5 Správa kanálů Vymazání stanice lze provést pomocí tlačítka se symbolem popelnice (páté tlačítko z nabídky stanice), které se zobrazí u názvu stanice v případě, kdy je kurzor myši umístěn na název stanice v seznamu stanic. K vymazání stanice dojde až po potvrzení dvou dialogů, stejně jako u vymazání ovladače (viz kapitola 3.3.3 Vymazání definice stávajícího ovladače ). Pozor při vymazání stanice dojde také k vymazání všech příslušných kanálů (viz kapitola 3.5 Správa kanálů ) a je nevratné. Prostřednictvím kanálů umožňuje systém LookDet práci s daty, která jsou systémem cyklicky čtena nebo jsou zasílána připojenými stanicemi. Každá samostatná proměnná / matice, zaslaná připojenou stanicí do systému LookDet, může vytvořit jeden kanál, nebo může být součástí již vytvořeného kanálu (v případě, kdy připojená stanice zapisuje do stejného WIDu kanálu, pouze s jiným číslem řádku / sloupce). Kanál si tedy lze představit jako skalární hodnotu nebo jako pole hodnot. Pro správu kanálů slouží sekce Kanály, kde je možné: manuálně vytvářet kanály, přiřazovat kanály k nadefinovaným stanicím, pojmenovat jednotlivé položky (hodnoty) kanálů, manuálně upravit hodnoty jednotlivých položek kanálů, nastavení ukládání hodnot kanálů do archívů, přiřazení hodnoty kanálu k provoznímu deníku (použitelné u systémů AMiT) import parametrů kanálu, export parametrů kanálu, smazání nepoužívaných kanálů. 51/153 lookdet_a_g_cz_106
Po výběru sekce Kanály bude levá část obsahovat seznam skupin kanálů lokality. Seznam obsahuje skupinu NEPŘIŘAZENA!, kde jsou kanály, které zatím nebyly administrátorem přiřazeny k žádné stanici. Obr. 54 Správa kanálů s nepřiřazenými kanály 1 Seznam kanálů v lokalitě (komunikovaných / manuálně vytvořených) 2 Tlačítko pro manuální přidání kanálu Zobrazeny jsou pouze kanály, které: byly úspěšně zaslány řídicím systémem do systému LookDet, byly úspěšně načteny systémem LookDet pomocí tzv. cyklického čtení (kanály jsou automaticky přiřazeny stanici, u které byly nadefinovány), byly manuálně nadefinovány. Kanály (proměnné), které řídicí systém na server nezaslal, nebo nebyly načteny cyklickým čtením, nebudou v seznamu zobrazeny (toto neplatí pro manuálně vytvořené kanály přiřazené stanici typu LookDet). Kanály, které již byly přiřazeny ke konkrétní stanici, jsou uvedeny ve skupině s názvem odpovídající stanice. Skupiny s názvem stanic jsou vypsány za skupinou NEPŘIŘAZENA!. lookdet_a_g_cz_106 52/153
Obr. 55 Kanály s nepřiřazenou a s přiřazenou stanicí 1 Kanály s nepřiřazenou stanicí 2 Kanály s přiřazenou stanicí s názvem ADOREG Význam jednotlivých položek v řádcích se seznamem kanálů, je patrný z následujícího obrázku. Obr. 56 Význam položek jednoho řádku seznamu kanálů 1 Číslo kanálu 2 Rozměr kanálu počáteční řádek:sloupec-koncový řádek:sloupec (zobrazí se v případě, kdy je kanál typu matice) 3 Druh kanálu (AMiT, Modbus, M-BUS, ) 4 Přiřazená stanice 53/153 lookdet_a_g_cz_106
Tlačítka, která jsou nabízena po najetí kurzoru myši na již vytvořený kanál, umožňují: export parametrů kanálu, import parametrů kanálu, smazání kanálu. Obr. 57 Tlačítka kanálu 1 Zvýraznění kanálu najetím kurzoru myši 2 Nezvýrazněný kanál 3 Tlačítka pro další práci s kanálem Význam tlačítek pro úpravu kanálů je patrný z následující tabulky. Tlačítko Význam Export nastavených parametrů kanálu do CSV souboru Import nastavených parametrů kanálu z CSV souboru Vymazání kanálu Pro rozvinutí všech skupin (stanic) a zobrazení seznamu kanálů, které jsou do nich přiřazeny, slouží dvě tlačítka nad seznamem nadefinovaných skupin (stanic). lookdet_a_g_cz_106 54/153
Obr. 58 pozice tlačítek pro zobrazení seznamu kanálů 1 Tlačítka pro zobrazení seznamu kanálů Význam tlačítek pro zobrazení seznamu kanálů je patrný z následující tabulky. Tlačítko Význam Rozvinutí všech skupin, zobrazených v seznamu kanálů Sbalení všech skupin, zobrazených v seznamu kanálů 3.5.1 Přiřazení kanálů ke stanici Po výběru jednoho, nebo více kanálů (výběr je možný podržením klávesy Ctrl a klikáním levým tlačítkem myši na vybrané položky) lze v editačním panelu přiřadit odpovídající stanici výběrem ze seznamu. Přiřazení vybraných kanálů proběhne okamžitě po výběru stanice (kanály již nebudou zobrazeny ve skupině nepřiřazených). 55/153 lookdet_a_g_cz_106
Obr. 59 Přiřazení vybraných kanálů ke stanici 1 Vybrané kanály 2 Pole pro výběr stanice pro přiřazení 3.5.2 Nastavení / editace parametrů kanálu Nastavení / editaci parametrů kanálu lze učinit v editačním panelu po kliknutí na požadovaný kanál (který je přiřazen ke stanici) v seznamu kanálů. V editačním panelu je po výběru kanálu možné: změnit / nastavit přiřazení kanálu ke stanici, zobrazit detailní popis všech hodnot v kanálu, nastavit / editovat parametry všech hodnot v kanálu. lookdet_a_g_cz_106 56/153
Obr. 60 Zobrazení seznamu hodnot kanálu 1 Vybraný kanál 2 Seznam hodnot kanálu s detailním popisem Význam jednotlivých položek v řádcích seznamu hodnot kanálu, je patrný z následujícího obrázku. Obr. 61 Význam položek jednoho řádku v seznamu hodnot kanálu 1 Číslo kanálu řádek sloupec 2 Čas poslední komunikace hodnoty 3 Aktuální hodnota 4 Popis hodnoty 5 Informace pro případné ukládání hodnoty do archívu / provozního deníku Kliknutím na řádek v seznamu hodnot kanálu lze upravit popis zvolené hodnoty a další parametry jako je nastavení ukládání historických dat apod. 57/153 lookdet_a_g_cz_106
Obr. 62 Parametrizace kanálu Parametry kanálu: Popis kanálu textový popis hodnoty. Původní hodnota aktuální hodnota (zapsaná např. připojenou stanicí) kanálu v systému LookDet. Hodnota požadovaná hodnota nastavená ze strany systému LookDet a upravená pomocí přepočetních konstant Násobitel kanálu a Plus (viz níže). Index PD AMiT volba, zda je hodnota v řídicím systému firmy AMiT nadefinována jako index provozního deníku. Využívá se při použití funkce Provozní deník (viz kapitola 4.22 Provozní deník ). Vytvářet historii volba, zda se bude provádět archivace hodnoty kanálu nebo nikoliv. V případě, že je zvolena, zobrazí se editační prvky pro zadání podmínek archivace. Hystereze rozdíl, o kolik se musí hodnota od poslední archivace změnit, aby se provedla archivace nová. Pozor! Pokud se Hystereze zadá 0, budou se data archivovat s každým zápisem hodnoty! Násobitel kanálu konstanta, kterou je vynásobena aktuální hodnota kanálu v LookDet. Plus konstanta, která je přičtena k aktuální hodnotě kanálu v LookDet. Poznámka Do databáze systému LookDet je archivována hodnota kanálu, upravená o parametry Násobitel kanálu a Plus. lookdet_a_g_cz_106 58/153
Obr. 63 Parametrizace kanálu s definicí podmínek archivace Minimální interval archivace v sec minimální čas, který musí uběhnout od poslední archivace, aby mohla být archivována další hodnota, a to i přes to, že hystereze bude překročena dříve. Pokud tedy bude nastavena hystereze např. na hodnotu 2 a minimální interval archivace bude mít hodnotu 5 s, nedojde k archivaci dříve, než uplyne zadaných 5 s a to i přes to, že dojde ke změně o hodnotu 2 dříve (např. za 3 s). Poznámka Parametr Hystereze a parametr Minimální interval archivace v sec ovlivňují četnost historických dat v archívu. Mají tedy přímý vliv na velikost databáze s archivními daty. Při nevhodném může rapidně narůstat velikost databáze. Pokud bude hodnotě kanálu nadefinováno v sekci Stanice zpětné čtení archívů (viz kapitola 3.4.2 Editace stávající stanice sekce Definice zpětného čtení archívů ), bude daná hodnota v kanálu barevně zvýrazněna. 59/153 lookdet_a_g_cz_106
Obr. 64 Hodnota s definicí zpětného čtení archívu 1 Zvýraznění hodnoty s nadefinovaným zpětným čtením archívu Vymazání hodnoty ze seznamu kanálu Vymazání hodnoty ze seznamu kanálu lze provést pomocí tlačítka se symbolem popelnice, které se zobrazí v řádku s hodnotou v případě, kdy je na něj umístěn kurzor myši. Obr. 65 Vymazání hodnoty ze seznamu kanálu 1 Zvýraznění kanálu najetím kurzoru myši 2 Tlačítko pro vymazání hodnoty ze seznamu 3.5.3 Manuální vytvoření kanálu v lokalitě Manuální vytvoření kanálu je vhodné použít v případě, kdy se v systému LookDet připravuje projekt bez možnosti vytvoření kanálů automaticky zasláním ze strany řídicího systému. Parametry nově vytvářeného kanálu lze zadat v editačním panelu po stisku tlačítka + v nástrojové liště sekce Kanály. lookdet_a_g_cz_106 60/153
Obr. 66 Manuální vytvoření kanálu v lokalitě 1 Parametry manuálně přidávaného kanálu 2 Tlačítko pro uložení parametrů manuálně přidávaného kanálu 3 Tlačítko pro manuální přidání kanálu Parametry manuálně přidávaného kanálu: Přiřadit kanál ke stanici výběr stanice, které bude kanál přiřazen. Typ kanálu výběr typu dat, která jsou v kanálu. K dispozici jsou následující typy: Typ kanálu AMiT M-BUS Modbus/TCP HTTP POST Text Význam Skalární proměnné a matice z řídicích systémů firmy AMiT. Data komunikovaná ze zařízení v síti M-BUS prostřednictvím převodníku DM-MB2ET (DM-DI4MB2ET) z produkce firmy AMiT. Data získaná prostřednictvím protokolu Modbus/TCP. Data získaná prostřednictvím protokolu HTTP POST. Data získaná prostřednictvím výše uvedených protokolů, která reprezentují text v podobě matice Integerů (viz kapitola 3.5.4 Kanál typu text ). 61/153 lookdet_a_g_cz_106
Popis kanálu textový popis kanálu. Kanál na serveru číslo nového / stávajícího kanálu, pod kterým bude / je hodnota k dispozici v rámci parametrizace náhledů (viz kapitola 3.6 Správa náhledů ). Řádek při tvorbě nového kanálu hodnota 0. Při manuální úpravě stávajícího kanálu zadat řádek, od kterého se přidává množství řádků, dosazených za parametr Řádků. Sloupec při tvorbě nového kanálu hodnota 0. Při manuální úpravě stávajícího kanálu zadat sloupec, od kterého se přidává množství sloupců, dosazených za parametr Sloupců. Řádků celkový počet nových / přidávaných řádků kanálu. Sloupců celkový počet nových / přidávaných sloupců kanálu. Minimální interval archivace v sec minimální čas, který musí uběhnout od poslední archivace, aby mohla být archivována další hodnota a to i přes to, že hystereze (viz kapitola 3.5.2 Nastavení / editace parametrů kanálu ) bude překročena dříve. Hystereze rozdíl, o kolik se musí hodnota od poslední archivace změnit, aby se provedla archivace nová. Pozor! Pokud se Hystereze zadá 0, budou se data archivovat s každým zápisem hodnoty! Násobitel kanálu konstanta, kterou je vynásobena aktuální hodnota kanálu v LookDet. Plus konstanta, která je přičtena k aktuální hodnotě kanálu v LookDet. Výchozí hodnota hodnota, která bude v kanálu, dokud neproběhne první získání skutečné hodnoty kanálu z připojené stanice. Poznámka Do databáze systému LookDet je archivována hodnota kanálu, upravená o parametry Násobitel kanálu a Plus. 3.5.4 Kanál typu text Založení nového kanálu proběhne až po kliknutí na tlačítko Přidat kanál. V případě, že dojde v průběhu zadávání parametrů nového kanálu ke kliknutí na název již vytvořeného kanálu nebo k přechodu do jiné sekce, nebude nově vytvářený kanál založen a jeho údaje budou ztraceny. Jedná se o speciální typ kanálu, který očekává data v podobě matice Integerů, kde každý řádek matice reprezentuje jeden text, každý sloupec jeden znak z řetězce. Znaky jsou v matici zadány pomocí kódů UTF-8. Kanál typu text je nutné vytvořit manuálně, dříve než do něj bude zapsána/načtena hodnota z připojené periferie. Vzhled již nadefinovaného kanálu typu text je patrná z následujícího obrázku. lookdet_a_g_cz_106 62/153
Obr. 67 Hodnoty nadefinovaného kanálu typu text 3.5.5 Export/Import parametrů kanálu Pomocí tlačítek Import a Export lze provádět hromadnou úpravu nastavení parametrů kanálu. Export a import využívá data ve formátu CSV (textový soubor, sloupce odděleny středníkem). Pro hromadnou úpravu je doporučen následující postup: provést export, poopravit získaný soubor, provést import. Výše uvedeným postupem se předejde případným problémům s formátem dat, který systém kontroluje. Import neplatného souboru systém neprovede. Pozor Import zruší veškeré aktuálně definované nastavení kanálu a nahradí jej importovaným souborem! V případě, že dojde při importu k chybě (např. vlivem špatného obsahu importovaného souboru), nebudou zrušená nastavení zachována! 3.5.6 Vymazání stávajícího kanálu Vymazání kanálu lze provést pomocí tlačítka se symbolem popelnice, které se zobrazí u kanálu v případě, kdy je na něj umístěn kurzor myši v seznamu kanálů. Vymazání kanálu je nutné potvrdit dialogem a je nevratné. Pokud byla data kanálu ukládána do databáze, dojde společně se smazáním kanálu také ke smazání všech jeho historických dat z databáze. V případě, že je kanál znovu zaslán do systému LookDet z připojení periferie, bude takovýto kanál po aktualizaci obrazovky k dispozici jako kanál nepřiřazený (viz kapitola 3.5 Správa kanálů ). 63/153 lookdet_a_g_cz_106
3.6 Správa náhledů Náhled je obrazovka, která uživateli umožňuje: zobrazovat data (v číselné či grafické podobě) poskytovaná připojenými stanicemi, zapisovat do stanic požadované parametry. Jedna uživatelská záložka (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf) v uživatelské sekci může zobrazovat libovolný počet náhledů. Pro správu náhledů slouží sekce Náhledy, kde je možné: zakládání nových náhledů, editaci parametrů stávajících náhledů, export / import parametrů stávajících náhledů, klonování náhledů, přiřazení funkcí grafické podobě náhledu, stažení starších verzí grafické podoby náhledů, vymazání stávajících náhledů. Obr. 68 Panel se správou náhledů 1 Seznam náhledů 2 Tlačítko pro vytvoření nového náhledu Grafická podoba náhledu je tvořena obrázky ve formátu SVG. Pro jejich tvorbu je nutné využít externí nástroj (např. Inkscape), který formát SVG podporuje. lookdet_a_g_cz_106 64/153
3.6.1 Založení nového náhledu Založení nového náhledu lze provést stiskem tlačítka + v nástrojové liště sekce Náhledy. V editačním panelu dojde k zobrazení parametrů, nutných pro založení nového náhledu. Obr. 69 Zobrazení potřebných údajů pro nově zakládaný náhled 1 Údaje nového náhledu 2 Tlačítko pro uložení změn Údaje náhledu: Česky český popis náhledu (povinný) následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Nadřazený náhled identifikátor šablony. Nutno vyplnit (výběrem z nabízeného seznamu již nadefinovaných šablon) pouze v případě, kdy náhled vychází ze šablony (viz kapitola 3.6.7 Šablony a podřízené náhledy ). Šablona nastavení, zda se jedná o šablonu nebo o standardní náhled (viz kapitola 3.6.7 Šablony a podřízené náhledy ). Založení nového náhledu proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu zadávání parametrů nového náhledu ke kliknutí na název již vytvořeného náhledu nebo k přechodu do jiné sekce, nebude nově vytvářený náhled založen a jeho údaje budou ztraceny. 3.6.2 Editace parametrů stávajícího náhledu Editaci stávajícího náhledu lze provést v editačním panelu po kliknutí na požadovaný náhled v seznamu náhledů. Význam jednotlivých položek je stejný jako při zakládání nového náhledu (viz kapitola 3.6.1 Založení nového náhledu ). 65/153 lookdet_a_g_cz_106
Obr. 70 Editace náhledu 1 Vybraná stanice 2 Údaje vybrané stanice 3 Grafická podoba náhledu Potvrzení provedených změn parametrů náhledu proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu úpravy parametrů stávajícího náhledu ke kliknutí na název jiného náhledu nebo k přechodu do jiné sekce, nebudou provedené změny uloženy a dojde k jejich ztrátě. Tlačítka, která jsou nabízena po najetí kurzoru myši na již vytvořený náhled, umožňují: vytvoření klonu náhledu, export grafické podoby náhledu, import grafické podoby náhledu, stažení starší verze náhledu, smazání stávajícího náhledu. lookdet_a_g_cz_106 66/153
Obr. 71 Možnosti náhledu 1 Zvýraznění náhledu najetím kurzoru myši 2 Nezvýrazněný náhled 3 Tlačítka pro další práci s náhledem Význam tlačítek pro práci s náhledy je patrný z následující tabulky. Tlačítko Význam Klonování vytvořeného náhledu Export grafické podoby náhledu Import grafické podoby náhledu Stažení starší verze grafické podoby náhledu Vymazání stávajícího náhledu Klonování vytvořeného náhledu Pomocí tlačítka lze vytvořit klon (kopii) náhledu, u kterého bylo na tlačítko kliknuto. Dojde k zobrazení okna, ve kterém je nutné zadat: prefix (předpona) nebo sufix (přípona) nebo prefix i sufix se kterými bude vytvořen klon náhledu. 67/153 lookdet_a_g_cz_106
Obr. 72 Okno pro zadání prefixu a sufixu klonovaného náhledu Tato funkce je velmi výhodná např. v případech, kdy je potřeba vytvořit kopii šablony (viz kapitola 3.6.7 Šablony a podřízené náhledy ), ve které je nadefinováno větší množství tagů. Při vytváření klonů jsou vždy zachovány veškerá nastavení klonovaného náhledu. Export grafické podoby náhledu Pomocí tlačítka lze provést export grafické podoby náhledu do formátu SVGZ a jeho uložení na disk počítače (viz kapitola 3.6.3 Editace grafické podoby náhledu ). Import grafické podoby náhledu Pomocí tlačítka lze provést import vlastní grafické podoby náhledu z disku počítače (viz kapitola 3.6.3 Editace grafické podoby náhledu ). Je možné provést import náhledu ve formátu SVG nebo SVGZ. Obecně je doporučeno používat spíše formáty SVGZ. Stažení starší verze náhledu Pomocí tlačítka lze provést stažení starší verze náhledu. Systém LookDet uchovává až 5 verzí náhledů zpět. S každým uložením náhledu dojde k aktualizaci starších verzí. Po stisku tlačítka se zobrazí okno se seznamem starších verzí, které je možno stáhnout. lookdet_a_g_cz_106 68/153
Obr. 73 Okno se seznamem starších verzí náhledu pro stažení Vymazání stávajícího náhledu Pomocí tlačítka lze provést vymazání stávajícího náhledu. K vymazání náhledu dojde až po potvrzení dvou dialogů, stejně jako u vymazání ovladače (viz kapitola 3.3.3 Vymazání definice stávajícího ovladače ). Pozor vymazání náhledu je nevratné. 3.6.3 Editace grafické podoby náhledu Editaci grafické podoby náhledu je nutné provést pomocí externího programu, který umožňuje práci se soubory typu SVG / SVGZ. Aby bylo zobrazení grafické podoby náhledu bezproblémové, je důrazně doporučeno využívat program Inkscape! 3.6.4 Přiřazení funkcí ke grafickým objektům Každému grafickému objektu, vytvořenému při editaci grafické podoby náhledu, lze přiřadit určitou funkci. Pro možnost přiřazení funkce musí být grafický objekt aktivován. Aktivaci / deaktivaci grafického objektu lze provést přímo v parametrizaci náhledu kliknutím na příslušný grafický objekt současně se stisknutou klávesou Ctrl. Pokud se jedná o jednoduchý objekt, bude přímo aktivován / deaktivován (1 problikne při aktivaci, 2 při deaktivaci). Pokud je objekt zanořen ve skupině více objektů, zobrazí se dialog, obsahující všechny související objekty, přejetím myši přes tlačítka v dialogu bude odpovídající objekt (nebo skupina objektů) zvýrazněn probliknutím. Aktivace / deaktivace objektu se provede kliknutím na příslušné tlačítko. Neaktivované objekty jsou pouze pasivní a nemají žádnou vazbu na hodnoty v kanálech. 69/153 lookdet_a_g_cz_106
Po kliknutí na aktivovaný grafický objekt se zobrazí okno s dostupnými funkcemi. Obr. 74 Dostupné funkce pro parametrizaci objektu Po výběru / editaci parametrů funkce a kliknutí na tlačítko Uložit, budou některé funkce vizualizace aktivní již v editovaném náhledu (čas obnovy, zobrazení barev a hodnot). Nefunkční je nastavení parametrů ve stanici, malé a velké grafy. Uložení přiřazených funkcí k objektům náhledu Jakmile je v grafické podobě náhledu potvrzena jakákoliv změna v přiřazení / parametrizaci funkce, zobrazí se nad grafickou podobou náhledu tlačítko Uložit, pomocí kterého je nutné veškeré změny potvrdit. Pokud nebude potvrzení provedeno, nebudou změny v přiřazení / parametrizaci funkcí akceptovány a po kliknutí na jakýkoliv jiný náhled v seznamu náhledů či na jakoukoliv jinou sekci budou úpravy ztraceny. lookdet_a_g_cz_106 70/153
Obr. 75 Správa náhledů tlačítka 1 Tlačítko pro uložení změn ve funkcích přiřazených grafickým objektům 2 Tlačítko pro zrušení změn ve funkcích přiřazených grafickým objektům V případě požadavku na zrušení změn v přiřazení / parametrizaci funkce bez uložení je možné kliknout na tlačítko Zrušit, které se vždy zobrazuje a skrývá společně s tlačítkem Uložit. Nástrojová lišta náhledu V horní části každého grafického náhledu je zobrazena nástrojová lišta, která uživateli umožňuje: probliknutí již aktivovaných objektů, přizpůsobení velikosti náhledu otevřenému oknu prohlížeče, nastavení intervalu obnovy náhledu. Obr. 76 Nástrojová lišta náhledu 1 Tlačítko pro probliknutí aktivovaných objektů 2 Tlačítka pro přiblížení/oddálení náhledu 71/153 lookdet_a_g_cz_106
3 Aktuální úroveň přiblížení/oddálení náhledu 4 Nastavený interval obnovy náhledu Význam tlačítek pro práci s náhledy je patrný z následující tabulky. Tlačítko Význam Probliknutí aktivních objektů Oddálení náhledu o 10 % Zobrazení celého náhledu Přiblížení náhledu o 10 % Přiblížení / oddálení náhledu je možné provést také pomocí točítka myši, při stisknuté klávese Ctrl (kurzor myši musí být umístěn nad grafickou podobou náhledu). Aktuální úroveň přiblížení/oddálení náhledu je číselně zobrazena vedle tlačítek. 3.6.5 Přehled funkcí pro parametrizaci objektů LookDet umožňuje přiřadit objektům v SVG formátu následující funkce: Zobrazení číselné hodnoty Zobrazení času Barva podle hodnoty Barva podle bitu Text a barva podle bitu Viditelnost podle bitu Zobrazení textu Ukazatel průběhu Graf pro ¼ hod maximum Nastavení parametrů Nastavení časových plánů Nastavení křivky (interpol) Nastavení křivky (EqLine) Lokalizace lokalizační label Zobrazení trendů Stav obnovy Nový náhled v okně Provozní deník Popis jednotlivých funkcí je uveden v kapitole 4 Funkce pro objekty v náhledech. lookdet_a_g_cz_106 72/153
Uživatelské funkce Pro zvýšení uživatelského komfortu lze do SVG náhledu vložit vlastní uživatelskou funkci napsanou v JavaScriptu. JavaScript se zapisuje do root SVG. 3.6.6 Ostrý náhled Systém podporuje pro tyto účely 3 události: tts-load uživatelská funkce zavolaná po načtení SVG, tts-refresh uživatelská funkce zavolaná při každé obnově dat v SVG, tts-destroy uživatelská funkce zavolaná před odstraněním SVG. Do uživatelských funkcí je předán objekt vizualizace, dostupný jako this. Pro získání aktuálních dat je dostupná funkce this.getlastdata, která vrátí aktuální stav dostupných kanálů, pro získání přístupu k SVG slouží this.getsvgobj. Pomocí tlačítka Ostrý náhled lze otevřít aktuální verzi grafické podoby náhledu v novém okně v plně funkčním provedení (jak zobrazení tak zápis dat). 3.6.7 Šablony a podřízené náhledy Funkci lze s výhodou použít zejména tam, kde je více stanic se stejnou technologií a data se posílají na dispečink v totožných maticích (například matice Float pro desetinná a matice Long pro celá čísla). Namísto několika hůře udržovatelných náhledů se založí 1 šablona, kde se u objektů místo čísla kanálu nastaví tzv. tag (např. FLOAT a LONG ). Při definici náhledu pro jednotlivé podřízené stanice se pak pouze přiřadí číslo příslušného kanálu s celočíselnou a desetinnou maticí odpovídajícímu tagu. Při změně šablony se automaticky přegenerují veškeré podřízené náhledy. Pro použití náhledu jako šablona je třeba aktivovat volbu Šablona v parametrech náhledu (parametr ID šablony je nutno ponechat nevyplněný!) při jeho zakládání, nebo později při jeho editaci. Při parametrizaci náhledu nastaveného jako šablona mohou být používána klíčová slova namísto parametrů: Kanál Řádek Sloupec Tato klíčová slova jsou následně u podřízených stanic nahrazena příslušným číslem kanálu (řádku, sloupce). Klíčové slovo smí obsahovat pouze znaky a až z, A až Z (včetně diakritiky) a čísla. Nesmí být platným celým číslem (platná čísla se považují přímo za číslo příslušného kanálu, řádku, nebo sloupce a nejsou nahrazována). Systém rozlišuje velká a malá písmena. Pro případ, že je třeba v šabloně změnit název tagu, případně jej vymazat je systém vybaven funkcí Správa tagů (dostupná u šablon). 73/153 lookdet_a_g_cz_106
Obr. 77 Pozice tlačítka pro vyvolání správy tagů 1 Tlačítko pro vyvolání okna se správou tagů Po stisku tlačítka je zobrazen seznam všech dostupných tagů, které je možno přejmenovat, nebo vymazat (pomocí tlačítka se symbolem popelnice ). Obr. 78 Seznam dostupných tagů Vymazáním tagu se v podřízených náhledech nastaví příslušné hodnoty na -1! V případě, že nebude použita funkce správy tagů a požadovaný tag bude lookdet_a_g_cz_106 74/153
přejmenován v grafickém náhledu šablony pouze u některého objektu, vznikne další (nový) tag. Uložením změn ve správě tagů je automaticky uložen i grafický náhled šablony. Vymazáním celé šablony se z podřízených náhledů stávají náhledy běžné. Šablony a podřízené náhledy jsou v seznamu náhledů barevně zvýrazněny. Zvýraznění je závislé na nastavení vzhledu. U podřízených náhledů je za názvem uvedeno nejen vlastní ID, ale také ID šablony (ID náhledu > ID šablony). Obr. 79 Příklady barevného značení náhledů 1 Vybraný náhled 2 ID náhledu 3 Náhled bez šablony 4 Šablona náhledu 5 Náhled podřízený šabloně 6 ID podřízeného náhledu 7 ID nadřazené šablony Příklad Chceme-li zobrazit venkovní teplotu, která je umístěna v kanálu 1000 jedné stanice a v kanálu 2000 stanice druhé. Vytvoříme nový grafický náhled šablonu. Při návrhu grafických objektů zadáme v parametru kanál pro číselné zobrazení místo hodnoty 1000 (resp. 2000) klíčové slovo venkt a šablonu uložíme (ID šablony se nevyplňuje!). Nyní založíme nový náhled, kterému vyplníme ID šablony (ID je uvedeno například v seznamu dostupných náhledů na konci příslušného řádku) a pole šablona ponecháme nastaveno na hodnotu ne. V okamžiku, kdy chceme nastavit parametry takto definované stanice, je zobrazen pouze neaktivní náhled šablony a nad ním tabulka se seznamem dostupných tagů pro nahrazení (v našem příkladu 1 řádek obsahující tag venkt ). Vyplněním a uložením tabulky vzniká plnohodnotný náhled stanice, které se při prvním zobrazení nahradí klíčové slovo venkt zadanou hodnotou (1000 pro první a 2000 pro druhý náhled). 75/153 lookdet_a_g_cz_106
Speciální funkce šablon Šablony umožňují u některých funkcí nebo objektů použití speciálních řetězců, které uvedou objekt do specifického režimu. Lokalizační label Objekt text Pokud se do lokalizačního labelu uvede řetězec %1, který se v SVG obrázku přiřadí objektu s textem, bude v náhledu místo takového textu zobrazen název náhledu, který z dané šablony vychází. Pokud se v SVG obrázku vyskytuje text, který začíná a končí znaky $, bude po nahrání SVG obrázku do náhledu s příznakem šablona uvedený text nabízen v podřízených náhledech jako tag. Tuto funkci lze typicky využít např. v případech, kdy je nutné vypracovat náhledy pro několik technologických prvků, které se neliší (typicky topná větev). Náhledy pro jednotlivé technologické prvky se od sebe budou lišit pouze pořadovým číslem, aby uživatel dokázal rozlišit, na který technologický prvek se dívá. Již v SVG obrázku pro šablonu se tedy vytvoří např. text $cislo$. Po importu SVG obrázku do šablony a vytvoření podřízených náhledů se pak automaticky u každého podřízeného náhledu automaticky vytvoří tag cislo, do kterého lze zadat jakoukoliv konstantu, která se bude v náhledu zobrazovat na pozici textu $cislo$. lookdet_a_g_cz_106 76/153
3.7 Správa uživatelů Pro správu uživatelů slouží sekce Uživatelé, kde je možné: zakládání nových uživatelů, klonování stávajících uživatelů, změna parametrů stávajících uživatelů, rušení stávajících uživatelů. Obr. 80 Panel se seznamem uživatelů 1 Seznam uživatelů v lokalitě 2 Tlačítko pro založení nového uživatele Význam jednotlivých položek v řádcích se seznamem uživatelů, je patrný z následujícího obrázku. Obr. 81 Význam položek jednoho řádku seznamu uživatelů 1 Symbol zařazení uživatele (běžný uživatel / administrátor) 2 Příjmení a jméno uživatele 3 Přihlašovací jméno uživatele 77/153 lookdet_a_g_cz_106
V závislosti na oprávnění uživatele se v řádku s jeho definicí zobrazuje různý symbol. Symbol Význam Běžný uživatel Administrátor lokality / Globální administrátor Skupina uživatelů Seznam globálních administrátorů je mimo seznam uživatelů lokality (položka Globální administrátoři ) a je přístupný pouze globálním administrátorům. Pro usnadnění správy uživatelů je možno definovat skupiny, kterým lze přiřazovat práva stejně jako uživatelům. Skupiny je možno rovněž zanořovat do podskupin. Výsledná práva jsou součtem všech nadřazených skupin (uživatel může vše, co je povoleno v nadřazené skupině a ve skupinách, které jsou jí nadřazeny). Pozor Je třeba zamezit cyklickému zanořování skupin (např.: existují skupiny 1 až 5, kde skupina 1 dědí práva skupiny 2 a ta opět skupiny 1), rovněž nesmí být skupina nadřazena sama sobě. 3.7.1 Založení nového uživatele / skupiny Založení nového uživatele / skupiny lze provést stiskem tlačítka + v nástrojové liště sekce Uživatelé. V editačním panelu dojde k zobrazení parametrů, nutných pro založení nového uživatele / skupiny. lookdet_a_g_cz_106 78/153
Obr. 82 Zobrazení potřebných údajů pro nově zadávaného uživatele 1 Údaje nově definovaného uživatele 2 Tlačítko pro potvrzení vytvoření nově definovaného uživatele 3 Tlačítko pro odeslání testovacího e-mailu Údaje uživatele: Skupina volba, zda se zakládá skupina uživatelů, nebo uživatel. Nadřazená skupina skupina, ze které příslušná skupina, nebo uživatel dědí práva. Jméno křestní jméno uživatele. Příjmení příjmení uživatele. Přihlašovací jméno přihlašovací jméno uživatele do systému LookDet. Heslo přístupové heslo uživatele, pokud probíhá úprava uživatele a nechcete měnit uživatelovo heslo, nechte pole prázdné, heslo nebude změněno. E-mail pokud má dostávat uživatel e-mail s hlášením poruch, je třeba zadat e-mail. Je možné zadat také více emailů, oddělených čárkami (bez mezer). Jazyk uživatele volba lokalizace uživatelova prostředí. Zařazení uživatele přiřazení práv (administrátor / běžný uživatel). Aktivní uživatel aktivace / deaktivace přístupu uživatele do systému. Založení nového uživatele proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu zadávání parametrů nového uživatele ke kliknutí 79/153 lookdet_a_g_cz_106
na název již vytvořeného uživatele nebo k přechodu do jiné sekce, nebude nově vytvářený uživatel založen a jeho údaje budou ztraceny. Pro ověření správnosti zadaného kontaktního e-mailu (kontaktních e-mailů) lze stisknout tlačítko Odeslat testovací email. Na všechny e-mailové adresy by měl být doručen e-mail s textem Testovaci zprava LookDet (LookDet test message) v předmětu e-mailu. 3.7.2 Editace stávajícího uživatele / skupiny Editaci stávajícího uživatele / skupiny lze provést v editačním panelu po kliknutí na požadovaného uživatele / skupinu v seznamu uživatelů. Význam jednotlivých položek je stejný jako při zakládání nového uživatele (viz kapitola 3.7.1 Založení nového uživatele ). Obr. 83 Editace uživatele 1 Vybraný uživatel 2 Údaje vybraného uživatele Potvrzení provedených změn v definici uživatele / skupiny proběhne až po kliknutí na tlačítko Uložit. V případě, že dojde v průběhu úpravy parametrů stávajícího uživatele / skupiny ke kliknutí na definici jiného uživatele / skupiny lookdet_a_g_cz_106 80/153
nebo k přechodu do jiné sekce, nebudou provedené změny uloženy a dojde k jejich ztrátě. Tlačítka, která jsou nabízena po najetí kurzoru myši na již vytvořeného uživatele / skupinu, umožňují: vytvoření klonu uživatele / skupiny, smazání stávajícího uživatele / skupiny. Obr. 84 Možnosti uživatelů / skupiny 1 Zvýraznění uživatele / skupiny najetím kurzoru myši 2 Nezvýrazněný uživatel / skupina 3 Tlačítka pro další práci s uživatelem / skupinou Význam tlačítek pro další práci s uživatelem / skupinou je patrný z následující tabulky. Tlačítko Význam Klonování vytvořeného uživatele / skupiny včetně přidělených oprávnění Vymazání stávajícího uživatele / skupiny Klonování vytvořeného uživatele / skupiny Pomocí tlačítka lze vytvořit klon (kopii) uživatele / skupiny, u kterého bylo na tlačítko kliknuto. V editačním panelu dojde k zobrazení stejných parametrů jako při zakládání nového uživatele / skupiny. 81/153 lookdet_a_g_cz_106
Obr. 85 Parametry uživatele / skupiny Po zadání parametrů a jejich potvrzení pomocí tlačítka Uložit dojde k vytvoření klonu uživatele / skupiny, jehož veškerá nastavení budou převzata od původně vybraného zdrojového uživatele / skupiny. 3.7.3 Vymazání stávajícího uživatele / skupiny Vymazání uživatele / skupiny lze provést pomocí tlačítka se symbolem popelnice, které se zobrazí u definice uživatele / skupiny v případě, kdy je na něj umístěn kurzor myši v seznamu uživatelů. Vymazání uživatele / skupiny je nutné potvrdit dialogem a je nevratné. 3.8 Nastavení práv uživatelům / skupině Pro nastavení práv uživatelům / skupině slouží sekce Práva. Vlastní definice práv probíhá obdobně, jako v jiných oblastech systému. V levé části obrazovky se vybere jeden, nebo více uživatelů (stiskem klávesy Ctrl a klikáním levým tlačítkem myši), případně skupina. Následně se v editačním panelu zvolí, která kategorie práv se uživateli(ům) / skupině bude nastavovat. lookdet_a_g_cz_106 82/153
Obr. 86 Nastavení práv 1 Seznam uživatelů 2 Kategorie pro nastavení práv Význam jednotlivých položek v řádcích se seznamem uživatelů, je patrný z následujícího obrázku. Obr. 87 Význam položek jednoho řádku seznamu uživatelů 1 Symbol zařazení uživatele (běžný uživatel / administrátor / skupina) 2 Příjmení a jméno uživatele / skupiny 3 Přihlašovací jméno uživatele 4 Nadřazená skupina, ve které je uživatel zařazen Nastavení práv uživatelů / skupin je rozděleno do 4 kategorií: Administrativní práva definuje možnost přidělení některých administrativních oprávnění běžným uživatelům / skupinám. Dostupné stanice určuje přístup k datům jednotlivých stanic vybrané lokality. Operace na stanicích definuje povolené operace u stanic, na které má uživatel / skupina povolen přístup. Dostupné náhledy určuje, které náhledy může uživatel / skupina využívat. Pokud chce uživatel provést operaci spadající do oblasti omezené právy, systém nejdříve zkontroluje, zda má uživatel / skupina, ve které je zařazen, 83/153 lookdet_a_g_cz_106
vůbec právo provádět cokoliv s vybranou stanicí, pokud ne, přístup mu zablokuje. Pokud ano, prověří ještě, jaké operace má uživatel / skupina, ve které je zařazen, na příslušné stanici povoleny. Pro nastavení práv v jednotlivých kategoriích jsou k dispozici tlačítka, která se zobrazí po výběru uživatele / skupiny a kliknutí na požadovanou kategorii (viz popis kategorií v následujících kapitolách). Význam tlačítek je následující. Tlačítko Význam Označení všech položek seznamu Zrušení označení všech položek seznamu Výběr jednotlivých položek v kategorii se provádí klikáním levým tlačítkem myši na konkrétní položky. Vybrané položky jsou zvýrazněny. Výběr konkrétní položky lze zrušit opětovným kliknutím na odpovídající položku. Při jakékoliv změně v nastavení práv se v nástrojové liště s kategoriemi pro nastavení práv objeví tlačítko Uložit. Obr. 88 Tlačítko pro zápis změn nastavení 1 Tlačítko pro zápis změn nastavení Aby se změny v nastavení projevily, je nutné, před opuštěním aktuální kategorie, kliknout na toto tlačítko. Po úspěšném uložení změn tlačítko zmizí. Pozor V případě opuštění kategorie bez kliknutí na tlačítko Uložit nebudou provedené změny uloženy! Na tuto skutečnost systém nijak neupozorňuje. 3.8.1 Administrativní práva Vybraná administrativní práva lze přiřazovat pouze uživatelům / skupinám typu běžný uživatel. Administrátor lokality má všechny administrativní práva (mimo Lokalizace a Správu systému) automaticky přiřazena. Každý uživatel tedy může mít přiřazena i určitá administrátorská práva. lookdet_a_g_cz_106 84/153
Obr. 89 Nastavení administrátorských práv 1 Vybraný uživatel /skupina 2 Panel dostupných operací K dispozici jsou následující oprávnění: Správa náhledů uživatel / skupina může upravovat náhledy stanic ve své lokalitě. Správa ovladačů uživatel / skupina může spravovat ovladače ve své lokalitě. Správa stanic uživatel / skupina může spravovat stanice ve své lokalitě. Správa kanálů uživatel / skupina může spravovat kanály ve své lokalitě. Správa uživatelů uživatel / skupina může ve své lokalitě vytvářet, upravovat a mazat jiné uživatele. Správa práv uživatel / skupina smí nastavovat práva ostatních uživatelů lokality. Práva administrace uživatel / skupina může definovat přístupné sekce lokálních administrátorů. Změna vlastních záložek uživatel / skupina může měnit rozložení náhledů v záložkách a jejich vzhled. 85/153 lookdet_a_g_cz_106
3.8.2 Dostupné stanice Seznam nadefinovaných stanic, s barevně zvýrazněnými stanicemi, se kterými může uživatel pracovat. Obr. 90 Nastavení práv pro dostupné stanice 1 Vybraný uživatel 2 Dostupná stanice pro uživatele 3 Nedostupná stanice pro uživatele 3.8.3 Operace na stanicích Pracovní plocha pod výběrem kategorie práv se rozdělí na 2 panely: levý stanice s povoleným přístupem v sekci Přístup ke stanicím, pravý seznam jednotlivých práv, která lze přiřadit. Po výběru stanic(e) ze seznamu (výběr více stanic lze učinit stiskem klávesy Ctrl a klikáním myší) se v oblasti povolených operací zvýrazní aktuálně povolené operace. lookdet_a_g_cz_106 86/153
Obr. 91 Nastavení práv pro operace na stanicích 1 Vybraný uživatel / skupina 2 Panel povolených stanic 3 Panel pro výběr povolených operací Dostupné operace: Načíst nastavení uživatel / skupina má viditelné nastavovací objekty v náhledu, v nastavovacím dialogovém okně může hodnoty pouze zobrazit. Zapsat nastavení uživatel / skupina může prostřednictvím nastavovacího dialogového okna hodnoty změnit a zapsat. Zobrazení poruch uživatel / skupina vidí poruchy na vybraných stanicích, nemůže je převzít (kvitovat). Převzetí poruch uživatel / skupina vidí poruchy na vybraných stanicích, může je převzít (kvitovat). Poruchy na e-mail o vzniku a ukončení poruch je uživatel / skupina informován prostřednictvím zadaného e-mailu. Poruchy na mobil o vzniku, převzetí a ukončení poruchy je uživatel / skupina informován na připojeném zařízení s OS Android. Čtení provozního deníku uživatel / skupina vidí na provozní deníky řídicích systémů firmy AMiT. 87/153 lookdet_a_g_cz_106
3.8.4 Dostupné náhledy Seznam nadefinovaných náhledů, s barevně zvýrazněnými náhledy, se kterými může uživatel pracovat. Obr. 92 Dostupné náhledy 1 Vybraný uživatel 2 Panel s dostupnými náhledy Funkčnost dostupných náhledů lze vysvětlit jednoduchým příkladem: uživatel systému provozuje rozvod tepla v obci. Provozuje kotelny i výměníkové stanice a vše má dostupné v dispečerském systému LookDet. Správce objektu chce získat informace o své technologii. Administrátor tedy vytvoří uživatelský účet pro tuto technologii, přiřadí mu jen jeho technologii a příslušné operace na ní. Protože ale nechce uživateli zpřístupnit veškerá technologická data, přiřadí mu náhled obsahující pouze informace, které má správce objektu vidět. Pro své potřeby bude mít jiný náhled, který bude obsahovat komplexní (jiné) informace. 3.9 Lokalizace (jazykové mutace) Lokalizace (jazykové mutace) umožňují překlad uživatelského prostředí a prostředí administrátora do libovolného jazyka, zobrazitelného v kódování UTF-8. Speciálním jazykem je čeština, která se nezobrazuje, protože je v systému vždy a nelze nijak upravovat, ani z něj odebrat. lookdet_a_g_cz_106 88/153
Obr. 93 Panel s dostupnými lokalizacemi 1 Seznam použitých lokalizací 2 Tlačítko pro definici nové lokalizace Význam jednotlivých položek v řádcích se seznamem lokalizací, je patrný z následujícího obrázku. Obr. 94 Význam položek jednoho řádku seznamu lokalizací 1 Kód jazyka dle ISO 639-2 2 Popis jazyka Pozor Systém lokalizace je jednotný na celém serveru. Jakákoliv změna provedená v lokalizaci se tedy projeví ve všech lokalitách u všech uživatelů. 3.9.1 Založení nové lokalizace Založení nové lokalizace lze provést stiskem tlačítka + v nástrojové liště sekce Lokalizace. Dojde k otevření dialogového okna, kde je nutné zadat: Popis jazyka (lokalizace) zadává se v jazyce a písmem příslušného jazyka. Kód jazyka slouží k identifikaci překladu a musí být jedinečný v rámci lokalizací. Je trojmístný může být použit libovolný kód jazyka, ale doporučujeme využití normy ISO 639-2. 89/153 lookdet_a_g_cz_106
Obr. 95 Zobrazení potřebných údajů pro založení nové lokalizace 3.9.2 Editace stávající lokalizace Editaci stávající lokalizace lze provést v editačním panelu po kliknutí na požadovanou lokalizaci v seznamu lokalizací. V editačním panelu dojde k zobrazení všech dostupných textů systému s českým nadpisem a aktuálně zadanou lokalizací. Obr. 96 Editace stávající lokalizace 1 Vybraná lokalizace 2 Texty lokalizace lookdet_a_g_cz_106 90/153
Po provedení změny v lokalizaci je ji nutné potvrdit tlačítkem Uložit změny, které se objeví jak v seznamu lokalizací, tak pod seznamem textů vybrané lokalizace. Obr. 97 Tlačítko pro uložení změn v seznamu lokalizací 1 Tlačítko pro uložení změn Poznámka V případě, že má uživatel přiřazenu lokalizaci, ve které není zadán některý z textů, zobrazí se mu místo takového textu identifikátor vybrané lokalizace v závorkách, následovaný textem české lokalizace, např.: (rus) Správa ovladačů. Tlačítka, která jsou nabízena po najetí kurzoru myši na již vytvořenou lokalizaci, umožňují: export lokalizačních textů do CSV souboru, import lokalizačních textů z CSV souboru, vymazání lokalizace. 91/153 lookdet_a_g_cz_106
Obr. 98 Možnosti lokalizací 1 Zvýraznění lokalizace najetím kurzoru myši 2 Nezvýrazněná lokalizace 3 Tlačítka pro další práci s lokalizací Význam tlačítek pro další práci s lokalizací je patrný z následující tabulky. Tlačítko Význam Export lokalizačních textů do CSV souboru Import lokalizačních textů z CSV souboru Vymazání stávající lokalizace Export lokalizačních textů Pomocí tlačítka lze provést export nadefinovaných lokalizačních textů do souboru CSV a jeho uložení na disk počítače. Import lokalizačních textů Pomocí tlačítka lze provést import lokalizačních textů z disku počítače. Import textů je možné provést ze souboru ve formátu CSV. 3.9.3 Vymazání stávající lokalizace Vymazání lokalizace lze provést pomocí tlačítka se symbolem popelnice, které se zobrazí u definice lokalizace v případě, kdy je na ni umístěn kurzor myši v seznamu lokalizací. Vymazání lokalizace je nutné potvrdit dialogem. Po potvrzení dojde k úplnému a nenávratnému zrušení lokalizace z celého systému. Veškeré lokalizované texty budou nenávratně vymazány. Výjimkou je lokalizace parametrů v SVG grafikách, která zůstává nezměněna (je součástí SVG obrázku). lookdet_a_g_cz_106 92/153
3.10 Správa systému Pro správu systému slouží sekce Systém (přístupná pouze globálnímu administrátorovi), kde je možné: zjistit, zda je k dispozici novější verze systému LookDet, provést aktualizaci systému LookDet, zjistit parametry zakoupené licence, zadat licenční klíč pro rozšíření licence, restartovat server, na kterém běží systém LookDet, zobrazit log administrace, nastavit zálohování dat na FTP server. Sekce Systém je rozdělena do několika panelů viz následující obrázek. Obr. 99 Sekce pro správu systému 1 Panel pro aktualizaci LookDet 2 Panel pro správu licence 3 Panel pro restartování serveru 4 Panel s logem administrace 5 Panel pro nastavení zálohování 93/153 lookdet_a_g_cz_106
6 Panel s možností pro ověření spojení s periferií pomocí funkce PING 7 Panel analyzéru TCPdump 8 Panel s informacemi o stavu serveru 3.10.1 Panel pro aktualizaci LookDet Na tomto panelu je zobrazena aktuálně nainstalovaná verze systému LookDet a dostupná verze pro aktualizaci systému LookDet. Pomocí tlačítka Instalovat aktualizaci lze spustit aktualizační proces systému LookDet (tlačítko je zobrazenou pouze v případě, kdy je dostupná novější verze systému LookDet). Před aktualizací systému LookDet by měl administrátor serveru plně aktualizovat také operační systém Linux (sudo apt-get update, sudo apt-get upgrade, sudo apt-get dist-upgrade) a spuštění aktualizace systému LookDet provést až po úspěšném dokončení aktualizace operačního systému Linux. Obecně je doporučeno operační systém Linux pravidelně aktualizovat nezávisle na dostupných aktualizacích systému LookDet. Obr. 100 Panel pro aktualizaci LookDet 1 Aktuálně nainstalovaná verze na serveru 2 Aktuální verze LookDet 3 Tlačítko pro instalaci aktualizace Proces aktualizace probíhá ve dvou etapách: Stahování aktualizace systém LookDet stahuje aktualizační data na pozadí. Všichni uživatelé mohou se systémem LookDet pracovat pomocí webového prohlížeče standardním způsobem. Uživatel, který aktualizaci spustil, může se systémem LookDet pracovat pouze v případě, kdy by se znovu přihlásil pomocí nové záložky (případně pomocí nové instance) webového prohlížeče. Webový prohlížeč (záložka webového prohlížeče) bude po dobu stahování aktualizace signalizovat tuto činnost. Instalace aktualizace systém LookDet se restartuje a nebude zpracovávat žádná příchozí data až do ukončení procesu aktualizace. lookdet_a_g_cz_106 94/153
Doba instalace aktualizace se může se pohybovat v rozmezí desítek sekund až desítek minut v závislosti na výpočetním výkonu serveru, na kterém je systém LookDet provozován. Poznámka Pro aktualizaci dispečerského systému LookDet je nutné umožnit navázání odchozího spojení na server https://vizualizace.tts.cz/ (port 443). Obecně je silně doporučeno, po dobu aktualizace, povolit odchozí data na všech portech serveru, čímž se zabrání případným problémům se stahováním aktualizačních balíčků. 3.10.2 Panel pro správu licence Na tomto panelu lze ověřit množství dostupných licencí a rovněž lze aktualizovat stav licence. Význam jednotlivých položek je patrný z následujícího obrázku. Obr. 101 Panel pro správu licence 1 Identifikátor licence 2 Informace o aktuální licenci 3 Tlačítko pro aktualizaci licence 4 Pole pro zadání nového licenčního klíče Pro rozšíření licence je třeba kontaktovat dodavatele systému. Po zaplacení licenčních poplatků obdrží uživatel licenční klíč, který zadá (doporučujeme funkci kopírovat vložit ) do pole Licenční klíč. Po potvrzení tlačítkem Aktualizovat licenci dojde k ověření zadaného klíče a nastavení licencí podle požadovaného stavu. Další použití klíče provede pouze reinicializaci zakoupených licencí a nemá vliv na počty dostupných stanic, lokalit ani uživatelů. 95/153 lookdet_a_g_cz_106
3.10.3 Panel pro zálohování Na tomto panelu lze zadat parametry pro nastavení zálohování systému LookDet. Význam jednotlivých položek je patrný z následujícího obrázku. Obr. 102 Panel pro zálohování 1 Parametry FTP serveru pro zálohování 2 Tlačítko pro uložení nastavených parametrů Systém LookDet provádí lokálně jedenkrát za den (ve 2:00 ráno) kompletní zálohu databáze (dobu ani periodu zálohování nelze měnit). Zálohují se tedy veškeré nastavení (lokality, komunikační ovladače, náhledy, atd.) a přírůstkově také data z archívů (vždy data za poslední den). V případě, že se systému LookDet podaří spojit se vzdáleným FTP serverem, zadaným v parametrech nastavení zálohování, je vytvořená záloha nahrána na vzdálený FTP server. Pokud se spojení nezdaří, je záloha ponechána lokálně na serveru systému LookDet. Obnovu databáze z vytvořené zálohy dokáže provést pouze výrobce systému LookDet. Při požadavku na obnovu databáze je tedy nutné kontaktovat technickou podporu firmy AMiT a umožnit vzdálený SSH přístup na server (viz kapitola 1 Úvod ). lookdet_a_g_cz_106 96/153
3.10.4 Panel s informacemi o stavu serveru Na tomto panelu lze nalézt informace o aktuálním stavu serveru (čas, čas od restartu, obsazení paměti, disku atd.). Obr. 103 Panel s informacemi o serveru 3.10.5 Panel pro restart serveru Na tomto panelu lze provést restart celého serveru. Obr. 104 Panel pro restart serveru Po stisku tlačítka Restartovat server se kompletně rebootuje celý server, znovu zinicializuje veškeré ovladače a podobně. Tato operace může trvat i několik minut v závislosti na automatické kontrole konzistence dat na discích operačním systémem. 3.10.6 Panel pro příkaz Ping Na tomto panelu lze provést příkaz Ping na uživatelem vloženou IP adresu (např. IP adresu periferie, se kterou má systém LookDet komunikovat). Pomocí příkazu Ping lze provést jednoduché ověření, zda server, na kterém běží systém LookDet dokáže navázat spojení s požadovanou periferií na dané IP adrese. 97/153 lookdet_a_g_cz_106
Obr. 105 Panel s příkazem Ping 1 Tlačítko pro vyslání příkazu Ping 2 Pole pro zadání IP adresy periferie, na kterou má být Ping proveden 3.10.7 Panel TCP DUMP Na tomto panelu lze využít funkce software TCPdump, který slouží pro odchyt komunikace na ethernetovém rozhraní serveru, kde je provozován systém LookDet. TCPdump dokáže odchytávat a zobrazovat všechny pakety posílané přes vybrané síťové rozhraní. Obr. 106 Panel pro odchyt komunikace 1 Pole pro výběr ethernetového rozhraní serveru, kde bude odchyt probíhat 2 Pole pro výběr typu paketů (TCP/UDP), které se budou odchytávat 3 Pole pro zadání IP adresy periferie, pro kterou má být odchyt proveden 4 Pole pro zadání portu serveru nebo portu periferie, kde bude odchyt probíhat 5 Tlačítko pro export odchytu do souboru ve formátu PCAP (formát pro odchytové SW) lookdet_a_g_cz_106 98/153
6 Tlačítko pro spuštění / zastavení odchytu 7 Tlačítko pro export odchytu do textového souboru 8 Výpis odchytu komunikace (zobrazuje se pouze v případě, kdy už byl spuštěn) 3.10.8 Panel s logem administrace Na tomto panelu je uveden seznam naposledy provedených změn administrátory systému LookDet. Obr. 107 Sekce s logem administrace 1 Tlačítko pro listování v historii logu 2 Záznamy logu 3.10.9 Systémové náhledy Prostřednictvím menu v uživatelské sekci a položky Soubory ke stažení (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf) jsou mimo jiné ke stažení dva soubory s koncovkou svgz: náhled stavu aplikací (app_status.svgz), náhled stavu systému (system_status.svgz). Soubory lze v administrátorské sekci importovat jako náhledy, které budou bez nutnosti vytvoření jakýchkoliv vazeb zobrazovat systémové informace. Lze je zobrazit na výchozí obrazovce standardním postupem pro vložení náhledu na obrazovku (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). V obou vytvořených náhledech je možné, pomocí tlačítka v záhlaví panelu, otevřít tzv. velký graf, ve kterém lze vidět grafický průběh libovolné hodnoty, zobrazované na panelu. Data z grafu je možné exportovat do CSV souboru (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). 99/153 lookdet_a_g_cz_106
Obr. 108 Tlačítko pro zobrazení grafu 1 Tlačítko pro zobrazení grafu Náhled Stav aplikací (APP STATUS) Náhled obsahuje několik panelů. Obr. 109 Náhled Stav aplikací Význam panelů: WWW server webový server, SQL server SQL server, PHP zprostředkování komunikace mezi uživatelem a serverem (příprava a předání veškerých data mezi uživatelským prohlížečem a serverem systému LookDet), lookdet_a_g_cz_106 100/153
amitreader čtení dat z řídicích systémů firmy AMiT na základě požadavku uživatele (načtení nastavení, zápis nastavení, apod.), amitrwmul server pro produkty firmy AMiT zabezpečující použití dynamických IP adres na straně stanic a tzv. stálé čtení, failures zpracování poruch a alarmů, pscron plánovač úloh CRON, pdamit provozní deník pro produkty firmy AMiT, modbusapp server zajišťující cyklické spouštění odečítacího procesu v síti Modbus/TCP (obdoba plánovače), modbus vlastní aplikace, která fyzicky komunikuje v síti Modbus/TCP s daným zařízením spouští se podle potřeby z modbusapp pouze na jednu operaci (např. přečti registr, zapiš registr, atd.), mbusapp server zajišťující cyklické spouštění odečítacího procesu v síti M-Bus (obdoba plánovače), mbus vlastní aplikace, která fyzicky komunikuje v síti M-Bus s daným zařízením spouští se podle potřeby z mbusapp pouze na jednu operaci (např. načti měřič apod.). Každý z panelů zobrazuje tři položky: CPU využití CPU v době vykonávání operace, RAM využití RAM, proc počet spuštěných procesů. Náhled Stav systému (SYSTEM STATUS) Náhled obsahuje několik panelů. Obr. 110 Náhled Stav systému 101/153 lookdet_a_g_cz_106
Význam panelů: CPU informace o celkovém využití CPU (údaj je zjištěn pomocí systémové služby a je aktualizován jednou za minutu), MEMORY informace o využití paměti, DISK informace o využití disku, WWW server informace o vytížení systému webovým serverem, DATABASE informace o databázi, UPTIME informace o době běhu od startu systému. Význam jednotlivých položek v panelech je pospán v rámci nápovědy, která se zobrazí po najetí kurzorem myši na hodnotu, zobrazenou u vybrané položky (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Obr. 111 Nápověda u vybrané hodnoty 1 Kurzor myši na hodnotě vybrané položky 2 Nápověda s vysvětlením zobrazovaného údaje lookdet_a_g_cz_106 102/153
3.11 Odhlášení administrátora Pro bezpečné ukončení práce je vhodné se odhlásit. Odhlášení lze provézt přímo z administrátorské sekce kliknutím na tlačítko v nástrojové liště stránky administrátora (viz kapitola 3.1.1 Nástrojová lišta stránky administrátora ) nebo pomocí menu z uživatelské sekce. Obr. 112 Odhlášení pomocí uživatelského menu O úspěšném odhlášení je administrátor informován následujícím dialogem. Obr. 113 Potvrzení o odhlášení administrátora 103/153 lookdet_a_g_cz_106
4 Funkce pro objekty v náhledech 4.1 Práce s barvami u jednotlivých funkcí U funkcí, které umožňují pracovat s barvami, se po kliknutí na zvolenou barvu zobrazí dialog pro nastavení požadované barvy. Obr. 114 Dialog pro nastavení barvy 1 Předdefinované barvy 2 Nastavení sytosti zvolené barvy 3 Posuvník pro rychlý výběr barvy 4 Uživatelem definované barvy 5 Zadání barvy pomocí RGB kódu dekadicky po složkách 6 Původně nastavená barva 7 Zadání barvy pomocí RGB kódu hexadecimálně 8 Zadání barvy pomocí RGB složek prostřednictvím posuvníků 9 Nově zadávaná barva 10 Potvrzení nově nastavené barvy a zavření okna 11 Zavření okna bez potvrzení nově nastavené barvy lookdet_a_g_cz_106 104/153
Poznámka Potvrzení nově nastavené barvy lze učinit: Kliknutím na tlačítko Uložit. Dvojklikem na předdefinovanou / uživatelskou barvu v nastavení sytosti nebo v rychlém výběru barvy. 4.1.1 Nastavení sytosti zvolené barvy Sytost lze přibližně nastavit: Kliknutím levým tlačítkem myši na požadované místo v poli pro nastavení sytosti (do místa kliknutí bude umístěn symbol kruhu, který ukazuje, v jaké části pole se aktuální barva nachází). Přetažením symbolu kruhu (kliknutím a držením levého tlačítka myši nad symbolem) na požadovanou pozici. Obr. 115 Pole pro nastavení sytosti 1 Symbol kruhu s umístěným kurzorem myši 4.1.2 Posuvník pro rychlý výběr barvy Pomocí posuvníku pro rychlý výběr barvy lze barvu přibližně vybrat: Klikáním levým tlačítkem myši na požadovanou barvu (symbol šipky na pravé straně posuvníku zobrazuje poslední polohu kliknutí). Tažením symbolu šipky (kliknutím a držením levého tlačítka myši nad symbolem) na pravé straně posuvníku na požadovanou pozici (lze táhnout také v barevné oblasti v takovém případě šipka pouze signalizuje vybranou pozici). 105/153 lookdet_a_g_cz_106
Obr. 116 Symbol šipky s kurzorem myši 1 Symbol šipky s umístěným kurzorem myši 4.1.3 Zadání barvy číselně nebo prostřednictvím posuvníků Výslednou barvu lze nastavit také pomocí: tří číselných hodnot, reprezentujících úroveň červené (R), zelené (G) a modré (B) barvy ve výsledné barvě, jedné hodnoty v hexadecimálním tvaru (zadáním úrovně červené, zelené a modré barvy ve výsledné barvě tvar čísla je ČČZZMM), tří posuvníků reprezentujících úrovně červené (R), zelené (G) a modré (B) barvy ve výsledné barvě. Obr. 117 Nastavení barvy pomocí posuvníků 1 Tři číselné hodnoty pro zadání barvy 2 Hexadecimální tvar zadání barvy 3 Posuvníky pro zadání barvy 4.1.4 Uložení barvy pro příští použití Systém LookDet umožňuje uložení až 24 uživatelsky definovaných barev. V případě požadavku na vícenásobné použití barvy, která není předdefinována, tedy není nutné barvu znovu definovat. Po její první definici ji postačí přesunout lookdet_a_g_cz_106 106/153
(kliknutím na nově vytvořenou barvu levým tlačítkem myši a tažením) na některé z polí určených pro uživatelské barvy. Obr. 118 Uložení uživatelsky definované barvy 1 Sekce pro uživatelem definované barvy 2 Zvýrazněné pole, do kterého se uloží aktuálně nadefinovaná barva 3 Přesouvání aktuálně nadefinované barvy 4 Aktuálně nadefinovaná barva Uživatelsky definované barvy jsou pro konkrétního uživatele k dispozici ve všech náhledech a lokalitách, ke kterým má uživatel přístup. 4.2 Reakce na kliknutí Vybrané zobrazovací funkce umožňují nastavit, aby se po kliknutí na objekt: nestalo nic, otevřelo okno s grafem, otevřelo okno s tabulkou. Reakci na kliknutí lze nastavit pouze u funkcí, které obsahují parametr Na kliknutí, kde lze vybrat jednu z výše uvedených možností. 4.2.1 Na kliknutí nic nedělat Obr. 119 Na kliknutí nic nedělat Pří nastavení volby Nic nedělat nebude objekt na kliknutí nijak reagovat. 107/153 lookdet_a_g_cz_106
4.2.2 Na kliknutí zobrazit graf Obr. 120 Na kliknutí zobrazit graf Při nastavení volby Zobrazit graf dojde po kliknutí levým tlačítkem myši na objekt k zobrazení okna s grafem. V okně bude možné u grafu zobrazit také tabulku (viz manuál lookdet_u_g_cz_xxx.pdf). Pro správnou funkcionalitu je nutné nastavit následující parametry: Šířka okna šířka okna s grafem a tabulkou v pixelech. Výška okna výška okna s grafem a tabulkou v pixelech. Minimum v grafu hodnota, od které začíná osa Y grafu. Pokud se nezadá, bude minimální hodnota určována automaticky dle zobrazených dat. Maximum v grafu hodnota, kde končí osa Y grafu. Pokud se nezadá, bude maximální hodnota určována automaticky dle zobrazených dat. Šířka legendy šířka legendy v grafu (v pixelech). S legendou lze pracovat čtyřmi způsoby: a) ponechá se nevyplněná legenda bude na jednom řádku vpravo uvnitř grafu, b) zadá se hodnota 0 legenda nebude zobrazena, c) zadá se kladné číslo legenda bude vpravo, vně grafu, a bude mít zadanou šířku v pixelech. V případě, že bude text delší než zadaná šířka, bude legenda zalamována dle zadané šířky, d) Zadá se záporné číslo legenda bude vpravo, uvnitř grafu, a bude mít zadanou šířku v pixelech. V případě, že bude text delší než zadaná šířka, bude legenda zalamována dle zadané šířky. Šířka tabulky šířka části okna s tabulkou v pixelech. Hloubka [hod] rozsah časové osy grafu v hodinách (lze zadat 1 hodinu až 24 hodin). Kroky posuvu [hod] časové kroky v hodinách, po kterých se bude posunovat graf pomocí tlačítek v jeho spodní části. Lze zadat pouze kladná čísla. Jednotlivé kroky se oddělují znakem, (čárka) bez mezer. Je možné lookdet_a_g_cz_106 108/153
nadefinovat libovolné množství kroků. Každému kroku odpovídají dvě tlačítka (posun o daný krok ke starším a k novějším vzorkům). 4.2.3 Na kliknutí zobrazit tabulku Obr. 121 Na kliknutí zobrazit tabulku Při nastavení volby Zobrazit tabulku dojde po kliknutí levým tlačítkem myši na objekt k zobrazení okna s tabulkou (viz manuál lookdet_u_g_cz_xxx.pdf). Pro správnou funkcionalitu je nutné nastavit následující parametry: Šířka okna šířka okna s tabulkou v pixelech. Výška okna výška okna s tabulkou v pixelech. Počet řádků počet řádků tabulky, které budou zobrazeny v okně. Nejnovější dole volba, zda má být nejnovější hodnota na horním, nebo na dolním řádku tabulky. Hledat zpět volba, jak hluboko v historii hledat data pro vykreslení jednoho okna s tabulkou. Parametr je potřeba nastavit dle četnosti změn hodnot, které se mají v tabulce zobrazit. Pokud se zadá velký interval, může vypsání i malé tabulky trvat značnou dobu. Pokud se naopak zadá interval příliš krátký, nebude zobrazen požadovaný počet vzorků. Příklad: Je k dispozici hodnota, která se archivuje 1 za den. V okně tabulky je požadováno vidět vždy posledních 30 záznamů. V poli Hledat zpět je tedy nutné zvolit Měsíc. V případě volby položky Týden by se v tabulce zobrazilo pouze 7 řádků. V případě volby položky Rok by trvalo vyhledávání delší dobu. Kroky posuvu [řádky] kroky v počtu řádků, po kterých se bude posunovat tabulka pomocí tlačítek v její spodní části. Lze zadat jak záporná, tak kladná čísla. Jednotlivé kroky se oddělují znakem, (čárka) bez mezer. Je možné nadefinovat libovolné množství kroků. Každému kroku odpovídá jedno tlačítko (posun o daný krok ve zvoleném směru záporná hodnota odpovídá směru ke starším vzorkům, kladná hodnota odpovídá směru k novějším vzorkům). Popis kroků texty (oddělené čárkami bez mezer), pro jednotlivá tlačítka posuvu. Musí být nadefinováno tolik textů, kolik je nadefinováno kroků 109/153 lookdet_a_g_cz_106
posuvu každému posuvu odpovídá jedno tlačítko s jedním textem (viz manuál lookdet_u_g_cz_xxx.pdf). 4.3 Práce s maskou u bitových funkcí Všechny funkce, které zobrazují stav bitu (v jakékoliv podobě), umožňují zadat nejen číslo vybraného bitu, ale také bitovou masku (výběr skupiny bitů, kterou je potřeba mít nastavenu) pro správnou reakci nastavované funkce. Masku je možné zadat po kliknutí do pole Bit a stisknutí klávesy m. Tím dojde k zobrazení okna Definice bitové masky, ve kterém je možné vybrat skupinu bitů a způsob jejich vyhodnocení pro danou funkci. Obr. 122 Okno s definicí masky pro vyhodnocovaný bit 4.4 Práce s více hodnotami v jedné funkci Pokud funkce umožňuje použití více různých kanálů nebo více různých bitů nezávisle, je možné měnit pořadí kanálů či bitů pomocí tlačítek šipka nahoru a šipka dolů, která jsou u každého nadefinovaného kanálu či bitu. Pokud lze v rámci funkce definovat různé skupiny kanálů či bitů, lze pořadí skupin taktéž měnit pomocí šipek. Zpracování jednotlivých kanálů či bitů pak probíhá vždy od shora dolů. Pokud je tedy např. požadována reakce na bit, bude přiřazená funkce reagovat na první nastavený bit v pořadí. Smazání kanálů, bitů či skupin je vždy možné provést pomocí tlačítka se symbolem popelnice. lookdet_a_g_cz_106 110/153
Obr. 123 šipky pro přesun položek 1 Smazání skupiny 2 Přesun pořadí skupiny 3 Přesun pořadí zpracování jednotlivých hodnot 4.5 Zobrazení číselné hodnoty Slouží k zobrazení číselné hodnoty v požadovaném formátu libovolného kanálu. Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Neaktuální po [sec] pokud v tomto intervalu nenastane zápis aktuálního stavu do systému vizualizace, hodnota zešedne. V případě, že se zadá záporná hodnota, bude funkce vypnuta. Jednotka veličiny jednotka zobrazené veličiny (kpa, C apod.). Parametr není nutné zadávat. V případě jeho využití je doporučeno vložit před text charakterizující jednotku znak mezera (odsazení jednotek od hodnoty). 111/153 lookdet_a_g_cz_106
Násobitel kanálu tímto číslem je vynásobena hodnota v systému vizualizace před zobrazením. Desetinných míst počet zobrazených desetinných míst. Systém vizualizace ukládá desetinná čísla na 4 desetinná místa. Základní barva výchozí barva písma. Parametr se uplatní pouze v případě použití hranic pro změnu barvy. Pokud nejsou hranice použity, zůstane objektu barva nadefinovaná v SVG obrázku.. Minimální hranice pokles hodnoty pod tuto hranici má za následek změnu barvy písma na barvu zadanou vedle. Pokud je hodnota stejná, jako hranice maximální, písmo barvu měnit nebude. Maximální hranice překročení hodnoty této hranice má za následek změnu barvy písma na barvu zadanou vedle. Pokud je hodnota stejná, jako hranice minimální, písmo barvu měnit nebude. Blikat pod hranicí pokles hodnoty pod tuto mez má za následek blikání hodnoty. Pokud je hodnota stejná, jako pro blikání nad hranicí, bude blikání neaktivní. Blikat nad hranicí překročení této meze má za následek blikání hodnoty. Pokud je hodnota stejná, jako pro blikání pod hranicí, bude blikání neaktivní. Skrýt ve velkém grafu hodnota z této funkce nebude nabízená ve velkém grafu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Na kliknutí viz kapitola 4.2 Reakce na kliknutí. Sledovaná stanice pro ladění parametrů lze nadefinovat kanál ve vzdálené stanici. V režimu vizualizace je v případě kliknutí na hodnotu se současným stiskem klávesy Ctrl tato cyklicky načítána a zobrazena v malém grafu. Tato funkce je vhodná pro ladění PID a podobně. Typ dat typ proměnné ve vzdálené stanici. Kanál kanál (WID) proměnné ve vzdálené stanici. Řádek řádek ve vzdálení stanici, nebo 0. Sloupec sloupec ve vzdálení stanici, nebo 0. Poznámka V případě, kdy parametry sekce Speciální (ladící) parametry (Sledovaná stanice, Typ dat, Kanál, Řádek, Sloupec) nebudou využívány, není nutné je vyplňovat. Při jejich použití je však nutné je vyplnit všechny! Počet míst zobrazované hodnoty není dán textem, před chystaným v grafice SVG souboru, ale hodnotou, přenášenou v kanálu, případně počtem desetinných míst, zvolených v nastavení objektu. Proto je doporučeno počítat s touto skutečností již při návrhu počtu znaků textu v grafické části. Poznámka Pokud se zadají základní (povinné) parametry, mimo popis kanálu, špatně, bude místo hodnoty zobrazeno ---. Stejné zobrazení se vyskytne v případě použití šablon, kdy se místo čísla kanálu zadá tzv. tag. 4.6 Zobrazení času Slouží k zobrazení kanálu typu Long jako času. Předpokládá se, že v kanálu je hodnota jako počet sekund od 1. 1. 1980. lookdet_a_g_cz_106 112/153
Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Neaktuální po [sec] pokud v tomto intervalu nenastane zápis aktuálního stavu do systému vizualizace, hodnota zešedne. Formát data a času formátovací řetězec Formátovací znaky: 4.7 Barva podle hodnoty $d den v měsíci ve tvaru 1 až 31 $m měsíc v roce 1 až 12 $y rok na 4 místa (2012 ) $Y rok na 2 místa (12 ) $h hodiny (0 až 23) $i minuty (00 až 59) $s sekundy (00 až 59) Slouží ke změně barvy objektu v závislosti na hodnotě kanálu (barva se plynule mění při změně hodnoty kanálu od minimální po maximální hodnotu). Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál pro zobrazení číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Minimální hranice minimální hodnota kanálu pro výpočet barvy. Barva minimálního stavu barva výplně objektu při minimálním stavu kanálu. Maximální hranice maximální hodnota kanálu pro výpočet barvy. Barva maximálního stavu barva výplně objektu při maximálním stavu kanálu, v rozmezí mezi minimem a maximem se barva plynule přepočítává. Skrýt ve velkém grafu hodnota z této funkce nebude nabízená ve velkém grafu (viz návod na ob-sluhu lookdet_u_g_cz_xxx.pdf). Na kliknutí viz kapitola 4.2 Reakce na kliknutí. 113/153 lookdet_a_g_cz_106
4.8 Barva podle bitu Slouží ke změně barvy objektu v závislosti na hodnotě vybraného bitu kanálu. Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Skrýt ve velkém grafu hodnota z této funkce nebude nabízená ve velkém grafu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Na kliknutí viz kapitola 4.2 Reakce na kliknutí. Základní barva je barva výplně, pokud není aktivní žádný z níže definovaných bitů. Výchozí popis lokalizace výchozího popisu popis vizualizačního objektu ve všech dostupných jazykových mutacích (vyplnění české mutace je povinné). Přidat další bit přidání proměnné počet vyhodnocených bitů není nijak omezen, výplň se nastaví podle 1. nalezeného aktivního bitu. Tlačítkem lze přidat další editační panel, ve kterém se následně zadají parametry bitu Popis popis vizualizačního objektu při aktivním bitu ve všech dostupných jazykových mutacích (vyplnění české mutace je povinné). Kanál číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kliknutím na ikonu (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Bit vyhodnocovaný bit (ne váha bitu) nebo maska (viz kapitola 4.3 Práce s maskou u bitových funkcí ). Negovat negace znamená, že aktivním stavem je 0, namísto 1. Barva barva výplně při aktivním bitu. 4.9 Text a barva podle bitu Slouží ke změně textu a barvy textu v závislosti na hodnotě vybraného bitu kanálu. Funkce je totožná s funkcí Barva podle bitu s tím rozdílem, že je přiřazen na textový objekt a kromě změny barvy písma nastavuje i patřičný text. 4.10 Viditelnost podle bitu Slouží k zobrazení/skrytí objektu v závislosti na hodnotě vybraného bitu kanálu. lookdet_a_g_cz_106 114/153
Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál pro zobrazení číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Bit (0 až 31) vyhodnocovaný bit (ne váha bitu) nebo maska (viz kapitola 4.3 Práce s maskou u bitových funkcí ). Negovat bit negace znamená, že aktivním stavem je 0, namísto 1. Transparentnost skrytí [%] udává procento průhlednosti objektu při neaktivním bitu. 0 objekt nebude vůbec vidět, 100 objekt bude zobrazen úplně (nebude poznat aktivita bitu). Skrýt ve velkém grafu hodnota z této funkce nebude nabízená ve velkém grafu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf) Na kliknutí viz kapitola 4.2 Reakce na kliknutí. 4.11 Zobrazení textu Stejně jako u funkce nastavení barvy podle bitu (viz kapitola 4.8 Barva podle bitu ) lze do pole Bit zadat také masku kliknutím do pole Bit a stisknutím klávesy m. Slouží k zobrazení hodnoty kanálu v podobě textu. Kanál musí být matice hodnot. Každý řádek matice reprezentuje jeden text, každý sloupec jeden znak z řetězce. Znaky jsou v matici zadány pomocí kódů UTF-8. Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál pro zobrazení číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kliknutím na ikonku (lupa). Řádek řádek z matice hodnot v databázi systému vizualizace. 4.12 Ukazatel průběhu Slouží ke grafickému zobrazení hodnoty kanálu (obdoba prvku progressbar v prostředí DetStudio). Přiřadí objektu barvu pozadí a barvou ukazatele bude objekt vyplňovat v závislosti na hodnotě přiřazeného kanálu. 115/153 lookdet_a_g_cz_106
Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Česky český popis (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál číslo kanálu (WID) v systému vizualizace lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Minimální hranice pokles hodnoty pod tuto hranici má za následek změnu barvy písma na barvu zadanou vedle. Pokud je hodnota stejná, jako hranice maximální, písmo barvu měnit nebude. Maximální hranice překročení hodnoty této hranice má za následek změnu barvy písma na barvu zadanou vedle. Pokud je hodnota stejná, jako hranice minimální, písmo barvu měnit nebude. Barva pozadí barva pozadí objektu. Barva ukazatele barva, kterou se bude objekt vyplňovat v závislosti na hodnotě přiřazeného kanálu. Typ ukazatele směr (horizontální/vertikální), jakým bude objekt vyplňován barvou ukazatele. Skrýt ve velkém grafu hodnota z této funkce nebude nabízená ve velkém grafu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Na kliknutí viz kapitola 4.2 Reakce na kliknutí. 4.13 Graf pro ¼ hod maximum Slouží ke grafickému zobrazení aktuální spotřeby a výslednému odhadu spotřeby při regulaci ¼ hodinového maxima. Funkce spolupracuje s moduly z knihovny Elektro v řídicích systémech AMiT. POZOR! Funkce graf pro ¼ hodinové maximum může být přiřazena pouze jednoduchému pravoúhlému objektu, vytvořenému v SVG. Nesmí být přiřazena skupině objektů! Dostupné parametry: Lokalita kanálu lokalita kanálu v systému vizualizace. Neaktuální po [sec] pokud v tomto intervalu nenastane zápis aktuálního stavu do systému vizualizace, hodnota zešedne. Čtvrthodinové maximum Kanál číslo kanálu (WID) v systému vizualizace s informací o ¼ hodinovém maximu, na které se má regulovat. Číslo (WID) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Čtvrthodinová suma lookdet_a_g_cz_106 116/153
Kanál číslo kanálu (WID) v systému vizualizace s informací o spotřebě v aktuální ¼ hodině. Číslo (WID) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Čtvrthodinový odhad Kanál číslo kanálu (WID) v systému vizualizace s informací o odhadu spotřeby v aktuální ¼ hodině. Číslo (WID) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Zbývající sekundy Kanál číslo kanálu (WID) v systému vizualizace s informací o počtu sekund, zbývajících do konce aktuální ¼ hodiny. Číslo (WID) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Barva pozadí barva pozadí objektu. Barva orámování grafu barva, rámečku vlastního grafu. Barva písma barva popisků grafu. Barva os a mřížek barva os a obou mřížek. Barva neutrální odhad barva plochy, která znázorňuje hodnotu, plánovanou pro aktuální ¼ hodinu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Barva pozitivní odhad barva plochy, která znázorňuje odhad v případě, kdy nebude překročeno ¼ hodinové maximum (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Barva negativní odhad barva plochy, která znázorňuje odhad v případě, kdy bude překročeno ¼ hodinové maximum (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Barva skutečného stavu barva plochy, která znázorňuje úroveň spotřeby v aktuální ¼ hodině (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Barva aktuální pozice barva svislé čáry, která znázorňuje aktuální čas ve ¼ hodině (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). Barva žádané hodnoty barva vodorovné čáry, která znázorňuje hodnotu, plánovanou pro aktuální ¼ hodinu (viz návod na obsluhu lookdet_u_g_cz_xxx.pdf). 117/153 lookdet_a_g_cz_106
4.14 Nastavení parametrů (editace dat ve stanici) Slouží k definici dialogového okna určeného pro nastavení hodnoty jedné, či více proměnným (viz kapitola 5.1 Parametrizace funkcí pro nastavení hodnot ve stanici ) v připojené stanici (stanicích). Dostupné parametry: Česky český popis (povinný) nastavovacího dialogu, následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz sekce Lokalizace lokality v kapitole 3.2.1 Založení nové lokality. Parametrizovaná stanice výběr stanice, ve které bude prováděna změna parametrů (viz správa stanic) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Šířka popisků [px] šířka popisků zadávané hodnoty. V závislosti na šířce popisku se mění poloha editačního pole pro nastavení parametrů. Analogový kanál Slouží pro zápis požadované hodnoty do proměnných v připojené periferii. Počet zápisů není nijak omezen. Při opakovaném stisku tlačítka Analogový kanál se budou přidávat jednotlivé definice analogových kanálů. V dialogu pro nastavení hodnot pak budou analogové kanály zobrazeny v pořadí, zadaném při parametrizaci. Pomocí tlačítka se symbolem popelnice lze nadefinované kanály odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou kanály zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 124 Parametry analogového kanálu Dostupné parametry: Česky český popis analogového kanálu (povinný) následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Typ dat typ parametrizovaného kanálu (WIDu). Kanál číslo kanálu (WID) v parametrizované stanici. lookdet_a_g_cz_106 118/153
Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Řádků počet řádků v matici, které budou editovány. Sloupců počet sloupců v matici, které budou editovány. Minimální hranice minimální povolená zadaná hodnota. Pokud je hodnota stejná s parametrem Maximální hranice, není zadávaná hodnota nijak omezena. Maximální hranice maximální povolená zadaná hodnota. Pokud je hodnota stejná s parametrem Minimální hranice, není zadávaná hodnota nijak omezena. Výběr hodnoty Slouží pro výběr jedné z několika analogových hodnot, která bude zapsána do proměnné v připojené periferii. Počet výběrů není nijak omezen. Při opakovaném stisku tlačítka Výběr hodnoty se budou přidávat jednotlivé definice výběrů. V dialogu pro výběr hodnot pak budou jednotlivé výběry zobrazeny v pořadí, zadaném při parametrizaci. Pomocí tlačítka se symbolem popelnice lze nadefinované výběry odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou jednotlivé výběry zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 125 Parametry výběru hodnoty Dostupné parametry: Česky český popis (povinný), následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz sekce Lokalizace lokality v kapitole 3.2.1 Založení nové lokality. Typ dat typ parametrizovaného kanálu. V případě vazby na kanál, přiřazený stanici typu Lookdet, lze vybrat libovolný typ. Kanál číslo kanálu (WID). Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. 119/153 lookdet_a_g_cz_106
Přidat volbu (přidání volby) při opakovaném stisku tlačítka Přidat volbu budou přidány položky, ze kterých se bude vybírat v dialogovém okně. Pomocí tlačítka se symbolem popelnice lze nadefinované položky odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou položky zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 126 Parametry přidání volby Dostupné parametry: Hodnota hodnota, která bude do proměnné nastavena. Česky český popis významu hodnoty (povinný), následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz sekce Lokalizace lokality v kapitole 3.2.1 Založení nové lokality. Binární kanál Slouží pro nastavení bitu proměnné v připojené periferii. Počet nastavení není nijak omezen. Při opakovaném stisku tlačítka Binární kanál se budou přidávat jednotlivé definice bitů. V dialogu pro nastavení hodnot pak budou binární kanály zobrazeny v pořadí, zadaném při parametrizaci. Pomocí tlačítka se symbolem popelnice lze nadefinované kanály odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou kanály zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 127 Parametry binárního kanálu Dostupné parametry: Typ dat typ parametrizovaného kanálu. Kanál číslo kanálu (WID) v parametrizované stanici. lookdet_a_g_cz_106 120/153
Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. check (přidání checkboxu) Při opakovaném stisku tlačítka check budou přidány položky, ze kterých se bude vybírat v dialogovém okně. Pomocí tlačítka se symbolem popelnice lze nadefinované položky odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou položky zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 128 Parametry volby Check Česky popis nastavovaného parametru v dostupných jazykových mutacích (vyplnění české mutace je povinné). Bit bit, který je nastavován. výběr (přidání výběru) Při opakovaném stisku tlačítka výběr budou přidány položky pro výběr, ze kterých se bude vybírat v dialogovém okně. Pomocí tlačítka se symbolem popelnice lze nadefinované položky odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou položky zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 129 Parametry volby Výběr Česky popis nastavovaného parametru v dostupných jazykových mutacích (vyplnění české mutace je povinné). Bit bit, který je nastavován. 121/153 lookdet_a_g_cz_106
Popis volby pro hodnotu 0 popis v dostupných jazykových mutacích pro případ nastavení bitu na hodnotu 0 (vyplnění české mutace je povinné). Popis volby pro hodnotu 1 popis v dostupných jazykových mutacích pro případ nastavení bitu na hodnotu 1 (vyplnění české mutace je povinné). Nastavení textu Slouží pro zápis textu do matice MI v připojené periferii. Počet nastavení není nijak omezen. Při opakovaném stisku tlačítka Nastavení textu se budou přidávat jednotlivé definice textů. V dialogu pro nastavení hodnot pak budou texty zobrazeny v pořadí, zadaném při parametrizaci. Pomocí tlačítka se symbolem popelnice lze nadefinované texty odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou texty zobrazeny v dialogovém okně (viz manuál lookdet_u_g_cz_xxx.pdf). Obr. 130 Parametry analogového kanálu Dostupné parametry: Česky český popis analogového kanálu (povinný) následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Kanál číslo kanálu (WID) v parametrizované stanici. Řádek číslo řádku s textem, který je uložen v kanálu (matici) zadaném v parametru kanál. Délka počet znaků, které bude možné zadat. Maximální možná hodnota je dána počtem sloupců v kanálu (matici) zadaném v parametru kanál. Přímý zápis Slouží pro zápis konstanty do proměnné v připojené periferii. Počet zápisů není nijak omezen. Při opakovaném stisku tlačítka Přímý zápis se budou přidávat jednotlivé definice přímých zápisů. Pomocí tlačítka se symbolem popelnice lze nadefinované přímé zápisy odebírat. Pomocí tlačítek šipka nahoru a šipka dolů lze měnit pořadí v jakém budou vkládány požadavky na přímý zápis. lookdet_a_g_cz_106 122/153
Obr. 131 Parametry analogového kanálu Dostupné parametry: Česky český popis analogového kanálu (povinný) následovaný případnými lokalizovanými názvy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Typ dat typ parametrizovaného kanálu (WIDu). Kanál číslo kanálu (WID) v parametrizované stanici. Řádek řádek z případné matice hodnot v databázi systému vizualizace, nebo 0. Sloupec sloupec z případné matice hodnot v databázi systému vizualizace, nebo 0. Řádků počet řádků v matici, které budou editovány. Sloupců počet sloupců v matici, které budou editovány. Hodnota hodnota, která se zapíše do požadovaného kanálu. Zobrazit výsledek zápisu volba, zda zobrazit dialogové okno s výsledkem zápisu nebo nikoliv. 4.15 Nastavení časových plánů Funkce je určena pro řídicí systémy firmy AMiT. Slouží pro grafické zobrazení/editaci kanálů (viz popis nastavení časových plánů v uživatelském návodu na obsluhu pro LookDet), které jsou na straně řídicího systému určeny pro časové plány (modul DayPlan/DayPlan2). Dostupné parametry: Česky český popis časového plánu (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Parametrizovaná stanice výběr stanice, ve které bude prováděna změna parametrů (viz kapitola 3.4 Správa stanic ) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). 123/153 lookdet_a_g_cz_106
Kanál časů (ML) číslo kanálu (WID) s časy denního plánu v parametrizované stanici. Kanál hodnot (MF/MI) číslo kanálu (WID) s posuny/povely v parametrizované stanici. Typ dat hodnot volba typu parametrů časového plánu mezi posunem hodnoty MF a povelem MI. Řádek číslo řádku, od kterého začínají data v kanálu časů a hodnot. Řádků počet řádků časového plánu. Sloupců počet povelů v 1 řádku časového plánu. Minimální hodnota minimální povolená hodnota v časovém plánu. Maximální hodnota maximální povolená hodnota v časovém plánu. Minimální rozsah osy Y minimální hodnota, zobrazená na ose Y. Maximální rozsah osy Y maximální hodnota, zobrazená na ose Y. Krok osa Y minimální krok, po kterém lze nastavovat editovanou hodnotu ve směru osy Y. Poznámka Hodnoty, zobrazované v popisu osy Y jsou určovány výrazem: ( Maximální rozsah osy Y - Minimální rozsah osy Y ) / 12 4.16 Nastavení křivky (interpol) Funkce je určena pro řídicí systémy firmy AMiT. Slouží pro grafické nastavení hodnot kanálu rozměru n 2 (viz popis nastavení křivky interpol v uživatelském návodu na obsluhu pro LookDet), který je na straně řídicího systému využíván modulem Interpol. Dostupné parametry: Česky český popis křivky (povinný), následovaný případnými lokalizovanými popisy (nepovinné). Počet popisů závisí na množství zadaných lokalizací systému viz kapitola 3.2.1 Založení nové lokality. Parametrizovaná stanice výběr stanice, ve které bude prováděna změna parametrů (viz kapitola 3.4 Správa stanic ) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Kanál (MF[?x2]) číslo kanálu (WID) křivky interpol v parametrizované stanici. Řádků počet řádků / zlomů křivky pro funkci Interpol. Minimální výstup minimální povolená hodnota na křivce interpol. Maximální výstup maximální povolená hodnota na křivce interpol. Minimální rozsah osy X hodnota, od které začíná osa X. Maximální rozsah osy X hodnota, na které končí osa X. Poznámka Hodnoty, zobrazované v popisu osy Y jsou určovány výrazem: ( Maximální rozsah osy Y - Minimální rozsah osy Y ) / 12 4.17 Nastavení křivky (EqLine) Funkce je určena pro řídicí systémy firmy AMiT. Slouží pro grafické nastavení hodnoty kanálu, určeného pro editaci strmosti topné křivky (viz popis nastavení lookdet_a_g_cz_106 124/153
křivky EqLine v uživatelském návodu na obsluhu pro LookDet). Na straně řídicího systému je kanál využíván v typových aplikacích firmy AMiT. Dostupné parametry: Česky popis topné křivky ve všech dostupných jazykových mutacích (vyplnění české mutace je povinné). Parametrizovaní stanice výběr stanice, ve které bude prováděna změna parametrů (viz kapitola 3.4 Správa stanic ) lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Konstanta K je v MF výběr, zda se jedná o jednoduchou proměnnou, nebo buňku matice. Kanál konstanty K číslo kanálu ve stanici. Řádek řádek v matici, nebo 0. Sloupec sloupec v matici, nebo 0. Minimální K minimální povolená hodnota konstanty K pro objekt EqLine. Maximální K maximální povolená hodnota konstanty K pro objekt EqLine. 4.18 Lokalizace lokalizační label Slouží pro zobrazení statického textu. Statický text zobrazuje v různých lokalizacích (jazykových mutacích), v závislosti na nastaveném jazyce uživatele. Dostupné parametry: Česky lokalizace překlad textu ve všech navolených jazycích. U šablon lze zadat text %1, který bude mít za následek nahrazení textu názvem náhledu (včetně případné lokalizace). 4.19 Zobrazení trendů Funkce nemá žádné doplňující parametry. Nastaví objekt tak, že po kliknutí zobrazí trendy měřených veličin. Pozor Prostřednictvím okna pro zobrazení trendů lze provádět také export dat do souborů CSV. Tímto způsobem lze zpracovávat maximálně 32 MB dat (omezení metody POST, jazyka PHP). Při překročení limitu se zapíše do exportovaného souboru chybové hlášení. V případě požadavku na získávání většího množství dat z databáze je silně doporučeno používat funkcí HTTP POST (viz kapitola 6 Dodatek B ). 4.20 Stav obnovy Funkce nemá žádné doplňující parametry. Text objektu je při každé obnově náhledu nastaven na aktuální čas. 125/153 lookdet_a_g_cz_106
4.21 Nový náhled v okně Slouží k vyvolání vyskakovacího okna definované velikosti s požadovaným náhledem. Dostupné parametry: ID náhledu jméno náhledu, který bude v otevřeném okně zobrazen. Šířka šířka okna s novým náhledem. Výška výška okna s novým náhledem. Zleva pozice okna od levého okraje okna. Odshora pozice okna od horního okraje okna. Poznámka V případě zadání záporné hodnoty do parametru šířka nebo výška, dojde k otevření náhledu v nové samostatné záložce okna prohlížeče, který je pro dané PC nastaven jako výchozí. Pokud se za parametry šířka/výška zadá hodnota 0 (nula), bude náhled v daném směru roztažen přes celou obrazovku. 4.22 Provozní deník Funkce je určena pro řídicí systémy firmy AMiT. Slouží k zobrazení okna s hlášeními provozního deníku zvoleného řídicího systému. Dostupné parametry: Sledovaná stanice jméno stanice (řídicího systému), pro kterou je požadováno zobrazení provozního deníku lze nalistovat z dostupných kanálů kliknutím na ikonku (lupa). Poznámka Provozní deník se zobrazí pouze za předpokladu, že: je do systému LookDet zasílána, ze strany řídicího systému, proměnná, s hodnotou indexu aplikačního provozního deníku, je u kanálu této proměnné nastavena volba Index PD AMiT (viz kapitola 3.5.2 Nastavení / editace parametrů kanálu ), je v definici stanice, ze které je zasílán index, správně zadán parametr Provozní deník (viz kapitola 3.4.1 Založení nové stanice ), jsou do systému LookDet importovány texty provozního deníku v příslušné lokalizaci (viz sekce Import textů provozního deník v kapitole 3.4.2 Editace stávající stanice ). lookdet_a_g_cz_106 126/153
5 Dodatek A 5.1 Parametrizace funkcí pro nastavení hodnot ve stanici 5.1.1 Zadání hodnoty Pomocí funkce Nastavení parametrů lze proměnným zadávat hodnoty pěti způsoby: Zadáním celočíselné nebo desetinné hodnoty. Zadáním binární hodnoty v podobě zatržítka (checkboxu) nebo v podobě výběru jedné ze dvou binárních hodnot. Výběrem jedné z několika hodnot. Zadáním textu. Zápisem konstanty. Vzhledem k tomu, že se požadované hodnoty vždy zadávají prostřednictvím automaticky vyvolaného dialogového okna, lze jednotlivé způsoby zadávání, v rámci jednoho přiřazení funkce pro nastavení parametrů, použít několikrát nebo je lze různě kombinovat. Pro zadání hodnoty slouží v nastavení parametrů položka Analogový kanál. V případě, že je požadavek na zadání více hodnot pomocí jednoho editačního okna, lze analogových kanálů nadefinovat více najednou (vícenásobným použitím položky Analogový kanál ), viz následující obrázek. 127/153 lookdet_a_g_cz_106
Obr. 132 Definice zadání několika analogových hodnot v jedné funkci lookdet_a_g_cz_106 128/153
Výsledkem výše uvedeného nastavení bude dialogové okno (zobrazené v následujícím obrázku), které se otevře vždy po kliknutí na objekt, kterému byla funkce přiřazena. Obr. 133 Výsledek parametrizace uvedené na předchozím obrázku 5.1.2 Zadání binární hodnoty Pro zadání binární hodnoty slouží v nastavení parametrů položka Binární kanál. V případě, že je požadavek na zadání více binárních hodnot z různých kanálů pomocí jednoho editačního okna, lze binárních kanálů nadefinovat více najednou (vícenásobným použitím položky Binární kanál ). V případě, že je požadavek na více zadání binárních hodnot ze stejného kanálu pomocí jednoho editačního okna, lze nadefinovat více binárních hodnot najednou (vícenásobným použitím položky check nebo výběr případně jejich kombinacemi). Na následujícím obrázku lze nalézt ukázku vícenásobného použití položky check. 129/153 lookdet_a_g_cz_106
Obr. 134 Definice zadání několika binárních hodnot ze stejného kanálu pomocí checkboxu Výsledkem výše uvedeného nastavení bude dialogové okno (zobrazené v následujícím obrázku), které se otevře vždy po kliknutí na objekt, kterému byla funkce přiřazena. lookdet_a_g_cz_106 130/153
Obr. 135 Výsledek parametrizace uvedené na předchozím obrázku V případě požadavku na vícenásobné použití výběru binární hodnoty lze nastavení provést dle následujícího obrázku. 131/153 lookdet_a_g_cz_106
Obr. 136 Definice zadání několika binárních hodnot ze stejného kanálu pomocí výběru lookdet_a_g_cz_106 132/153
Výsledkem výše uvedeného nastavení bude dialogové okno (zobrazené v následujícím obrázku), které se otevře vždy po kliknutí na objekt, kterému byla funkce přiřazena. Obr. 137 Výsledek parametrizace uvedené na předchozím obrázku 133/153 lookdet_a_g_cz_106
5.1.3 Výběr jedné z několika hodnot Pro zadání jedné z výběru několika hodnot slouží v nastavení parametrů položka Výběr hodnoty. V případě, že je požadavek na výběr hodnot z různých kanálů pomocí jednoho editačního okna, lze kanálů nadefinovat více najednou (vícenásobným použitím položky Výběr hodnoty ). Parametrizace výběru více hodnot z jednoho kanálu je uvedena na následujícím obrázku. Obr. 138 Definice výběru několika hodnot ze stejného kanálu lookdet_a_g_cz_106 134/153
Výsledkem výše uvedeného nastavení bude dialogové okno (zobrazené v následujícím obrázku), které se otevře vždy po kliknutí na objekt, kterému byla funkce přiřazena. Obr. 139 Výsledek parametrizace uvedené na předchozím obrázku 5.1.4 Zadání textu Pro zadání textu slouží v nastavení parametrů položka Nastavení textu. V případě, že je požadavek na zadání více textů pomocí jednoho editačního okna, lze položek pro zadání textů nadefinovat více najednou (vícenásobným použitím položky Nastavení textu ), viz následující obrázek. 135/153 lookdet_a_g_cz_106
Obr. 140 Definice zadání několika textů v jedné funkci Výsledkem výše uvedeného nastavení bude dialogové okno (zobrazené v následujícím obrázku), které se otevře vždy po kliknutí na objekt, kterému byla funkce přiřazena. lookdet_a_g_cz_106 136/153
Obr. 141 Výsledek parametrizace uvedené na předchozím obrázku 5.1.5 Zápis konstanty Pro zápis konstanty slouží v nastavení parametrů položka Přímý zápis. V případě, že je požadavek na zápis více konstant pomocí jednoho tlačítka, lze položek pro zápis konstanty nadefinovat více najednou (vícenásobným použitím položky Přímý zápis ), viz následující obrázek. 137/153 lookdet_a_g_cz_106
Obr. 142 Definice zápis několika konstant v jedné funkci Pokud je při parametrizaci zvoleno zobrazení výsledku zápisu, bude vždy po kliknutí na objekt, kterému byla funkce přiřazena, zobrazeno dialogové okno (zobrazené v následujícím obrázku) s výsledkem zápisu. lookdet_a_g_cz_106 138/153
Obr. 143 Výsledek parametrizace uvedené na předchozím obrázku 139/153 lookdet_a_g_cz_106
6 Dodatek B 6.1 HTTP POST 6.1.1 Základní údaje Kapitola pojednává o získání / uložení dat na server LookDet pomocí HTTP POST v 1.1. funkce post je na serveru LookDet přístupná na běžném http(s) portu, podporována je metoda POST i GET (s omezením délky dat daným protokolem HTTP), data se předávají ve formátu JSON, blok dat je šifrován algoritmem AES. 6.1.2 Základní formát dotazu http://adresalookdet/post.php?data={"idloc":2,"dataver":1,"data":"viz NÍŽE"} https://adresalookdet/post.php?data={"idloc":2,"dataver":1,"data":"viz NÍŽE"} http://adresalookdet/post.php?data={"idloc":2,"dataver":1,"heslo":"heslo LOKALITY","data":"VIZ NÍŽE"} https://adresalookdet/post.php?data={"idloc":2,"dataver":1,"heslo":"heslo LOKALITY","data":"VIZ NÍŽE"} http://adresalookdet/post.php?data={"idloc":2,"dataver":1,"archiv":1,"heslo": "HESLO LOKALITY","data":"VIZ NÍŽE"} http://adresalookdet/post.php?data={"idloc":2,"dataver":1,"archiv":1,"data": "VIZ NÍŽE"} kde idloc je ID lokality získané ze seznamu lokalit v administraci systému LookDet (viditelné u každé lokality v pravé části řádku). dataver označuje verzi použitého komunikačního protokolu, aktuálně 1. heslo obsahuje přístupové heslo lokality a zároveň udává, že není používáno šifrování dat. V tomto případě může útočník odposlechnout komunikaci a získat tak přístupové heslo lokality a přístup k datům a možnosti jejich změny. Je doporučeno pouze při použití protokolu https, případně v důvěryhodné lokální síti. V případě zadání neplatného hesla je vrácena chyba ve tvaru {"OK":0,"ERR":"Wrong password!"} viz chybové kódy. archiv pokud je v hlavičce zadán parametr archiv a je nastaven na hodnotu 1 ("archiv":1) nebudou získány aktuální data ve formátu JSON, ale historická data ve formátu CSV, odpověď bude vždy bez šifrování. Pozor, archiv NELZE kombinovat s aktuálními daty, ani zápisem do databáze (běžný get a put). data hexadecimálně zobrazený šifrovaný datový blok pro šifrovanou verzi, JSON požadavky pro verzi nešifrovanou. lookdet_a_g_cz_106 140/153
Datový blok je zašifrován standardním algoritmem AES, jako heslo je použit MD5 otisk hesla zadaného v parametrech lokality. Stejným způsobem je zašifrována i případná datová část odpovědi. V této verzi protokolu jsou v datovém bloku podporovány 2 parametry: get pro získání aktuálních dat, put pro zápis dat do databáze LookDetu. Data mohou být přenášena jednotlivě, nebo v souvislých blocích. Množství současně čtených / zapisovaných dat není teoreticky omezen (pouze výkonem serveru). Je třeba zvolit přiměřený interval, aby nedošlo k zbytečnému zatěžování serveru. Proto odpověď obsahuje parametr et (executing time) obsahující dobu zpracování na serveru v sekundách. 6.1.3 Možné varianty get tvar dotazu a odpovědi Žádost o kompletní data kanálu Žádost o data celého řádku kanálu Žádost o data celého sloupce kanálu Žádost o hodnotu buňky kanálu Žádost o čtení výřezu dat kanálu V příkladu je dotaz na kanál123 ve kterém je pole o rozměru 2 3. Dotaz [{"ch":123}] Odpověď [{"ch":123,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2,3.3],[9,8,7.1]]}] V příkladu je dotaz na řádek 0 kanálu 125, ve kterém je pole o 4 sloupcích. Dotaz [{"ch":125,"row":0}] Odpověď [{"ch":125,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2,3.3,4.4]]}] V příkladu je dotaz na sloupec 10 kanálu 25, který má 3 řádky. Dotaz [{"ch":25,"col":10}] Odpověď [{"ch":25,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1],[2.2],[3.3]]}] V příkladu je dotaz na buňku se souřadnicemi 5. řádek, 3. sloupec kanálu 1290. Dotaz [{"ch":1290,"row":5,"col":3}] Odpověď [{"ch":1290,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1]]}] V příkladu je dotaz na výřez kanálu 57, od řádku 7, sloupce 3, celkem 3 řádky a 2 sloupce (6 hodnot). Dotaz [{"ch":57,"row":7,"col":3,"rows":3,"cols":2}] Odpověď [{"ch":57,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,1.2],[2.1,2.2],[3.1,3.2]]}] 141/153 lookdet_a_g_cz_106
Žádost o kompletní data dvou kanálů V příkladu je dotaz na kanál 123 (rozměru 2 řádky, 3 sloupce), a na kanál 124 (rozměru 2 řádky, 2 sloupce). Dotaz [{"ch":123},{"ch":124}] Odpověď [{"ch":123,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2,3.3],[9,8,7.1]]}, {"ch":124,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2],[2.1,2.2]]}] Data odpovědi jsou vždy v polích po řádcích. Žádost o historická data Dotaz je totožný s parametrem get pro aktuální data, doplněný o následující parametry: from počáteční datum a čas ve formátu rrrr-mm-dd hh:mm:ss to konečný datum a čas ve formátu rrrr-mm-dd hh:mm:ss limit maximální počet řádků na 1 get požadavek V příkladu je dotaz na kompletní data kanálu 123 od 1.1.2014 00:00:00 hodin do 1.1.2014 23:59:59. Dotaz [{"from":"2014-01-01 00:00:00","to":"2014-01-01 23:59:59","limit":1000,"ch":123}] Odpověď Je v podobě CSV souboru ve tvaru: "Time";"Channel";"Row";"Col";"Value" 2014-01-01 00:00:00;123;0;0;11.5 2014-01-01 00:15:07;123;0;0;15.5 2014-01-01 00:31:10;123;0;0;22.2 2014-01-01 00:45:33;123;0;0;19.1 "Working time";-1;-1;-1;0.25 "Call back";-2;-1;-1;cb (parametr cb datového bloku viz kapitola 6.1.5 Tvar datového bloku ) Data jsou seřazena podle času vzorku v rámci jedné části požadavků. Řádek Working time obsahuje ve sloupci Value dobu zpracování dat na serveru. Řádek Call back obsahuje nezměněný parametr cb požadavku viz kapitola 6.1.5 Tvar datového bloku. 6.1.4 Možné varianty put tvar dotazu a odpovědi Zápis jednoho řádku dat do kanálu V příkladu je požadavek na zápis jednoho řádku dat o hodnotách 1, 2, 3, 4 a 5 do kanálu 1 od řádku 3 a sloupce 5. Požadavek [{"ch":1,"row":3,"col":5,"val":[[1,2,3,4,5]]}] Odpověď v případě úspěšného zápisu [{"ch":1,"res":0}] lookdet_a_g_cz_106 142/153
Odpověď v případě neúspěšného zápisu třetí hodnoty [{"ch":1,"res":-1,"dres":[[0,0,x,0,0]]}] X označuje chybový kód zápisu do My SQL databáze. Zápis několika řádků dat do kanálu Zápis bloku dat Zápis do více kanálů současně V příkladu je požadavek na zápis pěti řádků dat o hodnotách 1, 2, 3, 4 a 5 do kanálu 2 od řádku 5 do sloupce 3. Požadavek [{"ch":2,"row":5,"col":3,"val":[[1],[2],[3],[4],[5]]}] Odpověď v případě úspěšného zápisu [{"ch":2,"res":0}] Odpověď v případě neúspěšného zápisu ve čtvrtém řádku [{"ch":2,"res":-1,"dres":[[0],[0],[0],[x],[0]]}] X obsahuje chybový kód My SQL databáze V příkladu je požadavek na zápis pole dat 3 3 do kanálu 3 od řádku a sloupce 0. Požadavek [{"ch":3,"row":0,"col":0,"val":[[1,2,3],[2,2,2],[3,3,3]]}] Odpověď v případě úspěšného zápisu [{"ch":3,"res":0}] Odpověď v případě neúspěšného zápisu ve třetím řádku a druhém sloupci. [{"ch":3,"res":-1,"dres":[[0,0,0],[0,0,0],[0,x,0]]}] X obsahuje chybový kód My SQL databáze. V příkladu je požadavek na zápis stejných dat jako v příkladu 1 a 2, současně v rámci jednoho přenosu. Požadavek [{"ch":1,"row":3,"col":5,"val":[[1,2,3,4,5]]},{"ch":2,"row":5,"col":3,"val":[[1],[2],[3], [4],[5]]}] Odpověď v případě úspěšného zápisu [{"ch":1,"res":0},{"ch":2,"res":0}] Odpověď v případě neúspěšného zápisu třetí hodnoty. Kanál 2 je v pořádku uložen. [{"ch":1,"res":-1,"dres":[[0,0,x,0,0]]},,{"ch":2,"res":0}] X označuje chybový kód zápisu do My SQL databáze. 6.1.5 Tvar datového bloku Datový blok obsahuje parametr cb, který je beze změny předán v odpovědi pro kontrolu (například časová značka, nebo jiný identifikátor dotazujícího se klienta). Datový blok může obsahovat pouze get, pouze put, nebo get i put požadavky. 143/153 lookdet_a_g_cz_106
Příklad datového bloku Příklad načtení celého obsahu kanálů 123 a 124 a současně zápisu 5 hodnot do kanálu 1. { "cb":"iddotazu", get :[{"ch":123},{"ch":124}], put :[{"ch":1,"row":3,"col":5,"val":[[1,2,3,4,5]]}] } 6.1.6 Šifrování Tvar odpovědi { "cb":"iddotazu", get :[{"ch":123,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2,3.3],[9,8,7.1]]}, {"ch":124,"time": RRRR-MM-DD hh:mm:ss,"val":[[1.1,2.2],[2.1,2.2]]} ], put :[{"ch":1,"res":0}] } Vzhledem k tomu, že mohou být data vizualizace citlivá, byla zvolena jednoduchá metoda šifrování algoritmem AES. Datový blok je zašifrován MD5 otiskem hesla, které bylo zadáno v parametrech lokality. V případě bezpečné lokální sítě, nebo při využití protokolu https, je možno použít komunikaci nešifrovanou. Nešifrovaná komunikace bude použita v případě, kdy bude v hlavičce dotazu uvedeno heslo lokality viz výše. Příklad přípravy dat v PHP // datová část $zad='{"cb":"iddotazu","get":[{"ch":27}],"put":[{"ch":28,"row":0,"col":0,"val":[[1,2,3,4,5]]}]}'; // šifrování a převod na HEX (pokud je vyžadováno šifrování) $data=bin2hex(mcrypt_encrypt(mcrypt_rijndael_128,md5('heslo LOKALITY'),$zad, MCRYPT_MODE_ECB)); // výsledný požadavek pro POST/GET... šifrovaný {"idloc":2,"dataver":1,"data": '.$data.'"} // výsledný požadavek pro POST/GET... nešifrovaný {"idloc":2,"dataver":1,"heslo":"heslo LOKALITY","data":"'.$zad.'"} // použití GET se šifrováním https://wwwlookdetu/post.php?data={"idloc":2,"dataver":1,"data": '.$data.'"} // použití GET bez šifrování https://wwwlookdetu/post.php?data={"idloc":2,"dataver":1,"heslo":"heslo LOKALITY","data":"'.$zad.'"} Dešifrování odpovědi // získaná odpověď { "OK":1,"data":"ZAŠIFROVANÝ DATOVÝ BLOK" } // dešifrování odpovědi $data=trim(mcrypt_decrypt(mcrypt_rijndael_128,md5(heslo LOKALITY),pack('H*',$data->data),MCRYPT_MODE_ECB )); lookdet_a_g_cz_106 144/153
6.1.7 Chybové zprávy // $data obsahuje NULL při chybě dekódování, nebo objekt ve tvaru výše $data = json_decode( $data ); Hlavička odpovědi obsahuje parametr OK. Pokud má hodnotu 1, je odpověď v pořádku. Pokud ne, obsahuje parametr ERR s popisem chyby. Například: {"OK":0,"ERR":"Wrong data format #2!"} Seznam chybových hlášení: Hlášení Wrong data format #1! Wrong data format #2! Wrong parameter #1! Wrong password! Popis Nelze rozložit zaslaná JSON data (chybný formát základních dat). Neplatný tvar datové oblasti, nebo se nepodařilo datovou oblast dešifrovat (špatné heslo?). Neplatné číslo lokality, nebo není možné získat z databáze šifrovací heslo. Při nešifrované komunikaci bylo použito neplatné heslo lokality. 145/153 lookdet_a_g_cz_106
7 Dodatek C 7.1 M-Bus TCP (UDP) Dispečerský systém umožňuje, mimo jiné, také komunikaci prostřednictvím M-Bus paketů, které jsou zapouzdřeny do ethernetových TCP nebo UDP rámců. Tím je možné vyčítat vybraná data z měřičů, komunikujících protokolem M-Bus, připojených k převodníku DM-MB2ET (DM-DI4MB2ET) z produkce firmy AMiT. Pří využití komunikace pomocí M-Bus TCP (UDP) je nutné aktivovat systémový komunikační ovladač protokolu M-Bus. Ovladač může aktivovat / deaktivovat pouze globální administrátor. Obr. 144 M-Bus ovladač ve správci ovladačů Každý převodník je nutné nadefinovat jako samostatnou stanici v sekci Stanice. Při definici je nutné zvolit jednu z následujících voleb: M-Bus TCP komunikace, M-Bus UDP komunikace. lookdet_a_g_cz_106 146/153
Obr. 145 Nastavení stanice pro komunikaci M-Bus TCP Další práce se stanicí probíhá stejně, jak je popsáno v kapitole 3.4 Správa stanic. Oproti stanici typu AMiT je zde však nutné nastavit parametr Komunikační rychlost. Prostřednictvím tohoto parametru umožňuje systém LookDet dva způsoby práce s komunikační rychlostí v síti M-Bus. Vynucená komunikační rychlost Pokud je za parametr Komunikační rychlost zadána podporovaná rychlost systémem LookDet, je snaha o vynucení této rychlosti také v síti M-Bus. Systém LookDet před vlastním vyčtením dat zašle do sítě M-Bus komunikační rámec, kterým dle specifikace M-Bus zadá příkaz všem stanicím pro nastavení požadované rychlosti. S touto rychlostí pak bude snaha o komunikaci v síti M-Bus. Podporované rychlosti jsou: 300 bps, 600 bps, 1200 bps, 2400 bps, 4800 bps, 9600 bps, 19200 bps a 38400 bps. Pozor Pro správnou funkčnost musí být rychlost, nastavená v parametru Komunikační rychlost, shodná s rychlostí, nastavenou na převodníku DM-MB2ET (DM-DI4MB2ET) a stanice připojené k převodníku musí tuto rychlost podporovat. Pevná komunikační rychlost Pokud je za parametr Komunikační rychlost zadána hodnota 0, není systémem LookDet komunikační rychlost v síti M-Bus nijak ovlivňována. Pozor Pro správnou funkčnost musí být shodně nastavená rychlost na všech stanicích v síti M-Bus, včetně převodníku DM-MB2ET (DM-DI4MB2ET). 147/153 lookdet_a_g_cz_106
7.1.1 Získání dat Převodníky DM-MB2ET (DM-DI4MB2ET) neumí aktivně zasílat data do systému LookDet. Z toho důvodu se u stanice komunikující pomocí M-Bus TCP (UDP) musí nastavit cyklicky čtené kanály. Postupem, popsaným v kapitole 3.4.2 Editace stávající stanice, sekce Definice cyklického čtení, je nutné vyvolat okno pro definici cyklicky čtených kanálů, ve kterém se nadefinuje vždy jeden kanál pro jeden měřič, připojený k převodníku DM-MB2ET (DM-DI4MB2ET). Obr. 146 Okno pro definici cyklicky čteného kanálu v síti M-Bus TCP (UDP) Význam jednotlivých položek je následující: Popis kanálu uživatelský popis kanálu. Adresa měřiče primární nebo sekundární adresa měřiče v síti M-Bus. Typ adresy typ adresy (primární / sekundární) zadané do pole Adresa měřiče. Kanál na serveru číslo kanálu, ve kterém budou na serveru dostupná data z měřiče. Interval čtení perioda, s jakou se budou data z připojeného převodníku číst (nejkratší možná perioda je 5 s). Příští čtení nastavení času, kdy se mají začít číst data. Čtení aktivní aktivace / deaktivace cyklického čtení vzdálené proměnné. Údaje, zadané cyklicky vyčítanému kanálu, je nutné uložit pomocí tlačítka Uložit. lookdet_a_g_cz_106 148/153
Po definici cyklicky čtených kanálů je nutné je přiřadit ke stanici způsobem popsaným v kapitole 3.5 Správa kanálů. Každý kanál, nadefinovaný pro komunikaci M-Bus TCP (UDP), obsahuje vybrané aktuální hodnoty, poskytované jednotlivými měřiči (archivní data se z příchozích rámců nedekódují). Aktuální data z měřiče jsou dekódována a seřazena do přesně daných sloupců. Uživatel tedy nemusí znát popis protokolu. Obr. 147 Správa M-Bus kanálu Načtené hodnoty jsou v LookDet uchovávány v kanálu, který má standardně 1 řádek a 18 sloupců. Řazení načtených hodnot je uvedeno v tabulce. Sloupec Parametr Popis sloupce Jednotky v LookDet 0 Primární adresa Primary address - 1 Sekundární adresa Secondary address - 2 Výrobní číslo Serial number - 3 Stav měřiče Status - 4 Odebraná energie Energy 1 Wh 5 Odebraná energie Energy 2 kj 6 Proteklé množství Volume l 7 Hmotnost Mass kg 149/153 lookdet_a_g_cz_106
7.1.2 Licence Sloupec Parametr Popis sloupce Jednotky v LookDet 8 Okamžitý výkon Power 1 W 9 Okamžitý výkon Power 2 kj/h 10 Okamžitý průtok Volume Flow 1 l/h 11 Okamžitý průtok Volume Flow 2 l/min 12 Okamžitý průtok Volume Flow 3 ml/s 13 Okamžitý hmotnostní průtok Mass Flow kg/h 14 Přívodní teplota Flow temperature C 15 Vratná teplota Return temperature C 16 Teplotní diference Temperature diference C 17 Tlak Pressure mbar Sloupce s hodnotou, která není zařízením zaslána, zůstávají nevyplněny. Pokud zařízení zasílá např. energii v J, nebude již vyplněn sloupec s jednotkou Wh a naopak. Pokud se některá veličina v obdrženém rámci vyskytuje vícekrát (typicky při použití tarifů), bude její hodnota uložena na dalším řádku (kanál s hodnotami bude v takovém případě víceřádkový). Licence pro počet stanic v síti M-Bus je udávána jako samostatná položka a nijak nesouvisí s počtem stanic pro komunikaci v síti Modbus/TCP či pro komunikaci v systému DB-Net/IP. Pozor Počtem stanic v síti M-Bus se rozumí počet zařízení v síti M-Bus (počet položek definovaných v cyklickém vyčítání). Nejedná se o počet převodníků DM-MB2ET (DM-DI4MB2ET). lookdet_a_g_cz_106 150/153
8 Dodatek D 8.1 Modbus/TCP master Dispečerský systém umožňuje, mimo jiné, také komunikaci prostřednictvím protokolu Modbus/TCP (systém LookDet je v takovém případě Master (klient) v síti Modbus/TCP). Pří využití komunikace pomocí Modbus/TCP je nutné aktivovat systémový komunikační ovladač protokolu Modbus/TCP. Ovladač může aktivovat / deaktivovat pouze globální administrátor. Obr. 148 Modbus/TCP ovladač ve správci ovladačů Jednotlivé Slave stanice (servery) v síti Modbus/TCP je nutné nadefinovat v sekci Stanice, stejně jako stanice AMiT. Při definici je nutné zvolit položku Modbus/TCP komunikace. 151/153 lookdet_a_g_cz_106
Obr. 149 Nastavení stanice pro komunikaci Modbus/TCP 8.1.1 Získání dat Další práce se stanicí probíhá stejně, jak je popsáno v kapitole 3.4 Správa stanic. Jelikož je komunikace v síti Modbus/TCP typu single Master multi Slave, není možné, aby stanice komunikující se systémem LookDet, aktivně zasílala do systému data stejně, jako stanice AMiT. Z toho důvodu se u stanice komunikující pomocí Modbus/TCP musí nastavit cyklicky čtené kanály. Postupem, popsaným v kapitole 3.4.2 Editace stávající stanice, sekce Definice cyklického čtení, je nutné vyvolat okno pro definici cyklicky čtených kanálů, ve kterém se nadefinují, kanály pro čtené / zapisované registry / cívky. lookdet_a_g_cz_106 152/153
Obr. 150 Okno pro definici cyklicky čteného kanálu v síti Modbus/TCP Význam jednotlivých položek je následující: Popis kanálu uživatelský popis kanálu. Typ registru typ dat v síti Modbus/TCP (coils, discrete inputs, holding registers, input registers). Typ dat způsob interpretace dat v registru. Počáteční registr číslo, od kterého začínají data v registru. Počet registrů počet registrů, ve kterých jsou data uložena. Kanál na serveru kanál, ve kterém budou data přístupná v LookDetu. Od řádku na serveru řádek kanálu na serveru, od kterého se budou ukládat přijatí data. Interval čtení perioda, s jakou se budou data z připojené stanice číst (nejkratší možná perioda je 5 s). Příští čtení nastavení času, kdy se mají začít číst data. Čtení aktivní aktivace / deaktivace cyklického čtení vzdálené proměnné. Údaje, zadané cyklicky vyčítanému kanálu, je nutné uložit pomocí tlačítka Uložit. Veškerá další práce s nadefinovanými cyklicky čtenými kanály je stejná jako v případě cyklicky čtených kanálů u stanic typu AMiT. 153/153 lookdet_a_g_cz_106