Início › Guia do Usuário › Automação Residencial
Home Assistant · Hubitat · Webhooks

Home Assistant e Hubitat: suas cenas, rodando sem o seu celular

Vincule o AVR Maestro ao Home Assistant ou ao Hubitat e cada cena que você criou vira um script nativo no seu hub. A partir daí, o hub fala diretamente com o receptor, na sua própria rede - então “Alexa, noite de cinema” funciona com o celular desligado, em repouso ou em outro país.

Por que funciona sem o app

A maioria das integrações faz do seu celular o intermediário: o celular ouve o comando, o celular o envia, e a automação só funciona enquanto o celular está ativo e na rede.

O AVR Maestro não faz isso. Ele compila suas cenas em scripts que ficam no seu hub, e o hub envia os comandos para o IP local do seu receptor. O trabalho do app termina quando a sincronização acaba.

Home Assistant, do começo ao fim

Depois de sincronizar

Monte um dashboard que vale a pena olhar

O Home Assistant agora tem um controle para tudo o que o seu receptor pode fazer, e nenhuma opinião sobre como organizá-los. O exemplo de dashboard é uma organização possível, com o YAML completo: blocos de fonte e de surround que acendem quando estão ativos, volume em dB reais, suas Cenas exibindo seus próprios nomes e um mapa honesto do que o Home Assistant pode e não pode enxergar.

Um dashboard do Home Assistant montado com os controles sincronizados do AVR Maestro
Não só cenas

Predefinições de Alto-falantes, Dirac e Audyssey também

Ative Sincronizar Controles Avançados e o app publica um script para muito mais do que suas cenas: cada Predefinição de Alto-falantes, cada slot de filtro do Dirac Live, cada curva Audyssey. Uma sincronização completa em um Cinema 30 gera mais de setenta scripts, então um botão do dashboard ou um comando de voz pode carregar um filtro Dirac ou trocar a curva da sala da mesma forma que recupera uma cena.

A tela do Home Assistant no AVR Maestro com Sincronizar Controles Avançados ativado
Ele lê, não só escreve

O Home Assistant consegue ver o que está ativo

Um script pode ser executado, mas nunca lido, então os primeiros dashboards conseguiam trocar a curva Audyssey ou o slot Dirac sem ter como mostrar qual estava ativo. As leituras que o app já tem - o modo surround atual, o filtro Dirac ativo, a predefinição de alto-falantes, o dimmer e dezenas de outras - agora são publicadas como atributos no sensor de status do receptor, para que um bloco acenda para a configuração que está realmente em uso.

O AVR Maestro publicando no Home Assistant os scripts de controle de Predefinição de Alto-falantes, Dirac Live e Audyssey
Todos os cômodos

Suas outras zonas, no mesmo dashboard

Energia, volume e mudo da Zona 2 e da Zona 3 são publicados como scripts próprios, então uma varanda ou um segundo cômodo responde a um dashboard ou a um assistente de voz como a zona principal sempre respondeu. Só as zonas que o seu receptor realmente informa ganham botões, então um receptor de duas zonas nunca ganha uma Zona 3.

Se você sincronizou com uma versão mais antiga

Os IDs dos seus scripts mudam uma vez

Antes, os scripts eram nomeados com a cena e o receptor, então renomear qualquer um dos dois deixava o script antigo para trás e criava um segundo em silêncio. Agora eles são nomeados com a cena e o endereço MAC do receptor, e é isso que faz uma renomeação atualizar o mesmo script em vez de criar uma cópia.

A primeira sincronização depois dessa mudança substitui os scripts antigos pelos novos. Tudo o que você construiu sobre os IDs antigos precisa ser reapontado uma vez - um botão do dashboard, uma automação, um alias de voz. Abra o script no Home Assistant para encontrar o novo ID de entidade dele.

As entidades agora também são nomeadas a partir do receptor - cinema30 em vez de trinta e dois caracteres de identificador de máquina - então a lista é legível e o preenchimento automático as encontra. Os IDs de versões anteriores continuam funcionando.

Hubitat

O Hubitat é compatível por meio da sua Maker API e está marcado como BETA no app porque é mais novo que o caminho do Home Assistant, não porque esteja inacabado.

  • IP do Hub - o endereço do seu Hubitat na LAN.
  • ID do App na Maker API - o número na própria URL do app Maker API.
  • Token de Acesso - emitido pela Maker API quando você a ativa.

Ative primeiro a Maker API no hub (Apps › Add Built-In App › Maker API) e ele entrega os três. Cole-os e o AVR Maestro descobre o seu receptor, publica suas cenas como sequências de comandos e devolve o estado em tempo real, para que um dashboard do Hubitat reflita o que o receptor está realmente fazendo, e não o último comando que recebeu.

A tela de configuração do Hubitat com IP do hub, ID do App na Maker API e token de acesso

Webhooks

O Home Assistant e o Hubitat enviam comandos para o receptor. Os webhooks fazem o caminho inverso: quando o receptor faz algo, avisam qualquer outra coisa. Ligue o receptor e o AVR Maestro envia uma pequena mensagem para um endereço que você escolhe - essa mensagem é o webhook.

Esta é a única parte que não é independente do celular. Suas cenas sincronizadas viram scripts no seu hub e rodam esteja o app por perto ou não. Os webhooks são diferentes: o AVR Maestro é quem observa o receptor, então um gatilho dispara enquanto o app está aberto em um dispositivo que consiga enxergá-lo. Se você quer que algo dispare sem nada em execução, construa isso no seu hub em torno da entidade do receptor.

