Domotique — Fonctionnement
La domotique leukOS relie les équipements d'une habitation à un hub local installé sur la box. Chaque zone regroupe ses capteurs et actionneurs, tandis que le hub Go centralise leurs états, exécute les automatisations et expose l'API utilisée par la Web IHM Vue.js.
1. Organisation globale de l'habitation
Zones de sécurité et pièces de vie reliées à la box leukOS. Cliquer pour ouvrir le schéma en pleine résolution.
L'installation est découpée en zones fonctionnelles : sécurité, pièces de vie, équipements techniques et extérieur. Chaque zone peut contenir plusieurs contrôleurs et devices, mais tous restent rattachés à la même box leukOS.
- La box héberge le broker MQTT, le hub Go, les bases SQLite et la Web IHM.
- Les pièces regroupent les équipements sous des identifiants et des entités stables.
- Les capteurs remontent des mesures ou des événements.
- Les actionneurs reçoivent des commandes et republient leur état effectif.
- Le mobile ou navigateur accède à l'interface Vue.js sans parler directement au matériel.
Cette organisation permet de piloter localement la maison même lorsque la connexion au central ou à Internet est indisponible.
2. Réseau des contrôleurs et des PCB
Réseau local entre la box, les contrôleurs de zone et leurs équipements. Cliquer pour afficher tous les détails.
Les PCB de contrôle forment la passerelle entre le réseau local et les équipements physiques. Lorsqu'un contrôleur compatible apparaît, leukOS l'intègre selon un parcours maîtrisé :
- le contrôleur démarre et obtient sa configuration réseau ;
- il annonce sa présence à la box ;
- son identité est vérifiée avant son activation ;
- il est affecté à une pièce ou à une zone ;
- ses entités sont publiées sur MQTT et enregistrées par le hub ;
- son état de connexion devient visible dans la supervision locale.
Le broker MQTT distribue ensuite les états et les commandes sans coupler directement la Web IHM à chaque carte. Un contrôleur temporairement absent est signalé indisponible sans bloquer les autres zones.
3. Relation entre PCB et devices
Raccordement logique des devices à leur PCB de contrôle. Cliquer pour consulter le schéma complet.
Le PCB adapte les signaux du terrain au modèle d'entités de leukOS. Selon l'équipement, il lit une entrée, mesure une valeur ou pilote une sortie. Le hub ne manipule donc pas un port électrique brut : il manipule une entité nommée et rattachée à une pièce.
| Type | Exemples | Rôle dans leukOS |
|---|---|---|
| Capteur | présence, température, compteur, contact | Produit une mesure ou un événement. |
| Actionneur | relais, éclairage, vanne, moteur | Exécute une commande et retourne son état. |
| Contrôleur | ESP32 ou carte MCU | Dialogue avec les devices et publie leurs entités. |
| PCB d'interface | entrées, sorties, alimentation, protection | Adapte et sécurise la liaison avec le terrain. |
La séparation entre device, contrôleur et hub facilite le remplacement d'un composant : la logique d'automatisation reste attachée à l'entité fonctionnelle, pas au câblage de l'interface web.
4. Cycle complet d'une commande
Le hub persiste le nouvel état, émet les événements associés et évalue les automatisations susceptibles d'être déclenchées. La même chaîne fonctionne pour une action utilisateur, une règle horaire ou un changement provenant d'un capteur.
Principes de fonctionnement
- Local-first : le pilotage essentiel reste disponible sans Internet.
- Découplage : l'interface, le hub et le matériel communiquent par API et messages.
- État observable : chaque commande produit un retour d'état exploitable par l'IHM.
- Isolation des pannes : un contrôleur indisponible n'arrête pas les autres zones.
- Extensibilité : de nouveaux devices peuvent rejoindre le système sous forme d'entités et de plugins.