Getting started FR

🇬🇧 English version

Premiers pas

D'un tableau de bord vide à un plan vivant, en quelques étapes. Tout se fait à la souris ou au doigt ; le YAML de la fin montre seulement ce que l'éditeur écrit.

1. Ajouter la carte

Au choix :

• Un nouveau tableau de bord : Paramètres › Tableaux de bord › Ajouter un tableau de bord › Maquette. Vous obtenez un tableau de bord avec une vue pleine largeur (« Plan ») contenant un plan vide.

• Un tableau de bord existant : Modifier le tableau de bord › Ajouter une carte › Maquette. La carte part d'une pièce de 4 × 3 m. Elle donne le meilleur d'elle-même seule dans une vue de type Panneau (pleine largeur).

• À la main (Ajouter une carte › Manuel) :

  type: custom:maquette-card
  title: Ma maison

Pour faire un tour d'abord, choisissez plutôt Maquette — démo : voir La démo.

2. Ouvrir l'éditeur

Cliquez sur le bouton Modifier le plan (règle et crayon) en haut à droite de la carte. Il n'apparaît que pour les administrateurs de Home Assistant, et pas pendant que le tableau de bord lui-même est en mode édition : quittez d'abord l'éditeur du tableau de bord (Terminé).

Sur un plan vide, la carte propose trois façons de commencer :

Bouton	Ce qu'il fait
Démarrer avec mes pièces	Liste vos pièces Home Assistant (celles qui ont des entités sont cochées). Chacune devient une pièce de 4 × 3 m avec ses murs, ses capteurs de température et d'humidité et une pastille par appareil principal. Il reste à les déplacer et les redimensionner.
Dessiner une pièce	Arme l'outil rectangle : cliquez deux coins opposés.
Importer un plan	Collez ou ouvrez un plan YAML / JSON exporté d'une autre carte Maquette.

3. Dessiner les pièces

1. Appuyez sur R (outil Pièce rectangulaire avec ses murs) et cliquez deux coins opposés. La pièce et ses quatre murs sont créés ; un mur partagé avec une voisine n'est pas doublé.
2. La nouvelle pièce est sélectionnée, avec sa barre flottante : Modifier (ou double-clic) ouvre sa fenêtre d'édition ; tapez son Nom, puis sa Largeur (cm) et sa Hauteur (cm) exactes.
3. Choisissez ses capteurs de Température et d'Humidité : la pièce est teintée selon la température (bleu à 17 °C, rouge à 28 °C) et son étiquette affiche les deux valeurs.
4. Reliez-la à une pièce Home Assistant : la vue de pièce liste alors ses appareils, scènes et automatisations, et l'éditeur propose ses capteurs quand vous ajoutez des ouvertures ou des widgets.

Pour une pièce en L, utilisez P (Pièce de forme libre) et cliquez chaque sommet ; refermez sur le premier sommet ou avec Entrée. Les espaces extérieurs (terrasse, jardin, balcon) sont des pièces avec Extérieur coché : pas de teinte de température, mais ils reçoivent la météo. Voir Dessiner le plan.

4. Placer portes et fenêtres

• La fenêtre d'édition de la pièce (onglet Pièce Home Assistant) liste les contacts et volets de sa pièce HA qui ne sont pas encore sur le plan (À placer sur les murs) : cliquez-en un, puis ses deux extrémités sur un mur.
• Ou Ajouter › Ouvertures et choisissez un préréglage (Fenêtre + volet + contact, Porte + contact, Baie coulissante, Porte de garage…), puis cliquez ses deux extrémités sur un mur. Ses capteurs sont cherchés parmi les entités libres de la pièce bordée : une seule est reliée d'office, plusieurs ouvrent une petite liste, aucune laisse le champ surligné « à compléter ».

Un contact ouvert rend l'ouverture rouge ; un volet est dessiné à l'extérieur, plus sombre à mesure qu'il se ferme.

5. Ajouter appareils et meubles

• Ajouter › Appareils › Lumière (ou Prise / interrupteur, Caméra, Capteur (valeur)…), choisissez l'entité, cliquez sur le plan. Une lumière a un halo limité à sa pièce.
• Ajouter › Meubles : posez le canapé, le lit, la borne de recharge… Les meubles se collent aux murs. Donnez une Entité à un meuble pour le rendre connecté : il s'allume quand l'appareil est actif, affiche sa puissance et ouvre sa propre fiche.

6. Ajouter des widgets à côté du plan

Sous les colonnes gauche et droite, Ajouter un widget ouvre le catalogue des widgets : 10 types de base et 65 widgets prêts à l'emploi (jauge de CO₂, fuites d'eau, serrure, production solaire…), remplis avec vos entités. Voir Widgets.

7. Enregistrer

Enregistrer (Ctrl+S) écrit le plan dans la configuration du tableau de bord, comme n'importe quelle carte. Un point sur le bouton signale des modifications non enregistrées ; un brouillon est aussi gardé dans le navigateur. Quitter ferme l'éditeur.

Ce que l'éditeur a écrit

Un petit plan, tel qu'il est stocké dans le tableau de bord (chaque clé est dans la Référence) :

type: custom:maquette-card
id: home
title: Ma maison
rooms:
  - name: Séjour
    poly: [[0, 0], [500, 0], [500, 400], [0, 400]]
    label: [250, 200]
    temperature: sensor.living_room_temperature
    humidity: sensor.living_room_humidity
    area: living_room
  - name: Chambre
    poly: [[500, 0], [850, 0], [850, 400], [500, 400]]
    label: [675, 200]
    temperature: sensor.bedroom_temperature
walls:
  - [0, 0, 850, 0]
  - [850, 0, 850, 400]
  - [850, 400, 0, 400]
  - [0, 400, 0, 0]
  - [500, 0, 500, 400]
openings:
  - type: window
    seg: [120, 0, 380, 0]
    name: Fenêtre du séjour
    contact: binary_sensor.living_room_window
    shutter: cover.living_room_shutter
    outside: [0, -1]
  - type: door
    seg: [500, 250, 500, 340]
badges:
  - entity: light.living_room
    pos: [250, 120]
    icon: mdi:ceiling-light
    color: "#f6c445"
    halo: 170
    room: Séjour

Les coordonnées sont en centimètres, x vers la droite et y vers le bas.

La démo

La démo est un petit appartement simulé (séjour, chambre, bureau, salle de bain, entrée, balcon) où tout fonctionne : lumières, volets, météo, personnes, alertes, replay, fiches. Rien n'est envoyé à la maison : services et historique ne touchent que la simulation.

• Sélecteur de cartes : Maquette — démo, ou demo: true sur une carte Maquette.
• Tableaux de bord : Ajouter un tableau de bord › Maquette — démo.

type: custom:maquette-card
demo: true
title: Démo
language: fr

Avec demo: true, seuls title et language de la configuration sont utilisés. La démo n'a pas d'éditeur.

Ensuite

Guide de l'éditeur · Entités · Recettes