Installer Homebridge sur Raspberry Pi et Windows : 9 étapes

2024 Auteur: John Day | [email protected]. Dernière modifié: 2024-01-30 09:06

Ce tutoriel est destiné aux personnes qui souhaitent installer Homebridge sur Raspberry Pi et Windows.

Initialement, ce tutoriel a été écrit en portugais ici au Brésil. J'ai fait de mon mieux pour l'écrire en anglais. Alors pardonnez-moi pour quelques erreurs qui pourraient être dans l'écriture.

Cette instruction était divisée comme suit:

Étape 1: Qu'est-ce que Homekit ?

Étape 2: Qu'est-ce que Homebridge ?

Étape 3: Installation de Homebridge sur Raspberry Pi

Étape 4: Démarrer Homebridge sur Raspbian Boot

Étape 5: Installation du plugin Homebridge Config UI X (Raspberry Pi)

Étape 6: Installation de Homebridge sous Windows

Étape 7: Installation du plugin Homebridge Config UI X (Windows)

Étape 8: Démarrer Homebridge avec Windows

Étape 9: lier Homebridge à l'application Home

Étape 1: Qu'est-ce que Homekit ?

Homekit est un package de développement fourni par Apple pour que les développeurs créent des solutions Internet des objets (IoT). Ce package de développement permet aux appareils construits par Apple (iPhone et iPad, par exemple) de contrôler d'autres appareils, tels que des lampes ou des informations de capteur. Depuis iOS 9 et Watch OS, Homekit est devenu un outil natif, et grâce à toute la technologie mise en œuvre par Apple, il est possible de créer des systèmes d'automatisation simplement avec ce kit.

Pour identifier les appareils compatibles Homekit qui sont actifs sur le réseau et pour configurer et contrôler ces appareils, vous devez avoir l'application Home installée sur n'importe quel appareil Apple (iPhone, iPad, iPod touch, Apple Watch, Apple TV, HomePod ou Mac). Les appareils à intégrer à l'application Home peuvent avoir un code QR qui permet le couplage avec l'application Home sur votre appareil Apple.

Après avoir configuré l'appareil dans l'application Home, l'utilisateur peut contrôler l'appareil via un raccourci créé sur l'écran principal de l'application ou utiliser Siri (assistant vocal fourni par Apple) et envoyer des commandes vocales pour déclencher l'appareil.

Les exigences matérielles et logicielles Apple pour l'utilisation de Homekit sont:

- iPhone, iPad ou iPod touch (exécutant iOS 10 ou version ultérieure);

- Apple Watch (exécutant WatchOS 3 ou version ultérieure);

- Apple TV (4e génération);

- Apple HomePod;

- Mac (exécutant macOS 10.14 Mojave ou version ultérieure);

En matière de domotique et d'IoT, il existe de nombreuses solutions économiques sur le marché, cependant, la grande majorité ne sont pas certifiées Apple et ne sont donc pas nativement compatibles avec Homekit. Si vous en avez assez d'attendre qu'Apple certifie ces solutions pour une utilisation avec Homekit, vous devriez utiliser Homebridge.

Étape 2: Qu'est-ce que Homebridge ?

Développé par Nick Farina, Homebridge est un serveur NodeJS qui émule l'API Homekit et permet d'utiliser des appareils non certifiés Apple avec l'application Home et Siri. Le serveur est léger, peut fonctionner sur un réseau domestique et est modulaire, ce qui signifie qu'il prend en charge plusieurs plugins créés et mis à disposition par une communauté extrêmement active dans le renforcement de l'outil.

Les plugins sont installés sur Homebridge et la plupart d'entre eux sont destinés à rendre Homekit compatible avec tout appareil non certifié Apple. Les plugins à utiliser avec Homebridge sont installés directement à partir du site Web de NPM.

L'installation de Homebridge peut être effectuée sur différents systèmes, cependant, pour cette instructable sera utilisé Raspberry Pi 3 modèle B + exécutant le système d'exploitation Raspbian, et j'expliquerai également comment installer sur Windows.

Étape 3: Installation de Homebridge sur Raspberry Pi

