18. 11. 2026 – Nová verze open-source API pro kontroléry Unipi umí komunikovat přes MQTT a chránit přístup tokenem. U hodnot navíc uvádí, kdy zařízení naposledy odpovědělo.
EVOK je open-source software, který běží přímo na kontroléru Unipi. Díky němu mohou se vstupy, výstupy a čidly kontroléru pracovat další aplikace – Node-RED, skripty v Pythonu, Mervis a další. Komunikují s ním přes REST, WebSocket, JSON-RPC, webhooky a nově i MQTT.
Přístup chráněný tokenem
Ve výchozím stavu EVOK přijímá požadavky jen od aplikací, které běží přímo na kontroléru. Přístup ze sítě zapnete v konfiguraci. Na jednom řádku tam nastavíte i token – heslo, kterým se musí prokázat každá aplikace, která se k EVOK připojuje. Token platí pro všechna rozhraní kromě MQTT, kde přístup řídí broker.
Aplikacím, které mají data jen zobrazovat, například dashboardům, můžete dát druhý token jen pro čtení. S ním lze hodnoty číst, ale výstupy ovládat nejde.
EVOK sám komunikaci nešifruje. Pro přístup mimo důvěryhodnou síť proto doporučujeme zařadit před něj reverzní proxy s TLS, například nginx.
Víte, kdy zařízení naposledy odpovědělo
U hodnot ze vstupů a výstupů kontroléru, z rozšiřujících modulů, externích zařízení Modbus i 1-Wire čidel EVOK uvádí čas poslední úspěšné komunikace. Aplikace tak pozná, že pracuje se starou hodnotou – třeba když čidlo přestane odpovídat. Výpadek i obnovení komunikace jí EVOK oznámí, takže na ně můžete navázat alarm.
Nereagující zařízení nezdrží ostatní
Když modul nebo externí zařízení na sběrnici přestane odpovídat, komunikace s ostatními se nezpomalí. Nastavit lze i to, jak dlouho EVOK na odpověď čeká a kolikrát dotaz zopakuje.
Chyby se ukážou hned
Když aplikace pošle neplatnou hodnotu, například mimo rozsah analogového výstupu, EVOK ji odmítne a vrátí chybu. O problému ve svém programu se tak dozvíte hned. Chyby v konfiguraci EVOK zapíše do logu, který si přečtete i na dálku přes API.
1-Wire bez další služby
EVOK nově čte 1-Wire čidla přímo přes jádro Linuxu. Samostatnou službu owserver, kterou k tomu dosud používal, už nepotřebuje.
Instalace a aktualizace
Na Debianu 13 Trixie EVOK 3.1 nainstalujete i aktualizujete přes apt: sudo apt update && sudo apt install -y evok. Pro Debian 12 zůstává k dispozici verze 3.0.
Pokud EVOK už používáte, před aktualizací si zkontrolujte hlavně:
- Přístup ze sítě. Připojují se k EVOK aplikace z jiných zařízení? Povolte jim přístup v konfiguraci.
- WebSocket. Node-RED a webové aplikace, které se připojují přes WebSocket, musí mít svou adresu uvedenou v nastavení
allowed_origins. - Pulzy výstupů. Sepnutí výstupu na nastavenou dobu se nově zadává přes sekvencer. Ten nahrazuje parametry
pulse_durationatimeout. - Označení vstupů a výstupů. U některých se změnilo (pole
circuit).
Další změny shrnuje přehled změn API. Dokumentaci najdete na evok.readthedocs.io, zdrojový kód na GitHubu.
