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 :
- Le nœud se réveille.
- Il lit ses capteurs.
- Il envoie les valeurs par radio LoRa à la passerelle.
- Il attend brièvement un accusé de réception.
- 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.
- Installez l'application gratuite ESP BLE Provisioning (Espressif Systems) pour Android ou iOS.
- Raccordez la passerelle à l'alimentation. Tant qu'elle ne connaît aucun WiFi, elle démarre automatiquement le mode de configuration.
- Ouvrez l'application et recherchez l'appareil. Il se signale sous le nom
PROV_…. - 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.
- 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
- 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. - Choisissez le fichier de firmware (
.bin) et envoyez-le. - 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 :
- 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.
- Lors de ses prochains cycles de mesure, le nœud maintient brièvement le Bluetooth disponible à chaque fois. Cet état persiste environ 30 minutes.
- 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.
- 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.