Idéalement, Homebridge devrait être disponible à tout moment, vous devriez donc laisser le serveur fonctionner 24h/24 et 7j/7. Pour cela, vous pouvez installer le serveur sur Raspberry Pi et continuer à fonctionner en permanence sur votre réseau domestique.

Si vous n'avez pas installé et configuré Raspbian sur la carte mémoire, je vous recommande de lire le Instructable Installer et configurer Raspbian sur Raspberry Pi, suivez les étapes ci-dessous, puis revenez pour continuer.

Avec votre Raspberry Pi exécutant Raspbian, dans l'écran d'accueil du système, ouvrez le terminal:

Sur le terminal, tapez la première commande ci-dessous, appuyez sur Entrée, et si vous êtes invité à confirmer le type d'action Y et appuyez sur Entrée. Ce type de confirmation apparaît souvent lors de la suppression ou de l'installation de packages. Tapez ensuite la deuxième commande, entrez, confirmez la commande si vous y êtes invité et attendez. Ces commandes vérifient et mettent à jour le système si nécessaire:

sudo apt-get mise à jour

sudo apt-get mise à niveau

Tapez la commande ci-dessous sur le terminal et appuyez sur Entrée:

ifconfig

Certaines informations seront retournées. Si vous utilisez un câble réseau pour fournir une connexion réseau à votre Raspberry Pi, accédez à la partie information après « eth0: » et recherchez l'adresse MAC de la carte réseau à huit chiffres et ce sera après le mot « ether » Si vous utilisez une connexion WiFi pour attribuer une connexion réseau à votre carte, accédez à la partie information après « wlan0: » et recherchez l'adresse MAC de la carte réseau à huit chiffres qui sera également après le mot « éther »:

Copiez l'adresse MAC à huit chiffres de votre carte réseau et enregistrez-la dans le Bloc-notes, car cette adresse sera requise plus tard.

Comme je l'ai signalé plus tôt, Homebridge est un serveur NodeJS et les plugins pour celui-ci sont installés directement à partir du site NPM. Raspbian est généralement livré avec les packages NodeJS et NPM installés, cependant, il peut y avoir une incompatibilité entre les versions des deux packages, il est donc préférable de supprimer les deux installations, puis de les réinstaller.

Pour supprimer NPM, tapez la commande ci-dessous sur le terminal, entrez, confirmez la commande si vous y êtes invité et attendez la fin de la suppression du package:

sudo apt --auto-remove purge npm

Pour supprimer NodeJS, tapez la commande ci-dessous sur le terminal, entrez, confirmez la commande si vous y êtes invité et attendez la fin de la suppression du package:

sudo apt --auto-remove purge nodejs

Après avoir supprimé NodeJS et NPM, nous pouvons procéder à l'installation des packages mis à jour. Pour installer NodeJS, tapez la commande ci-dessous dans le terminal, entrez, confirmez la commande si vous y êtes invité et attendez la fin de l'installation du package:

sudo apt installer nodejs

Pour installer NPM, tapez la commande ci-dessous dans le terminal, entrez, confirmez la commande si vous y êtes invité et attendez la fin de l'installation du package:

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

Tapez chacune des commandes ci-dessous et appuyez sur Entrée après chacune pour confirmer que l'installation du package a réussi. Ces commandes renvoient la version de chaque package qui vient d'être installé:

nœud -v

npm -v

Installez Avahi et ses dépendances. Entrez la commande ci-dessous, entrez, confirmez la commande si vous y êtes invité et attendez la fin de l'installation:

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

Une fois ces procédures terminées, nous pouvons installer le Homebridge. Entrez la commande ci-dessous, entrez, confirmez la commande si vous y êtes invité et attendez la fin de l'installation:

sudo npm install -g --unsafe-perm homebridge

Tapez ensuite la commande ci-dessous et appuyez sur Entrée pour démarrer Homebridge:

pont

Homebridge renverra quelques informations:

1) Le fichier config.json n'a pas été trouvé par Homebridge. Ce fichier fournit les paramètres de base pour exécuter Homebridge et tous les plugins installés. Plus tard, nous créerons le fichier config.json et ses paramètres.

2) Aucun plugin installé. Homebridge sans plugins installés est complètement inutile.

