Guide d'intégration · Home Assistant

VIGILED dans
Home Assistant

Reliez votre VIGILED à Home Assistant pour choisir sa couleur, changer de mode, ou en faire un témoin lumineux qui réagit à votre maison — vert quand tout va bien, ambre en alerte.

⏱ environ 10 min VIGILED + Home Assistant Aucun outil requis
1

Connecter VIGILED à votre WiFi

Au démarrage, VIGILED crée son propre réseau (mode « voiture »). Pour Home Assistant, il doit rejoindre votre box.

  1. Alimentez VIGILED en 5 V USB-C (chargeur secteur, dashcam, ou tout port USB).
  2. Sur votre téléphone ou PC : Réglages → WiFi → réseau « VIGILED » (mot de passe 12345678).
  3. Ouvrez un navigateur sur http://192.168.4.1
  4. Dans la carte 🏠 WiFi Maison, saisissez le nom (SSID) et le mot de passe de votre box, puis appuyez sur Connecter.
  5. VIGILED redémarre et rejoint votre réseau :
    • 3 flashs verts = connecté ✅
    • 2 flashs oranges = échec : VIGILED rouvre son réseau « VIGILED » pour corriger le mot de passe et réessayer.
Bon à savoir VIGILED rebascule tout seul sur son réseau « voiture » s'il ne trouve pas votre WiFi. Vous ne perdez jamais l'accès à son interface.
2

Le trouver sur le réseau

Une fois connecté, VIGILED est accessible à cette adresse :

http://vigiled.local

Si elle ne répond pas (la résolution .local est capricieuse sur certains PC Windows) :

3

L'ajouter à Home Assistant

Éditez votre fichier configuration.yaml (add-on File Editor ou Studio Code Server).

3.1 — Déclarer la commande VIGILED

Ajoutez ce bloc collé à la marge de gauche (même niveau que les autres grandes rubriques du fichier) :

rest_command:
  vigiled:
    url: "http://vigiled.local/cmd?c={{ cmd }}"
    method: GET
    timeout: 5
Astuce Si vous utilisez l'adresse IP au lieu de vigiled.local, remplacez-la ici.

3.2 — Créer la lampe couleur

Cette lampe fait apparaître un cercle de couleurs dans Home Assistant. Si vous avez déjà une clé template:, ajoutez seulement le bloc - light: comme nouvel élément de la liste — ne recréez pas une deuxième clé template:.

template:
  - light:
      - name: "VIGILED Couleur"
        unique_id: vigiled_couleur
        turn_on:
          - action: rest_command.vigiled
            data:
              cmd: "MODE:12"
        turn_off:
          - action: rest_command.vigiled
            data:
              cmd: "OFF"
        set_level:
          - action: rest_command.vigiled
            data:
              cmd: "BRI:{{ (80 + (brightness / 255 * 175)) | round(0) | int }}"
        set_rgb:
          - action: rest_command.vigiled
            data:
              cmd: "COL:0:{{ r | int }}:{{ g | int }}:{{ b | int }}"
          - action: rest_command.vigiled
            data:
              cmd: "MODE:12"

3.3 — Valider et redémarrer

  1. Outils de développement → YAML → Vérifier la configuration.
  2. Redémarrez Home Assistant complètement : Paramètres → Système → (bouton d'alimentation) → Redémarrer.
Important Un simple « rechargement » ne suffit pas : les rest_command ne s'enregistrent qu'au redémarrage complet.
4

Utiliser

Si la couleur ne change pas Pensez à allumer la lampe d'abord : les contrôles de couleur n'apparaissent que lampe allumée.

Optionnel

Le mode « témoin d'état »

Faites réagir VIGILED à n'importe quel évènement de votre maison (alarme, capteur, énergie solaire…) grâce aux commandes ci-dessous, envoyées via rest_command.vigiled.

Commandes principales

CommandeEffet
MODE:<n>Change de mode LED (voir tableau)
BRI:<80-255>Règle la luminosité
COL:0:<r>:<g>:<b>Couleur du mode Fixe (0-255)
OFFÉteint les LEDs

Modes disponibles

N°ModeN°Mode
0Respiration verte11Veille
1Respiration bleue12Fixe (couleur unie)
2Respiration violette13K-2000
3Respiration orange14Intervention (ambre)
4Arc-en-ciel15Présence
5Drapeau français16Comète
6Éteint17Biphasé
7Vague

Exemple : alerte visuelle automatique

VIGILED passe en ambre (mode Intervention) quand un capteur se déclenche, et revient au vert quand tout rentre dans l'ordre :

automation:
  - alias: "VIGILED — alerte"
    trigger:
      - trigger: state
        entity_id: binary_sensor.mon_capteur
        to: "on"
    action:
      - action: rest_command.vigiled
        data:
          cmd: "MODE:14"

  - alias: "VIGILED — retour normal"
    trigger:
      - trigger: state
        entity_id: binary_sensor.mon_capteur
        to: "off"
    action:
      - action: rest_command.vigiled
        data:
          cmd: "MODE:0"

Si ça coince

Dépannage

ProblèmeSolution
vigiled.local ne répond pasUtilisez l'adresse IP trouvée dans votre box ; réservez-lui une IP fixe.
« Action rest_command.vigiled introuvable »Le bloc rest_command: est absent ou mal indenté. Vérifiez qu'il est en marge de gauche, puis redémarrez HA complètement.
Erreur « template … must be under its own template: key »La lampe doit être sous la clé template: (étape 3.2), pas sous light:.
L'entité existe mais la couleur ne change pasOuvrez la lampe et allumez-la d'abord.
Le bloc n'est pas pris en compteUne même clé (rest_command:, template:…) ne doit apparaître qu'une seule fois dans le fichier.