Skip to content
Guyzmo edited this page Mar 12, 2013 · 2 revisions

Notice de Pollux’NZ City

Avant Propos

Vous venez d’obtenir le prototype de capteur de pollution « Pollux’NZ City ». Ce dispositif composé d’un module passerelle connecté au réseau de l’utilisateur et d’un module de capteurs autonome en énergie pouvant être fixé en extérieur. Le prototype permet de mesurer en standard les niveaux de particules fines (pm 10) de température et de polllution sonore.

La station est un prototype en version beta susceptible de rencontrer des problèmes d’ordres ergonomique et fonctionnel; nous serons gré à votre équipe technique de nous remonter tout type de problèmes rencontrés en phases d’installation et d’utilisation.

Contenu du colis

Le colis contient deux ensembles complets. Chacun est référencé par une étiquette d’indentification permettant de reconnaître les paires de modules associées. Pour chaque paire, ci-après vous trouverez les appareils et accessoires fournis.

  • Un module « passerelle » Pollux’NZ City (ci-après nommé « la passerelle »)
  • Une alimentation secteur (5V)
  • Une antenne de petite taille

  • Une module « autonome » de capteurs Pollux’NZ City (ci-après nommé « le module autonome »)
  • Un câble USB
  • Une antenne de grande taille
  • Un kit d’attaches
  • Un bras d’attache

Attention: le module autonome de mesure contient une batterie Lithium Ion, il est donc recommandé de faire très attention à ne pas créer de court circuit sur l’électronique de gestion de la batterie et de ne pas détériorer l’emballage de la batterie, celle-ci risquant alors de brûler ou d’exploser.

   
   
   
   
    
   
   
   
   
   
   
     
   
   
   
   

Installation

  • Installer le module de capteur (avec le panneau solaire) orienté vers le soleil et de préférence à une hauteur de 2 mètres par rapport au sol,
  • Au dos du module autonome, une diode va s’allumer avec une intensité indiquant le niveau de l’ensoleillement reçu par le panneau solaire (et donc du niveau de charge instantané).
  • Pour une utilisation du capteur en autonomie d’énergie, veiller à optimiser le positionnement du capteur en fonction de la course du soleil (viser donc un axe sud-ouest).
  • Pour accrocher le capteur, choisir l’accroche la plus adaptée au support et l’y installer,
  • prendre le bras, accrocher le bras au module autonome du côté opposé au ressort du bras

Démarrage

Sur le module autonome

  • Ouvrir le compartiment batterie (celui sans ouvertures sur le couvercle),
  • Et passer le switch à côté du port USB large de « OFF » à « ON »,

  • Vérifier que la batterie est à plus de 50% en appuyant sur le switch situé sur le côté extérieur de la carte (identifié « K2 »), le nombre de diodes allumées correspond au niveau de charges,
    • Si le niveau de batterie est de moins de 50%, branchez le module autonome (cf section « Branchements »)

Sur le module passerelle

  • (cf section « Branchements » ci-après), reliez d’abord le module passerelle à un réseau routé vers Internet, puis connectez le au secteur,
  • La module va alors automatiquement demander une adresse sur le réseau (si un serveur « DHCP » est présent) ou prendre une IP en autoconfiguration,
  • Attendre :
    • qu’une diode (à côté du connecteur réseau) clignote en battement de coeur (indiquant que le système d’exploitation est bien lancé),
    • puis que la diode verte (pointant vers le haut) s’allume (indiquant que le programme d’écoute des mesures est en fonctionnement)
    • procéder à la configuration (cf section « Configuration »)

Branchements

Branchements du module Autonome

  • Pour recharger le module autonome:
  • utiliser le cordon USB pour le relier à un ordinateur ou une prise secteur-USB,
    • une diode rouge s’allume pour indiquer la charge,
    • une diode verte s’allume pour indiquer la fin de charge.

