espnav-display/README.md

/**
 * @file main.cpp
 * @brief Marine Navigation Display — application entry point.
 *
 * Boot sequence
 * ─────────────
 * 1. Initialise Serial, NeoPixel LED, LittleFS config.
 * 2. Check for AP-mode button combo held at boot.
 *    If combo detected (or first boot): start WiFi AP + web server.
 * 3. Otherwise start BLE scanning for the Marine Gateway.
 * 4. main loop:
 *    a. Poll touch buttons.
 *    b. Handle page navigation events.
 *    c. Check BLE status → update LED.
 *    d. Render display (partial refresh where possible).
 *    e. Run WiFi server tasks.
 *
 * WiFi AP ↔ BLE co-existence
 * ──────────────────────────
 * The ESP32-S3 radio is shared. We run in one of two mutually exclusive modes:
 *   MODE_BLE  — BLE client active, WiFi off.
 *   MODE_WIFI — WiFi AP active, BLE off (configuration / OTA mode).
 *
 * The user switches modes via the NEXT+PREV button combo (hold 3 s).
 */

#include <Arduino.h>
#include "Config.h"
#include "ConfigManager.h"
#include "BleManager.h"
#include "DisplayManager.h"
#include "WifiManager.h"
#include "TouchManager.h"
#include "StatusLed.h"

// =============================================================================
// Application state
// =============================================================================

enum class AppMode { BLE, WIFI_AP };
static AppMode  _mode         = AppMode::BLE;
static bool     _otaInProgress = false;

// Cached WiFi status for LED
static AppState::WifiStatus _wifiStatus = AppState::WifiStatus::OFF;

// =============================================================================
// Forward declarations
// =============================================================================
static void enterBleMode();
static void enterApMode();
static void handleTouchEvents();
static void updateDisplay();

// =============================================================================
// setup()
// =============================================================================

void setup() {
    Serial.begin(115200);
    delay(200);
    Serial.println("\n╔═══════════════════════════════╗");
    Serial.println("║  Marine Navigation Display    ║");
    Serial.printf( "║  v%-28s║\n", APP_VERSION);
    Serial.println("╚═══════════════════════════════╝");

    // ── Status LED ────────────────────────────────────────────────────────────
    statusLed.begin();
    statusLed.setColor(0xFFFFFF, 20);  // brief white flash on boot

    // ── Persistent config ─────────────────────────────────────────────────────
    if (!configManager.begin()) {
        Serial.println("[MAIN] FATAL: Config init failed");
        // Continue with defaults — non-fatal
    }

    // ── Display ───────────────────────────────────────────────────────────────
    displayManager.begin();  // Shows splash screen

    // ── Touch ─────────────────────────────────────────────────────────────────
    touchManager.begin();

    // ── Detect boot-time AP combo (hold NEXT+PREV while powering on) ──────────
    // Sample touch pads for 500 ms at boot
    uint32_t comboStart = millis();
    bool comboDetected  = false;
    while (millis() - comboStart < 500) {
        if (touchRead(Pins::TOUCH_NEXT)   < Touch::THRESHOLD &&
            touchRead(Pins::TOUCH_PREV)   < Touch::THRESHOLD) {
            comboDetected = true;
            break;
        }
        delay(10);
    }

    if (comboDetected) {
        Serial.println("[MAIN] Boot combo detected → entering AP mode");
        enterApMode();
    } else {
        enterBleMode();
    }
}

// =============================================================================
// loop()
// =============================================================================

void loop() {
    // ── Touch input ───────────────────────────────────────────────────────────
    touchManager.update();
    handleTouchEvents();

    // ── Status LED ────────────────────────────────────────────────────────────
    statusLed.update(bleManager.status(), _wifiStatus, _otaInProgress);

    // ── BLE mode tasks ────────────────────────────────────────────────────────
    if (_mode == AppMode::BLE) {
        bleManager.update();

        // Show BLE status banner when not connected
        static AppState::BleStatus prevBleStatus = AppState::BleStatus::IDLE;
        AppState::BleStatus curStatus = bleManager.status();
        if (curStatus != prevBleStatus) {
            prevBleStatus = curStatus;
            if (curStatus != AppState::BleStatus::CONNECTED) {
                displayManager.showBleStatus(curStatus);
            }
        }
    }

    // ── WiFi mode tasks ───────────────────────────────────────────────────────
    if (_mode == AppMode::WIFI_AP) {
        wifiManager.update();
    }

    // ── Display render ────────────────────────────────────────────────────────
    if (_mode == AppMode::BLE && !_otaInProgress) {
        updateDisplay();
    }

    // Small yield to let background tasks run
    delay(20);
}

// =============================================================================
// Mode transitions
// =============================================================================

static void enterBleMode() {
    Serial.println("[MAIN] Entering BLE mode");
    _mode       = AppMode::BLE;
    _wifiStatus = AppState::WifiStatus::OFF;

    if (wifiManager.isActive()) wifiManager.stop();

    bleManager.begin();
    displayManager.forceFullRefresh();
}

static void enterApMode() {
    Serial.println("[MAIN] Entering WiFi AP mode");
    _mode       = AppMode::WIFI_AP;
    _wifiStatus = AppState::WifiStatus::AP_ACTIVE;

    // BLE and WiFi share the radio; stop BLE first (NimBLE deinit is implicit
    // when WiFi takes over, but we force a clean state)
    // Note: NimBLEDevice::deinit(true) could be called here if needed.

    const AppConfig& cfg = configManager.config();
    wifiManager.begin(cfg.apSSID, cfg.apPassword);
    displayManager.showApScreen(cfg.apSSID, WifiManager::AP_IP);
}

// =============================================================================
// Touch event dispatcher
// =============================================================================

static void handleTouchEvents() {
    // AP combo (NEXT + PREV held 3 s)
    if (touchManager.apCombo()) {
        if (_mode == AppMode::BLE) {
            enterApMode();
        } else {
            enterBleMode();
        }
        return;
    }

    if (_mode == AppMode::BLE) {
        if (touchManager.nextPressed()) {
            configManager.nextPage();
            displayManager.forceFullRefresh();
            Serial.printf("[MAIN] Page → %u\n", configManager.activePage());
        }
        if (touchManager.prevPressed()) {
            configManager.prevPage();
            displayManager.forceFullRefresh();
            Serial.printf("[MAIN] Page ← %u\n", configManager.activePage());
        }
        if (touchManager.actionPressed()) {
            // Force a full e-ink refresh (clears ghosting)
            displayManager.forceFullRefresh();
            Serial.println("[MAIN] Manual full refresh");
        }
    }
}

// =============================================================================
// Display update
// =============================================================================

static void updateDisplay() {
    BoatState state;
    bleManager.getBoatState(state);

    const AppConfig&  cfg  = configManager.config();
    const PageConfig& page = cfg.pages[cfg.activePage];

    displayManager.render(state, page);
}