Guide Homebridge : Comment tout rendre compatible avec HomeKit

Aussi bon que soit Apple HomeKit, offrant à la fois un contrôle vocal et une automatisation puissante, le système est plutôt limité en ce qui concerne le support matériel. Par exemple, vous ne trouverez aucun support Nest ou Ring pour la plate-forme, et la compatibilité avec d'autres grandes marques telles qu'Arlo, Sonos et bien d'autres est limitée.

C'est là qu'intervient Homebridge.

Capable de fonctionner sur pratiquement n'importe quel ordinateur, Homebridge est, comme son nom l'indique, un pont entre HomeKit et d'autres appareils domestiques intelligents. Un serveur NodeJS léger qui émule l'API iOS HomeKit, Homebridge est un logiciel open source qui fournit le support qui manque à la plate-forme. Il n'est en aucun cas affilié à Apple et, comme pour tous les logiciels open source, installez-le à vos risques et périls.

L'installation et l'exécution peuvent être fastidieuses, mais ici, nous vous guiderons tout au long de l'installation initiale. Nous vous montrerons comment configurer le système et comment ajouter des appareils et vous permettre d'être opérationnel.

Sur quel ordinateur dois-je exécuter Homebridge ?

Homebridge fonctionne avec Windows, macOS, Linux et le Raspberry Pi. Le plus important est que, quel que soit l'appareil sur lequel vous l'installez, il doit être allumé en permanence pour fonctionner. Pour cette raison, il est logique de l'installer sur un Raspberry Pi, car le petit ordinateur a besoin de peu d'énergie pour fonctionner.

Il vaut la peine de lire les instructions d'installation de Raspberry Pi sur le Homebridge Wiki pour installer les composants initiaux requis, avant de revenir à la page Homebridge GitHub pour les instructions d'installation de Homebridge.

Si vous n'avez pas de Raspberry Pi et que vous souhaitez simplement essayer le système sur un autre type d'ordinateur, vous devez d'abord télécharger et installer la dernière version de Node.js, disponible pour Windows, Mac et Linux.

Lorsque vous exécutez votre Raspberry Pi pour la première fois, il exécutera une version obsolète de Node.js et du gestionnaire de packages NPM. Vous devrez mettre à jour les deux pour installer et exécuter Homebridge.

Tout d'abord, vous devez taper ces deux commandes pour mettre à jour la liste des packages.

sudo apt update
sudo apt full-upgrade

Ensuite, nous devons dire au Pi d'obtenir la dernière version de Node.js, ce que nous faisons en ajoutant le référentiel actuel avec cette commande :

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

Ensuite, vous êtes prêt à mettre à jour vos nouveaux packages, alors tapez les commandes suivantes (tapez Y lorsque vous y êtes invité) :

sudo apt install nodejs
sudo apt install npm

Une fois installé, suivez les étapes de la page Homebridge GitHub pour télécharger et installer Homebridge. Vous devez utiliser la ligne de commande suivante à partir d'une fenêtre de terminal lors de l'installation :

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

Une fois terminé, vous êtes prêt et Homebridge est installé sur votre ordinateur. Vous pouvez l'exécuter en utilisant l'invite de commande et en tapant "homebridge".

Vous verrez un code QR à l'écran, ainsi qu'un message vous indiquant qu'il n'y a pas de fichier config.json et que vous n'avez aucun plugin. Pour l'instant, quittez Homebridge en accédant à sa fenêtre Terminal et appuyez sur CTRL + C (Apple + C sur un Mac).

Il existe maintenant une interface Web qui facilite la gestion de Homebridge. Pour l'installer, ouvrez l'invite de commande et tapez :

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

Ensuite, nous voulons installer Homebridge en tant que service afin qu'il démarre au démarrage de votre ordinateur. Vous pouvez le faire avec cette commande :

sudo hb-service install --user homebridge

Une fois cela fait, vous pouvez voir à l'écran l'adresse IP de votre ordinateur et l'adresse du portail de gestion du serveur Web. Il vaut la peine de donner à votre ordinateur Homebridge une adresse IP fixe, ce qui est plus simple si vous utilisez la fonction de réservation DHCP de votre routeur.

Prenez l'adresse complète de votre serveur Homebridge et collez-la dans un navigateur (ce sera quelque chose comme http://192.168.0.61:8581 ). Le nom d'utilisateur et le mot de passe par défaut sont tous deux ‘admin'.

Lorsque vous vous connectez, vous verrez toutes les informations sur votre serveur, y compris le code QR pour l'ajouter à Apple Home.

Installer les plugins et configurer Homebridge

Lorsque vous utilisez la méthode d'installation ci-dessus, Homebridge s'installe avec un fichier de configuration par défaut, vous n'avez donc plus besoin d'en créer un. De plus, l'utilisation de l'interface Web met automatiquement à jour le fichier de configuration, vous n'avez donc plus besoin de le modifier à la main. Pourtant, il est pratique de savoir ce qui devrait être dans le fichier, juste au cas où. Ce qui suit est la façon de configurer manuellement le serveur, mais vous pouvez passer à la section Ajouter des plugins Homebridge ci-dessous pour un itinéraire facile. En plus des instructions ci-dessous, vous pouvez trouver le fichier de configuration dans l'interface Web en cliquant sur Config.

