Instale o Homebridge no Raspberry Pi e no Windows: 9 etapas

2024 Autor: John Day | [email protected]. Última modificação: 2024-01-30 11:36

Este tutorial é para pessoas que desejam instalar o Homebridge no Raspberry Pi e no Windows.

Inicialmente, este tutorial foi escrito em português aqui no Brasil. Eu tentei o meu melhor para escrever em inglês. Portanto, perdoe-me por alguns erros que possam estar na escrita.

Esta instrução foi dividida da seguinte forma:

Etapa 1: O que é Homekit?

Etapa 2: O que é Homebridge?

Etapa 3: Instalando o Homebridge no Raspberry Pi

Etapa 4: Iniciando o Homebridge com a bota Raspbian

Etapa 5: Instalando o Homebridge Config UI X Plugin (Raspberry Pi)

Etapa 6: Instalando o Homebridge no Windows

Etapa 7: Instalando o Homebridge Config UI X Plugin (Windows)

Etapa 8: Iniciando o Homebridge com o Windows

Etapa 9: Vinculando o Homebridge ao aplicativo Home

Etapa 1: O que é Homekit?

Homekit é um pacote de desenvolvimento fornecido pela Apple para desenvolvedores construírem soluções de Internet das Coisas (IoT). Este pacote de desenvolvimento permite que dispositivos construídos pela Apple (iPhone e iPad, por exemplo) controlem outros dispositivos, como lâmpadas ou informações do sensor. A partir do iOS 9 e do Watch OS Homekit tornou-se uma ferramenta nativa, e devido a toda a tecnologia implementada pela Apple é possível criar sistemas de automação simplesmente com este kit.

Para identificar dispositivos compatíveis com Homekit que estão ativos na rede e para configurar e controlar esses dispositivos, você deve ter o aplicativo Home instalado em qualquer dispositivo Apple (iPhone, iPad, iPod touch, Apple Watch, Apple TV, HomePod ou Mac). Os dispositivos para integração com o aplicativo Home podem ter um código QR que permite o emparelhamento com o aplicativo Home no seu dispositivo Apple.

Após configurar o aparelho no app Home, o usuário pode controlar o aparelho por meio de um atalho que é criado na tela principal do app ou usar o Siri (assistente de voz da Apple) e enviar comandos de voz para acionar o aparelho.

Os requisitos de hardware e software da Apple para uso do Homekit são:

- iPhone, iPad ou iPod touch (executando iOS 10 ou posterior);

- Apple Watch (executando WatchOS 3 ou posterior);

- Apple TV (4ª geração);

- Apple HomePod;

- Macs (executando macOS 10.14 Mojave ou posterior);

Quando se trata de automação residencial e IoT, há uma série de soluções econômicas no mercado, no entanto, a grande maioria não é certificada pela Apple e, portanto, não é nativamente compatível com o Homekit. Se você está cansado de esperar que a Apple certifique essas soluções para uso com o Homekit, você deve usar o Homebridge.

Etapa 2: O que é Homebridge?

Desenvolvido por Nick Farina, o Homebridge é um servidor NodeJS que emula a API Homekit e possibilita o uso de dispositivos não certificados pela Apple com o app Home e Siri. O servidor é leve, pode ser executado em uma rede doméstica e é modular, o que significa que suporta vários plug-ins criados e disponibilizados por uma comunidade extremamente ativa no fortalecimento da ferramenta.

Os plug-ins são instalados no Homebridge e a maioria deles se destina a tornar o Homekit compatível com qualquer dispositivo não certificado pela Apple. Os plug-ins para uso com o Homebridge são instalados diretamente do site do NPM.

A instalação do Homebridge pode ser feita em vários sistemas, porém, para este instrutível será utilizado Raspberry Pi 3 Model B + rodando o sistema operacional Raspbian, e também irei explicar como instalar no Windows.

Etapa 3: Instalando o Homebridge no Raspberry Pi

Idealmente, o Homebridge deve estar disponível sempre que você precisar, portanto, você deve deixar o servidor funcionando 24 horas por dia, 7 dias por semana. Para isso você pode instalar o servidor no Raspberry Pi e mantê-lo funcionando constantemente na sua rede doméstica.

Se você não tiver o Raspbian instalado e configurado no cartão de memória, recomendo que você leia o Instructable Install and Configure Raspbian on Raspberry Pi, siga as etapas abaixo e volte para continuar.

