Guia Homebridge: Como tornar tudo compatível com o HomeKit

Por melhor que seja o Apple HomeKit, oferecendo controle de voz e alguma automação poderosa, o sistema é bastante limitado quando se trata de suporte de hardware. Por exemplo, você não encontrará nenhum suporte Nest ou Ring para a plataforma e há compatibilidade limitada para outras grandes marcas, como Arlo, Sonos e muito mais.

É aí que entra o Homebridge.

Capaz de rodar em praticamente qualquer computador, o Homebridge é, como o nome sugere, uma ponte entre o HomeKit e outros dispositivos domésticos inteligentes. Um servidor NodeJS leve que emula a API HomeKit do iOS, o Homebridge é um software de código aberto que fornece o suporte que falta na plataforma. Não é de forma alguma afiliado à Apple e, como acontece com todos os softwares de código aberto, instale-o por sua conta e risco.

Pode ser um pouco complicado de instalar e executar, mas aqui vamos guiá-lo pela instalação inicial. Mostraremos como configurar o sistema e como adicionar dispositivos e colocá-lo em funcionamento.

Em qual computador devo executar o Homebridge?

O Homebridge funciona com Windows, macOS, Linux e Raspberry Pi. O mais importante é que, seja qual for o dispositivo em que você o instalar, ele precisa estar ligado o tempo todo para funcionar. Por esse motivo, faz sentido instalá-lo em um Raspberry Pi, pois o pequeno computador precisa de pouca energia para funcionar.

Vale a pena ler as instruções de instalação do Raspberry Pi no Homebridge Wiki para instalar os componentes iniciais necessários, antes de retornar à página Homebridge GitHub para obter as instruções de instalação do Homebridge.

Se você não possui um Raspberry Pi e deseja apenas experimentar o sistema em um tipo diferente de computador, primeiro faça o download e instale a versão mais recente do Node.js, que está disponível para Windows, Mac e Linux.

Quando você executar seu Raspberry Pi pela primeira vez, ele executará uma versão desatualizada do Node.js e do gerenciador de pacotes NPM. Você precisará atualizar ambos para instalar e executar o Homebridge.

Primeiro, você precisa digitar esses dois comandos para atualizar a lista de pacotes.

sudo apt update
sudo apt full-upgrade

Em seguida, precisamos dizer ao Pi para obter a versão mais recente do Node.js, o que fazemos adicionando o repositório atual com este comando:

curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash -

Então, você está pronto para atualizar para seus novos pacotes, então digite os seguintes comandos (digite Y quando solicitado):

sudo apt install nodejs
sudo apt install npm

Depois de instalado, siga as etapas na página Homebridge GitHub para baixar e instalar o Homebridge. Você deve usar a seguinte linha de comando de uma janela de terminal ao instalar:

npm install -g --unsafe-perm homebridge
sudo npm install -g --unsafe-perm homebridge

Depois de concluído, você está pronto e o Homebridge está instalado em seu computador. Você pode executá-lo usando o prompt de comando e digitando "homebridge".

Você verá um código QR na tela, juntamente com uma mensagem informando que não há nenhum arquivo config.json e que você não possui nenhum plug-in. Por enquanto, saia do Homebridge indo para a janela do Terminal e pressione CTRL+C (Apple+C em um Mac).

Agora existe uma interface da Web que facilita o gerenciamento do Homebridge. Para instalá-lo, abra o prompt de comando e digite:

sudo npm install -g --unsafe-perm homebridge homebridge-config-ui-x

Em seguida, queremos instalar o Homebridge como um serviço para que ele seja iniciado quando o computador inicializar. Você pode fazer isso com este comando:

sudo hb-service install --user homebridge

Uma vez feito, você pode ver na tela o endereço IP do seu computador e o endereço do portal de gerenciamento do servidor web. Vale a pena dar ao seu computador Homebridge um endereço IP fixo, o que é mais fácil se você usar o recurso de reserva DHCP do seu roteador.

