Skip to content

Entities FR

Jump to bottom
Alex RAMIREZ edited this page Oct 13, 2026 · 4 revisions

🇬🇧 English version

Entités

Comment Maquette lit et affiche vos entités Home Assistant, domaine par domaine, ce que fait un toucher, et quels services elle peut appeler. Presque toute entité peut servir presque partout ; certains domaines ont un traitement particulier, décrit ici.

Où vont les entités

Endroit Clé(s) Entités habituelles
Pièce temperature, humidity (+ _attribute), tap sensor (température, humidité), weather / climate avec un attribut
Ouverture contact, shutter, entity binary_sensor porte / fenêtre, cover volet, cover portail / garage
Pastille entity, active, value tout
Meuble connecté entity, active, value switch + sensor de puissance, media_player, climate…
Widget (panneaux, fiches) entity, rows, entities, clés propres au type voir Widgets
Puce du résumé entity, presence tout ; voir Puces du résumé
Ligne d'une zone d'informations entity (+ attribute) tout
Alerte plein plan entity, entities détecteurs, tout capteur numérique
Ambiance sun, weather, personnes sun.sun, weather.*, person.*
Présence presence zone.home (défaut), person, group, binary_sensor

Pastilles

Une pastille est une icône ronde posée sur le plan, colorée quand son entité est active, avec une valeur, un halo, une animation et une fiche facultatifs.

badges:
  - entity: light.living_room
    pos: [230, 200]
    icon: mdi:floor-lamp
    name: Lampadaire               # infobulle, listes, titre de la fiche
    color: "#f6c445"               # couleur quand elle est active
    halo: 170                      # rayon du halo de lumière en cm (true = 130)
    room: Séjour                   # limite le halo à cette pièce (nom exact de la pièce)
  - entity: switch.washer_plug
    pos: [60, 380]
    icon: mdi:washing-machine
    value: sensor.washer_power     # valeur affichée dans la pastille
    active: sensor.washer_power    # « actif » vient de cette entité…
    threshold: 5                   # …quand elle dépasse 5
  - entity: climate.thermostat
    pos: [300, 60]
    icon: mdi:thermostat
    attribute: temperature         # affiche cet attribut de `entity` comme valeur
    unit: " °C"
    active_attribute: hvac_action  # active tant que hvac_action vaut heating / cooling
  • Couleur : color quand elle est active, sinon la couleur d'état actif de Home Assistant. light_color: true dessine l'icône en sombre sur une couleur claire (deviné d'après color s'il est absent). Les pastilles inactives restent neutres.
  • Icône : icon, sinon mdi:circle. L'éditeur écrit une icône d'après l'entité (sa propre icône, sa classe d'appareil, son domaine).
  • Halo : une lueur ambrée de rayon halo (cm) tant que la pastille est active, limitée à la pièce nommée dans room et aux pièces ouvertes sur elle (bord commun sans mur ni ouverture). Nouveau en 0.2.1 : room: false donne un halo libre, jamais coupé ; l'éditeur propose Automatique (pièce où elle est posée) et Aucune : halo libre sous Halo limité à une pièce. La couleur et la luminosité de la lampe ne sont pas utilisées ; n'importe quel domaine peut avoir un halo.
  • alert: true : la pastille utilise l'animation alerte tant qu'elle est active (pulsation par défaut).
  • Indisponible : estompée (voir badge_style plus bas).
  • Les pastilles gardent la même taille à l'écran quel que soit le zoom.

Style des pastilles (⚙ Paramètres › Pastilles d'appareils) :

badge_style:
  unavailable: dashed     # dimmed (estompée, défaut) | dashed (pointillés) | hidden (masquée)
  inactive: active_only   # shown (affichée, défaut) | active_only (seulement actives) | dimmed (estompée)
  size: small             # small (0,8×) | normal | large (1,25×)
  values: hover           # always (toujours, défaut) | hover (au survol) | never (jamais)

Une pastille masquée compte toujours dans les puces et apparaît dans la vue de pièce ; une pastille concernée par une alerte plein plan reste visible ; l'éditeur montre toujours toutes les pastilles.

Règle de l'état actif

Pastilles, meubles connectés et icônes des fiches suivent la même règle :

  1. La valeur lue est l'état de active (défaut : entity), ou son attribut active_attribute.
  2. Avec threshold, actif signifie valeur > seuil (nombres).
  3. Sans seuil, actif signifie que la valeur est l'une de on, open, opening, closing, playing, heating, cooling, cleaning, detected, home.

Donc, sans threshold ni active_attribute, des états comme unlocked, triggered, armed_away, heat (un mode de thermostat), recording ou not_home ne sont pas actifs. Utilisez active_attribute: hvac_action pour un thermostat, ou un capteur binaire template dans Home Assistant pour le reste.

Valeurs et unités

  • Widgets, lignes, puces et zones d'informations : decimals s'il est indiqué, sinon 1 décimale, ou 0 à partir de 100 ; unité = unit, sinon le unit_of_measurement de l'entité. decimals est un maximum (21,0 s'affiche 21).
  • value d'une pastille ou d'un meuble : 0 décimale par défaut. Avec attribute, 1 décimale au plus et seulement l'unit que vous donnez.
  • Les états non numériques sont affichés tels que Home Assistant les formate (traduits).
  • En français, une espace insécable précède % et °C ; les nombres suivent la langue de Home Assistant.