3) Pour lier des appareils à l'application Home, vous pouvez lire le code QR qui vous donne les informations dont vous avez besoin pour associer. Étant donné que le fichier config.json n'a pas été créé et configuré et qu'aucun plug-in n'est installé, ce code QR n'est actuellement pas bon, bien que dans l'application Home, vous puissiez déjà trouver Homebridge disponible pour la liaison, mais ce n'est pas le cas.

4) Une autre façon de lier des appareils à l'application Home consiste à utiliser l'option "Ajouter un accessoire", "Je n'ai pas de code ou je ne peux pas scanner", et sous "Accessoires à proximité", l'appareil est sélectionné et vous serez alors invité à le code de configuration. Notez que le terminal affiche le code à huit chiffres et doit être entré pour correspondre à l'application.

Vous pouvez ensuite utiliser le code QR ou le code à huit chiffres pour lier Homebridge à l'application Home sur votre appareil Apple.

Appuyez sur les touches CTRL + C du terminal pour arrêter Homebridge et le message « Got SIGINT, shutdowning Homebridge… » sera renvoyé.

Pour créer le fichier config.json tapez la commande ci-dessous dans le terminal et appuyez sur Entrée. Le fichier vierge s'ouvrira:

sudo nano ~/.homebridge/config.json

Téléchargez le fichier ci-dessous. Ouvrez ce fichier, copiez le contenu et collez-le dans le fichier ouvert dans le terminal:

fichier01

1) Dans « nom d'utilisateur » supprimez la séquence XX: XX: XX: XX: XX: XX et entrez l'adresse MAC à huit chiffres de la carte réseau que vous avez précédemment notée. Les lettres de l'adresse que vous entrez doivent être toutes en majuscules.

2) Dans "pin" vous pouvez conserver les huit chiffres numériques ou vous pouvez passer à une séquence que vous voulez, en vous rappelant de garder le même format de séparation avec les tirets. Ce sera le code que vous devrez entrer au moment où vous lierez Homebridge à l'application Home.

Les autres informations de fichier que vous pouvez conserver, au fur et à mesure que vous ajoutez des plugins et des accessoires, vous pouvez entrer les informations requises.

Pour enregistrer les modifications apportées au fichier, appuyez sur CTRL + O, appuyez sur Entrée, puis sur CTRL + X pour fermer le fichier.

Étape 4: Démarrer Homebridge sur Raspbian Boot

Démarrer Homebridge manuellement à chaque fois que vous allumez votre Raspberry Pi n'est pas très pratique, il est donc préférable de faire fonctionner le serveur immédiatement après le démarrage de Raspbian.

Tapez la commande ci-dessous sur le terminal et appuyez sur Entrée. Le fichier vierge s'ouvrira:

sudo nano /etc/default/homebridge

Téléchargez le fichier ci-dessous. Ouvrez ce fichier, copiez le contenu et collez-le dans le fichier ouvert dans le terminal:

fichier02

Pour enregistrer les modifications apportées au fichier, appuyez sur CTRL + O, appuyez sur Entrée, puis sur CTRL + X pour fermer le fichier.

Tapez la commande ci-dessous sur le terminal et appuyez sur Entrée. Le fichier vierge s'ouvrira:

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

Téléchargez le fichier ci-dessous. Ouvrez ce fichier, copiez le contenu et collez-le dans le fichier ouvert dans le terminal:

fichier03

Pour enregistrer les modifications du fichier, appuyez sur CTRL + O, appuyez sur Entrée, puis sur CTRL + X pour fermer le fichier.

Pour créer un utilisateur qui exécutera le service automatiquement au démarrage et lui accordera les autorisations appropriées, saisissez chacune des commandes suivantes et appuyez sur Entrée après chacune:

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 démon-recharger

sudo systemctl activer homebridge

sudo systemctl démarrer homebridge

Pour redémarrer le système, tapez la commande ci-dessous et appuyez sur Entrée:

redémarrage sudo

Après le redémarrage du système, ouvrez à nouveau le terminal, tapez la commande ci-dessous et appuyez sur Entrée pour vérifier si le service est déjà en cours d'exécution:

statut systemctl homebridge

Si tout va bien, le service sera en cours d'exécution et vous pouvez voir écrit "actif (en cours d'exécution)" et en dessous le code à huit chiffres qui a été précédemment entré dans config.json.

