Obsah

Hodnoty

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 zaslané na Živý obraz

Ukládání hodnot na server ŽO

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:
http://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.

Zpětné získávání vlastních hodnot

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:
http://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":
http://in.zivyobraz.eu/?import_key=mujKlic123&export_my_values=json&epaper_only=1

Získávání informací o ePaperech pod vaším účtem

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:
http://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: http://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",
     ...

Hodnoty vyčítané z TMEPu

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.

Globální hodnoty

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ů.

Počasí

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).

Promazání hodnot

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.