Domotique

LoRaWAN arrive dans Home Assistant : des capteurs à des kilomètres, et son propre réseau avec ChirpStack

Avec la version 2026.11, Home Assistant parle LoRaWAN, la radio des capteurs sur pile installés loin de la maison. Ce que demande la chaîne capteur, passerelle, serveur réseau, et pourquoi ChirpStack permet de tout garder chez soi.

Une maison au bord d'un lac de montagne, au crépuscule. Une antenne sur le toit reçoit, en pointillés lumineux, les signaux de petits boîtiers posés au portail, au garage, au potager et près d'un enclos. Un câble descend vers un serveur et un tableau de bord domotique au sous-sol.
Illustration générée par IA.

Chaque maison équipée a son point mort. Le fond du jardin, l’abri, la cave, la boîte aux lettres au bout de l’allée. On y pose un capteur Zigbee, il tient deux jours, puis il disparaît du réseau. On ajoute une prise relais à mi-chemin, puis une deuxième. Et on finit par tirer un câble.

Chez moi, ce sont le portail et le garage. J’aimerais y mesurer la consommation du garage et piloter le portail, deux endroits que mes radios habituelles atteignent mal. C’est exactement le genre de cas pour lequel LoRaWAN a été inventé, et la version 2026.11 de Home Assistant, attendue le 4 novembre, le prend désormais en charge sans module complémentaire.

Une radio qui parle lentement, mais très loin

LoRa est une technique de modulation radio : une façon d’encoder des données dans une onde. LoRaWAN est le protocole construit au-dessus, celui qui dit qui parle à qui, comment les messages sont chiffrés et comment le réseau s’organise. La différence ressemble à celle qui sépare une voix (LoRa) d’une langue avec sa grammaire (LoRaWAN).

L’astuce de LoRa tient dans ses « chirps », des signaux dont la fréquence glisse d’un bout à l’autre du canal. Plus le glissement est lent, plus le récepteur arrive à extraire le message du bruit, et plus il porte loin. Ce réglage s’appelle le facteur d’étalement (spreading factor), noté de SF7 à SF12. Chaque cran supplémentaire divise le débit par deux, mais rend le récepteur plus sensible : de −123 dBm en SF7 à −137 dBm en SF12, soit un signal environ vingt-cinq fois plus faible encore compris1.

Pensez à quelqu’un qui doit se faire comprendre d’un bout à l’autre d’un stade. Il peut parler vite, et seuls les premiers rangs saisiront. Ou il peut articuler syllabe par syllabe, et le dernier rang suivra. LoRa choisit d’articuler. Le prix, c’est un débit minuscule, de l’ordre de quelques kilobits par seconde au mieux : de quoi transmettre une température, un niveau de batterie ou un état de contact, certainement pas une image.

En échange, la portée change d’échelle. The Things Network, réseau LoRaWAN communautaire, note que même une passerelle d’intérieur peut, selon l’environnement, recevoir des capteurs situés à plusieurs kilomètres. Et comme le capteur passe l’essentiel de sa vie endormi, radio coupée, une pile peut durer des années.

Cette radio, je la connais aussi par mon travail. Dans le bâtiment où je travaille, nous avons des capteurs de météo et de qualité de l’air en LoRaWAN, et bientôt un millier de capteurs d’inondation, tous de la marque Milesight. Pour un particulier, ma réponse est oui, ça vaut le coup : pour la faible consommation, et surtout pour la portée énorme.

Qui parle à qui dans un réseau LoRaWAN

Un réseau Zigbee est un maillage : chaque appareil relaie les messages de ses voisins. LoRaWAN fonctionne autrement, en « étoile d’étoiles ». Le capteur crie son message une fois, sans s’adresser à personne en particulier. Toutes les passerelles qui l’entendent le transmettent à un serveur réseau, qui jette les doublons et n’en garde qu’un. Il n’y a pas d’appairage avec une passerelle précise : si vous en ajoutez une deuxième, elle se met simplement à écouter aussi.

La chaîne LoRaWAN : le capteur émet par radio vers une ou plusieurs passerelles, qui transmettent sur le réseau de la maison au serveur réseau ChirpStack, que Home Assistant écoute par son API. Le capteursur pile, au portail La passerellesimple relais radio ChirpStackserveur réseau Home Assistantles automatismes radio LoRa réseau IP API gRPC des centaines de mètres, voire des kilomètres, puis tout le reste se passe dans le placard
La chaîne LoRaWAN avec un serveur ChirpStack hébergé chez soi. Pointillés : liaison radio LoRa. Les autres liens passent par le réseau local.

