Telecommande universelle
L'objectif est de transformer leukOS en passerelle de commande pour les appareils deja pilotes par une telecommande physique: climatiseur, television, amplificateur, decodeur, ventilateur ou rideau motorise.
Le principe n'est pas de modifier l'appareil cible. Le boitier leukOS apprend le signal emis par la telecommande d'origine, le stocke comme une commande domotique, puis le rejoue avec un emetteur infrarouge ou radio compatible.
Principe general
Le prototype fonctionne en deux modes:
- apprentissage: le boitier capture un signal emis par la telecommande originale ;
- commande: leukOS rejoue le signal capture quand une scene, un planning ou une action utilisateur demande l'allumage, l'extinction ou le changement de mode.
Cas climatiseur
Les climatiseurs sont un bon premier cas de prototypage, car beaucoup de modeles utilisent une telecommande infrarouge. Une commande ne represente pas seulement un bouton: elle encode souvent l'etat complet de l'appareil.
Exemple pour une commande cool_24_auto:
{
"device_id": "salon-ac",
"protocol": "ir",
"carrier_khz": 38,
"command": "cool_24_auto",
"state": {
"power": "on",
"mode": "cool",
"temperature_c": 24,
"fan": "auto",
"swing": "off"
},
"raw_signal": "base64-or-pulse-list"
}
Le hub peut ensuite exposer des actions lisibles: allumer, eteindre, mode froid,
24 degres, ventilation auto. La couche basse conserve le signal exact a rejouer.
Capture et rejeu
Le device de prototypage doit embarquer au minimum:
| Bloc | Role |
|---|---|
| Recepteur IR 38 kHz | Lire les telecommandes infrarouges classiques. |
| LED IR haute puissance | Rejouer le signal vers l'appareil cible. |
| Microcontroleur | Mesurer les impulsions avec un timing stable. |
| Liaison leukOS | UART, USB, Wi-Fi ou MQTT selon l'integration. |
| Stockage local | Garder les profils appris et les commandes associees. |
Pour les appareils RF, le principe est similaire, mais il faut ajouter un module radio adapte au pays et a la frequence utilisee, par exemple 315 MHz, 433 MHz ou 868 MHz. La partie RF est plus sensible: certains equipements utilisent des codes tournants ou des protocoles securises qui ne doivent pas etre clones.
Integration domotique
Dans leukOS, chaque commande apprise devient une entite pilotable:
La confirmation indique que le signal a ete emis. Pour connaitre l'etat reel de l'appareil, il faut ajouter une mesure de retour: temperature ambiante, consommation, capteur d'etat, ou integration reseau native quand elle existe.
Exemples du marche
Ces produits illustrent les formes deja presentes sur le marche. Ils servent de reference visuelle et fonctionnelle pour cadrer le prototype leukOS; ils ne sont pas des dependances du projet.

Sensibo Air: exemple de controleur infrarouge specialise climatiseur. La page constructeur montre un boitier compact qui pilote un climatiseur par IR via Wi-Fi.
| Exemple | Famille | Ce que le prototype leukOS doit retenir |
|---|---|---|
| Sensibo Air | Controleur IR climatiseur | Interface simple, profils AC, commandes de temperature/mode/fan. |
| BroadLink RM4 Pro | Hub IR + RF universel | Couverture IR large et RF pour certains appareils domestiques. |
| SwitchBot Hub Mini | Hub IR grand public | Apprentissage de telecommandes et pilotage via application. |
| Tuya / Smart Life IR blaster | Modules OEM IR Wi-Fi | Format economique, integration cloud/app, logique de profils. |
Conception
La fabrication leukOS peut demarrer avec des modules electroniques du marche, puis evoluer vers un PCB dedie une fois les protocoles et les puissances valides. L'objectif est de separer trois fonctions: calcul/connexion, apprentissage du signal, puis emission du signal.
Prototype IR simple
Cette version couvre la majorite des telecommandes TV, climatiseurs, decodeurs et ventilateurs infrarouges.

Carte ESP32: base simple pour Wi-Fi, MQTT, apprentissage local et pilotage des modules IR/RF.

