Mais c'est si simple !
Nous passons ici en revue les étapes de la construction, de la configuration et de l'intégration d'un émetteur/récepteur RF 433.92 MHz pour Home Assistant. La plateforme OpenMQTT offre la possibilité de créer d'autres passerelles (LoRa, Bluetooth, …), mais nous nous limitons ici à l'option RF.
Ce descriptif ne remplace pas la documentation officielle qui sert de base à ce document.
GitHub original: OpenMQTTGateway
Crédits: 1technophile
Les options choisies pour les émetteur/récepteur sont :
- Émetteur : STX822
- Récepteur : SRX822
- Récepteur : Wemos D1 mini
Il existe des kits avec le STX822 et le SRX822 sur Banggood et sur Aliexpress. Bastelgarage.ch offre aussi des composants similaires à un prix très attractif.
Avec les composants choisis ci-dessus, la passerelle fonctionne en 433.92 MHz, ce qui couvre une grande plage d'accessoires RF. Pour les stores Somfy, il faut une passerelle 433.42 MHz. Le module émetteur/récepteur CC1101 décrit dans la documentation officielle couvre les deux plages et pourrait être une meilleure option, mais elle n'a été pas testée.
Les composants RTX822 et STX822 ne sont pas exactement les bons sur le schéma, mais vous comprendrez avec l'aide du tableau ci-dessous.
| Composants | Connexions | |||
|---|---|---|---|---|
| Wemos D1 mini | 5V | G | D1 | D2 |
| SRX822 | VCC | GND | CS | |
| STX822 | VCC | GND | DATA |
L'option 3 du mode de configuration est choisie, avec l'aide du logiciel Arduino IDE, c'est l'option qui offre la plus grande flexibilité de configuration.
Les 2 fichiers (User_config.h et config_RF.h) dont la modification est décrite ci-dessous sont disponibles déjà modifiés dans le dossier "main" de ce projet.
- Assurez-vous d'avoir la dernière version de Arduino IDE avec la libraire ESP8266 (ou ESP32 en fonction de l'ESP choisi) (tutoriel).
- Télécharger la librairie spécifique à ce projet (RF avec Wemos D1 mini): nodemcuv2-rf-librairies.zip (Vous trouvez ici le lien pour la liste de toutes les autres librairies au cas où vous souhaitez partir sur d'autres composants ou pour créer un autre type de passerelle : lien)
- A l'intérieur du dossier décompressé, il y a 6 dossiers qu'il faut déplacer individuellement dans le dossier de vos librairies Arduino (exemple : Users/xxxx/Documents/Arduino/libraries)
- Télécharger les fichiers de programmation depuis GitHub (Cliquer sur le bouton vert « Code » pour accéder au fichier .zip) : https://github.com/1technophile/OpenMQTTGateway
- Décompresser ce dossier où vous souhaitez conserver l'ensemble des documents relatifs à ce projet.
- Éditer le fichier User_config.h qui se trouve dans le dossier OpenMQTTGateway/main. Enlever les 2 caractères de commentaire "//" en début des lignes suivantes pour obtenir :
Pour la configuration du module RF :
- ligne 292 : #define ZgatewayRF "RF"//ESP8266, Arduino, ESP32
Pour la découverte automatique des modules dans HA:
- ligne 316 : #define ZmqttDiscovery "HADiscovery"//ESP8266, Arduino, ESP32, Sonoff RF Bridge - Éditer le fichier config_RF.h qui se trouve dans le dossier OpenMQTTGateway/main. C'est ici que nos indiquons les connexions correspondantes à notre schéma de branchement :
- ligne 127 : # define RF_RECEIVER_GPIO 4
- ligne 139 : # define RF_EMITTER_GPIO 5 - Avec l'application Arduino IDE, ouvrir le fichier main.ino qui se trouve dans le dossier OpenMQTTGateway/main.
- Dans le menu Tools/Board, choisir « LOLIN (WEMOS) D1 mini »
- Dans le menu Tools/Port, choisir le port USB sur lequel est branché votre ESP
- Uploader votre code.
Depuis un smartphone, se connecter au WiFi créé par l'ESP : OpenMQTTGateway
Un page web va s'ouvrir. Si vous n'avez rien changé au code le mot de passe est "your_password". Il vous faudra ensuite introduire les paramètres du réseau WiFi sur lequel votre ESP doit se connecter et les paramètre de votre broker MQTT (voir documentation officielle pour la configuration).
Après redémarrage de HA votre module OpenMQTTGateway apparaîtra automatiquement dans la liste de vos devices.
Plus à suivre après les premiers essais dans HA...