Connecter Home Assistant aux appareils de la maison

Home Assistant sur blitz.cloud peut piloter les appareils de votre réseau local dès que ce réseau est connecté et que chaque appareil lui est redirigé sous un nom comme hue-bridge. Il vous faut pour cela une petite machine Linux allumée en permanence à la maison, comme un Raspberry Pi. Votre box reste fermée, donc cela marche aussi derrière un CGNAT.

Ce qu'il vous faut

• Home Assistant, installé depuis l'App Store.
• Une machine Linux sur votre réseau local qui tourne en permanence : un Raspberry Pi, un serveur domestique ou le boîtier où tournait Home Assistant. Elle relie votre réseau local à blitz.cloud.
• La plage de votre réseau local. Sur beaucoup de box c'est 192.168.1.0/24 ou 192.168.0.0/24. Les réglages réseau de votre box l'indiquent.

1. Connecter le réseau hébergé

Ouvrez Private network dans le tableau de bord et connectez la carte de l'app WireGuard, si ce n'est pas déjà fait. C'est le réseau WireGuard que blitz.cloud gère pour vous, décrit dans private networks (en anglais). Si vous utilisez déjà Tailscale ou votre propre WireGuard, vous pouvez prendre ce réseau et passer directement à l'étape 4 pour les appareils qui y sont connectés eux-mêmes.

2. Ajouter la machine de la maison comme appareil

1. Sur la carte WireGuard, cliquez sur Add a device et donnez-lui un nom, par exemple home.
2. Saisissez la plage de votre réseau local, comme 192.168.1.0/24, comme plage que cet appareil apporte.
3. Téléchargez le fichier de configuration. La clé qu'il contient n'est affichée qu'une fois et nous ne la conservons pas, alors enregistrez le fichier maintenant.

3. Préparer la machine de la maison

Sur la machine Linux, installez WireGuard et lancez la configuration comme service. Avec le fichier enregistré sous home.conf, sur Debian, Ubuntu ou Raspberry Pi OS :

sudo apt install wireguard
sudo cp home.conf /etc/wireguard/blitz.conf
sudo systemctl enable --now wg-quick@blitz

Sous la configuration, le tableau de bord affiche quelques lignes de plus qui permettent à la machine de transmettre le trafic aux autres appareils de votre réseau. Exécutez-les aussi. Un instant plus tard, la machine apparaît en ligne sur la page Designer.

La machine se connecte elle-même à blitz.cloud, il n'y a donc rien à régler sur votre box.

4. Trouver l'appareil

Ouvrez Designer dans le tableau de bord, sélectionnez votre réseau et cliquez sur Scan my network. L'analyse vérifie la plage de votre réseau local sur les ports qu'utilisent un pont Hue, un NAS, une caméra ou un broker MQTT, et liste ce qui répond, avec le titre de sa page web quand il y en a une. Elle ne tourne que quand vous cliquez.

Un appareil que l'analyse ne trouve pas s'ajoute à la main sur le canevas avec son adresse, par exemple 192.168.1.20.

5. Relier Home Assistant à l'appareil

1. Sur le canevas, tracez un trait de Home Assistant vers l'appareil.
2. Donnez un nom à la connexion. Home Assistant joindra l'appareil sous ce nom, gardez-le court : hue-bridge, shelly-cuisine, mqtt.
3. Choisissez les ports et, pour chacun, TCP ou UDP. Valeurs courantes :

Enregistrez. La connexion est prête quelques secondes plus tard. Seul Home Assistant peut l'utiliser ; vos autres apps ne joignent pas l'appareil, sauf si vous tracez aussi un trait depuis elles.

6. Ajouter l'appareil dans Home Assistant

Home Assistant trouve d'habitude les appareils seul, en écoutant les diffusions du réseau local. Elles ne traversent pas le tunnel, donc vous ajoutez chaque intégration à la main :

1. Dans Home Assistant, ouvrez Paramètres, Appareils et services, puis cliquez sur Ajouter une intégration.
2. Choisissez l'intégration, par exemple Philips Hue.
3. Là où elle demande un hôte ou une adresse IP, saisissez le nom de l'étape 5 : hue-bridge. Pour ESPHome et MQTT, indiquez aussi le port.

Pour le pont Hue, appuyez sur son bouton quand Home Assistant le demande. Vos lampes apparaissent ensuite comme d'habitude.

Limites

Home Assistant n'exécute ses automatisations que lorsqu'il est éveillé. Avec l'offre gratuite, une app s'endort après 30 minutes sans visite. Des automatisations qui doivent tourner jour et nuit demandent donc un Home Assistant maintenu éveillé, avec Pro ou en en faisant une app Pro.

Questions

Pourquoi Home Assistant ne trouve-t-il pas mes appareils seul ?

La découverte passe par mDNS et des diffusions similaires qui ne circulent que dans votre réseau local. Home Assistant sur blitz.cloud joint un appareil par sa redirection, sous le nom que vous lui avez donné, et c'est ce nom que vous saisissez en ajoutant l'intégration.

Home Assistant n'arrive pas à joindre l'appareil. Que vérifier ?

Vérifiez que la machine de la maison est en ligne sur la page Designer, que la redirection contient le port qu'utilise l'intégration, et que l'appareil répond à son adresse depuis un autre appareil de la maison. Si l'appareil a changé d'adresse, saisissez la nouvelle sur le canevas ; une adresse fixe réglée dans votre box l'évite.

Faut-il ouvrir un port sur ma box ?

Non. La machine de la maison se connecte elle-même à blitz.cloud, et tout passe par cette connexion.