Branchements du module passerelle

  • D’abord reliez le module passerelle à Internet à l’aide d’un câble ethernet (non-fourni),
  • Utiliser le chargeur 5V pour relier le module passerelle Pollux au secteur,

Configuration

Connexion

  • Ouvrir un navigateur Internet sur un ordinateur connecté sur le réseau local,
    • Pour l’instant seuls Firefox/Chrome/Safari sous Linux et MacOSX ont été testés et validés
    • Sous Linux, s’assurer que le daemon « avahi/mdns » soit installé
  • Accèder à l’adresse : « http://pollux.local »

Onglet « My Datas »

  • Sous l’onglet « My Datas » apparaîtra la courbe des mesures, dès que les premières mesures seront exécutées,

Onglet « Sensors »

  • Sous l’onglet « Sensors » est la liste des capteurs activés ou désactivables, ainsi que la sélection du module à appairer
    • N.B.: ne pas activer ou désactiver les capteurs sur cette interface; ne pas modifier l’appairage module autonome/passerelle, ces fonctionnalités pouvant entraîner des dysfonctionnements. Les deux passerelles ont été appairées et configurés avant envoi.

Onglet « Datastores »

  • Sous l’onglet « Datastores » se situe

  • la géolocalisation du module:
    • Pour mettre une nouvelle adresse, effacez le champ « address » et mettez votre adresse, puis cliquez sur « change/reset »,
    • Pour mettre directement des coordonnées, effacez le champ « address » puis cliquez sur « change/reset », ensuite entrez les coordonnées dans les champs « latitude »/« longitude » dégrisés,

  • la configuration des différents modules installés:
    • vous pouvez configurer ici votre compte « [http://cosm.com Cosm] » pour le module « Pachube »,
    • ne touchez pas au module « local », à moins de vouloir désactiver la sauvegarde en local des mesures (qui apparaît sous l’onglet « My Datas »)

Onglet « Advanced »

  • Sous l’onglet « Advanced »

  • vous pouvez configurer le temps entre deux mesures (sous l’intitulé « wud_sleep_time »)
    • N.B.: le module est pré-réglé sur une base de mesures opérées toutes les 15 minutes (soit 900 seconeds); pour garantir l’autonomie en énergie du module autonome il est recommandé de conserver cette valeur.

  • vous pouvez ajouter/supprimer un plugin
    • N.B.: il n’y a pas de confirmation avant suppression et toute suppression est définitive ! Faire attention à ne pas faire d’erreurs,

  • et executer plusieurs commandes
    • « reload configuration » peut être utile si la configuration a changé par un autre intermédiaire que l’interface web
    • « update sensors list » télécharge et met à jour la liste des capteurs pour l’onglet « sensors » ; faire « reload configuration » une fois le téléchargement réalisé
      • N.B.: cette fonctionnalité n’est pas à utiliser pour le moment, la liste des capteurs est déjà à jour et correspond aux besoins de l’appareil fourni
    • « restart gateway service » relance le service d’interrogation du module autonome, permet de prendre en compte la nouvelle configuration (notamment le temps d’intervalle entre deux mesures)
      • N.B.: il est possible que cette fonctionnalité bloque l’interface web ou ne fonctionne pas, auquel cas il faudra faire un redémarrage en débranchant/rebranchant ou en appuyant sur le bouton à côté du port ethernet
    • « view logs » permet de visualiser les 40 dernières lignes des journaux de bord des services pollux, notamment « pollux_gateway » qui interroge les capteurs et « pollux-config » qui est l’interface web de configuration utilisé.
      • Si l’interrogation s’est bien déroulée, on peut voir sur « pollux_gateway » une valeur tronquée des mesures effectuée, ainsi que le succès d’exécution des modules python (en cas d’exception, le message d’erreur de l’exception sera affiché)
      • Si l’interrogation s’est mal déroulée:
        • soit on verra l’enchaînement de trois erreurs « Failed to send D0 », ce qui signifie que la communication avec le module autonome est un échec,
        • soit les messages s’arrêtent au milieu de l’interrogation (après un « sending measures »), ce qui signifie que la communication interne au module autonome est défectueuse

Usage

  • Toutes les 15 minutes (ou le temps en secondes indiqué par le champ « wud_sleep_time » de l’onglet « Advanced » de l’outil de configuration), une mesure est lancée
  • le module autonome s’active, une lumière verte indiquant sa mise sous tension,
    • chaque mesure est indiquée par une pulsation verte,
    • chaque communication sans-fil est indiquée par une pulsation bleue,
    • si un clignotement rouge apparaît fréquemment, se référer à la section « Troubleshooting » ci-dessous
    • en fin de mesure les trois diodes clignotent en même temps avant de passer hors-tension
  • la passerelle, aura un clignotement bleu correspondant à une bonne réception des mesures,

Attention: En cas de non utilisation prolongée du module autonome de mesures, penser à bien mettre à « OFF » dans le compartiment batterie afin d’éviter tout risque de décharge ou de défaut de la batterie.

Troubleshooting

  • Problème: la passerelle émet des mesures (diode bleue qui clignote quelques fois), mais le module autonome ne s’allume pas
    • Vérifier que le bouton « on » est bien positionné,
    • Vérifier que la batterie est bien chargée,
    • Rapprocher le capteur de la base et attendre la mesure suivante (en mettant le « wud_sleep_time » à 90 secondes pour ne pas attendre longtemps),
    • Si le problème persiste, contacter un ingénieur CKAB
  • Problème: impossible de se connecter à « http://pollux.local »
    • vérifier que la connexion est bien faite entre l’ordinateur utilisé et le pollux (notamment à travers Internet),
    • utiliser un système supportant le protocol « zeroconf » ou « bonjour » (plus exactement le multicast DNS), notamment utiliser « avahi/mdns » sous linux
    • vérifier sur le routeur si la passerelle a bien eu une adresse IP
  • Problème: la passerelle ne démarre pas
    • est-ce qu’à côté du port ethernet une diode clignote en battement de coeur ?
    • si non: vérifier que la SD Carte est présente et bien insérée
    • contacter les ingénieurs CKAB (le cable mini-USB sera nécessaire)

Errata

Les erreurs suivantes ont été identifiées sur la version actuelle et des actions correctives sont prévues pour la prochaine génération du système Pollux’NZ City

  • Configuration :
    • Le système d’adressage des capteurs a un problème d’implémentation. Ainsi, si on décoche des capteurs sur l’interface de gestion des capteurs (onglet « Sensors »), on risque d’obtenir des mesures ne correspondant pas à ce qui a été demandé ;
    • Si l’utilisateur choisi d’utiliser moins de capteurs que par défaut (et ce malgré le problème précédent), le graphe local (onglet « My Data ») ne se mettra pas à jour en fonction du nouveau nombre de capteurs ;
    • Le système de géolocalisation est peu ergonomique, et ne permet pas de trouver efficacement les coordonnées à partir de toute adresse.
    • La géolocalisation n’enregistre que les coordonnées géographiques du capteur, mais pas la hauteur de la position pour la retransmettre à un plugin d’exploitation et envoi des données.
  • Module Passerelle :
    • les diodes sur le module « passerelle » sont d’une indication peu explicite et la diode rouge peut s’allumer pour signaler des erreurs sans conséquence ;
    • il est actuellement impossible de connecter plusieurs modules autonomes de mesure à un seul module passerelle.
    • les communications en zigbee entre les deux modules ne sont pas encore chiffrées
  • Module Autonome de mesure :
    • Lors de la fermeture du capot côté batterie, il est possible de faire levier sur le bouton « on/off » et de le casser ; il faut faire attention à bien poser le capot à plat avant de baisser les fermetures.