Expose RTL_433 whitelist slots in Home Assistant

Author: waiet

docs/integrate/home_assistant.md

@@ -74,7 +74,12 @@ 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.
+The gateway device also exposes RTL_433 whitelist controls through MQTT discovery:
+
+- `RTL_433: Whitelist`, a switch to enable or disable the filter
+- `RTL_433: Whitelist 1` to `RTL_433: Whitelist 5`, text fields containing accepted device identifiers
+
+When the whitelist switch is enabled, only matching RTL_433 devices are published to MQTT and discovered as Home Assistant entities. The same whitelist can also be edited from the OpenMQTTGateway WebUI RF configuration page. Changes made from either Home Assistant or the WebUI are saved on the gateway and published back in the SYS state topic.
 
 ### RF (RCSwitch based gateway) Auto discovery specificity
 With OpenMQTTGateway [configured to receive RF signals](../setitup/rf.html) messages are transmitted accordingly.

main/config_mqttDiscovery.h

@@ -277,6 +277,7 @@ extern char discovery_prefix[];
 #define HASS_TYPE_SWITCH         "switch"
 #define HASS_TYPE_BUTTON         "button"
 #define HASS_TYPE_NUMBER         "number"
+#define HASS_TYPE_TEXT           "text"
 #define HASS_TYPE_UPDATE         "update"
 #define HASS_TYPE_COVER          "cover"
 #define HASS_TYPE_DEVICE_TRACKER "device_tracker"

main/mqttDiscovery.cpp

@@ -739,6 +739,24 @@ void pubMqttDiscovery() {
   createDiscoveryFromList(nullptr, systemEntities, entityCount, nullptr, nullptr, nullptr,
                           true, subjectSYStoMQTT, will_Topic, nullptr);
 
+#  ifdef ZgatewayRTL_433
+  for (uint8_t i = 1; i <= 5; i++) {
+    String slotKey = "rtl433wl" + String(i);
+    String slotName = "RTL_433: Whitelist " + String(i);
+    String valueTemplate = "{{ value_json." + slotKey + " | default('') }}";
+    String commandTemplate = "{\"" + slotKey + "\":\"{{ value }}\",\"save\":true}";
+    createDiscovery(HASS_TYPE_TEXT,
+                    subjectSYStoMQTT, slotName.c_str(), (char*)getUniqueId(slotKey, "").c_str(),
+                    will_Topic, "", valueTemplate.c_str(),
+                    "", "", "",
+                    0,
+                    Gateway_AnnouncementMsg, will_Message, true, subjectMQTTtoSYSset,
+                    "", "", "", "", false,
+                    stateClassNone, nullptr, nullptr, nullptr,
+                    commandTemplate.c_str());
+  }
+#  endif
+
 #  ifdef SecondaryModule
   // Secondary module system sensors - dynamic string handling required
   String secondaryPrefix = String(SecondaryModule);