Appuyez sur les touches CTRL + C du terminal. Tapez la commande ci-dessous et appuyez sur Entrée pour vérifier le journal des informations enregistrées:

journalctl -f -u homebridge

Appuyez sur les touches CTRL + C du terminal.

Étape 5: Installation du plugin Homebridge Config UI X (Raspberry Pi)

Pour démontrer l'installation d'un plugin sur Homebridge j'ai choisi d'utiliser Homebridge Config UI X. Ce plugin permet via un navigateur de pouvoir configurer, surveiller, sauvegarder et redémarrer Homebridge.

Pour installer le plugin, tapez la commande ci-dessous dans le terminal, entrez, confirmez la commande si vous y êtes invité et attendez la fin de l'installation:

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

Tapez la commande ci-dessous sur le terminal et appuyez sur Entrée. Un fichier s'ouvrira:

sudo nano /etc/sudoers

À l'aide de la flèche vers le bas du clavier ou en roulant la souris, faites défiler jusqu'à la fin du fichier et ajoutez la ligne suivante:

homebridge ALL=(ALL) NOPASSWD: ALL

Pour enregistrer le fichier, appuyez sur CTRL + O, puis sur CTRL + X pour fermer le fichier.

Tapez la commande ci-dessous sur le terminal et appuyez sur Entrée. Un fichier s'ouvrira:

sudo nano /etc/default/homebridge

A l'aide des touches fléchées, faites défiler jusqu'à la fin de la ligne HOMEBRIDGE_OPTS=-U /var/homebridge, donnez un espace et insérez:

-JE

Pour enregistrer le fichier, appuyez sur CTRL + O, puis sur CTRL + X pour fermer le fichier.

Vous devrez maintenant éditer config.json et ajouter les informations du plugin ajoutées à Homebridge.

Si vous avez effectué l'étape 4 pour que Homebridge s'exécute immédiatement après le démarrage de Raspbian, tapez la commande ci-dessous et appuyez sur Entrée:

sudo nano /var/homebridge/config.json

Si vous n'avez pas lancé Homebridge avec Raspbian, tapez la commande ci-dessous et appuyez sur Entrée:

sudo nano ~/.homebridge/config.json

Le config.json s'ouvrira:

Au sein de la structure « plate-forme », tous les plugins en cours d'installation sur Homebridge doivent être informés.

Pour Homebridge Config UI X, vous devez ajouter l'extrait de code suivant qui se trouve dans le fichier ci-dessous. Téléchargez-le, ouvrez-le, copiez le contenu et collez-le dans le fichier qui est ouvert sur le terminal:

fichier04

À l'aide des touches fléchées, accédez à « plates-formes » et entrez l'extrait de code que vous avez copié à partir du fichier. Dans l'image ci-dessous, vous pouvez voir à quoi ressemblera la structure des « plates-formes » après avoir ajouté les informations:

Si vous souhaitez valider la structure de votre code après édition, il vous suffit de vous rendre sur le site JSONLint, de coller tout le code config.json, de cliquer sur "Valider JSON" et si tout est OK le message "Valid JSON" sera renvoyé. Si votre code contient une erreur, il pointera vers la ligne avec l'erreur et renverra un message décrivant l'erreur:

jsonlint.com/

Pour enregistrer le fichier, appuyez sur CTRL + O, puis sur CTRL + X pour fermer le fichier.

Redémarrez le système en tapant la commande ci-dessous, appuyez sur Entrée et attendez le redémarrage:

redémarrage sudo

Pour ouvrir Homebridge Config UI X via le navigateur directement dans Raspberry Pi, vous devez accéder à l'adresse:

localhost:8080/

Si vous souhaitez ouvrir Homebridge Config UI X dans un navigateur à partir d'un autre ordinateur connecté sur le même réseau que la carte, remplacez simplement le mot localhost de l'adresse ci-dessus par l'adresse IP de votre Raspberry Pi. Pour vérifier l'IP attribuée à votre Raspberry Pi, accédez simplement au terminal, saisissez la commande ci-dessous et saisissez:

ifconfig

L'adresse IP attribuée à votre Raspberry Pi commence probablement par « 192.168… ».

