Home Assistant est une application open source populaire pour organiser une maison intelligente. La première expérience de l’auteur avec le Home Assistant est basée sur une tentative d’y intégrer un cuiseur à riz intelligent. L'auteur tentera de décrire les principaux composants et fonctionnalités de cette application, qu'il a eu la chance de connaître pas à pas. L'article est en quelque sorte une revue, en quelque sorte un guide pour ceux qui veulent commencer leur connaissance de Home Assistant.
Pour ceux qui ont peu de temps libre, je vous conseille de sauter le dicton - le premier chapitre - et de passer directement au second. Vous devez seulement savoir que nous travaillerons avec un cuiseur à riz chinois intelligent de Xiaomi.
Cuiseur à riz intelligent
Un cuiseur à riz est évidemment un cuiseur à riz. Wiki nous montre des bateaux à vapeur en céramique du British Museum datant de 1250 av. En 1945, Mitsubishi est devenue la première entreprise japonaise de cuiseurs à riz électriques faits maison. Notre modèle - Rice Cooker de Xiaomi - peut non seulement cuisiner du riz. «C'est un excellent appareil pour faire non seulement du riz, mais d'autres types de plats. Il peut préparer des soupes, des pâtisseries et bien plus encore », indique la publicité. Mais le plus important est la présence d'un module Wi-Fi, d'un logiciel avec des capacités d'automatisation et de plus de 200 recettes installées par logiciel. "Le chemin vers une maison intelligente par l'estomac est juste", pensa l'auteur, et décida.
Xiaomi Rice Cooker, comme il sied à un appareil numérique, est très attrayant à l'extérieur, plaît avec sa forme ronde et son minimalisme général. Pour le configurer et l'utiliser, le constructeur propose l'application Mi Home. Après avoir enregistré un compte Mi, le programme recherche facilement un nouvel appareil et vous l'enregistrez sur votre réseau local. L'interface d'application n'est pas la pire, fournit des outils d'automatisation de base et peut recevoir des notifications des appareils. Cependant, il existe des inconvénients importants. Tout le monde ne peut pas être content d'envoyer des informations au développeur sur chaque clic de l'utilisateur. Et une expression désagréable se retrouve souvent aujourd'hui de couleur nationale. Au lieu de plus de 200 recettes, seulement quatre sont traduites et disponibles en langues étrangères. Le reste est exclusivement réservé au peuple chinois. Lorsque votre cuiseur à riz «intelligent» n'est pas en mesure de remplir toutes les fonctions culinaires promises, alors, vous voyez, cela devient triste. Après avoir erré pendant un certain temps sur Internet, un triste auteur est tombé sur le prochain
projet intéressant (avantages éternels pour l'auteur). Ce qui s'est avéré être dédié au développement d'un module pour un certain Home Assistant.
Assistant à domicile
Tout d'abord, quelques informations générales. Comme on nous le dit sur
la page d'accueil de HA , «il s'agit d'un logiciel open source pour la domotique intelligente qui se concentre sur la gestion locale et la confidentialité. Développé par le travail d'une communauté ouverte de passionnés, il est idéal pour travailler sur un Raspberry Pi ou un serveur local. » Le projet a plus de cinq ans, il utilise python et une licence Apache 2.0. La version finale au moment de la rédaction de ces lignes est 0.99.3.
HA utilise des modules distincts (intégrations ou composants) pour gérer les périphériques. En créer un est assez simple. Sur le site, vous trouverez un catalogue des
principaux modules (approuvés et soutenus par la communauté). Parmi leur nombre total (1485 pièces), il en existe de très divers, les noms amazon, google, xiaomi, et même une fois yandex figurent dans le catalogue.
Essayons d'
installer HA dans un environnement virtuel sur un bureau Linux. Nous aurons besoin de python3 et du gestionnaire de paquets pip.
python3 -m venv homeassistant
Après cela, l'
interface graphique HA deviendra disponible sur
http: // localhost: 8123 . Lors de votre première connexion, vous devrez créer un compte utilisateur. L'interface Web HA est assez volumineuse. Quelques éléments importants qui méritent d'être mentionnés au tout début sont l'onglet Configuration → Général, où vous pouvez facilement recharger les fichiers de configuration ou le serveur lui-même. Ainsi que la page Info dans la liste des outils Développeurs, où vous pouvez voir les journaux d'erreurs.
HA stocke toutes les données utilisateur nécessaires, dans le cas de Linux, dans le dossier de paramètres «~ / .homeassistant». Les fichiers de configuration sont écrits au format
YAML , et le principal est «configuration.yaml». Il combine les données des modules, l'automatisation, etc. La fonction d'importation vous permet de diviser les paramètres en fichiers séparés organisés logiquement. Les modules sont stockés dans des sous-dossiers «composants» (intégrés) et «custom_components».
Cette connaissance devrait nous suffire pour installer un nouveau module. Copiez le dossier «xiaomi_cooker» de notre référentiel dans nos «~ / .homeassistant / custom_components». Selon la description, ajoutez les paramètres du module au fichier «configuration.yaml»:
C'est fait. Après le redémarrage HA, une nouvelle entrée de module apparaîtra dans la section Général → Intégrations de l'interface Web.
Tout module est un certain ensemble d'objets (entités) et de services (services, essentiellement - fonctions). Les objets stockent diverses données reçues des appareils. Par exemple, sensor.xiaomi_cooker_temperature est la température du cuiseur à riz, sun.sun est la position du soleil. Les données d'un objet sont exprimées par une valeur de base - état (état) et un ensemble arbitraire d'attributs supplémentaires (attributs). Les services sont utilisés pour transférer des commandes et des valeurs vers des appareils. Par exemple, xiaomi_cooker.start - la commande pour démarrer le fonctionnement du cuiseur à riz, ou homeassistant.check_config - initialisation de la recherche d'erreurs dans les fichiers de paramètres HA. La liste des outils de développement de l'interface Web contient la section Services, où vous pouvez afficher la liste des services à votre disposition et jouer avec leurs appels. À proximité se trouve la section États, où, en conséquence, vous pouvez afficher et modifier les valeurs des objets. Il convient de noter que les modifications des valeurs des objets dans la section États sont unilatérales. C'est-à-dire si, par exemple, vous modifiez l'état de l'objet lights.state ici de off à on, cela n'affectera pas l'état réel de l'appareil, et la prochaine fois que les données de l'appareil seront mises à jour, la valeur de l'objet sera remplacée par réelle.
Automatisation
Le principal outil de gestion d'une maison intelligente est l'
automatisation . Vous pouvez les ajouter et les modifier à l'aide de l'interface graphique dans la section Général → Automatisation ou directement dans le fichier «automations.yaml». L'automatisation a pour fonction principale d'appeler des services lorsque certaines conditions sont remplies. Outils de base pour définir les conditions d'appel de la valeur des objets, incl. données de temps. Il existe des solutions légèrement plus spécifiques, comme les événements. À titre d'exemple d'automatisation simple, nous donnerons un code qui met à jour les données de l'auteur sur une période de 15 minutes:
Il convient de noter que jusqu'à présent, toutes les automatisations disponibles (par exemple, ci-dessus) ne peuvent pas être configurées sans éditer le code yaml via l'interface graphique, mais les développeurs disent qu'ils travaillent activement pour éliminer cet inconvénient.
Templating
Après l'automatisation, il est temps de parler de
modèles (modèles). Divers éléments de paramètres dans les fichiers yaml vous permettent d'utiliser des insertions dans
le langage de script jinja2 . Beaucoup de ces éléments sont unis par le nom commun «Templates», comme service_template ou trigger_template. En utilisant des modèles, nous avons accès aux valeurs des
objets dans HA et la possibilité d'utiliser ces données dans des expressions mathématiques et logiques complexes, ce qui élargit considérablement notre potentiel. Par exemple, prenons un code un peu plus compliqué de sensor.umpiro_charge écrit dans "configuration.yaml". Il s'agit de
template_sensor , c'est-à-dire «un capteur qui forme des données en fonction des valeurs d'autres objets». Notre capteur sera un peu l'analogue d'une batterie déchargée progressivement:
Nous avons laissé entity_id vide car nous avons déjà ajouté une automatisation qui provoquera indépendamment la mise à jour des données d'objet.
Scripts Python
À leur tour, les scripts python sont un outil simple pour créer de nouveaux services. Après avoir ajouté la ligne: «script python:» à «configuration.yaml», tous les fichiers avec l'extension «.py» que nous avons placés dans le dossier «~ / .homeassistant / python_scripts» deviendront disponibles en tant que services avec les noms «python_scripts. < nom_fichier> ». Leur code est exécuté dans un environnement prédéfini, où les données et les variables hass nous donnent accès aux arguments de l'appel de service, ainsi qu'aux objets et services HA. A titre d'exemple, nous donnons le code du fichier "charge_set.py" pour le service "python_scripts.charge_set". Sa fonction sera de régler la charge de notre batterie:
python_scripts / charge_set.py Créer l'intégration
Tout ce que nous avons fait à l'aide de modèles et de scripts Python, il serait peut-être plus facile de le faire en écrivant un module séparé. Comme déjà mentionné, les modules non officiels sont stockés dans le dossier «custom_components». À l'avenir, nous aurons besoin d'un objet qui stocke des informations sur la recette actuelle de notre cuiseur à riz et d'un service qui vous permet de modifier ces données. Sur la base d'un
exemple de la documentation, nous allons créer un nouveau module pour cela, «overmind». La première étape est le fichier custom_components / overmind / __ init__.py:
custom_components / overmind / __ init__.py Après cela, nous rapporterons le nouveau module au fichier de configuration «configuration.yaml», en y ajoutant une ligne avec le nom du module: «overmind:». Le problème est résolu.
Lovelace ui
Il s'agit du nom du HA
frontal utilisé. Cette interface graphique, par laquelle un utilisateur ordinaire est invité à contrôler une maison intelligente, est la première page de l'interface Web HA. L'interface LUI est formée de cartes de différents types, qui peuvent refléter les valeurs des objets, servir à appeler des fonctions et d'autres tâches. Les cartes peuvent être distribuées sur des pages (vue), par analogie avec les signets du navigateur. La configuration est organisée de manière pratique via la même interface graphique, mais est également accessible via le code yaml, pour lequel il existe également un éditeur de texte intégré. Je vous recommande de consulter la page
https://demo.home-assistant.io/ , où il existe plusieurs exemples différents de paramètres LUI, et où vous pouvez facilement les voir, cliquer et les modifier.
Exemple de configuration de l'interface graphiqueParlant des lacunes de l'interface, malheureusement, les développeurs eux-mêmes admettent que le projet essaie de s'asseoir simultanément sur les chaises du bureau et du smartphone. LUI, par défaut, aime déterminer indépendamment l'emplacement et la taille des cartes, ce qui peut parfois transformer une page qui semble normale sur le moniteur en un gâchis sur l'écran du smartphone, et vice versa. Il existe des outils simples pour rationaliser l'interface, mais d'après mon expérience, ils ne sont pas toujours efficaces.
Je pense que cela n'a pas beaucoup de sens de décrire la création d'une interface à l'aide d'outils graphiques, je vais donc donner quelques exemples sous la forme du code yaml que j'ai utilisé. Après avoir créé une page séparée (vue) pour notre cuiseur à riz, nous essaierons de la remplir avec les éléments les plus nécessaires afin qu'elle ne provoque pas de rejet lors de l'utilisation de l'écran du smartphone.
Ici, nous allons essayer ces outils de commande d'interface très simples, ce sont la pile horizontale et la pile verticale. Tout d'abord, créez une pile verticale à partir de cartes de types bouton-entité et capteur. Le premier servira à lancer notre cuiseur à riz, le second - pour afficher la température:
L'assistant d'accueil comprend une archive d'
icônes de conception de
matériaux qui, par le biais de noms appropriés (par exemple, mdi: sélection), peuvent être utilisées dans les éléments de paramètres. Le script (dans ce cas, pas python-, mais yaml-), que nous appelions le service, est un autre outil HA pratique.
Combinez maintenant la pile verticale ci-dessus avec la carte portrait de la nôtre dans la pile maintenant horizontale. Tout sera aussi simple:
Ici, vous devez marquer la ligne «image:». Tous les fichiers que nous mettons dans le dossier '~ / .homeassistant / www' deviennent disponibles sur le lien
http: // localhost / local / filename .
L'étape suivante consiste à travailler un peu sur le bouton d'appel de service que nous avons créé. Ce serait pratique pour nous si cela fonctionnait comme un interrupteur à bascule, c'est-à-dire marche / arrêt, et non la façon dont cela se fait maintenant. Ceci peut être réalisé grâce à l'utilisation d'une carte de type conditionnelle, dont l'affichage sur l'écran peut être ajusté en définissant certaines conditions. Voici le code de la carte, qui est le bouton pour éteindre le cuiseur à riz et n'est visible que si le cuiseur à riz est en train de préparer le plat:
En réécrivant le code du bouton d'alimentation précédemment créé de la même manière, et en le combinant avec cela, nous obtenons un bouton qui fonctionne à la fois en marche et en arrêt.
Nous complétons notre intérêt avec une autre carte - avec le temps jusqu'à la fin de la cuisson (similaire à la carte de température), et un de plus avec les détails de la recette (personnalisée: carte de recette) affichée. En conséquence, nous obtenons quelque chose comme ceci:
Cartes personnalisées
Home Assistant, en plus de la richesse de l'ensemble de types de cartes intégrés, offre bien entendu la possibilité de créer le vôtre. Ces cartes sont appelées cartes personnalisées et javascript est utilisé pour les créer.
Voici deux exemples de code simples. Il est facile de trouver des cartes prêtes à l'emploi créées par divers
passionnés sur le réseau, et si vous voulez vous expérimenter, il sera utile de découvrir qu'il existe des
modules js spéciaux créés pour simplifier le travail d'écriture de nouveaux. Mon expérience avec javascript continue de vouloir moins, donc, à titre d'exemple, je ne donnerai qu'une petite partie du code de la carte utilisé pour sélectionner et afficher la recette actuelle.
Pour utiliser la nouvelle carte, vous devrez ajouter le code suivant au début du fichier de paramètres LUI:
carte de recette resources:
et parmi la liste des cartes:
- type: 'custom:recipe-card'
Notifications
Une partie nécessaire d'une maison intelligente envoie des messages à l'utilisateur. Dans HA, ces messages sont appelés notifications et il existe deux types de base de notifications. Le premier est les notifications persistantes. Pour les envoyer, le service intégré "persistent_notification.create" est utilisé. Une liste de ces messages est disponible via l'icône en forme de cloche dans l'interface graphique, ils utilisent un balisage de démarque et sont essentiellement assez simples.
Un autre outil, plus intéressant, est le module de notification intégré qui, grâce à l'installation de modules supplémentaires, vous permet d'envoyer des messages à l'aide de
plates-formes tierces . À titre d'exemple, considérons un
module pour télégramme .
Pour utiliser le module, tout d'abord, nous devrons créer un bot dans le télégramme lui-même. Lors de la configuration, nous avons besoin du chat_id de notre utilisateur et de l'API du token bot. Comment obtenir ces données - décrites en détail sur le lien ci-dessus, nous supposons que nous sommes prêts. Passer directement à l'installation du module, tout d'abord, comme nous l'avons déjà fait, copiez son code source dans le dossier des composants, puis ajoutez ses paramètres dans le fichier «configuration.yaml»:
configuration.yaml telegram_bot:
ainsi que les paramètres du module de notification:
notify:
Le module télégramme nous permet d'envoyer des messages, des photos ou des vidéos. A titre d'exemple, nous allons créer une automatisation pour envoyer un message avec une photo, nous informant de la fin de la cuisson.
Postface
Home Assistant peut intéresser ceux qui veulent essayer d'organiser la gestion locale d'une maison intelligente. Il s'agit d'un projet large, intéressant, ouvertement et activement développé, grâce aux efforts de la communauté. La variété des outils Home Assistant ne peut que se réjouir (je n'ai pas eu le temps d'en mentionner quelques-uns importants). Comme inconvénient, on peut mentionner la complexité relative et le caractère incomplet de la documentation.
PS
Récemment, le 10 octobre, il y a eu, je ne sais pas si cela peut s'appeler une release, la transition du projet de la version 0.99 à la version 0.100.
Citation des notes de publication:
Bienvenue dans les notes de version d'une autre merveilleuse version! Non, nous n'allons pas pour 1.0, nous faisons 0.100! Nous pensons que nous ne sommes pas encore prêts avec nos objectifs pour 1.0, mais nous progressons chaque jour. Pour un aperçu de ce à quoi nous pensons, consultez notre blog Mode simple dans Home Assistant 1.0.