Pegue o endereço completo do seu servidor Homebridge e cole-o em um navegador (será algo como http://192.168.0.61:8581 ). O nome de usuário e a senha padrão são ‘admin'.

Ao fazer login, você verá todas as informações sobre seu servidor, incluindo o código QR para adicioná-lo ao Apple Home.

Instalando plugins e configurando o Homebridge

Quando você usa o método de instalação acima, o Homebridge será instalado com um arquivo de configuração padrão, então você não precisa mais criar um. E, usando a interface da web, atualiza o arquivo de configuração automaticamente, para que você não precise mais editá-lo manualmente. Ainda assim, é útil saber o que deve estar no arquivo, apenas por precaução. O que se segue é como configurar manualmente o servidor, mas você pode pular para a seção Adicionando plug-ins do Homebridge abaixo para uma rota fácil. Além das instruções abaixo, você pode encontrar o arquivo Config na interface web, clicando em Config.

Com colchetes, você pode criar um novo arquivo no menu Arquivo > Novo. Vá para Salvar e, em seguida, você precisa dar ao arquivo o nome certo e colocá-lo no diretório certo.

Para Windows, você precisa digitar o seguinte nome de diretório na caixa de diálogo Salvar:

c:users.homebridge.

Para usuários de Mac, na caixa de diálogo Salvar, pressione Apple+Shift+G e digite:

~/.homebridge.

Para ambos, insira o nome do arquivo como config.json.

Com o Brackets, seu arquivo config.json está sempre disponível quando você abre o aplicativo, portanto, para atualizações futuras, você pode selecionar o arquivo, inserir o texto necessário e clicar em Salvar.

Agora você pode começar a adicionar as informações de que precisa. Primeiro, você precisa de uma configuração básica, como esta:

{
  "bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
  },
  "description": "My Homebridge server.",
  "ports": {
    "start": 52100,
    "end": 52150,
    "comment": "This section is used to control the range of ports that separate accessories should bind to."
  }
}

Você pode alterar o nome de usuário e o PIN, mas deve manter a formatação e o comprimento iguais.

Adicionando plug-ins do Homebridge

Na interface da web, você pode gerenciar seus plug-ins Homebridge, que oferecem controle sobre dispositivos que normalmente não têm suporte para Homebridge.

Para adicionar um novo plug-in, clique em Plug-ins e procure o que deseja. Muitas vezes, você terá várias opções, mas escolha a que diz ‘Verificado' e clique no link Instalar.

Você verá uma janela pop-up que mostra o progresso da instalação. Quando um plug-in for concluído, você verá uma nova janela com opções de configuração. Em muitos casos, como no Ring, tudo o que você precisa fazer é fazer login na sua conta e os dispositivos suportados são vistos.

Depois de vinculado, você pode clicar no botão Configurações para visualizar as opções e a Configuração opcional. Com o Ring, por exemplo, as campainhas podem aparecer como botões que podem acionar eventos; isso provavelmente não é muito útil, então você pode simplesmente ocultá-los.

Alguns plugins são mais complicados de configurar e requerem etapas extras, como o SmartThings. Depois de instalar este plug-in, você verá uma longa lista de campos obrigatórios que precisa inserir, mas muito pouca ajuda.

Se você ficar confuso, vale a pena verificar o site oficial do Homebridge para obter instruções de instalação do plug-in: procure o plug-in desejado e leia as instruções.

O SmartThings, por exemplo, requer algum trabalho a ser feito no próprio SmartThings, como explicam as instruções de instalação do Homebridge SmartThings.

Nesse caso, ignore as instruções sobre o uso do aplicativo SmartThings Classic (este foi descontinuado), mas use o novo aplicativo SmartThings e você encontrará o aplicativo Homebridge em Smart Apps: você precisa selecionar quais dispositivos estarão disponíveis para o HomeKit seguindo as instruções na tela, você encontrará os detalhes necessários para configurar o plug-in na opção Renderizar os dados da plataforma.

Veredicto: Revisão do Aeotec SmartThings Hub

Isso fornece um arquivo de configuração que você pode copiar e colar no arquivo de configuração do Homebridge. No entanto, você pode simplesmente copiar e colar as informações deste arquivo diretamente nos campos da página Plugins na interface web do Homebridge.

Você pode continuar a adicionar plug-ins da mesma forma, construindo todos os seus dispositivos conectados.

Adicionando o Homebridge ao seu telefone

Com sua configuração funcionando, abra o aplicativo Home em seu dispositivo iOS. Em seguida, selecione ‘+' e selecione Adicionar acessório. Toque em Don't have a Code ou Can't Scan, então selecione seu computador Homebridge na próxima página.

Você será informado de que este é um acessório não certificado, mas selecione Adicionar mesmo assim. Insira manualmente o código de configuração do HomeKit (o PIN principal em seu arquivo de configuração). Agora, seus dispositivos Homebridge serão encontrados e adicionados ao Home, mas não se surpreenda se houver mais do que você pensa.

Por exemplo, com o Nest Thermostats, você obtém uma chave que liga ou desliga o modo Eco, o controle principal do termostato e uma chave que define se você está em casa ou não.

Todos os dispositivos adicionados aparecerão enquanto o servidor Homebridge estiver em execução.

Quando seus dispositivos estiverem no HomeKit, eles aparecerão por padrão na sala onde você adicionou o hub. Você pode mover dispositivos para qualquer sala e controlá-los como qualquer outro dispositivo HomeKit.

Você também pode usá-los em cenas e automações HomeKit, misturando e combinando com dispositivos HomeKit nativos.