Como automatizar iluminação e dispositivos com Home Assistant
1. Introdução ao Home Assistant e conceitos fundamentais
Home Assistant é uma plataforma open-source de automação residencial que centraliza o controle de dispositivos inteligentes de diferentes fabricantes em um único sistema. Sua principal vantagem é a privacidade — tudo funciona localmente, sem depender de nuvens externas.
A arquitetura do Home Assistant é baseada em três componentes principais:
- Sensores: dispositivos que captam informações do ambiente (movimento, luminosidade, temperatura)
- Atuadores: dispositivos que executam ações (lâmpadas, relés, motores de cortina)
- Automações e cenas: regras que conectam sensores a atuadores, criando comportamentos inteligentes
Para instalação, as opções mais comuns são:
- Raspberry Pi 4/5: ideal para iniciantes, baixo consumo energético
- Docker: flexível para quem já tem servidor Linux
- VM (Virtual Machine): melhor desempenho e isolamento
- Hardware dedicado (Home Assistant Green/Yellow): plug-and-play oficial
2. Configuração inicial e integração de dispositivos
Após a instalação, acesse http://homeassistant.local:8123 para criar o usuário administrador. A configuração de rede geralmente é automática via DHCP.
Para integrar dispositivos, utilize as integrações nativas ou complementos:
Philips Hue (Bridge):
Configurações > Dispositivos e Serviços > Adicionar Integração > Philips Hue
Pressione o botão físico da Bridge quando solicitado
Zigbee2MQTT (para dispositivos Zigbee genéricos):
Instale o complemento Mosquitto broker (MQTT)
Instale o complemento Zigbee2MQTT
Conecte o adaptador USB (Sonoff Zigbee 3.0, Conbee II)
Adicione dispositivos no modo pareamento do sensor
ESPHome (dispositivos Wi-Fi personalizados):
Instale o complemento ESPHome
Crie um novo dispositivo com template YAML
Faça upload via USB ou OTA
3. Criando automações de iluminação inteligente
Acesse Configurações > Automações e Cenas > Criar Automação.
Exemplo 1: Acender luz ao anoitecer
gatilho:
- plataforma: sun
evento: sunset
offset: "-00:30"
condição:
- condição: estado
entidade_id: binary_sensor.presenca_sala
estado: "on"
ação:
- serviço: light.turn_on
dados:
entidade_id: light.luminaria_sala
brightness_pct: 70
Exemplo 2: Sensor de presença com timeout
gatilho:
- plataforma: state
entidade_id: binary_sensor.movimento_quarto
para: "on"
ação:
- serviço: light.turn_on
dados:
entidade_id: light.abajur_quarto
- atraso: "00:05:00"
- serviço: light.turn_off
dados:
entidade_id: light.abajur_quarto
Condições avançadas combinam luminosidade e horário:
condição:
- condição: numeric_state
entidade_id: sensor.luminosidade_sala
abaixo: 50
- condição: time
after: "18:00:00"
before: "06:00:00"
4. Automações avançadas com dispositivos diversos
Controle de ventilador por temperatura:
gatilho:
- plataforma: numeric_state
entidade_id: sensor.temperatura_quarto
acima: 26
ação:
- serviço: fan.turn_on
dados:
entidade_id: fan.ventilador_teto
percentage: 75
Fechadura inteligente + alarme ao sair:
gatilho:
- plataforma: state
entidade_id: lock.porta_principal
para: "locked"
condição:
- condição: state
entidade_id: binary_sensor.presenca_casa
estado: "off"
ação:
- serviço: alarm_control_panel.alarm_arm_away
dados:
entidade_id: alarm_control_panel.alarme_residencial
- serviço: light.turn_off
dados:
entidade_id: all
Modo cinema (cenário combinado):
ação:
- serviço: light.turn_on
dados:
entidade_id: light.luz_sala
brightness_pct: 20
rgb_color: [255, 100, 0]
- serviço: cover.close_cover
dados:
entidade_id: cover.cortina_sala
- serviço: media_player.turn_on
dados:
entidade_id: media_player.tv_sala
- serviço: media_player.select_source
dados:
entidade_id: media_player.tv_sala
source: "HDMI 1"
5. Uso de scripts, cenas e blueprints
Criando uma cena "Modo Noturno":
Configurações > Automações e Cenas > Cenas > Criar Cena
Nome: "Modo Noturno"
Entidades:
light.luz_quarto: desligado
light.luz_corredor: brightness 10%
cover.cortina_quarto: fechada
Script para desligar tudo ao dormir:
script:
desligar_tudo_dormir:
sequence:
- serviço: light.turn_off
dados: {}
alvo:
area_id: living_room
- serviço: light.turn_off
dados: {}
alvo:
area_id: kitchen
- serviço: cover.close_cover
dados: {}
alvo:
area_id: bedroom
- serviço: media_player.turn_off
dados: {}
alvo:
area_id: living_room
Importando blueprint da comunidade:
Configurações > Automações e Cenas > Blueprints > Importar Blueprint
URL: https://github.com/home-assistant/core/blob/dev/homeassistant/components/blueprint/blueprints/example.yaml
6. Automações baseadas em localização e presença
Rastreamento via app do Home Assistant:
Instale o app Home Assistant Companion no celular
Configurações > Pessoas > Seu perfil > Rastreamento de localização
Ative "Atualizar localização em segundo plano"
Automação geográfica — luzes ao chegar:
gatilho:
- plataforma: zone
entidade_id: zone.minha_casa
evento: enter
contexto:
user: seu_user_id
ação:
- serviço: light.turn_on
dados:
entidade_id: group.luzes_entrada
brightness_pct: 80
- serviço: notify.mobile_app_seu_celular
dados:
message: "Bem-vindo! Luzes da entrada acesas."
Detecção combinada — todos saíram:
gatilho:
- plataforma: state
entidade_id: binary_sensor.presenca_casa
para: "off"
condição:
- condição: state
entidade_id: binary_sensor.presenca_casa
estado: "off"
for:
hours: 0
minutes: 5
seconds: 0
ação:
- serviço: light.turn_off
dados:
entidade_id: all
- serviço: climate.turn_off
dados:
entidade_id: climate.ar_condicionado
- serviço: alarm_control_panel.alarm_arm_away
dados:
entidade_id: alarm_control_panel.alarme
7. Monitoramento, manutenção e boas práticas
Logs e depuração:
Configurações > Sistema > Logs
Filtre por "automation" para ver execuções de automações
Ative o modo de depuração:
logger:
default: info
logs:
homeassistant.components.automation: debug
Backup e versionamento:
# Backup manual via interface
Configurações > Sistema > Backups > Criar Backup
# Versionamento com Git no diretório de configuração
cd /config
git init
git add .
git commit -m "Configuração inicial"
Segurança:
- Acesso remoto: utilize Nabu Casa (oficial, criptografado) ou VPN (WireGuard)
- Senhas fortes: mínimo 12 caracteres com maiúsculas, números e símbolos
- Atualizações: mantenha Home Assistant e complementos sempre atualizados
- Firewall: bloqueie portas 8123 externas se não usar Nabu Casa
Referências
- Documentação Oficial do Home Assistant - Automações — Guia completo sobre criação de automações, gatilhos, condições e ações
- Integração Philips Hue no Home Assistant — Configuração detalhada para conectar lâmpadas Hue ao Home Assistant
- Zigbee2MQTT - Documentação Oficial — Guia de instalação e configuração para dispositivos Zigbee com MQTT
- ESPHome - Criando Dispositivos Customizados — Tutorial para criar sensores e atuadores Wi-Fi com microcontroladores ESP
- Blueprints da Comunidade Home Assistant — Repositório de blueprints prontos para importar e personalizar automações
- Nabu Casa - Acesso Remoto Seguro — Serviço oficial de acesso remoto com criptografia e suporte ao desenvolvimento do Home Assistant