ITex Services s.r.o.

[ ITexSpot · Loxone ]

Spotová cena elektřiny v Loxone

Miniserver si výhled načte sám přes Virtuální HTTP vstup — bez Node-RED, bez skriptů a bez dalšího serveru. Stačí klíč a šablona.

Beta · zdarma · klíč jen ke čtení

Co budete potřebovat

  • Miniserver Gen 2 nebo novější (adresa je jen HTTPS; Gen 1 HTTPS neumí — použijte most přes Home Assistant nebo Node-RED).
  • Loxone Config.
  • Klíč ITexSpot API (its_…) — v aplikaci ITexLink v sekci Můj účet, nebo přes přihlášku do bety.

1. Šablona

Stáhněte si šablonu Virtuálního HTTP vstupu (VI_ITexSpot.xml). V Loxone Configu otevřete ve stromu periférií Virtuální vstupy, v liště zvolte Šablony zařízení → Importovat šablonu a vyberte stažený soubor. Pak šablonu vložte jako nový Virtuální HTTP vstup.

Šablonu jsme připravili podle šablon výrobce; v Loxone Library zatím není. Kdyby import ve vaší verzi Configu neprošel, nastavte vstup ručně podle kroků níž — je to dvanáct řádků.

2. Adresa a klíč

Ve vlastnostech Virtuálního HTTP vstupu nastavte adresu. Máte dvě možnosti:

Klíč v adrese (nejjednodušší)
https://www.itexservices.cz/api/spot/v1/k/its_VASKLIC/loxone.txt
Basic Auth (klíč jako uživatel, heslo prázdné)
https://its_VASKLIC@www.itexservices.cz/api/spot/v1/loxone.txt

Loxone u Virtuálního HTTP vstupu podporuje jen Basic Auth zapsanou v adrese; vlastní hlavičky neumí, proto přijímáme klíč i v cestě. Interval dotazování nastavte na 300 s. Data se mění třikrát denně, častější dotaz nic nepřinese a limit je 60 dotazů za hodinu.

3. Příkazy (co vstup přečte)

Odpověď je prostý text, jeden údaj na řádek, desetinná tečka. Každý Virtuální HTTP vstup — příkaz dostane rozpoznání ve tvaru \icena_ted=\i\v. Žádný název není součástí jiného, takže se hodnoty nepletou.

loxone.txt
stav_kod=0
stav=ok
cena_ted=4.012
spot_ted=2.31
levno_ted=1
uroven_ted=1
okno3_za_min=185
okno3_cena=3.41
drahe3_za_min=125
drahe3_cena=6.9
pockat_uroven=1
zaporna_dnes_p=0
stari_min=42
h00=4.012
h01=4.105
…
h47=3.88
Rozpoznání příkazuVýznam
\istav_kod=\i\v0 = v pořádku, 1 = stará data, 401 = špatný klíč, 429 = limit, 503 = výpadek
\icena_ted=\i\vcena teď v Kč/kWh (koncová, má-li klíč tarif; jinak spot)
\ispot_ted=\i\vspot teď, bez DPH a distribuce
\ilevno_ted=\i\v1 = levná nebo záporná hodina (digitální vstup)
\iuroven_ted=\i\v0 záporná, 1 levná, 2 běžná, 3 drahá
\iokno3_za_min=\i\vza kolik minut začne nejlevnější 3h okno (0 = právě běží)
\iokno3_cena=\i\vprůměrná cena toho okna
\idrahe3_za_min=\i\vza kolik minut začne nejdražší 3h okno — kdy nespotřebovávat
\ipockat_uroven=\i\vbeta: 0/1/2 = nízká/střední/vysoká šance, že v příštích dnech bude levněji
\izaporna_dnes_p=\i\vnejvyšší pravděpodobnost záporné ceny do konce dne v %
\istari_min=\i\vstáří dat v minutách
\ih00=\i\v … \ih47=\i\vceny po hodinách od běžící hodiny (h00) na 48 h dopředu

Chybějící hodnota je -999, ne nula — nula by mohla vypadat jako opravdová cena. Pro blok Spotpreis-Optimierer použijte řádky h00 až h47; jak je blok přebírá, záleží na verzi Configu, ověřte si to v jeho nápovědě.

4. Pojistky

  • Hlídejte stari_min: když je přes 1 800 (30 h), data jsou stará — přepněte řízení na výchozí režim (např. bojler podle času).
  • Hlídejte stav_kod: cokoli jiného než 0 a 1 znamená, že vstup nedostává čerstvá data.
  • Při výpadku spojení drží Miniserver poslední hodnotu; počítejte s tím v logice.

Ověřeno / známá omezení

  • Šablona zatím není ověřená importem. Tvar jsme převzali ze šablon výrobce, ale import do Loxone Configu ani běh na Miniserveru jsme s ní zatím nezkoušeli. Když import neprojde, nastavte vstup ručně podle kroků výš a dejte nám vědět, ve které verzi Configu.
  • Miniserver Gen 1 není podporovaný přímo. API běží jen na HTTPS a Gen 1 HTTPS neumí. Použijte most přes Home Assistant nebo Node-RED.
  • Záporné ceny. Cena může být pod nulou, proto mají cenové příkazy v šabloně zapnuté „Se znaménkem“ (Signed). Při ručním nastavení to zapněte také, jinak se záporná cena přečte špatně.
  • Chybějící hodnota je -999 — v logice ji ošetřete stejně jako výpadek (viz Pojistky).
Předpověď je orientační údaj, ne záruka. Řízení u vás doma musí počítat s tím, že API chvíli neodpoví — nastavte rozumnou výchozí hodnotu a hlídejte stáří dat. Podrobnosti jsou v podmínkách API.