Home Assistant
Incluida en Macro DeckEnciende y apaga luces, ejecuta escenas y scripts, y muestra en tu deck los estados en directo de tu Home Assistant.
El cuadro de diálogo Conectar Home Assistant con los campos Dirección y Token de acceso de larga duración
- Enciende, apaga o alterna entidades, con botones que muestran su estado
- Ajusta luces, cubiertas, termostatos y reproductores multimedia
- Ejecuta escenas, scripts y automatizaciones, o llama a cualquier servicio
- Variables en directo para el estado o el atributo de cualquier entidad
- Disparadores con los cambios de estado y con los eventos del bus de eventos
La integración Home Assistant conecta Macro Deck con tu Home Assistant a través de su API WebSocket. Macro Deck mantiene una conexión abierta, así que los estados llegan en el momento en que cambian en Home Assistant y las acciones se ejecutan al instante. Home Assistant puede ejecutarse en cualquier lugar al que Macro Deck pueda llegar: en el mismo ordenador, en una Raspberry Pi o un servidor de tu red, o en una dirección remota.
Qué puedes hacer
- Enciende o apaga una o varias entidades, o altérnalas. Un botón con Alternar se ilumina mientras la entidad está encendida.
- Establece el estado, el brillo, el color, la temperatura de color y la transición de una luz con Configurar luz.
- Abre, cierra, detén o coloca una cubierta, ajusta la temperatura, el modo, el modo del ventilador y el preajuste de un termostato, y controla la reproducción y el volumen de un reproductor multimedia.
- Activa una escena, ejecuta un script con variables, y dispara, habilita o deshabilita una automatización.
- Llama a cualquier servicio con Llamar servicio, con entidades, dispositivos o áreas como destino y datos en JSON.
- Lee el estado o un atributo de una entidad en una variable de Macro Deck con Obtener estado de la entidad.
Algunos ejemplos:
- Un botón con Alternar para la lámpara de tu escritorio que muestra si la lámpara está encendida.
- Un botón Película que activa tu escena de cine y pausa la música en un reproductor multimedia.
- Un control deslizante vinculado al brillo de una luz, para atenuarla desde el deck y ver los cambios hechos en Home Assistant.
- Un botón cuya etiqueta muestra la temperatura de un sensor, y un flujo con Estado de entidad cambiado que muestra una notificación cuando se abre la puerta de entrada.
Variables y actualizaciones en directo
Home Assistant ofrece muchos más valores de los que Macro Deck muestra de entrada. Encontrarás todas las entidades en el grupo plegado Variables sin vincular de las variables de la integración, en la página Variables y en todos los selectores de variables. Abre una entidad para ver su estado y sus atributos y elige Vincular en el que necesites: se convierte en una variable normal que se actualiza en directo. Así, un control deslizante puede controlar el brillo de una luz, la velocidad de un ventilador, la posición de una cubierta, el volumen de un reproductor multimedia o la temperatura de un termostato.
Cuando se corta la conexión, Macro Deck vuelve a conectarse por sí solo, esperando un poco más tras cada intento fallido, hasta un minuto. Los disparadores Conectado y Desconectado se activan cuando eso ocurre, y las acciones fallan con un mensaje mientras Home Assistant no está conectado. Puedes conectar un Home Assistant.
Qué necesitas
- Un Home Assistant en funcionamiento al que Macro Deck pueda llegar, por ejemplo
http://homeassistant.local:8123. - Una cuenta de usuario de Home Assistant con la que crear un token de acceso de larga duración.
- Para una dirección
https://: un certificado en el que confíe tu ordenador.
Configúrala
Paso 1: Crea un token de acceso de larga duración
En Home Assistant, abre tu perfil y ve a la pestaña Seguridad. Desplázate hasta Tokens de acceso de larga duración, crea un token, llámalo
Macro Decky cópialo. Home Assistant solo lo muestra una vez.Paso 2: Abre la integración Home Assistant
En Macro Deck, haz clic en Integraciones en la barra lateral y después en Home Assistant. En la pestaña Resumen, haz clic en Configurar en la sección Configuración. Activar el interruptor de arriba a la derecha abre el mismo cuadro de diálogo, y la integración se activa cuando termina la configuración.
Paso 3: Introduce la dirección y el token
En el cuadro de diálogo Conectar Home Assistant, introduce:
- Dirección: la dirección con la que abres Home Assistant, con el puerto, por ejemplo
http://homeassistant.local:8123. - Token de acceso de larga duración: el token que acabas de copiar.
Al hacer clic en Continuar, Macro Deck prueba la conexión y la guarda como Home Assistant con el nombre de tu casa entre paréntesis.
- Dirección: la dirección con la que abres Home Assistant, con el puerto, por ejemplo
Paso 4: Añade una acción a un botón
En la página Deck, haz clic en un botón. El deck tiene que estar desbloqueado: lo está cuando arriba a la derecha aparece el botón Bloquear. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, selecciona Home Assistant a la izquierda del cuadro de diálogo Añadir acción, elige Alternar y selecciona una o varias Entidades, por ejemplo una luz.
Paso 5: Pulsa el botón
Pulsa el botón en tu deck. La luz cambia en Home Assistant y el botón muestra si está encendida.
Paso 6: Vincula un valor para mostrarlo en un botón
Para mostrar un valor, abre la pestaña Variables de la página de Home Assistant y abre el grupo Variables sin vincular. Abre una entidad y haz clic en Vincular en su estado o en un atributo. Usa la nueva variable en una etiqueta, por ejemplo
{{ vars.ha_sensor_living_room_temperature }}.
Acciones12
Ponlas en un botón o ejecútalas desde un flujo.
- Llamar servicio
- Llama a cualquier servicio de Home Assistant, con entidades, dispositivos, áreas y datos en JSON opcionales.
- Encender
- Enciende una o varias entidades.
- Apagar
- Apaga una o varias entidades.
- Alternar
- Alterna una o varias entidades y muestra en el botón si están encendidas.
- Configurar luz
- Enciende o apaga una luz y ajusta su brillo, su color, su temperatura de color y su transición.
- Controlar cubierta
- Abre, cierra o detiene una cubierta, o ajusta su posición o su inclinación.
- Controlar reproductor multimedia
- Reproduce, pausa, detiene, salta, silencia o ajusta el volumen de un reproductor multimedia.
- Configurar termostato
- Ajusta la temperatura objetivo, el modo, el modo del ventilador y el preajuste de un termostato.
- Activar escena
- Activa una escena, con una transición opcional.
- Ejecutar script
- Ejecuta un script, si quieres con variables como objeto JSON.
- Controlar automatización
- Dispara, habilita, deshabilita o alterna una automatización, si quieres ignorando sus condiciones.
- Obtener estado de la entidad
- Lee el estado de una entidad o uno de sus atributos en una variable de Macro Deck.
Disparadores4
Un botón o un flujo puede reaccionar a estos eventos.
- Conectado
- Macro Deck se conectó a Home Assistant.
- Desconectado
- Se perdió la conexión con Home Assistant.
- Estado de entidad cambiado
- Una entidad cambió de estado, si quieres solo para un dominio, una entidad o un cambio desde o hacia un estado concreto.
- Evento de Home Assistant
- Cualquier cosa del bus de eventos de Home Assistant, como automatizaciones, scripts, pulsaciones de botones ZHA y deCONZ o eventos personalizados, si quieres solo un tipo de evento.
Variables5
Muestra estos valores en botones y widgets, o úsalos en condiciones.
homeassistant_is_connected- Si Macro Deck está conectado a Home Assistant.
homeassistant_version- La versión de tu Home Assistant.
homeassistant_location_name- El nombre de tu casa.
homeassistant_entity_count- Cuántas entidades tiene tu Home Assistant.
ha_<entity>,ha_<entity>_<attribute>- El estado o cualquier atributo de una entidad, en cuanto lo vinculas desde Variables sin vincular. El nombre se propone a partir del id de la entidad, por ejemplo
ha_light_office_lampoha_light_office_lamp_brightness_pct. Muchos también se pueden establecer, por ejemplo elbrightness_pctde una luz.
Preguntas frecuentes
¿Home Assistant tiene que ejecutarse en el mismo ordenador?
No. Macro Deck se conecta a través de la red, así que Home Assistant puede ejecutarse en una Raspberry Pi, en un servidor o en una dirección remota, siempre que Macro Deck pueda llegar a él.
¿Puedo conectar más de un Home Assistant?
No. La integración admite un Home Assistant. Si vuelves a ejecutar la configuración, se sustituye la conexión y tus botones siguen funcionando.
La configuración dice que no se pudo validar el certificado. ¿Qué puedo hacer?
Tu ordenador no confía en el certificado de tu dirección https://. Márcalo como de confianza en el almacén de certificados de tu sistema operativo, o conéctate por http:// en tu red local.
Home Assistant detrás de un proxy inverso no se conecta. ¿Por qué?
Algunos proxies bloquean las solicitudes que toman por tráfico automatizado. Abre Configuración > Avanzado > HTTP e introduce en HTTP User-Agent un valor que el proxy acepte.
¿Qué pasa cuando se corta la conexión?
Macro Deck vuelve a conectarse por sí solo y activa los disparadores Desconectado y Conectado. Si no puede llegar a Home Assistant durante un rato, la integración muestra Home Assistant no está disponible y lo sigue intentando en segundo plano.
¿Dónde se guarda mi token de acceso?
El token se guarda cifrado en tu ordenador y nunca sale de él, salvo para comunicarse con tu Home Assistant. Si Home Assistant lo rechaza, la integración muestra un problema: crea un token nuevo y vuelve a ejecutar la configuración.
Más en Hogar inteligente y web
AdGuard Home
Incluida en Macro DeckActiva, desactiva o pausa la protección de AdGuard Home y muestra sus estadísticas en tu deck.
Feeds RSS
Incluida en Macro DeckSigue feeds RSS y Atom, muestra sus artículos más recientes en widgets y reacciona cuando llegan artículos nuevos.
HTTP
Incluida en Macro DeckEnvía solicitudes HTTP desde un botón y guarda valores de la respuesta en variables.
Clima
Incluida en Macro DeckMuestra en tu deck el tiempo actual y el pronóstico de tus ubicaciones, sin clave de API.