Název
Pojmenování ePaperu - ať víte o který se jedná až jich budete mít vícero.

MAC adresa ePaperu
Fyzická adresa síťového (bezdrátového) rozhraní, podle které se ePaper jednoznačně identifikuje vůči serveru.

API klíč
Volitelné zabezpečení od firmware 3.0 - zařízení se na server hlásí MAC adresou a nově i API klíčem, což je 8 číslic. API klíč musí souhlasit s tím, který je vyplněný u zařízení (pokud ho vyplníte). Pokud nesouhlasí, tak se na zařízení objeví chybová hláška spolu s klíčem, který na serveru má být uvedený.

Poznámka
Libovolná další informace k displeji či jeho identifikace - popis umístění, kapacity baterie, typu rámečku…

Rozlišení displeje
Určuje v jakém rozlišení musí být obrázek nahrávaný do ePaperu. Toto rozlišení musí mít přesný rozměr jako displej.

Barevnost
Podle barevnosti se rozlišuje nakolik a do jakých barev se má upravit obrázek před odesláním do ePaperu.

Skupina
Pro účely správy můžete zařízení rozdělit do skupin. Buď zvolte z rozbalovacího menu jednu z již vytvořených skupin, nebo do pole "Nová skupina" vepište název nové skupiny - ta se při uložení vytvoří a zařízení se do ní zařadí.

Pro využití počasí máte hned dvě možnosti - můžete ePaperu zvolit jako aktivní obsah galerii, která počasí zobrazuje, nebo můžete využít některé vyčtené údaje o počasí ve vlastní obrazovce. Pro vyčítání počasí je potřeba vyplnit zeměpisnou šířku a délku, kterou můžete nechat předvyplnit zvolením položky "Vyplnit souřadnice podle obce v ČR:" a následným uložením údajů.

Zeměpisnou šířka a délku můžete vyplnit také ručně - jde o GPS údaj umístění např. z mapy.cz, pro které má být vyčítané a zobrazené počasí v kompatibilní galerii, která takovou informaci umí využít.

Pro zjištění konkrétní zeměpisné šířky a délky (pokud nechcete vyplnit souřadnice podle obce výše na stránce) použijte například http://www.mapy.cz Najděte na mapě místo, pro které chcete získávat předpověď počasí a klikněte na to umístění pravým tlačítkem myši. Následně z nabídky zvolte „Co je zde?“ a poté v pravém panelu klikněte na GPS. Číselnou hodnotu souřadnic bez koncového rozlišení „N“ a „E“ zkopírujte/přepište do nastavení čidla.

Výška metrů nad mořem
To samé, jen údaj v celých metrech.

Ukládat počasí i do Hodnot pod názvem
Chcete-li některé údaje z počasí využít také na vlastní Obrazovce, vyplňte zde název místa, ke kterému se vyčtené počasí vztahuje. Následně po vyčtení počasí serverem najdete pod "Hodnoty" záložka "Počasí" řádky s některými údaji a v poznámce bude uvedeno "Počasí - " a vámi vyplněný název. Více o Hodnotách se dozvíte na stránce Hodnoty.

Až 4 přednastavené iCal kalendáře přímo na úrovni ePaperu. Zobrazí je kalendářový widget na obrazovce, aniž byste mu URL museli vyplňovat zvlášť.

iCal URL = tajná „odběrová“ adresa kalendáře (typicky končí .ics). Najdete ji v Apple, Google, Microsoftu a podobně pod Sdílet / Publikovat / Tajná adresa ve formátu iCal - bližší inforamce jak adresu získat najdete v nastavení kalendářového widgetu v sekci Obrazovky.

Prefix (vlevo, nepovinný) je krátký text, který se vypíše před názvem každé události z daného kalendáře – například "M", "Práce"… Pomáhá rozlišit více kalendářů na jednom displeji.