Com o Raspberry Pi executando o Raspbian, na tela inicial do sistema, abra o terminal:

No terminal, digite o primeiro comando abaixo, pressione Enter e, se solicitado a confirmar a ação, digite Y e pressione Enter. Este tipo de confirmação freqüentemente aparece ao remover ou instalar pacotes. Em seguida, digite o segundo comando, digite, confirme o comando se solicitado e aguarde. Esses comandos verificam e atualizam o sistema, se necessário:

sudo apt-get update

sudo apt-get upgrade

Digite o comando abaixo no terminal e pressione Enter:

ifconfig

Algumas informações serão devolvidas. Se você estiver usando um cabo de rede para fornecer uma conexão de rede ao seu Raspberry Pi, vá para a parte de informações após “eth0:” e procure o endereço MAC da placa de rede de oito dígitos e ele estará após a palavra “ether . estiver usando uma conexão WiFi para atribuir uma conexão de rede à sua placa, vá para a parte de informações após “wlan0:” e procure o endereço MAC da placa de rede de oito dígitos que também estará após a palavra “ether”:

Copie o endereço MAC de oito dígitos da placa de rede e salve-o no Bloco de notas, pois esse endereço será necessário posteriormente.

Como relatei anteriormente, o Homebridge é um servidor NodeJS e os plug-ins para ele são instalados diretamente do site do NPM. O Raspbian geralmente vem com os pacotes NodeJS e NPM instalados, entretanto, pode haver incompatibilidade entre as versões de ambos os pacotes, então é melhor remover ambas as instalações e então reinstalar.

Para remover o NPM, digite o comando abaixo no terminal, digite, confirme o comando se solicitado e aguarde a conclusão da remoção do pacote:

sudo apt --auto-remove purge npm

Para remover o NodeJS, digite o comando abaixo no terminal, digite, confirme o comando se solicitado e aguarde a conclusão da remoção do pacote:

sudo apt --auto-remove purge nodejs

Depois de remover o NodeJS e o NPM, podemos prosseguir com a instalação dos pacotes atualizados. Para instalar o NodeJS, digite o comando abaixo no terminal, digite, confirme o comando se solicitado e aguarde a conclusão da instalação do pacote:

sudo apt install nodejs

Para instalar o NPM, digite o comando abaixo no terminal, digite, confirme o comando se solicitado e aguarde a conclusão da instalação do pacote:

curl -L https://www.npmjs.com/install.sh | sudo sh

Digite cada um dos comandos abaixo e pressione Enter após cada um para confirmar se a instalação do pacote foi bem-sucedida. Esses comandos retornam a versão de cada pacote que acabou de ser instalado:

node -v

npm -v

Instale o Avahi e suas dependências. Digite o comando abaixo, digite, confirme o comando se solicitado e aguarde a conclusão da instalação:

sudo apt-get install libavahi-compat-libdnssd-dev

Após a conclusão desses procedimentos, podemos instalar o Homebridge. Digite o comando abaixo, digite, confirme o comando se solicitado e aguarde a conclusão da instalação:

sudo npm install -g --unsafe-perm homebridge

Em seguida, digite o comando abaixo e pressione Enter para inicializar o Homebridge:

homebridge

Homebridge retornará algumas informações:

1) O arquivo config.json não foi encontrado pelo Homebridge. Este arquivo fornece configurações básicas para executar o Homebridge e quaisquer plug-ins instalados. Posteriormente, criaremos o arquivo config.json e suas configurações.

2) Nenhum plugin instalado. Homebridge sem plugins instalados é completamente inútil.

3) Para vincular dispositivos ao app Home, você pode ler o código QR que fornece as informações necessárias para emparelhar. Como o arquivo config.json não foi criado e configurado e não há plug-in instalado, este código QR não é bom no momento, embora no app Home você já possa encontrar o Homebridge disponível para vinculação, mas não.

4) Outra forma de vincular dispositivos ao app Home é por meio da opção “Adicionar Acessório”, “Não tenho um código ou não consigo digitalizar” e em “Acessórios Próximos” o dispositivo é selecionado e você será solicitado a informar o código de configuração. Observe que o terminal exibe o código de oito dígitos e deve ser inserido para corresponder à aplicação.

Posteriormente, você pode usar o código QR ou o código de oito dígitos para vincular o Homebridge ao aplicativo Home no seu dispositivo Apple.