Trois pièces, donc, et c’est là que LoRaWAN demande un peu plus de réflexion qu’une clé Zigbee. La passerelle est une radio avec une antenne, reliée au réseau de la maison par Ethernet ou Wi-Fi ; elle ne comprend rien aux messages qu’elle transporte. Le serveur réseau, lui, gère les appareils, vérifie que les messages sont authentiques, choisit le débit de chaque capteur et déchiffre le tout : les échanges entre capteur et serveur sont protégés par un chiffrement AES de 128 bits2. C’est seulement au bout de cette chaîne que Home Assistant récupère les mesures.

L’analogie la plus juste est celle du facteur rural. Le capteur dépose sa lettre dans n’importe quelle boîte jaune à portée (la passerelle), le centre de tri (le serveur réseau) la remet en ordre, et Home Assistant n’a plus qu’à ouvrir son courrier.

Ce que fait Home Assistant 2026.11

La nouveauté de la 2026.11, c’est que Home Assistant sait désormais lire directement ce courrier. Le projet a découpé le travail en deux familles d’intégrations. Les intégrations de connexion savent parler à un serveur réseau : ChirpStack, ou The Things Network (y compris une instance The Things Stack hébergée chez soi). Les intégrations d’appareil savent interpréter les messages d’un modèle donné. Une intégration « LoRaWAN », chargée automatiquement, fait le lien entre les deux.

Concrètement, vous configurez la connexion à votre serveur, et dès qu’un appareil reconnu y apparaît, Home Assistant propose l’intégration correspondante dans les appareils découverts. Une nouvelle page, dans Paramètres > Connectivité, rassemble les connexions, la liste des appareils et une carte qui montre quelle passerelle entend quel capteur, et lesquels n’ont été entendus par aucune. Chaque appareil affiche la force de son signal, l’heure de son dernier message et sa batterie. Un appareil que Home Assistant ne sait pas encore interpréter apparaît quand même, avec une note sur ce qui manque.

Le comportement est pensé pour rester cohérent avec le serveur. Si la connexion tombe, les appareils passent en « indisponible », puis reviennent. Si vous supprimez un capteur dans ChirpStack, il disparaît aussi de Home Assistant. Et un même capteur entendu via deux serveurs différents apparaîtra deux fois, une par connexion.

Le catalogue, encore très court

C’est le point à garder en tête avant de commander du matériel. Au lancement, une seule intégration d’appareil existe : SenseCAP, de Seeed Studio. Elle couvre les modèles S2101 à S2107 et la station météo S2120, avec température, humidité, luminosité, CO₂, mesures de sol, météo et batterie selon les modèles. Ce sont uniquement des capteurs : la demande d’intégration ne contient aucun interrupteur ni aucune commande.

Pour mes deux usages, c’est donc un peu tôt. Ni un compteur de consommation ni un module qui actionne un portail ne sont reconnus nativement à ce jour. Pas de Milesight non plus, alors que le catalogue de profils de ChirpStack contient déjà une quinzaine de modèles de la marque (capteurs d’ambiance AM102 et AM307, série EM300, entre autres). Ce n’est pas une impasse, il existe un chemin de traverse, mais il faut savoir qu’on le prendra.

Pourquoi ChirpStack plutôt que The Things Network

The Things Network est la voie la plus simple pour démarrer : un réseau communautaire mondial, déjà en place dans beaucoup de villes, où l’on peut enregistrer ses capteurs gratuitement. Sa version gratuite a pourtant deux contreparties. Vos messages passent par des serveurs que vous ne maîtrisez pas. Et une politique d’usage équitable limite chaque capteur à 30 secondes d’émission par jour, et à 10 messages descendants (du réseau vers le capteur) par jour. Pour un thermomètre qui donne des nouvelles toutes les dix minutes, c’est confortable. Pour un portail qu’on commande plusieurs fois par jour, beaucoup moins.

ChirpStack est un serveur réseau LoRaWAN libre, que l’on installe où l’on veut. ChirpStack me tente bien : j’aime le tout auto-hébergé. Avec lui, la passerelle, le serveur et Home Assistant tiennent dans la maison, et les limites d’usage équitable disparaissent. Restent les règles radio, qui s’appliquent à tout le monde (on y revient plus bas).

