Manuel de configuration de l'application STANTOR Micro Central Domotique: stantor_bbb_v04

Transcription

1 Manuel de configuration de l'application STANTOR Micro Central Domotique: stantor_bbb_v04 Application temps-réel pour carte BeagleBone Black ( BBB) utilisant le protocole Websockets (HTML5) et la vidéo en mode "streaming" sous les distributions Linux Debian ou Linux Angström. 1) Principales fonctions réalisées par cette application. Acquisition d'informations digitales (ex: capteur de position, bouton poussoir). Acquisition d'informations analogiques (ex: capteur de température). Commandes de sorties digitales (ex: commande de relais de puissance 220V, commande de LED). Commande de sorties PWM - Modulation de largeur d'impulsions (ex: variateur de luminosité). Acquisition de compteurs impulsionnels sous interruption (ex: compteur d'eau, soit 1 à "n" litres par impulsion). Envoi automatique de courriels ( ) sur apparition d'événement (ex: détection de présence,...). Affichage de courbes de tendance de température. Acquisition et affichage d'un flux vidéo de Webcam connectée en USB à la carte BeagleBone Black ( BBB). Nota: Le système d'exploitation Linux (distribution Angstrom orientée système embarqué ou Debian) est utilisé pour assurer le fonctionnement temps-réel et en parallèle de ces fonctions pour un usage 24/24H. La version v04 de ce programme utilise une librairie Websocket permettant un fonctionnement de plusieurs sessions utilisateurs en simultané et en temps réel. 2) Installation des progiciels. L'installation des progiciels nécessaires à l'application Stantor Micro Central, coté serveur et coté client, est décrite dans le fichier readme.txt ou lisezmoi.txt. Les progiciels "PHP5.x", "msmtp" et "mjpgstreamer" doivent être installés au préalable sur la carte BBB avant de procéder à l'installation de l'application Stantor. Conformément au protocole Websocket/HTML5, l'installation des pages Web peut s'effectuer soit: directement dans un répertoire sur le poste client de l'utilisateur (PC, tablette, Smartphone...). dans un serveur Web intermédiaire (Apache, etc...) avec un répertoire dédié. Ce serveur pouvant être localisé chez un fournisseur d'accès Internet (FAI).

2 3) Principes de configuration. La configuration comprend 2 parties: La modification du fichier "stantor_conf.inc.php" comprenant l'ensemble des paramètres utilisés par les différents processus de l'application localisée dans la carte BBB. Ce fichier est au format "texte". Il utilise des directives "define" du langage PHP5.x pour affecter des valeurs constantes à des informations spécifiques pour chaque utilisation de l'application Stantor. L'affectation des broches utilisées (header et numéro de pin sur le "header" - connecteurs P8 et P9) s'effectue dans un tableau de correspondance avec l'identifiant "gpio". La modification du fichier "stantor_config.js". Ce fichier est au format "texte". Il présente des variables "javascript" qui doivent être affectées de valeurs spécifiques pour chaque utilisation de l'application Stantor. La configuration du programme de la carte BBB consiste à: Définir au préalable les types et les affectations des broches (pins) de la carte BBB en accord avec les matériels raccordés à la carte. Il est très important de noter que les I/O digitales utilisées doivent fonctionner avec le mode "7" (cf documentation du fabricant de la carte BBB). Le cas échéant il faut modifier le mode fourni lors de la livraison pour s'adapter aux besoins de l'utilisateur (cf documentation de la carte). Définir les paramètres d'utilisation des différents modules du programme dans le fichier "stantor_conf.inc.php". L' adaptation du fichier texte "stantor_config.js" à la configuration de cette application consiste à: Définir des paramètres généraux en accord avec ceux mentionnés dans le fichier de configuration "stantor_conf.inc.php". Définir les noms ou libellés que l'utilisateur souhaite voir apparaître dans les pages Web. Définir les actions entraînées par l'appui sur certains boutons des pages Web. Définir les caractéristiques des capteurs de température de type CTN (Coefficient de Température Négatif). Définir la durée maximum d'une session utilisateur non utilisée. Au delà les ordres de l'utilisateur ne sont plus opérationnels. 4) Configuration du programme de la carte BBB. Les paramètres suivants doivent être précisés (lire attentivement le fichier "stantor_conf.inc.php"): L'adresse IP et le port Ethernet du serveur Websocket de la carte BBB. L'identifiant (nom)de la carte BBB. Exemples: BB00 <=> BB99. Le code secret autorisant l'accès aux informations de la carte BBB. Le nombre de secondes de validation de l'autorisation d'accès après perte de la connexion Websocket. La zone de l'heure locale (Exemple: "Europe/Paris"). Le paramètre de rafraîchissement des valeurs analogiques dans la page Web (en standard 3 secondes). Les entrées/sorties digitales utilisées sous forme de tableau de correspondance entre l'identifiant sous forme de "header" - numéro de pin dans le "header" en relation avec l identifiant "gpio". L'identifiant des sorties PWM (modulation par largeur d'impulsion) utilisées sous forme de "header" - numéro de pin dans le "header".