Aby se zde vyplněné kalendáře skutečně zobrazily, musí mít obrazovka kalendářový widget se zapnutou volbou „Přepsat kalendáři nastavenými pod e-paperem“. Bez ní si widget bere kalendáře z vlastního nastavení.

Po uložení server kalendář natáhne do paměti a aktualizuje ho přibližně jednou za hodinu – nové změny událostí se tedy projeví s mírným zpožděním.

Lze kombinovat – stačí vyplnit jen URL #1, nebo třeba všechny 4. Prázdné řádky se ignorují.

Určuje odkud se má brát obrázek pro ePaper - je potřeba mít nahraný/nastavený obsah pro zvolený zdroj. Např. pro vlastní obrázek k ePaperu nějaký nahrát (viz záložka "Vlastní obrázek"), v případě URL mít vyplněné nějaké, které vede přímo na obrázek apod. Jako zdroj obsahu je také možné použít "Pokročilý rozvrh" ve kterém je možné definovat v jakou denní hodinu se má použít jaká Obrazovka/Galerie/URL pro zobrazení na ePaperu.

Galerie
Zdroj obsahu pro ePaper - buď nějaká přednastavená galerie nebo ta, kterou si na serveru sami dáte dohromady případně nějaká sdílená od jiného uživatele.

Obrazovka
Vámi definovaná obrazovka s údaji, která se vygeneruje do obrázku pro zobrazení na ePaperu.

URL s obrázkem (JPG, PNG, GIF, WEBP)
URL na obrázek ve formátu JPG nebo PNG, který se má do ePaperu nahrát. Více informací o tomto zdroji obsahu pro ePaper najdete na samostatné stránce URL. Pro obrázek stahovaný z URL můžete zapnout dithering - více o tom co tato metoda znamená se dočtete na stránce Optimalizace obrázku.

Připojovat se na URL/server každých X minut
Pro URL a vlastní obrázek zde můžete nastavit na jak dlouhou dobu se má ePaper uspat, než se znovu připojí na server pro kontrolu obsahu.

Rozvrh
Pro Galerii, Obrazovku a URL můžete nastavit rozvrh, kdy má dojít k obnovování obrázku na ePaperu. Jakmile bude rozvrh aktivní a ePaper se připojí pro nový obsah na server, tak se právě podle rozvrhu určí, za jak dlouho se má příště připojit. Čím déle bude ePaper čekat, tím větší může vzniknout odchylka pro připojení, ale to je vlastnost.

Můžete nastavit pro jednotlivé hodiny 0-23, zda dojde k připojení v jeden přibližný čas, nebo se má obrazovka obnovit vícekrát a v tom případě nastavit interval pro dané hodiny.

Pokud z nějakého důvodu chcete v rámci dne míchat i Zdroje obsahu, použijte pro tento účel právě speciální Zdroj obsahu Pokročilý rozvrh, který je přímo pro tento scénář určený.

Rozvrhem je možné vynutit přepsání i v jiné časy, než jaké mohou být specifikované u konkrétní galerie. Bývá ale lepší v tomto případě nechat ty výchozí, kdy např. pro zobrazení dne se svátkem (kalendář Portal a další) stačí jedna obnova někdy po půlnoci.

Jak na to:

1. Jako výchozí interval zvolte hodnotu, která bude převládat, ať ji nemusíte nastavovat u většiny hodin v rámci dne. Typicky můžete nechat vyplněné neobnovovat a vyplnit čas jen u těch hodin, kdy naopak obnovovat chcete.
2. Následně u těch hodin, kde chcete mít jinou hodnotu než výchozí, zvolte právě onu požadovanou hodnotu. Např. pokud chcete obnovit ePaper jen jednou v 6.00, 12.00 a 20.00, tak u hodin 6, 12 a 20 zvolte hodnotu "v :00". Pokud byste v některých hodinách chtěli obnovovat např. co 10 minut (tedy 6x za hodinu), pak pro tyto hodiny zvolte hodnotu "10 minut" apod.