Pressione as teclas CTRL + C no terminal para desligar o Homebridge e a mensagem “Got SIGINT, desligando o Homebridge…” será retornada.

Para criar o arquivo config.json digite o comando abaixo no terminal e pressione Enter. O arquivo em branco será aberto:

sudo nano ~ /.homebridge / config.json

Baixe o arquivo abaixo. Abra este arquivo, copie o conteúdo e cole no arquivo que está aberto no terminal:

file01

1) Em “nome de usuário”, exclua a sequência XX: XX: XX: XX: XX: XX e insira o endereço MAC de oito dígitos da placa de rede que você anotou anteriormente. As letras do endereço que você inserir devem estar todas em maiúsculas.

2) Em "pin" você pode manter os oito dígitos numéricos ou pode mudar para a sequência que desejar, lembrando de manter o mesmo formato de separação com os travessões. Este será o código que você deve inserir ao vincular o Homebridge ao aplicativo Home.

As outras informações do arquivo você pode manter, conforme adiciona plug-ins e acessórios, você pode inserir as informações necessárias.

Para salvar as edições do arquivo, pressione CTRL + O, pressione Enter e CTRL + X para fechar o arquivo.

Etapa 4: Iniciando o Homebridge com a bota Raspbian

Iniciar o Homebridge manualmente toda vez que você ligar o Raspberry Pi não é muito prático, portanto, é melhor executar o servidor imediatamente após o Raspbian iniciar.

Digite o comando abaixo no terminal e pressione Enter. O arquivo em branco será aberto:

sudo nano / etc / default / homebridge

Baixe o arquivo abaixo. Abra este arquivo, copie o conteúdo e cole no arquivo que está aberto no terminal:

file02

Para salvar as edições do arquivo, pressione CTRL + O, pressione Enter e CTRL + X para fechar o arquivo.

Digite o comando abaixo no terminal e pressione Enter. O arquivo em branco será aberto:

sudo nano /etc/systemd/system/homebridge.service

Baixe o arquivo abaixo. Abra este arquivo, copie o conteúdo e cole no arquivo que está aberto no terminal:

arquivo03

Para salvar as edições do arquivo, pressione CTRL + O, pressione Enter e CTRL + X para fechar o arquivo.

Para criar um usuário que irá executar o serviço automaticamente na inicialização e dar a ele as permissões apropriadas, digite cada um dos seguintes comandos e pressione Enter após cada um:

sudo useradd --system homebridge

sudo mkdir / var / homebridge

sudo cp ~ /.homebridge / config.json / var / homebridge /

sudo cp -r ~ /.homebridge / persist / var / homebridge

sudo chmod -R 0777 / var / homebridge

sudo systemctl daemon-reload

sudo systemctl enable homebridge

sudo systemctl start homebridge

Para reiniciar o sistema digite o comando abaixo e pressione Enter:

sudo reboot

Após a reinicialização do sistema, abra o terminal novamente, digite o comando abaixo e pressione Enter para verificar se o serviço já está em execução:

systemctl status homebridge

Se tudo estiver OK, o serviço estará funcionando e você pode ver escrito “ativo (em execução)” e abaixo o código de oito dígitos que foi inserido anteriormente em config.json.

Pressione as teclas CTRL + C no terminal. Digite o comando abaixo e pressione Enter para verificar o registro das informações registradas:

journalctl -f -u homebridge

Pressione as teclas CTRL + C no terminal.

Etapa 5: Instalando o Homebridge Config UI X Plugin (Raspberry Pi)

Para demonstrar a instalação de um plugin no Homebridge optei por usar o Homebridge Config UI X. Este plugin permite através de um navegador configurar, monitorar, fazer backup e reiniciar o Homebridge.

Para instalar o plug-in, digite o comando abaixo no terminal, digite, confirme o comando se solicitado e aguarde a conclusão da instalação:

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

Digite o comando abaixo no terminal e pressione Enter. Um arquivo será aberto:

sudo nano / etc / sudoers

Usando a seta para baixo do teclado ou rolando o mouse, role até o final do arquivo e adicione a seguinte linha:

homebridge ALL = (ALL) NOPASSWD: ALL

Para salvar o arquivo, pressione CTRL + O e depois CTRL + X para fechá-lo.

Digite o comando abaixo no terminal e pressione Enter. Um arquivo será aberto:

sudo nano / etc / default / homebridge

Usando as teclas de seta, role até o final da linha HOMEBRIDGE_OPTS = -U / var / homebridge, forneça um espaço e insira:

-EU

Para salvar o arquivo, pressione CTRL + O e depois CTRL + X para fechar o arquivo.

Agora você precisará editar config.json e adicionar as informações do plug-in adicionadas ao Homebridge.

Se você executou a etapa 4 para colocar o Homebridge em execução imediatamente após o Raspbian ter iniciado, digite o comando abaixo e pressione Enter:

sudo nano /var/homebridge/config.json

Se você não colocou o Homebridge para iniciar com Raspbian, digite o comando abaixo e pressione Enter:

sudo nano ~ /.homebridge / config.json

O config.json será aberto:

Dentro da estrutura da “plataforma”, todos os plugins que estão sendo instalados no Homebridge devem ser informados.

Para Homebridge Config UI X, você deve adicionar o seguinte fragmento de código que está no arquivo abaixo. Baixe, abra, copie o conteúdo e cole no arquivo que está aberto no terminal:

arquivo04

Usando as teclas de seta, vá para “plataformas” e digite o trecho de código que você copiou do arquivo. Na imagem abaixo você pode ver como ficará a estrutura das “plataformas” após adicionar as informações:

Se quiser validar a estrutura do seu código após a edição, basta acessar o site JSONLint, colar todo o código config.json, clicar em "Validar JSON" e se estiver tudo OK a mensagem "JSON válido" será retornada. Se o seu código tiver algum erro, será apontado para a linha com o erro e retornará uma mensagem descrevendo o erro:

jsonlint.com/

Para salvar o arquivo, pressione CTRL + O e depois CTRL + X para fechar o arquivo.

Reinicialize o sistema digitando o comando abaixo, pressione Enter e aguarde a reinicialização:

sudo reboot

Para abrir o Homebridge Config UI X por meio do navegador diretamente no Raspberry Pi, você deve acessar o endereço:

localhost: 8080 /

Se você deseja abrir o Homebridge Config UI X em um navegador de outro computador conectado na mesma rede da placa, simplesmente substitua a palavra localhost do endereço acima pelo IP do seu Raspberry Pi. Para verificar o IP atribuído ao seu Raspberry Pi, basta acessar o terminal, inserir o comando abaixo e inserir:

ifconfig

Provavelmente, o IP atribuído ao seu Raspberry Pi começa com “192.168…”.

No meu caso, a placa é IP 192.168.2.129, então basta acessar a URL abaixo de qualquer computador da minha rede:

192.168.2.129:8080/

Uma página semelhante à imagem abaixo será aberta e será solicitado um login e uma senha. Para login e senha, digite admin e digite para acessar:

Observe que na página inicial é mostrado o código QR e abaixo dele o pino de 8 dígitos que pode ser usado para vincular o Homebridge ao app Home. Na opção "Config" da ferramenta, você pode acessar config.json, editar se precisar e depois salvar.

Navegue pelos recursos disponíveis no Homebridge Config UI X e familiarize-se com a ferramenta.

Para interromper a execução do Homebridge você pode usar o comando abaixo no terminal:

sudo service homebridge stop

Para reiniciar o Homebridge, você pode usar o comando abaixo:

sudo service homebridge restart

Para iniciar a execução do Homebridge, você pode usar o comando abaixo:

sudo service homebridge start

Com o servidor em execução, vá para a etapa 9 para continuar vinculando o Homebridge ao aplicativo Home no seu dispositivo Apple.

Etapa 6: Instalando o Homebridge no Windows

Se você não tiver um Raspberry Pi ou outra plataforma incorporada que possa executar o Homebridge, pode deixar seu servidor executando no Windows.

Você precisará instalar o NodeJS e um editor de texto alternativo para o Bloco de Notas do Windows.

Baixe o NodeJS de um dos links abaixo e instale-o:

nodejs.org/en/download/

Durante a instalação, marque a caixa de seleção que permite instalar automaticamente as ferramentas necessárias:

O NodeJS não é um programa de interface gráfica, portanto, todas as ações são feitas nele a partir de um prompt de comando.

Baixe o Notepad ++ de um dos links abaixo e instale-o:

notepad-plus-plus.org/downloads/

No menu de opções do Windows ao clicar com o botão direito em qualquer arquivo aparecerá a opção “Editar com Notepad ++” e você poderá selecionar esta opção sempre que precisar editar algum arquivo texto ou arquivo Homebridge.

