Relais et actionneurs

Les relais sont le premier niveau de commande physique de leukOS. Ils permettent de piloter un eclairage, une pompe, une electrovanne, un ventilateur, un contacteur ou une alimentation de charge a partir d'une commande domotique.

Le principe est simple: leukOS ne commande pas directement la charge depuis l'interface. Le hub valide l'action, le node transmet l'ordre au controleur, puis le controleur active une sortie isolee et remonte son etat.

Principe general

Chaque sortie doit etre modelisee comme une entite domotique: nom, piece, type de charge, etat attendu, securite et duree maximale d'activation.

Cas d'usage

Usage	Exemple	Point d'attention
Eclairage	Lampe, circuit LED, zone commune	Eviter les basculements trop frequents.
Eau	Pompe, electrovanne, arrosage	Toujours definir une fermeture automatique.
Ventilation	Extracteur, ventilateur	Prevoir hystereses et seuils capteurs.
Energie	Contacteur, prise commandee	Dimensionnement courant/tension obligatoire.
Securite atelier	Arret machine non critique	Ne pas remplacer un arret d'urgence certifie.

Exemples du marche

Carte relais multicanal: format courant pour prototyper rapidement des sorties tout-ou-rien.

Exemple d'integration mecanique: la logique basse tension reste separee de la partie puissance.

Exemple	Famille	Ce que le prototype leukOS doit retenir
Module relais 1 canal	Sortie simple	Ideal pour valider une lampe, une pompe ou une serrure non critique.
Module relais 4/8 canaux	Sorties groupees	Utile pour pieces, arrosage, tableaux de test et maquettes.
SSR AC	Relais statique	Silence et endurance, mais chauffe et fuite residuelle a prendre en compte.
Contacteur rail DIN	Charge forte	Le microcontroleur pilote la bobine, pas la charge directement.
MOSFET DC	Variation ou PWM	LED, moteur DC, electrovanne basse tension avec diode de roue libre.

Conception

La fabrication peut commencer avec un ESP32 et un module relais standard. Cette approche permet de tester rapidement le firmware, les messages MQTT et les protections logicielles avant un PCB leukOS dedie.

Prototype relais IP

ESP32: controleur Wi-Fi pour transformer une carte relais en device domotique leukOS.

Prototype cable au node

Pour un boitier proche du node, une liaison serie est plus deterministe que le Wi-Fi. Le daemon leukOS envoie une commande au microcontroleur, qui active le relais localement.

Nomenclature de depart

Composant	Exemple de module	Role
Microcontroleur	ESP32, RP2040, ATmega2560	Logique locale et protocole de commande.
Carte relais	1, 4 ou 8 canaux avec optocoupleurs	Commutation tout-ou-rien.
Driver DC	MOSFET logique + diode de roue libre	Vannes, moteurs DC, rubans LED.
Alimentation	5 V logique + 12/24 V charge	Separation propre des rails.
Protection	Fusible, TVS, bornier, boitier	Robustesse et securite electrique.
Mesure optionnelle	Capteur courant, entree retour	Verification de l'effet reel de la commande.

Passage vers un PCB leukOS

Le PCB final doit integrer les protections des sorties, les borniers, les distances d'isolement et un mode de test local. Les relais de puissance doivent etre dimensionnes selon la tension, le courant, le type de charge et les normes du site.

Points a figer avant fabrication:

• nombre de sorties et courant maximum par canal ;
• tension de bobine ou tension de commande ;
• logique active haut/bas et etat par defaut au boot ;
• comportement apres perte reseau ;
• timeout de securite pour vannes, pompes et moteurs ;
• journalisation de chaque action envoyee par leukOS.

Securite

Un relais domotique ne remplace pas une protection electrique ni un arret d'urgence. Les charges secteur ou industrielles doivent rester dans un coffret adapte avec disjoncteur, fusible, terre, separation basse tension/puissance et bornes correctement serrees.

Regles minimales:

• couper par defaut en cas de crash firmware ;
• utiliser un etat fail-safe pour les vannes et pompes ;
• ne jamais commander une charge secteur depuis un breadboard ;
• isoler les GPIO de la puissance ;
• documenter chaque sortie dans la configuration du node.