Home Assistant: Cria a Tua Primeira Automação Sem Código [Episódio 4]

Ter as luzes controladas pelo telemóvel é giro durante uma semana. A verdadeira casa inteligente começa quando deixas de carregar em botões: a luz do corredor acende sozinha quando passas de noite, as tomadas em standby desligam-se à hora de deitar e recebes um aviso se deixaste a janela aberta com o aquecimento ligado.

Neste Episódio 4 da série Home Assistant do Zero à Prática, vamos criar as primeiras automações no Home Assistant sem escrever código, usando o sensor Zigbee que emparelhámos no Episódio 3. No fim, deixo também o código pronto a copiar para quem quiser ir mais rápido.

Gatilho, condição e ação: os 3 blocos de qualquer automação

Todas as automações do Home Assistant seguem a mesma lógica, e o editor mostra-a com três secções:

• Quando (gatilho): o acontecimento que faz a automação arrancar. Por exemplo, o sensor deteta movimento, são 23h00 ou o sol põe-se.
• E se (condição): uma verificação opcional. A automação só continua se for verdade. Por exemplo, só se for de noite ou só se não estiver ninguém em casa.
• Então faz (ação): o que acontece. Acender uma luz, desligar uma tomada, enviar uma notificação.

Uma frase resume tudo: quando acontece X, e se Y for verdade, então faz Z. Se consegues dizer a automação assim em voz alta, consegues criá-la no Home Assistant.

Antes de começar: nomes e divisões

Cinco minutos de organização agora poupam horas depois. Em Definições > Áreas, etiquetas e zonas, cria as divisões da casa (Sala, Cozinha, Corredor, Quarto) e atribui cada dispositivo à sua divisão. Dá também nomes claros aos dispositivos: "Sensor movimento corredor" é muito mais fácil de encontrar do que "lumi.sensor_motion.aq2".

Para receberes notificações no telemóvel (exemplo 3), instala também a app Home Assistant para Android ou iPhone e inicia sessão na tua casa. É ela que cria o "serviço de notificação" do teu telemóvel.

Exemplo 1: luz do corredor com sensor de movimento

O clássico: passas no corredor de noite, a luz acende; dois minutos sem movimento, apaga.

1. Vai a Definições > Automações e cenas e carrega em Criar automação > Criar nova automação.
2. Em Quando, carrega em Adicionar gatilho, escolhe Entidade > Estado, seleciona o sensor de movimento do corredor e define "Para" como Detetado.
3. Em E se, carrega em Adicionar condição > Estado, escolhe a entidade Sol e o estado Abaixo do horizonte. Assim a luz só acende quando já é de noite.
4. Em Então faz, carrega em Adicionar ação, procura Ligar luz e escolhe como alvo a luz (ou a área) do corredor.
5. Adiciona uma segunda ação: Aguardar por um gatilho, com o sensor de movimento a passar para Limpo (sem movimento) durante 2 minutos.
6. Adiciona uma terceira ação: Desligar luz, no mesmo alvo.
7. No menu dos três pontos, em Modo, escolhe Reiniciar. Se houver movimento novo enquanto a automação espera, a contagem recomeça em vez de a luz apagar contigo lá.
8. Carrega em Guardar, dá-lhe um nome ("Luz corredor noite") e testa.

Exemplo 2: desligar o standby à noite

Televisão, box, consola e coluna em standby gastam energia 24 horas por dia. Com uma tomada inteligente resolves isso automaticamente.

1. Cria uma nova automação.
2. Em Quando: Adicionar gatilho > Hora e sol > Hora, às 01:00.
3. Em E se: Adicionar condição > Estado, com a TV (ou o consumo da tomada, se tiver medição) em Desligado. Assim não cortas a energia a meio de um filme.
4. Em Então faz: Desligar a tomada do móvel da TV.
5. Cria uma segunda automação simétrica para voltar a ligar a tomada de manhã, por exemplo às 7h00.

Se a tua tomada mede consumo, olha para o valor em standby antes e depois. É um bom número para perceberes quanto estás a poupar, e vamos voltar a ele no episódio dedicado à energia.

Exemplo 3: aviso de janela aberta com aquecimento ligado

Precisas de um sensor de porta/janela Zigbee e de um aquecedor ou termóstato controlado pelo Home Assistant (ou uma tomada inteligente onde ele está ligado).

1. Cria uma nova automação.
2. Em Quando: Estado do sensor da janela a passar para Aberto durante 5 minutos. O tempo evita avisos quando só abres a janela para sacudir um tapete.
3. Em E se: Estado do aquecedor (ou da tomada) em Ligado.
4. Em Então faz: Notificações > Enviar notificação para o teu telemóvel, com a mensagem "A janela da sala está aberta com o aquecimento ligado".
5. Se quiseres ir mais longe, acrescenta uma ação para desligar o aquecimento automaticamente.

Blueprints: automações prontas a usar

Os blueprints são modelos de automação feitos pela comunidade: escolhes o modelo, indicas os teus dispositivos e está feito. O Home Assistant já traz alguns, como "Luz ativada por movimento". Encontras-os em Definições > Automações e cenas > Blueprints, e podes importar muitos mais a partir do fórum da comunidade.

São ótimos para começar, mas recomendo criar pelo menos as tuas três primeiras automações à mão. É assim que percebes a lógica e depois consegues adaptar qualquer blueprint ao que precisas.

O código por trás (para copiar)

Tudo o que fazes no editor visual é guardado como código YAML. Não precisas de lhe tocar, mas é útil para copiar automações entre casas. No editor, abre o menu dos três pontos, escolhe Editar em YAML e cola o código abaixo, trocando os nomes das entidades pelos teus.

alias: Luz corredor noite
mode: restart
triggers:
  - trigger: state
    entity_id: binary_sensor.sensor_movimento_corredor
    to: "on"
conditions:
  - condition: state
    entity_id: sun.sun
    state: below_horizon
actions:
  - action: light.turn_on
    target:
      entity_id: light.corredor
  - wait_for_trigger:
      - trigger: state
        entity_id: binary_sensor.sensor_movimento_corredor
        to: "off"
        for:
          minutes: 2
  - action: light.turn_off
    target:
      entity_id: light.corredor

Os nomes das tuas entidades (como light.corredor) aparecem em Definições > Dispositivos e serviços > Entidades.

Perguntas frequentes

Preciso de saber programar para criar automações no Home Assistant?

Não. O editor visual permite criar automações completas com gatilhos, condições e ações escolhidos em menus. O código YAML é opcional e serve sobretudo para copiar ou partilhar automações.

Qual é a diferença entre automação, cena e script?

Uma automação arranca sozinha quando algo acontece. Uma cena guarda um estado de vários dispositivos (por exemplo, "Cinema": luzes a 20% e estores fechados). Um script é uma sequência de ações que só corre quando o chamas, por um botão ou por outra automação.

As automações funcionam sem internet?

Sim, desde que os dispositivos envolvidos sejam locais, como os Zigbee. As notificações para o telemóvel fora de casa precisam de internet.

O que é o modo de uma automação?

Define o que acontece se a automação for disparada outra vez enquanto ainda está a correr. O modo "Reiniciar" recomeça do início, o que é ideal para luzes com sensor de movimento.

No próximo episódio

As automações funcionam dentro de casa. Mas e quando estás fora? No Episódio 5: Acesso Remoto Seguro e Gratuito, mostramos como controlar o Home Assistant a partir de qualquer lado sem abrir portas no router.

Qual foi a primeira automação que criaste? Partilha nos comentários: as melhores ideias vão entrar num episódio futuro.