#include "gateway_cache.hpp" #include #include #include #include #include #include "dali_gateway.hpp" #include "esp_log.h" namespace gateway { namespace { constexpr const char* kTag = "gateway_cache"; constexpr size_t kMaxNameBytes = 32; class LockGuard { public: explicit LockGuard(SemaphoreHandle_t lock) : lock_(lock) { if (lock_ != nullptr) { xSemaphoreTakeRecursive(lock_, portMAX_DELAY); } } ~LockGuard() { if (lock_ != nullptr) { xSemaphoreGiveRecursive(lock_); } } private: SemaphoreHandle_t lock_; }; std::string ShortKey(const char* prefix, uint8_t gateway_id, uint8_t slot) { char key[16] = {0}; std::snprintf(key, sizeof(key), "%s%u_%u", prefix, gateway_id, slot); return std::string(key); } std::vector ParseCsv(std::string_view raw) { std::vector values; size_t start = 0; while (start < raw.size()) { const size_t comma = raw.find(',', start); const size_t end = comma == std::string_view::npos ? raw.size() : comma; if (end > start) { values.push_back(static_cast(std::strtol(std::string(raw.substr(start, end - start)).c_str(), nullptr, 10))); } if (comma == std::string_view::npos) { break; } start = comma + 1; } return values; } std::string NormalizeName(std::string_view name) { std::string normalized(name); if (normalized.size() > kMaxNameBytes) { normalized.resize(kMaxNameBytes); } return normalized; } bool IsDefaultScene(const GatewayCache::SceneEntry& scene) { return !scene.enabled && scene.brightness == 254 && scene.color_mode == 2 && scene.data1 == 0 && scene.data2 == 0 && scene.data3 == 0; } bool IsDefaultGroup(const GatewayCache::GroupEntry& group) { return !group.enabled && group.target_type == 2 && group.target_value == 0; } std::string BuildScenePayload(const GatewayCache::SceneEntry& scene) { char payload[32] = {0}; std::snprintf(payload, sizeof(payload), "%u,%u,%u,%u,%u,%u", scene.enabled ? 1 : 0, scene.brightness, scene.color_mode, scene.data1, scene.data2, scene.data3); return std::string(payload); } std::string BuildGroupPayload(const GatewayCache::GroupEntry& group) { char payload[24] = {0}; std::snprintf(payload, sizeof(payload), "%u,%u,%u", group.enabled ? 1 : 0, group.target_type, group.target_value); return std::string(payload); } } // namespace GatewayCache::GatewayCache(DaliGatewayCache& dali_cache, GatewayCacheConfig config) : dali_cache_(dali_cache), config_(std::move(config)), lock_(xSemaphoreCreateRecursiveMutex()) { dali_cache_.setPersistenceCallbacks({ [this](uint8_t channel, uint8_t short_address) -> std::optional { LockGuard guard(lock_); const auto value = readStringLocked(ShortKey("ds", channel, short_address)); return value.empty() ? std::nullopt : std::optional(value); }, [this](uint8_t channel, uint8_t short_address, const std::optional& payload) { LockGuard guard(lock_); if (!openStorageLocked()) return false; const auto key = ShortKey("ds", channel, short_address); return payload.has_value() ? writeStringLocked(key, *payload) : eraseKeyLocked(key); }, [this]() { LockGuard guard(lock_); return commitStorageLocked(); }, }); } GatewayCache::~GatewayCache() { if (task_handle_ != nullptr) { vTaskDelete(task_handle_); task_handle_ = nullptr; } if (config_.cache_enabled) flushDirty(); dali_cache_.setPersistenceCallbacks({}); { LockGuard guard(lock_); closeStorageLocked(); } if (lock_ != nullptr) { vSemaphoreDelete(lock_); lock_ = nullptr; } } esp_err_t GatewayCache::start() { { LockGuard guard(lock_); if (!openStorageLocked()) { return ESP_FAIL; } } if (!config_.cache_enabled) { ESP_LOGI(kTag, "cache disabled namespace=%s persistence=direct-nvs", config_.storage_namespace.c_str()); return ESP_OK; } if (task_handle_ != nullptr) { return ESP_OK; } const BaseType_t created = xTaskCreate(&GatewayCache::TaskEntry, "gateway_cache", config_.task_stack_size, this, config_.task_priority, &task_handle_); if (created != pdPASS) { task_handle_ = nullptr; ESP_LOGE(kTag, "failed to create cache task"); return ESP_ERR_NO_MEM; } ESP_LOGI(kTag, "cache adapter started namespace=%s flush_interval_ms=%u", config_.storage_namespace.c_str(), static_cast(config_.flush_interval_ms)); return ESP_OK; } GatewayCache::SceneStore GatewayCache::scenes(uint8_t gateway_id) { LockGuard guard(lock_); if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); return store; } return ensureSceneStoreLocked(gateway_id); } GatewayCache::GroupStore GatewayCache::groups(uint8_t gateway_id) { LockGuard guard(lock_); if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); return store; } return ensureGroupStoreLocked(gateway_id); } GatewayCache::SceneEntry GatewayCache::scene(uint8_t gateway_id, uint8_t scene_id) { LockGuard guard(lock_); if (scene_id >= 16) { return {}; } if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); return store[scene_id]; } return ensureSceneStoreLocked(gateway_id)[scene_id]; } GatewayCache::GroupEntry GatewayCache::group(uint8_t gateway_id, uint8_t group_id) { LockGuard guard(lock_); if (group_id >= 16) { return {}; } if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); return store[group_id]; } return ensureGroupStoreLocked(gateway_id)[group_id]; } bool GatewayCache::setSceneEnabled(uint8_t gateway_id, uint8_t scene_id, bool enabled) { LockGuard guard(lock_); if (scene_id >= 16) { return false; } if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); auto& entry = store[scene_id]; if (entry.enabled == enabled) { return true; } entry.enabled = enabled; return persistSceneLocked(gateway_id, scene_id, entry); } auto& entry = ensureSceneStoreLocked(gateway_id)[scene_id]; if (entry.enabled == enabled) { return true; } entry.enabled = enabled; dirty_ = true; return true; } bool GatewayCache::setSceneDetail(uint8_t gateway_id, uint8_t scene_id, uint8_t brightness, uint8_t color_mode, uint8_t data1, uint8_t data2, uint8_t data3) { LockGuard guard(lock_); if (scene_id >= 16) { return false; } if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); auto& entry = store[scene_id]; if (entry.brightness == brightness && entry.color_mode == color_mode && entry.data1 == data1 && entry.data2 == data2 && entry.data3 == data3) { return true; } entry.brightness = brightness; entry.color_mode = color_mode; entry.data1 = data1; entry.data2 = data2; entry.data3 = data3; return persistSceneLocked(gateway_id, scene_id, entry); } auto& entry = ensureSceneStoreLocked(gateway_id)[scene_id]; if (entry.brightness == brightness && entry.color_mode == color_mode && entry.data1 == data1 && entry.data2 == data2 && entry.data3 == data3) { return true; } entry.brightness = brightness; entry.color_mode = color_mode; entry.data1 = data1; entry.data2 = data2; entry.data3 = data3; dirty_ = true; return true; } bool GatewayCache::setSceneName(uint8_t gateway_id, uint8_t scene_id, std::string_view name) { LockGuard guard(lock_); if (scene_id >= 16) { return false; } if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); auto& entry = store[scene_id]; const auto normalized = NormalizeName(name); if (entry.name == normalized) { return true; } entry.name = normalized; return persistSceneLocked(gateway_id, scene_id, entry); } auto& entry = ensureSceneStoreLocked(gateway_id)[scene_id]; const auto normalized = NormalizeName(name); if (entry.name == normalized) { return true; } entry.name = normalized; dirty_ = true; return true; } bool GatewayCache::deleteScene(uint8_t gateway_id, uint8_t scene_id) { LockGuard guard(lock_); if (scene_id >= 16) { return false; } if (!config_.cache_enabled) { SceneStore store; loadSceneStoreLocked(gateway_id, store); auto& entry = store[scene_id]; if (IsDefaultScene(entry) && entry.name.empty()) { return true; } entry = SceneEntry{}; return persistSceneLocked(gateway_id, scene_id, entry); } auto& entry = ensureSceneStoreLocked(gateway_id)[scene_id]; if (IsDefaultScene(entry) && entry.name.empty()) { return true; } entry = SceneEntry{}; dirty_ = true; return true; } std::pair GatewayCache::sceneMask(uint8_t gateway_id) { LockGuard guard(lock_); SceneStore direct_store; if (!config_.cache_enabled) { loadSceneStoreLocked(gateway_id, direct_store); } const auto& store = config_.cache_enabled ? ensureSceneStoreLocked(gateway_id) : direct_store; uint16_t mask = 0; for (size_t index = 0; index < store.size(); ++index) { if (store[index].enabled) { mask |= static_cast(1U << index); } } return {static_cast(mask & 0xff), static_cast((mask >> 8) & 0xff)}; } bool GatewayCache::setGroupEnabled(uint8_t gateway_id, uint8_t group_id, bool enabled) { LockGuard guard(lock_); if (group_id >= 16) { return false; } if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); auto& entry = store[group_id]; if (entry.enabled == enabled) { return true; } entry.enabled = enabled; return persistGroupLocked(gateway_id, group_id, entry); } auto& entry = ensureGroupStoreLocked(gateway_id)[group_id]; if (entry.enabled == enabled) { return true; } entry.enabled = enabled; dirty_ = true; return true; } bool GatewayCache::setGroupDetail(uint8_t gateway_id, uint8_t group_id, uint8_t target_type, uint8_t target_value) { LockGuard guard(lock_); if (group_id >= 16) { return false; } if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); auto& entry = store[group_id]; if (entry.target_type == target_type && entry.target_value == target_value) { return true; } entry.target_type = target_type; entry.target_value = target_value; return persistGroupLocked(gateway_id, group_id, entry); } auto& entry = ensureGroupStoreLocked(gateway_id)[group_id]; if (entry.target_type == target_type && entry.target_value == target_value) { return true; } entry.target_type = target_type; entry.target_value = target_value; dirty_ = true; return true; } bool GatewayCache::setGroupName(uint8_t gateway_id, uint8_t group_id, std::string_view name) { LockGuard guard(lock_); if (group_id >= 16) { return false; } if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); auto& entry = store[group_id]; const auto normalized = NormalizeName(name); if (entry.name == normalized) { return true; } entry.name = normalized; return persistGroupLocked(gateway_id, group_id, entry); } auto& entry = ensureGroupStoreLocked(gateway_id)[group_id]; const auto normalized = NormalizeName(name); if (entry.name == normalized) { return true; } entry.name = normalized; dirty_ = true; return true; } bool GatewayCache::deleteGroup(uint8_t gateway_id, uint8_t group_id) { LockGuard guard(lock_); if (group_id >= 16) { return false; } if (!config_.cache_enabled) { GroupStore store; loadGroupStoreLocked(gateway_id, store); auto& entry = store[group_id]; if (IsDefaultGroup(entry) && entry.name.empty()) { return true; } entry = GroupEntry{}; return persistGroupLocked(gateway_id, group_id, entry); } auto& entry = ensureGroupStoreLocked(gateway_id)[group_id]; if (IsDefaultGroup(entry) && entry.name.empty()) { return true; } entry = GroupEntry{}; dirty_ = true; return true; } std::pair GatewayCache::groupMask(uint8_t gateway_id) { LockGuard guard(lock_); GroupStore direct_store; if (!config_.cache_enabled) { loadGroupStoreLocked(gateway_id, direct_store); } const auto& store = config_.cache_enabled ? ensureGroupStoreLocked(gateway_id) : direct_store; uint16_t mask = 0; for (size_t index = 0; index < store.size(); ++index) { if (store[index].enabled) { mask |= static_cast(1U << index); } } return {static_cast(mask & 0xff), static_cast((mask >> 8) & 0xff)}; } bool GatewayCache::cacheEnabled() const { LockGuard guard(lock_); return config_.cache_enabled; } bool GatewayCache::setCacheEnabled(bool enabled) { { LockGuard guard(lock_); if (config_.cache_enabled == enabled) return true; } if (!enabled && !flushDirty()) return false; { LockGuard guard(lock_); config_.cache_enabled = enabled; } return !enabled || start() == ESP_OK; } void GatewayCache::TaskEntry(void* arg) { static_cast(arg)->taskLoop(); } void GatewayCache::taskLoop() { const TickType_t interval_ticks = std::max(1, pdMS_TO_TICKS(config_.flush_interval_ms)); while (true) { vTaskDelay(interval_ticks); flushDirty(); } } bool GatewayCache::flushDirty() { if (!dali_cache_.flush()) { return false; } LockGuard guard(lock_); if (!config_.cache_enabled) { return true; } if (!dirty_) { return true; } if (!openStorageLocked()) { return false; } for (const auto& [gateway_id, store] : scenes_) { for (uint8_t scene_id = 0; scene_id < store.size(); ++scene_id) { const auto& entry = store[scene_id]; if (!IsDefaultScene(entry)) { if (!writeStringLocked(ShortKey("sc", gateway_id, scene_id), BuildScenePayload(entry))) { return false; } } else if (!eraseKeyLocked(ShortKey("sc", gateway_id, scene_id))) { return false; } if (!entry.name.empty()) { if (!writeStringLocked(ShortKey("sn", gateway_id, scene_id), entry.name)) { return false; } } else if (!eraseKeyLocked(ShortKey("sn", gateway_id, scene_id))) { return false; } } } for (const auto& [gateway_id, store] : groups_) { for (uint8_t group_id = 0; group_id < store.size(); ++group_id) { const auto& entry = store[group_id]; if (!IsDefaultGroup(entry)) { if (!writeStringLocked(ShortKey("gr", gateway_id, group_id), BuildGroupPayload(entry))) { return false; } } else if (!eraseKeyLocked(ShortKey("gr", gateway_id, group_id))) { return false; } if (!entry.name.empty()) { if (!writeStringLocked(ShortKey("gn", gateway_id, group_id), entry.name)) { return false; } } else if (!eraseKeyLocked(ShortKey("gn", gateway_id, group_id))) { return false; } } } const esp_err_t commit_err = nvs_commit(storage_); if (commit_err != ESP_OK) { ESP_LOGE(kTag, "cache commit failed: %s", esp_err_to_name(commit_err)); return false; } dirty_ = false; return true; } bool GatewayCache::openStorageLocked() { if (storage_ != 0) { return true; } const esp_err_t err = nvs_open(config_.storage_namespace.c_str(), NVS_READWRITE, &storage_); if (err != ESP_OK) { ESP_LOGE(kTag, "failed to open cache storage: %s", esp_err_to_name(err)); return false; } return true; } void GatewayCache::closeStorageLocked() { if (storage_ != 0) { nvs_close(storage_); storage_ = 0; } } bool GatewayCache::persistSceneLocked(uint8_t gateway_id, uint8_t scene_id, const SceneEntry& scene) { if (!openStorageLocked()) { return false; } if (!IsDefaultScene(scene)) { if (!writeStringLocked(ShortKey("sc", gateway_id, scene_id), BuildScenePayload(scene))) { return false; } } else if (!eraseKeyLocked(ShortKey("sc", gateway_id, scene_id))) { return false; } if (!scene.name.empty()) { if (!writeStringLocked(ShortKey("sn", gateway_id, scene_id), scene.name)) { return false; } } else if (!eraseKeyLocked(ShortKey("sn", gateway_id, scene_id))) { return false; } return commitStorageLocked(); } bool GatewayCache::persistGroupLocked(uint8_t gateway_id, uint8_t group_id, const GroupEntry& group) { if (!openStorageLocked()) { return false; } if (!IsDefaultGroup(group)) { if (!writeStringLocked(ShortKey("gr", gateway_id, group_id), BuildGroupPayload(group))) { return false; } } else if (!eraseKeyLocked(ShortKey("gr", gateway_id, group_id))) { return false; } if (!group.name.empty()) { if (!writeStringLocked(ShortKey("gn", gateway_id, group_id), group.name)) { return false; } } else if (!eraseKeyLocked(ShortKey("gn", gateway_id, group_id))) { return false; } return commitStorageLocked(); } bool GatewayCache::commitStorageLocked() { if (storage_ == 0) { return false; } const esp_err_t commit_err = nvs_commit(storage_); if (commit_err != ESP_OK) { ESP_LOGE(kTag, "cache commit failed: %s", esp_err_to_name(commit_err)); return false; } return true; } GatewayCache::SceneStore& GatewayCache::ensureSceneStoreLocked(uint8_t gateway_id) { auto [it, inserted] = scenes_.try_emplace(gateway_id); if (inserted) { loadSceneStoreLocked(gateway_id, it->second); } return it->second; } GatewayCache::GroupStore& GatewayCache::ensureGroupStoreLocked(uint8_t gateway_id) { auto [it, inserted] = groups_.try_emplace(gateway_id); if (inserted) { loadGroupStoreLocked(gateway_id, it->second); } return it->second; } void GatewayCache::loadSceneStoreLocked(uint8_t gateway_id, SceneStore& scenes) { for (uint8_t scene_id = 0; scene_id < scenes.size(); ++scene_id) { const auto raw = readStringLocked(ShortKey("sc", gateway_id, scene_id)); const auto values = ParseCsv(raw); if (values.size() >= 6) { scenes[scene_id].enabled = values[0] != 0; scenes[scene_id].brightness = static_cast(std::clamp(values[1], 0, 254)); scenes[scene_id].color_mode = static_cast(std::clamp(values[2], 0, 2)); scenes[scene_id].data1 = static_cast(std::clamp(values[3], 0, 255)); scenes[scene_id].data2 = static_cast(std::clamp(values[4], 0, 255)); scenes[scene_id].data3 = static_cast(std::clamp(values[5], 0, 255)); } scenes[scene_id].name = NormalizeName(readStringLocked(ShortKey("sn", gateway_id, scene_id))); } } void GatewayCache::loadGroupStoreLocked(uint8_t gateway_id, GroupStore& groups) { for (uint8_t group_id = 0; group_id < groups.size(); ++group_id) { const auto raw = readStringLocked(ShortKey("gr", gateway_id, group_id)); const auto values = ParseCsv(raw); if (values.size() >= 2) { groups[group_id].enabled = values[0] != 0; uint8_t target_type = static_cast(std::clamp(values[1], 0, 2)); uint8_t target_value = values.size() >= 3 ? static_cast(std::clamp(values[2], 0, 255)) : target_type; if (values.size() < 3) { target_type = 2; } groups[group_id].target_type = target_type; groups[group_id].target_value = target_type == 0 ? static_cast(std::min(target_value, 63)) : target_type == 1 ? static_cast(std::min(target_value, 15)) : 0; } groups[group_id].name = NormalizeName(readStringLocked(ShortKey("gn", gateway_id, group_id))); } } std::string GatewayCache::readStringLocked(std::string_view key) { if (!openStorageLocked()) { return {}; } size_t required_size = 0; const esp_err_t err = nvs_get_str(storage_, std::string(key).c_str(), nullptr, &required_size); if (err != ESP_OK || required_size == 0) { return {}; } std::string value(required_size - 1, '\0'); if (nvs_get_str(storage_, std::string(key).c_str(), value.data(), &required_size) != ESP_OK) { return {}; } return value; } bool GatewayCache::writeStringLocked(std::string_view key, std::string_view value) { if (storage_ == 0) { return false; } const esp_err_t err = nvs_set_str(storage_, std::string(key).c_str(), std::string(value).c_str()); if (err != ESP_OK) { ESP_LOGE(kTag, "failed to write cache key=%s err=%s", std::string(key).c_str(), esp_err_to_name(err)); return false; } return true; } bool GatewayCache::eraseKeyLocked(std::string_view key) { if (storage_ == 0) { return false; } const esp_err_t err = nvs_erase_key(storage_, std::string(key).c_str()); if (err == ESP_ERR_NVS_NOT_FOUND) { return true; } if (err != ESP_OK) { ESP_LOGE(kTag, "failed to erase cache key=%s err=%s", std::string(key).c_str(), esp_err_to_name(err)); return false; } return true; } } // namespace gateway