UniPi-EVOK-Installation

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche

Qu'est ce que EVOK?

EVOK est un logiciel de contrôle de base pour UniPi soit via une API ou une interface Web rudimentaire. Le code source est librement disponible sur GitHub où vous trouverez également les instructions d'installation.

EVOK est une couche offrant l'accès aux relais, aux entrées/sortie analogiques et digitales. Grâce à l'API, vous pouvez utiliser UniPi comme unité de contrôle totalement indépendante (avec son propre programme) ou unité de contrôle exploitée par un autre logiciel (Pidome, DomotiGa).

L'API EVOK est accessible via:

  • REST
  • JSON
  • WebSocket

EVOK doit être installé sur la carte microSD du Raspberry-Pi contrôlant l'UniPi. EVOK s'installe sur le système d'exploitation Rapsbian.

Liens utiles

Installation

Préparer votre Pi

Télécharger et graver la dernière version de Raspbian (Raspbian Jessie, 05 07 2017).

Utiliser raspi-config pour:

  1. Changer le mot de passe de l'utilisateur Pi
  2. Changer le nom de l'hôte
  3. Activer le support I2C (indispensable pour contrôler la carte)
  4. Etendre le système de fichier

Après avoir rebooté le Raspberry-Pi, faire une mise-à-jour du système d'exploitation

sudo apt-get upgrade
sudo apt-get upgrade

Rebooter le Pi une deuxième fois.

Installer EVOK

Conformément aux instructions sur le GitHub de EVOK, vous pouvez installer EVOK en suivant les instructions suivantes:

Télécharger la dernière release depuis le dépôt en utilisant wget (ou en utilisant git):

cd /tmp
wget https://github.com/UniPiTechnology/evok/archive/v1.0.0.tar.gz
tar -zxvf v1.0.0.tar.gz && mv evok-* evok  

Le répertoire téléchargé ne sera plus utile après l'installation. Il pourra donc être installé pour libérer de la place.

Les fichiers de configuration seront placés dans /etc/

Exécutez le script d'installation en suivant les instructions suivantes:

cd evok
chmod +x install-evok.sh uninstall-evok.sh
sudo ./install-evok.sh

Le Rasberry-Pi rebootera une 3ieme fois au terme de l'installation.

Après le redémarrage, tout devrait fonctionner comme attendu.

Contrôler l'état du service

Vous pouvez facilement contrôler l'état du service en saisissant la commande suivante:

systemctl | grep evok

Si le service n'est pas démarré :

  • Vous pouvez vérifier les erreurs en lancant Evok en mode debug
  • Considérer l'installation de la version de développement de Evok.
    Ce que nous avons fait ce 25 juillet pour faire fonctionner Evok.

Installer la version de développement

Il est assez facile d'installer la version de développement d'Evok par dessus l'installation d'evok.

Suivez les instructions suivantes:

cd /tmp
wget https://github.com/UniPiTechnology/evok/archive/master.zip
unzip master.zip
cd evok-master
sudo bash install-evok.sh

Daemon et fichier de configuration

EVOK utilise un fichier le configuration /etc/evok.conf

Il est nécessaire de redémarrer le deamon EVOK après chaque modification du fichier de configuration.

Le deamon peut être contrôler à l'aide de:

systemctl start/restart/stop evok

Debogage

Il est possible de démarrer EVOK manuellement pour faciliter les tâches de débogage.

Il est possible de modifier le niveau de débogage dans le fichier /etc/evok.conf

systemctl stop evok

et exécuter manuellement EVOK comme utilisateur root en appelant

sudo /opt/evok/evok.py

Test du serveur Web

Une fois Evok installé, il démarre un serveur Web pour autoriser l'accès à l'API.

Evok propose également une interface WEB rudimentaire pour changer l'état des relais et vérifier l'état des entrées.

Ouvrez un navigateur internet et saisissez l'adresses http://adress_ip_de_votre_pi ou http://host_name_de_votre_pi.local

Comme notre Raspberry-Pi porte le nom "unipi" (comme hostname), nous pouvons obtenir l'interface avec unipi.local

UniPi-EVOK-Installation-web.jpg

Désinstallation

Executer les opérations suivantes pour désinstaller EVOK:

systemctl stop evok
sudo /opt/evok/uninstall-evok.sh

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.