Elark KB

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 votre secrets.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>-fallback avec le mot de passe AP fallback défini dans votre 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. 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.