Démarrage
Dépannage : mon appareil ne remonte pas
Quatre points à vérifier dans l’ordre quand un appareil ne se connecte pas, n’apparaît pas dans l’app, ou bascule constamment hors ligne.
Lecture 3 min
1. Vérifier que le device est sous tension et associé au WiFi
Branchez l’appareil et attendez 30 secondes. La LED de status doit cesser de clignoter (le clignotement signifie « pas de WiFi »).
Si elle continue à clignoter :
- Le SSID / mot de passe WiFi est faux dans
secrets.yaml. Corrigez-le à la main dans votresecrets.yaml, puis recompilez et re-flashez (esphome run main.yaml). - Le réseau WiFi n’est pas joignable (signal faible, hors portée, 5 GHz alors que l’ESP est 2.4 GHz uniquement).
- L’ESP redémarre l’AP de fallback. Connectez-vous au SSID
<device_id>-fallbackavec le mot de passe AP fallback défini dans votresecrets.yaml.
2. Vérifier l’accès au broker MQTT
Si l’appareil est censé être en cloud, il doit pouvoir sortir vers mqtt.elark.cloud:8883. Depuis le LAN, testez :
mosquitto_pub -h mqtt.elark.cloud -p 8883 \
--cafile /etc/ssl/certs/ca-certificates.crt \
-u <claim_code> -P <mqtt_password> \
-t test -m helloSi ça échoue, votre pare-feu/box bloque sans doute le port 8883 en sortie. Autorisez-le.
3. Vérifier le claim_code
Le claim_code est l’identifiant MQTT qui rattache l’appareil à votre compte. C’est la valeur mqtt_user que vous avez collée dans votre secrets.yaml lors de la création de la fiche (cf. Ajouter un appareil). Si elle ne correspond plus au claim_code affiché sur la fiche de l’appareil dans l’app, corrigez-la et re-flashez.
4. Forcer un redémarrage
Sur le LAN, ouvrez http://<ip-appareil> et cliquez Reboot. Ou coupez/rebranchez l’alimentation pendant 10 s. Il n’existe aucune action de redémarrage à distance depuis l’app Elark (supervision seule) — c’est une manipulation physique ou l’interface locale de l’ESP.
Toujours rien ?
Ouvrez l’appareil dans l’app, onglet Diagnostic : relevez les problèmes affichés (WiFi, MQTT, dernière télémétrie…) et transmettez-les au support avec le modèle et la marque de l’appareil, à supportelark.cloud.