Pokud chcete konkrétní rozvrh použít i u jiného ePaperu, můžete ho jednoduše zkopírovat - pod rozvrhem v položce "Zkopírovat rozvrh do" zvolte cílový ePaper a na stránce přes Upravit uložte hodnoty. Rozvrh se tak zkopíruje, ale u cílového ePaperu nezmění Zdroj obsahu (pro který je rozvrh vytvořený). Je potřeba tak případně zdroj přenastavit a použití rozvrhu aktivovat.

Povolené IP adresy, ze kterých se zařízení může připojit a načíst obrázek
Je možné zadat více IPv4/IPv6 adres oddělených čárkou. Tuto ochranu nastavte až po odzkoušení příjmu obrázku do zařízení, abyste měli jistotu, že základ chodí. Díky této ochraně si nikdo jiný nemůže načíst váš obrázek. Adresa obrázku pro ePaper je pevně daná a kdokoliv může zkoušet načíst obrázek pro různé MAC adresy. Touto ochranou zamknete přístup pouze na konkrétní IP adresu. Tu najdete na záložce "Logy" když dáte upravit konkrétní ePaper (a již proběhla nějaká komunikace se serverem). U adres IPv4 je navíc možné zadat rozsah adres ve formátu CIDR, možné tvary zadání např.:
75.28.10.0/24
75.28.10.0/24,85.207.0.56

HTTP adresa pro zasílání naměřené teploty ePaperem
Adresa, kam zasílat měření z připojeného čidla (máte-li nějaké). Nejlepší je využít službu https://www.tmep.cz a vložit sem doménu pro zápis hodnot. Na vložené URL budou přes HTTP GET serverem Živého obrazu zasílány proměnné (jen ty, pro které existuje aktuální hodnota):

Sem budou časem doplňované další položky k nastavení, které mohou být vyžadovány novými funkcemi.

Zde je možné zkorigovat naměřenou hodnotu teploty/vlhkosti/… tím, že uvedete kladné/záporné číslo, které se má u konkrétní naměřené hodnoty přičíst/odečíst.

Pokud chcete mít jednu Obrazovku pro více zařízení, ale na každém načítat trochu jiný obsah, tak toho můžete docílit právě pomocí zástupných proměnných. Můžete definovat libovolný počet proměnných, které budou nahrazené obsahem, který rovněž definujete. Můžete tak např. pod 2 zařízení nastavit proměnnou "umisteni", dát jí obsah pod každým zařízením jiný, např. "koupelna", "loznice" apod. do Obrazovky umístíte hodnotu s dynamickým názvem:

{{umisteni}}_teplota

a budete posílat na server hodnoty:
koupelna_teplota
loznice_teplota

Oběma zařízením nastavíte stejnou Obrazovku, ale každé uvidí jinou hodnotu právě na základě proměnné, která je nastavená u zařízení.

Doladění odchylky vnitřního časovače ePaperu, aby se probouzel přesně podle plánu.

Vnitřní časovač desky ESP nebývá přesný – odchylka může být i okolo 5 %. Důsledkem je, že ePaper se z hlubokého spánku probouzí dříve (typicky) nebo později, než byste čekali. Kompenzace je násobitel doby spánku:

1.00 = beze změny
1.05 = spánek o 5 % delší (zařízení se probouzí později)
0.95 = spánek o 5 % kratší (zařízení se probouzí dříve)

Faktor progresivity určuje, jak moc se má kompenzace u dlouhých intervalů zmenšovat. Je rozumné ji zmenšovat, protože stejná procentuální chyba u 24hodinového spánku znamená násobně větší absolutní chybu než u 30minutového.

0 = lineární (procentuální kompenzace stejná pro všechny intervaly, absolutní rozdíl roste)
0.5 = mírně progresivní (rozumný start)
1 = absolutní rozdíl konstantní (procentuální kompenzace klesá s délkou)

