WifiHandlers.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_hal/IWifiController.h"
#include <cstdint>
 
namespace cdc::ui {
 
// WiFi timeout constants (milliseconds)
static constexpr uint32_t WIFI_CONNECT_TIMEOUT_DEFAULT_MS = 15000;
static constexpr uint32_t WIFI_CONNECT_TIMEOUT_MIN_MS     = 3000;
static constexpr uint32_t WIFI_CONNECT_TIMEOUT_MAX_MS     = 60000;
static constexpr uint32_t WIFI_SCAN_TIMEOUT_MS = 10000;
static constexpr uint32_t NTP_SYNC_TIMEOUT_MS = 10000;
 
// WiFi Setup Wizard State
struct WifiWizard {
    char ssid[33] = {};
    char password[65] = {};
    hal::WifiSecurity security = hal::WifiSecurity::WPA2_PSK;
    bool useDhcp = true;
    char staticIp[16] = {};
    char gateway[16] = {};
    char netmask[16] = "255.255.255.0";
    bool fromScan = false;
 
    void reset();
};
 
// WiFi Stored Configuration
struct WifiConfig {
    char ssid[33] = {};
    char password[65] = {};
    uint8_t security = 0;
    bool useDhcp = true;
    uint32_t staticIp = 0;
    uint32_t gateway = 0;
    uint32_t netmask = 0;
    bool valid = false;
};
 
// WiFi management handler class
class WifiHandlers {
public:
    static WifiHandlers& instance();
 
    // Config persistence
    void loadConfig();
    void saveConfig();
    WifiConfig& config() { return config_; }
    WifiWizard& wizard() { return wizard_; }

    void saveCredentials(const char* ssid, const char* password);

    void clearConfig();

    uint32_t getConnectTimeoutMs() const;

    bool setConnectTimeoutMs(uint32_t ms);
 
    // Connection management
    bool connect();
    void disconnect();
    bool isConnected() const;

    bool ensureConnected();

    bool setUserEnabled(bool enabled);

    bool isUserEnabled() const { return userEnabled_; }

    void persistUserIntent(bool enabled) {
        userEnabled_ = enabled;
        persistUserEnabled(enabled);
    }

    bool acquire();

    void release();

    void restoreOnBoot();

    bool syncNtp(bool disconnectAfter = true);
 
    // Helper: IP validation
    static bool isValidIpAddress(const char* ip);
 
    // Get connection error message
    const char* getLastError() const { return lastError_; }
 
private:
    WifiHandlers() = default;
 
    WifiConfig config_;
    WifiWizard wizard_;
    const char* lastError_ = nullptr;
 
    bool userEnabled_ = false;
    int holdCount_ = 0;
 
    static bool isValidIpOctet(int val);
    uint32_t parseIpAddress(const char* ip) const;
 
    void persistUserEnabled(bool enabled);
    void maybeRelease();
};
 
} // namespace cdc::ui