Mise en service des capteurs ESPhome

Ce guide vous accompagne pas à pas dans tout ce dont vous avez besoin après avoir déballé un capteur :

1. Configurer le WiFi – le capteur se connecte à votre réseau
2. Ouvrir l'interface web – consulter les mesures et identifier le capteur
3. Enregistrer le capteur – pour que les données apparaissent dans votre tableau de bord
4. Mettre à jour le firmware – même lorsque le capteur est depuis longtemps sur son lieu d'utilisation

Ce dont vous avez besoin

• le capteur, raccordé à son alimentation (ou monté sur son lieu d'utilisation, voir la documentation de l'appareil)
• un WiFi 2,4 GHz avec accès Internet – les capteurs ne gèrent pas le WiFi 5 GHz. Si votre routeur propose les deux bandes sous un nom commun, ce n'est généralement pas un problème
• le nom et le mot de passe de ce WiFi
• un smartphone, une tablette ou un ordinateur portable avec WiFi et navigateur web

Configurer le WiFi

Un capteur neuf ne connaît pas encore votre WiFi. Il résout cela en créant lui-même un petit WiFi (le hotspot ou portail captif), par lequel vous lui communiquez les identifiants de votre WiFi.

Pas à pas

1. Alimenter le capteur. Si le capteur ne trouve aucun WiFi connu, il ouvre son propre hotspot après environ une minute. Son nom (SSID) commence par eco… et se termine par un identifiant, p. ex. ecopvgx-431512.

2. Se connecter au hotspot. Ouvrez les réglages WiFi de votre smartphone ou ordinateur portable et connectez-vous au hotspot du capteur. Le mot de passe est :

   Mot de passe : 12345678

3. Ouvrir la page de configuration. Sur de nombreux smartphones, la page s'ouvre automatiquement. Sinon, ouvrez l'adresse http://192.168.4.1 dans un navigateur web. Si des identifiants vous sont demandés :

   Utilisateur : admin
   Mot de passe : 12345678

   