V tabulce dole se okamžitě zobrazí, jak moc se která modelová doba (30 min až 24 h) po kompenzaci posune – nemusíte nic přepočítávat.

Manuální výběr konkrétního buildu firmwaru, který má server při dalším kontaktu nabídnout ePaperu k OTA aktualizaci.

Slouží k nasazení konkrétní verze – například když chcete vyzkoušet novější/starší build.

V seznamu se objeví jen buildy kompatibilní s vaší kombinací desky a displeje (server musí o desce a displeji vědět, což znamená alespoň jeden kontakt zařízení po nasazení FW 3.0+). Po úspěšné aktualizaci se požadavek z databáze sám smaže

Pokud máte hlavní volbu OTA – Povolená aktualizace firmwaru vzduchem vypnutou a něco zde vyberete, OTA se při uložení automaticky zapne.

Pokud zde žádný build nevidíte: zařízení ještě se serverem nikdy nemluvilo na FW 3.0+, nebo pro vaši kombinaci desky a displeje aktuálně žádný kompatibilní build neexistuje.

Vynutit invertování u Obrazovky
Chcete-li na konkrétním e-paperu nějakou Obrazovku vynutit do invertovaného (nebo naopak vždy běžného zobrazení), abyste pro něj vynutili jiné chování než jaké je nastavené u Obrazovky, tak toho touto volbou můžete docílit.

OTA – Povolená aktualizace firmwaru vzduchem (od FW 3.0)\ Povolení/zakázání OTA. Když je OTA zapnuté, ePaper si umí stáhnout nový firmware vzduchem bez USB.

Server čas od času nabídne novější verzi firmwaru a zařízení si ji při kontaktu samo stáhne a nainstaluje. Restart proběhne automaticky a obsah se po něm znovu vykreslí.

Funkce vyžaduje FW 3.0 nebo novější – starší firmware OTA neumí a tato volba na něj nemá vliv. OTA vždy nabízí jen buildy, které jsou kompatibilní s vaší deskou a displejem (žádný „cizí“ FW se nestáhne).

Vypnout dává smysl výjimečně – například při ladění vlastního firmwaru, kdy nechcete, aby vám ho server přepsal.

Otočit obrázek o 180° (pro ePaper vzhůru nohama)
Funguje jen pro vlastní obrazovky. Slouží primárně pro desku ES3ink od @dronecz, která má obraz otočený o 180 st. a aby byl v rámečku správně zobrazený, tak je potřeba do ePaperu poslat obraz již přetočený.

Zobrazit obrazovku s nastavením Wi-Fi přivýpadku
Při výpadku Wi-Fi se na zařízení zobrazí obrazovka s nastavením Wi-Fi a QR kódem. Pokud je toto nastavení vypnuté, zůstane zobrazený poslední známý obsah. Je to pro případy, kdy je potřeba mít vždy zobrazenou obrazovku s obsahem nebo si ji jen nechcete "kazit" informací o zrovna nedostupné Wi-Fi. V takovém případě se zařízení pokouší znovu brzy připojit, takže obsah by neměl zůstat dlouho zastaralý. Pokud zařízení ani tak neuspěje, tak se o nepřekreslení zařízení dozvíte upozorněním v e-mailu (které je ve výchozím stavu zapnuté a přijde e-mail 1 hodinu poté, kdy se zařízení mělo původně připojit - viz výstrahy níže).

Počítat kontrolní součet obsahu
Šetří překreslení displeje pokud se obsah Obrazovky nezměnil - před odesláním obsahu do zařízení se vypočítá kontrolní součet, jestli jsou nová data odlišná od těch předchozích. Pokud ano (a liší se byť v jediném pixelu), tak budou celá odeslaná do zařízení a to překreslí displej. Pokud nikoliv, tak k překreslení nedojde a zařízení se uspí na další dobu podle plánu. Jestli displej nebyl překreslený více jak 24 hodin, tak k překreslení i tak dojde - kvůli obnovení displeje a prevenci tzv. ghostingu. Při restartu zařízení k překreslení dojde vždy.