Par domaine

light

  • Pastille : active quand on ; halo si halo est réglé ; utilise l'animation lumière (aucune par défaut).
  • Comptée dans la puce lumières (pastilles de lumières seulement, masquées comprises).
  • Vue de pièce : listée avec un interrupteur ; bouton Éteindre tout / Allumer tout pour les lumières de la pièce.
  • En-tête de fiche : interrupteur marche / arrêt (light.turn_on / turn_off).

switch, fan, input_boolean, humidifier

  • Interrupteur dans les widgets entities et dans la vue de pièce (homeassistant.toggle), et interrupteur marche / arrêt dans l'en-tête d'une fiche. Dans une fiche, les lignes des listes montrent des valeurs, pas des interrupteurs.
  • protected: true retire l'interrupteur « arrêt » de la fiche de l'élément (frigo, congélateur…) ; un bouton Rallumer apparaît quand il est éteint. Les interrupteurs de la vue de pièce et des panneaux latéraux ne suivent pas protected.
  • Une prise avec un capteur de puissance : value + active sur la puissance, threshold: 5 (l'Appareil mesuré de l'éditeur).

cover (volets, stores, portails, portes de garage)

  • shutter d'une ouverture : dessiné dehors, opacité d'après current_position (sans position : closed = 0 %, tout le reste 100 %), animé pendant opening / closing. Compté dans la puce volets en dessous de 50 %.
  • entity d'une ouverture : portail ou porte motorisés, leur état donne la couleur de l'ouverture quand il n'y a pas de contact.
  • Widget cover : état, barre de position, Ouvrir / Stop / Fermer (boutons masqués quand supported_features ne les prévoit pas). Dialogue de confirmation par défaut pour les classes garage, gate, door (voir Sécurité).
  • Vue de pièce : boutons Ouvrir / Fermer pour les cover de la pièce de classe shade, shutter, blind, curtain, awning ou window.

valve

Widget cover avec valve.open_valve / stop_valve / close_valve ; l'ouverture est toujours confirmée. Demande Home Assistant 2024.1. Widget prêt à l'emploi Vanne d'arrêt (Eau).

lock

Widget lock : état (rouge quand déverrouillée, ouverte ou bloquée), Déverrouiller quand elle est verrouillée, Verrouiller quand elle est déverrouillée, les deux quand l'état est incertain, Ouvrir quand la serrure le permet. Déverrouiller et Ouvrir sont toujours confirmés dans un dialogue. Aucun code n'est jamais envoyé : une serrure qui demande un code se commande depuis son plus d'infos.

binary_sensor

Classe d'appareil Usage
door, window, opening, garage_door contact d'une ouverture : rouge quand on
moisture, smoke, gas, carbon_monoxide, safety, problem, tamper, heat, cold Valeur en rouge quand on dans les lignes et les tuiles ; candidats naturels aux alertes plein plan
motion, occupancy, presence active d'une pastille (une pastille de caméra qui clignote au mouvement : alert: true)
plug, battery_charging plugged du widget ev

sensor

Classe d'appareil / unité Usage
temperature, humidity temperature / humidity d'une pièce (teinte et étiquette), widget climate
power (W, kW, MW) value d'une pastille ou d'un meuble ; source des flux d'énergie (d'après l'unité)
energy (kWh, Wh) Widget periods depuis les statistiques de Home Assistant (stat)
carbon_dioxide, composés organiques volatils, pm25, illuminance, pressure, battery… Widgets gauge et tile, widgets prêts à l'emploi avec des bornes raisonnables
monetary, prix (€/kWh) Widgets periods et tariff

