Les "entités" de Home Assistant: ce qu'ils sont et comment ils sont utilisés

5 minutes de lecture

Un principe important: personne est prêt à utiliser Home Assistant qui proprio HUB le personnel doit faire proavant les concepts exprimés sur cette page. Cela ne peut pas être utilisé HUB sans comprendre clairement le concept d'entité: c'est en fait un concept pivot.

Qu'est-ce qu'une entité

Le entité ils sont des dieux objets abstraits équipé d'un proavant nature, D'un proprio état, un ou plusieurs attributs et services connecté à eux. Imaginez, pour utiliser une métaphore, comme des briques LEGO.

Essayons de nous expliquer en utilisant des exemples.

Supposons que nous avons (sans entrer dans les mérites de comment) ajouté un passage à la configuration de Home Assistant.

Cet interrupteur sera lui-même entité.
Disons qu'il s'appelle "Radiateur soufflant de salle de bains". Sur le front de Home Assistant l'interrupteur appapparaîtra comme suit:

Switch Home Assistant

Revenant aux fonctionnalités décrites ci-dessus:

  • la nature de cette entité sera, pour laappoint, de interrupteur ou, comme dans la langue proavant Home Assistant"Switch« ;
  • lo état de ce type d'entité a deux conditions, "on"Et"off", Pour leappgraisseux accéder e off;
  • la attributs ils varient en fonction de la technologie à laquelle ce commutateur a été inséré dans la configuration, lecomment”Omis au début de l'exemple. Un attribut généralement présent dans presque toutes les entités est le "friendly_name", Ou"icon", Ou beaucoup d'autres;
  • i services varient également en fonction de la technologie utilisée: services typiques connectés à une entité de type "Switch" Je suis "turn_on","turn_off","toggle", Respectivement accendi, éteindreet état inversé.