L’installation la plus directe passe par Docker Compose. Le projet fournit un dépôt d’exemple, réglé par défaut pour la bande européenne EU868, qui lance ChirpStack avec ses dépendances, dont un courtier MQTT (le facteur de messages que beaucoup de domotiques utilisent déjà). La passerelle s’y raccorde par l’un des protocoles habituels du métier : l’ancien « UDP Packet Forwarder » de Semtech sur le port 1700, Basics Station sur le port 3001, ou les logiciels de ChirpStack installés sur la passerelle elle-même.

Pour les curieux : démarrer ChirpStack et le relier à Home Assistant

Le démarrage tient en trois commandes, sur la machine du homelab :

git clone https://github.com/chirpstack/chirpstack-docker.git
cd chirpstack-docker
docker compose up -d
make import-device-profiles   # importe le catalogue de profils (git et make requis)

L’interface web répond ensuite sur le port 8080, avec l’identifiant admin / admin : à changer immédiatement.

Pour que Home Assistant 2026.11 s’y connecte, la documentation de l’intégration pose quatre conditions :

  • ChirpStack en version 4 (la version 3 n’est pas prise en charge) ;
  • l’API gRPC joignable depuis Home Assistant, ce qui veut dire qu’un éventuel proxy inverse doit laisser passer ce trafic, pas seulement l’interface web ;
  • la conservation des événements d’appareil activée dans ChirpStack ;
  • une clé d’API : en lecture seule, elle suffit pour recevoir les mesures, mais envoyer des commandes demande des droits d’écriture.

Dernier détail, qui fait trébucher : chaque capteur doit utiliser un profil d’appareil lié au catalogue global de ChirpStack. C’est ce lien qui donne à Home Assistant la marque et le modèle. Un décodeur écrit à la main ne suffit pas à identifier l’appareil, même s’il décode parfaitement les mesures.

Le chemin de traverse : MQTT

Pour tout ce que Home Assistant ne reconnaît pas encore, ChirpStack offre une sortie plus ancienne et très souple. Son intégration MQTT publie chaque événement en JSON, sur un sujet de la forme application/<identifiant>/device/<DevEUI>/event/up pour les messages montants. Dans le profil d’appareil, un petit décodeur en JavaScript (fourni par le catalogue ou écrit soi-même) transforme les octets bruts en valeurs lisibles. Et dans l’autre sens, publier sur .../command/down met une commande en file d’attente pour le capteur.

Côté Home Assistant, il suffit alors de brancher l’intégration MQTT sur le même courtier et de déclarer des capteurs qui lisent ces messages. On perd la découverte automatique et la jolie page Connectivité, on gagne l’accès à n’importe quel appareil du catalogue de ChirpStack, Milesight compris. C’est une solution d’attente raisonnable, en attendant que d’autres intégrations d’appareil arrivent.

Pour les curieux : un capteur MQTT alimenté par ChirpStack

Exemple d’entité pour un compteur au garage. Les champs exacts dépendent du décodeur de l’appareil : quand un décodeur est configuré, les valeurs décodées se trouvent dans l’objet object du message.

mqtt:
  sensor:
    - name: "Garage : puissance"
      state_topic: "application/APPLICATION_ID/device/DEV_EUI/event/up"
      value_template: "{{ value_json.object.power }}"
      unit_of_measurement: "W"
      device_class: power

APPLICATION_ID est l’identifiant de l’application dans ChirpStack (pas le JoinEUI du capteur), DEV_EUI celui de l’appareil. Pour vérifier ce qui arrive avant d’écrire la moindre ligne, mosquitto_sub -t "application/APPLICATION_ID/#" -v affiche tout le trafic de l’application.

Le portail, ou le problème de la boîte aux lettres

Mesurer est facile en LoRaWAN. Commander l’est beaucoup moins, et le portail en est le bon exemple. La raison tient aux « classes » d’appareils définies par la norme.

Tous les appareils LoRaWAN savent fonctionner en classe A, la plus économe. Un appareil de classe A émet quand il le décide, puis ouvre deux brèves fenêtres d’écoute, RX1 et RX2, juste après. Le reste du temps, sa radio dort. Un message envoyé par le réseau pendant ce sommeil attend donc la prochaine émission du capteur pour être livré.

Un appareil de classe A n'écoute que pendant deux courtes fenêtres après chacune de ses émissions. Un ordre envoyé pendant qu'il dort attend son prochain message. Émissionla mesure part RX1, RX2deux brèves écoutes Sommeilradio coupée Émission suivantel'ordre est enfin livré « ouvre le portail » arrive ici… … et patiente jusque-là
Un appareil de classe A n’écoute qu’après avoir parlé. Une commande envoyée entre deux émissions attend la suivante.

