Přeskočit obsah

Datové body a prvky dashboardu

Dashboard propojuje program a jeho ovládací panel pomocí datových bodů. Prvky určují, jak tyto body zobrazíš nebo změníš.

Datový bod není prvek panelu

Datový bod představuje jednu přenášenou hodnotu s daným typem a směrem komunikace. Vytvoří právě jeden vnější vstup na bloku Dashboard.

Prvek je její zobrazení nebo ovladač na ploše. Jeden datový bod můžeš přiřadit více prvkům: například číslu a grafu, nebo posuvníku a současně číselnému displeji. Všechny pracují se stejnou hodnotou; nevznikají kvůli nim další vstupy bloku.

Správa datových bodů

V režimu Upravit otevři Datové body a klikni na + Přidat. V seznamu vybíráš bod, jehož údaje chceš upravit.

Správa datových bodů: název, typ, směr komunikace a informace o zapojení do bloku

Položka Co nastavuje
Název Srozumitelný popisek bodu. Nemusí se shodovat s názvem proměnné v programu.
Typ Druh přenášené hodnoty: celé číslo, desetinné číslo, ano/ne nebo text.
Směr komunikace Zda program hodnotu poskytuje panelu, přijímá změny z panelu, nebo obojí.
Připojená proměnná / informace o zapojení Údaj rozpoznaný z vnějšího vstupu bloku. Proměnnou zde nevybíráš; zapojuješ ji na Blockly ploše.
Odebrat bod i jeho prvky Odstraní bod a všechny prvky, které ho používají. Pro odstranění pouze jednoho zobrazení maž samotný prvek.

Nový bod začíná jako Desetinné číslo se směrem Čtení i zápis. Nastav je podle skutečného účelu; pro pouhé zobrazování měření obvykle potřebuješ Čtení z procesoru.

Použít přijme změny do rozpracovaného návrhu. Zrušit ve správě bodů vrátí stav před jejím otevřením. Celý návrh nakonec potvrď tlačítkem Uložit v editoru dashboardu.

Typy hodnot

Typ K čemu slouží
Celé číslo Počty, indexy a číselné hodnoty bez desetinné části. U číselných ovladačů používej celočíselný rozsah i krok.
Desetinné číslo Měření a nastavení, která mohou mít desetinnou část. Počet zobrazených desetinných míst se nastavuje zvlášť na prvku.
Ano / ne Logické hodnoty, například povoleno/zakázáno. Používá je Stav a Přepínač.
Text Textové zprávy a zadání řetězce. Není to číselná hodnota jen proto, že obsahuje číslice.

Po změně typu nebo směru zkontroluj připojené prvky. Nepodporované zobrazení může editor nahradit obecným prvkem Hodnota.

Směry komunikace

Směr je pojmenovaný z pohledu procesoru, nikoli z pohledu obrazovky.

Volba Tok hodnoty Co připojit na vstup bloku
Čtení z procesoru Program → panel Proměnnou nebo jinou čtecí hodnotu či výraz.
Zápis do procesoru Panel → program Přímo čtecí blok proměnné, do které se má přijatá hodnota uložit.
Čtení i zápis Program ↔ panel Přímo čtecí blok proměnné; program ji zobrazuje a panel ji může změnit.

Pro běžný ovladač se zpětným zobrazením hodnoty použij Čtení i zápis. Chceš-li sledovat skutečný stav programu, zvol čtení nebo obousměrný přenos, nikoli pouze zápis.

Zapojení na Blockly ploše

Po uložení návrhu má blok Dashboard jeden vstup pro každý datový bod. Popisek odpovídá jeho názvu.

Blok Dashboard s čtecím výrazem analogového vstupu a dvěma přímo připojenými proměnnými pro ovládání

  • Pro zobrazení můžeš připojit přímo měření, výpočet, text nebo proměnnou odpovídajícího typu.
  • Pro ovládání připoj běžný čtecí blok proměnné. Výraz typu součet dvou čísel nemá jediné místo, do kterého by šla přijatá hodnota zapsat.
  • Počáteční hodnoty nastav před prvním průchodem dashboardem, například v úvodní části programu.

Každý vstup se při průchodu blokem vyhodnotí jednou. Vygenerovaný program převezme přijaté změny a přiřadí je příslušným proměnným. Další chování už určuje tvůj program.

Program může hodnotu zase přepsat

Pokud v každém průchodu smyčkou bez podmínky nastavíš ovládanou proměnnou zpět na pevné číslo, změna z panelu nemusí vydržet. Jednorázové výchozí nastavení proto nepatří do opakované části. Ovladač také sám nezapíná motor nebo LED: program musí přijatou proměnnou skutečně používat.

Přejmenování proměnné v projektu zachovává její vazbu. Po odpojení vstupu, odstranění proměnné nebo změně konfigurace ale propojení znovu zkontroluj.

