Elark KB
Accéder à mon compte

Démarrage

Ajouter un nouvel appareil

Trois manières d’ajouter un appareil à votre compte Elark : depuis le Marketplace (ESPHome), via découverte locale mDNS, ou en saisie manuelle (code de claim).

Lecture 6 min

Pré-requis

  • Un ESP8266 ou ESP32 (avec USB ou en place déjà flashé).
  • Vos identifiants WiFi/MQTT par défaut renseignés dans Paramètres › Identifiants par défaut.
  • Pour la première installation : un câble USB-C ou micro-USB selon votre carte.

Méthode A — Générer un firmware depuis le Marketplace

C’est la méthode recommandée pour un appareil neuf ou non flashé.

  1. Dans l’app, ouvrez Marketplace puis choisissez le modèle (volet roulant, prise connectée, sonde DS18B20, etc.).
  2. Cliquez sur « Configurer ». Renseignez les variables (nom de l’appareil, GPIO, etc.). Les champs WiFi/MQTT et le claim_code sont remplis automatiquement.
  3. Cliquez sur « Télécharger le bundle ZIP ». Vous obtenez 4 fichiers : main.yaml, secrets.yaml, base.yaml et README.txt.
  4. Sur votre poste, dézippez et flashez :
    pip install esphome esphome run main.yaml
    (ou utilisez la web tool officielle : web.esphome.io)
  5. Une fois flashé, branchez l’ESP. Il rejoint votre WiFi, publie sur le broker MQTT Elark et apparaît automatiquement dans Mes appareils sous 30 secondes.

Méthode B — Découverte locale (mDNS)

Si l’appareil tourne déjà sur votre LAN avec un firmware ESPHome compatible (web_server v3 activé), l’app le détecte automatiquement.

  1. Allez sur Mes appareils › + Ajouter.
  2. L’app scanne le LAN via mDNS (service _esphomelib._tcp). Les ESP détectés s’affichent avec leur IP locale.
  3. Cliquez sur celui à rattacher. L’app récupère son claim_code et le lie à votre compte.
La découverte mDNS fonctionne uniquement sur le même réseau WiFi/LAN que votre téléphone ou navigateur. Pas de découverte cross-VLAN.

Méthode C — Saisie manuelle (claim code)

Si vous avez le claim_code (étiquette sous l’appareil ou affiché à la fin du flash), entrez-le directement.

  1. Mes appareils › + Ajouter › Saisir un code.
  2. Tapez le code (format elark-XXXX-XXXX).
  3. Donnez-lui un nom (ex. « Volet salon »).
  4. Validez.

Choisir une pièce

Une fois l’appareil ajouté, 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.

Cloud actif ou non ?

Par défaut, l’accès cloud est désactivé sur chaque nouvel appareil. L’appareil est donc joignable uniquement sur le LAN.

Pour activer l’accès à distance, ouvrez l’appareil dans l’app et basculez l’interrupteur « Accès Cloud ». L’appareil commence alors à publier ses états sur le broker MQTT Elark.

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. Testez une commande (toggle d’un relais par exemple). La réponse doit être instantanée (< 1 s en LAN, < 3 s en cloud).

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