Fonctions du firmware

Transmission radio, économie d'énergie et utilisation sur l'appareil

Le firmware est le logiciel qui tourne directement sur la passerelle HC-50 et les nœuds HC-50. Il veille à ce que les mesures soient enregistrées, transmises par radio et affichées dans EcoSensors.cloud. Le même code de programme est utilisé pour la passerelle et le nœud. Ils ne diffèrent que par leur tâche.

Cette page décrit le firmware version 0.9.6. Il s'agit d'une version préliminaire, testée sur du matériel réel. La mesure du niveau d'eau est en test. D'autres capteurs, p. ex. pour le pH, suivront dans des versions ultérieures.

Comment le système fonctionne

La passerelle et le nœud ont des tâches différentes :

Nœud (station de mesure) Passerelle (station de base)
Tâche Mesurer et envoyer Recevoir et transmettre au cloud
Alimentation Batterie, économe Bloc d'alimentation USB, permanent
Connexion radio LoRa uniquement radio LoRa et WiFi
Fonctionnement dort la plupart du temps écoute en permanence les signaux radio

Un cycle de mesure du nœud :

  1. Le nœud se réveille.
  2. Il lit ses capteurs.
  3. Il envoie les valeurs par radio LoRa à la passerelle.
  4. Il attend brièvement un accusé de réception.
  5. Il se rendort.

La passerelle reçoit les valeurs, accuse réception et les transmet via WiFi et Internet à EcoSensors.cloud. Les valeurs du nœud y apparaissent exactement comme celles de la passerelle elle-même.

Un nœud émet directement vers les passerelles à sa portée. Planifiez donc les emplacements de façon que chaque nœud atteigne directement au moins une passerelle. Plusieurs kilomètres sont typiques, selon le terrain.

Aperçu des fonctions

Transmission radio fiable

  • Accusé de réception : La passerelle accuse réception de chaque paquet reçu. Si aucun accusé n'arrive au nœud, il envoie jusqu'à trois fois.
  • Puissance d'émission automatique : Le nœud démarre avec peu de puissance et l'augmente si nécessaire. Si un niveau fonctionne de façon fiable, il le mémorise et essaie plus tard prudemment d'émettre à nouveau avec moins de puissance. Cela ménage la batterie.
  • N'envoyer que les changements : Une valeur n'est transmise que si elle a changé depuis la dernière transmission. Cela raccourcit le temps d'émission et économise de l'énergie. Le cloud affiche entre-temps la dernière valeur connue.
  • Limitation du temps d'émission : Les appareils radio de la bande 433 MHz ne peuvent émettre qu'une partie du temps (plus d'informations sur les paramètres radio sous Technologie radio LoRa). Le firmware respecte seul cette limite légale et allonge les pauses si nécessaire. Vous n'avez rien à régler.

Plusieurs passerelles

Depuis la version 0.9.4, plusieurs passerelles dont les portées se recouvrent peuvent fonctionner ensemble. Le système devient ainsi tolérant aux pannes, voir Système HC-50.

  • Chaque passerelle transmet elle-même : Chaque passerelle qui reçoit un paquet d'un nœud transmet ses valeurs au cloud via son propre WiFi. Le cloud élimine les doublons. Les passerelles ne se retransmettent pas les paquets entre elles. Chacune a donc besoin de sa propre alimentation et de son propre WiFi avec accès Internet.
  • Une seule passerelle accuse réception : Les passerelles se coordonnent par radio. La priorité revient à une passerelle qui détient un réglage pour le nœud, puis à une passerelle dont la connexion Internet fonctionne, puis à celle qui a la meilleure liaison radio avec le nœud. Les autres entendent l'accusé de réception et renoncent au leur.
  • Relais automatique : Si une passerelle tombe en panne ou perd sa connexion Internet, une autre accuse réception et transmet. Une passerelle sans connexion Internet n'accuse réception que si aucune autre ne le fait.
  • Aucun réglage nécessaire : Tous les appareils utilisent le même canal radio. Rien ne change sur les nœuds.
  • Qualité radio par passerelle : Chaque passerelle indique la qualité de réception d'un nœud et des autres passerelles. La carte réseau du tableau de bord en découle.

Les passerelles dotées d'un firmware plus ancien ne se coordonnent pas. Dans une installation à plusieurs passerelles, mettez toutes les passerelles à jour vers la version 0.9.4 ou une version plus récente.

Fonctionnement économe sur batterie

Le nœud dort complètement entre deux mesures. Pendant ce temps, il consomme très peu et la batterie dure en conséquence longtemps. En sortie d'usine, l'intervalle de mesure est volontairement réglé court, à environ 20 secondes, afin que les tests puissent être évalués rapidement. Pour l'usage sur le terrain, il se règle à distance pour chaque nœud entre 10 secondes et 24 heures, voir « Réglages à distance » plus bas. Moins on mesure souvent, plus la batterie dure longtemps. Ce qui influence encore l'autonomie figure sous Alimentation.

Capteurs

Les capteurs suivants sont pris en charge par le firmware. Ils peuvent être raccordés à la passerelle et au nœud :

Capteur Mesures
Température du processeur (intégrée) Température dans l'appareil
BME280 Température, humidité, pression atmosphérique
BMP280 Température, pression atmosphérique
BMP085 Température, pression atmosphérique
VEML7700 Luminosité (lux)
MCP9808 Température précise (±0,25 °C)
DS18B20 Température, p. ex. température de l'eau (jusqu'à quatre sondes)
RCWL-9620 (ultrasons) Distance à la surface de l'eau pour le niveau d'eau, en test

