Evok
Evok je naše Open-Source aplikační programovací rozhraní (API), které slouží jako rozhraní fyzických vstupů, výstupů a komunikačních rozhraní. Jde o software, který uživateli umožňuje co nejjednodušší přístup k hardwaru bez toho, aby se uživatel musel zaobírat složitým nízkoúrovňovým programováním.
Veškerá dokumentace, návod na instalaci a popis jednotlivých API je k dispozici v našem repozitáři GitHub.
Základní funkce
Evok je rozdělen na dvě části:
- Evok - jádro zajišťující komunikaci mezi jednotlivými API a hardwarem
- Evok Web (volitelná) - praktická ukázka využití API v podobě jednoduché webové aplikace sloužící jako uživatelské rozhraní pro všechny vstupy a výstupy jednotky
Pro programovou logiku a další operace (integrace dalších komponent systému) je již třeba využít odpovídající externí aplikaci.
Podporované protokoly
- REST
- REST JSON
- WebSocket
- BULK
- JSON-RPC
Dokumentace
Dokumentace (instalace a konfigurace) je k dispozici na Read the Docs. API je dokumentováno na Stoplight, pár příkladů níže.
Jednoduché příklady pomocí curl a JSON:
- Získání stavu digitálního vstupu DI 1_01:
curl --request GET --url http://127.0.0.1:8080/json/di/1_01 --header 'Accept: text/html, application/json'
- Sepnutí digitálního výstupu DO 1_01:
curl --request POST --url http://127.0.0.1:8080/json/do/1_01 --header 'Accept: application/json' --header 'Content-Type: application/json' --data '{"value": 1}' - Rozepnutí digitálního výstupu DO 1_01:
curl --request POST --url http://127.0.0.1:8080/json/do/1_01 --header 'Accept: application/json' --header 'Content-Type: application/json' --data '{"value": 0}'
Starší verze Evok:
Dokumentace k zastaralému Evok v2 je k dispozici zde, API dokumentace v2 je též k dispozici.