Recepteur IR 38 kHz: permet de capturer les impulsions emises par une telecommande classique.

LED IR 940 nm: composant d'emission. Pour une portee correcte, elle doit etre pilotee par transistor ou MOSFET, pas directement depuis un GPIO.
Variante IR + radio
Pour couvrir certains ventilateurs, prises, stores ou modules sans fil simples, on peut ajouter un transceiver radio. Cette partie doit rester limitee aux appareils non securitaires et aux frequences autorisees localement.

Module radio type RFM69HCW: utile pour tester des architectures RF controlees avec SPI, antenne externe et puissance reglable. Pour 433 MHz, choisir la variante adaptee au pays.
Retour d'etat optionnel
Le rejeu IR/RF confirme que le signal a ete envoye, mais pas que l'appareil a vraiment change d'etat. Pour un climatiseur, un capteur de temperature donne un retour simple et utile.

Capteur temperature I2C: retour d'etat indirect pour valider qu'une commande climatiseur produit bien un effet mesurable dans la piece.
Nomenclature de depart
| Composant | Exemple de module | Role dans le prototype |
|---|---|---|
| Microcontroleur | ESP32 DevKit / Feather ESP32 | Wi-Fi, MQTT, stockage local, timing d'acquisition. |
| Recepteur IR | TSOP38238 ou equivalent 38 kHz | Capture des signaux IR de telecommande. |
| Emetteur IR | LED IR 940 nm + transistor/MOSFET | Rejeu des signaux vers TV, climatiseur, decodeur. |
| Radio optionnelle | RFM69, CC1101 ou module 433 MHz adapte | Tests RF pour appareils simples non securitaires. |
| Antenne | Fil quart d'onde, uFL ou SMA selon module | Stabilite et portee radio. |
| Capteur optionnel | Temperature, humidite, consommation | Confirmation indirecte de l'etat reel. |
| Alimentation | 5 V USB ou buck 24 V -> 5 V | Integration atelier/armoire leukOS. |
Passage vers un PCB leukOS
Le prototype sur modules sert a figer le cablage et le firmware. Le PCB final peut ensuite integrer:
- ESP32 ou microcontroleur equivalent ;
- recepteur IR place en facade ;
- plusieurs LED IR orientees pour couvrir une piece ;
- driver transistor/MOSFET pour impulsions IR plus puissantes ;
- emplacement radio optionnel, avec antenne correctement degagee ;
- connecteur UART ou USB de diagnostic ;
- alimentation protegee, regulateur 3,3 V et filtrage ;
- bouton local d'apprentissage et LED d'etat.
Le firmware expose ensuite des commandes simples au hub: learn, test, send, list,
delete. La logique domotique reste cote leukOS: pieces, scenes, horaires, permissions et
journalisation.
Limites et securite
Le prototype doit rester limite aux appareils possedes ou explicitement autorises. Il ne doit pas etre utilise pour cloner des badges, alarmes, serrures, portails, garages ou tout equipement avec code tournant ou fonction de securite.
Contraintes importantes:
- ne pas apprendre ni rejouer de signaux d'acces ou d'alarme ;
- marquer chaque commande avec sa piece, son appareil et son usage ;
- garder les signaux localement si possible, sans exposition publique ;
- journaliser les commandes envoyees par le hub ;
- prevoir une limitation de frequence pour eviter les repetitions accidentelles ;
- confirmer a l'utilisateur que le retour d'etat est estime tant qu'aucun capteur ne mesure l'etat reel.
Prototype leukOS cible
Une premiere version peut se limiter a l'infrarouge:
| Etape | Resultat attendu |
|---|---|
| Detection | Le device confirme qu'un recepteur IR est present. |
| Apprentissage | L'utilisateur choisit un bouton, appuie sur la telecommande, puis nomme la commande. |
| Test | leukOS rejoue immediatement le signal pour valider la capture. |
| Association | La commande est liee a un appareil domotique et a une piece. |
| Automatisation | Les scenes et plannings peuvent appeler la commande. |
La version suivante peut ajouter RF, profils par marque, export/import de profils et retour d'etat par capteur de temperature ou mesure de consommation.