Les capteurs n'ont pas besoin d'être configurés. Au démarrage, le firmware vérifie quels capteurs sont raccordés et ne transmet que leurs valeurs. Un capteur non raccordé ne génère pas de message d'erreur.

En outre, chaque appareil signale des informations sur son propre état : durée de fonctionnement, version du firmware, qualité de la liaison radio (puissance du signal et rapport signal/bruit) et taux d'utilisation du temps d'émission autorisé. Pour la passerelle s'ajoutent des données WiFi, p. ex. la puissance du signal WiFi.

La mesure du niveau d'eau par ultrasons est en test. D'autres capteurs pour la qualité de l'eau, p. ex. pour le pH, sont en développement. L'état de chaque grandeur mesurée figure sur la page Surveillance des eaux. Le capteur de CO₂ SCD40, les capteurs de mouvement MPU-6500 et MPU-6050 (inclinaison et mouvement de l'appareil), la surveillance de la batterie, le Paxcounter et les interrupteurs magnétiques pour la maintenance sont également en test. Des capteurs de particules fines, de vent, de qualité de l'air (MQ-135 : alcool, benzène, CO₂, fumée et autres gaz) et de radioactivité ainsi que la localisation par GPS sont prévus.

État en ligne

Chaque appareil est géré dans le cloud avec l'état en ligne ou hors ligne. Une passerelle se désinscrit d'elle-même dès que la connexion est rompue. Pour les nœuds, la passerelle assume cette tâche : si elle n'entend plus rien d'un nœud pendant longtemps, elle le marque comme hors ligne. Le délai d'attente dépend de l'intervalle de mesure du nœud.

En outre, la passerelle tient un journal d'événements pour chaque nœud. Elle y consigne la panne ou le rétablissement d'un capteur, le passage du nœud hors ligne ou en ligne, l'absence d'accusés de réception et le changement de version du firmware.

Identifiant d'appareil unique

Chaque appareil reçoit automatiquement son propre identifiant, dérivé de son adresse matérielle :

  • Passerelles : hc50gw-xxxxxx
  • Nœuds : hc50nd-xxxxxx

Vous n'avez à saisir l'identifiant nulle part. Pour la passerelle, il se trouve sur l'écran et sur l'autocollant. Il vous permet d'associer l'appareil dans le cloud.

Réglages à distance

Certains réglages peuvent être modifiés via la connexion au cloud (MQTT), sans ouvrir l'appareil :

Réglage Effet
Intervalle de mesure (nœud) de 10 secondes à 24 heures
Puissance d'émission maximale (nœud) limite supérieure de la puissance d'émission automatique
LED allumer et éteindre, désactiver les signaux automatiques
Mode de mise à jour (nœud) tenir le Bluetooth prêt pour une mise à jour du firmware, voir « Mettre à jour le firmware »

Une passerelle applique un réglage immédiatement. Un nœud le reçoit dès qu'il se manifeste de nouveau, car il dort entre-temps. L'intervalle de mesure et la puissance d'émission maximale restent enregistrés dans le nœud, même après un changement de batterie. Pour toute modification, adressez-vous au support si nécessaire.

Utilisation sur l'appareil

Écran

Les modèles de passerelle avec écran (Heltec WB32LA) affichent l'état et les mesures. Pour économiser l'énergie et ménager l'écran, il s'éteint après une minute sans manipulation.

Bouton (PRG)

  • Appui court : réveille l'écran.
  • En même temps, le bouton déclenche une transmission de test. Vous vérifiez ainsi sur le lieu d'utilisation si la liaison radio est établie.

LED

La LED ne s'allume que lors d'événements, pas en permanence :

  • Brève lueur : activité radio, c'est-à-dire qu'un paquet a été envoyé ou reçu.
  • Quatre clignotements rapides : une erreur s'est produite.

La LED peut aussi être allumée et éteinte manuellement via le cloud et sert alors p. ex. d'aide pour retrouver un appareil sur place. Les affichages automatiques peuvent alors être désactivés.

Configurer le WiFi (passerelle)

Les identifiants WiFi ne sont pas inscrits en dur dans le firmware, mais saisis par smartphone lors de la mise en service. Votre mot de passe n'est ainsi stocké que sur votre appareil.

  1. Installez l'application gratuite ESP BLE Provisioning (Espressif Systems) pour Android ou iOS.
  2. Raccordez la passerelle à l'alimentation. Tant qu'elle ne connaît aucun WiFi, elle démarre automatiquement le mode de configuration.
  3. Ouvrez l'application et recherchez l'appareil. Il se signale sous le nom PROV_….
  4. Saisissez le code PIN. Il figure sur l'écran de la passerelle ou, pour les modèles sans écran, sur l'autocollant ou le code QR de l'appareil, si l'appareil a été livré ainsi. Chaque appareil a son propre PIN.
  5. Choisissez votre WiFi et saisissez le mot de passe. La passerelle se connecte et s'enregistre dans le cloud.

Rétablissement automatique : Si la passerelle n'atteint pas son WiFi pendant deux minutes, elle ouvre le mode de configuration pendant cinq minutes, puis réessaie avec le WiFi enregistré. Cela se répète jusqu'à ce que la connexion soit établie. Les identifiants enregistrés sont toujours conservés : après une coupure de courant ou un redémarrage du routeur, la passerelle se reconnecte d'elle-même. Si le mot de passe WiFi a changé, répétez les étapes ci-dessus dès que le mode de configuration est ouvert. Vous n'avez pas besoin d'ouvrir l'appareil ni de brancher un câble pour cela.

Mettre à jour le firmware

Il existe trois voies. Celle qui convient dépend de l'appareil :

Appareil Voie Effort
Passerelle Par WiFi via une page web dans le navigateur faible, aucun câble nécessaire
Nœud Par Bluetooth avec le smartphone moyen, vous devez être sur place
Passerelle et nœud Par câble USB le boîtier doit être accessible

Passerelle : par WiFi

  1. Ouvrez dans le navigateur http://<adresse IP de la passerelle>/update. Le smartphone ou le PC doivent être dans le même WiFi. Vous trouvez l'adresse IP dans votre routeur ou dans le cloud auprès de l'appareil.
  2. Choisissez le fichier de firmware (.bin) et envoyez-le.
  3. La passerelle installe le firmware et redémarre d'elle-même.

Nœud : par Bluetooth

Un nœud dort presque tout le temps. Il doit donc d'abord être mis en mode de mise à jour, sans que vous ayez à l'ouvrir :

  1. Demandez le mode de mise à jour pour le nœud. Cela peut se faire avant même le déplacement via la liaison cloud (MQTT). Adressez-vous pour cela au support si besoin.
  2. Lors de ses prochains cycles de mesure, le nœud maintient brièvement le Bluetooth disponible à chaque fois. Cet état persiste environ 30 minutes.
  3. Sur place, connectez-vous avec l'application Android ESP32 OTA BLE et sélectionnez le fichier de firmware. La portée est de quelques mètres à quelques dizaines de mètres.
  4. Après l'installation, le nœud redémarre. Si personne n'est arrivé dans le délai, il revient de lui-même en fonctionnement normal.

Par câble USB

Toujours possible si vous avez l'appareil en main. Il faut pour cela un ordinateur et l'environnement de développement. Adressez-vous au support si besoin.

N'installez que des fichiers de firmware que vous avez reçus directement d'EcoSensors. Les mises à jour par WiFi et Bluetooth ne vérifient pas encore dans la version actuelle si le fichier est authentique. Une vérification par signature numérique sera ajoutée.

Bon à savoir

  • La connexion est interrompue : Si Internet ou le WiFi est brièvement perturbé, la passerelle se reconnecte d'elle-même et envoie ensuite les valeurs mises en tampon. Ce tampon est petit. Lors d'une perturbation prolongée, des valeurs sont perdues, sauf si une deuxième passerelle entend les nœuds.
  • Plusieurs passerelles à portée : Tous les appareils utilisent le même canal radio. À partir de la version 0.9.4, les passerelles se coordonnent automatiquement, voir « Plusieurs passerelles » plus haut.
  • Meilleure liaison radio : Positionnez la passerelle et les nœuds le plus dégagé possible, p. ex. sur un mât ou sur le toit, et non près de grandes surfaces métalliques. Plus d'informations sous Technologie radio LoRa.