feat(rf): add CC1101 transceiver support, merge X10 RF protocol and bump to v1.2.66

- Add support for TI CC1101 SPI sub-GHz transceivers in rf-transceiver and ir-rf-transceiver
- Merge X10 RF transceiver into rf-transceiver and deprecate standalone x10-transceiver env
- Support dynamic X10 device mappings (x10-devs) with scheduling and event automation
- Add ModuleType definitions for Siren, Fan, Shutter, and DoorLock
- Add before/after transmit callback hooks to RFTransmitter and X10RFTransmitter
- Update LiteScriptHandler to signal FX.Style events on script change
- Add deserialization error handling in EventRouter for schedule rules
- Update documentation and Web API references for CC1101 and UPnP auto-discovery
- Bump version to 1.2.66

Author: genemars

README.md

@@ -77,7 +77,7 @@ HomeGenie Mini provides several specialized configurations and ready-to-use firm
 - 📷 [**Smart Camera + A.I.**](https://homegenie.it/mini/1.2/smart-camera-ai/): Implements video streaming and object tracking logic using ESP32-CAM models.
 - 💡 [**Smart Light / Mood Lamp**](https://homegenie.it/mini/1.2/smart-light/): Controls WS281x RGB LED strips with automated transitions, schedules, and custom animations.
 - 🌡️ [**Smart Sensor**](https://homegenie.it/mini/1.2/smart-sensor/): Gathers data from DHT22, LDR, and motion sensors with low overhead.
-- 📟 [**Remote Control & Gateway**](https://homegenie.it/mini/1.2/remote-control/): A transceiver gateway to capture and replay IR/RF commands.
+- 📟 [**Remote Control & Gateway**](https://homegenie.it/mini/1.2/remote-control/): A multi-protocol transceiver gateway (Firefly Kit) to capture, replay, and bridge IR, generic 433/315 MHz RF (SYN modules or CC1101 SPI), and bidirectional **X10 RF** home automation devices.
 
 ---
 
@@ -103,9 +103,16 @@ Once connected, your device will appear in the HomeGenie Panel dashboard.
 
 ### Connecting to HomeGenie Server
 
-HomeGenie Mini devices can communicate with [HomeGenie Server](https://github.com/genielabs/HomeGenie) and other brokers by configuring the MQTT client as shown below:
+HomeGenie Mini devices feature zero-configuration network discovery and seamless integration with [HomeGenie Server](https://github.com/genielabs/HomeGenie):
 
-![HomeGenie Server - MQTT configuration](data/images/phone/hg_server_mqtt_config.png)
+1. **Automatic Discovery (UPnP/SSDP):**  
+   Once connected to your local Wi-Fi network, your HomeGenie Mini device is automatically detected by HomeGenie Server and appears as a device card in the **UPnP** dashboard group.
+
+2. **One-Click MQTT Connection:**  
+   Click the **`CONNECT`** button on the device card. HomeGenie Server will automatically provision and establish the secure MQTT communication link in the background—no manual broker configuration required.
+
+3. **Browse Modules & Add Dashboard Widgets:**  
+   Once connected, click the **`MODULES`** button to view all hardware endpoints exposed by the device (e.g., *IR Transceiver*, *RC RF*, *Color Light*, *X10 Devices*). From the popup dialog, you can select any module and add its interactive widget directly to your preferred dashboard groups.
 
 ---
 

examples/color-light/README.md

@@ -12,10 +12,10 @@ In addition to default system options the following configuration options are av
 | Key        | Description                 | Default                                 |
 |------------|-----------------------------|-----------------------------------------|
 | `leds-pin` | LED strip GPIO pin number   | -1 (-1=not used)                        |
-| `leds-cnt` | Number of LEDs              | 1 (1 - 1024)                            |
+| `leds-cnt` | Number of LEDs              | 1 (1 - 4096)                            |
 | `leds-rws` | Number of matrix rows       | 1 (1 - 64)                              |
-| `leds-vrt` | Matrix vertical wiring      | false (false=horizontal, true=vertical) |
 | `leds-srp` | Serpentine cabling layout   | true (false=progressive, true=serp.)    |
+| `leds-vrt` | Matrix vertical wiring      | false (false=horizontal, true=vertical) |
 | `leds-stb` | Start layout at bottom      | false (false=start top, true=bottom)    |
 | `leds-str` | Start layout at right       | false (false=start left, true=right)    |
 | `leds-spd` | Data transfer speed         | 0 (0=800kHz, 256=400kHz)                |

examples/color-light/api/LiteScriptHandler.cpp

@@ -1,6 +1,27 @@
-//
-// Created by gene on 06/06/26.
-//
+/*
+ * HomeGenie-Mini (c) 2018-2026 G-Labs
+ *
+ *
+ * This file is part of HomeGenie-Mini (HGM).
+ *
+ *  HomeGenie-Mini is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  HomeGenie-Mini is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with HomeGenie-Mini.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ *
+ * Authors:
+ * - Generoso Martello <gene@homegenie.it>
+ *
+ */
 
 #include "LiteScriptHandler.h"
 
@@ -37,8 +58,7 @@ namespace Service { namespace API {
 
                 startTime = millis();
                 responseCallback->writeAll(ApiHandlerResponseStatus::OK);
-
-                currentStyleIndex = 20; // switch to `SCRIPT` fx to show result
+                switchToScriptFx();
 
                 return true;
             }
@@ -47,8 +67,7 @@ namespace Service { namespace API {
                 liteScript.clear();
                 compiledScript.clear(); // Ensure the binary buffer is also cleared
                 responseCallback->writeAll(ApiHandlerResponseStatus::OK);
-
-                currentStyleIndex = 20; // switch to `SCRIPT` fx to show result
+                switchToScriptFx();
 
                 return true;
             }
@@ -63,10 +82,17 @@ namespace Service { namespace API {
     }
 
     Module * LiteScriptHandler::getModule(const char *domain, const char *address) {
-        return nullptr;
+        return module;
     }
 
     LinkedList<Module *> * LiteScriptHandler::getModuleList() {
         return &moduleList;
     }
+
+    void LiteScriptHandler::switchToScriptFx() {
+        currentStyleIndex = 20; // switch to `SCRIPT` fx to show result
+        auto msg = std::make_shared<QueuedMessage>(module, "FX.Style", "script");
+        module->setProperty("FX.Style", "script");
+        HomeGenie::getInstance()->getEventRouter().signalEvent(msg);
+    }
 }}

examples/color-light/api/LiteScriptHandler.h

@@ -1,10 +1,32 @@
-//
-// Created by gene on 06/06/26.
-//
+/*
+ * HomeGenie-Mini (c) 2018-2026 G-Labs
+ *
+ *
+ * This file is part of HomeGenie-Mini (HGM).
+ *
+ *  HomeGenie-Mini is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  HomeGenie-Mini is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with HomeGenie-Mini.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ *
+ * Authors:
+ * - Generoso Martello <gene@homegenie.it>
+ *
+ */
 
 #ifndef HOMEGENIE_MINI_LITESCRIPTHANDLER_H
 #define HOMEGENIE_MINI_LITESCRIPTHANDLER_H
 
+#include "HomeGenie.h"
 #include "service/api/APIHandler.h"
 
 #include "../fx/fx_script_utils.h"
@@ -14,7 +36,12 @@ namespace Service { namespace API {
     class LiteScriptHandler : public APIHandler {
     private:
         LinkedList<Module*> moduleList;
+        void switchToScriptFx();
     public:
+        LiteScriptHandler(Module* module) {
+            this->module = module;
+        }
+
         void init() override;
         bool canHandleDomain(String* domain) override;
         bool handleRequest(APIRequest*, ResponseCallback*) override;
@@ -25,9 +52,10 @@ namespace Service { namespace API {
         Module* getModule(const char* domain, const char* address) override;
         LinkedList<Module*>* getModuleList() override;
 
+        Module* module;
         String liteScript;
         std::vector<uint8_t> compiledScript;
-        unsigned long startTime;
+        unsigned long startTime{};
     };
 
 }}

examples/color-light/color-light.cpp

@@ -98,7 +98,7 @@ void setup() {
         // Setup example schedules/scenes
         setupDefaultSchedules();
 
-        scriptHandler = new LiteScriptHandler();
+        scriptHandler = new LiteScriptHandler(module);
         homeGenie->addAPIHandler(scriptHandler);
 #endif
 

examples/ir-rf-transceiver/ir-rf-transceiver.cpp

@@ -1,5 +1,5 @@
 /*
- * HomeGenie-Mini (c) 2018-2025 G-Labs
+ * HomeGenie-Mini (c) 2018-2026 G-Labs
  *
  *
  * This file is part of HomeGenie-Mini (HGM).
@@ -34,6 +34,7 @@
 
 #include "../rf-transceiver/io/RFReceiver.h"
 #include "../rf-transceiver/io/RFTransmitter.h"
+#include "../rf-transceiver/io/CC1101Transceiver.h"
 #include "../rf-transceiver/api/RCSwitchHandler.h"
 
 #include "../x10-transceiver/io/X10RFReceiver.h"
@@ -48,6 +49,7 @@ StatusLed statusLed;
 using namespace Service;
 
 HomeGenie* homeGenie;
+CC1101Transceiver cc1101;
 
 void setup() {
     // Default name shown in SNMP/UPnP advertising
@@ -62,28 +64,32 @@ void setup() {
     statusLed.setup();
 #endif
 
+    // Read pin configuration
+    uint8_t irReceiverPin = Config::getSetting("irrc-pin", CONFIG_IRReceiverPin).toInt();
+    uint8_t irTransmitterPin = Config::getSetting("irtr-pin", CONFIG_IRTransmitterPin).toInt();
+    uint8_t rfReceiverPin = Config::getSetting("rfrc-pin", CONFIG_RCSwitchReceiverPin).toInt();
+    uint8_t rfTransmitterPin = Config::getSetting("rftr-pin", CONFIG_RCSwitchTransmitterPin).toInt();
+
     // IR transceiver
 
     auto irApiHandler = new IRTransceiverHandler();
     // IR receiver
-    uint8_t irReceiverPin = Config::getSetting("irrc-pin", CONFIG_IRReceiverPin).toInt();
     if (irReceiverPin > 0) {
         auto receiverConfiguration = new IR::IRReceiverConfig(irReceiverPin);
         auto receiver = new IR::IRReceiver(receiverConfiguration);
         irApiHandler->setReceiver(receiver);
         homeGenie->addIOHandler(receiver);
     }
     // IR transmitter
-    uint8_t irTransmitterPin = Config::getSetting("irtr-pin", CONFIG_IRTransmitterPin).toInt();
     if (irTransmitterPin > 0) {
         auto transmitterConfig = new IR::IRTransmitterConfig(irTransmitterPin);
         auto transmitter = new IR::IRTransmitter(transmitterConfig);
         irApiHandler->setTransmitter(transmitter);
     }
     homeGenie->addAPIHandler(irApiHandler);
 
-    uint8_t rfReceiverPin = Config::getSetting("rfrc-pin", CONFIG_RCSwitchReceiverPin).toInt();
-    uint8_t rfTransmitterPin = Config::getSetting("rftr-pin", CONFIG_RCSwitchTransmitterPin).toInt();
+    // CC1101 sub-GHz RF Module auto-detect
+    cc1101.begin(rfReceiverPin, rfTransmitterPin);
 
     // RC-Switch RF transceiver
 
@@ -98,6 +104,7 @@ void setup() {
     if (rfTransmitterPin > 0) {
         auto rcsTransmitterConfig = new RCS::RFTransmitterConfig(rfTransmitterPin);
         auto rcsTransmitter = new RCS::RFTransmitter(rcsTransmitterConfig);
+        cc1101.bindTransmitter(rcsTransmitter);
         rcsApiHandler->setTransmitter(rcsTransmitter);
     }
     // RCSwitch RF Receiver
@@ -107,7 +114,9 @@ void setup() {
         homeGenie->addIOHandler(rcsReceiver);
         // shared interrupt handler with X10 class
         X10RFReceiver::addInterruptHandler([rcsReceiver](){
-            rcsReceiver->handleInterrupt();
+            if (!cc1101.isTransmitting()) {
+                rcsReceiver->handleInterrupt();
+            }
         });
         rcsApiHandler->setReceiver(rcsReceiver);
     }
@@ -127,6 +136,7 @@ void setup() {
     if (rfTransmitterPin > 0) {
         auto x10TransmitterConfig = new X10::X10RFTransmitterConfig(rfTransmitterPin);
         auto x10Transmitter = new X10::X10RFTransmitter(x10TransmitterConfig);
+        cc1101.bindTransmitter(x10Transmitter);
         x10ApiHandler->setTransmitter(x10Transmitter);
     }
     // X10 RF RFReceiver
@@ -140,6 +150,8 @@ void setup() {
     homeGenie->addAPIHandler(x10ApiHandler);
 
     homeGenie->begin();
+
+    cc1101.startListening();
 }
 
 

examples/ir-transceiver/api/IRTransceiverHandler.cpp

@@ -1,5 +1,5 @@
 /*
- * HomeGenie-Mini (c) 2018-2024 G-Labs
+ * HomeGenie-Mini (c) 2018-2026 G-Labs
  *
  *
  * This file is part of HomeGenie-Mini (HGM).
@@ -55,9 +55,13 @@ namespace Service { namespace API {
 
         moduleList.add(irModule);
 
-        transmitter->begin();
-        //receiver->begin(); <-- this is already done automatically by "IIOEventSender" parent class
-        receiver->setModule(irModule);
+        if (transmitter != nullptr) {
+            transmitter->begin();
+        }
+        if (receiver != nullptr) {
+            //receiver->begin(); <-- this is already done automatically by "IIOEventSender" parent class
+            receiver->setModule(irModule);
+        }
     }
 
     bool IRTransceiverHandler::handleRequest(APIRequest *command, ResponseCallback* responseCallback) {

examples/ir-transceiver/api/IRTransceiverHandler.h

@@ -1,5 +1,5 @@
 /*
- * HomeGenie-Mini (c) 2018-2024 G-Labs
+ * HomeGenie-Mini (c) 2018-2026 G-Labs
  *
  *
  * This file is part of HomeGenie-Mini (HGM).
@@ -42,8 +42,8 @@ namespace Service { namespace API {
     private:
         LinkedList<Module*> moduleList;
         ModuleParameter* rawDataParameter{};
-        IRTransmitter* transmitter = nullptr;
-        IRReceiver* receiver = nullptr;
+        IRTransmitter* transmitter{};
+        IRReceiver* receiver{};
     public:
         void setReceiver(IRReceiver*);
         void setTransmitter(IRTransmitter*);