====== Evok ====== 
~~NOTOC~~

<WRAP group>
/*
<WRAP half column 81%>
*/
{{ :en:sw:evok_1_.png?400&nolink |}}
/*
</WRAP>
<WRAP half column 15%>
;;#
<html><span class="dev-tag dev-patron">Patron</span></html> \\
<html><span class="dev-tag dev-neuron">Neuron</span></html> \\
<html><span class="dev-tag dev-gate">Gate*</span></html> \\
<html><span class="dev-tag dev-unipi11">Unipi&nbsp1.1</span></html> \\
<html><span class="dev-tag dev-axon">Axon</span></html>
;;#
</WRAP>
*/
</WRAP>

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 [[https://github.com/UniPiTechnology/evok|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.

/*{{:en:sw:02-evok:evokedited.png?400|Zjednodušené schéma EVOKu}}*/

===== Podporované protokoly =====
  * **REST**
  * **REST JSON**
  * **WebSocket**
  * **BULK**
  * **JSON-RPC**
\\

===== Dokumentace =====
Dokumentace (instalace a konfigurace) je k dispozici na [[https://evok.readthedocs.io|Read the Docs]]. API je dokumentováno na [[https://unipitechnology.stoplight.io/docs/evok/|Stoplight]], pár příkladů níže.

<html><span class="kbBlueText">Jednoduché příklady pomocí curl a JSON:</span></html>
  * Získání stavu digitálního vstupu **DI 1_01**: <code>curl --request GET --url http://127.0.0.1:8080/json/di/1_01 --header 'Accept: text/html, application/json'</code>
  * Sepnutí digitálního výstupu **DO 1_01**: <code>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}'</code>
  * Rozepnutí digitálního výstupu **DO 1_01**: <code>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}'</code>

----

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
</WRAP>
<WRAP half column 83%>
**Starší verze Evok:** \\
Dokumentace k zastaralému Evok v2 je k dispozici [[https://github.com/UniPiTechnology/evok/tree/master|zde]], [[en:sw:02-apis:01-evok:apidoc-hidden|API dokumentace v2]] je též k dispozici.
</WRAP>
</WRAP>

/*Kompletní dokumentace a příklad použítí jednotlivých API je k dispozici {{https://kb.unipi.technology/_media/en~:sw:02-evok:evok.html | ZDE}}.

===== Kompletní technické schéma EVOKu =====
{{:en:sw:02-evok:neuron_diagram.png?direct&400|}}*/