Dans mon cas, la carte est IP 192.168.2.129, il suffit donc d'accéder à l'URL sous n'importe quel ordinateur de mon réseau:

192.168.2.129:8080/

Une page similaire à l'image ci-dessous s'ouvrira et vous serez invité à entrer un identifiant et un mot de passe. Pour le login et le mot de passe, tapez admin et entrez pour accéder:

Veuillez noter que sur la page d'accueil est affiché le code QR et en dessous le code PIN à 8 chiffres qui peut être utilisé pour relier Homebridge à l'application Home. Dans l'option "Config" de l'outil, vous pouvez accéder à config.json, éditer si besoin puis enregistrer.

Parcourez les fonctionnalités disponibles dans Homebridge Config UI X et familiarisez-vous avec l'outil.

Pour arrêter l'exécution de Homebridge vous pouvez utiliser la commande ci-dessous dans le terminal:

arrêt du service sudo homebridge

Pour redémarrer Homebridge, vous pouvez utiliser la commande ci-dessous:

redémarrage du service sudo homebridge

Pour démarrer l'exécution de Homebridge, vous pouvez utiliser la commande ci-dessous:

démarrage du service sudo homebridge

Avec le serveur en cours d'exécution, passez à l'étape 9 pour continuer à lier Homebridge à l'application Home sur votre appareil Apple.

Étape 6: Installation de Homebridge sous Windows

Si vous ne disposez pas d'un Raspberry Pi ou d'une autre plate-forme embarquée pouvant exécuter Homebridge, vous pouvez laisser votre serveur fonctionner sous Windows.

Vous devrez installer NodeJS et un éditeur de texte alternatif au Bloc-notes Windows.

Téléchargez NodeJS à partir de l'un des liens ci-dessous, puis installez-le:

nodejs.org/en/download/

Lors de l'installation cochez la case qui vous permet d'installer automatiquement les outils nécessaires:

NodeJS n'est pas un programme d'interface graphique, donc toutes les actions sont effectuées dessus à partir d'une invite de commande.

Téléchargez Notepad ++ à partir de l'un des liens ci-dessous, puis installez-le:

notepad-plus-plus.org/downloads/

Dans le menu des options de Windows, lorsque vous cliquez avec le bouton droit sur un fichier, l'option "Modifier avec le bloc-notes ++" apparaîtra et vous pouvez sélectionner cette option chaque fois que vous devez modifier un fichier texte ou un fichier Homebridge.

Allez dans le menu "Démarrer" de Windows, tapez et recherchez "Paramètres" et une fois trouvé, accédez à l'option. Cliquez sur "Réseau et Internet", puis sur "Centre Réseau et partage". Sous "Type d'accès", cliquez sur votre connexion active, cliquez sur "Détails" et copiez l'adresse MAC à huit chiffres de votre carte réseau et enregistrez-la dans le bloc-notes, car cette adresse sera requise plus tard:

Dans le menu "Démarrer" de Windows, tapez et recherchez "cmd" (Invite de commandes) et lorsque vous le trouvez, faites un clic droit dessus et sélectionnez "Exécuter en tant qu'administrateur":

Avec le terminal ouvert, tapez chacune des commandes ci-dessous et appuyez sur Entrée après chacune pour confirmer que l'installation de NodeJS / NPM a réussi. Ces commandes renvoient la version de chacun des packages installés:

nœud -v

npm -v

Une fois ces procédures terminées, nous pouvons installer le Homebridge. Entrez la commande ci-dessous, entrez et attendez la fin de l'installation:

npm install -g --unsafe-perm homebridge

Tapez ensuite la commande ci-dessous et appuyez sur Entrée pour démarrer Homebridge:

pont

Homebridge renverra quelques informations:

1) Le fichier config.json n'a pas été trouvé par Homebridge. Ce fichier fournit les paramètres de base pour exécuter Homebridge et tous les plugins installés. Plus tard, nous créerons le fichier config.json et ses paramètres.

2) Aucun plugin installé. Homebridge sans plugins installés est complètement inutile.

3) Pour lier des appareils à l'application Home, vous pouvez lire le code QR qui vous donne les informations dont vous avez besoin pour associer. Étant donné que le fichier config.json n'a pas été créé et configuré et qu'aucun plug-in n'est installé, ce code QR n'est actuellement pas bon, bien que dans l'application Home, vous puissiez déjà trouver Homebridge disponible pour la liaison, mais ce n'est pas le cas.

