Démarrage

Dépannage : mon appareil ne remonte pas

Cinq 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. Re-générez un firmware depuis le Marketplace après avoir mis à jour vos identifiants WiFi dans Paramètres.
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>-fallback avec le mot de passe AP fallback (visible dans le bundle ZIP, fichier secrets.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 hello

Si ç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. Il est imprimé dans le bundle secrets.yaml en tant que mqtt_user. Si vous avez régénéré le firmware après création du device, le claim_code peut avoir changé — re-téléchargez le bundle.

4. Forcer un redémarrage

Sur le LAN, ouvrez http://<ip-appareil> et cliquez Reboot. Ou coupez/rebranchez l’alimentation pendant 10 s.

En cloud, ouvrez l’appareil dans l’app et utilisez Diagnostic › Redémarrer.

5. Désactiver puis réactiver l’accès cloud

Dans l’app, basculez le switch « Accès Cloud » deux fois (OFF → ON). Cela force la republication MQTT et résout 80 % des cas où la fiche existe mais reste grise.

Toujours rien ?

Récupérez le diagnostic complet :