Tout capteur numérique fonctionne dans une tile (avec courbe d'historique) ou une gauge.

climate

  • Pastille : attribute: temperature (consigne) ou current_temperature, active_attribute: hvac_action (chauffe / refroidit).
  • Widget thermostat : température actuelle, consigne avec − / + (climate.set_temperature, arrondie au pas de l'appareil, entre min_temp et max_temp), action et mode. Le mode ne se change pas depuis la carte.
  • temperature d'une pièce avec temperature_attribute: current_temperature.

media_player

Pastille active pendant playing. Widgets prêts à l'emploi Télévision et Enceintes.

camera

Une pastille (le préréglage Caméra de l'éditeur) avec active réglé sur un détecteur de mouvement et alert: true clignote au mouvement ; un toucher ouvre le plus d'infos de la caméra. La carte n'affiche pas de vidéo.

person, zone, device_tracker

  • ambience.people affiche les entités person.* à la maison ou absentes, avec leur direction et leur distance calculées d'après leurs latitude / longitude et la position de la maison dans Home Assistant. Voir Ambiance › Personnes.
  • La présence (puces show: away|home, alertes when_away) lit presence, par défaut zone.home : un nombre (personnes dans la zone) > 0 signifie que quelqu'un est là ; pour une personne, un groupe ou un capteur binaire, home / on signifie présent.
  • device_tracker n'a pas de traitement particulier (widget prêt à l'emploi Téléphones).

weather et sun

  • weather.* : météo peinte sur les espaces extérieurs (condition, cloud_coverage, wind_speed, wind_bearing), température d'une pièce via temperature_attribute, widget prêt à l'emploi Météo.
  • sun.sun : jour et nuit (elevation, azimuth, next_setting).

scene, script, button, input_button

  • Dans les listes des panneaux latéraux : un bouton Activer (scene.turn_on, script.turn_on, button.press, input_button.press) ; scripts et boutons demandent d'abord confirmation. Dans une fiche, ces lignes affichent seulement leur valeur.
  • Les scènes liées à la pièce Home Assistant d'une pièce apparaissent en boutons dans sa vue de pièce.

automation

Les automatisations et scripts liés à une pièce (pièce Home Assistant ou entités) sont listés dans sa vue de pièce avec leur dernier déclenchement ; une automatisation a un interrupteur marche / arrêt (homeassistant.toggle).

alarm_control_panel, vacuum, event et autres

Pas de dessin particulier : utilisez une pastille (un aspirateur est actif pendant cleaning), une tuile, une puce ou une alerte (state: triggered). Des widgets prêts à l'emploi existent pour Alarme, Aspirateur robot et Sonnette.

Ce que fait un toucher

Élément Par défaut Options
Pièce (sol ou étiquette) Vue de pièce interaction.room_tap: more_info (son tap, sinon temperature) ou none ; zoom: false par pièce
Pastille Plus d'infos de entity tap: card (défaut quand elle a une card), more_info, none
Ouverture Plus d'infos de contact, sinon entity, sinon shutter comme les pastilles
Meuble connecté Sa fiche s'il en a une, sinon le plus d'infos tap
Valeur d'un widget, ligne de liste, puce, ligne de zone d'informations, personne Plus d'infos

Dans la démo, les fenêtres plus d'infos sont désactivées (les entités sont simulées).

Services que Maquette peut appeler

Rien n'est appelé sans un toucher ; la lecture de l'historique, des statistiques et des éléments liés est automatique. La liste complète :

Service Quand
homeassistant.toggle Interrupteurs des widgets entities et des rows dans les panneaux latéraux, lignes d'appareils et d'automatisations de la vue de pièce
light / switch / fan / input_boolean / humidifier .turn_on / .turn_off Interrupteur marche / arrêt de l'en-tête d'une fiche, sur l'entité de l'élément ; jamais « arrêt » si protected
scene.turn_on, script.turn_on, button.press, input_button.press Boutons Activer des listes des panneaux latéraux ; boutons de scènes de la vue de pièce
cover.open_cover / stop_cover / close_cover, valve.open_valve / stop_valve / close_valve Widgets cover (seulement pour une entité configurée dans un tel widget)
lock.lock / unlock / open Widgets lock (seulement pour une entité configurée dans un tel widget)
climate.set_temperature Widgets thermostat
light.turn_on / turn_off, cover.open_cover / close_cover Boutons automatiques de la vue de pièce
n'importe quel domaine.service Boutons actions d'une pièce : le service, les data et la cible écrits dans la configuration par un administrateur

Les services sensibles (déverrouiller, ouvrir une porte de garage, un portail ou une vanne, désarmer, lancer un script, tout service non reconnu comme sûr) ouvrent toujours un dialogue de confirmation qui nomme le vrai service, quel que soit le libellé du bouton. confirm: true le demande même pour un service sûr (boutons des pièces, bulles, ouvertures, meubles, widgets). Détails : Sécurité.

Pré-remplissage des entités

Quand vous ajoutez quelque chose dans l'éditeur, Maquette cherche les entités qui conviennent pour que vous ayez rarement à taper un identifiant d'entité.

Critères : domaine, classe d'appareil, unité et mots dans l'identifiant ou le nom de l'entité (en anglais ou en français : co2, solaire, garage, fuite…). Les entités de l'appareil visé comptent le plus, puis celles d'un appareil déjà choisi, puis celles de la pièce visée ; les entités de diagnostic et de configuration viennent en dernier.

Quelle pièce : pour les ouvertures et les meubles, la pièce qu'ils touchent ; son area, sinon la pièce Home Assistant de même nom (accents et majuscules ignorés), sinon la seule dont le nom la contient ou y est contenu (quatre lettres au moins). Les widgets prêts à l'emploi utilisent l'area de la pièce (panneaux de pièce) ou l'appareil de l'élément (fiches).

Élément Champs Règle
Ouverture tracée depuis un préréglage contact (door / window / opening / garage_door), shutter (shutter / blind / shade / curtain / awning / window), entity (cover garage / gate / door) Une seule correspondance libre dans la pièce → reliée ; plusieurs → petite liste ; aucune dans la pièce → laissé vide et surligné. Les entités déjà sur le plan sont écartées
Widget prêt à l'emploi Chaque champ d'entité Une correspondance → prise ; plusieurs → petite liste (30 au plus) ; aucune → surligné. Les champs de liste prennent les meilleures sans demander
Modèle de meuble avec ask entity Cherchée dans la pièce où le meuble est posé
Pastille entity Sélecteur complet, filtré par domaine

La petite liste montre d'abord Dans « pièce », puis Ailleurs, avec Autre entité… (sélecteur complet) et Ignorer.

Une ouverture sélectionnée affiche aussi des suggestions : « Contact libre : … » › Relier, « 3 volets libres dans … » › Choisir, « Type d'après le contact : Porte » › Appliquer.

Remplir depuis l'appareil

Dans l'onglet Fiche de la fenêtre d'édition d'un meuble, d'une ouverture ou d'une pastille, Remplir depuis l'appareil construit une fiche avec les entités du même appareil Home Assistant (entités masquées et de configuration écartées), montre le vrai résultat, puis Ajouter ou Remplacer la fiche :

Élément Widgets proposés
Borne de recharge Courbe de puissance de charge avec énergie et coût, puis branchement, tension, température, alertes
Tableau électrique Jauge de puissance (max = puissance souscrite, sinon 6000), puissance apparente, tension, intensité, énergie et coût, tarif (prix et couleurs Tempo trouvés n'importe où dans Home Assistant)
Chaudière, ou appareil avec une entité climate Liste chauffage (climate, températures, puissance, énergie, alertes)
Meuble TV Lecteurs multimédias, puis consommation
Autre meuble Consommation (courbe de puissance, énergie, coût), sinon les entités de l'appareil
Fenêtre / porte Widget cover du volet ou du moteur, puis le contact avec ses capteurs de batterie et d'arrachement, et les compteurs du jour
Portail Widget cover avec confirm: true, puis les capteurs de l'appareil
Pastille cover → widget volet ; sensor → tuile 24 h et autres mesures ; binary_sensor → détecteur avec batterie et arrachement ; sinon comme un meuble

Importer les pièces Home Assistant

  • Ajouter › Pièces › Pièce Home Assistant : choisissez une pièce, tracez-la ; elle prend le nom et l'area de la pièce Home Assistant.
  • Toutes mes pièces HA (ou Démarrer avec mes pièces sur un plan vide) : une pièce de 4 × 3 m par pièce choisie, en grille à côté du plan (une seule étape d'annulation).

Pour chaque pièce, Intégrer les appareils de la pièce :

  • les premiers capteurs de température et d'humidité deviennent ceux de la pièce (si elle n'en a pas) ;
  • une pastille par appareil, d'après son entité principale, par priorité : light, climate, media_player, camera, vacuum, fan, lock, switch, puis détecteurs de mouvement / occupation / présence / fumée / fuite / gaz / monoxyde de carbone ; un switch avec un capteur de puissance devient une pastille mesurée ; une caméra avec un détecteur de mouvement clignote au mouvement ;
  • les appareils déjà sur le plan sont écartés ; les entités masquées et catégorisées sont ignorées ;
  • les contacts de portes et fenêtres et les cover sont listés sous À placer sur les murs : cliquez-en un, puis ses deux extrémités sur un mur (un cover de garage, de portail ou de porte devient un portail avec entity, un autre cover une fenêtre avec shutter, un contact de porte une porte, tout autre contact une fenêtre).

Maquette · a living floor plan for Home Assistant · MIT · Issues · 🇬🇧 Home · 🇫🇷 Accueil

Maquette

Start

Plan

Home Assistant

Using the card

Practical

🇫🇷 Français

Clone this wiki locally