AppUi.cpp

Go to the documentation of this file.

 
#include "AppUiInternal.h"
#include "cdc_os_ui/AppUi.h"
#include "cdc_os_ui/views/LockScreenView.h"
#include "cdc_os_ui/views/PinChangeView.h"
#include "cdc_os_ui/views/BlePairingPromptView.h"
#include "cdc_os_ui/WifiHandlers.h"
#include "cdc_os_ui/SettingsHandlers.h"
#include "cdc_os_ui/SleepManager.h"
#include "cdc_os_ui/HardwareInfo.h"
#include "cdc_core/PinManager.h"
#include "cdc_core/FactoryReset.h"
#include "cdc_core/TropicSlotMap.h"
#include "cdc_core/TropicStorage.h"
#include "cdc_core/UsbManager.h"
#include "cdc_core/Raii.h"
 
#include "cdc_views/SliderView.h"
#include "cdc_views/PinEntryView.h"
#include "cdc_views/DateInputView.h"
#include "cdc_views/TimeInputView.h"
#include "plugin_manager/PluginListView.h"
#include "plugin_manager/PluginManager.h"
 
#include "cdc_hal/IDisplay.h"
#include "cdc_hal/IKeypad.h"
#include "cdc_hal/IPowerManager.h"
#include "cdc_hal/ISleepController.h"
#include "cdc_hal/ISecureElement.h"
#include "cdc_hal/IWifiController.h"
#include "cdc_hal/IBluetoothController.h"
#include "cdc_hal/IRtc.h"
 
#include "serial_cmd/SerialCmd.h"
#include "nvs.h"
 
#include <atomic>
#include <cstdio>
#include <cstring>
#include <ctime>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/semphr.h"
#include "esp_timer.h"
 