Obnovit displej po konci nejbližší události v kalendáři

Když je na obrazovce kalendář, displej se může obnovit ihned po skončení události a tedy ukázat/vybarvit tu další – nikdy se ale neposune dál, než byl plánovaný refresh.

Při uspání server porovnává:
čas, kdy by se zařízení normálně probudilo podle nastavení obnovení,
čas konce nejbližší probíhající nebo nadcházející události v kalendáři\\, a vybere ten dřívější.

V praxi: pokud máte refresh každou hodinu a schůzka končí za 17 minut, displej se obnoví za 17 minut – ne až za hodinu, kdy už by na něm bylo zastaralé „právě probíhá schůzka“.

Pokud na obrazovce kalendář není (nebo je v něm jen jedna velmi vzdálená událost), funkce nemá co řešit a displej se obnovuje podle běžného plánu.

Hlídač neaktivity ePaperu
Po jaké době od očekávaného kontaktu má být poslána na e-mail výstraha, že ePaper nekomunikoval i když měl.

Oznámit opětovnou aktivitu ePaperu
Má být na e-mail oznámeno i to, že ePaper se na server přihlásil (a tedy začal opět komunikovat)?

Při poklesu napětí zobrazovat na ePaperu obrazovku s varováním
Pokud napětí poklesne na cca 3.4 V, tak se začne místo obsahu objevovat varování s informací, že je potřeba dobít baterii a doba obnovení ePaperu se začne postupně prodlužovat s klesajícím napětím.

Baterie
Zde je možné specifikovat rozsah napětí od/do aby byla zobrazena přibližná procentuální kapacita. Vybíjení baterie je nelineární a hodnota v procentech je tedy orientační. Pokud rozsah nevyplníte, pak bude zobrazeno vyčtené napětí ve voltech. Můžete si zde nastavit upozornění e-mailem na pokles napětí pod určitou hodnotu abyste věděli, že je potřeba baterii dobít.

Vlastní obrázek
Chcete-li na ePaperu zobrazit vlastní obrázek, můžete jich na této záložce nahrát hned několik najednou a zvolit si vždy ten konkrétní, který se má právě zobrazovat a který se při dalším kontaktování ePaperu na server nahraje na displej. Nahrávejte formát JPG nebo PNG, ideálně v rozlišení jako má displej. Je lepší rovnou obrázek upravit na černobílý a udělat ho kontrastní, aby dobře vyniknul. Nezapomeňte jako aktivní zdroj obsahu pro ePaper zvolit právě "Vlastní obrázek". Obrázek je vhodné ještě dát optimalizovat pro zobrazení na konkrétním ePaperu.

Nastavit první z nahraných fotek jako aktivní (a přepnout zdroj obsahu)
Po zaškrtnutí této volby se nastaví jako zdroj obsahu pro ePaper právě "Vlastní obrázek" a zvolí se právě nahrávaný obrázek jako ten aktivní (nahráváte-li jich víc, pak to bude ten první v pořadí).

Tyto záložky slouží k ladění a obsahují diagnostická data - uvidíte, jaké hodnoty ePaper zasílá na server. Typicky je to MAC adresa, jeho rozlišení, barevnost displeje, verze firmwaru a případně ještě naměřené hodnoty (je-li připojeno čidlo teploty/vlhkost/tlaku…).

Také zde naleznete jednoduché grafy vývoje napětí na baterii, signálu na Wi-Fi a případných naměřených hodnot.

Podle záložky Počty připojení si můžete zkontrolovat kolik připojení denně je aktuálně potřeba na server a jaký to má přibližný dlouhodobý dopad na baterii.

Vizuální průběh klíčových údajů, které ePaper hlásí při každém kontaktu se serverem.

