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 facilite grandement la configuration :

1. Par défaut : SCLK: GPIO18 | CSN: GPIO05 | MOSI: GPIO23 | MISO: GPIO19 | TX: GPIO13 | RX: GPIO12
2. CC1101 - ESP32-D1 : SCLK: GPIO18 | CSN: GPIO05 | MOSI: GPIO23 | MISO: GPIO19 | TX: GPIO21 | RX: GPIO22
3. Définir manuellement : Pour personnaliser intégralement le brochage selon vos besoins spécifiques.

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.

Tip

Des info-bulles (?) sont disponibles à côté de chaque réglage pour vous rappeler leur fonction.

• Fréquence de Base : Standard RTS à 433.420 MHz. Certains moteurs utilisent le 433.920 MHz.
• Largeur de bande RX : La "taille des oreilles" du module. Plus elle est étroite, moins il y a de parasites, mais plus la fréquence doit être précise.
• Déviation de Fréquence : Définit l'écart nécessaire pour distinguer un signal du bruit ambiant.
• TX Puissance : Réglée à 10dBm par défaut. Peut être montée à 12dBm si vos volets sont très éloignés.

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 à proximité du boîtier.
3. Observez le pic de signal et la valeur RSSI (voir Interpréter le RSSI).
4. 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.

---

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.