Os quatro gatilhos

Evento de GatilhoDispara quandoPode ser restrito a
Receptor LigadoO receptor sai do standby-
Receptor DesligadoO receptor entra em standby-
Entrada Ativa AlteradaA fonte selecionada mudaUma entrada, em Disparar apenas para a fonte de entrada
Cena RecuperadaUma Cena é aplicadaUma cena, em Selecionar Cena

Restringir é o que os torna úteis em vez de barulhentos. “Entrada Ativa Alterada” em todas as entradas é uma enxurrada; o mesmo gatilho fixado na entrada em que o seu projetor está ligado é um interruptor de luz.

A lista de entradas é a que o seu próprio receptor informa, então já reflete qualquer fonte que você tenha renomeado ou ocultado. A lista de cenas são as suas próprias cenas.

Configurando um, passo a passo

Este é o caminho do Home Assistant, que é o que a maioria das pessoas quer. Faça primeiro a parte do Home Assistant - o app precisa de algo para apontar.

No Home Assistant

No AVR Maestro

Você nunca digita uma URL no caminho do Home Assistant. O app a monta a partir do Home Assistant que você vinculou e consulta esse endereço toda vez que um gatilho dispara. Mude o Home Assistant para uma nova porta, um novo nome de host ou um endereço do Nabu Casa, e todos os webhooks que você já criou acompanham. Não há nada para ressincronizar e nenhum botão para apertar.
Se a folha disser O Home Assistant ainda não está vinculado, faça primeiro o card do Home Assistant no topo desta página. O caminho do webhook precisa de um endereço como base.

Enviando para algo que não é o Home Assistant

Mude Para onde enviar para Outro e cole uma URL completa em URL do Webhook. Qualquer coisa que aceite um POST funciona - um fluxo do Node-RED, um applet do IFTTT, um script em um NAS, um endpoint da Maker API do Hubitat. Esse caminho guarda o endereço exatamente como você digitou, então, se o destino mudar, você edita o gatilho.

O que realmente é enviado

Um pequeno corpo JSON. O card O que ele envia, na mesma tela, descreve isso em linguagem simples para o gatilho escolhido, então você nunca precisa adivinhar - e estes são os nomes de campo que a sua automação lê:

GatilhoCampos na mensagem
Receptor Ligado / Desligadoevent, timestamp
Entrada Ativa Alterada...mais source
Cena Recuperada...mais sceneId e sceneName

Em uma automação do Home Assistant, eles chegam como {{ trigger.json.event }}, {{ trigger.json.source }} e assim por diante. Você pode lê-los ou ignorá-los por completo e apenas agir pelo fato de ter disparado. A maioria das pessoas faz a segunda opção.

Se você precisa de um formato diferente - um serviço que espera o próprio formato - abra Enviar meu próprio JSON embaixo desse card e escreva lá. Ele fica recolhido e marcado como Avançado porque quase ninguém precisa dele, não porque seja desaconselhado.

A tela se chama Webhooks porque é isso que eles são. Se você procura as automações que rodam no seu hub, elas estão nos cards do Home Assistant e do Hubitat acima - uma Cena sincronizada vira um script lá, não um webhook aqui.

Quando um webhook não chega

Na ordem em que vale conferir, porque os dois primeiros quase sempre são a causa:

O que é pago e o que não é

A Automação Residencial é o único desbloqueio. O assistente de IA é gratuito.

Automação Residencial (Pro) - Home Assistant, Hubitat e webhooks de saída - é um desbloqueio único. Todo o resto do AVR Maestro, inclusive o assistente de IA no dispositivo, está incluído no app.

O controle por voz chega ao seu receptor por meio da Automação Residencial, através do seu hub. O AVR Maestro não tem reconhecimento de voz próprio.

Perguntas frequentes

Automação Residencial, respondida

Meu celular precisa estar ligado para o controle por voz funcionar?
Não. O AVR Maestro compila suas cenas em scripts nativos do Home Assistant. O Home Assistant fala diretamente com o receptor na sua rede local, então seu celular pode estar desligado, em repouso ou em outro país.
Quais assistentes de voz podem controlar meu receptor?
O que você já usa. O AVR Maestro não adiciona uma camada de voz própria - ele publica scripts no Home Assistant ou no Hubitat, e o hub em que você já confia os expõe para Alexa, Google Assistant ou Atalhos da Siri.
O assistente de IA faz parte do recurso pago?
Não. O assistente de IA no dispositivo é gratuito. A Automação Residencial - Home Assistant, Hubitat e webhooks de saída - é o único recurso pago do AVR Maestro.
Alguma coisa sai da minha rede doméstica?
Não para o controle. O app fala com o seu receptor e com o seu hub pela sua própria rede. Nada passa por um servidor da MiyaraHub. Um webhook vai para onde você apontar, e a escolha é sua.
Mais do guia

Outros guias do AVR Maestro

Primeiros passos · Tela Inicial · Cenas · Ícones Personalizados · Som · Graphic EQ · Alto-falantes · Por que um controle está bloqueado · O Assistente · Painel do Home Assistant · Zonas · Remoto · Rádio (FM/AM) · Exibição em Tela (OSD) · Configurações · Idiomas · Controles de Volume · Backup & Restauração · Reproduzindo agora & HEOS

Suas cenas, rodando sem o seu celular

A Automação Residencial é um desbloqueio único. Todo o resto do app, inclusive o assistente de IA, está incluído.

Disponível no Google Play Baixe na App Store Baixe na Mac App Store Disponível na Microsoft Store

Voltar ao Guia do Usuário completo →