IWifiController.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_core/IService.h"
#include <cstdint>
#include <cstddef>
 
namespace cdc::hal {

enum class WifiMode : uint8_t {
    OFF,        // WiFi disabled
    STA,        // Station mode (connect to AP)
    AP,         // Access Point mode
    STA_AP      // Both modes simultaneously
};

enum class WifiSecurity : uint8_t {
    OPEN,
    WEP,
    WPA_PSK,
    WPA2_PSK,
    WPA3_PSK,
    WPA2_ENTERPRISE
};

enum class WifiState : uint8_t {
    DISCONNECTED,
    CONNECTING,
    CONNECTED,
    CONNECTION_FAILED,
    GOT_IP
};

struct WifiScanResult {
    char ssid[33];          // SSID (max 32 chars + null)
    uint8_t bssid[6];       // MAC address
    int8_t rssi;            // Signal strength in dBm
    uint8_t channel;        // WiFi channel
    WifiSecurity security;  // Security type
};

class IWifiController : public core::IService {
public:
    virtual ~IWifiController() = default;

    virtual bool enable(WifiMode mode = WifiMode::STA) = 0;

    virtual void disable() = 0;

    virtual bool isEnabled() const = 0;

    virtual WifiMode getMode() const = 0;

    virtual WifiState getWifiState() const = 0;

    virtual bool connect(const char* ssid, const char* password,
                         uint32_t timeoutMs = 10000) = 0;

    virtual void disconnect() = 0;

    virtual bool isConnected() const = 0;

    virtual const char* getCurrentSsid() const = 0;

    virtual bool getIpAddress(char* ip, size_t len) const = 0;

    virtual bool getMacAddress(uint8_t* mac) const = 0;

    virtual int8_t getRssi() const = 0;

    static constexpr uint8_t MAX_SCAN_RESULTS = 32;

    virtual bool startScan() = 0;

    virtual bool isScanComplete() const = 0;

    virtual uint8_t getScanResults(WifiScanResult* results, uint8_t maxResults) = 0;
 
    // Access Point mode functions

    virtual bool startAp(const char* ssid, const char* password = nullptr,
                         uint8_t channel = 1) = 0;

    virtual uint8_t getConnectedStations() const = 0;
};
 
// Factory function
IWifiController* getWifiControllerInstance();
 
} // namespace cdc::hal