C’est la boîte aux lettres qu’on ne relève qu’en partant au travail. Pour un capteur de température, aucun problème. Pour un portail qu’on veut ouvrir en arrivant devant, attendre l’émission suivante, peut-être dix minutes plus tard, n’a aucun sens.

La norme prévoit deux autres modes. La classe B ouvre des fenêtres d’écoute à intervalles réguliers, calées sur des balises de temps diffusées par les passerelles. La classe C garde sa radio en écoute presque en permanence : la latence devient très faible, mais la consommation aussi grimpe, et ces appareils sont en général alimentés sur secteur. Pour un portail, c’est sans regret : le moteur est de toute façon branché au courant, et un module de classe C peut puiser dans la même alimentation. ChirpStack sait gérer ces classes dans les profils d’appareil.

Reste le quota radio. Une commande vers le capteur est une émission de la passerelle, et la passerelle est soumise aux mêmes règles que les capteurs. Ouvrir le portail quelques fois par jour ne pose aucune difficulté ; en faire un interrupteur qu’on actionne toutes les dix secondes, si.

Ce que ça demande, honnêtement

Une passerelle, et elle a un prix. C’est la pièce qu’un réseau Zigbee n’a pas : une vraie radio LoRaWAN, à acheter en plus des capteurs. La documentation de Home Assistant n’en recommande aucune, et le choix entre modèle d’intérieur et modèle d’extérieur avec antenne déportée dépend de la distance à couvrir et des murs à traverser.

Un serveur de plus à faire vivre. ChirpStack, sa base de données et son courtier MQTT sont trois conteneurs supplémentaires à mettre à jour et à sauvegarder. Et si Home Assistant est arrêté, les mesures envoyées pendant ce temps ne sont pas rattrapées : la documentation le dit noir sur blanc.

Les règles de la bande 868 MHz. En Europe, la norme ETSI EN 300 220-2 limite le temps d’émission de chaque appareil selon la sous-bande : 1 % du temps entre 865 et 868,6 MHz, 0,1 % ou 10 % sur d’autres sous-bandes. 1 %, c’est 36 secondes d’antenne par heure, réparties entre tous les messages. Comme chaque cran de facteur d’étalement double la durée d’un message, un capteur très éloigné, réglé en SF12, épuise son quota bien plus vite qu’un voisin en SF7. C’est aussi la raison pour laquelle LoRaWAN ne remplacera jamais une radio domotique classique pour un bouton qu’on presse souvent.

Un catalogue à construire. Au lancement, seuls les capteurs SenseCAP sont reconnus nativement. Pour le reste, il faudra passer par MQTT, ou attendre de nouvelles intégrations d’appareil. L’envoi de commandes n’est par ailleurs pas encore documenté côté Home Assistant.

Une intégration toute neuve. L’intégration ChirpStack a été fusionnée le 21 octobre, une semaine avant la bêta. Quelques remarques de relecture portaient encore sur l’identification des serveurs et la stabilité des appareils en cas de suppression puis de réajout de la connexion. Rien d’alarmant, mais de quoi attendre une version corrective avant de bâtir dessus un automatisme important.

Par où commencer

Le plus sage est de commencer petit. Une passerelle, ChirpStack en conteneur sur la machine du homelab, un ou deux capteurs de température SenseCAP pour valider la chaîne de bout en bout avec l’intégration native. Une fois que la carte de la page Connectivité montre le capteur relié à sa passerelle, avec un signal confortable, on peut aller plus loin : un capteur d’un autre fabricant via MQTT, puis, quand le matériel adapté sera reconnu, une commande.

Le jour où le capteur du fond du jardin donne des nouvelles sans relais, sans câble et avec une pile qui ne bouge pas de l’hiver, on comprend pourquoi cette radio équipe depuis longtemps les compteurs d’eau, l’éclairage public et les détecteurs de fuite. La maison vient simplement de les rejoindre.

Notes

  1. Les décibels-milliwatts (dBm) mesurent une puissance sur une échelle logarithmique : 14 dB d’écart, entre −123 et −137 dBm, correspondent à un facteur d’environ 25. ↩

  2. Le serveur réseau vérifie l’intégrité des messages et le serveur d’application déchiffre leur contenu. Dans ChirpStack, les deux rôles sont assurés par le même logiciel. ↩

Pour aller plus loin

fdubeaux

Technicien son, image et réseaux le jour, bricoleur le reste du temps. Une erreur, un avis contraire ? Écrivez-moi, je corrige et je cite.