EVOK 3.1 přidává MQTT, ověřování tokenem a časové značky u hodnot

Domů Novinky EVOK 3.1 přidává MQTT, ověřování tokenem a časové značky u hodnot Zpět
Novinky

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_duration a timeout.
  • 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.



Zobrazit více