Vá até o menu “Iniciar” do Windows, digite e busque “Configurações” e, quando encontrado, acesse a opção. Clique em “Rede e Internet” e, em seguida, clique em “Centro de Rede e Compartilhamento”. Em "Tipo de acesso" clique na sua conexão ativa, clique em "Detalhes" e copie o endereço MAC de oito dígitos da sua placa de rede e salve-o no bloco de notas, pois este endereço será solicitado posteriormente:

No menu "Iniciar" do Windows, digite e pesquise "cmd" (Prompt de Comando) e, ao encontrá-lo, clique com o botão direito sobre ele e selecione "Executar como administrador":

Com o terminal aberto, digite cada um dos comandos abaixo e pressione Enter após cada um para confirmar se a instalação do NodeJS / NPM foi bem-sucedida. Esses comandos retornam a versão de cada um dos pacotes que foram instalados:

node -v

npm -v

Após a conclusão desses procedimentos, podemos instalar o Homebridge. Digite o comando abaixo, digite e aguarde a conclusão da instalação:

npm install -g --unsafe-perm homebridge

Em seguida, digite o comando abaixo e pressione Enter para inicializar o Homebridge:

homebridge

Homebridge retornará algumas informações:

1) O arquivo config.json não foi encontrado pelo Homebridge. Este arquivo fornece configurações básicas para executar o Homebridge e quaisquer plug-ins instalados. Posteriormente, criaremos o arquivo config.json e suas configurações.

2) Nenhum plugin instalado. Homebridge sem plugins instalados é completamente inútil.

3) Para vincular dispositivos ao app Home, você pode ler o código QR que fornece as informações necessárias para emparelhar. Como o arquivo config.json não foi criado e configurado e não há plug-in instalado, este código QR não é bom no momento, embora no app Home você já possa encontrar o Homebridge disponível para vinculação, mas não.

4) Outra forma de vincular dispositivos ao app Home é por meio da opção “Adicionar Acessório”, “Não tenho um código ou não consigo digitalizar” e em “Acessórios Próximos” o dispositivo é selecionado e você será solicitado a informar o código de configuração. Observe que o terminal exibe o código de oito dígitos e deve ser inserido para corresponder à aplicação.

Pressione as teclas CTRL + C no terminal para fechar o Homebridge. A mensagem “Got SIGINT, shutting down Homebridge …” será retornada e você será solicitado a confirmar, onde você deve digitar a letra Y e pressionar enter.

Para criar o arquivo config.json abra o Notepad ++, clique no menu "Arquivo", "Novo" e uma nova janela se abrirá. Clique no menu "Idioma", role até a letra J na lista e selecione "JSON".

Baixe o arquivo abaixo. Abra este arquivo, copie o conteúdo e cole-o no arquivo que está aberto no Notepad ++:

arquivo05

1) Em “nome de usuário”, exclua a sequência XX: XX: XX: XX: XX: XX e insira o endereço MAC de oito dígitos da placa de rede que você anotou anteriormente. As letras do endereço que você inserir devem estar todas em maiúsculas.

2) Em “pin” você pode manter os oito dígitos numéricos ou pode mudar para a sequência que desejar, lembrando de manter o mesmo formato de separação com os travessões. Este será o código que você deve inserir ao vincular o Homebridge ao aplicativo Home.

As outras informações do arquivo você pode manter, conforme adiciona plug-ins e acessórios, você pode inserir as informações necessárias.

Clique no menu "Arquivo", "Salvar", nomeie o arquivo config.json e salve-o no caminho "C: / Usuários / SEU NOME OU DOCUMENTOS \.homebridge":

Feche o Notepad ++.

Etapa 7: Instalando o Homebridge Config UI X Plugin (Windows)

Para demonstrar a instalação de um plugin no Homebridge optei por usar o Homebridge Config UI X. Este plugin permite através de um navegador configurar, monitorar, fazer backup e reiniciar o Homebridge.

Para instalar o plugin digite o comando abaixo no terminal, aperte enter e aguarde a instalação terminar:

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

NOTA: Se durante a instalação do plugin você encontrar um erro contendo os termos MSBUILD / VCBuild.exe, apenas execute cada um dos seguintes comandos de forma independente e tente instalar novamente a partir do comando acima:

npm install -g node-gyp

npm install --global --production windows-build-tools

npm install --global --production windows-build-tools --vs2015