4) Une autre façon de lier des appareils à l'application Home consiste à utiliser l'option "Ajouter un accessoire", "Je n'ai pas de code ou je ne peux pas scanner", et sous "Accessoires à proximité", l'appareil est sélectionné et vous serez alors invité à le code de configuration. Notez que le terminal affiche le code à huit chiffres et doit être entré pour correspondre à l'application.

Appuyez sur les touches CTRL + C du terminal pour fermer Homebridge. Le message « Got SIGINT, shutdown down Homebridge… » sera renvoyé et vous serez invité à confirmer, dans lequel vous devrez taper la lettre Y et appuyer sur Entrée.

Pour créer le fichier config.json ouvrez Notepad++, cliquez sur le menu "Fichier", "Nouveau" et une nouvelle fenêtre s'ouvrira. Cliquez sur le menu "Langue", faites défiler jusqu'à la lettre J dans la liste et sélectionnez "JSON".

Téléchargez le fichier ci-dessous. Ouvrez ce fichier, copiez le contenu et collez-le dans le fichier ouvert dans Notepad ++:

fichier05

1) Dans « nom d'utilisateur » supprimez la séquence XX: XX: XX: XX: XX: XX et entrez l'adresse MAC à huit chiffres de la carte réseau que vous avez précédemment notée. Les lettres de l'adresse que vous entrez doivent être toutes en majuscules.

2) Dans « pin », vous pouvez conserver les huit chiffres numériques ou vous pouvez passer à une séquence que vous voulez, en vous rappelant de garder le même format de séparation avec les tirets. Ce sera le code que vous devrez entrer au moment où vous lierez Homebridge à l'application Home.

Les autres informations de fichier que vous pouvez conserver, au fur et à mesure que vous ajoutez des plugins et des accessoires, vous pouvez entrer les informations requises.

Cliquez sur le menu "Fichier", "Enregistrer", nommez le fichier config.json et enregistrez-le dans le chemin "C:\Users\YOUR NAME OR DOCUMENTS\.homebridge":

Fermez le Bloc-notes ++.

Étape 7: Installation du plugin Homebridge Config UI X (Windows)

Pour démontrer l'installation d'un plugin sur Homebridge j'ai choisi d'utiliser Homebridge Config UI X. Ce plugin permet via un navigateur de pouvoir configurer, surveiller, sauvegarder et redémarrer Homebridge.

Pour installer le plugin, tapez la commande ci-dessous dans le terminal, appuyez sur Entrée et attendez la fin de l'installation:

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

REMARQUE: Si lors de l'installation du plugin vous trouvez une erreur contenant les termes MSBUILD / VCBuild.exe, exécutez simplement chacune des commandes suivantes indépendamment, puis essayez de réinstaller à partir de la commande ci-dessus:

npm install -g node-gyp

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

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

Vous devrez maintenant éditer config.json et saisir les informations du plugin ajoutées à Homebridge. Accédez au chemin "C:\Users\YOUR NAME OR DOCUMENTS\.homebridge" et via Notepad ++ ouvrez config.json qui a été créé précédemment:

Au sein de la structure « plate-forme », tous les plugins en cours d'installation sur Homebridge doivent être informés.

Pour Homebridge Config UI X, vous devez ajouter l'extrait de code suivant qui se trouve dans le fichier ci-dessous. Téléchargez, ouvrez, copiez le contenu et collez-le dans le fichier ouvert dans Notepad ++:

fichier06

Allez dans "plates-formes" et entrez l'extrait de code que vous avez copié à partir du fichier. Dans l'image ci-dessous, vous pouvez voir à quoi ressemblera la structure des « plates-formes » après avoir ajouté les informations:

Si vous souhaitez valider la structure de votre code après édition, il vous suffit de vous rendre sur le site JSONLint, de coller tout le code config.json, de cliquer sur "Valider JSON" et si tout est OK le message "Valid JSON" sera renvoyé. Si votre code contient une erreur, il pointera vers la ligne avec l'erreur et renverra un message décrivant l'erreur:

jsonlint.com/

Enregistrez le fichier, fermez le Bloc-notes ++ et redémarrez Windows.

Pour ouvrir Homebridge Config UI X via le navigateur, accédez à:

localhost:8080/

Une page similaire à l'image ci-dessous s'ouvrira et vous serez invité à entrer un identifiant et un mot de passe. Pour le login et le mot de passe, tapez admin et entrez pour accéder:

Veuillez noter que sur la page d'accueil est affiché le code QR et en dessous le code PIN à 8 chiffres qui peut être utilisé pour relier Homebridge à l'application Home. Dans l'option "Config" de l'outil, vous pouvez accéder à config.json, éditer si besoin puis enregistrer.

Parcourez les fonctionnalités disponibles dans Homebridge Config UI X et familiarisez-vous avec l'outil.

Étape 8: Démarrer Homebridge avec Windows

Homebridge Config UI X fournit une commande qui peut être utilisée pour configurer Homebridge en tant que service afin que le serveur puisse être démarré avec Windows. À l'invite, tapez la commande ci-dessous, entrez et attendez la fin de l'installation:

installation du service hb

REMARQUE: si votre pare-feu Windows demande l'autorisation d'accéder au réseau privé, accordez-le

Une fois l'installation terminée, fermez l'invite de commande et redémarrez Windows.

Une fois le système démarré, appuyez sur CTRL + ALT + SUPPR pour ouvrir le Gestionnaire des tâches de Windows. Allez dans l'onglet "Services", recherchez Homebridge dans la liste et voyez si "Status" est "En cours d'exécution":

Un clic droit sur le service Homebridge ouvrira les options où vous pouvez arrêter le service, redémarrer et si le service est arrêté, vous pouvez démarrer:

Si vous souhaitez supprimer Homebridge du démarrage de Windows, entrez simplement la commande ci-dessous, entrez et attendez la fin de la désinstallation:

désinstallation du service hb

REMARQUE: selon l'antivirus que vous utilisez, vous pouvez avoir des difficultés à trouver Homebridge à partir de votre appareil mobile. À des fins de test, lorsqu'il est temps de lier Homebridge à l'application Home, si le serveur n'est pas trouvé dans les deux minutes, désactivez votre antivirus, désactivez Windows Defender, redémarrez le service Homebridge via Windows Task Manager et réessayez de trouver le serveur depuis l'application Accueil

Étape 9: lier Homebridge à l'application Home

Les directives suivantes sont valables pour Homebridge fonctionnant sur Raspberry Pi et Windows. Assurez-vous que le serveur est en cours d'exécution car l'application Home ne trouvera Homebridge que s'il est en ligne.

J'ai utilisé un iPhone 8 Plus pour ce post, donc à partir de là, les étapes seront basées sur iOS. Pour les autres appareils compatibles Apple Homekit, je vous suggère de consulter les menus pour les options suivantes.

Accédez à l'écran d'accueil de votre iPhone et recherchez l'application Accueil dans les applications. Si vous ne le trouvez pas, rendez-vous sur l'App Store et installez l'application:

Avec l'application Home ouverte, cliquez sur « Ajouter un accessoire »:

Sur l'écran qui s'ouvre, cliquez sur « Je n'ai pas de code ou je ne peux pas scanner ? »:

Dans « Accessoires à proximité », vous verrez le Homebridge. Cliquez dessus pour ouvrir l'écran d'appairage:

Un message s'ouvrira et vous devrez cliquer sur « Ajouter quand même »:

Vous serez invité à saisir le « Code de configuration Homebridge ». Remplissez le code (PIN) que vous avez défini dans config.json et attendez:

Si tout se passe bien, vous verrez un écran indiquant que Homebridge a été ajouté et est prêt à l'emploi:

REMARQUE: si vous recevez un message indiquant que le code n'a pas été accepté ou n'a pas pu être ajouté, fermez l'application Home, redémarrez Homebridge et réessayez les étapes

Sur l'écran suivant, vous verrez le message « Configuration supplémentaire requise » car il n'y a pas encore de périphérique Homebridge. Cliquez sur TERMINÉ et l'application reviendra à l'écran d'accueil:

