feat(gateway): enhance DALI host activity tracking and presence management

Signed-off-by: Tony <tonylu@tony-cloud.com>

components/gateway_cache/include/gateway_cache.hpp

@@ -5,6 +5,7 @@
 #include <map>
 #include <optional>
 #include <string>
+#include <vector>
 
 #include "esp_err.h"
 #include "freertos/FreeRTOS.h"
@@ -42,6 +43,12 @@ enum class GatewayCacheDaliTargetKind : uint8_t {
   kBroadcast = 2,
 };
 
+enum class GatewayCacheDaliPresence : uint8_t {
+  kUnknown = 0,
+  kOnline = 1,
+  kOffline = 2,
+};
+
 struct GatewayCacheDaliTarget {
   GatewayCacheDaliTargetKind kind{GatewayCacheDaliTargetKind::kShortAddress};
   uint8_t value{0};
@@ -138,6 +145,12 @@ class GatewayCache {
   GatewayCacheChannelFlags channelFlags(uint8_t gateway_id);
   GatewayCacheChannelFlags pendingChannelFlags(uint8_t gateway_id);
   GatewayCacheDaliAddressState daliAddressState(uint8_t gateway_id, uint8_t short_address);
+  GatewayCacheDaliPresence daliAddressPresence(uint8_t gateway_id, uint8_t short_address);
+  void markDaliAddressPresence(uint8_t gateway_id, uint8_t short_address,
+                               GatewayCacheDaliPresence presence);
+  std::optional<GatewayCacheDaliTarget> decodeDaliTarget(uint8_t raw_addr);
+  std::vector<uint8_t> reconciliationAddresses(
+      uint8_t gateway_id, std::optional<GatewayCacheDaliTarget> target);
   GatewayCacheDaliRuntimeStatus daliGroupStatus(uint8_t gateway_id, uint8_t group_id);
   GatewayCacheDaliRuntimeStatus daliBroadcastStatus(uint8_t gateway_id);
   bool setDaliGroupMask(uint8_t gateway_id, uint8_t short_address,
@@ -183,6 +196,8 @@ class GatewayCache {
   bool commitStorageLocked();
   bool shouldTrackUpdateFlagsLocked() const;
   uint32_t nextDaliRuntimeRevisionLocked();
+  void markDaliAddressPresenceLocked(uint8_t gateway_id, uint8_t short_address,
+                                     GatewayCacheDaliPresence presence);
   bool mirrorDaliCommandLocked(uint8_t gateway_id, uint8_t raw_addr, uint8_t command);
   void clearDaliTargetStateLocked(uint8_t gateway_id, const GatewayCacheDaliTarget& target,
                                   uint32_t revision);
@@ -225,6 +240,7 @@ class GatewayCache {
   std::map<uint8_t, SceneStore> scenes_;
   std::map<uint8_t, GroupStore> groups_;
   std::map<uint8_t, std::array<GatewayCacheDaliAddressState, 64>> dali_states_;
+  std::map<uint8_t, std::array<GatewayCacheDaliPresence, 64>> dali_presence_;
   std::map<uint8_t, std::array<GatewayCacheDaliRuntimeStatus, 16>> dali_group_status_;
   std::map<uint8_t, GatewayCacheDaliRuntimeStatus> dali_broadcast_status_;
   std::map<uint8_t, DtrState> dtr_states_;