• Napětí baterie (V) – průběh vybíjení / nabíjení.
• RSSI (dBm) – síla Wi-Fi signálu v místě, kde je ePaper.
• Teplota / Vlhkost / Tlak / CO₂ – pokud má zařízení připojené čidlo.

Pro každý údaj jsou zobrazené dva grafy nad sebou: nahoře krátký výřez (poslední den – detail probíhajícího dění), dole širší pohled (3 měsíce, případně 1 rok – dlouhodobý trend).

Svislá čára v grafu odděluje dnešní data od starších – snadno tak vidíte, kde končí historický vývoj a začíná aktuální den. Hodnoty zjevně mimo rozsah (typicky 0 jako výpadek čidla nebo velký skok proti předchozí hodnotě) jsou automaticky filtrovány, aby graf nebyl deformovaný.

Dlouhodobé statistiky všech naměřených údajů z denních agregací. Pro každou metriku (napětí baterie, RSSI, teplota, vlhkost, tlak/CO₂, teplota CPU, doba stažení obrázku, doba překreslení displeje) se zobrazuje tabulka min / průměr / max / dnů s daty v několika obdobích:

• Celkem – za celou dobu existence zařízení v databázi.
• Posledních 7, 30 a 365 dnů – aktuální stav za poslední týden, měsíc a rok.
• Po letech – přehled rok po roce.
• Po měsících – posledních 24 měsíců.

Důležité poznámky:

• Průměr je vážený podle počtu měření daného dne, takže dny s mnoha měřeními mají větší vliv (a krátké dny s pár měřeními výsledek nezkreslí).
• Hodnoty zjevně chybné (např. denní minimum vlhkosti pod 10 % nebo přesně 0,0 °C) se z výpočtu min vynechají, ale den se nadále započítá do průměru, maxima i počtu dnů.
• Záložka neobsahuje počty kontrol/překreslení – ty patří pod Aktivita.

Nahoře na stránce jsou tlačítka pro rychlý skok na konkrétní metriku, vedle nadpisu každé tabulky pak ikonka pro návrat na začátek seznamu.

Posledních ~20 "syrových" HTTP požadavků, které ePaper poslal serveru (volání API se všemi parametry – MAC, baterie, teplota, RSSI, verze FW…).

Záznamy se uchovávají přibližně 2 dny zpětně.

Ověříte tak, jestli zařízení vůbec komunikuje a z jaké IP adresy. Vidíte přesně, co server od ePaperu dostává – ideální pro ladění čidel nebo nestandardních hodnot. Když „něco nefunguje“, je to první místo, kam se podívat.

Tlačítkem Obnovit nad tabulkou si vyžádáte nejnovější záznamy bez nutnosti klikat „obnovit“ na celou stránku.

Přehled, jak často se ePaper hlásí na server a moc se baterie (ne)vybíjí.

Záložka má dvě části:

Výdrž na baterii – automaticky detekované cykly mezi nabíjeními (skok napětí ≥ 0,15 V mezi sousedními dny). Pro každý cyklus je vidět:

• datum od – do
• počet dnů cyklu
• počet kontrol (každé hlášení se serverem) a počet překreslení displeje za celý cyklus
• počáteční a poslední napětí a rozdíl. Pomáhá to odpovědět na otázku: „Jak dlouho mi reálně vydrží jedno nabití při téhle obrazovce a nastavení?“

Denní přehled – pro každý den:

• počet kontrol (kolikrát se zařízení ozvalo)
• počet překreslení displeje
• napětí baterie ráno a večer + denní rozdíl

Detaily k napětí: Hodnoty jsou oříznuté na 4,20 V (maximum Li-ion). Když zařízení naměří víc, je téměř jistě připojené k USB / nabíječce – takový den/cyklus je v tabulce označen ikonou ⚡. Dny se zjevným nabíjením v průběhu dne (přírůstek napětí ≥ 0,1 V) jsou navíc barevně zvýrazněné, abyste je při počítání výdrže nezaměňovali za normální provoz.