3 La période, la durée et la polarité des sorties PWM. La durée est à fournir en % lors du lancement du programme. L'identifiant de la pin utilisée pour le comptage d'impulsion sous forme de "header" - numéro de pin dans le "header". Le front de l'impulsion de comptage, la durée minimale entre 2 fronts successifs pour l'antirebond, les localisations et noms des fichiers servant au comptage. Les adresses mail de l'expéditeur et du destinataire. Le sujet du mail. Les textes des messages transmis lors de l'apparition des événements correspondants. L'heure et la minute du mail journalier de contrôle. L'identifiant de la pin utilisée pour l'alarme sous forme de "header" - numéro de pin dans le "header". Le sens (valeur 0 ou 1) de fonctionnement de l'alarme de l'entrée digitale utilisée. La durée minimale entre deux envois successifs de l'alarme. La définition en pixel de la résolution de la Webcam utilisée. Les nom et répertoire du programme de "streaming" utilisé. A mettre en conformité avec ceux définis par l'éditeur du progiciel lors de l'installation pour la distribution Linux implantée dans la carte. 5) Configuration des pages Web. Le fichier javascript "stantor_config.js" rassemble l'ensemble des paramètres utilisés par les pages Web de cette application. L'adresse IP et le port Ethernet du serveur de Websocket de la carte BBB (ils doivent être identiques à ceux mentionnés dans le fichier "stantor_conf.inc.php"). L'identifiant de la carte BBB. Exemple BB00 <=> BB99 (il doit être identique à celui mentionné dans le fichier "stantor_conf.inc.php"). Les libellés des noms des informations digitales affichées dans le tableau (entrées et sorties digitales). La chaîne d'information reçue pour chaque case du tableau des informations digitales. Informations à mettre en correspondance avec le paramétrage des entrées/sorties de la carte BBB. Format: ID ou OD= entrée ou sortie digitale, séparateur "; ", Header-Numéro de la pin, séparateur "; ", sens= 0 ou 1. Exemple: 'ID;0815;1'. Le texte affiché dans le tableau des boutons de commande de sorties digitales (un libellé distinct pour chaque sens). Il est possible de mettre des icônes sous forme de fichier *.jpeg ou *.png en lieu et place de boutons rectangulaires avec texte. La chaîne d'information transmise pour chaque case du tableau des boutons de commandes digitales. Informations à mettre en correspondance avec le paramétrage des entrées/sorties de la carte BBB. Format: OD= sortie digitale,séparateur "; ", Header-Numéro de la pin, séparateur "; ", sens= 0 ou 1. Exemple: "OD;0915;1".

4 Les libellés des noms des informations affichées dans les cases des tableaux des entrées analogiques (CTN = coefficient de température négatif). Le libellé de l'unité de mesure (par défaut degré Celsius). Les numéros des broches (pins) des entrées analogiques de chaque case du tableau des entrées analogiques. La valeur en ohms de la résistance de charge du pont diviseur. La valeur en ohms de la résistance CTN à 25 degré Celsius. Le coefficient "b" spécifique à la CTN en degré Kelvin. Le libellé du nom de l' informations affichées dans les cases du tableau des sorties PWM. Le numéro de broche ("header - numéro de pin") de la sorties PWM pour la case du tableau des sorties PWM. Le libellé du nom des informations affichées dans les cases du tableau des compteurs d'impulsions. Le numéro de broche ("header - numéro de pin") du compteur d'impulsions pour la case du tableau des compteurs d'impulsions. Le libellé des unités des informations affichées dans la case du tableau des compteurs d'impulsions. Les libellés des températures et les unités s'affichant sur le graphe de tendance. Les codes HTML de couleur des courbes de tendance. L'adresse IP et le port Ethernet du serveur vidéo de la carte BBB. Ce port Ethernet doit être différent de celui utilisé pour le serveur de Websocket (cf ci dessus). Le texte à afficher dans le bandeau de la fenêtre d'affichage de la vidéo. 6) Mise en service de l'application. Pour utiliser l'application une fois configurée il faut: Lancer l'application, manuellement ou automatiquement, dans la carte BBB par le script bash "start_stantor.sh". Ouvrir la page Web index.html en utilisant un navigateur Web (Firefox, Chrome, etc...). Saisir le code secret conformément à celui mentionné dans le fichier "stantor_conf.inc.php". Sélectionner la page choisie via le tableau des liens en bas de chaque page Web. L'arrêt de l'application s'effectue par le script "stop_stantor.sh". 7) Compléments techniques. Relais Exemple de schéma de montage de la commande de relais 5V via des transistors intermédiaires pour des sorties digitales de 3,3V (Nota: Il existe des ensembles entièrement montés chez des revendeurs de modules électroniques).

5 Sondes de température CTN Les capteurs de température CTN se montent en pont diviseur avec le capteur CTN branché entre la masse (0V) et la broche analogique AIN0, AIN1 et AIN2 ("header" 9 - pins 39, 40 et 37). La résistance de charge du pont diviseur se branche entre le 1,8V et la broche analogique. Par défaut le capteur de température extérieure est connecté à la broche AIN0 et le capteur de température intérieure à la broche AIN1.