Guía de Homebridge: cómo hacer que todo sea compatible con HomeKit

A pesar de lo bueno que es Apple HomeKit, que ofrece control de voz y una potente automatización, el sistema es bastante limitado en lo que respecta al soporte de hardware. Por ejemplo, no encontrará soporte de Nest o Ring para la plataforma, y ​​hay compatibilidad limitada para otras grandes marcas como Arlo, Sonos y muchas más.

Ahí es donde entra Homebridge.

Capaz de ejecutarse en prácticamente cualquier computadora, Homebridge es, como su nombre indica, un puente entre HomeKit y otros dispositivos domésticos inteligentes. Homebridge, un servidor ligero de NodeJS que emula la API HomeKit de iOS, es un software de código abierto que brinda el soporte que falta en la plataforma. De ninguna manera está afiliado a Apple y, como ocurre con todo el software de código abierto, instálelo bajo su propio riesgo.

Puede ser un poco complicado de instalar y ejecutar, pero aquí lo guiaremos a través de la instalación inicial. Le mostraremos cómo configurar el sistema y cómo agregar dispositivos y ponerlo en funcionamiento.

¿En qué computadora debo ejecutar Homebridge?

Homebridge funciona con Windows, macOS, Linux y Raspberry Pi. Lo más importante es que sea cual sea el dispositivo en el que lo instales, debe estar encendido todo el tiempo para que funcione. Por esa razón, tiene sentido instalarlo en una Raspberry Pi, ya que la computadora pequeña necesita poca energía para funcionar.

Vale la pena leer las instrucciones de instalación de Raspberry Pi en Homebridge Wiki para instalar los componentes iniciales requeridos, antes de regresar a la página de Homebridge GitHub para obtener instrucciones de instalación de Homebridge.

Si no tiene una Raspberry Pi y solo desea probar el sistema en un tipo diferente de computadora, primero debe descargar e instalar la última versión de Node.js, que está disponible para Windows, Mac y Linux.

Cuando ejecute su Raspberry Pi por primera vez, ejecutará una versión desactualizada de Node.js y el administrador de paquetes NPM. Deberá actualizar ambos para instalar y ejecutar Homebridge.

Primero, debe escribir estos dos comandos para actualizar la lista de paquetes.

sudo apt update
sudo apt full-upgrade

A continuación, debemos decirle a Pi que obtenga la última versión de Node.js, lo que hacemos agregando el repositorio actual con este comando:

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

Luego, estará listo para actualizar a sus nuevos paquetes, así que escriba los siguientes comandos (escriba Y cuando se le solicite):

sudo apt install nodejs
sudo apt install npm

Una vez instalado, siga los pasos en la página de GitHub de Homebridge para descargar e instalar Homebridge. Debe usar la siguiente línea de comando desde una ventana de terminal al instalar:

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

Una vez completado, estará listo y Homebridge estará instalado en su computadora. Puede ejecutarlo utilizando el símbolo del sistema y escribiendo "homebridge".

Verá un código QR en la pantalla, junto con un mensaje que le indica que no hay ningún archivo config.json y que no tiene ningún complemento. Por ahora, salga de Homebridge yendo a su ventana de Terminal y presione CTRL+C (Apple+C en una Mac).

Ahora hay una interfaz web que facilita la administración de Homebridge. Para instalar esto, acceda al símbolo del sistema y escriba:

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

A continuación, queremos instalar Homebridge como un servicio para que se inicie cuando se inicie la computadora. Puedes hacer esto con este comando:

sudo hb-service install --user homebridge

Una vez hecho esto, puede ver en pantalla la dirección IP de su computadora y la dirección del portal de administración del servidor web. Vale la pena darle a su computadora Homebridge una dirección IP fija, que es más fácil si usa la función de reserva DHCP de su enrutador.