Přehled prvků

Nabídka dostupných zobrazení vychází z typu bodu a povoleného směru komunikace. Ovladače pro zápis nejsou nabízené u bodu určeného pouze ke čtení z procesoru.

Prvek Typ hodnoty K čemu slouží
Hodnota Všechny čtyři typy Zobrazuje poslední přijatou hodnotu; pro čísla může mít jednotku a nastavená desetinná místa.
Stav Ano / ne Stavový indikátor s textem pro ano/ne. Hodnotu jen zobrazuje.
Zadání čísla Celé nebo desetinné číslo Přímé zadání nové hodnoty do programu. Vyžaduje povolený zápis.
Zadání textu Text Zadání řetězce. Vyžaduje povolený zápis.
Posuvník Celé nebo desetinné číslo Nastavení hodnoty tažením, tlačítky −/+ nebo číselným polem. Vyžaduje povolený zápis.
Přepínač Ano / ne Přepínání logické hodnoty. Vyžaduje povolený zápis.
Tlačítko Všechny čtyři typy Po kliknutí zapíše jednu předem nastavenou hodnotu. Vyžaduje povolený zápis.
Graf Celé nebo desetinné číslo Zobrazuje historii jednoho bodu podle skutečných časů přijetí dat.
Ručička Celé nebo desetinné číslo Obloukový ukazatel hodnoty mezi nastaveným minimem a maximem.
Kruhový ukazatel Celé nebo desetinné číslo Kruhové vyjádření polohy hodnoty v rozsahu. Při použití pro procenta nastav odpovídající rozsah a jednotku.

Nastavení vybraného prvku

Vlastnost Význam
Název Vlastní nadpis konkrétního prvku. Bez něj se použije název datového bodu.
Datový bod Hodnota, kterou tento prvek používá. Více prvků může mít stejný bod.
Zobrazení Změna typu prvku v mezích toho, co daný bod podporuje.
Jednotka Zobrazovaný doplněk čísla, například °C nebo %. Sama hodnotu nepřepočítává.
Desetinná místa Počet zobrazených míst, 0–8. Formátuje zobrazení, nemění výpočet v programu.
Minimum / Maximum Rozsah ovladače nebo ukazatele. Minimum musí být menší než maximum.
Krok Velikost změny čísla či posuvníku; musí být kladná. U celého čísla použij celočíselné nastavení.
Text pro ano / Text pro ne Vlastní popisky logického stavu. Nemění typ bodu na text.
Hodnota zapisovaná tlačítkem Přesná hodnota odeslaná po kliknutí na Tlačítko.
Počet bodů v grafu Nejvýše uchovávaný počet zobrazených vzorků pro daný graf.
Šířka / Výška Rozměry prvku v mřížce editoru.

Některá pole se zobrazují jen u odpovídajícího typu prvku. Rozsah posuvníku není obecnou ochranou proměnné ve všech částech programu; program ji může sám změnit i mimo něj.

U kruhového ukazatele určuje minimum a maximum zaplnění kruhu. Číslo uvnitř ale zůstává přijatou hodnotou; samotný ukazatel ji nepřepočítává na procenta. Chceš-li data z rozsahu 0–1 zobrazovat jako 0–100 %, proveď přepočet v programu nebo připojeném čtecím výrazu.

Jak se potvrzuje ovládání

U číselného nebo textového zadání potvrď změnu Enterem nebo opuštěním pole. Posuvník při tažení ukazuje náhled, hodnotu odešle při potvrzení změny, typicky po puštění. Jeho tlačítka −/+ mění hodnotu podle kroku; číslo můžeš zadat i přímo. Escape v číselném poli posuvníku rozpracovanou změnu zruší.

Tlačítko není automaticky tlačítkem „držím / pustil jsem“. Zapíše nastavenou hodnotu při kliknutí a při puštění samo neodešle opačnou. Pokud má proměnná po zpracování povelu opět změnit stav, musí to zajistit program.

Graf a historie

Graf zobrazuje jeden datový bod. Pro další veličinu přidej další graf. Dva grafy téhož bodu mohou mít různý počet uchovávaných vzorků.

  • Počet bodů v grafu: 2 až 10 000, výchozí 250.
  • Časová osa vychází z reálného přijetí dat, nikoli z pouhého násobení nastavené obnovy.
  • Svislá osa se přizpůsobuje zobrazeným datům.
  • Historie je v paměti otevřeného panelu prohlížeče. Po novém načtení se naplňuje znovu.
  • Export .espdash.json historii nepřenáší.

Při pravidelném přenosu po 100 ms pokryje 250 bodů přibližně 25 sekund. Při méně častých průchodech programu nebo nepravidelných datech bude skutečná délka jiná. Rozhodující je časová osa a údaj o poslední aktualizaci.