Configurer la Radio

Radio

Le module CC1101 est un émetteur-récepteur polyvalent. Cette section vous permet de l'aligner parfaitement avec vos moteurs Somfy RTS.

Tip

Utilisateurs du boîtier : > Si vous avez acheté le boîtier ESPSomfy-RTS prêt à l'emploi, la configuration est simplifiée au maximum. La radio est déjà activée et le profil GPIO est pré-réglé sur CC1101 - ESP32-D1. Votre seule étape consiste à ajuster le protocole, bit et la fréquence si nécessaire.

Protocoles et Valeurs par Défaut

Ces réglages définissent les paramètres appliqués par défaut lors de l'ajout de tout nouveau moteur (sans affecter les moteurs déjà enregistrés).

• Radio : Désactivée par défaut pour vous permettre de valider vos broches GPIO avant la mise en service.
• Protocole : Choisissez entre RTS (standard), RTW ou RTV.
• Bit : Standardisé à 56-BIT pour le RTS, option 80-BIT disponible selon vos équipements.

Caution

Utilisateurs Ethernet : Assurez-vous qu'aucune broche radio n'est partagée avec votre module Ethernet (PHY), car cela pourrait endommager physiquement les composants.

---

Assignation des GPIO

Depuis la version v2.5.0, un sélecteur de profil vous permet de choisir rapidement votre configuration de broches (pinout) vous permettant aisi de ne plus vous poser de question sur le ". Trois options sont disponibles :

1. Par défaut : (Auto-détection)

   👉 Cliquez pour voir le détail selon votre puce (S2, S3, C3, Standard)

   • ESP32 Standard (WROOM, WROVER, Devkit C/V1)

     CC1101	ESP32
     SCLK	GPIO18
     CSN	GPIO05
     MOSI	GPIO23
     MISO	GPIO19
     GDO0 (TX)	GPIO13
     GDO2 (RX)	GPIO12

   • ESP32-S2 (Mini, Devkit)

     CC1101	ESP32
     SCLK	GPIO36
     CSN	GPIO34
     MOSI	GPIO35
     MISO	GPIO37
     GDO0 (TX)	GPIO15
     GDO2 (RX)	GPIO14

   • ESP32-S3 (4 ou 8 Mo Flash)

     CC1101	ESP32
     SCLK	GPIO12
     CSN	GPIO10
     MOSI	GPIO11
     MISO	GPIO13
     GDO0 (TX)	GPIO15
     GDO2 (RX)	GPIO14

   • ESP32-C3 (Toutes versions)

     CC1101	ESP32
     SCLK	GPIO15
     CSN	GPIO14
     MOSI	GPIO16
     MISO	GPIO17
     GDO0 (TX)	GPIO13
     GDO2 (RX)	GPIO12

   C'est l'option recommandée. L'application détecte votre chipset et applique automatiquement les broches standards. Vérifiez que votre modèle d'ESP32 correspond bien aux GPIO assignés avant de câbler.

2. CC1101 - ESP32-D1 : Profil spécifique pour les cartes de type D1 Mini ESP32.

   CC1101	esp32
   SCLK	GPIO18
   CSN	GPIO05
   MOSI	GPIO23
   MISO	GPIO19
   TX	GPIO21
   RX	GPIO22

3. Définir manuellement : Choisissez cette option pour personnaliser intégralement le brochage selon vos besoins spécifiques ou si vous utilisez des broches non standards.

   

Note

• Interface SPI : Les broches SCLK, CSN, MOSI et MISO doivent correspondre exactement au câblage physique. Si le message "Radio not Initialized" persiste, vérifiez ces paramètres en priorité.
• GDO0 / GDO2 : La transmission (TX) se fait obligatoirement via GDO0. La réception (RX) peut se faire sur GDO0 ou GDO2.
• Mode Multiplexé (Conseillé) : Économisez une broche en reliant uniquement GDO0 et en configurant RX et TX sur le même numéro de GPIO. L'appareil commutera automatiquement la fonction.
• Astuce diagnostic : Si le RSSI s'agite mais qu'aucune commande n'est détectée, vos broches RX et TX sont probablement inversées.

---

Diagnostic RSSI

Le RSSI est votre indicateur de force du signal :