Agora você precisará editar config.json e inserir as informações do plug-in adicionadas ao Homebridge. Vá para o caminho “C: / Usuários / SEU NOME OU DOCUMENTOS \.homebridge” e através do Notepad ++ abra config.json que foi criado anteriormente:

Dentro da estrutura da “plataforma”, todos os plugins que estão sendo instalados no Homebridge devem ser informados.

Para Homebridge Config UI X, você deve adicionar o seguinte fragmento de código que está no arquivo abaixo. Baixe, abra, copie o conteúdo e cole no arquivo que está aberto no Notepad ++:

arquivo06

Vá para "plataformas" e digite o trecho de código que você copiou do arquivo. Na imagem abaixo você pode ver como ficará a estrutura das “plataformas” após adicionar as informações:

Se quiser validar a estrutura do seu código após a edição, basta acessar o site JSONLint, colar todo o código config.json, clicar em "Validar JSON" e se estiver tudo OK a mensagem "JSON válido" será retornada. Se o seu código tiver algum erro, será apontado para a linha com o erro e retornará uma mensagem descrevendo o erro:

jsonlint.com/

Salve o arquivo, feche o Notepad ++ e reinicie o Windows.

Para abrir o Homebridge Config UI X por meio do navegador, vá para:

localhost: 8080 /

Uma página semelhante à imagem abaixo será aberta e será solicitado um login e uma senha. Para login e senha, digite admin e digite para acessar:

Observe que na página inicial é mostrado o código QR e abaixo dele o pino de 8 dígitos que pode ser usado para vincular o Homebridge ao app Home. Na opção "Config" da ferramenta, você pode acessar config.json, editar se precisar e depois salvar.

Navegue pelos recursos disponíveis no Homebridge Config UI X e familiarize-se com a ferramenta.

Etapa 8: Iniciando o Homebridge com Windows

O Homebridge Config UI X fornece um comando que pode ser usado para configurar o Homebridge como um serviço para que o servidor possa ser inicializado junto com o Windows. No prompt, digite o comando abaixo, digite e aguarde a conclusão da instalação:

hb-service install

NOTA: Se o firewall do Windows solicitar permissão para acessar a rede privada, conceda-a

Após a conclusão da instalação, feche o prompt de comando e reinicie o Windows.

Após a inicialização do sistema, pressione CTRL + ALT + DEL para abrir o Gerenciador de Tarefas do Windows. Vá para a guia "Serviços", procure Homebridge na lista e veja se o "Status" é "Em execução":

Clicar com o botão direito no serviço Homebridge abrirá as opções onde você pode interromper o serviço, reiniciar e se o serviço for interrompido, você pode iniciar:

Se você deseja remover o Homebridge da inicialização do Windows, basta inserir o comando abaixo, inserir e aguardar a conclusão da desinstalação:

desinstalação do serviço hb

NOTA: Dependendo de qual antivírus você usa, pode ter dificuldade em encontrar o Homebridge em seu dispositivo móvel. Para fins de teste, quando chegar a hora de vincular o Homebridge ao aplicativo Home, se o servidor não for encontrado em dois minutos, desabilite seu antivírus, desabilite o Windows Defender, reinicie o serviço Homebridge por meio do Gerenciador de Tarefas do Windows e tente encontrar o servidor novamente no app Home

Etapa 9: Vinculando o Homebridge ao aplicativo Home

As diretrizes a seguir são válidas para o Homebridge em execução no Raspberry Pi e no Windows. Certifique-se de que o servidor esteja funcionando, pois o aplicativo Home só encontrará o Homebridge se estiver online.

Eu usei um iPhone 8 Plus para este post, então a partir daqui as etapas serão baseadas no iOS. Para outros dispositivos compatíveis com o Apple Homekit, sugiro que você verifique os menus para as seguintes opções.

Vá para a tela inicial do seu iPhone e procure o app Home nos aplicativos. Se você não conseguir encontrar, acesse a App Store e instale o aplicativo:

Com o aplicativo Home aberto, clique em “Adicionar Acessório”:

Na tela que abrir, clique em “Não tenho um código ou não consigo digitalizar?”:

Em “Acessórios Próximos” você verá a Homebridge. Clique nele para abrir a tela de pareamento:

Uma mensagem será aberta e você deve clicar em "Adicionar mesmo assim":

Será solicitado que você insira o “Código de configuração do Homebridge”. Preencha o código (PIN) que você definiu em config.json e espere:

Se tudo correr bem, você verá uma tela informando que o Homebridge foi adicionado e está pronto para uso:

NOTA: Se você receber uma mensagem informando que o código não foi aceito ou não pôde ser adicionado, feche o aplicativo Home, reinicie o Homebridge e tente as etapas novamente

Na próxima tela, você verá a mensagem “Configuração adicional necessária”, pois ainda não há um dispositivo Homebridge. Clique em CONCLUÍDO e o aplicativo retornará à tela inicial:

Na tela inicial, clique no símbolo de uma casa, na próxima tela clique em “Hubs & Bridges”, clique no novo Homebridge adicionado e você verá algumas informações, e SE posteriormente você precisar remover o link Homebridge, clique em “Remova a ponte de casa”:

Se você remover o Homebridge do aplicativo Home e quiser adicioná-lo novamente, será necessário excluir as pastas “acessórios” e “persistentes” do servidor.

No Raspberry Pi:

Encerre o Homebridge digitando o comando abaixo no terminal e pressionando Enter:

sudo service homebridge stop

Se você executou a etapa 4 para colocar o Homebridge em execução imediatamente após o Raspbian ter iniciado, digite o comando abaixo e pressione Enter:

cd / var / homebridge

Se você não colocou o Homebridge para iniciar com Raspbian, digite o comando abaixo e pressione Enter:

cd.homebridge /

Digite cada um dos comandos abaixo e pressione Enter após cada um para excluir as pastas "acessórios" e "persistentes":

sudo rm -r persist /

acessórios sudo rm -r /

Digite o comando abaixo no terminal e dê entrar para iniciar o Homebridge:

sudo service homebridge start

Execute as etapas novamente para vincular o Homebridge ao app Home.

No Windows:

Pare o serviço Homebridge através do Gerenciador de Tarefas do Windows, vá para o caminho “C: / Usuários / SEU NOME OU DOCUMENTOS \.homebridge” e exclua as pastas “acessórios” e “persistentes. Inicie o serviço Homebridge por meio do Gerenciador de Tarefas do Windows.

Execute as etapas novamente para vincular o Homebridge ao app Home.

É importante observar que qualquer dispositivo integrado ao app Home é alimentado localmente. Para poder controlar dispositivos de aplicativos domésticos por meio de uma rede externa (conexão 3G / 4G, por exemplo), você precisará configurar um hub de automação de um dos seguintes dispositivos Apple: iPad (executando iOS 10 ou posterior), Apple TV (4ª geração) ou HomePod. Desta forma, mesmo fora de casa você poderá controlar remotamente seus dispositivos de automação e IoT que estão integrados ao app Home através do Homebridge ou Homekit.

Ao vincular o Homebridge ao aplicativo Completed Home, você pode explorar as funções desta excelente ferramenta. No link abaixo você pode ver a lista de plugins disponíveis para uso com o Homebridge e clicando em cada um você pode ver suas informações e como instalar:

www.npmjs.com/search?q=homebridge-plugin

Se você possui um dispositivo de IoT ou automação residencial e deseja integrá-lo ao Homebridge, basta pesquisar se já existe um plugin criado que lhe permitirá usar este dispositivo no app Home.

Uma vez que o usuário root não está habilitado no Raspbian, para instalações de plugins sempre lembre-se de usar a palavra sudo antes do comando de instalação do terminal. Se você não usar o sudo, o sistema sempre solicitará que você insira a senha do sistema para executar a ação ou você pode retornar uma mensagem informando que não tem permissão.

No Windows, o prompt de comando deve ser executado como administrador para poder executar as linhas de comando e você não deve usar a palavra sudo, pois ela não será reconhecida pelo sistema.

Sempre que você instalar um plug-in, certifique-se de adicionar suas informações em config.json e reinicie o Homebridge para que o aplicativo Home possa ser atualizado com as informações dos plug-ins adicionados. Da mesma forma, sempre que você desinstalar um plug-in Homebridge, certifique-se de remover as informações do config.json do plug-in, pois se você não remover o servidor, poderá ter problemas de inicialização.

Abaixo estão alguns links que podem ser úteis para encontrar mais informações sobre o Homebridge e o Homekit:

homebridge.io/

github.com/nfarina/homebridge

support.apple.com/pt-br/HT204893

Se você tem dispositivos Sonoff e gostaria de usá-los com o app Home e Siri, recomendo que leia o app Integrate Sonoff With Home (Apple IPhone IOS) instrutível.