namespace cdc::ui {

 
static constexpr uint8_t MAIN_MENU_MAX_ITEMS = 16;
// Fixed main-menu entries appended after the dynamic module items; the
// trailing MAIN_MENU_FIXED_COUNT is their number, derived automatically.
enum MainMenuFixed : uint8_t { MM_PLUGINS, MM_TOOLS, MM_SETTINGS, MAIN_MENU_FIXED_COUNT };
static constexpr uint8_t TOOLS_MAX_ITEMS = 16;
 
static constexpr uint32_t INACTIVITY_TIMEOUT_MS = 5 * 60 * 1000;

 
enum SettingsMenuIdx {
    SETTINGS_IDX_BRIGHTNESS = 0,
    SETTINGS_IDX_LANGUAGE,
    SETTINGS_IDX_TIMEZONE,
    SETTINGS_IDX_AUTO_SLEEP,
    SETTINGS_IDX_BADGE_TEXT,
    SETTINGS_IDX_SET_DATE,
    SETTINGS_IDX_SET_TIME,
    SETTINGS_IDX_CHANGE_PIN,
    SETTINGS_IDX_COUNT
};

static constexpr uint16_t MAX_LANGUAGES = 16;

static LockScreenView* s_lockScreen = nullptr;
static PinEntryView* s_pinEntry = nullptr;
static ListView* s_mainMenu = nullptr;
static ListView* s_toolsMenu = nullptr;
static ListView* s_settingsMenu = nullptr;
static SliderView* s_brightnessSlider = nullptr;
static SliderView* s_sleepSlider = nullptr;
static SliderView* s_timezoneSlider = nullptr;
static ListView* s_languageMenu = nullptr;
static DateInputView* s_dateInput = nullptr;
static TimeInputView* s_timeInput = nullptr;
static PinChangeView* s_pinChangeView = nullptr;
static PinChangeView* s_duressPinView = nullptr;
static BlePairingPromptView* s_pairingPrompt = nullptr;
static cdc::plugin_manager::PluginListView* s_pluginListView = nullptr;
 
// Numeric-comparison pairing is requested from the nimble_host task; the prompt
// must be shown from the main/UI task. The request is parked here under a mutex
// and the UI work is deferred via BLE_PAIRING_REQUEST.
struct PendingPairing {
    bool     valid = false;
    uint16_t connHandle = 0xFFFF;
    uint32_t passkey = 0;
};
static PendingPairing s_pendingPairing;
static SemaphoreHandle_t s_blePendingMutex = nullptr;

static UiDeps s_deps = {};

static ListItem s_mainMenuItems[MAIN_MENU_MAX_ITEMS];
static core::ModuleMenuItem s_mainMenuModuleItems[MAIN_MENU_MAX_ITEMS];
static uint8_t s_mainMenuPluginCount = 0;

static ListItem s_toolsItems[TOOLS_MAX_ITEMS];
static core::ModuleMenuItem s_toolsModuleItems[TOOLS_MAX_ITEMS];
static uint8_t s_toolsModuleCount = 0;

static ListItem s_settingsItems[SETTINGS_IDX_COUNT];

static ListItem s_languageItems[MAX_LANGUAGES];
static char     s_languageCodes[MAX_LANGUAGES][8];
static uint16_t s_languageCount = 0;

static int8_t s_lastMinute = -1;

static bool s_lastUsbConnected = false;
static bool s_lastCharging = false;
static bool s_lastWifiConnected = false;
static bool s_lastBleEnabled = false;
static bool s_lastBackgroundPlugin = false;
static bool s_lastBatteryPresent = false;
 
// Throttle for the battery-percent ADC sample on the lockscreen. The BQ25895
// ADC step is 20 mV, mapped over 1000 mV (3200-4200 mV) the linear curve gives
// ~2 %/step; an unrestricted per-tick sample makes ADC jitter flip the
// rendered percentage, marking the view dirty and triggering a partial EPD
// refresh on essentially every tick.
static constexpr uint32_t BATTERY_SAMPLE_INTERVAL_MS = 30000;
static uint32_t s_lastBatterySampleMs = 0;

static bool s_ignoreKeyUntilRelease = false;
 
// Set from the keypad task when the N+Y rescue chord is held; consumed by
// ui_process on the UI task, which performs the anti-block instant lock.
static std::atomic<bool> s_antiBlockLockRequested{false};

static inline uint8_t getPluginsIndex()  { return s_mainMenuPluginCount + MM_PLUGINS; }
static inline uint8_t getToolsIndex()    { return s_mainMenuPluginCount + MM_TOOLS; }
static inline uint8_t getSettingsIndex() { return s_mainMenuPluginCount + MM_SETTINGS; }
static inline uint8_t getMainMenuCount() { return s_mainMenuPluginCount + MAIN_MENU_FIXED_COUNT; }

static void onUnlockRequested();
static bool onPinVerify(const char* pin);
static void onPinSuccess();
static void onMainMenuSelect(uint16_t index, void* userData);
static void onToolsSelect(uint16_t index, void* userData);
static void onSettingsSelect(uint16_t index, void* userData);
static void onLanguageSelect(uint16_t index, void* userData);
static void rebuildLanguageMenu();
static void rebuildMenuLabels();
static void onInactivityTimeout();
static void clearKeypadBuffer();

void drawSignalBars(Gdey029T94* gfx, int x, int y, int8_t rssi, bool inverted) {
    if (!gfx) return;
 
    int bars;
    if (rssi > -50) bars = 4;
    else if (rssi > -60) bars = 3;
    else if (rssi > -70) bars = 2;
    else bars = 1;
 
    uint16_t fg = inverted ? EPD_WHITE : EPD_BLACK;
 
    int barWidth = 3;
    int gap = 1;
    int baseY = y + 13;
 
    for (int i = 0; i < 4; i++) {
        int barHeight = 4 + i * 3;
        int bx = x + i * (barWidth + gap);
        int by = baseY - barHeight;
 
        if (i < bars) {
            gfx->fillRect(bx, by, barWidth, barHeight, fg);
        } else {
            gfx->drawRect(bx, by, barWidth, barHeight, fg);
        }
    }
}

static void updateStatusIcon(StatusIcon icon, bool active, bool& last) {
    if (active == last) return;
    if (active) {
        s_lockScreen->addStatusIcon(icon);
    } else {
        s_lockScreen->removeStatusIcon(icon);
    }
    last = active;
}

static void updateBatteryIndicator() {
    bool present = s_deps.power->isBatteryPresent();
    uint32_t nowMs = static_cast<uint32_t>(esp_timer_get_time() / 1000ULL);
 
    if (present != s_lastBatteryPresent) {
        if (present) {
            s_lockScreen->removeStatusIcon(StatusIcon::NO_BATTERY);
            s_lockScreen->setBatteryPercent(s_deps.power->getBatteryPercent());
        } else {
            s_lockScreen->addStatusIcon(StatusIcon::NO_BATTERY);
            s_lockScreen->setBatteryPercent(0);
        }
        s_lastBatteryPresent = present;
        s_lastBatterySampleMs = nowMs;
        return;
    }
 
    if (!present) return;
 
    if (s_lastBatterySampleMs != 0 &&
        (nowMs - s_lastBatterySampleMs) < BATTERY_SAMPLE_INTERVAL_MS) {
        return;
    }
    s_lastBatterySampleMs = nowMs;
    s_lockScreen->setBatteryPercent(s_deps.power->getBatteryPercent());
}

void updatePowerStatusIcons() {
    if (!s_lockScreen || !s_deps.power) return;
 
    const bool usbConnected = s_deps.power->isUsbConnected();
    const hal::ChargeStatus chargeStatus = s_deps.power->getChargeStatus();
    const bool charging = (chargeStatus == hal::ChargeStatus::FAST_CHARGE ||
                           chargeStatus == hal::ChargeStatus::PRE_CHARGE);
 
    auto* wifi = hal::getWifiControllerInstance();
    const bool wifiConnected = wifi && wifi->isConnected();
 
    auto* ble = hal::getBluetoothControllerInstance();
    const bool bleEnabled = ble && ble->isEnabled();
 
    const bool backgroundPlugin =
        cdc::plugin_manager::PluginManager::instance().hasBackgroundPlugin();
 
    updateStatusIcon(StatusIcon::USB, usbConnected, s_lastUsbConnected);
    updateStatusIcon(StatusIcon::CHARGING, charging, s_lastCharging);
    updateStatusIcon(StatusIcon::WIFI, wifiConnected, s_lastWifiConnected);
    updateStatusIcon(StatusIcon::BLE, bleEnabled, s_lastBleEnabled);
    updateStatusIcon(StatusIcon::BACKGROUND, backgroundPlugin, s_lastBackgroundPlugin);
 
    updateBatteryIndicator();
}

static void clearKeypadBuffer() {
    if (!s_deps.keypad) return;
    while (s_deps.keypad->getNextKey() != hal::Key::KEY_NONE) {}
}

static void updateLockScreenClock() {
    if (!s_lockScreen) return;
    if (ViewStack::instance().current() != s_lockScreen) return;
 
    time_t now = time(nullptr);
    struct tm* t = localtime(&now);
    if (!t || t->tm_min == s_lastMinute) return;
 
    s_lastMinute = t->tm_min;
    char buf[40];
    snprintf(buf, sizeof(buf), "%02d:%02d", t->tm_hour, t->tm_min);
    s_lockScreen->setClock(buf);
    snprintf(buf, sizeof(buf), "%02d.%02d.%04d", t->tm_mday, t->tm_mon + 1, t->tm_year + 1900);
    s_lockScreen->setDate(buf);
}

static void onUnlockRequested() {
    clearKeypadBuffer();
    s_ignoreKeyUntilRelease = true;
 
    if (s_pinEntry) {
        s_pinEntry->clear();
        ViewStack::instance().push(s_pinEntry);
    }
}

static bool onPinVerify(const char* pin) {
    auto& pm = core::PinManager::instance();
    // Duress check runs before the badge-PIN verify. The duress PIN is forced
    // distinct from the badge PIN at set time, so the order is unambiguous.
    // selfDestruct() does not return; from the user's perspective entry is
    // indistinguishable from any other PIN attempt (no UI/log/timing tell).
    if (pm.hasDuressPin() && pm.isDuressPin(pin)) {
        core::selfDestruct();
    }
    return pm.verifyBadgePin(pin);
}

static bool onDuressPinSet(const char* currentPin, const char* newPin) {
    (void)currentPin;
    return core::PinManager::instance().setDuressPin(newPin);
}

void showDuressPinSetup() {
    if (!s_duressPinView) return;
    s_duressPinView->init(core::PinManager::BADGE_PIN_MIN, core::PinManager::BADGE_PIN_MAX);
    ViewStack::instance().push(s_duressPinView);
}

static void onPinSuccess() {
    ViewStack::instance().replace(s_mainMenu);
    core::ModuleRegistry::instance().dispatchUnlock();
    if (s_deps.display) s_deps.display->backlightOn();
}

static void onInactivityTimeout() {
    auto& pm = cdc::plugin_manager::PluginManager::instance();
    // No auto-lock while a prevent_sleep plugin holds the foreground.
    if (pm.activePluginPreventsSleep()) {
        ViewStack::instance().resetInactivityTimer();
        return;
    }
    // A non-background foreground plugin is unloaded on lock; a background
    // plugin is demoted and keeps running.
    pm.requestStopActivePlugin();
    while (ViewStack::instance().depth() > 1) {
        ViewStack::instance().pop();
    }
    s_ignoreKeyUntilRelease = true;
    clearKeypadBuffer();
}

static void performAntiBlockLock() {
    cdc::plugin_manager::PluginManager::instance().unloadAllFromRam();
 
    auto& stack = ViewStack::instance();
    while (stack.hasModal()) stack.hideModal();
    while (stack.depth() > 1) stack.pop();
 
    core::ModuleRegistry::instance().dispatchLock();
 
    s_ignoreKeyUntilRelease = true;
    clearKeypadBuffer();
    if (s_lockScreen) s_lockScreen->markDirty();
}

void rebuildMainMenu() {
    auto& moduleReg = core::ModuleRegistry::instance();
 
    s_mainMenuPluginCount = moduleReg.getMenuItems(
        core::MenuLocation::MAIN_MENU,
        s_mainMenuModuleItems,
        MAIN_MENU_MAX_ITEMS - MAIN_MENU_FIXED_COUNT
    );
 
    for (uint8_t i = 0; i < s_mainMenuPluginCount; i++) {
        s_mainMenuItems[i] = {s_mainMenuModuleItems[i].label, 0, false, nullptr};
    }
 
    s_mainMenuItems[getPluginsIndex()]  = {ui::tr("core.plugins"),  0, false, nullptr};
    s_mainMenuItems[getToolsIndex()]    = {ui::tr("core.tools"),    0, false, nullptr};
    s_mainMenuItems[getSettingsIndex()] = {ui::tr("core.settings"), 0, false, nullptr};
 
    if (s_mainMenu) {
        s_mainMenu->init(ui::tr("core.main_menu"), s_mainMenuItems, getMainMenuCount());
    }
}

struct FixedMenuEntry {
    const char* labelKey;   // i18n key
    uint8_t (*icon)();      // optional status icon getter (nullptr -> none)
    void (*action)();       // invoked when the entry is selected
};
 
static uint8_t toolsBluetoothIcon() {
    auto* ble = hal::getBluetoothControllerInstance();
    return static_cast<uint8_t>(ble && ble->isEnabled() ? '*' : 0);
}
 
static const FixedMenuEntry kToolsFixed[] = {
    {"core.wifi_menu",  nullptr,            showWifiMainMenu},
    {"core.bluetooth",  toolsBluetoothIcon, showBluetoothMenu},
    {"core.msg_beacon", nullptr,            showBeaconMenu},
    {"core.expert",     nullptr,            showExpertMenu},
};
static constexpr uint8_t TOOLS_FIXED_COUNT =
    static_cast<uint8_t>(sizeof(kToolsFixed) / sizeof(kToolsFixed[0]));

void rebuildToolsMenu() {
    for (uint8_t i = 0; i < TOOLS_FIXED_COUNT; i++) {
        s_toolsItems[i] = {ui::tr(kToolsFixed[i].labelKey),
                           kToolsFixed[i].icon ? kToolsFixed[i].icon() : uint8_t{0},
                           false, nullptr};
    }
 
    auto& moduleReg = core::ModuleRegistry::instance();
    s_toolsModuleCount = moduleReg.getMenuItems(
        core::MenuLocation::TOOLS_MENU,
        s_toolsModuleItems,
        TOOLS_MAX_ITEMS - TOOLS_FIXED_COUNT
    );
 
    for (uint8_t i = 0; i < s_toolsModuleCount; i++) {
        s_toolsItems[TOOLS_FIXED_COUNT + i] = {s_toolsModuleItems[i].label, 0, false, nullptr};
    }
 
    if (s_toolsMenu) {
        s_toolsMenu->init(ui::tr("core.tools"), s_toolsItems, TOOLS_FIXED_COUNT + s_toolsModuleCount);
    }
}

static void rebuildMenuLabels() {
    // Settings items
    s_settingsItems[SETTINGS_IDX_BRIGHTNESS] = {ui::tr("core.brightness"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_LANGUAGE] = {ui::tr("core.language"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_TIMEZONE] = {ui::tr("core.timezone"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_AUTO_SLEEP] = {ui::tr("core.auto_sleep"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_BADGE_TEXT] = {ui::tr("core.badge_text"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_SET_DATE] = {ui::tr("core.set_date"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_SET_TIME] = {ui::tr("core.set_time"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_CHANGE_PIN] = {ui::tr("core.change_pin"), 0, false, nullptr};
 
    if (s_settingsMenu) {
        s_settingsMenu->init(ui::tr("core.settings"), s_settingsItems, SETTINGS_IDX_COUNT);
    }
 
    rebuildMainMenu();
    rebuildToolsMenu();
}

static void onMainMenuSelect(uint16_t index, void* userData) {
    (void)userData;
 
    // Module items first
    if (index < s_mainMenuPluginCount) {
        auto& item = s_mainMenuModuleItems[index];
        if (item.getView) {
            IView* view = item.getView();
            if (view) ViewStack::instance().push(view);
        }
        return;
    }
 
    if (index == getPluginsIndex()) {
        if (!s_pluginListView) s_pluginListView = new cdc::plugin_manager::PluginListView();
        ViewStack::instance().push(s_pluginListView);
    } else if (index == getToolsIndex()) {
        ViewStack::instance().push(s_toolsMenu);
    } else if (index == getSettingsIndex()) {
        ViewStack::instance().push(s_settingsMenu);
    }
}

static void onToolsSelect(uint16_t index, void* userData) {
    (void)userData;
 
    switch (index) {
        case 0: showWifiMainMenu(); return;
        case 1: showBluetoothMenu(); return;
        case 2: showBeaconMenu(); return;
        case 3: showExpertMenu(); return;
    }
 
    uint8_t moduleIdx = index - TOOLS_FIXED_COUNT;
    if (moduleIdx < s_toolsModuleCount) {
        auto& item = s_toolsModuleItems[moduleIdx];
        if (item.getView) {
            IView* view = item.getView();
            if (view) ViewStack::instance().push(view);
        }
    }
}

static void onSettingsSelect(uint16_t index, void* userData) {
    (void)userData;
 
    switch (index) {
        case SETTINGS_IDX_BRIGHTNESS:
            ViewStack::instance().push(s_brightnessSlider);
            break;
        case SETTINGS_IDX_LANGUAGE:
            rebuildLanguageMenu();
            ViewStack::instance().push(s_languageMenu);
            break;
        case SETTINGS_IDX_TIMEZONE:
            ViewStack::instance().push(s_timezoneSlider);
            break;
        case SETTINGS_IDX_AUTO_SLEEP:
            ViewStack::instance().push(s_sleepSlider);
            break;
        case SETTINGS_IDX_BADGE_TEXT:
            settings::startBadgeTextEdit();
            break;
        case SETTINGS_IDX_SET_DATE:
            ViewStack::instance().push(s_dateInput);
            break;
        case SETTINGS_IDX_SET_TIME:
            ViewStack::instance().push(s_timeInput);
            break;
        case SETTINGS_IDX_CHANGE_PIN:
            if (s_pinChangeView) {
                s_pinChangeView->init(core::PinManager::BADGE_PIN_MIN, core::PinManager::BADGE_PIN_MAX);
                ViewStack::instance().push(s_pinChangeView);
            }
            break;
    }
}

static void rebuildLanguageMenu() {
    if (!s_languageMenu) return;
    auto& i18n = I18n::instance();
 
    s_languageCount = 0;
    auto addLanguage = [&](const char* code) {
        if (s_languageCount >= MAX_LANGUAGES) return;
        std::strncpy(s_languageCodes[s_languageCount], code,
                     sizeof(s_languageCodes[0]) - 1);
        s_languageCodes[s_languageCount][sizeof(s_languageCodes[0]) - 1] = '\0';
        s_languageItems[s_languageCount] = {i18n.languageName(code), 0, false, nullptr};
        ++s_languageCount;
    };
 
    addLanguage("en");
    for (const auto& lang : i18n.availableOverlayLanguages()) {
        addLanguage(lang.code.c_str());
    }
 
    s_languageMenu->init(ui::tr("core.language"), s_languageItems, s_languageCount);
    s_languageMenu->setOnSelect(onLanguageSelect);
 
    for (uint16_t i = 0; i < s_languageCount; ++i) {
        if (i18n.getLanguageCode() == s_languageCodes[i]) {
            s_languageMenu->setSelection(i);
            break;
        }
    }
}

static void onLanguageSelect(uint16_t index, void* userData) {
    (void)userData;
    if (index >= s_languageCount) return;
 
    I18n::instance().setLanguageCode(s_languageCodes[index]);
    cdc::plugin_manager::PluginManager::instance().reloadActiveLangOverlay();
    ViewStack::instance().pop();
}

bool isBadgeLocked() {
    return ViewStack::instance().depth() <= 1 &&
           ViewStack::instance().current() == s_lockScreen;
}

static void onBleNumericComparison(uint16_t connHandle, uint32_t passkey) {
    auto* ble = hal::getBluetoothControllerInstance();
 
    bool dropped = false;
    {
        core::MutexGuard guard(s_blePendingMutex);
        if (s_pendingPairing.valid) {
            dropped = true;
        } else {
            s_pendingPairing.connHandle = connHandle;
            s_pendingPairing.passkey = passkey;
            s_pendingPairing.valid = true;
        }
    }
    if (dropped) {
        if (ble) ble->respondToNumericComparison(connHandle, false);
        return;
    }
 
    if (!core::EventBus::instance().publish(core::EventType::BLE_PAIRING_REQUEST)) {
        {
            core::MutexGuard guard(s_blePendingMutex);
            s_pendingPairing.valid = false;
        }
        if (ble) ble->respondToNumericComparison(connHandle, false);
    }
}

static void onBlePairingRequestEvent(const core::Event& evt) {
    (void)evt;
    PendingPairing req;
    {
        core::MutexGuard guard(s_blePendingMutex);
        req = s_pendingPairing;
        s_pendingPairing.valid = false;
    }
    if (!req.valid) return;
 
    auto* ble = hal::getBluetoothControllerInstance();
    if (isBadgeLocked()) {
        if (ble) ble->respondToNumericComparison(req.connHandle, false);
        return;
    }
    if (!s_pairingPrompt) {
        s_pairingPrompt = new BlePairingPromptView();
    }
    s_pairingPrompt->prepare(req.connHandle, req.passkey);
    ViewStack::instance().showModal(s_pairingPrompt);
}

void ui_init(const UiDeps& deps) {
    s_deps = deps;
 
    // Initialize I18n
    I18n::instance().init();
 
    // Refresh menu labels whenever the active translation table changes,
    // so item label pointers stay in sync with the loaded overlay.
    I18n::instance().setOnLanguageChanged([]() {
        ui_rebuild_menus();
    });
 
    // Create LockScreen
    s_lockScreen = new LockScreenView();
    s_lockScreen->init();
 
    if (s_deps.keypad) {
        s_deps.keypad->setLongPressEnabled(true, 800);
        s_deps.keypad->setLongPressCallback([](hal::Key key) {
            char keyChar = static_cast<char>(key);
            ViewStack::instance().dispatchLongPress(keyChar);
        });
        s_deps.keypad->setPanicChordCallback([]() {
            s_antiBlockLockRequested.store(true, std::memory_order_relaxed);
        });
    }
 
    // Load display texts from NVS
    {
        nvs_handle_t nvs;
        char buf[64];
        size_t len;
 
        if (nvs_open("display", NVS_READONLY, &nvs) == ESP_OK) {
            len = sizeof(buf);
            if (nvs_get_str(nvs, "name", buf, &len) == ESP_OK && len > 1) {
                s_lockScreen->setDisplayName(buf);
            } else {
                s_lockScreen->setDisplayName(ui::tr("core.default_name"));
            }
 
            len = sizeof(buf);
            if (nvs_get_str(nvs, "info", buf, &len) == ESP_OK && len > 1) {
                s_lockScreen->setInfo(buf);
            } else {
                s_lockScreen->setInfo(ui::tr("core.default_info"));
            }
 
            len = sizeof(buf);
            if (nvs_get_str(nvs, "info2", buf, &len) == ESP_OK && len > 1) {
                s_lockScreen->setInfo2(buf);
            }
 
            nvs_close(nvs);
        } else {
            s_lockScreen->setDisplayName(ui::tr("core.default_name"));
            s_lockScreen->setInfo(ui::tr("core.default_info"));
        }
    }
 
    s_lockScreen->setOnUnlock(onUnlockRequested);
    s_lockScreen->setPreRenderCallback([]() {
        if (s_deps.power) {
            s_deps.power->refresh();
        }
        updatePowerStatusIcons();
    });
 
    if (!core::TropicSlotMap::instance().isValid()) {
        const char* msg = core::TropicSlotMap::instance().errorMessage();
        showToastAlertSticky(msg ? msg : "Slot map invalid");
    }
 
    // Set initial clock/date from RTC
    {
        time_t now = time(nullptr);
        struct tm* t = localtime(&now);
        if (t) {
            char buf[40];
            snprintf(buf, sizeof(buf), "%02d:%02d", t->tm_hour, t->tm_min);
            s_lockScreen->setClock(buf);
            snprintf(buf, sizeof(buf), "%02d.%02d.%04d", t->tm_mday, t->tm_mon + 1, t->tm_year + 1900);
            s_lockScreen->setDate(buf);
            s_lastMinute = t->tm_min;
        }
    }
 
    // Set initial battery/charging status
    if (s_deps.power) {
        s_lockScreen->setBatteryPercent(s_deps.power->getBatteryPercent());
        if (s_deps.power->getChargeStatus() == hal::ChargeStatus::FAST_CHARGE ||
            s_deps.power->getChargeStatus() == hal::ChargeStatus::PRE_CHARGE) {
            s_lockScreen->addStatusIcon(StatusIcon::CHARGING);
        }
        if (s_deps.power->isUsbConnected()) {
            s_lockScreen->addStatusIcon(StatusIcon::USB);
        }
        s_lastUsbConnected = s_deps.power->isUsbConnected();
        s_lastCharging = (s_deps.power->getChargeStatus() == hal::ChargeStatus::FAST_CHARGE ||
                          s_deps.power->getChargeStatus() == hal::ChargeStatus::PRE_CHARGE);
    }
 
    // Create PinEntryView
    s_pinEntry = new PinEntryView();
    s_pinEntry->init(ui::tr("core.enter_pin"), 8, 3);
    s_pinEntry->setOnVerify(onPinVerify);
    s_pinEntry->setOnSuccess(onPinSuccess);
 
    // Create Main Menu
    s_mainMenu = new ListView();
    s_mainMenu->setOnSelect(onMainMenuSelect);
 
    // Tools Menu
    s_toolsMenu = new ListView();
    s_toolsMenu->setOnSelect(onToolsSelect);
 
    // Build menus with module items
    rebuildMainMenu();
    rebuildToolsMenu();
 
    // Settings Menu
    s_settingsItems[SETTINGS_IDX_BRIGHTNESS] = {ui::tr("core.brightness"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_LANGUAGE] = {ui::tr("core.language"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_TIMEZONE] = {ui::tr("core.timezone"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_AUTO_SLEEP] = {ui::tr("core.auto_sleep"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_BADGE_TEXT] = {ui::tr("core.badge_text"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_SET_DATE] = {ui::tr("core.set_date"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_SET_TIME] = {ui::tr("core.set_time"), 0, false, nullptr};
    s_settingsItems[SETTINGS_IDX_CHANGE_PIN] = {ui::tr("core.change_pin"), 0, false, nullptr};
    s_settingsMenu = new ListView();
    s_settingsMenu->init(ui::tr("core.settings"), s_settingsItems, SETTINGS_IDX_COUNT);
    s_settingsMenu->setOnSelect(onSettingsSelect);
 
    // Initialize settings handlers
    settings::init(s_deps.display, s_deps.sleep, s_lockScreen);
 
    // Brightness Slider
    s_brightnessSlider = new SliderView();
    uint16_t currentBrightness = s_deps.display ? s_deps.display->getBacklight() / 10 : 50;
    s_brightnessSlider->init(ui::tr("core.brightness"), 0, 100, currentBrightness, 1, "%");
    s_brightnessSlider->setStepCallback(settings::brightnessStepCallback);
    s_brightnessSlider->setOnSave(settings::onBrightnessSave);
    s_brightnessSlider->setOnChange(settings::onBrightnessChange);
 
    // Auto Sleep Slider
    s_sleepSlider = new SliderView();
    uint16_t currentSleepMin = 0;
    if (s_deps.sleep) {
        currentSleepMin = static_cast<uint16_t>(s_deps.sleep->getLightSleepInterval() / 60);
    }
    s_sleepSlider->init(ui::tr("core.auto_sleep"), 0, 60, currentSleepMin, 1, ui::tr("core.minutes"));
    s_sleepSlider->setZeroLabel(ui::tr("core.never"));
    s_sleepSlider->setOnSave(settings::onSleepIntervalSave);
 
    // Timezone Slider
    s_timezoneSlider = new SliderView();
    {
        auto* rtcTz = hal::getRtcInstance();
        int8_t currentTz = rtcTz ? rtcTz->getTimezoneOffset() : 0;
        uint16_t tzSliderValue = static_cast<uint16_t>(currentTz + 12);
        s_timezoneSlider->init(ui::tr("core.timezone"), 0, 26, tzSliderValue, 1, "h");
        s_timezoneSlider->setDisplayOffset(-12);
        s_timezoneSlider->setOnSave(settings::onTimezoneSave);
    }
 
    // Language Menu - populated from the overlay files present (English only
    // until the plugins FAT is mounted and the overlay scan runs at boot).
    s_languageMenu = new ListView();
    rebuildLanguageMenu();
 
    // Date/Time Input Views
    time_t now = time(nullptr);
    struct tm* tm = localtime(&now);
    s_dateInput = new DateInputView();
    s_dateInput->init(ui::tr("core.set_date"),
                      tm ? tm->tm_mday : 1,
                      tm ? tm->tm_mon + 1 : 1,
                      tm ? tm->tm_year + 1900 : 2026);
    s_dateInput->setOnConfirm(settings::onDateConfirm);
 
    s_timeInput = new TimeInputView();
    s_timeInput->init(ui::tr("core.set_time"),
                      tm ? tm->tm_hour : 12,
                      tm ? tm->tm_min : 0);
    s_timeInput->setOnConfirm(settings::onTimeConfirm);
 
    // PIN Change View
    s_pinChangeView = new PinChangeView();
    s_pinChangeView->init(core::PinManager::BADGE_PIN_MIN, core::PinManager::BADGE_PIN_MAX);
    s_pinChangeView->setOnComplete(settings::onPinChangeComplete);
 
    // Duress / self-destruct PIN setup: same wizard, step 1 verifies the badge
    // PIN, steps 2-3 set the duress PIN (armed via onDuressPinSet).
    s_duressPinView = new PinChangeView();
    s_duressPinView->init(core::PinManager::BADGE_PIN_MIN, core::PinManager::BADGE_PIN_MAX);
    s_duressPinView->setTitle(ui::tr("core.set_duress_pin"));
    s_duressPinView->setChangeCallback(onDuressPinSet);
    s_duressPinView->setOnComplete(settings::onPinChangeComplete);
 
    // Initialize PinManager
    core::PinManager::instance().init();
 
    // Initialize SleepManager
    SleepManager::instance().init(s_deps.sleep, s_deps.power, s_lockScreen);
 
    // Push to ViewStack
    ViewStack::instance().push(s_lockScreen);
 
    // Configure inactivity timeout
    ViewStack::instance().setInactivityTimeout(onInactivityTimeout, INACTIVITY_TIMEOUT_MS);
 
    // Subscribe to module error events
    core::EventBus::instance().subscribe(onModuleErrorEvent,
                                         core::EventBus::eventMask(core::EventType::MODULE_ERROR));
 
    // Central numeric-comparison pairing prompt: the request arrives on the
    // nimble_host task and is deferred to the main task for UI work.
    if (!s_blePendingMutex) {
        s_blePendingMutex = xSemaphoreCreateMutex();
    }
    core::EventBus::instance().subscribe(onBlePairingRequestEvent,
                                         core::EventBus::eventMask(core::EventType::BLE_PAIRING_REQUEST));
    if (auto* ble = hal::getBluetoothControllerInstance()) {
        ble->addNumericComparisonCallback(onBleNumericComparison);
    }
 
    // Badge-to-badge message transfer: consent prompt, peer picker, progress.
    msgTransferUiInit();
 
    // Serial callbacks
    registerBackupSerialCommand();
    serial::SerialCmd::setTextCallback([](const char* field, const char* value) {
        if (!s_lockScreen) return;
        // Serial text arrives already as CP437 (matches T9 and the display
        // pipeline), so it is stored verbatim.
        if (strcmp(field, "name") == 0) {
            s_lockScreen->setDisplayName(value);
            settings::saveDisplayField("name", value);
        } else if (strcmp(field, "info") == 0) {
            s_lockScreen->setInfo(value);
            settings::saveDisplayField("info", value);
        } else if (strcmp(field, "info2") == 0) {
            s_lockScreen->setInfo2(value);
            settings::saveDisplayField("info2", value);
        }
    });
 
    serial::SerialCmd::setTimeCallback([]() {
        if (!s_lockScreen) return;
        time_t now = time(nullptr);
        struct tm* tm = localtime(&now);
        if (tm) {
            char buf[32];
            snprintf(buf, sizeof(buf), "%02d:%02d", tm->tm_hour, tm->tm_min);
            s_lockScreen->setClock(buf);
            snprintf(buf, sizeof(buf), "%02d.%02d.%d", tm->tm_mday, tm->tm_mon + 1, tm->tm_year + 1900);
            s_lockScreen->setDate(buf);
        }
    });
}

void ui_on_modules_ready() {
    rebuildToolsMenu();
    rebuildMainMenu();
}

void ui_rebuild_menus() {
    rebuildMenuLabels();
}

void prepareForBootloaderReset() {
    if (s_lockScreen) {
        s_lockScreen->setDisplayName("BOOTLOADER MODE");
        s_lockScreen->setInfo("Awaiting flash...");
        s_lockScreen->setInfo2("Press RESET to resume");
        s_lockScreen->markDirty();
    }
 
    auto& stack = ViewStack::instance();
    while (stack.hasModal()) {
        stack.hideModal();
    }
    while (stack.depth() > 1) {
        stack.pop();
    }
 
    if (s_lockScreen) {
        s_lockScreen->render(false);
        if (s_deps.display) {
            s_deps.display->flushSync(hal::RefreshMode::FULL);
            // Defensive wait in case the driver returns from flushSync()
            // before the panel busy line has fully deasserted.
            for (int i = 0; i < 50 && s_deps.display->isBusy(); ++i) {
                vTaskDelay(pdMS_TO_TICKS(20));
            }
            s_deps.display->backlightOff();
        }
    }
}

void ui_process(uint32_t nowMs) {
    // Rescue chord (N+Y) requested an anti-block lock: bypass the current view
    // entirely and force a clean locked state before any key dispatch.
    if (s_antiBlockLockRequested.exchange(false, std::memory_order_relaxed)) {
        performAntiBlockLock();
    }
 
    // Update status icons when on lock screen
    if (s_lockScreen && ViewStack::instance().current() == s_lockScreen) {
        updatePowerStatusIcons();
    }
 
    // Update clock at minute change
    updateLockScreenClock();
 
    // Keypad input
    if (s_deps.keypad) {
        if (s_ignoreKeyUntilRelease) {
            clearKeypadBuffer();
            if (!s_deps.keypad->anyKeyDown()) {
                s_ignoreKeyUntilRelease = false;
            }
        } else {
            hal::Key key = s_deps.keypad->getNextKey();
            if (key != hal::Key::KEY_NONE) {
                char keyChar = static_cast<char>(key);
                ViewStack::instance().dispatchKey(keyChar);
                SleepManager::instance().resetTimer(nowMs);
            }
        }
    }
 
    settings::processPendingBadgeText();
    msgTransferUiProcess(nowMs);
 
    nowMs = static_cast<uint32_t>(esp_timer_get_time() / 1000ULL);
    ViewStack::instance().dispatchTick(nowMs);
    if (ViewStack::instance().depth() > 1) {
        ViewStack::instance().checkInactivity(nowMs);
    } else {
        // On lock screen: check for light sleep
        SleepManager::instance().checkLockScreenSleep(nowMs);
    }
 
    // Render if needed
    if (ViewStack::instance().needsRender()) {
        ViewStack::instance().render();
    }
}
 
} // namespace cdc::ui