Home Assistant
Incluse avec Macro DeckAllumez les lumières, lancez des scènes et des scripts, et affichez sur votre deck les états en direct de votre Home Assistant.
La boîte de dialogue Connecter Home Assistant avec les champs Adresse et Jeton d'accès longue durée
- Allumez, éteignez ou basculez des entités, avec des boutons qui affichent leur état
- Réglez lumières, volets, thermostats et lecteurs multimédias
- Lancez des scènes, des scripts et des automatisations, ou appelez n'importe quel service
- Des variables en direct pour l'état ou l'attribut de n'importe quelle entité
- Des déclencheurs sur les changements d'état et les événements du bus d'événements
L'intégration Home Assistant relie Macro Deck à votre Home Assistant via son API WebSocket. Macro Deck garde une connexion ouverte : les états arrivent dès qu'ils changent dans Home Assistant, et les actions s'exécutent immédiatement. Home Assistant peut tourner partout où Macro Deck peut le joindre : sur le même ordinateur, sur un Raspberry Pi ou un serveur de votre réseau, ou à une adresse distante.
Ce que vous pouvez faire
- Allumer ou éteindre une ou plusieurs entités, ou les basculer. Un bouton avec Basculer s'allume tant que l'entité est allumée.
- Régler l'état, la luminosité, la couleur, la température de couleur et la transition d'une lumière avec Régler la lumière.
- Ouvrir, fermer, arrêter ou positionner un volet, régler la température, le mode, le mode de ventilation et le préréglage d'un thermostat, et piloter la lecture et le volume d'un lecteur multimédia.
- Activer une scène, exécuter un script avec des variables, et déclencher, activer ou désactiver une automatisation.
- Appeler n'importe quel service avec Appeler un service, en ciblant des entités, des appareils ou des pièces, avec des données en JSON.
- Lire l'état ou un attribut d'une entité dans une variable Macro Deck avec Obtenir l'état de l'entité.
Quelques exemples de configuration :
- Un bouton avec Basculer pour votre lampe de bureau, qui indique si la lampe est allumée.
- Un bouton Film qui active votre scène cinéma et met en pause la musique sur un lecteur multimédia.
- Un curseur lié à la luminosité d'une lumière, pour la tamiser depuis le deck et voir les changements faits dans Home Assistant.
- Un bouton dont le libellé affiche la température d'un capteur, et un flux sur État de l'entité modifié qui affiche une notification quand la porte d'entrée s'ouvre.
Variables et mises à jour en direct
Home Assistant propose bien plus de valeurs que Macro Deck n'en liste d'emblée. Vous trouvez chaque entité dans le groupe replié Variables non liées des variables de l'intégration, sur la page Variables et dans chaque sélecteur de variables. Ouvrez une entité pour voir son état et ses attributs, et choisissez Lier sur celui dont vous avez besoin : il devient une variable normale qui se met à jour en direct. Un curseur peut ainsi piloter la luminosité d'une lumière, la vitesse d'un ventilateur, la position d'un volet, le volume d'un lecteur multimédia ou la température d'un thermostat.
Quand la connexion est perdue, Macro Deck se reconnecte tout seul, en attendant un peu plus après chaque échec, jusqu'à une minute. Les déclencheurs Connecté et Déconnecté se déclenchent à ce moment-là, et les actions échouent avec un message tant que Home Assistant n'est pas connecté. Vous pouvez connecter un seul Home Assistant.
Ce qu'il vous faut
- Un Home Assistant en marche que Macro Deck peut joindre, par exemple
http://homeassistant.local:8123. - Un compte utilisateur Home Assistant pour créer un jeton d'accès longue durée.
- Pour une adresse
https://: un certificat approuvé par votre ordinateur.
Configuration
Étape 1: Créez un jeton d'accès longue durée
Dans Home Assistant, ouvrez votre profil et allez dans l'onglet Sécurité. Faites défiler jusqu'à Jetons d'accès de longue durée, créez un jeton, nommez-le
Macro Decket copiez-le. Home Assistant ne l'affiche qu'une seule fois.Étape 2: Ouvrez l'intégration Home Assistant
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Home Assistant. Dans l'onglet Aperçu, cliquez sur Configurer dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée.
Étape 3: Saisissez l'adresse et le jeton
Dans la boîte de dialogue Connecter Home Assistant, saisissez :
- Adresse : l'adresse avec laquelle vous ouvrez Home Assistant, port compris, par exemple
http://homeassistant.local:8123. - Jeton d'accès longue durée : le jeton que vous venez de copier.
Quand vous cliquez sur Continuer, Macro Deck teste la connexion et l'enregistre sous le nom Home Assistant, avec le nom de votre maison entre parenthèses.
- Adresse : l'adresse avec laquelle vous ouvrez Home Assistant, port compris, par exemple
Étape 4: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur un bouton. Le deck doit être déverrouillé : c'est le cas lorsque le bouton Verrouiller s'affiche en haut à droite. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Home Assistant à gauche de la boîte de dialogue Ajouter une action, choisissez Basculer et sélectionnez une ou plusieurs Entités, par exemple une lumière.
Étape 5: Appuyez sur le bouton
Appuyez sur le bouton de votre deck. La lumière change d'état dans Home Assistant, et le bouton indique si elle est allumée.
Étape 6: Liez une valeur à afficher sur un bouton
Pour afficher une valeur, ouvrez l'onglet Variables de la page Home Assistant, puis le groupe Variables non liées. Ouvrez une entité et cliquez sur Lier sur son état ou un attribut. Utilisez la nouvelle variable dans un libellé, par exemple
{{ vars.ha_sensor_living_room_temperature }}.
Actions12
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Appeler un service
- Appelle n'importe quel service Home Assistant avec, si vous le souhaitez, des entités, des appareils, des pièces et des données en JSON.
- Allumer
- Allume une ou plusieurs entités.
- Éteindre
- Éteint une ou plusieurs entités.
- Basculer
- Bascule une ou plusieurs entités, et indique sur le bouton si elles sont allumées.
- Régler la lumière
- Allume ou éteint une lumière et règle sa luminosité, sa couleur, sa température de couleur et sa transition.
- Contrôler le volet
- Ouvre, ferme ou arrête un volet, ou règle sa position ou son inclinaison.
- Contrôler le lecteur multimédia
- Lance, met en pause, arrête, passe, coupe le son ou règle le volume d'un lecteur multimédia.
- Régler le thermostat
- Règle la température cible, le mode, le mode de ventilation et le préréglage d'un thermostat.
- Activer la scène
- Active une scène, avec une transition facultative.
- Exécuter le script
- Exécute un script, éventuellement avec des variables sous forme d'objet JSON.
- Contrôler l'automatisation
- Déclenche, active, désactive ou bascule une automatisation, en ignorant éventuellement ses conditions.
- Obtenir l'état de l'entité
- Lit l'état d'une entité ou l'un de ses attributs dans une variable Macro Deck.
Déclencheurs4
Un bouton ou un flux peut réagir à ces événements.
- Connecté
- Macro Deck s'est connecté à Home Assistant.
- Déconnecté
- La connexion à Home Assistant a été perdue.
- État de l'entité modifié
- Une entité a changé d'état, éventuellement pour un domaine, une entité, ou un passage depuis ou vers un état précis uniquement.
- Événement Home Assistant
- Tout ce qui passe sur le bus d'événements de Home Assistant, comme les automatisations, les scripts, les appuis sur des boutons ZHA et deCONZ ou les événements personnalisés, éventuellement pour un seul type d'événement.
Variables5
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
homeassistant_is_connected- Indique si Macro Deck est connecté à Home Assistant.
homeassistant_version- La version de votre Home Assistant.
homeassistant_location_name- Le nom de votre maison.
homeassistant_entity_count- Le nombre d'entités de votre Home Assistant.
ha_<entity>,ha_<entity>_<attribute>- L'état ou n'importe quel attribut d'une entité, une fois que vous l'avez lié depuis Variables non liées. Le nom proposé est dérivé de l'ID de l'entité, par exemple
ha_light_office_lampouha_light_office_lamp_brightness_pct. Beaucoup peuvent aussi être modifiés, par exemple lebrightness_pctd'une lumière.
Questions fréquentes
Home Assistant doit-il tourner sur le même ordinateur ?
Non. Macro Deck se connecte par le réseau : Home Assistant peut donc tourner sur un Raspberry Pi, un serveur ou à une adresse distante, tant que Macro Deck peut le joindre.
Puis-je connecter plusieurs Home Assistant ?
Non. L'intégration prend en charge un seul Home Assistant. Relancer la configuration remplace la connexion, et vos boutons continuent de fonctionner.
La configuration indique que le certificat n'a pas pu être validé. Que faire ?
Votre ordinateur n'approuve pas le certificat de votre adresse https://. Approuvez-le dans le magasin de certificats de votre système d'exploitation, ou connectez-vous en http:// sur votre réseau local.
Home Assistant derrière un reverse proxy ne se connecte pas. Pourquoi ?
Certains proxys bloquent les requêtes qu'ils prennent pour du trafic automatisé. Ouvrez Paramètres > Avancé > HTTP et saisissez sous HTTP User-Agent une valeur que le proxy accepte.
Que se passe-t-il quand la connexion est perdue ?
Macro Deck se reconnecte tout seul, et les déclencheurs Déconnecté et Connecté s'exécutent. Quand il ne peut pas joindre Home Assistant pendant un moment, l'intégration affiche Home Assistant est inaccessible et continue d'essayer en arrière-plan.
Où mon jeton d'accès est-il stocké ?
Le jeton est stocké chiffré sur votre ordinateur et n'en sort que pour communiquer avec votre Home Assistant. Quand Home Assistant le rejette, l'intégration affiche un problème : créez un nouveau jeton et relancez la configuration.
Plus dans Maison connectée et web
AdGuard Home
Incluse avec Macro DeckActivez, désactivez ou mettez en pause la protection AdGuard Home, et affichez ses statistiques sur votre deck.
Flux RSS
Incluse avec Macro DeckSuivez des flux RSS et Atom, affichez leurs derniers articles dans des widgets et réagissez à l'arrivée de nouveaux articles.
HTTP
Incluse avec Macro DeckEnvoyez des requêtes HTTP depuis un bouton et enregistrez des valeurs de la réponse dans des variables.
Météo
Incluse avec Macro DeckAffichez sur votre deck la météo actuelle et les prévisions pour vos lieux, sans clé d'API.