Add RTL_433 whitelist support

Author: waiet

docs/integrate/home_assistant.md

@@ -74,6 +74,8 @@ mqtt:
 
 Alternatively the rssi signal could be used also.
 
+The gateway device also exposes an `RTL_433: Whitelist` switch through MQTT discovery. When the whitelist switch is enabled, only matching RTL_433 devices are published to MQTT and discovered as Home Assistant entities. The whitelist entries can be edited from the OpenMQTTGateway WebUI RF configuration page or with MQTT commands.
+
 ### RF (RCSwitch based gateway) Auto discovery specificity
 With OpenMQTTGateway [configured to receive RF signals](../setitup/rf.html) messages are transmitted accordingly.
 

docs/use/rf.md

@@ -72,6 +72,45 @@ This feature is only available on a ESP32 based device with a supported transcei
 
 For the most recent support decoder list please check the [rtl_433_esp](https://github.com/NorthernMan54/rtl_433_ESP?tab=readme-ov-file#ook-signal-device-decoders) repository.
 
+### RTL_433 device whitelist
+
+The RTL_433 gateway can filter received devices with a whitelist. When the whitelist is enabled, only devices matching one of the configured RTL_433 device identifiers are published to MQTT. Other received RTL_433 messages are ignored.
+
+The device identifier is built from the RTL_433 decoded fields in this order:
+
+`type/model/subtype/channel/id`
+
+Depending on the protocol, some parts may be absent. The WebUI shows the identifiers detected during the current runtime, making it easier to select devices without typing them manually.
+
+The whitelist can be configured from:
+
+- the WebUI RF configuration page
+- MQTT commands to the SYS command topic
+- Home Assistant, when MQTT discovery is enabled
+
+The whitelist supports up to 5 device identifiers.
+
+Enable or disable the whitelist:
+
+```bash
+mosquitto_pub -t "home/OpenMQTTGateway/commands/MQTTtoSYS/config" -m '{"rtl433wle":true,"save":true}'
+mosquitto_pub -t "home/OpenMQTTGateway/commands/MQTTtoSYS/config" -m '{"rtl433wle":false,"save":true}'
+```
+
+Set whitelist entries:
+
+```bash
+mosquitto_pub -t "home/OpenMQTTGateway/commands/MQTTtoSYS/config" -m '{"rtl433wl1":"OOK/Acurite-Tower/1/12345","rtl433wl2":"OOK/Prologue-TH/9/1/215","save":true}'
+```
+
+Clear one whitelist entry by sending an empty string:
+
+```bash
+mosquitto_pub -t "home/OpenMQTTGateway/commands/MQTTtoSYS/config" -m '{"rtl433wl2":"","save":true}'
+```
+
+The current whitelist state is published in the SYS state topic with the keys `rtl433wle` and `rtl433wl1` to `rtl433wl5`.
+
 ### Change Signal RSSI Threshold Delta
 
 Delta applied to RSSI floor noise level to determine start and end of signal, defaults to 9db.

main/config_RF.h

@@ -61,17 +61,17 @@ extern int getRTLMessageCount();
 extern int getRTLAverageRSSI();
 extern int getOOKThresh();
 
+#  define uniqueIdSize  60 // longest model + longest key
+#  define modelNameSize 31 // longest model
+#  define typeSize      10 // longest type
+
 #  ifdef ZmqttDiscovery
 extern void launchRTL_433Discovery(bool overrideDiscovery);
 // This structure stores the entities of the RTL 433 devices and is they have been discovered or not
 // The uniqueId is composed of the device id + the key
-
-#    define uniqueIdSize  60 // longest model + longest key
-#    define modelNameSize 31 // longest model
-#    define typeSize      10 // longest type
-
 struct RTL_433device {
   char uniqueId[uniqueIdSize];
+  char deviceId[uniqueIdSize];
   char modelName[modelNameSize];
   char type[typeSize];
   bool isDisc;
@@ -131,6 +131,15 @@ const char parameters[51][4][24] = {
     {"wind_speed_km_h", "Wind speed", "km/h", "wind_speed"},
     {"wind_speed_m_s", "Wind speed", "m/s", "wind_speed"}};
 #  endif
+extern void RTL_433Config_addState(JsonObject& data);
+extern bool RTL_433Config_fromJson(JsonObject& data);
+extern bool RTL_433Config_save();
+extern bool RTL_433Config_load();
+extern void RTL_433Config_setWhitelistEnabled(bool enabled);
+extern bool RTL_433Config_isWhitelistEnabled();
+extern void RTL_433Config_clearWhitelist();
+extern bool RTL_433Config_addWhitelistId(const char* id);
+extern String RTL_433Config_webWhitelist();
 #  ifdef RTL_433_DISCOVERY_LOGGING
 #    define DISCOVERY_TRACE_LOG(...) THEENGS_LOG_TRACE(__VA_ARGS__)
 #  else

main/config_WebContent.h

@@ -153,6 +153,8 @@ const char config_rf_body[] = body_header
     "<p><b>Active library</b><br>"
     "<select id='ar' name='ar'>%s</select></p>"
 
+    "%s"
+
     /* // Need testing
     "<p><b>OOK Threshold</b><br>"
     "<input type='number' id='oo' name='oo' step='any' value='%d'></p>"