Hodnoty slouží k uložení informací do databáze Živého obrazu, abyste je později mohli použít pro jejich zobrazení na ePaperu.
Hodnoty posílejte nejdříve po minutě, ne častěji.
Jak hodnoty zasílat z Home Assistanta popsal @Yourigh skvěle zde:
https://github.com/Yourigh/zivy_obraz_HA/blob/main/README.md
Občas je problém poslat více jak přibližně 15+ hodnot najednou - pak je vhodné to rozdělit na více exportů.
Na server Živého obrazu můžete zasílat vlastní hodnoty přes metodu GET i POST.
Adresa pro zasílání hodnot je:
Nezabezpečeně: http://in.zivyobraz.eu/
Zabezpečeně: https://in.zivyobraz.eu/
Je potřeba vždy zaslat i váš unikátní import_key, který se dozvíte právě na stránce Hodnoty. Tedy např. volání GET, kdy chceme uložit proměnnou "teplota_kuchyne" s hodnotou "25" by vypadalo:
https://in.zivyobraz.eu/?import_key=mujKlic123&teplota_kuchyne=25
Hodnotu následně uvidíte i po novém načtené stránky s hodnotami v sekci hodnot zaslaných na Živý obraz.
Potřebujete-li vlastní hodnoty zpětně vyčítat (např. kvůli získání napětí na ePaperech), můžete využít URL se subdoménou out
a parametrem export_key (který zjistíte na stránce s hodnotami) a přidat (jako jediný) parametr my_values=json
:
https://out.zivyobraz.eu/?export_key=MUJKLIC&my_values=json
A zpětně získáte stránku s polem všech hodnot v JSONu:
{ "08:d1:f9:a6:ed:58-napeti-procenta": { "value": 80, "datetime": "2024-07-25 00:03:30" }, "08:d1:f9:a6:ed:58-napeti-volty": { "value": 3.88, "datetime": "2024-07-25 00:03:30" }, "08:d1:f9:a6:ed:58-signal-dbm": { "value": -48, "datetime": "2024-07-25 00:03:30" }, ...
Chcete-li získat jen hodnoty ohledně ePaperů, přidejte ještě parametr "epaper_only=1":
https://in.zivyobraz.eu/?import_key=mujKlic123&export_my_values=json&epaper_only=1
Můžete si nechat vypsat export informací přímo o ePaperech, které máte zadané pod účtem. Slouží k tomu opět doména out.zivyobraz.eu
tentokrát s parametrem epapers=json
, kdy klíčem k uzlu je MAC adresa konkrétního ePaperu:
https://out.zivyobraz.eu/?export_key=MUJKLIC&epapers=json
{ "14:23:b2:fe:91:b9": { "caption": "Malej", "note": "", "x": 400, "y": 300, "colors": "BW", "fw": "2.2", "last_contact": "2024-08-01 16:00:28", "ssid": "AP_WALRUS", "rssi": -45, "battery_volts": 4.06, "battery_percent": 93, "temperature": 29, "humidity": 55, "pressure": null }, "d2:e0:9a:cd:aa:15": { "caption": "ESPInk 42", "note": "", "x": 400, "y": 300, "colors": "Grayscale", "fw": "2.2", ...
Na přání jsem přidal i alternativu, kde pod polem "epapers" jsou vypsané všechny ePapery bez toho, aby byly pod MAC adresou:
https://out.zivyobraz.eu/?export_key=MUJKLID&epapers=json_flat
{ "epapers": [ { "mac": "14:23:b2:fe:91:b9", "caption": "Malej", "note": "", "x": 400, "y": 300, "colors": "BW", "fw": "2.2", "last_contact": "2024-08-01 16:00:28", "ssid": "AP_LOSOS", "rssi": -45, "battery_volts": 4.06, "battery_percent": 93, "temperature": 29, "humidity": 55, "pressure": null }, { "mac": "d2:e0:9a:cd:aa:15", "caption": "ESPInk 42", "note": "", "x": 400, "y": 300, "colors": "Grayscale", "fw": "2.2", ...
Do formuláře vložte URL exportu hodnot všech čidel z TMEPu, tedy něco jako:
https://tmep.cz/vystup-json.php?id=1&export_key=x123yaefqeigt&all=1
Případně můžete použít i rozšířený export hodnot či dát odkaz na URL, kde je JSON ve stejné struktuře jako na TMEPu. Následně se co 5 minut bude tento soubor kontrolovat a hodnoty v databázi aktualizovat. Poté na stránce hodnot uvidíte v sekci "Vyčítané z TMEPu" tabulku těchto hodnot.
Hodnoty, které vytváří a aktualizuje přímo sám server. Pro začátek ceny komodit (elektřina, stříbro, zemní plyn, zlato) a kurzy měn (Bitcoin, EUR, USD, …). Do budoucna je možné získávat i další údaje, pokud budou pravděpodobně užitečné pro větší množství uživatelů.
Nastavíte-li u některého z ePaperů souřadnice a název pro ukládání počasí (viz Nastavení ePaperu), pak se zde budou zobrazovat patřičné Hodnoty.
Hodnoty "Aktuálně" - jedná se o předpověď vyčtenou +/- v aktuální hodinu.
Sekce X - jedná se o sekce 1-5 pro několik sdružených hodin. O jaké období se jedná se dozvíte v "Sekce X - období", např. "dnes 12-18" apod. K té sekci se vztahují další informace. Jakmile dojde v vyčtení počasí na další dobu, tak se vyčtené hodnoty pošoupnou - Sekce 1 tak vždy bude předpověď na nejbližší období apod.
Je zde jedna specialita - položky, kde je uvedené "ikona XXpx" se při použití na Obrazovce nahradí za ikonu, která ladí s položkou "popis" (např. přeháňky, zataženo…). Právě "XX" v názvu položky udává jak bude ikona velká (20/40/60/80 px).
V případě, že budou některé hodnoty staré dva týdny (nebo starší), objeví se tlačítko, kterým je můžete promazat. Takové hodnoty nesmíte využívat v obrazovce, aby nedošlo k problému s vyčtením neexistující hodnoty.