• Le Score : Plus il est proche de 0, plus le signal est pur (ex: -20dBm = excellent, -90dBm = limite de rupture).
• Le Compteur : Le petit nombre à côté indique le nombre de trames reçues, idéal pour tester la réactivité de vos télécommandes.

---

Réglages Fins et Calibration

Utilisez les sliders pour les ajustements globaux, ou les boutons < > pour une précision maximale. Les sélecteurs 1 10 100 permettent de définir le pas d'incrémentation.

🛠️ Comment bien accorder votre module ?

Les paramètres par défaut ne sont pas toujours optimaux pour votre environnement. Voici la procédure recommandée pour un réglage parfait :

1. Valeurs de départ : Réglez la Largeur de bande RX sur 96.96 kHz et la Déviation sur 11.43 kHz. Cliquez sur SAUVEGARDER.
2. Test de distance : Placez-vous avec une télécommande à environ 1 mètre du boîtier et appuyez sur un bouton.
3. Observez le RSSI : Le but est d'obtenir la valeur la plus proche de 0 (voir Interpréter le RSSI).
   • Un bon module (type E07-M1101D) peut descendre à -32dBm, alors qu'un module standard tournera autour de -60dBm à cette distance.

📋 Détails des paramètres

• Fréquence de Base : Standard RTS à 433.420 MHz. Si vous modifiez cette valeur, faites-le par très petits incréments. Si vous êtes perdu, revenez à 433.420 MHz et recommencez.
• Largeur de bande RX : Contrôle la quantité de fréquences écoutées.
  • Plus c'est étroit (gauche) : Filtre le bruit, mais demande une fréquence ultra-précise.
  • Plus c'est large (droite) : Capte mieux les signaux qui dérivent, mais subit plus d'interférences.
• Déviation de Fréquence : Détermine l'écart nécessaire pour valider un bit de donnée. Une valeur de 11.92 kHz est souvent le meilleur compromis entre portée et réduction du bruit.
• TX Puissance : Puissance à laquelle le boîtier "crie" vers vos volets. À 10dBm, la portée est déjà bien supérieure à une télécommande Somfy classique.

Tip

Emplacement : Ne placez jamais votre boîtier sur un micro-ondes ou à proximité immédiate d'appareils générant de fortes interférences, cela réduirait drastiquement la sensibilité de réception.

---

🔍 Balayage des Fréquences (Scan)

Si vos volets ne répondent pas ou si vous ne connaissez pas la fréquence exacte de vos télécommandes d'origine, cet outil permet de calibrer automatiquement votre module CC1101.

Procédure de détection

1. Cliquez sur le bouton BALAYER LES FRÉQUENCES. Un popup interactif s'ouvre.
2. Action : Maintenez enfoncé n'importe quel bouton de votre télécommande Somfy à environ 1 mètre du boîtier.
3. Analyse : L'ESPSomfy-RTS scanne les fréquences. Lorsqu'un pic de signal est détecté, la fréquence s'affiche (ex: 433.19 MHz) et le graphique affiche un "pic" représentant l'intensité du signal.
4. RSSI : Observez la force du signal pour confirmer la qualité (voir Interpréter le RSSI).

---

Validation du réglage

Une fois que vous avez identifié la fréquence où le signal est le plus stable :

1. Cliquez sur ARRÊTER LE BALAYAGE.
2. La valeur détectée sera automatiquement injectée dans le champ Fréquence de Base de l'onglet Radio si vous cliquez sur le bouton DÉFINIR LA FRÉQUENCE
3. Important : Cliquez sur le bouton SAUVEGARDER en bas de la page principale pour mémoriser définitivement vos réglages de fréquences.

Tip

Conseil de précision : Pour un résultat optimal, ne collez pas la télécommande contre l'antenne (cela peut saturer le récepteur). Gardez une distance d'environ 1 à 2 mètres lors du balayage.

Journaux (Logs)

L'onglet Journaux est votre outil de diagnostic en temps réel. Il permet de visualiser les trames radio reçues et de vérifier la configuration de vos télécommandes.

Description des colonnes:

• Clé : La clé d'obfuscation utilisée pour la frame. Selon le protocole, cette clé peut également contenir la valeur de commande brute. ESPSomfy RTS extrairea les données de cette clé pour les protocoles RTW et RTV afin de déterminer l'octet de commande approprié.
• Adresse: L'adresse 24 bits de la télécommande qui a envoyé la frame.
• Commandes: Le bouton qui a été enfoncé sur la télécommande. Ce sera l'une des valeurs suivantes
  • Up
  • Down
  • My
  • My+Up
  • My+Down
  • My+Up+Down
  • Up+Down
  • Prog
  • SunFlag
  • Sensor
  • Step Up
  • Step Down
• Code : Le code de roulement utilisé dans le cadre depuis la télécommande.
• RSSI : La valeur de l'indicateur de force du signal de réception (RSSI) pour la trame.
• Bits : Le nombre de bits qui ont été utilisés pour refléter la trame. Il s'agit le plus souvent de 56 ou 80 bits.
• Temps : Heure locale pour le fuseau horaire défini dans la section générale de la configuration.

Boutons

• COPIER : Copie l'intégralité du journal dans votre presse-papiers. Indispensable pour obtenir de l'aide sur le forum ou GitHub.
• EFFACER : Réinitialise la liste pour faciliter une nouvelle session de test.

Analyser les signaux entrants

Chaque pression sur une télécommande d'origine génère une ligne dans le journal. Les trames les plus récentes s'affichent toujours en haut de la liste.

Identifier le protocole (Colonne Bits)

Utilisez cette colonne pour savoir quel protocole choisir lors de l'ajout d'un nouveau moteur :

• 56-S : Protocole RTS standard (56 bits).
• 80-S : Protocole RTS étendu (80 bits).
• 56-W : Protocole RTW (souvent pour les moteurs de marque ASA).
• 56-V : Protocole RTV.

Tip

Si vous hésitez sur le type de moteur que vous possédez, observez le journal en manipulant votre télécommande d'origine : le suffixe (-S, -W, -V) vous donnera la configuration exacte à appliquer.

---

Interpréter la qualité du signal (RSSI)

Le RSSI indique la force du signal. Plus la valeur est proche de 0, meilleure est la réception.

• 🟢 -30 à -60 dBm (Excellent) : Signal très fort. Communication parfaite.
• 🟡 -70 à -85 dBm (Faible) : Signal limite. Risques de pertes de commandes.
• 🔴 > -90 dBm (Instable) : Signal trop faible ou trop de bruit parasite.

Guide de Dépannage (FAQ)

Le message "désactivé" ou l'icon radio est toujours barré par un trait rouge persiste

L'ESP32 ne parvient pas à établir la communication avec le module CC1101.

• Câblage : Vérifiez vos soudures et l'ordre des broches. Attention, les broches sont inversées (droite/gauche) lorsque vous retournez le module CC1101 pour le brancher.
• Conflit GPIO : Si vous utilisez une carte Ethernet, assurez-vous qu'aucune broche SPI n'est partagée avec le contrôleur réseau.
• Configuration : Vérifiez que les numéros de GPIO saisis dans l'onglet Radio correspondent à votre câblage physique.

Réception OK mais Émission impossible

Si les logs défilent quand vous utilisez votre télécommande, mais que l'interface ne fait pas bouger les volets :

• Inversion RX/TX : Le CC1101 ne peut transmettre (TX) que via la broche GDO0. Si vous avez inversé GDO0 et GDO2 dans vos réglages, la réception fonctionnera mais l'émission échouera.
• Mémoire moteur : Les moteurs Somfy ont un nombre limité d'emplacements mémoire. S'il est plein, le moteur ignorera les nouvelles tentatives d'appairage.

Le RSSI varie mais rien n'apparaît dans les journaux

• Fréquence : Votre fréquence de base est probablement décalée. Utilisez le Balayage des fréquences pour trouver le point central.
• Bande passante : Votre "fenêtre d'écoute" est peut-être trop étroite. Essayez les valeurs de base : Bande passante RX à 96.96 kHz et Déviation à 11.43 kHz.

---

Important

Interférences : Évitez de placer le boîtier près d'un micro-ondes ou d'un routeur Wi-Fi, car ils génèrent du bruit qui masque le signal de vos volets.