Avec Brackets, vous pouvez créer un nouveau fichier à partir du menu Fichier > Nouveau. Allez dans Enregistrer, puis vous devez donner au fichier le bon nom et le placer dans le bon répertoire.

Pour Windows, vous devez saisir le nom de répertoire suivant dans la boîte de dialogue d'enregistrement :

c:users.homebridge.

Pour les utilisateurs de Mac, dans la boîte de dialogue d'enregistrement, appuyez sur Pomme+Maj+G, puis tapez :

~/.homebridge.

Pour les deux, entrez le nom du fichier sous la forme config.json.

Avec Brackets, votre fichier config.json est toujours disponible lorsque vous ouvrez l'application. Ainsi, pour les futures mises à jour, vous pouvez sélectionner le fichier, saisir le texte dont vous avez besoin et cliquer sur Enregistrer.

Vous pouvez maintenant commencer à ajouter les informations dont vous avez besoin. Tout d'abord, vous avez besoin d'une configuration de base, telle que celle-ci :

{
  "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."
  }
}

Vous pouvez modifier le nom d'utilisateur et le code PIN, mais vous devez conserver le même format et la même longueur.

Ajout de plugins Homebridge

Depuis l'interface Web, vous pouvez gérer vos plugins Homebridge, qui vous permettent de contrôler les appareils qui ne prennent normalement pas en charge Homebridge.

Pour ajouter un nouveau plugin, cliquez sur Plugins et recherchez celui que vous voulez. Vous aurez souvent plusieurs choix, mais choisissez celui qui dit "Vérifié" et cliquez sur le lien Installer.

Vous obtiendrez une fenêtre contextuelle qui vous montrera la progression de l'installation. Lorsqu'un plug-in est terminé, vous obtenez une nouvelle fenêtre avec des options de configuration. Dans de nombreux cas, comme avec Ring, tout ce que vous avez à faire est de vous connecter à votre compte et les appareils pris en charge sont visibles.

Une fois lié, vous pouvez cliquer sur le bouton Paramètres pour afficher les options et la configuration facultative. Avec Ring, par exemple, les sonnettes peuvent apparaître comme des boutons pouvant déclencher des événements ; ce n'est probablement pas très utile, vous pouvez donc simplement les masquer.

Certains plugins sont plus compliqués à configurer et nécessitent des étapes supplémentaires, comme SmartThings. Après avoir installé ce plugin, vous verrez une longue liste de champs obligatoires que vous devez saisir, mais très peu d'aide.

Si vous obtenez quelque chose de confus, cela vaut la peine de consulter le site Web officiel de Homebridge pour les instructions d'installation du plugin: recherchez le plugin que vous voulez, puis lisez les instructions.

SmartThings, par exemple, nécessite que certains travaux soient effectués dans SmartThings lui-même, comme l' expliquent les instructions d'installation de Homebridge SmartThings.

Dans ce cas, ignorez les instructions d'utilisation de l'application SmartThings Classic (cela a été abandonné), mais utilisez la nouvelle application SmartThings, et vous trouverez l'application Homebridge sous Smart Apps: vous devez sélectionner les appareils qui seront disponibles pour HomeKit en suivant les instructions à l'écran, et vous trouverez les détails dont vous avez besoin pour configurer le plugin sous l'option Render the platform data.

Verdict : examen du hub Aeotec SmartThings

Cela vous donne un fichier de configuration que vous pouvez copier et coller dans le fichier de configuration Homebridge. Cependant, vous pouvez simplement copier et coller les informations de ce fichier directement dans les champs de la page Plugins de l'interface Web Homebridge.

Vous pouvez continuer à ajouter des plug-ins de la même manière, en créant tous vos appareils connectés.

Ajouter Homebridge à votre téléphone

Lorsque votre configuration fonctionne, ouvrez l'application Home sur votre appareil iOS. Sélectionnez ensuite ‘+' et sélectionnez Ajouter un accessoire. Appuyez sur Je n'ai pas de code ou je ne peux pas numériser, puis sélectionnez votre ordinateur Homebridge sur la page suivante.

On vous dira qu'il s'agit d'un accessoire non certifié, mais sélectionnez Ajouter quand même. Entrez manuellement le code de configuration HomeKit (le code PIN principal dans votre fichier de configuration). Maintenant, vos appareils Homebridge seront trouvés et ajoutés à la maison, mais ne soyez pas surpris s'il y en a plus que vous ne le pensez.

Par exemple, avec les thermostats Nest, vous obtenez un interrupteur qui active ou désactive le mode Éco, la commande principale du thermostat et un interrupteur qui définit si vous êtes à la maison ou non.

Tous les appareils que vous ajoutez apparaîtront pendant que votre serveur Homebridge est en cours d'exécution.

Une fois vos appareils dans HomeKit, ils apparaîtront par défaut dans la pièce où vous avez ajouté le hub. Vous pouvez déplacer des appareils dans n'importe quelle pièce et les contrôler comme n'importe quel autre appareil HomeKit.

Vous pouvez également les utiliser dans les automatisations et les scènes HomeKit, en mélangeant et en faisant correspondre les appareils HomeKit natifs.