Tome la dirección completa de su servidor Homebridge y péguela en un navegador (será algo así como http://192.168.0.61:8581 ). El nombre de usuario y la contraseña predeterminados son ambos ‘admin'.

Cuando inicie sesión, verá toda la información sobre su servidor, incluido el código QR para agregarlo a Apple Home.

Instalar complementos y configurar Homebridge

Cuando utilice el método de instalación anterior, Homebridge se instalará con un archivo de configuración predeterminado, por lo que ya no necesitará crear uno. Y, al usar la interfaz web, el archivo de configuración se actualiza automáticamente, por lo que ya no necesita editarlo a mano. Aún así, es útil saber qué debe estar en el archivo, por si acaso. Lo que sigue es cómo configurar manualmente el servidor, pero puede saltar a la sección Agregar complementos de Homebridge a continuación para una ruta fácil. Además de las instrucciones a continuación, puede encontrar el archivo de configuración en la interfaz web, haciendo clic en Configuración.

Con Brackets, puede crear un nuevo archivo desde el menú Archivo > Nuevo. Vaya a Guardar, y luego debe darle al archivo el nombre correcto y colocarlo en el directorio correcto.

Para Windows, debe escribir el siguiente nombre de directorio en el cuadro de diálogo Guardar:

c:users.homebridge.

Para usuarios de Mac, en el cuadro de diálogo Guardar presione Apple+Shift+G, luego escriba:

~/.homebridge.

Para ambos, ingrese el nombre del archivo como config.json.

Con Brackets, su archivo config.json siempre está disponible cuando abre la aplicación, por lo que para futuras actualizaciones puede seleccionar el archivo, ingresar el texto que necesita y hacer clic en Guardar.

Ahora puede comenzar a agregar la información que necesita. Primero, necesitas una configuración 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."
  }
}

Puede cambiar el nombre de usuario y el pin, pero debe mantener el mismo formato y longitud.

Agregar complementos de Homebridge

Desde la interfaz web, puede administrar sus complementos de Homebridge, que le brindan control sobre los dispositivos que normalmente no son compatibles con Homebridge.

Para agregar un nuevo complemento, haga clic en Complementos y busque el que desee. A menudo obtendrá varias opciones, pero elija la que dice "Verificado" y haga clic en el enlace Instalar.

Aparecerá una ventana emergente que le mostrará el progreso de la instalación. Cuando se completa un complemento, obtendrá una nueva ventana con opciones de configuración. En muchos casos, como con Ring, todo lo que necesita hacer es iniciar sesión en su cuenta y se verán los dispositivos compatibles.

Una vez vinculado, puede hacer clic en el botón Configuración para ver las opciones y la Configuración opcional. Con Ring, por ejemplo, los timbres pueden aparecer como botones que pueden desencadenar eventos; esto probablemente no sea muy útil, por lo que puede ocultarlos de la vista.

Algunos complementos son más complicados de configurar y requieren pasos adicionales, como SmartThings. Después de instalar este complemento, verá una larga lista de campos obligatorios que debe ingresar, pero muy poca ayuda.

Si encuentra algo confuso, vale la pena consultar el sitio web oficial de Homebridge para obtener instrucciones de instalación del complemento: busque el complemento que desea y luego lea las instrucciones.

SmartThings, por ejemplo, requiere que se realice algo de trabajo en SmartThings, como se explica en las instrucciones de instalación de Homebridge SmartThings.

En este caso, ignore las instrucciones sobre el uso de la aplicación SmartThings Classic (se suspendió), pero use la nueva aplicación SmartThings y encontrará la aplicación Homebridge en Smart Apps: debe seleccionar qué dispositivos estarán disponibles para HomeKit siguiendo las instrucciones en pantalla, encontrará los detalles que necesita para configurar el complemento en la opción Procesar los datos de la plataforma.

Veredicto: revisión de Aeotec SmartThings Hub

Esto le proporciona un archivo de configuración que puede copiar y pegar en el archivo de configuración de Homebridge. Sin embargo, puede simplemente copiar y pegar la información de este archivo directamente en los campos de la página Complementos en la interfaz web de Homebridge.

Puede continuar agregando complementos de la misma manera, construyendo todos sus dispositivos conectados.

Agregar Homebridge a su teléfono

Con su configuración funcionando, abra la aplicación Inicio en su dispositivo iOS. Luego seleccione ‘+' y seleccione Agregar accesorio. Toque No tengo un código o No puedo escanear, luego seleccione su computadora Homebridge en la página siguiente.

Se le informará que se trata de un accesorio no certificado, pero seleccione Agregar de todos modos. Ingrese manualmente el código de configuración de HomeKit (el PIN principal en su archivo de configuración). Ahora, sus dispositivos Homebridge se encontrarán y agregarán a Inicio, pero no se sorprenda si hay más de los que cree.

Por ejemplo, con los termostatos Nest, obtienes un interruptor que activa o desactiva el modo Eco, el control principal del termostato y un interruptor que establece si estás en casa o no.

Todos los dispositivos que agregue aparecerán mientras su servidor Homebridge se está ejecutando.

Una vez que sus dispositivos estén en HomeKit, aparecerán de forma predeterminada en la habitación donde agregó el concentrador. Puede mover dispositivos a cualquier habitación y controlarlos como cualquier otro dispositivo HomeKit.

También puede usarlos en Automatizaciones y Escenas de HomeKit, mezclándolos y combinándolos con dispositivos nativos de HomeKit.