Home Assistant
Incluída no Macro DeckAcione luzes, execute cenas e scripts e mostre no seu deck os estados ao vivo do seu Home Assistant.
A caixa de diálogo Conectar ao Home Assistant com os campos Endereço e Token de acesso de longa duração
- Ligue, desligue ou alterne entidades, com botões que mostram o estado delas
- Ajuste luzes, persianas, termostatos e reprodutores de mídia
- Execute cenas, scripts e automações, ou chame qualquer serviço
- Variáveis ao vivo para qualquer estado ou atributo de entidade
- Gatilhos em mudanças de estado e em eventos do barramento de eventos
A integração Home Assistant conecta o Macro Deck ao seu Home Assistant pela API WebSocket dele. O Macro Deck mantém uma conexão aberta, então os estados chegam no momento em que mudam no Home Assistant, e as ações são executadas na hora. O Home Assistant pode rodar em qualquer lugar que o Macro Deck consiga alcançar: no mesmo computador, em um Raspberry Pi ou servidor da sua rede, ou em um endereço remoto.
O que dá para fazer
- Ligue ou desligue uma ou mais entidades, ou alterne o estado delas. Um botão com Alternar acende enquanto a entidade está ligada.
- Defina o estado, o brilho, a cor, a temperatura de cor e a transição de uma luz com Definir luz.
- Abra, feche, pare ou posicione uma persiana, defina a temperatura, o modo, o modo do ventilador e a predefinição de um termostato e controle a reprodução e o volume de um reprodutor de mídia.
- Ative uma cena, execute um script com variáveis e dispare, ative ou desative uma automação.
- Chame qualquer serviço com Chamar serviço, tendo entidades, dispositivos ou áreas como alvo e dados em JSON.
- Leia o estado ou um atributo de uma entidade para uma variável do Macro Deck com Obter estado da entidade.
Alguns exemplos de uso:
- Um botão com Alternar para a luminária da mesa que mostra se ela está acesa.
- Um botão Filme que ativa a sua cena de filme e pausa a música em um reprodutor de mídia.
- Um controle deslizante vinculado ao brilho de uma luz, para diminuir a luz pelo deck e ver as mudanças feitas no Home Assistant.
- Um botão cujo rótulo mostra a temperatura de um sensor, e um fluxo em Estado da entidade alterado que mostra uma notificação quando a porta da frente abre.
Variáveis e atualizações ao vivo
O Home Assistant oferece muito mais valores do que o Macro Deck lista de início. Todas as entidades estão no grupo recolhido Variáveis não vinculadas das variáveis da integração, na página Variáveis e em todos os seletores de variáveis. Abra uma entidade para ver o estado e os atributos dela e escolha Vincular no valor de que precisar: ele vira uma variável normal, atualizada ao vivo. Assim, um controle deslizante pode controlar o brilho de uma luz, a velocidade de um ventilador, a posição de uma persiana, o volume de um reprodutor de mídia ou a temperatura de um termostato.
Quando a conexão cai, o Macro Deck se reconecta sozinho, esperando um pouco mais após cada tentativa malsucedida, até um minuto. Os gatilhos Conectado e Desconectado disparam quando isso acontece, e as ações falham com uma mensagem enquanto o Home Assistant não estiver conectado. É possível conectar um Home Assistant.
O que é necessário
- Um Home Assistant em execução que o Macro Deck consiga alcançar, por exemplo
http://homeassistant.local:8123. - Uma conta de usuário do Home Assistant para criar um token de acesso de longa duração.
- Para um endereço
https://: um certificado em que o computador confie.
Configuração
Passo 1: Crie um token de acesso de longa duração
No Home Assistant, abra o seu perfil e vá para a aba Segurança. Role até Tokens de acesso de longa duração, crie um token, dê a ele o nome
Macro Decke copie-o. O Home Assistant só o mostra uma vez.Passo 2: Abra a integração Home Assistant
No Macro Deck, clique em Integrações na barra lateral e depois em Home Assistant. Na aba Visão geral, clique em Configurar na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída.
Passo 3: Informe o endereço e o token
Na caixa de diálogo Conectar ao Home Assistant, informe:
- Endereço: o endereço usado para abrir o Home Assistant, com a porta, por exemplo
http://homeassistant.local:8123. - Token de acesso de longa duração: o token que você acabou de copiar.
Quando você clica em Continuar, o Macro Deck testa a conexão e a salva como Home Assistant com o nome da sua casa entre parênteses.
- Endereço: o endereço usado para abrir o Home Assistant, com a porta, por exemplo
Passo 4: Adicione uma ação a um botão
Na página Deck, clique em um botão. O deck precisa estar desbloqueado: se o botão Bloquear aparece no canto superior direito, ele está. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Home Assistant à esquerda da caixa de diálogo Adicionar ação, escolha Alternar e selecione uma ou mais Entidades, por exemplo uma luz.
Passo 5: Pressione o botão
Pressione o botão no seu deck. A luz muda de estado no Home Assistant, e o botão mostra se ela está acesa.
Passo 6: Vincule um valor para mostrar em um botão
Para mostrar um valor, abra a aba Variáveis da página do Home Assistant e abra o grupo Variáveis não vinculadas. Abra uma entidade e clique em Vincular no estado dela ou em um atributo. Use a nova variável em um rótulo, por exemplo
{{ vars.ha_sensor_living_room_temperature }}.
Ações12
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Chamar serviço
- Chama qualquer serviço do Home Assistant com entidades, dispositivos, áreas e dados em JSON opcionais.
- Ligar
- Liga uma ou mais entidades.
- Desligar
- Desliga uma ou mais entidades.
- Alternar
- Alterna uma ou mais entidades e mostra no botão se elas estão ligadas.
- Definir luz
- Liga ou desliga uma luz e define o brilho, a cor, a temperatura de cor e a transição dela.
- Controlar persiana
- Abre, fecha ou para uma persiana, ou define a posição ou a inclinação dela.
- Controlar reprodutor de mídia
- Reproduz, pausa, para, pula, silencia ou define o volume de um reprodutor de mídia.
- Definir termostato
- Define a temperatura desejada, o modo, o modo do ventilador e a predefinição de um termostato.
- Ativar cena
- Ativa uma cena, com uma transição opcional.
- Executar script
- Executa um script, opcionalmente com variáveis como objeto JSON.
- Controlar automação
- Dispara, ativa, desativa ou alterna uma automação, com a opção de ignorar as condições dela.
- Obter estado da entidade
- Lê o estado de uma entidade ou um dos atributos dela para uma variável do Macro Deck.
Gatilhos4
Um botão ou fluxo pode reagir a estes eventos.
- Conectado
- O Macro Deck se conectou ao Home Assistant.
- Desconectado
- A conexão com o Home Assistant foi perdida.
- Estado da entidade alterado
- Uma entidade mudou de estado, opcionalmente só para um domínio, uma entidade ou uma mudança de ou para um determinado estado.
- Evento do Home Assistant
- Qualquer coisa no barramento de eventos do Home Assistant, como automações, scripts, pressionamentos de botões ZHA e deCONZ ou eventos personalizados, opcionalmente só um tipo de evento.
Variáveis5
Mostre estes valores em botões e widgets ou use-os em condições.
homeassistant_is_connected- Se o Macro Deck está conectado ao Home Assistant.
homeassistant_version- A versão do seu Home Assistant.
homeassistant_location_name- O nome da sua casa.
homeassistant_entity_count- Quantas entidades o seu Home Assistant tem.
ha_<entity>,ha_<entity>_<attribute>- O estado ou qualquer atributo de uma entidade, depois que você o vincula em Variáveis não vinculadas. O nome é sugerido a partir do ID da entidade, por exemplo
ha_light_office_lampouha_light_office_lamp_brightness_pct. Muitos também podem ser definidos, por exemplo obrightness_pctde uma luz.
Perguntas frequentes
O Home Assistant precisa rodar no mesmo computador?
Não. O Macro Deck se conecta pela rede, então o Home Assistant pode rodar em um Raspberry Pi, em um servidor ou em um endereço remoto, desde que o Macro Deck consiga alcançá-lo.
Posso conectar mais de um Home Assistant?
Não. A integração aceita um Home Assistant. Executar a configuração de novo substitui a conexão, e os seus botões continuam funcionando.
A configuração diz que o certificado não pôde ser validado. O que fazer?
O computador não confia no certificado do seu endereço https://. Marque-o como confiável no repositório de certificados do sistema operacional, ou conecte via http:// na rede local.
O Home Assistant atrás de um proxy reverso não conecta. Por quê?
Alguns proxies bloqueiam requisições que consideram tráfego automatizado. Abra Configurações > Avançado > HTTP e informe em HTTP User-Agent um valor que o proxy aceite.
O que acontece quando a conexão cai?
O Macro Deck se reconecta sozinho e dispara os gatilhos Desconectado e Conectado. Quando não consegue alcançar o Home Assistant por um tempo, a integração mostra O Home Assistant está inacessível e continua tentando em segundo plano.
Onde meu token de acesso fica armazenado?
O token fica armazenado criptografado no seu computador e só sai dele para a comunicação com o seu Home Assistant. Quando o Home Assistant o recusa, a integração mostra um problema: crie um novo token e execute a configuração de novo.
Mais em Casa inteligente e web
AdGuard Home
Incluída no Macro DeckAtive, desative ou pause a proteção do AdGuard Home e mostre as estatísticas dele no seu deck.
Feeds RSS
Incluída no Macro DeckAcompanhe feeds RSS e Atom, mostre os artigos mais recentes em widgets e reaja quando chegam artigos novos.
HTTP
Incluída no Macro DeckEnvie requisições HTTP a partir de um botão e salve valores da resposta em variáveis.
Clima
Incluída no Macro DeckMostre no deck o clima atual e a previsão para os seus locais, sem chave de API.