Sur l'écran d'accueil, cliquez sur le symbole d'une maison, sur l'écran suivant, cliquez sur "Hubs & Bridges", cliquez sur le Homebridge nouvellement ajouté et vous verrez des informations, et SI vous devez plus tard supprimer le lien Homebridge, cliquez simplement sur " Supprimer le pont de la maison »:

Si vous supprimez Homebridge de l'application Home et souhaitez l'ajouter à nouveau, vous devrez supprimer les dossiers « accessoires » et « persistance » du serveur.

Dans Raspberry Pi:

Terminez Homebridge en tapant la commande ci-dessous dans le terminal et en appuyant sur Entrée:

arrêt du service sudo homebridge

Si vous avez effectué l'étape 4 pour que Homebridge s'exécute immédiatement après le démarrage de Raspbian, tapez la commande ci-dessous et appuyez sur Entrée:

cd /var/homebridge

Si vous n'avez pas lancé Homebridge avec Raspbian, tapez la commande ci-dessous et appuyez sur Entrée:

cd.homebridge/

Tapez chacune des commandes ci-dessous et appuyez sur Entrée après chacune pour supprimer les dossiers « accessoires » et « persistance »:

sudo rm -r persister/

sudo rm -r accessoires/

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

démarrage du service sudo homebridge

Répétez les étapes pour lier Homebridge à l'application Home.

Sous Windows:

Arrêtez le service Homebridge via le Gestionnaire des tâches de Windows, accédez au chemin « C:\Utilisateurs\VOTRE NOM OU DOCUMENTS\.homebridge », et supprimez les dossiers « accessoires » et« persistance. Démarrez le service Homebridge via le Gestionnaire des tâches de Windows.

Répétez les étapes pour lier Homebridge à l'application Home.

Il est important de noter que tout appareil intégré à l'application Home est alimenté localement. Pour pouvoir contrôler les appareils de l'application Home via un réseau externe (connexion 3G/4G, par exemple), vous devrez configurer un hub d'automatisation depuis l'un des appareils Apple suivants: iPad (sous iOS 10 ou supérieur), Apple TV (4e génération) ou HomePod. De cette façon, même loin de chez vous, vous pourrez contrôler à distance vos appareils d'automatisation et IoT intégrés à l'application Home via Homebridge ou Homekit.

En reliant Homebridge à l'application Completed Home, vous pouvez explorer les fonctions de cet excellent outil. Dans le lien ci-dessous, vous pouvez voir la liste des plugins disponibles pour une utilisation avec Homebridge et en cliquant sur chacun, vous pouvez voir leurs informations et comment installer:

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

Si vous possédez un appareil IoT ou domotique et que vous souhaitez l'intégrer à Homebridge, recherchez simplement s'il existe un plugin déjà créé qui vous permettra d'utiliser cet appareil dans l'application Home.

Étant donné que l'utilisateur root n'est pas activé sur Raspbian, pour les installations de plug-in, n'oubliez pas d'utiliser le mot sudo avant la commande d'installation du terminal. Si vous n'utilisez pas sudo, le système vous demandera toujours d'entrer le mot de passe système pour effectuer l'action ou vous pouvez renvoyer un message indiquant que vous n'avez pas l'autorisation.

Sous Windows, l'invite de commande doit s'exécuter en tant qu'administrateur pour pouvoir exécuter les lignes de commande, et vous ne devez pas utiliser le mot sudo car il ne sera pas reconnu par le système.

Chaque fois que vous installez un plugin, assurez-vous d'ajouter ses informations dans config.json et redémarrez Homebridge afin que l'application Home puisse être mise à jour avec les informations des plugins ajoutés. De même, chaque fois que vous désinstallez un plugin Homebridge, assurez-vous de supprimer les informations config.json du plugin, car si vous ne supprimez pas le serveur, vous pourriez avoir des problèmes de démarrage.

Voici quelques liens qui peuvent être utiles pour trouver plus d'informations sur Homebridge et Homekit:

homebridge.io/

github.com/nfarina/homebridge

support.apple.com/pt-br/HT204893

Si vous avez des appareils Sonoff et que vous souhaitez les utiliser avec l'application Home et Siri, je vous recommande de lire l'instruction Intégrer Sonoff avec l'application Home (Apple IPhone IOS).