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:
https://www.itexservices.cz/api/spot/v1/k/its_VASKLIC/loxone.txthttps://its_VASKLIC@www.itexservices.cz/api/spot/v1/loxone.txtLoxone 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.
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říkazu | Význam |
|---|---|
\istav_kod=\i\v | 0 = v pořádku, 1 = stará data, 401 = špatný klíč, 429 = limit, 503 = výpadek |
\icena_ted=\i\v | cena teď v Kč/kWh (koncová, má-li klíč tarif; jinak spot) |
\ispot_ted=\i\v | spot teď, bez DPH a distribuce |
\ilevno_ted=\i\v | 1 = levná nebo záporná hodina (digitální vstup) |
\iuroven_ted=\i\v | 0 záporná, 1 levná, 2 běžná, 3 drahá |
\iokno3_za_min=\i\v | za kolik minut začne nejlevnější 3h okno (0 = právě běží) |
\iokno3_cena=\i\v | průměrná cena toho okna |
\idrahe3_za_min=\i\v | za kolik minut začne nejdražší 3h okno — kdy nespotřebovávat |
\ipockat_uroven=\i\v | beta: 0/1/2 = nízká/střední/vysoká šance, že v příštích dnech bude levněji |
\izaporna_dnes_p=\i\v | nejvyšší pravděpodobnost záporné ceny do konce dne v % |
\istari_min=\i\v | stáří dat v minutách |
\ih00=\i\v … \ih47=\i\v | ceny 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).