🏠 Integração do Home Assistant com Apple HomeKit: Um Guia Passo a Passo

Publicado em por

🔍 Introdução

Se você é usuário do Apple HomeKit e do Home Assistant, a boa notícia é que os dois mundos podem trabalhar perfeitamente juntos. Com essa integração, você pode expor dispositivos, sensores e automações do Home Assistant para o app Casa da Apple e até controlá-los com a Siri.

Este guia prático vai mostrar como fazer isso de forma segura, estável e sem complicações.

✅ Pré-Requisitos

Antes de começar, certifique-se de ter:

  • Um Home Assistant em funcionamento (de preferência na versão mais recente).
  • Um dispositivo Apple (iPhone, iPad ou Mac) com o app Casa instalado.
  • Conectividade na mesma rede local.
  • Acesso ao configuration.yaml (modo avançado habilitado).

🔧 Etapa 1: Ativando a Integração HomeKit no Home Assistant

O Home Assistant oferece uma integração nativa com o HomeKit que pode ser configurada manualmente ou via UI. Para um controle mais preciso, usaremos o método via YAML.

No seu configuration.yaml, adicione:

yamlCopiarEditarhomekit:
  name: Home Assistant Bridge
  port: 21063
  filter:
    include_domains:
      - light
      - switch
      - climate
      - sensor
  entity_config:
    light.sala_tv:
      name: Luz da Sala de TV
      manufacturer: Philips Hue
    climate.ar_condicionado:
      name: Ar-condicionado Quarto

💡 Dica: Personalize os nomes e filtros conforme suas preferências.

🧠 Etapa 2: Reinicie o Home Assistant

Após salvar o arquivo YAML, vá até Configurações > Controles do servidor e clique em Reiniciar.

Quando o Home Assistant voltar, você verá uma notificação no canto inferior esquerdo:
“HomeKit: Ready to pair”

📲 Etapa 3: Pareamento com o App Casa da Apple

  1. Abra o app Casa no seu iPhone ou iPad.
  2. Toque em “+” > Adicionar Acessório.
  3. Toque em “Mais opções”.
  4. O Home Assistant Bridge será listado. Selecione-o.
  5. Insira o código de pareamento exibido no Home Assistant (ex: 123-45-678).

🔐 Segurança e Privacidade

  • O HomeKit cria uma ponte criptografada localmente, ou seja, nenhum dado é enviado à nuvem.
  • Apenas dispositivos da sua rede poderão parear.
  • Recomendado: defina um IP fixo para o Home Assistant.

🧪 Testando com Siri

Experimente comandos como:

  • “Ei Siri, acenda a Luz da Sala de TV”
  • “Ei Siri, qual a temperatura do quarto?”

Você verá a resposta sendo enviada diretamente para o Home Assistant.

🧰 Recursos Avançados

Você pode expor:

  • Automations como switches no HomeKit
  • Sensores de movimento, temperatura e umidade
  • Scripts personalizados como cenas

Exemplo:

yamlCopiarEditarscript:
  cena_jantar:
    alias: Cena de Jantar
    sequence:
      - service: light.turn_on
        target:
          entity_id: light.sala_de_jantar
        data:
          brightness: 50

Depois, inclua esse script na seção entity_config do HomeKit.

🧠 Conclusão

Integrar o Home Assistant com o Apple HomeKit desbloqueia o melhor dos dois mundos: a versatilidade do Home Assistant com a facilidade e segurança do ecossistema Apple.

Com essa ponte, você transforma seu iPhone, Apple Watch e até a Siri em controladores poderosos da sua casa inteligente.

📝 Gostou deste guia?

Fique ligado para os próximos artigos da série, como:

  • “Use a Siri para Controlar Dispositivos do Home Assistant”
  • “Câmeras no HomeKit com Stream via Home Assistant”
  • “Como Criar Automação Totalmente Offline com HomeKit Controller”