4. Noter l'ID du capteur. En haut de la page figure l'identifiant du capteur sous la forme eco…-<ID> (marqué sur l'image). Notez-le – vous en aurez besoin plus tard pour l'enregistrement. Il peut aussi être relu plus tard dans l'interface web.

5. Saisir les identifiants de votre WiFi. Choisissez votre WiFi dans la liste (ou saisissez le nom sous SSID), saisissez le Password et appuyez sur Save.

   

6. Patienter. Le capteur redémarre, le hotspot disparaît et, après un court instant, le capteur est connecté à votre WiFi. Votre smartphone se reconnecte alors automatiquement à votre WiFi habituel.

Si votre capteur dispose d'une LED d'état, vous y voyez comment il va (voir Dépannage).

Interface web

Chaque capteur possède une petite page web qu'il met à disposition dans votre WiFi. Vous y voyez les mesures actuelles, un journal pour le dépannage et la possibilité de mettre à jour le firmware. Il vous suffit d'un navigateur web dans le même WiFi que le capteur.

Trouver le capteur

Ouvrez dans votre navigateur l'adresse

http://eco…-<ID>

donc p. ex. http://ecopvgx-431512. Dans certains réseaux, il faut ajouter .local : http://ecopvgx-431512.local.

Si ni l'un ni l'autre ne fonctionne (certains routeurs et réseaux domestiques ne résolvent pas les noms d'appareils), consultez la liste des appareils de votre routeur WiFi pour voir quelle adresse IP a été attribuée au capteur, puis ouvrez http://<adresse IP>, p. ex. http://192.168.1.95.

Connexion

Sur la page web, vous vous connectez avec :

Utilisateur : admin
Mot de passe : 12345678

Ce que vous y voyez

1. Données du capteur
2. Un « clic » sur une valeur du capteur affiche des détails (historique)
3. Un « double-clic » sur un titre agrandit la zone
4. Sortie du journal – en cas d'erreur, il indique ici ce qui ne fonctionne pas
5. Durée de fonctionnement depuis le dernier redémarrage
6. Nom et type du capteur
7. Mode clair/sombre
8. Heartbeat : vert = actif, gris = hors ligne

Plus bas dans la page, vous trouvez les indications sur le capteur lui-même :

1. ID EcoSensor – nécessaire pour enregistrer le capteur
2. Informations réseau et paramètres de fonctionnement, notamment l'adresse IP de l'interface web et la version du firmware installée
3. Mise à jour du firmware (selon le capteur sous forme de bouton Firmware update ou de sélection de fichier OTA Update, voir Mise à jour du firmware)

Enregistrer le capteur

Pour que les mesures de votre capteur apparaissent dans votre tableau de bord, il doit être associé une fois à votre compte. Pour cela, vous avez besoin de l'ID EcoSensor (eco…-<ID>) du hotspot ou de l'interface web. Le déroulement de l'enregistrement est décrit dans la documentation Enregistrer un appareil.

Intégration dans Home Assistant (optionnelle)

Sur certaines versions des capteurs, une interface vers le logiciel domotique Home Assistant peut être activée. Elle fait partie d'une variante de firmware distincte (repère -ha, voir Mise à jour du firmware). Si vous n'utilisez pas Home Assistant, vous n'avez pas besoin de ce chapitre.

Ajoutez le capteur dans Home Assistant comme suit :

Paramètres (1) → Appareils et services (2)

→ + Ajouter une intégration

Choisissez ensuite « ESPHome » et indiquez le nom d'hôte du capteur (eco…-<ID>). Il faut parfois ajouter .local, p. ex. ecopvgx-431512.local.

Une clé de chiffrement vous est ensuite demandée. Elle est jointe à chaque capteur ou vous est communiquée par e-mail.

Mise à jour du firmware

Le firmware est le logiciel qui tourne sur le capteur. Nous l'améliorons en continu ; une mise à jour apporte des corrections et de nouvelles fonctions. La façon de le mettre à jour dépend de la façon dont vous accédez au capteur et de ce que le capteur sait faire. Les capteurs de la série Eco se trouvent le plus souvent à un endroit fixe et n'y sont souvent plus joignables que par WiFi – c'est pourquoi les voies sont classées ici par effort. Prenez la plus simple qui fonctionne pour votre capteur.

Quelle voie s'applique à mon capteur ?

Ouvrez l'interface web et faites défiler vers le bas (point 3 sur l'image ci-dessus) :

• ecosensors.cloud propose-t-il une mise à jour pour votre capteur directement dans le tableau de bord ? → Voie A. (Encore en développement, voir ci-dessous.)
• Y a-t-il un bouton « Firmware update » dans l'interface web du capteur ? → Voie B.
• Y a-t-il une section « OTA Update » avec Choisir un fichier et UPDATE ? → Voie C.
• Le capteur n'est plus du tout joignable en WiFi ou une mise à jour échoue durablement ? → Voie D.

La documentation de l'appareil indique en outre quelle voie votre capteur prend en charge.

Avant chaque mise à jour

• Vérifier la version installée : Dans l'interface web, EcoSensor FW Version indique la version actuellement installée. Dans le tableau de bord, sous Firmware (connexion nécessaire), vous voyez pour chacun de vos appareils si une mise à jour est disponible.
• Assurer l'alimentation : Ne débranchez pas le capteur pendant la mise à jour et laissez-le ensuite redémarrer tranquillement (environ une minute). Pour les clés d'onduleur comme l'EcoPVGX, cela signifie : ne mettre à jour qu'en plein jour.
• Choisir la bonne variante : Certains capteurs existent avec et sans interface Home Assistant (-ha). Installez toujours la variante déjà présente sur le capteur – sinon vous modifiez involontairement son comportement (voir aussi Home Assistant).

Voie A : mise à jour via ecosensors.cloud

Les capteurs capables de se mettre à jour eux-mêmes doivent pouvoir être mis à jour à l'avenir directement via ecosensors.cloud : vous déclenchez la mise à jour sur le site web, le capteur installe seul le nouveau firmware. Vous n'avez besoin ni d'accéder à l'interface web du capteur ni d'être dans le même WiFi – le capteur doit seulement être en ligne. C'est particulièrement pratique pour les capteurs placés à des endroits exposés.

L'endroit où vous trouvez un avis de mise à jour disponible et la façon de le déclencher seront ajoutés ici dès que la fonction sera activée. Dès maintenant, la page Firmware vous montre pour chacun de vos appareils la version installée et la version actuelle.

Voie B : mise à jour d'une pression sur un bouton

Le capteur télécharge lui-même le firmware le plus récent depuis Internet et l'installe. Vous n'avez aucun fichier à télécharger.

1. Ouvrez l'interface web du capteur.
2. Appuyez sur le bouton « Firmware update ».
3. Patientez une à deux minutes. Le capteur télécharge le firmware, l'installe et redémarre. La page web est brièvement inaccessible pendant ce temps.
4. Rechargez la page et vérifiez sous EcoSensor FW Version si la nouvelle version est en service.

Si la version la plus récente est déjà installée, il ne se passe rien de grave en appuyant à nouveau – le capteur l'installe alors simplement une fois de plus.

Voie C : charger un fichier de mise à jour

Certains capteurs (p. ex. EcoPVGX, EcoSPM) ne peuvent pas se mettre à jour eux-mêmes. Ici, vous téléchargez vous-même le fichier de mise à jour et le remettez au capteur via son interface web. Pour cela non plus, vous n'avez besoin d'aucune liaison USB, vous devez seulement être dans le même WiFi que le capteur.

1. Télécharger le fichier de mise à jour

1. Connectez-vous à ecosensors.cloud et ouvrez la page Firmware.
2. Vous y voyez les produits de vos appareils, la version installée et la version actuelle. Dans la section Téléchargements, téléchargez le fichier de mise à jour (extension .ota.bin) pour la bonne variante.

2. Transférer le fichier vers le capteur

1. Ouvrez l'interface web du capteur (depuis le même WiFi) et faites défiler jusqu'à OTA Update.
2. Cliquez sur Choisir un fichier et sélectionnez le .ota.bin téléchargé.
3. Cliquez sur UPDATE et patientez jusqu'à la fin du transfert et au redémarrage du capteur (env. 1 à 2 minutes). Ne fermez pas l'onglet du navigateur avant.
4. Rechargez la page et vérifiez sous EcoSensor FW Version si la nouvelle version est en service.

Vous pouvez aussi effectuer cette mise à jour avec le smartphone : l'interface web (et la page de configuration du hotspot, également sous OTA Update) fonctionne dans le navigateur mobile.

Voie D : mise à jour par USB

Nécessaire uniquement si le capteur n'est plus joignable par WiFi, si une mise à jour via l'interface web échoue durablement ou si un appareil existant doit être converti pour la première fois à notre firmware. Pour cela, le capteur doit être physiquement accessible, c'est-à-dire relié à un ordinateur. Pour les capteurs montés à demeure, cela signifie : les démonter.

La façon de relier le capteur à l'ordinateur et la nécessité d'ouvrir un boîtier ou de placer un cavalier sont propres à chaque appareil – voir la documentation de l'appareil.

1. Sous Firmware, téléchargez l'image complète (première installation) pour votre capteur et la bonne variante.

2. Reliez le capteur à votre ordinateur par USB.

3. Ouvrez l'ESP Web Tool dans un navigateur basé sur Chromium (Chrome, Edge, Brave …). L'outil fonctionne entièrement dans le navigateur, vous n'avez rien à installer.

4. Cliquez sur CONNECT et choisissez le port USB du capteur.

   

5. Avec SELECT, choisissez le fichier téléchargé. L'adresse (champ 0x) reste sur 0. Cliquez ensuite sur PROGRAM.

   

6. Patientez jusqu'à ce que la progression atteigne 100 %.

   

7. Dès que l'outil indique Done!, débranchez le capteur de l'ordinateur et rebranchez-le à son alimentation normale (« reset your device »).

   

Le capteur démarre avec le nouveau firmware. Selon son état, il se connecte à votre WiFi ou rouvre son hotspot – commencez alors à Configurer le WiFi.

Dépannage

Messages des LED

Certains capteurs possèdent des LED d'état, dont le plus souvent la rouge sert de LED d'état. Normalement, la LED rouge ne s'allume pas du tout.

• Rouge
  • clignotement lent : Un avertissement est actif. C'est le cas, par exemple, lorsque la lecture d'une valeur du capteur échoue temporairement, lorsque la connexion WiFi ou MQTT est interrompue (p. ex. au démarrage) ou lorsque l'interface Home Assistant est active mais non connectée.
  • clignotement rapide : Le capteur a trouvé une erreur lors de la configuration. Dans la plupart des cas, il essaie malgré tout de se rétablir et de continuer.

Le hotspot n'apparaît pas

• Après la mise sous tension, patientez jusqu'à deux minutes.
• Le hotspot n'apparaît que si le capteur ne trouve aucun WiFi connu. Si votre ancien WiFi est encore à portée, il s'y connecte peut-être toujours – éteignez-le brièvement pour la configuration.
• Recherchez les WiFi dans la bande 2,4 GHz ; certains smartphones masquent les réseaux sans accès Internet ou repassent d'eux-mêmes sur votre WiFi domestique. Désactivez au besoin temporairement les données mobiles et reconnectez-vous.

L'interface web n'est pas joignable

• Êtes-vous connecté au même WiFi que le capteur (pas le WiFi invité, pas via les données mobiles) ?
• Si http://eco…-<ID> ne fonctionne pas, essayez http://eco…-<ID>.local, et si cela ne fonctionne pas non plus, l'adresse IP de votre routeur (voir Trouver le capteur).
• Redémarrez le capteur (débrancher et rebrancher le courant, ou Restart dans l'interface web).

Le capteur ne se signale pas dans le tableau de bord

• Le capteur est-il enregistré ?
• L'interface web montre-t-elle le heartbeat en vert, mais le capteur est hors ligne dans le tableau de bord ? Vérifiez l'accès Internet de votre WiFi.
• Si la variante Home Assistant tourne sans couplage, le capteur redémarre toutes les 15 minutes (voir Home Assistant).

La mise à jour du firmware ne fonctionne pas

• Voie B : Le capteur a-t-il un accès Internet ? Sinon, utilisez la voie C.
• Voie C : S'agit-il bien du fichier de mise à jour (.ota.bin) et de la variante correspondant au capteur ?
• Si le transfert s'interrompt, rapprochez-vous du capteur avec votre appareil ou améliorez la réception et réessayez.
• Si rien de tout cela n'aide : voie D.

Documentation des appareils

Les pages suivantes contiennent tout ce qui ne concerne que l'appareil correspondant – p. ex. raccordement, compatibilité, caractéristiques techniques et particularités de la mise à jour du firmware par USB :

• EcoPVGX – pour onduleurs Growatt
• EcoMBR1 – pour appareils ModBus RTU
• EcoSPM – pour Shelly PM Mini Gen3