Un autre exemple
Considérons le cas d’avoir intégré un capteur thermique:

  • son nature, est-ce que "Sensor« ;
  • sa état contient la lecture thermique (généralement un nombre décimal);
  • la attributs ils varient, comme toujours, en fonction de la technologie et de la nature du composant: typiquement, dans un capteur de ce type, on s'attend à trouver au moins “unit_of_measurement"(L'unité de mesure, C ou F) et l'omniprésent"friendly_name";
  • i services varient en fonction de la technologie utilisée et de la nature du composant. Dans le cas des capteurs (“Sensors "), il n'y a pas de services.

En substance, chaque accessoire / composant / appareil domotique intégré à Home Assistant est rappresentato par une ou plusieurs entités. Un ou plusieurs, bien sûr: même si un seul commutateur peut être intégré (basé sur la technologie) par une seule entité, des périphériques plus complexes peuvent être exposés à Home Assistant comme un ensemble d'entités de nature différente.

Un thermostat domotique pourrait être rapprenvoyé par une entité de type "Climate" (pour gérer les fonctions marche / arrêt du système de chauffage) et une entité de type "Sensor" qui contient, dans son état, la température ambiante détectée par le thermostat lui-même. BRIDGE/Gateway comme celle de la ligne Xiaomi "Smart Home" (auquel de nombreux capteurs et actionneurs sont connectés directement) est considéré comme une entité de type "Light" plus toute une série d'entités qui rappce sont les composants qui y sont connectés.
Et ainsi de suite.


Dit de cette façon l'équivalence semblerait évident composant domotique = entitémais ce n'est pas le cas.

En fait, ils sont également considérés comme des entités (de nature spécifique) gruppile automationsle scénariole scènele zone (et autres): tout composant Home Assistant prend en compte des entités définies dans le proenvironnement d'exploitation.

Ces entités ont aussi évidemment un statut, des attributs, des services associés.

par exemple automation Il a:

  • la nature de "Automation";
  • lo état "On" ou "Off" (ou s'il est opérationnel ou non);
  • attributs comme "last_triggered"(Date et heure de la dernière exécution) ou"hidden”(Pour le cacher du frontend etc;
  • services automatisation interne appelée "objet d'état".

Plus de détails sur les automatisations ils sont disponibles ici.


I gruppi ("Groupe") sont des entités intéressantes: groupe, Pour le 'appoints, entités de nature différente pour être vus de cette manière à l’avant-plan; où la nature des entités contenues dans un groupe est homogène (par exemple, toutes "Light"), Le statut de l'entité du groupe assumera le statut"offre"Quand toutes les lumières sont en état"offre"Et"on"Quand même on est"on».

Supposons un groupe qui ne groupe que des entités de type "Device Tracker"(Pour suivre géographiquement la position des locataires): le statut de cette entité sera"not_home"Quand toutes les entités groupées ont été différentes de"Accueil", Et aura"Accueil"Quand au moins un a proétait la même chose que "la maison".

Nb Nous avons également dédié une carte ad hoc aux groupes:

Les "groupes" de Home Assistant: ce qu'ils sont et comment ils sont utilisés

Intégrations et entités

Une fois que ça arrive la logique des entités il est facile de comprendre comment, une fois que vous avez "traduit" un accessoire / composant / appareil domotique en un ou plusieurs de ces objets, vous y êtes bien plus de la moitié du travail. Une fois qu'une ou plusieurs entités de travail sont obtenues, il sera possible insoucieux des aspects "physiques" de la propremière domotique à s'intéresser, concentrez-vous sur les "logiques".

Grande variation de ce concept est, par exemple, à domoter quelque chose qui n'est pas domotique. Supposons que vous fabriquiez un climatiseur traditionnel avec un émetteur infrarouge: une fois bien configuré Home Assistant nous obtiendrons une entité de type HVAC (cité ci-dessus): à ce stade, nous ne nous intéresserons plus à l'aspect physique de la question, mais nous nous limiterons à commander et interroger l'entité à travers sa état, son attributs et son services.

Quand, sur inDomus, décrivant un composant domotique nous nous concentrons sur le thème "intégration domotique", nous essayons de comprendre avec quelle facilité ce composant peut être traduit en une ou plusieurs entités à Home Assistant (ou autres HUB).

Nomenclature

Les entités sont définies par un nom composé d'un préfixe - donné par le type de composant auquel appartient la plate-forme d'intégration (par exemple. "Switch","Light","Climate"Etc.) - et de suffixe - donné par le nom de l'entité, défini dans la configuration.

Supposons que vous avez enregistré une lumière LED sur la plateforme Flux LED / Magic Light:

light:
  - platform: flux_led
    devices:
      192.168.1.10:
        name: LED 1
        mode: "rgbw"

Le nom de l'entité résultante sera: light.led_1 (notez comment les espaces eventuai sont remplacés par un "_")

Liste d'entités

Home Assistant mettre à disposition, le propremière interface, une page ad hoc où toutes les entités présentes sont listées détecté au démarrage. Cette page est disponible en cliquant sur ce symbole:

Home Assistant États - Liste des entités

La page s'appelle "Etats" car il y a, outre les différentes entités, tous les états et attributs relatifs (et valeurs relatives).

Utiliser

En plus de l'utilisation intuitive au front, les entités peuvent être utilisées (très précisément) même dans des automatismes, des scripts, des scènes, etc.

Ce qui est intéressant et intéressant, c’est qu’une entité, une fois définie dans la configuration, peut être utilisée de concert avec d’autres entités, en faisant abstraction complète de la source physique de ces entités. En pratique, des entités connectées à différents dispositifs physiques (lignes, technologies et prodifférents producteurs) peuvent collaborer au même niveau.

Un exemple frappant est donné par la plate-forme "Thermostat générique" (fille du composant "Climate") Ce qui permet de définir en configuration une entité de type thermostat (virtuel) qui prend les décisions typiques d’un thermostat (activer le chauffage en fonction d'un seuil thermique) à partir de la lecture thermique présente dans l'état d'une autre entité (de type "Sensor") Et venant activer" / "off" le statut d'une entité de type "Switch”, Qui exploite le système de chauffage en aval (voir projet ad hoc).

EN AUTOMATISATION

Dans le domaine de l'automatisation, les entités ils sont le pain quotidien: peut être utilisé comme trigger (ou utilisez un état et / ou un ou plusieurs attributs pour déclencher l'automatisation) et / ou comment condition (ou vérifier un statut / attribut pour valider l'automatisation déclenchée) et / ou comment action (ou modifiez le statut d'une ou plusieurs entités en fonction de l'exécution de l'automatisation elle-même.

Un exemple:

automation:
- alias: "Risveglio"
 
  trigger:
    
  - platform: time
      
    at: '07:00:00'
 
  condition:
  
  - condition: state
      
    entity_id: group.famiglia
      
    state: 'home'
  
  action:
    
  - service: light.turn_on
      
    entity_id: light.sala

À 7 le matin, il est vérifié que l'entité "group.famiglia"A été"Accueil", A ce stade (si la condition est vérifiée), le service est utilisé"turn_on"Pour l'entité type"Light"Appel"light.sala».

Bien évidemment, l'entité de type "Automation" ainsi créée sera appelée "automation.risveglio».

Comprendre la logique composant-plate-forme-entité de Home Assistant


Home Assistant Logo officielATTENZIONE: rappelez-vous qu'il y a sur notre communauté FORUM une section ad hoc dédiée à Home Assistantpour tout doute, question, information sur le mérite spécifique de ces composants.


Veuillez commenter ci-dessous