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.