Elark KB
Accéder à mon compte

Démarrage

Ajouter un nouvel appareil

Le rattachement d’un appareil à votre compte Elark se fait toujours en deux temps : (1) on crée la fiche dans l’app, qui génère un claim_code unique, et (2) on flashe le firmware ESPHome avec ce claim_code. L’appareil se rattache ensuite tout seul via MQTT.

Lecture 6 min

Comment ça marche en réalité ?

Chaque appareil est identifié par un claim_code public (format elark-XXXX-XXXX). C’est lui qui sert d’identifiant MQTT et qui rattache l’ESP à votre compte. Le claim_code est généré par le serveur au moment où vous créez la fiche de l’appareil dans l’app — vous ne le saisissez jamais à la main.

Une fois ce code injecté dans le firmware (champ mqtt_user du secrets.yaml), l’ESP se connecte au broker MQTT Elark avec ce code comme identité, et la fiche bascule automatiquement « en ligne » dans l’app. Pas de pairing manuel, pas de scan : le rattachement est implicite.

Un navigateur ne peut pas faire de découverte mDNS (l’API n’existe pas en Web) — l’app Elark est 100 % web, il n’y a pas d’app mobile pour scanner le réseau local. La création se fait donc toujours côté serveur en premier.

Ajouter un appareil

Créez d’abord la fiche dans l’app pour obtenir le claim_code, puis injectez-le dans votre propre secrets.yaml. C’est la seule méthode d’ajout — Elark ne génère ni ne compile de firmware pour vous, vous compilez et flashez de votre côté.

  1. Dans l’app, Mes appareils › + Ajouter.
  2. Saisissez un nom (ex. « Volet salon »). Validez.
  3. La modale affiche le claim_code. Cliquez sur « Copier ».
  4. Dans votre secrets.yaml, mettez :
    mqtt_broker: "mqtt.elark.cloud"
mqtt_port: 8883
mqtt_user: "elark-XXXX-XXXX"   # le claim_code collé ici
mqtt_password: "<votre mot de passe MQTT>"
wifi_ssid: "<votre SSID>"
wifi_password: "<votre mot de passe Wi-Fi>"
  5. Dans votre main.yaml ou équivalent, incluez la section MQTT standard :
    mqtt:
  broker: !secret mqtt_broker
  port: !secret mqtt_port
  username: !secret mqtt_user
  password: !secret mqtt_password
  ssl: true
  topic_prefix: devices/${device_id}
  6. esphome run main.yaml (ou la web tool officielle web.esphome.io). L’ESP se connecte et la fiche passe « en ligne » en moins de 30 secondes.

Ré-appairer un appareil existant

Si un ESP était rattaché à un autre compte (changement de propriétaire, revente), ou si vous l’avez flashé avec un firmware générique sans Elark dedans :

  1. Créez une nouvelle fiche dans l’app (voir ci-dessus). Récupérez le claim_code.
  2. Connectez-vous au web_server de l’ESP en local (http://<ip-esp>) avec votre login/mot de passe ESPHome.
  3. Dans l’interface, remplacez les valeurs MQTT par celles d’Elark (broker mqtt.elark.cloud:8883, user = nouveau claim_code, password = votre mot de passe MQTT Elark). Sauvegardez.
  4. L’ESP redémarre et se rattache au nouveau compte.

Choisir une pièce

Une fois l’appareil rattaché, attribuez-lui une pièce (Salon, Chambre, Garage…). Vous pouvez créer une nouvelle pièce depuis l’écran de l’appareil ou depuis Ma maison.

Le cloud nécessite un ESP32. La connexion au broker se fait en MQTT chiffré (TLS), que seul l’ESP32 sait gérer avec ESPHome. Un ESP8266 (Wemos D1 mini, NodeMCU…) reste local-only et ne peut pas être rendu joignable à distance. Le cloud est désormais obligatoire pour apparaître dans Elark — il n’y a plus de bascule local/cloud dans l’app.

Et la découverte mDNS dont parlent les autres docs ?

Il n’y a aucune découverte mDNS dans la plateforme actuelle : l’app web n’a ni scan réseau ni connexion locale directe à un ESP. L’application mobile Flutter qui devait un jour utiliser mDNS a été définitivement abandonnée (elle n’a jamais été publiée). L’ajout d’un appareil se fait toujours par création de fiche + injection du claim_code dans le firmware.

Vérification finale

  1. L’appareil apparaît dans Mes appareils avec une pastille verte « En ligne ».
  2. Cliquez dessus → vous voyez la liste des entités (switch, sensor, light…).
  3. Vérifiez que l’état d’une entité se met à jour dans l’app (actionnez le relais depuis son interface propre, l’état affiché dans Elark doit suivre en moins de 3 secondes).

Supprimer un appareil

Pour retirer définitivement un appareil de votre compte, ouvrez sa fiche depuis Mes appareils puis cliquez sur le bouton « Supprimer cet appareil » dans la section « Zone dangereuse » de la colonne de droite. Une confirmation est demandée.

La suppression entraîne :

  • la suppression du device et de toutes ses entités (relais, capteurs, lumières…) ;
  • la suppression de l’historique et des sauvegardes liées ;
  • la révocation des credentials MQTT du device — l’ESP physique ne pourra plus se connecter au broker.
L’ESP n’est pas effacé physiquement : il continue de tenter de se connecter avec ses anciens credentials mais sera systématiquement refusé par le broker. Pour le réutiliser ailleurs, créez une nouvelle fiche et re-flashez-le avec le nouveau claim_code (ou un autre firmware).

En cas de souci, consultez le guide de dépannage.