TrolView Servisní a vizualizační nástroj
Programátorská příručka
Verze 1.13
10.11
TROLVIEW
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) 2006, AMiT, spol. s r. o. AMiT, spol. s r. o. Naskové 3/1100, 150 00 Praha 5, Česká republika tel.: 222 780 100, 222 781 516, 222 782 074 Kollárova 6a, 612 00 Brno, Česká republika tel.: 541 217 220, 549 210 403 Starobělská 13, 700 30 Ostrava, Česká republika tel.: 597 570 306, 597 570 307
File:, Dokument3 Created: 14.1.09 Autor: Václav Krčmář Rev.: 10.11, Doc.ver.:1.0
trolview_ms_cz_113
2/87
TROLVIEW Obsah Obsah....................................................................................3 Historie revizí.........................................................................5 Související dokumentace.......................................................6
1.
Úvod .............................................................................. 7
2.
Práce s prostředím....................................................... 8
2.1. 2.2. 2.3. 2.4.
Nástrojová lišta......................................................................9 Okno Projekt..........................................................................9 Možnosti projektu ................................................................10 Časování .............................................................................11
3.
Communication .......................................................... 12
3.1. 3.1.1 3.1.2 3.1.3 3.2.
Konfigurace sítě ..................................................................12 Info/Status Station ...............................................................13 Info/Status BUS...................................................................14 Info/Status Slave .................................................................15 Komunikační profily a stanice..............................................15
4.
Download programu .................................................. 17
4.1. 4.2. 4.3. 4.4. 4.4.1
Download programu pokud stanice komunikuje ..................18 Download programu pokud stanice nekomunikuje ..............19 Záloha a obnova parametrických proměnných....................20 Datafile Manager .................................................................21 Ovládání Datafile Manageru................................................22
5.
Databáze...................................................................... 25
5.1. 5.1.1 5.1.2
Načtení databáze ................................................................26 Načtení databáze ze stanice ...............................................26 Načtení procesních proměnných ze souboru ......................27
6.
Scény........................................................................... 28
6.1. 6.2. 6.2.1 6.2.2 6.2.3 6.2.4
Parametry scény .................................................................28 Scénické prvky ....................................................................28 Vkládání prvků.....................................................................29 Parametry prvků ..................................................................29 Kopírování scén a prvků (Funkce Copy&Paste)..................30 Klonování scén a prvků (Funkce Clone)..............................32
7.
Prvky............................................................................ 33
7.1. 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.2. 7.2.1 7.2.2 7.2.3
Prvek Inspector ...................................................................33 Vyhledávání proměnných ....................................................34 Použití regulárních výrazů ...................................................35 Aplikační a vnucená banka..................................................36 Změna hodnoty v bankách ..................................................37 Funkce Fit u okna inspektoru ..............................................38 Výběr více položek v okně inspektoru .................................38 Prvek PDO ..........................................................................38 Zobrazení surových dat z CANu..........................................39 Funkce Fit u okna PDO .......................................................40 Výčtový typ u okna PDO......................................................40
3/87
trolview_ms_cz_113
TROLVIEW 7.3. 7.3.1 7.3.2 7.3.3 7.3.4 7.4. 7.4.1 7.4.2 7.4.3 7.5. 7.6. 7.7. 7.7.1 7.8. 7.9. 7.9.1 7.9.2
Prvek Datalogger ................................................................ 42 View – zobrazovací část prvku ........................................... 43 Control – změna parametrů dataloggeru ve stanici ............ 45 Doporučený postup při změně databáze ............................ 47 Synchronní režim Dataloggeru ........................................... 47 Prvek SDL........................................................................... 49 View – zobrazovací část prvku ........................................... 50 Control – změna parametrů SDL ve stanici ........................ 52 Select – Výběr pohledu....................................................... 53 Kompatibilita Datalogger/SDL............................................. 55 Prvek Alarm-inspector......................................................... 55 Prvek AlarmLogger ............................................................. 56 Doporučený postup při změně databáze ............................ 57 Prvek Text........................................................................... 58 Prvek Oscilogram ............................................................... 59 View – zobrazovací část prvku ........................................... 60 Parameters – změna setu vzorkovaných proměnných ....... 61
8.
Systém přístupových práv ........................................ 64
8.1. 8.2. 8.2.1 8.3. 8.3.1
Nastavení práva k editaci proměnné / PDO........................ 65 Časově omezené právo k editaci proměnné / PDO ............ 66 Indikace stavu časového omezení práv .............................. 66 Export a Import nastavení práv........................................... 67 Prodloužení platnosti práv .................................................. 68
9.
Variable browser ........................................................ 70
10.
Další funkce prostředí ............................................... 71
10.1.
Interní FLASH – formátování /zobrazení statusu ................ 71
11.
Formáty čísel .............................................................. 73
11.1. 11.2. 11.3.
Předdefinované formáty...................................................... 73 Vlastní formáty.................................................................... 73 Formát typu IP adresa ........................................................ 75
12.
Klávesové zkratky ...................................................... 76
13.
Servisní nástroje ........................................................ 82
13.1. 13.2. 13.3. 13.4. 13.5. 13.6.
TrolAlarmsLogExportProcess ............................................. 82 TrolDownload...................................................................... 82 TrolCloneDataSet ............................................................... 83 TrolLogger .......................................................................... 83 TrolParameters ................................................................... 85 Comparams - přehled parametrů komunikace.................... 85
14.
FAQ.............................................................................. 87
14.1.
Nahrání aplikace pro CAN8 zařízení do CAN4 ................... 87
trolview_ms_cz_113
4/87
TROLVIEW Historie revizí Jméno dokumentu: trolview_ms_cz_110.pdf Verze 100 101 102 103 104
105
Datum 26.05.2009 26.06.2009 15.07.2009
Změny Nový dokument Synchronizace s verzí 1.0.0.36 programu Kapitola 6.1.4 Kapitola 6.3.1 Revize textu 27.07.2009 Doplnění části Communication Kapitola 6.7 02.09.2009 Aktualizace obrázků Doplnění Dataloggeru čtení od-do Nové kapitoly: 4 Download programu 7.1.5 Funkce Fit u okna inspektoru 7.1.6 Výběr více položek v okně inspektoru 8 Systém přístupových práv 10 Další funkce prostředí Doplněna tabulka horkých kláves 27.10.2009 Nová kapitola - 4.4 Datafile Manager Nové podkapitoly: 8.2.1 Indikace stavu 8.3 Export a Import nastavení práv 7.2.2 Funkce Fit u okna PDO 8.3 Export a Import nastavení práv 7.9 Prvek Oscilogram - rozšíření o nové funkce 7.3 Prvek Datalogger - rozšíření o nové funkce
106 107
01.11.2009 12.11.2009
108 109
26.11.2009 13.01.2009
Aktualizace klávesových zkratek Nová kapitola 13 Servisní nástroje Doplněna kapitola 7.9 Prvek Oscilogram o vyčtení dat navzorkovaných po startu zařízení Nová podkapitola 13.3 TrolCloneDataSet Nové podkapitoly: 7.3.4 Synchronní režim Dataloggeru 8.3.1 Prodloužení platnosti práv Přepracování kapitoly: 8 Systém přístupových práv
110
22.03.2010 Doplněn rozdíl mezi stavy Disconected a
5/87
trolview_ms_cz_113
TROLVIEW Unknown_state (kapitola 3.1) Nová podkapitola: 6.2.3 Kopírování scén a prvků (Funkce Copy&Paste) 6.2.4 Klonování scén a prvků (Funkce Clone) 111
Revize Oscilogram - odložené čtení 30.04.2010 Nové podkapitoly: 7.2.3 Výčtový typ Enum u okna PDO
112
11.3. Formát typu IP adresa 16.08.2010 Doplnění kapitoly 7.7 Prvek AlarmLogger Revize - překlepy
113
8.03.2011
Doplněna kapitola 13.6 o popis formátu 15.03.2011 inifile Nová kapitola 7.4 Prvek SDL 11.10.2011 Nová kapitola 7.5 Kompatibilita Datalogger/SDL Doplněna kapitola 6.2 (SDL) Aktualizace obrázku v kapitole 6.2.1
Příloha: -
Související dokumentace
trolview_ms_cz_113
1)
Knihovna TROL, trol_ms_cz_xxx.pdf
2)
TrolDatGen, příručka troldatgen_ms_cz_xxx.pdf
6/87
programátorská
příručka, uživatele,
TROLVIEW
1.
Úvod TrolView je servisní a vizualizační nástroj určený k ladění aplikací psaných pod knihovnou TROL. Umožňuje do řídicí jednotky nahrát novou aplikaci, číst a editovat jak hodnoty procesních proměnných, tak PDO sloužících pro komunikaci po CAN sběrnici. Nabízí též přístup k systému alarmů a údajům, které o aplikaci poskytuje datalogger.
7/87
trolview_ms_cz_113
TROLVIEW
2.
Práce s prostředím
Obr. 1 - Úvodní obrazovka po založení projektu
Hlavní části prostředí
Hlavní nabídka – umožňuje přístup k většině funkcí programu Nástrojová lišta – obsahuje ikony se zkratkami k jednotlivým funkcím Pracovní okno – okno pro editaci jednotlivých scén a databáze. Databáze/každá scéna se otevírá ve vlastní záložce. Mezi záložkami lze přepínat kliknutím nebo klávesovou zkratkou Ctrl+PageDown / Ctrl+PageUp okno Projekt – udržuje strukturu projektu a umožňuje přístup k jednotlivým částem projektu Stavový řádek – zobrazují se v něm podrobnosti o prováděné činnosti. Indikace přihlášeného uživatele – zobrazuje údaj o úrovni oprávnění, které má aktuálně přihlášený uživatel (admin/service/user)
trolview_ms_cz_113
8/87
TROLVIEW
2.1.
Nástrojová lišta
Obr. 2 - Nástrojová líšta Aktivní komunikační profil – výběr předdefinovaných komunikačních profilů
jednoho
z
Spustit/Zastavit komunikaci - spustí/zastaví komunikaci dle aktivního komunikačního profilu Spustit proces(y) – provede jedno spuštění povolených procesů – definováno v Communication (k dispozici pouze v ladícím režimu) Přihlášení uživatele – vytvoření/přihlášení/odhlášení uživatele
funkce
pro
Načíst databázi ze stanice – načte seznam procesních proměnných ze stanice nadefinované v aktivním profilu Načíst databázi ze souboru – otevře dialog pro výběr textového souboru se seznamem procesních proměnných Přenést program do stanice – nahraje aplikaci (.bin) do připojené stanice
2.2.
Okno Projekt Okno Projekt udržuje pohromadě ve stromové struktuře základní stavbu projektu. Projekt v TrolView se skládá z komunikačních profilů, databáze (seznamu procesních proměnných, seznamu PDO) a scén. V záhlaví Okna Projekt se nachází několik ikon, kterým jsou přiřazeny různé funkce a to vždy podle toho, která položka v okně je vybrána. K dispozici jsou funkce dle následujícího obrázku.
9/87
trolview_ms_cz_113
TROLVIEW
Obr. 3 - Záhlaví okna Projekt – dostupné funkce Pozn.: Ve stromu projektu je možné profily, stanice, scény a scénické prvky přejmenovávat buď kliknutím nebo stiskem klávesy F2 na aktivním uzlu (je v modrém rámečku) . Jména jednotlivých profilů, stanic, scén i scénických prvků mohou být duplicitní Na uzlech v okně projekt lze vyvolávat kontextové nabídky s dalšími funkcemi TrolView. Funkce Klonování a Kopírování jsou podrobněji popsány v kapitole 6.
2.3.
Možnosti projektu Možnosti projektu se otvírají kontextové menu (Options) nad uzlem Projekt nebo z hlavního menu volbou Projekt/Options. V dialogu se globálně nastavuje formát zobrazení reálných čísel (Float number format), data (Date format), času (Time format), a globální časování (Timing) v rámci celého projektu.
Obr. 4 - Dialogové okno Možnosti projektu
trolview_ms_cz_113
10/87
TROLVIEW Bližší informace o formátu zobrazení čísel je popsán v kapitole Formáty čísel. Volba „Enable edit param application value“ upravuje editaci hodnoty Param proměnných v režimu aplikační banky. Banky a práce s nimy jsou podrobněji probrány v kapitole 7.1.3 Aplikační a vnucená banka a 7.1.4 Změna hodnoty v bankách.
2.4.
Časování Program TrolView umožňuje zvolit vlastní periodu obnovování každého datového prvku. Tato vlastnost je k dispozici zejména kvůli možnosti lépe rozložit výkon řídicího systému a kapacitu komunikační linky. Některé procesní proměnné nemusí být přenášeny tak často jako jiné a je jen na uživateli, aby rozhodl, které proměnné jsou časově kritické a které ne. V programu existují tři úrovně nastavení periody časování. Tou nejvyšší je nastavení časování celého projektu, které se nastavuje v dialogu otvíraném z menu volbou Projekt/Options. Zde nastavený čas je implicitně používán pro všechny scény a komponenty (viz Obr. 4 - – parametr Timing). Druhou úrovní je nastavení časování scény, které se týká pouze této scény a jejich komponent (viz kapitola 6.1 Parametry scény). Třetí úrovní je nastavení časování komponenty, které se týká jen a pouze konkrétní komponenty (viz kapitola 6.2.2 Parametry prvků) Pozn.: Citlivé nastavení period obnovování jednotlivých prvků a scén může zefektivnit komunikaci a pomoci při zobrazování časově kritických proměnných. Pokud ovšem dojde k nevhodnému nastavení časování, může dojít k tomu, že některé proměnné se nestihnou přenést v požadovaných intervalech. V nejhorším případě může dojít k zahlcení komunikační linky požadavky a rozpadu celé komunikace.
11/87
trolview_ms_cz_113
TROLVIEW
3.
Communication Sekce Communication obsahuje definici komunikačních profilů, informace o konfiguraci CAN sítě a stavu jednotlivých prvků sítě (Master, Slave).
3.1.
Konfigurace sítě Dialogové okno poskytuje informace o připojené CAN síti. ♦ informace o stavu a konfiguraci Master jednotky (Station) ♦ informace o stavu jednotlivých CAN sběrnic (BUSX) ♦ informace o stavu a nastavení definovaných Slave jednotek (dle názvu, který je volen v TrolDatGen)
Obr. 5 - Stav CAN sítě Na první pohled zřetelnou informací je stav, ve kterém se prvky sítě nacházejí, který je indikován ikonou před názvem sběrnice/jednotky. Možné jsou následující stavy a jim odpovídající ikony ♦ Disconected ♦ Connecting ♦ Preparing ♦ Stopped ♦ Operational ♦ Pre_operational ♦ Unknown_state
trolview_ms_cz_113
12/87
TROLVIEW Další informace lze získat po rozbalení příslušného uzlu před Info/Status před názvem prvku sítě. Pro zobrazení některých dat musí být v master jednotce nahrána aplikace. Disconected
Je stav, kdy aplikace přerušila veškerou komunikaci se slave (včetně heartbeat), takže stav slave není známý. Aplikace se o obnovení komunikace nesnaží.
Uknown_state
Vlivem závady v CAN komunikaci není přenášen heatbeat, tudíž neznáme stav slave. Tento stav je způsoben vnějšími vlivy (chybou). Aplikace se snaží obnovit komunikaci. V případě, že se Uknown_state objevuje během komunikace náhodně, může být příčinou nastavení příliš dlouhé periody pro heartbeat.
Ostatní stavy
3.1.1
Ostatní stavy odpovídají definici dle CANopen.
Info/Status Station
Obr. 6 - Info/Status Master jednotky Application – verze aplikace v master jednotce Library – verze knihovny TROL Comunication Interface – verze firmware komunikačního procesoru Time – systémový čas master jednotky
13/87
trolview_ms_cz_113
TROLVIEW Temperature [C] – teplota uvnitř zařízení Battery [V] – napětí zálohovací baterie Baterry low limit [V] – napětí, při kterém je nutná výměna zálohovací baterie CAN master – stav master jednotky Power drop-out – indikuje, zda nastal pokles napájecího napětí pod minimální hodnotu MAC address – MAC adresa master jednotky DHCP config – nastavení konfigurace přes DHCP IP Address – IP adresa master jednotky Net mask – nastavená maska podsítě master jednotky Default gateway – nastavená výchozí brána master jednotky Ethernet – indikace připojení do sítě Ethernet Connection X – porty, které jsou aplikací otevřeny pro komunikaci Open: číslo portu TX – počet odeslaných / zahozených rámců RX – počet přijatých / zahozených rámců
3.1.2
Info/Status BUS
K dispozici jsou parametry: Speed [kbit/s] – komunikační rychlost sběrnice Period [ms] – perioda zasílání Heartbeat rámců Lifetime [ms] – počet nepřijatých heartbeat rámců, po kterých je nahlášena chyba slave SDO timeout [ms] – timeout SDO komunikace Sync period [ms] – perioda vysílání rámce Sync Timestamp period [ms] – perioda vysílání rámce Timestamp
trolview_ms_cz_113
14/87
TROLVIEW RunTime [ms] – minimální prodleva mezi dvěma rámci NMT control CAN BUS – stav CAN sběrnice
3.1.3
Info/Status Slave
K dispozici jsou parametry: Node ID – Node ID Slave jednotky Mode – typ komunikace Heartbeat Boot time [ms] – doba odložení inicializace slave jednotky Config done – indikuje, zda byla ukončena konfigurace Slave CAN mode – stav Slave jednotky SDO active – informace o aktivní SDO komunikaci Config automat – interní proměnná firmy AMiT Config count – interní proměnná firmy AMiT Config PDO – interní proměnná firmy AMiT
3.2.
Komunikační profily a stanice Systém komunikačních profilů umožňuje definovat a rychle měnit nastavení parametrů komunikace s různými stanicemi. Profil, který je právě používán, se nazývá Aktivní. Jeho jméno je zobrazeno v rolovací nabídce na Nástrojové liště. Zde je také možné vybírat, který z vytvořených profilů bude aktivní (druhou možností je kontextová nabídka vyvolaná nad jménem profilu v okně Projekt). K dispozici je připojení přes sériovou linku (COM) a Ethernet (změna přepínačem Connection type). Oba typy komunikace obsahují volbu jména (Name), pod kterým bude profil zobrazen v okně Projekt. Číslo stanice nemá v současných verzích význam a ponechává se původní hodnota připojené stanice (Station number).
15/87
trolview_ms_cz_113
TROLVIEW
Obr. 7 - Nastavení komunikace – sériová linka Při volbě komunikace přes sériovou linku je dále možné zvolit číslo portu (COM) a komunikační rychlost (Speed). Aktuální nastavení
Komunikační rychlost je třeba nastavit na 38400 a port dle přiřazení USB-serial portu ve Windows (Nastavení/Ovládací panely/Systém).
Obr. 8 - Nastavení komunikace - Ethernet Při komunikaci přes Ethernet pak volíme IP adresu (IP address). UDP port musí být 1001 a timeout ponecháváme na implicitní hodnotě.
trolview_ms_cz_113
16/87
TROLVIEW
4.
Download programu Pro nahrání programu do stanice slouží dialog Download program to station, které vyvoláme kliknutím na ikonu
či z Hlavní nabídky Project/Data/Download program.
Obr. 9 - Dialog Download program to station Sekce Station info poskytuje informace o připojené stanici: Application – verze programu ve stanici, Library – verze knihovny TROL Zobrazení informací je podmíněno navázáním komunikace se stanicí. Pokud komunikace navázána není, zobrazí se počítadlo pokusů o navázání komunikace.
Obr. 10 - Chyba při komunikaci se stanicí
17/87
trolview_ms_cz_113
TROLVIEW Sekce File information zobrazuje velikost, datum a čas buildu programu, který se do stanice chystáme nahrát (pokud je zadána cesta k souboru .bin). Důležitou funkcí je možnost zálohování a obnovy parametrických proměnných při nahrávání programu – Backup and restore param variables. Této funkci je věnována kapitola 4.3 Záloha a obnova parametrických proměnných. Pro zrychlení práce v případě nutnosti návratu k minulé verzi programu slouží funkce Download recent program, která je opět k dispozici v Hlavní nabídce Project/Data/Download recent program a provede nahrání programu z posledního použitého umístění.
4.1.
Download programu pokud stanice komunikuje Postup při nahráváni nového programu v případě, že stanice komunikuje, je následující: ♦ vybereme umístění zdrojového souboru s programem (Program file) ♦ provedeme úpravu volby Backup and restore param. varaibles ♦ odstartujeme nahrávání stiskem tlačítka OK Po stisku tlačítka OK dojde k zobrazení dialogového okna, které bude indikovat průběh nahrávání programu.
Obr. 11 - Úspěšné nahrání programu do stanice Po úspěšném nahrání programu (Download successfully completed) lze dialog ukončit stiskem tlačítka OK.
trolview_ms_cz_113
18/87
TROLVIEW
4.2.
Download programu pokud stanice nekomunikuje Pokud se stanice z nějakého důvodu nachází v chybovém stavu, ve kterém s TrolView nekomunikuje a program nelze nahrát standardní cestou (tlačítko OK je po výběru zdrojového souboru zašedlé), je třeba před nahráváním vypnout funkci čtení stavových informací – Reading information.
Obr. 12 - Vypnutí automatického čtení informací Výše popsaný postup je funkční pouze pokud je správně nastavena komunikace se stanicí! Další postup nahrávání programu je shodný s nahráváním v případě, že stanice komunikuje. Uknown error při nahrávání programu
Problém může nastat také v případě, že předchozí nahrávání nebylo dokončeno úspěšně (např. při výpadku napájení stanice). Při pokusu nahrát v této situaci program se zaškrtnutou možností “Backup and restore param variables“ je indikována chyba – Communication error: unknown error!
19/87
trolview_ms_cz_113
TROLVIEW
Obr. 13 - Nahrání programu bez zálohy parametrických proměnných Řešením je zrušit před nahráváním zaškrtnutí výše zmíněné volby a parametrické proměnné po úspěšném nahrání programu obnovit dle postupu v následující kapitole.
4.3.
Záloha a obnova parametrických proměnných
Záloha parametrických proměnných
Při zaškrtnutí volby “Backup and restore param variables“ dojde při nahrávání programu (před smazáním paměti FLASH ve stanici) k zálohování hodnot parametrických proměnných do souboru, který se automaticky vytvoří v adresáři projektu. Jméno souboru bude odpovídat formátu: <jménoprojektu>.download<číslo>.tvdw. V případě úspěšného nahrání programu bude z tohoto souboru provedena obnova parametrických proměnných a soubor bude smazán. Pokud však dojde během nahrávání programu k chybě, zůstane soubor zachován a hodnoty parametrických proměnných tak bude možné v budoucnu obnovit.
Obnova parametrických proměnných
Pro obnovu parametrických proměnných slouží funkce Write variables from file, která se nachází v Hlavní nabídce Project/Data/Write variables from file. V zobrazeném dialogovém okně je třeba určit z jakého souboru (.tvwd) se bude obnova provádět a tlačítkem Otevřít spustit nahrávání.
trolview_ms_cz_113
20/87
TROLVIEW
Obr. 14 - Obnova parametrických proměnných Po úspěšném nahrání proměnných (Write variables from file successfully done.) lze dialog ukončit stiskem tlačítka OK. Hodnoty parametrických proměnných jsou nyní obnoveny. Ke správě a editaci souborů .tvwd je určena součást TrolView Datafile Manager.
4.4.
Datafile Manager Datafile Manager slouží k tvorbě a editaci souborů hodnot proměnných .tvwd. Datafile Manager se spouští Window/Tools/Datafile Manager.
v Hlavní
nabídce
Editovat lze v Datafile manageru pouze hodnotu proměnné (Value). Další údaje o proměnné jsou pouze informačního charakteru.
21/87
trolview_ms_cz_113
TROLVIEW
Obr. 15 - Datafile manager Pokud načtený datafile obsahuje proměnné, které nejsou v databázi, jsou označeny ikonkou v prvním sloupci tabulky – viz následující obrázek.
Obr. 16 - Označení proměnných, které nejsou v databázi
4.4.1
Ovládání Datafile Manageru
Open datafile
Načte datafile uložený na disku. Načíst lze nejen soubory, které obsahují databázi shodnou s databází ve stanici, ale i soubory, jejichž databáze je rozdílná.
New datafile
Vytvoří nový datafile. Pokud byl před stiskem tlačítka otevřen datafile a byly v něm provedeny změny, zobrazí se dotaz na uložení provedených změn. Poté budou ze zobrazeného seznamu odstraněny proměnné, které nejsou přítomny v databázi, se kterou pracuje projekt. Všechny zobrazené proměnné budou neoznačeny.
trolview_ms_cz_113
22/87
TROLVIEW Save datafile /
Uloží provedené změny. Obsah k ukládání indikuje modrá barva ikony. Změna hodnoty se uloží pouze u proměnných, které mají před jménem zaškrtnutý checkbox!
Třídění zobrazených proměnných
– zobrazí proměnné třídy Normal – zobrazí proměnné třídy Retain – zobrazí proměnné třídy Param – zobrazí pouze označené proměnné
Označování proměnných
– označí všechny zobrazené proměnné – odznačí všechny zobrazené proměnné
Filtr proměnných Načtení hodnoty proměnných ze stanice
– filtr proměnných dle jména – načte ze stanice hodnoty označených proměnných (nezávisle na tom, zda jsou zobrazeny) Označené proměnné, které nejsou součástí databáze, svou hodnotu nezmění. Po načtení hodnot ze stanice bude však jejich hodnota zvýrazněna červenou barvou.
Obr. 17 - Načtení hodnot proměnných, které nejsou ve stanici V pravé dolní části obrazovky je k dispozici indikace počtu označených proměnných.
Obr. 18 - Indikace označených proměnných
23/87
trolview_ms_cz_113
TROLVIEW V levé části pak umístění a název souboru, se kterým Datafile Manager právě pracuje.
trolview_ms_cz_113
24/87
TROLVIEW
5.
Databáze Otevření Database/Variables nebo Database/PDO z okna Projekt získáme seznam procesních proměnných/PDO, které jsou v projektu načteny. Po založení nového projektu je tento seznam prázdný.
Procesní proměnné
Procesní proměnné zobrazené v seznamu jsou vázány na konkrétní aplikaci, proto nelze upravovat jejich jména, ani měnit jejich typ.
Obr. 19 - Databáze – okno Variables V seznamu proměnných lze dále získat informaci o třídě (N – Normal, R – Retain, P – Param) a přístupových právech k proměnné. Přístupovým právům se podrobněji věnuje kapitola 8 Systém přístupových práv. PDO
Také PDO v seznamu jsou vázány na konkrétní aplikaci, proto nelze upravovat jejich jména, ani měnit Lokaci.
25/87
trolview_ms_cz_113
TROLVIEW Obr. 20 - Databáze – okno PDO Pokud některé z načtených PDO obsahuje definované bitové skupiny, zobrazí se u jeho jména symbol +, kterým lze zobrazit podrobnější informace o bitových skupinách – jejich jména a bitový rozsah.
Obr. 21 - Podrobnější informace o PDO Stejně jako u proměnných je i pro každou bitovou skupinu možnost nastavit přístupová práva. Přístupovým právům se podrobněji věnuje kapitola 8 Systém přístupových práv.
5.1.
Načtení databáze K načtení databáze slouží ikony Read database from station nebo Read database from file (resp. projektu TrolDatGen) na Nástrojové liště. Nelze načíst samostatně pouze procesní proměnné nebo PDO. Použitím této funkce dojde k načtení jak proměnných, tak PDO z připojené stanice.
5.1.1
Načtení databáze ze stanice Možné stavy komunikace v průběhu načítání databáze ilustrují následující obrázky.
Obr. 22 - Načtení databáze – inicializace
trolview_ms_cz_113
26/87
TROLVIEW
Obr. 23 - Načtení databáze – chyba komunikace
Obr. 24 - Načtení databáze – úspěšné načítání databáze
5.1.2
Načtení procesních proměnných ze souboru Po výběru načtení databáze ze souboru je zobrazeno dialogové okno, ve kterém zvolíme umístění projektu TrolDatGen ( soubor s koncovkou .tdg). Stiskem tlačítka Otevřít dojde k vlastnímu načtení databáze.
Obr. 25 - Úspěšné načtení databáze ze souboru
27/87
trolview_ms_cz_113
TROLVIEW
6.
Scény Každou ze scén si lze představit jako volnou pracovní plochu o rozměrech, které odpovídají rozměrům okna. Na scénu lze vkládat různé předdefinované vizualizační prvky. Při práci s programem je možné mít otevřeno více scén v jednom okamžiku a libovolně se mezi nimi přepínat. Takto je možné mít pod kontrolou velké množství různých prvků – hodnot proměnných, stavů… Scény je možno libovolně vytvářet, zobrazovat, měnit jejich jména, duplikovat je, schovávat, mazat. Všechny tyto úkony jsou přístupné jak z kontextové nabídky vyvolané stiskem pravého tlačítka myši na příslušné scéně v okně Projekt, tak pomocí ikon v záhlaví okna projekt a v neposlední řadě pomocí klávesových zkratek.
6.1.
Parametry scény Dialogové okno pro editaci parametrů scény je možné vyvolat z kontextové nabídky vyvolané stiskem pravého tlačítka myši na názvu příslušné scény ve stromu projektu a výběrem Edit scene. Další možnosti jsou stisk příslušné ikony v záhlaví okna projektu nebo pomocí klávesové zkratky Ctrl+Enter na vybrané scéně. V dialogovém okně je možno ve třech záložkách měnit parametry scény: ♦ jméno scény (záložka Name) ♦ periodu vyčítání dat z prvků (záložka Parameters) ♦ formát zobrazení float hodnot, data a času (záložka Parameters) 1 ♦ vlastnosti pozadí scény (záložka Background)
6.2.
Scénické prvky Na každou scénu je možné vložit libovolné množství scénických prvků. K dispozici jsou tyto scénické prvky: ♦ Alarm-Inspektor – zobrazení stavů alarmů v aplikaci ♦ AlarmLogger – zobrazení historie alarmů z flash paměti ♦ DataLogger – zobrazení archivovaných dat (starší typ dataloggeru) ♦ Inspektor – zobrazení a editace procesních proměnných ♦ Oscilogram – zaznamenání hodnot proměnných v reálném čase ♦ PDO – zobrazení a editace hodnot přenášených v PDO 1
Bližší informace o formátu zobrazení čísel je popsán v kapitole Formáty čísel.
trolview_ms_cz_113
28/87
TROLVIEW ♦ SDL – zobrazení archivovaných dataloggeru) ♦ Text – textový popisek
dat
(novější
typ
Aby TrolView vyčítal data ze stanice a scénické prvky zobrazovaly platné hodnoty, je nutné spustit komunikaci. Komunikace vždy běží s parametry nastavenými v aktivním profilu.
6.2.1
Vkládání prvků Prvky lze nejpohodlněji do scén vkládat z kontextové nabídky, vyvolané nad volnou plochou scény pravým tlačítkem myši.
Obr. 26 - Kontextové menu – přidání nového prvku Scény
6.2.2
Parametry prvků Parametry prvků lze editovat v dialogovém okně (obdoba dialogového okna pro scény), které se spouští ihned po vložení prvku na scénu. V zobrazeném okně je možno ve třech záložkách měnit následující parametry: ♦ jméno prvku (záložka Name) ♦ periodu vyčítání dat z prvku (záložka Parameters) ♦ formát zobrazení hodnot (záložka Parameters) 2 ♦ umístění prvku (záložka Location) Stejné editační dialogové okno lze vyvolat též kdykoliv později poklepáním na titulek prvku (případně přímo na prvek, pokud titulek nemá), volbou Edit z kontextového menu pravého tlačítka nad prvkem na scéně nebo v okně Projekt.
2
Bližší informace o formátu zobrazení čísel je popsán v kapitole Formáty čísel.
29/87
trolview_ms_cz_113
TROLVIEW Časování
V záložce Parameters je možné změnit periodu obnovování procesních proměnných na vlastní hodnotu. Pozn.: Je nutno pamatovat, že malá perioda komunikace (zvláště při větším počtu proměnných) může vést k neúměrné zátěži řídicího systému a komunikační linky.
Umístění prvku
V záložce Location lze měnit pozici prvku na scéně a velikost (celého prvku, šířku a výšku sloupců, atd). Pokud je zadaná velikost prvku 0,0, prvek se přizpůsobuje svému obsahu. (Prvek Inspektor přizpůsobuje výšku počtu zobrazovaných proměnných a šířku délce dat, prvky obsahující grafy mají přednastavenou velikost, atd.) Pozn.: Pokud se stane, že je prvek při tažení za lištu umístěn za okraj scény, ve vlastnostech prvku je možno zadat novou pozici.
6.2.3
Kopírování scén a prvků (Funkce Copy&Paste)
Funkce Copy
Použitím funkce Copy zkopírujeme vybraný objekt (scénu, prvek), na kterém tuto funkci vyvoláme, do schránky. Existuje více způsobů, kterými lze tyto funkce vyvolat: • z kontextového menu pravého tlačítka nad kopírovanou scénou/prvkem v okně Projekt • z kontextového menu nad prázdnou pracovní plochou otevřené scény/prvkem ve scéně • ikonou v záhlaví okna Projekt (viz kapitola 2.2 Okno Projekt); funkce bude provedena na položku, která je vybrána v okně Projekt
Obr. 27 - Kontextová nabídka funkce Copy pro scénu a prvek v okně Projekt Funkce Paste
trolview_ms_cz_113
Opakem kopírování je vložení zkopírovaného objektu, pro které slouží funkce Paste.
30/87
TROLVIEW Vkládáme-li prvek, modifikuje se název funkce v kontextovém menu na „Paste (název prvku)“ a je nutné ji vyvolávat nad scénou, do které ho chceme vložit, v okně Projekt. Druhou možností je vyvolání nad prázdnou pracovní plochou scény. Vkládáme-li scénu, je nutné funkci vyvolat nad uzlem Scenes. Použití klávesových zkratek
Pro kopírování a vkládání je možné využít též standardní klávesové zkratky Ctrl+C a Ctrl+V. Klávesové zkratky lze uplatit pouze pro práci v okně Projekt. Důležité je místo, na kterém je klávesová zkratka stisknuta – viz následující dva obrázky.
Obr. 28 - Použití klávesových zkratek pro kopírování a vkládání prvků
31/87
trolview_ms_cz_113
TROLVIEW Obr. 29 - Použití klávesových zkratek pro kopírování a vkládání scén
6.2.4
Klonování scén a prvků (Funkce Clone) Funkce klonování scén/prvků je určena pro replikaci scén či prvků v rámci jednoho projektu. Při klonováním scény dojde k vložení „klonu“ (stejné scény se jménem SceneX – kde X bude nejnižší volný index). Pokud bude klonován prvek, bude vložen do vybrané scény prvek stejných parametrů. Stejně jako v případě kopírování existuje více způsobů, kterými lze tyto funkce vyvolat: • z kontextového menu pravého tlačítka nad scénou/prvkem v okně Projekt • z kontextového menu nad prázdnou pracovní plochou otevřené scény/prvkem ve scéně • ikonou v záhlaví okna Projekt (viz kapitola 2.2 Okno Projekt); funkce bude provedena na položku, která je vybrána v okně Projekt
trolview_ms_cz_113
32/87
TROLVIEW
7.
Prvky V následující kapitole jsou popsány prvky, které je možné používat ve scénách. Obecné vlastnosti všech prvků byly popsány v předcházející kapitole.
7.1.
Prvek Inspector Scénický prvek Inspector slouží k zobrazení a editaci hodnot procesních proměnných. Zobrazované proměnné se volí v parametrech prvku na záložce Variables.
Obr. 30 - Editace parametrů prvku Inspektor – Variables K dispozici jsou funkce: ♦ editace proměnné (Edit variable) ♦ přidání jedné proměnné (Add new variable) ♦ přidání více proměnných (Add new variables) ♦ přidání proměnných ze zdrojového souboru (Add variable(s) from C-source ♦ kopírování proměnné (Copy variable) ♦ smazání proměnné (Delete variable) ♦ posun proměnné v seznamu (Move variable one line up/down) Přidání proměnné
Funkce Add new variable zobrazí dialog pro přidání jedné proměnné.
33/87
trolview_ms_cz_113
TROLVIEW
Obr. 31 - Inspektor – vložení proměnné Pro hromadné vkládání proměnných je vhodnější funkce Add new variables. Proměnné označené check-boxem jsou po stisku OK vloženy do seznamu zobrazených.
Obr. 32 - Inspektor – hromadné vložení proměnných Proměnné lze také do okna Inspector přidávat ze zdrojového souboru. V tomto případě jsou v zadaném souboru vyhledány všechny výskyty řetězců db_Get_name a db_Put_name jsou vloženy do prvku. Funkce má význam „ukaž všechny proměnné, které jsou použity v tomto souboru“.
7.1.1
Vyhledávání proměnných
Filtr jmen proměnných
trolview_ms_cz_113
Pro zvýšení přehlednosti a zlepšení orientace v seznamu proměnných je k dispozici funkce filtru, která umožňuje redukci počtu nabízených proměnných na základě regulárního výrazu (viz další kapitola).
34/87
TROLVIEW
Obr. 33 - Inspektor – filtr Filtr je přístupný klávesovou zkratkou Ctrl+F v dialogovém okně ♦ vložení jedné proměnné (Obr. 31 - Inspektor – vložení proměnné) po stisknutí tlačítka ♦ hromadné vkládání proměnných (Obr. 32 - Inspektor – hromadné vložení proměnných)
7.1.2
Použití regulárních výrazů Při hledání proměnné lze využít tzv. regulární výrazy. Následuje krátký přehled s příklady použití. Řídicí znaky jsou . $ ^ { } [ ] ( ) | * + ? \ Mají-li se tyto znaky vyskytnout v hledaném textu, musí být rozepsány jako \ a znak (např. \. \+ \\ atd.) Hledaný text se pouze napíše, tedy např. brzdaA. Tečka představuje jeden libovolný znak. Zápis 'brzda.' vyhledá všechno obsahující brzda následované alespoň jedním znakem. Otazník znamená žádný nebo jeden výskyt. Zápis 'brzda_?a' tedy vyhledá jména 'brzdaa' i 'brzda_a'. Plus znamená jeden a více výskytů. Zápis 'brzda1+' vyhledá jména 'brzda1', 'brzda11', 'brzda111', ale nikoliv 'brzda'. Hvězdička znamená 0 a více výskytů. Zápis 'brzda*' vyhledá 'brzda', 'brzda1', brzda11' atd. Kulaté závorky vytváří skupinu zejména pro ? + *. 'dvere(kab)?_otevrit' vyhledá 'dvere_otevrit' i 'dverekab_otevrit'. Hranaté závorky definují jeden znak z/kromě. [aeiouy] například znamená samohlásku. Lze použít i rozsah případně kombinace: [a-zA-Z] jsou všechna ascii písmena. [^aeiouy] znamená negaci tedy například cokoliv mimo samohlásky.
35/87
trolview_ms_cz_113
TROLVIEW 'D[io]_Kamera' vyhledá 'di_kamera' i 'do_kamera'. Svislá čára je operátor nebo. 'kamera|dvere' vyhledá 'kamera' i 'dvere'. Základní náhrady: \d - číslice neboli [0-9] \w - znak identifikátoru neboli [0-9a-zA-Z]
7.1.3
Aplikační a vnucená banka Každá procesní proměnná obsahuje dvě banky. Aplikační banka je ta, se kterou pracuje aplikace, čte z ní i zapisuje. Vnucená banka slouží k tzv. podkladu proměnné. Aplikace z ní čte, nicméně zápis provádí aplikace stále do aplikační banky. Tímto mechanismem lze vnutit do aplikace jinou hodnotu pro každou procesní proměnnou. Aplikační banka (zelený symbol) – hodnota proměnné je určená aplikací. Vnucená banka (červený symbol) – hodnota proměnné je určena uživatelem (nezávisle na hodnotě, kterou by v dané situaci nastavila aplikace – aplikace pak dále zpracovává pouze hodnotu vnucenou).
Změna banky
Banku, kterou proměnná používá lze změnit dvojklikem na zelený/červený symbol nebo pomocí kontextového menu a volby Bank Switch. Druhý způsob přepneme banku proměnné, jejíž řádek je právě modře označen, přičemž lze označit více řádků najednou (změnit banku více proměnným najednou). Aktivní banka je indikována až po prvním spuštění komunikace.
Obr. 34 - Inspektor – banky Editace hodnoty proměnné
Spustit editaci hodnoty můžeme dvojklikem do okna hodnoty příslušné proměnné nebo stiskem F2 při selekci řádku proměnné, jejíž hodnotu chceme editovat. Pro rychlejší přepínání hodnoty proměnné typu BOOL je možné použít klávesovou zkratku Ctrl+T (Toggle).
trolview_ms_cz_113
36/87
TROLVIEW Pokud je okno inspektora vybrané (tedy pokud má "fokus"), je možné šipkami přecházet po jednotlivých položkách a kombinacemi Alt+Šipka vlevo a Alt+Šipka vpravo měnit šířku jednotlivých sloupců. Poklepáním nebo stiskem kláves Ctrl+F je možno rychle zvolit zobrazovaný formát dat ve vybraném řádku. Zobrazení komentářů
7.1.4
K zobrazení hodnoty proměnné lze (pokud jsou procesní proměnné načteny ze souboru) po stisku kláves Ctrl+I zobrazit i komentář.
Změna hodnoty v bankách Způsob přepínání bank se liší ve směru, v jakém dochází k přepínání bank a také na třídě proměnné.
Aplikační do vnucené banky
Při přepnutí z aplikační banky do vnucené banky dojde nejdříve ke zkopírování hodnoty z aplikační banky do vnucené banky a pak teprve k přepnutí. Celý proces je z hlediska aplikace atomický a je realizován pouze jedním příkazem z TrolView (kopii i přepnutí realizuje sama knihovna).
Vnucená do aplikační banky
Opačné přepnutí, tedy přepnutí z vnucené do aplikační banky, je prováděno bez kopie hodnoty. Jedná se tedy o pouhé přepnutí a o skokovou změnu hodnoty.
Proměnné třídy Param
Proměnné třídy Param není možné editovat v režimu aplikační banky, pokud není povolena volba „Enable edit param application value“ z hlavní nabídky Project/Options. Implicitně lze editovat pouze hodnotu ve vnucené bance. Důvodem je zamezit nechtěné změně parametrické proměnné. V případě proměnných třídy Param lze navíc využít systém hromadného kopírování hodnot z vnucené banky do aplikační nebo přepnutí do aplikační banky bez vnucené. Na výběr jsou dvě možnosti, které nalezneme v Hlavní nabídce Project/Data.
37/87
trolview_ms_cz_113
TROLVIEW
Obr. 35 - Inspektor – Přepnutí banky u Parametrických proměnných Accept new parameters – hodnoty, které jsou ve vnucené bance jsou zkopírovány do banky aplikační, která je zároveň aktivována Discard changed parameters – přepnutí na aplikační banku bez kopírování hodnot z vnucené banky; hodnoty ve vnucené bance zůstanou zachovány Tyto dvě funkce jsou hromadné, parametrické proměnné v aplikaci.
7.1.5
procházejí
všechny
Funkce Fit u okna inspektoru V kontextovém menu nebo horkou klávesou Shift-B lze u okna inspektoru dosáhnout zarovnání velikosti okna s velikostí vnitřní tabulky obsahující proměnné.
7.1.6
Výběr více položek v okně inspektoru V okně inspektora stejně jako v okně PDO (viz dále) lze vybírat i nesouvislý seznam položek (proměnných) a provádět na nich operace změny banky nebo toggle hodnoty (kontextovým menu i horkou klávesou).
7.2.
Prvek PDO Scénický prvek PDO slouží k zobrazení a editaci hodnot PDO ("Process Data Object"), které jsou využívány při komunikaci v CAN síti.
trolview_ms_cz_113
38/87
TROLVIEW Zobrazený PDO se volí v Parametrech prvku na záložce PDO. Jeden prvek PDO je schopen zobrazit pouze jeden PDO.
Obr. 36 - PDO - Parametry Po výběru PDO (rolovací nabídka), který chceme zobrazit na scénu, se ve spodní části okna zobrazí bitová pole daného PDO (pojmenování a jejich bitový rozsah) a je umožněno individuálně pro každou položku nastavit formát zobrazení hodnot. Banky hodnot
Také u PDO lze využívat systém bank. Symbolika i význam bank je shodný s prvkem Inspektor.
Obr. 37 - PDO – Banky
7.2.1
Zobrazení surových dat z CANu Kromě mechanismu podkladu (aplikační vs. vnucená banka) je na systémové úrovni zaveden pro PDO mechanismus tzv. bezpečných hodnot. Na vzestupnou hranu procesní proměnné (typu BOOL) mohou vybraná bitová pole nabýt konstantní hodnoty, dosáhnout tedy bezpečné hodnoty. Pro zobrazení příchozích PDO, tedy TPDO (jsou to tedy data, která vysílají
39/87
trolview_ms_cz_113
TROLVIEW slave stanice) je zaveden mód zobrazení, tzv. pure can, kde se zobrazují data PDO tak jak přišla po CANu. Do aplikačního módu, kde jsou bitová pole zobrazena tak, jak je čte aplikace, tedy se zakomponováním bezpečných hodnot, se okna PDO Inspector přepíná pomocí Ctrl+M. Uvedený mód zobrazení se týká pouze TPDO. RPDO, tedy PDO která se vysílají, se zobrazují vždy s daty, která mohou obsahovat bezpečné hodnoty. Pro RPDO se tedy zobrazují bitová pole s hodnotou, která vznikla činností aplikace nebo s bezpečnou hodnotou. Bližší popis mechanismu bezpečných v manuálu ke knihovně TROL.
hodnot
naleznete
Obr. 38 - PDO – Pure CAN režim
7.2.2
Funkce Fit u okna PDO V kontextovém menu nebo horkou klávesou Shift-B lze u okna inspektoru dosáhnout zarovnání velikosti okna s velikostí vnitřní tabulky obsahující proměnné.
7.2.3
Výčtový typ u okna PDO V okně PDO lze definovat zobrazení skupiny bitů výčtovým typem jako texty odpovídající hodnotám bitového pole. Tento způsob zobrazení (volitelný) je implementován od verze TrolView 1.0.0.64 a je nastaven jako výchozí způsob zobrazování.
trolview_ms_cz_113
40/87
TROLVIEW
Obr. 39 - Okno PDO s typem Enum Definice Enums
Dvojklikem na políčko Enums nebo klávesou F2 je vyvoláno okno pro zadání definice výčtu. Ve všech substitucích je možné použít formátovaný text se specifikátory %d dekadická hodnota %x hexadecimální hodnota Default text – text pro nedefinované bity (při nevyplněné položce je zobrazeno 'uknown enum (%d)) Hexa defines – slouží pouze ke konverzi mezi hexadecimální a dekadické hodnoty při editaci Subtitutes –
editace substituce
–
vytvoření nové substituce
–
smazání substituce
Obr. 40 - Definice Enum Je umožněno nadefinovat substituci jak pro jednu hodnotu, tak i pro rozsah hodnot, ale je zakázán přesah hodnot (nelze např.
41/87
trolview_ms_cz_113
TROLVIEW substituce 2-5 a 3-3). Lze nadefinovat i hodnoty, které přesahují rozsah bitfieldu. Již definovaný výčet lze opět editovat, mazat nebo kopírovat či vkládat do jiného pole bitfieldu (nabídku lze vyvolat pravým tlačítkem myši na požadovanou položku). Zobrazení nadefinované substituce se již děje v okně Scene zcela předvídatelně. Zobrazit lze pouze pevně nadefinované hodnoty (Např. From = To, 1 = 1).
Obr. 41 - Zobrazení ve formátu Enum
7.3.
Prvek Datalogger Součástí aplikace může být tzv. datalogger3 (součást aplikace ve stanici), který slouží k archivaci hodnot vybraných procesních proměnných. Jeho definice se vytváří v TrolDatGen. Hodnoty se ukládají do předem definovaného bufferu. Velikost bufferu nelze při běhu aplikace měnit, lze jí nastavit pouze při navrhování databáze v prostředí TrolDatGen. Do bufferu se ukládají archivační záznamy. Archivační záznam se provede při splnění archivační podmínky (přechod spouštěcí proměnné označené Trigger z 0 do 1). Při provedení záznamu je uložen určitý počet vzorků před a po splnění archivační podmínky. Počet vzorků je určen parametrem Epsilon (počet vzorků však nemusí roven Epsilon, mechanismus práce datalogeru je popsán v manuálu ke knihovně TROL).
3
trolview_ms_cz_113
datalogger – součást aplikace ve stanici prvek Datalogger – vizualizační prvek v TrolView
42/87
TROLVIEW Parametry Epsilon a Trigger je možné změnit i za běhu aplikace. Změnit je též možně set proměnných, jejichž hodnoty budou archivovány. Vložení prvku
Při vložení prvku Datalogger na scénu je nutné zvolit ID dataloggeru, jehož data mají být prvkem zobrazena. Volba ID se provádí v parametrech prvku na záložce DataLogger.
Obr. 42 - Prvek DataLogger – volba Dataloggeru Prvek obsahuje dvě části – zobrazovací (záložka View) a ovládací (záložka Control).
7.3.1
View – zobrazovací část prvku
Obr. 43 - Datalogger – zobrazovací část V záložce View je k dispozici v levé části seznam všech vyčtených archivovaných událostí společně s datem a časem, ve kterém byla splněna archivační podmínka. Pravá část okna pak slouží k zobrazení hodnot vzorků proměnných, které dané události náleží. V záhlaví této části lze najít informace o datu a času, ve kterém byla splněna archivační podmínka pro zobrazené vzorky, ID Triggeru a Periodu s jakou byly vzorky pořizovány.
43/87
trolview_ms_cz_113
TROLVIEW
Načtení nových událostí
K načtení nově vzniklých událostí slouží tlačítko
, po jehož
stisku jsou načteny všechny nové události a tlačítko , kterým lze provést vyčtení událostí v zadaném časovém intervalu (od – do). Po stisku tlačítka se zobrazí dialogové okno, ve kterém se nastavuje datum začátku a konce vyčítání. Stiskem tlačítka OK se vyčítání zahájí.
Obr. 44 - Datalogger – Načtení událostí od – do Během načítání záznamů se v seznamu mění ikony jednotlivých záznamů. Graficky jsou indikovány čtyři různé stavy.
Obr. 45 - Datalogger – stav záznamů a) b) c) d) Zobrazení hodnot proměnných
trolview_ms_cz_113
záznam nebyl dosud ze stanice vyčten záznam se právě vyčítá záznam byl vyčten v plném rozsahu záznam byl vyčten nekompletní
Prvek poskytuje dva způsoby zobrazení dat. Tabulkový výpis (viz obr. Obr. 43 - pravá část) a Grafické zobrazení (viz Obr. 46 - pravá část).
44/87
TROLVIEW Obr. 46 - Datalogger – grafické zobrazení hodnot Export a mazání záznamů
K přepínání slouží ikony Table a Graph nad seznamem poskytuje funkci exportu/smazání záznamů. Třetí ikona (Export/delete selected events) označených záznamů.
Obr. 47 - Datalogger – Export záznamů Při exportu dojde k uložení označených záznamů do souboru .csv dle nastaveného umístění. Označené záznamy lze: ♦ Exportovat ♦ Smazat (bez exportu) ♦ Exportovat a poté smazat Smazáním je myšleno smazání dat z prvku, ve stanici zůstanou záznamy uloženy a lze je opět stáhnout (např. použitím dalšího prvku Datalogger) Ke smazání záznamů v dataloggeru ve stanici slouží funkce z Hlavní nabídky Project/Data/Erase datalogger events.
7.3.2
Control – změna parametrů dataloggeru ve stanici V ovládací části prvku lze měnit důležité parametry dataloggeru – Trigger, Period, Epsilon i set proměnných, které jsou archivovány.
45/87
trolview_ms_cz_113
TROLVIEW
Obr. 48 - Datalogger – záložka Control Po provedení změn lze nové nastavení zapsat do stanice (ikona Write params) nebo obnovit původní nastavení (ikona read params). Filtrovat zobrazené proměnné lze použitím tlačítka , které zobrazí pouze označené proměnné nebo pomocí filtru na . základě jména proměnné Tlačítka slouží k označení / odznačení všech proměnných, které jsou zobrazeny v seznamu proměnných. Šablony setu proměnných
K většímu komfortu při práci s několika různými sety proměnných jsou nově k dispozici šablony setů proměnných.
Obr. 49 - Datalogger – Šablony setů proměnných Šablony setů proměnných jsou uloženy v rámci projektu. Načtením setu nedojde k jeho nahrání do stanice, pouze se v okně s proměnnými zaškrtnou proměnné dle nastavení v uložené šabloně. K nahrání je třeba použít výše zmíněnou funkci Write params!
trolview_ms_cz_113
46/87
TROLVIEW 7.3.3
Doporučený postup při změně databáze Nahráním nové verze aplikace, která obsahuje modifikovanou databázi, dojde ke znehodnocení záznamů, které jsou prvkem Datalogger archivovány. Znehodnocení lze zabránit dodržením následujícího postupu: 1.Načteme prvkem poslední vzniklé záznamy 2.Zálohujeme TrolView projekt 3.Vymažeme svazek Datalogger příkazem v Hlavní nabídce Project/Data/Erase datalogger events 4.Nahrajeme novou verzi aplikace Zálohovaný projekt v sobě zachová všechny uložené záznamy (za předpokladu, že nebude načtena jiná verze databáze). Jako ideální řešení se jeví mít vždy vytvořeno ke každé verzi aplikace příslušnou verzi projektu v TrolView s odpovídající databází.
7.3.4
Synchronní režim Dataloggeru Synchronní činnost při prohlížení událostí umožňují pouze dataloggery, které obsahují události se společným Triggerem. Je-li zvolen synchronní způsob prohlížení, jsou některé operace s prvkem prováděny se všemi prvky (viz dále).
Aktivace synchronního režimu
Při splnění výše zmíněné podmínky stačí pro aktivaci synchronního režimu v nastavení parametrů prvku Datalogger zaškrtnout Couple mode. Zaškrtnutí je nutno provést pro všechny prvky, které chceme v synchronním režimu prohlížet.
Obr. 50 - Povolení synchronního režimu Dataloggeru
47/87
trolview_ms_cz_113
TROLVIEW Synchronní režim se projeví při následujících třech operacích:
společnou
změnou
prvků
I. Změna zobrazené události II. Změna zoomu při zobrazení grafické podoby hodnot III. Posuv v časové ose
Obr. 51 - Skupinové ovládání v synchronním režimu Jakmile však bude k zobrazení vybrána událost s časem vzniku, který není v přítomen v ostatních Dataloggerech (nebude splněna základní podmínka), bude na změny zoomu a pozice v časové ose reagovat pouze právě ovládaný prvek. Zarovnání grafů změnou šířky legend
trolview_ms_cz_113
Pro vizuální srovnání grafů pod sebe je zavedena možnost nastavit šířku popisů osy Y. Udává se v pixelech a je implicitně nastavena na 0 – v tomto případě se automaticky spočítá a použije se nejmenší potřebná šířka. To v řadě případů nemusí vyhovovat, zejména když se míchají např. boolovské průběhy s analogovými, kde jsou v legendě uvedena čísla s větším počtem číslic.
48/87
TROLVIEW
Obr. 52 - Volba šířky legend - událostí a osy X
7.4.
Prvek SDL Prvek SDL (Single datalogger) je lze použít v aplikacích nad knihovnou TROL 2.XX. Jedná se o funkčně téměř totožný prvek jako Datalogger (dále bude označován jako DL), ale s výrazně lepší implementací vzorkování na stanici. Jde zejména o následující vlastnosti ♦ Deterministické chování při vytváření vzorků ♦ Schopnost navzorkovat a uložit (po novém zapnutí) událost navzorkovanou v posledním plně dokončeném procesním tiku (dataloger DL nebyl schopen uložit událost cca 1-2 s před vypnutím stanice) Na základě principu práce z hlediska funkce obdobný prvku Datalogger, tj. jedná se o novější verzi, která spolupracuje s implementací v aplikaci s podporou formátu SDL. Prvky SDL a Datalogger nejsou vzájemně zaměnitelné, pro daný prvek musí být vždy podpora v aplikaci.
Vložení prvku
Prvek SDL lze přidat na scénu běžným způsobem.
49/87
trolview_ms_cz_113
TROLVIEW
Obr. 53 - Prvek SDL
Prvek obsahuje tři části – zobrazovací (záložka View), výběrová (záložka Select) a ovládací (záložka Control).
7.4.1
View – zobrazovací část prvku
Obr. 54 - SDL – zobrazovací část V záložce View je k dispozici v levé části seznam všech vyčtených archivovaných událostí společně s datem a časem, ve kterém byla splněna archivační podmínka. Pravá část okna pak slouží k zobrazení hodnot vzorků proměnných, které dané události náleží. V záhlaví této části lze najít informace o datu a času, ve kterém byla splněna archivační podmínka pro zobrazené vzorky, počet vzorků a ID Triggeru. Načtení nových událostí
trolview_ms_cz_113
K načtení nově vzniklých událostí slouží tlačítko
, po jehož
stisku jsou načteny všechny nové události a tlačítko , kterým lze provést vyčtení událostí v zadaném časovém intervalu (od – do).
50/87
TROLVIEW Po stisku tlačítka se zobrazí dialogové okno, ve kterém se nastavuje datum začátku a konce vyčítání. Stiskem tlačítka OK se vyčítání zahájí.
Obr. 55 - SDL – Načtení událostí od – do
Zobrazení hodnot proměnných
Prvek poskytuje dva způsoby zobrazení dat. Tabulkový výpis (viz Obr. 55 - pravá část) a Grafické zobrazení (viz Obr. 57 pravá část).
Obr. 56 - SDL – grafické zobrazení hodnot Export a mazání záznamů
K přepínání slouží ikony Table a Graph nad seznamem záznamů. Třetí ikona poskytuje funkci exportu/smazání (Export/delete selected events) označených záznamů.
Obr. 57 - SDL – Export záznamů
51/87
trolview_ms_cz_113
TROLVIEW Při exportu dojde k uložení označených záznamů do souboru .csv dle nastaveného umístění. Označené záznamy lze: ♦ Exportovat ♦ Smazat (bez exportu) ♦ Exportovat a poté smazat Smazáním je myšleno smazání dat z prvku, ve stanici zůstanou záznamy uloženy a lze je opět stáhnout (např. použitím dalšího prvku SDL) Ke smazání záznamů v dataloggeru (SDL) ve stanici slouží funkce z Hlavní nabídky Project/Data/Erase datalogger events.
7.4.2
Control – změna parametrů SDL ve stanici V ovládací části prvku lze na základě výběru měnit proměnné, které budou ze stanice vyčítány a bude k dispozici jejich náhled („Výběr pohledu“). Informace o důležitých parametrech vybraných proměnných jsou v pravé části okna.
Obr. 58 - SDL – záložka Control Po provedení změn lze nové nastavení zapsat do stanice (ikona Write params) nebo obnovit původní nastavení (ikona read params). Změny jsou provedeny po resetu stanice. Filtrovat zobrazené proměnné lze použitím tlačítka , které zobrazí pouze označené proměnné nebo pomocí filtru na základě jména proměnné .
trolview_ms_cz_113
52/87
TROLVIEW Tlačítka slouží k označení / odznačení všech proměnných, které jsou zobrazeny v seznamu proměnných. Šablony setu proměnných
K většímu komfortu při práci s několika různými sety proměnných jsou nově k dispozici šablony setů proměnných.
Obr. 59 - SDL – Šablony setů proměnných Šablony setů proměnných jsou uloženy v rámci projektu. Načtením setu nedojde k jeho nahrání do stanice, pouze se v okně s proměnnými zaškrtnou proměnné dle nastavení v uložené šabloně. K nahrání je třeba použít výše zmíněnou funkci Write params! Na základě výběru proměnných lze provádět jejich kopírování a vkládání aktuálního prvku.
7.4.3
mezi jednotlivými prvky SDL i v rámci
Select – Výběr pohledu Výběr pohledu lze měnit ikonou (aktivace a deaktivace filtru pohledu), která je viditelná v rámci záložky Select a během aktivace filtru se v seznamu na záložce View mění ikony jednotlivých záznamů. Graficky jsou indikovány čtyři různé stavy.
53/87
trolview_ms_cz_113
TROLVIEW
Obr. 60 - SDL – záložka Select
Obr. 61 - SDL – stav záznamů a) b) c) d)
trolview_ms_cz_113
záznam v plném rozsahu není vybrán žádný trigger nebo proměnná není vybrán žádný trigger není vybrána žádná proměnná
54/87
TROLVIEW Obr. 62 - SDL – Výběr pohledu
7.5.
Kompatibilita Datalogger/SDL Aplikace běžící na stanici může mít implementován DL (DataLogger) nebo SDL (SingleDataLogger) nebo nemusí mít implementován žádný. Nemůže existovat aplikace, která bude mít zároveň implementován SDL a DL. Toto je založeno na základě skutečnosti, že pro daný typ dataloggeru je příslušně naformátována paměť flash. Formátování na typ dataloggeru se děje automaticky podle kompatibility.
7.6.
Prvek Alarm-inspector Prvek Alarm-inspector slouží k prohlížení stavu alarmů, které jsou v aplikaci použity.
Obr. 63 - Alarm-inspektor Prvek zobrazí alarmy v podobě seznamu, který obsahuje identifikační index (Idx), název alarmu (Name) a stav alarmu (Alarm). V záhlaví je možnost přepnutí zobrazení na aktivní alarmy (zobrazeny pouze alarmy ve stavu ON) nebo všechny alarmy. Indikován je také počet alarmů.
55/87
trolview_ms_cz_113
TROLVIEW
7.7.
Prvek AlarmLogger Prvek AlarmLogger slouží k prohlížení historie vzniklých alarmů. O každé změně alarmové proměnné, která v aplikaci nastane, je proveden záznam do paměti flash. Prvkem AlarmLogger lze tyto záznamy vyčíst, exportovat či smazat.
Obr. 64 - AlarmLogger Údaje, které prvek o každém záznamu poskytuje, jsou datum a čas vzniku/zániku alarmu (Date), identifikační index alarmu (Idx), stav alarmu (Value) a text alarmu (Text), který slouží k jeho popisu. Typ události (Value)
Typ události může nabývat několika stavů: ♦ ON – alarmová proměnná nabyla hodnoty True (chybový stav) ♦ OFF – alarmová proměnná nabyla hodnotu False (normální stav) ♦ CHNG – hodnota alarmové proměnné zůstala nezměněna, změnila se hodnota proměnné Reason (pro použití proměnné Reason je třeba vhodný návrh aplikace viz Knihovna TROL – Programátorská příručka, kapitola Alarmový systém) ♦ ON-C – změna alarmové proměnné do True a zároveň změna proměnné Reason ♦ OFF-C – změna alarmové proměnné do False a zároveň změna proměnné Reason Pokud není použito pole Reason, nabývá alarm pouze dvou stavů – ON / OFF.
Text
Popis události, který může obsahovat název alarmu, hodnotu proměnné Reason, hodnotu lokální / globální proměnné Param (volitelná proměnná, která může obsahovat doplňkové informace – více viz Knihovna TROL – Programátorská příručka, kapitola Alarmový systém).
Ovládací funkce
Funkce, které jsou k dispozici pro ovládání prvku AlarmLogger jsou následující:
trolview_ms_cz_113
56/87
TROLVIEW ♦ automatický přechod na nejnovější záznam (Move to newest record) ♦ načtení nejnovějších záznamů - tlačítko umožňuje zobrazit záznamy uložené ve flash nebo RAM paměti - pokud je vytvořeno více než 13 nových (nezobrazených) záznamů, prvek je načte a zobrazí automaticky ♦ export/smazání záznamů (export/delete records) ♦ filtrování záznamů Export / smazání záznamů
Funkce umožňuje vyexportovat (po exportu případně smazat) záznamy, které jsou staršího data než je datum zvolené.
Filtry
Pro zlepšení orientace v zobrazených záznamech lze definovat filtry a jeden z nich pomocí rozbalovací nabídky na zobrazené záznamy aktivovat
Filtrační podmínka může být libovolnou kombinací času a data, ID alarmu a hodnot (alarmové proměnné, proměnné Reason či jejich kombinací).
7.7.1
Doporučený postup při změně databáze Nahráním nové verze aplikace, která obsahuje modifikovanou databázi, dojde ke znehodnocení záznamů, které jsou prvkem AlarmLogger archivovány. Znehodnocení lze zabránit dodržením následujícího postupu:
57/87
trolview_ms_cz_113
TROLVIEW 1.Načteme prvkem poslední vzniklé záznamy 2.Zálohujeme TrolView projekt 3.Vymažeme AlarmLogger příkazem „Erase alarm records“ v Hlavní nabídce Project/Data 4.Nahrajeme novou verzi aplikace Zálohovaný projekt v sobě zachová všechny uložené záznamy (za předpokladu, že nebude načtena jiná verze databáze). Jako ideální řešení se jeví mít vždy vytvořeno ke každé verzi aplikace příslušnou verzi projektu v TrolView s odpovídající databází.
7.8.
Prvek Text Slouží pro vkládání uživatelských textů, které složí zejména ke zvýšení přehlednosti obsahu scén. K nastavení vlastností písma slouží záložka Text v parametrech prvku.
Obr. 65 - Prvek Text – nastavení vlastností písma K dispozici máme nastavení: ♦ zobrazovaného textu (Displaying text) ♦ velikosti fontu (Font size) ♦ vzhledu písma – tučné (Bold), kurzíva (Italic), podtržené (Underlined) ♦ barvy textu (Colour – Text) a barvy pozadí (Colour – Background)
trolview_ms_cz_113
58/87
TROLVIEW
7.9.
Prvek Oscilogram Prvek poskytuje možnost run-time sledování hodnot vybraných proměnných v TROL-aplikaci a zaznamenávat tyto hodnoty v době, která je definována stiskem tlačítek: Start up capture – pro start vzorkování, Stop capture – pro ukončení vzorkování. Po spuštění vzorkování se postupně plní paměťové rámce o velikosti 240 byte vzorky proměnných datasetu s periodou vzorkování (typicky 50 ms, 20 ms). Těchto rámců je v paměti 10 a jsou postupně vyčítány po jednom po maximálním možném naplnění rámce.
Odložené čtení
Kromě manuálního spuštění vzorkování je k dispozici také možnost spuštění vzorkování po startu zařízení (spuštění zajišťuje vhodně upravená aplikace – nelze nastavit pouze z TrolView). Vzorkování v tomto případě probíhá až do přetečení bufferu (čas, za který přetečení nastane, je závislý na velikosti setu vzorkovaných proměnných). Pokud je stisknuto tlačítko pro manuální start vzorkování a zároveň ještě běží vzorkování spuštěné po startu zařízení, ve vzorkování se pokračuje a je možné ho přerušit tlačítkem pro zastavení vzorkování Záznam, který je touto funkcí vytvořen, lze načíst pomocí tlačítka - Read last captured data. Pro tuto funkci existuje také klávesová zkratka (Ctrl+J).
Upozornění
Jelikož občas dochází při komunikaci ke ztrátě paketu, je potřeba vhodně nastavit v profilu komunikace se stanicí po ethernetu timeout tak, aby během něho nedošlo k naplnění všech rámců a k následnému zastavení vzorkování. Příklad: Perioda vzorkování = 50 ms Šířka vzorků datasetu = 30 Byte 240 / 30 * 50 = 400 ms … doba pro naplnění jednoho rámce Pokud by timeout byl nastaven např. na 10 * 400 = 4000 ms, dojde k přerušení vzorkování již při první ztrátě paketu. V tomhle případě je vhodné nastavit timeout např. na 200 ms. Jako minimální hodnota pro timeout je doporučeno 100 ms. Prvek obsahuje dvě části – zobrazení záznamů (záložka View) a nastavení parametrů (záložka Parameters).
59/87
trolview_ms_cz_113
TROLVIEW 7.9.1
View – zobrazovací část prvku Zobrazení navzorkovaných dat je (stejně jako v případě prvku Datalogger) možné v podobě tabulky hodnot a grafu. K přepnutí způsobu zobrazení slouží první dvě ovládací ikony okna .
Obr. 66 - Oscilogram – tabulkové zobrazení Tabulka obsahuje čas pořízení vzorku a hodnotu proměnných v tomto čase. Graf není nic jiného než grafickou podobou hodnot z tabulky. Kliknutím na libovolné místo průběhu křivky v grafu lze vyčíst danou hodnotu příslušného místa a čas uskutečnění daného vzorku. Při prohlížení graficky znázorněného průběhu hodnot lze využívat také zoomu a případných postníků v ose hodnot a času.
trolview_ms_cz_113
60/87
TROLVIEW
Obr. 67 - Oscilogram – zobrazení ve formě grafu Ikona poskytuje funkci exportu/smazání (Export/delete selected events) označených záznamů.
Obr. 68 - Datalogger – Export záznamů Při exportu dojde k uložení označených záznamů do souboru .csv dle nastaveného umístění. Označené záznamy lze: ♦ Exportovat ♦ Smazat (bez exportu) ♦ Exportovat a poté smazat
7.9.2
Parameters – změna setu vzorkovaných proměnných Jediným parametrem, který je možné nastavit, je proměnných (dataset), jejichž hodnoty budou vzorkovány.
61/87
set
trolview_ms_cz_113
TROLVIEW
Obr. 69 - Oscilogram – volba setu proměnných Nastavení datasetu je možno pouze při vypnutém vzorkování, počet vzorkovaných proměnných je max. 122, šířka vzorků max. 240 byte. Proměnné jsou v datasetu uspořádány. Pokud seznam obsahuje proměnné typu BOOL, musí být uvedeny na začátku seznamu. Nastane-li během zápisu parametrů chyba, je indikována zobrazením chybového symbolu na záložce příčina chyby je vypsána jako stavová informace.
a
Filtrovat zobrazené proměnné lze použitím tlačítka , které zobrazí pouze označené proměnné nebo pomocí filtru na základě jména proměnné
Šablony setu proměnných
.
Tlačítka slouží k označení / odznačení všech proměnných, které jsou zobrazeny v seznamu proměnných. K většímu komfortu při práci s několika různými sety proměnných jsou nově k dispozici šablony setů proměnných.
Obr. 70 - Oscilogram – Šablony setů proměnných
trolview_ms_cz_113
62/87
TROLVIEW Šablony setů proměnných jsou uloženy v rámci projektu. Načtením setu nedojde k jeho nahrání do stanice, pouze se v okně s proměnnými zaškrtnou proměnné dle nastavení v uložené šabloně. K nahrání je třeba použít výše zmíněnou funkci Write params!
63/87
trolview_ms_cz_113
TROLVIEW
8.
Systém přístupových práv Systém přístupových práv upravuje přístup k důležitým součástem projektu TrolView (např. nastavení stanice, editace proměnných, download aplikace, mazání flash). K dispozici jsou tři úrovně oprávnění: Admin – přístup bez omezení Service – nízké omezení přístupových práv User – vysoké omezení přístupových práv Při prvním spuštění TrolView je uživatel vyzván k zadání hesla.
Obr. 71 - Přístupová práva – přihlášení Heslem, které je nastaveno pevně a nelze měnit, se lze přihlásit k účtům s právy Admin a Service. K přihlášení s právy User slouží check box „Use only “user“-access. Úroveň oprávnění je po prvním přihlášení uložena a při dalším spouštění je provedeno automatické přihlášení se stejnými právy. Při instalaci nové verze je při prvním spuštění opět požadováno zadání hesla. Právě používaná úroveň oprávnění je indikována v pravém dolním rohu okna programu. Následující tabulka uvádí seznam funkcí, k nimž je přihlášením k danému účtu upraven přístup. Tabulka obsahuje pouze funkce, které jsou přihlášením ovlivněny. Vše, co v tabulce uvedeno není, je přístupné se všemi úrovněmi oprávnění. funkce admin service user Založení nového projektu Ano Ne Ne Smazání záznamů na Flash Ano Ano Ne Smazání událostí dataloggeru Ano Ne Smazání historie alarmů Ano Ne Změna setu proměnných Dataloggeru ve Ano Ano Ne stanici Měnit nastavení zápisu do aplikační banky Ano Ne Ne Nahrání aplikace do stanice Ano Ano Ne Načtení seznamu proměnných do projektu Ano Ano Ne Spuštění projektu, pokud je zjištěn nesoulad Ano Ano Ne databáze aplikace ve stanici x projekt Změna parametrů stanice (např. IP, čas) Ano Ano Ne v okně Communication
trolview_ms_cz_113
64/87
TROLVIEW Zapsaní hodnoty do proměnné/bitfieldu, změna banky Nastavení omezené doby platnosti práv (LifeTime exception) v projektu Exportování/Importování nastavení práv do/ze souboru Prodloužení platnosti práv (Extend lifetime exception)
Vždy
Nast.
Nast.
Ano
Ne
Ne
Ano
Ne
Ne
Ano
Ano
Ne
Přihlášením k účtu Admin získáme neomezený přístup k celému projektu. Specifikem účtu Admin je možnost „zkušebního“ přihlášení s právy dalších dvou úrovní. Zmíněná možnost je nabízena v Hlavní nabídce Projekt/User/Login nebo ikonou
z Nástrojové lišty.
Ke zkušebnímu přihlášení je třeba zadat příslušné heslo (resp. pro úroveň User heslo nezadávat). Pro návrat zpět k úrovni admin slouží opět funkce Login. Jako heslo je nutno zadat heslo patřící úrovni práv admin.
8.1.
Nastavení práva k editaci proměnné / PDO Po přihlášení s právy Admin lze kliknutím do sloupce Rights nastavit, jaká úroveň oprávnění bude třeba pro editaci hodnoty proměnné/změnu banky. Filosofie je následující: Rights je nastaveno na user – editovat proměnnou/bitfield lze s právy admin, service, user. Rights je nastaveno na service – editovat proměnnou/bitfield lze s právy admin a service. Rights je nastaveno na admin – editovat proměnnou/bitfield lze pouze s právy admin.
Obr. 72 - Přístupová práva – nastavení přístupu k proměnným Analogické nastavení umožňují také bitfieldy všech PDO.
65/87
trolview_ms_cz_113
TROLVIEW
Obr. 73 - Přístupová práva – nastavení přístupu k bitfieldům
8.2.
Časově omezené právo k editaci proměnné / PDO Nastavení práva k editaci proměnné / PDO může mít pouze omezenou dobu trvání. Při každém otevření projektu se provede porovnání systémového času (Windows) a nastaveného data. Vytvořit nebo smazat existující časové omezení práv lze pouze po přihlášení s právy admin. Jestliže systémový čas zatím nedosáhl nastaveného data, projekt se spustí s nastavenými právy. Pokud systémový čas nastaveného data dosáhl, automaticky se u všech proměnných změní nastavení Rights na admin. Proměnné tedy bude moci editovat pouze admin. Datum, po jehož dosažení dojde k vypršení nastavených práv, se volí v Hlavní nabídce: Project/User/Change/delete lifetime exception.
Obr. 74 - Nastavení časově omezených práv Ve stejném dialogovém okně lze také vytvořené časové omezení nastavení práv smazat zaškrtnutím Delete exception a kliknutím na OK.
8.2.1
Indikace stavu časového omezení práv Nastavení Lifetime exception je při návrhu s právy admin indikováno zobrazením hvězdičky v okně projekt. Za hvězdičkou je nově také datum, po kterém nastavení práv vyprší. Při otevření projektu s právy service nebo user je v okně Projekt k dispozici indikátor stavu Lifetime exception, kterým jsou podchyceny tři možné stavy.
trolview_ms_cz_113
66/87
TROLVIEW Lifetime exception není nastaven – indikátor v okně Projekt se nezobrazuje.
Obr. 75 - Lifetime – nebylo provedeno nastavení Lifetime exception je nastaven a dosud nedošlo k dosažení nastaveného data a času – indikátor v okně Projekt zobrazí hvězdičku.
Obr. 76 - Lifetime – aktivní – nebyl dosažen nastavený čas a datum Lifetime exception je nastaven a došlo k dosažení nastaveného data a času – indikátor v okně Projekt zobrazí vykřičník.
Obr. 77 - Lifetime – aktivní – byl dosažen nastavený čas a datum
8.3.
Export a Import nastavení práv Import i export nalezneme v hlavní nabídce Project/Data.
67/87
trolview_ms_cz_113
TROLVIEW
Export
Funkce “Export data rights“ slouží uživateli s právy admin při tvorbě projektu. Pomocí exportu lze uložit nastavení práv (pro PDO a proměnné) do souboru (.tvwr). Při exportu je do souboru uloženo nastavení práv pro proměnné/PDO, které obsahuje úrovně service nebo user. Všechny ostatní položky, jejichž nastavení práv soubor neobsahuje, zůstávají v případě dalšího zpracování nastaveny na admin. zároveň nastavit Provedení exportu umožňuje LifeTime exception pro exportované nastavení práv a vytvořit tak zabezpečený soubor, který lze použít pro prodloužení platnosti práv v projektu (funkce Extend lifetime exception popsaná níže), který používá pracovník s úrovní oprávnění service.
Obr. 78 - Vytvoření zabezpečeného .tvwr souboru Import
Opačnou funkcí je “Import data rights“, kterou nastavení práv načteme ze souboru do projektu. Při načítání práv se nejdříve provede smazání nastavení práv v projektu (vše se nastaví na admin) a následně jsou práva proměnných/PDO nastavena dle importovaného souboru. Import nastavení práv nelze provést v případě, že soubor .twvr obsahuje Lifetime exception a aktuální systémové datum již překročilo datum Lifetime exception nastavené v importovaném souboru.
Nekonzistence databáze projektu a souboru twvr
Následující informační hlášení se zobrazí v případě, že provedeme import souboru, který obsahuje nastavení práv pro proměnné, které nejsou v databázi projektu přítomny.
Obr. 79 - Import proměnné, která není v databázi
8.3.1
Prodloužení platnosti práv Funkci nalezneme v Hlavní Project/Data/Extend the lifetime exception.
trolview_ms_cz_113
68/87
nabídce
TROLVIEW Prodloužení platnosti práv je určeno pro servisní pracovníky, kteří již mají k dispozici TrolView projekt, ve kterém došlo k překročení nastavené doby Lifetime exception (tím ke smazání nastavení práv). Pokud i poté nastanou okolnosti, které vyústí v nutnost přidělit servisnímu pracovníkovi právo k editaci proměnné/PDO, lze využít této funkce a přidělit servisnímu pracovníkovi opět (na omezenou dobu) potřebná práva. Základní podmínkou je, aby autor projektu (uživatel s právy admin) a servisní pracovník (uživatel s právy service) sdíleli stejný TrolView projekt (se stejnou databází). Postup při prodloužení platnosti Lifetime exception
Uživatel s právy admin (autor projektu) provede: 1.jednu z následujících akcí: nově nastaví práva na úroveň service/use dle potřeby nebo importuje dříve použitý soubor .tvwr a následně provede export včetně nastavení nového data Lifetime exception. 2.nastavení časového omezení doby trvání nastavených práv (Lifetime exception ) – pokud má jít o dočasnou úpravu práv. 3.export práv do souboru (.tvwr) 4.odeslání vyexportovaného souboru (.tvwr) k servisnímu pracovníkovi. Uživatel s právy service (servisní pracovník) poté: 1.provede prodloužení práv ze souboru (.tvwr) pomocí funkce „Extend the lifetime exception“ 2.pracuje (do vypršení nově nastavené doby) s právy k editaci proměnných/PDO dle importovaného souboru
69/87
trolview_ms_cz_113
TROLVIEW
9.
Variable browser Okno Variable browser se vyvolá z Hlavní nabídky Windows/Tools. Okno lze využít pro vyhledávání proměnných pro ♦ Vyhledání výskytu proměnné ve zdrojových textech ♦ Vyhledání proměnné ve scénách V obou případech se zadává jméno proměnné.
Prohledávání zdrojových modulů
Pro prohledávání zdrojových souborů je třeba zadat adresář, který se má prohledat. V adresáři budou prohledány všechny soubory s koncovkou .cpp na výskyt řetězců db_Get a db_Put. Po prohledání se zobrazí statistika a v pravém okně se zobrazí náhled na soubor.
Prohledávání scén
Vyhledávání lze také přepnout na prohledávání scén, na kterých se vyskytuje zadaná proměnná. Je zobrazena statistika výskytu a poklepáním na informaci o výskytu je fokusována příslušná scéna s prvkem Inspector. Lze vyhledávat ve všech scénách nebo vybrat pouze jednu. Okno Variable browser lze aktivovat klávesou F3 a kombinace Ctrl, Shift a Alt (viz. Kapitola klávesové zkratky).
Obr. 80 - Variable browser – prohledávání zdrojových modulů
trolview_ms_cz_113
70/87
TROLVIEW
10.
Další funkce prostředí Kapitola slouží k popisu důležitých funkcí, které nelze přímo zařadit do žádné z jiných kapitol, ale jejich popis není tak rozsáhlý, aby vytvořil samostatnou kapitolu.
10.1.
Interní FLASH – formátování /zobrazení statusu Z Hlavní nabídky Project/Data/FLASH status / format získáme přístup k funkci, která v sobě kombinuje možnost zobrazit status interní FLASH nebo provést formátování této paměti. Provedením formátu dojde ke smazání dat dataloggeru a všech záznamů alarmového systému!
Obr. 81 - Výběr formátování / zobrazení statusu Stiskem tlačítka Read dojde k vyčtení statusu, který charakterizuje stav, ve kterém se interní FLASH nachází. Součástí statusu je zobrazení stavu, ve kterém se nachází datalogger. Zobrazit se mohou následující statusy: ♦ Čtení statusu FLASH ♦ FLASH v pořádku, datalogger povolen ♦ FLASH v pořádku, datalogger zakázán ♦ FLASH se formátuje, prosím čekejte ♦ FLASH není připravena, proveďte formátování Ke spuštění procesu formátování slouží tlačítko Format. Po jeho stisku je spuštěno formátování, což také indikuje změna statusu FLASH.
Obr. 82 - Průběh formátování Průběh formátování je provázen progress barem.
71/87
trolview_ms_cz_113
TROLVIEW
Obr. 83 - Formátování dokončeno Dokončení formátování je opět oznámeno ve statusu. Po formátování FLASH je nutné provést reset stanice.
trolview_ms_cz_113
72/87
TROLVIEW
11.
Formáty čísel Pro zobrazení hodnot v komponentách lze využít celé řady předdefinovaných formátů čísel, nebo pokud je to nutné, definovat formát vlastní. Formáty čísel je možno definovat globálně pro celý projekt, zvlášť pro každou jednotlivou scénu, pro každý prvek, v některých případech i pro každou zobrazenou procesní proměnnou. Pokud není pro určitý prvek definován uživatelem formát zobrazení, použije se vždy takový, jaký je nastaven v popisované hierarchii o úroveň výše.
11.1.
Předdefinované formáty Předdefinované formáty jsou nabízeny rozbalovací nabídkou. Na následujícím obrázku je pro ilustraci uvedeno nastavení zobrazení proměnné prvku Inspektor.
Obr. 84 - Předdefinované formáty proměnné prvku Inspektor
11.2.
Vlastní formáty Po výběru custom format v sekci Format dojde k rozšíření dialogového okna o další řádek, ve kterém je možno definovat vlastní formát zobrazení.
Obr. 85 - Vlastní formát zobrazení proměnné prvku Inspektor Pro definování vlastního formátu jsou k dispozici následující formátovací znaky:
73/87
trolview_ms_cz_113
TROLVIEW
0
#
.
,
%
;
e, E
trolview_ms_cz_113
Místo znaku je vždy zobrazeno číslo. Pokud je hodnota proměnné řádově menší, číslo se doplní nulami. Tohoto znaku lze tedy použít např. pro jednoduché zaokrouhlení hodnoty Příklad: Hodnota = 35.5, Řetězec = 000, Výstup = 036 Místo znaku je vždy zobrazeno číslo. Rozdíl mezi tímto znakem a znakem 0 je v tom, že zde se nedoplňují automaticky nuly. Tohoto znaku lze tedy použít např. pro jednoduché zaokrouhlení hodnoty Příklad: Hodnota = 35.5, Řetězec = ##, Výstup = 36 Desetinná tečka. V místě prvního výskytu symbolu vloží desetinnou tečku. Všechny další výskyty jsou ignorovány. Příklad: Hodnota = 35.6, Řetězec = 000.00, Výstup = 035.60 Oddělovač tisíců. Pokud je vložen do řetězce jeden tento symbol, jsou od sebe oddělovány vždy 3 řády (tisíce). Příklad: Hodnota = 12345678, Řetězec = #,#, Výstup = 12 345 678 Procenta. Po vložení tohoto znaku do řetězce dojde před samotným formátováním k vynásobení hodnoty číslem 100. K hodnotě je přidán symbol procenta. Příklad: Hodnota = 123, Řetězec = #,#%, Výstup = 12 300% Definice různých formátů v závislosti na hodnotě čísla. Obvykle jsou definovány 3 části oddělené od sebe středníky. První část definuje formát kladného čísla, druhá část formát záporného čísla a třetí část definuje formát zobrazení, pokud je číslo nulové. V tomto případě, kdy je explicitně definován formát záporného čísla, se před takovým číslem nezobrazuje znaménko -. Pokud je toto zobrazení požadováno, musí se nadefinovat v části pro zápornou hodnotu. V příkladu je definováno zobrazení vždy na jedno desetinné místo, záporná čísla v závorkách a pokud je číslo nulové, zobrazí se místo hodnoty "nula". Příklad: Hodnota = -2.713, Řetězec = #.#;(#.#);Nula, Výstup = (2,7) Příklad: Hodnota = 3.715, Řetězec = #.#;(#.#);Nula, Výstup = 3,7 Příklad: Hodnota = 0, Řetězec = #.#;(#.#);Nula, Výstup = Nula Vědecký formát. Používá se pro zobrazení čísel ve vědeckém formátu. Příklad: Hodnota = -0.027, Řetězec = 0.00e+0, Výstup = -2.70e-2
74/87
TROLVIEW
Tento seznam je pouze orientační. Podrobné informace o všech možnostech formátovacích řetězců naleznete na internetové adrese http://msdn2.microsoft.com/enus/library/fbxft59x.aspx.
11.3.
Formát typu IP adresa Proměnné, které mají definovaný datový typ Int32 nebo UInt32, lze převést na formát typu IP adresa. U ostatních datových typů tato možnost není.
Obr. 86 - Formát typu IP adresa
75/87
trolview_ms_cz_113
TROLVIEW
12.
Klávesové zkratky Oblast
Klávesa
Popis
IDE
Ctrl-W,S
Aktivace okna projektu
Ctrl-W,W
Aktivace scén
F3
Aktivace okna Variable Browser
F4
Login
Alt-F3
Aktivace okna Variable Browser a přepnutí na vyhledávání v souborech
Shift-F3
Aktivace okna Variable Browser a přepnutí na vyhledávání ve scénách
Ctrl-F3
Aktivace okna Variable Browser a přepnutí na vyhledávání ve scéně, která je právě aktivní. Není-li scéna aktivní, pak stejná funkce jako Shift+F3
Ctrl-dvojklik
Dvojklik na nalezeném výskytu aktivuje příslušnou scén, při držení Ctrl aktivuje příslušný uzel ve stromu projektu
Alt-F5
Načtení databáze ze stanice
Alt-F6
Načtení databáze ze souboru
F5
Dowlnoad programu do stanice
Ctrl+F5
Download předcházející verze programu do stanice
F8
Spuštění/zastavení komunikace
Ctrl-C
Zkopíruje vybranou scénu/prvek
Ctrl-V
Vloží zkopírovanou scénu/prvek
Ctrl-Enter
Editace parametrů aktivního prvku
Ins
Vložení nového prvku
Del
Smazání aktivního prvku
Ctrl-I,D
Vložení datalogeru
Ctrl-I,A
Vložení alarm logu
Ctrl-I,I
Vložení inspektora procesní proměnné
Ctrl-I,L
Vložení alarm inspektora
Ctrl-I,T
Vložení textu
Ctrl-B
Přepnutí do move/resize módu
Okno Projekt Scény
Prvky (obecně)
trolview_ms_cz_113
76/87
TROLVIEW šipky
Posun po 1 px
Ctrl-šipky
Posun po 10 px
Shift-šipky
Změna velikosti po 1 px
Shift-Ctrl- +
Změna velikosti po 10 px
Šipky Communication Ctrl-S
Zápis času PC (jen nad řádkem s časem stanice)
Browser
Ctrl-0,Ctrl-1
Seřazení podle x-tého sloupce
Database
Ctrl-F
Filtr pro hledání jména pomocí regulárního výrazu. Základní přehled použití regulárních výrazů je v další kapitole.
Space
Změna práv proměnné
Ctrl-0,Ctrl-1
Seřazení podle x-tého sloupce
Ctrl-<číslo>
Řazení podle sloupce,
Datafile Manager
0 – Name, 1 – Type, Shift-N
Nový datafile
Shift-O
Otevřít datafile
Shift-S
Uložit datafile
Shift-F,Ctrl-F Zaměření textboxu (potvrzení filtru Enter)
pro
zadání
filtru
Shift-C
Zapnutí/vypnutí zobrazení jen označených proměnných
Shift-+, Shift--
Označ/ zruš označení zobrazených proměnných
Shift-0,
Zapnutí/vypnutí filtru C
Shift-1,
Zapnutí/vypnutí filtru N
Shift-2,
Zapnutí/vypnutí filtru R
Shift-3
Zapnutí/vypnutí filtru P
F2
Zahájení editace hodnoty proměnné
Shift-R,
Načíst hodnoty označených proměnných ze stanice
Ctrl-R
všech
právě
Space
Označení/odznačení proměnné
Prvek / část
Klávesa
Popis
Alarm inspector
Alt-Left
Změna velikosti aktivního sloupce o 5 px
Alt-Right
77/87
trolview_ms_cz_113
TROLVIEW Ctrl-0, Ctrl-1 Seřazení podle x-tého sloupce
PDO
Ctrl-A
Zapnutí zobrazení všech/pouze aktivních alarmů
Ctrl-+
Změna banky na aplikační
Ctrl--
Změna banky na vnucenou
Ctrl-*
Negace banky
Ctrl-F
Změna formátu zobrazení
Alt-Left
Změna velikosti aktivního sloupce o 5 px
Alt-Right
Inspector
Ctrl-T
Toggle hodnoty bf o velikosti BOOL
Space, F2
Zahájení editace hodnoty proměnné / přepnutí banky (závislé na zvýrazněné části)
Ctrl-T
Toggle hodnoty na proměnné typu BOOL
Ctrl-F
Změna formátu zobrazení proměnné
Ctrl-I
Změna viditelnosti sloupce s komentáři
Alt-Left
Změna velikosti aktivního sloupce o 5 px
Alt-Right
dialog
Ctrl-+
Změna banky na aplikační
Ctrl--
Změna banky na vnucenou
Ctrl-*
Negace banky
Shift-B
Přizpůsobení velikosti okna aktuální velikosti vnitřní tabulky
Space, F2
Zahájení editace hodnoty proměnné / přepnutí banky (závislé na zvýrazněné části)
Ins
Přidání proměnné
Ctrl-Ins
Vícenásobné vkládání proměnné
Alt-Ins
Kopie proměnné
Del
Smazání proměnné ze seznamu
Ctrl-Up
Změna pořadí proměnných v seznamu
Ctrl-Dn AlarmLogger
Space
Editace zvýrazněné proměnné
Alt-Left
Změna velikosti aktivního sloupce o 5 px
Alt-Right
trolview_ms_cz_113
Ctrl-F
Výběr filtru
Ctrl-M
Editace filtrů
78/87
TROLVIEW Ctrl-A
Přepínání posunu na poslední řádek při příchodu nových alarmů.
Ctrl-E
Export dat s možností mazání
Ctrl-Q
Rychlý filtr. Zobrazí se jen záznamy alarmu, na kterém je právě aktivní řádek.
Ctrl-0,Ctrl-1
Seřazení dle x-tého sloupce
Ctrl-2,Ctrl-3 Datalogger
Ctrl-R
Načtení parametrů
záložka Control
Ctrl-W
Zápis parametrů
záložka Control
Ctrl-<číslo>
Řazení podle sloupce,
seznam proměnných
0 – Name, 1 – Type, Shift-O
Nahrání šablony setu proměnných
Shift-S
Uložení šablony setu proměnných
Shift-D
Smazání šablony setu proměnných
Shift-F,Ctrl-F Zaměření textboxu (potvrzení filtru Enter)
záložka View
pro
zadání
filtru
Shift-C
Zapnutí/vypnutí zobrazení jen označených proměnných
Shift-+, Shift--
Označ/ zruš označení zobrazených proměnných
Space
Označení/odznačení proměnné
Ctrl-L
Načtení záznamů
Crtl-F
Načtení záznamů od – do
Ctrl-T
Zobrazení v tabulce
Ctrl-G
Zobrazení v grafu
Ctrl-E
Export záznamů s možností mazání
seznam událostí Ctrl-+
všech
právě
Označení všech událostí
Ctrl--
Odznačení všech událostí
Ctrl-. (šedá Označení všech událostí starších než je tečka) vybraná Space
Označení/odznačení zvýrazněné události
událost
Ctrl-Shift-+
Označení všech proměnných
seznam proměnných
Ctrl-Shift--
Odznačení všech proměnných
Ctrl-Shift-*
Toggle označení všech proměnných
Space
Označení/odznačení zvýrazněné proměnné
79/87
trolview_ms_cz_113
TROLVIEW graf
Left,Right
Horizontální rolování
Ctrl+Left Ctrl-Right Home, End Up, Dn,
Vertikální rolování
PgUp,PgDn +,-
Zoom
Ctrl-Q
Zaměření prvku pro zoom
Shift-šipky
Posun vybraného bodu
dialog
Space
Nastaví aktuální čas
načtení od – do
Šipky
Přechod mezi hodnotami / inkrementace či dekrementace fokusované hodnoty
.
Přechod na další prvek (lze tedy typovat na klávesnici ‚1.1.1980‘ apod.)
Home
N.astavení na začátek dne (ponechá aktuální den, čas nastaví 00:00:00)
End
Nastavení na konec dne (ponechá aktuální den, čas nastaví 23:59:59)
Ctrl-Home
Nastaví na začátek měsíce (ponechá aktuální měsíc, den nastaví 1, čas 00:00:00)
Ctrl-End
Nastaví na konec měsíce (ponechá aktuální měsíc, nastaví poslední den, čas 23:59:59)
Ctrl-Space
Nastaví stejný datum/čas jako opačný prvek Je-li zaměřené From, zkopíruje do něj údaj To Je-li zaměřené To, zkopíruje do něj údaj From
Oscilogram
Ctrl-R
Načtení parametrů
záložka Parameters
Ctrl-W
Zápis parametrů
Ctrl-<číslo>
Řazení podle sloupce,
záložka Parameters seznam proměnných
0 – Name, 1 – Type, ….. Shift-L
Nahrání šablony setu proměnných
Shift-S
Uložení šablony setu proměnných
Shift-D
Smazání šablony setu proměnných
Shift-F,Ctrl-F Zaměření textboxu (potvrzení filtru Enter)
trolview_ms_cz_113
80/87
pro
zadání
filtru
TROLVIEW
záložka View
seznam sekvencí
Shift-C
Zapnutí/vypnutí zobrazení jen označených proměnných
Shift-+, Shift--
Označ/zruš označení zobrazených proměnných
Space
Označení/odznačení zvýrazněné proměnné
Ctrl-L
Spuštění / zastavení vzorkování
Ctrl-T
Zobrazení v tabulce
Ctrl-G
Zobrazení v grafu
Ctrl-J
Načtení záznamů vytvořených po startu zařízení (pokud je podporováno aplikací)
Ctrl-E
Export záznamů s možností mazání
Ctrl-+
Označení všech sekvencí
Ctrl--
Odznačení všech sekvencí
všech
právě
Ctrl-. (šedá Označení všech sekvencí starších než je tečka) vybraná Space
Označení/odznačení zvýrazněné sekvence
sekvence
Ctrl-Shift-+
Označení všech proměnných
seznam proměnných
Ctrl-Shift--
Odznačení všech proměnných
Ctrl-Shift-*
Toggle označení všech proměnných
Space
Označení/odznačení zvýrazněné proměnné
Left,Right
Horizontální rolování
graf
Ctrl+Left Ctrl-Right Home, End Up, Dn,
Vertikální rolování
PgUp,PgDn +,-
Zoom
Ctrl-Q
Zaměření prvku pro zoom
Shift-šipky
Posun vybraného bodu
81/87
trolview_ms_cz_113
TROLVIEW
13. 13.1.
Servisní nástroje TrolAlarmsLogExportProcess Z prvku AlarmLogger lze data exportovat za použití filtru (kapitola 7.7). Protože v tomto souboru jsou všechny informace, které obsahuje alarmový systém knihovny Trol, je k dispozici samostatná utilita, která vyexportovaný soubor (ve formátu csv, tedy textový soubor, kde jsou jednotlivé položky oddělené středníkem) rozdělí na servisní a provozní výpisy a nepotřebné položky ve větě ignoruje.
Provozní/servisní hlášení
Která hlášení jsou provozní a která servisní určuje vstupní soubor v parametru – P. Ze souboru 15T_Diagnostika-hlášení… exportovat do formátu csv list HLASENI_DISP. Soubor má mít následující podobu Sloupec
Význam
0
ID hlášení
1
Text hlášení
2
Komentář
3
Specifikace
Ve verzi 1.00 TrolAlarmsLogExportProcess je za provozní hlášení považováno hlášení se Specifikací rovno 0x80. Všechna ostatní hlášení jsou považována za servisní. Příklad provozních hlášení 0x00400100;Záchranná brzda cestujících - dveře 1; ;0x80 0x00410100;Záchranná brzda cestujících - dveře 2; ;0x80
Příklad servisních hlášení 0x00120100;UZEMNĚNO;TRAKČNÍ OBVODY UZEMNĚNY;0x74 0x00400000;ZÁCHRANNÁ BRZDA CESTUJÍCÍCH;AKTIVACE ;0x62
Program při svém spuštění vypíše nápovědu pro parametry na příkazové řádce. Program je součástí instalace TrolTools od verze 1.50.
13.2.
TrolDownload Nástroj umožňující nahrávání aplikace bez použití TrolView. Stejně jako TrolView umožňuje zálohování a obnovu parametrických proměnných.
trolview_ms_cz_113
82/87
TROLVIEW Syntaxe
TrolDownload [-d] comparams <downfile> -d
(volitelný) při použití parametru download bez zálohy a obnovy parametrických proměnných
comparams komunikační parametry (viz kapitola 13.6) <downfile> jméno a umístění nahrávaného .BIN Příklad zápisu
TrolDownload –d –a192.168.1.190 -t1000 E:\VYVOJ\Testy\APL.bin TrolDownload –d –c12 –38400 E:\VYVOJ\Testy\APL.bin
Program je součástí instalace TrolTools od verze 1.50.
13.3.
TrolCloneDataSet Nástroj slouží k záloze a obnově parametrizace dataloggerů (Data Set, Epsilon, Period, Trigger). Při obnově umožňuje využít filtr, kterým lze omezit změny v parametrizaci.
Syntaxe
TrolCloneDataSet w:r [-l
] [-e] [-p] comparams w:r
výběr typu operace w = obnova r = záloha
-l
proměnná, která obsahuje číslo vozu
-e
neprováděj obnovu parametru Epsilon (lze použít pouze při obnově parametrů)
-p
neprováděj obnovu parametru Period (lze použít pouze při obnově parametrů)
comparams komunikační parametry (viz kapitola 13.6) <downfile> jméno a umístění nahrávaného .BIN Příklad zápisu
TrolCloneDataSet r –a192.168.1.190 –t1000 Params.tvws TrolCloneDataSet r –c8 –s38400 Params.tvws TrolCloneDataSet w –c10 –s38400 Params.tvws TrolCloneDataSet w –c10 –s38400 –e Params.tvws TrolCloneDataSet w –a192.168.1.190 –t1000 –p Params.tvws
Program je součástí instalace TrolTools od verze 1.60.
13.4.
TrolLogger Provede stažení záznamů dataloggeru a alarmloggeru. Ze stažených dat sestaví TrolView projekt, ve které bude pro každý
83/87
trolview_ms_cz_113
TROLVIEW datalogger samostatná scéna (Datalog X) s prvkem Datalogger. Pro alarmy bude vytvořena scéna Alarms s prvkem AlarmLogger. V projektu bude též nastavena komunikace dle parametrů, které byly použity pro stahování záznamů. Scéna se jménem *Info* slouží ke krátkému popisu projektu (viz následující obrázek).
Obr. 87 - Obsah scény *Info* Syntaxe
TrolLogger a:d:ad:da –w –p comparams a:d:ad:da
výběr typu exportovaných záznamů a = pouze alarmy d = pouze datalogger ad = datalogger i alarmy da = datalogger i alarmy
-w proměnná, která obsahuje číslo vozu -p rozmezí vyčtení záznamů, datum (od – do) ve formátu YYYY/MM/DD nebo DD.MM.YYYY comparams komunikační parametry (viz kapitola 13.6) Příklad zápisu
TrolLogger ad –wWAGON –p1.11.2009–2.11.2009 –a192.168.1.190 –t1000 TrolLogger ad –wWAGON –p2009/11.01-02.11.2009 –c12 –s38400
Program je součástí instalace TrolTools od verze 1.50.
trolview_ms_cz_113
84/87
TROLVIEW
13.5.
TrolParameters Slouží k zálohování a obnově hodnot proměnných bez nutnosti použití TrolView.
Syntaxe
parametrických
TrolParameters b:r comparams typ operace – jedna z možností:
b:r
b = zálohování (backup), r = obnova (restore) comparams komunikační parametry (viz kapitola 13.6)
Příklad zápisu
umístění vstupního/výstupního (obnova/záloha) souboru .tvwd
TrolParameters b –c12 –s38400 backup.tvwd TrolParameters r –a192.168.1.190 –t1000 backup.tvwd Program je součástí instalace TrolTools od verze 1.50.
13.6.
Comparams - přehled parametrů komunikace Následující tabulka obsahuje přehled parametrů, kterými lze nastavit komunikaci při použití nástrojů TrolDownload, TrolLogger a TrolParameters. Parametr
Význam
-i
cesta k .ini souboru, který obsahuje komunikační parametry
-a
IP adresa stanice (např. 10.0.0.1) v síti Ethernet
-c
číslo COM portu, na kterém je připojena stanice, pro komunikaci přes RS232
-n<station>
(volitelný) číslo stanice – default 1
-s<speed>
rychlost komunikace [Bd] pro RS232
-t
(volitelný) timeout [ms] Ethernet – default 3000
pro
připojení
přes
Povolené kombinace parametrů -i [-n<station>]* *
Volitelné parametry
85/87
trolview_ms_cz_113
TROLVIEW -c -s<speed> [-n<station>]* -a[:] [-t] [-n<station>]* Inifile
Tvar souboru Inifile Řetězec s popisem HW má formát INI souboru.
Ethernet
Pro připojení pomocí Ethernetu je nutné zadat IP adresu případně UDP port zařízení, timeout komunikace (udává se v ms) a HW číslo stanice. [UDP] Address=10.0.0.1:1001 Timeout=500 Station=1 Pro připojení více stanic najednou může řetězec obsahovat více sekcí [UDP] z nich každá nezávisle popisuje jednu stanici.
RS232
Pro připojení pomocí RS232 je nutné zadat číslo COMu, rychlost komunikace a HW číslo stanice. [COM] COM=1 Speed=19200 Station=1 Pro připojení více stanic najednou může klíč Station obsahovat seznam stanic oddělených čárkou (například Station=1,2,7,11).
trolview_ms_cz_113
86/87
TROLVIEW
14.
FAQ Následující kapitola popisuje řešení známých problémových situací.
14.1.
Nahrání aplikace pro CAN8 zařízení do CAN4 Po nahrání aplikace, která je určena pro CAN8 zařízení do zařízení CAN4 (nebo opačně) je třeba další nahrávání aplikace provést následujícím způsobem: 1. Upravit aplikaci pro správný typ zařízení 2. Připojit se k zařízení přes USB 3. Nastavit správně komunikační parametry 4. Nahrát opravenou aplikaci, při nahrávání postupovat dle Kapitoly 4.2 Download programu pokud stanice nekomunikuje, volba “Backup and restore param variables“ nesmí být zaškrtnuta!
87/87
trolview_ms_cz_113
