wifi_client.hpp

#pragma once
 
#include "libxr_def.hpp"
#include "libxr_rw.hpp"
#include "net.hpp"
 
namespace LibXR
{
 
class WifiClient : public NetworkInterface
{
 public:
  // =========================
  // 类型定义 / Type Definitions
  // =========================
 
  enum class WifiError
  {
    NONE,                   
    ALREADY_ENABLED,        
    NOT_ENABLED,            
    CONNECTION_TIMEOUT,     
    AUTHENTICATION_FAILED,  
    DHCP_FAILED,            
    SSID_NOT_FOUND,         
    INVALID_CONFIG,         
    HARDWARE_FAILURE,       
    SCAN_FAILED,            
    UNKNOWN,                
  };
 
  enum class Security
  {
    OPEN,             
    WPA2_PSK,         
    WPA2_ENTERPRISE,  
    UNKNOWN,          
  };
 
  struct EnterpriseConfig
  {
    const char* identity;     
    const char* username;     
    const char* password;     
    const char* ca_cert;      
    const char* client_cert;  
    const char* client_key;   
  };
 
  struct StaticIPConfig
  {
    IPAddressRaw ip;       
    IPAddressRaw gateway;  
    IPAddressRaw netmask;  
    IPAddressRaw dns;      
  };
 
  struct Config
  {
    char ssid[33];                           
    char password[64];                       
    Security security = Security::WPA2_PSK;  
 
    const EnterpriseConfig* enterprise_config =
        nullptr;  
    const StaticIPConfig* static_ip_config =
        nullptr;  
 
    bool use_dhcp = true;  
  };
 
  struct ScanResult
  {
    char ssid[33]{};                        
    int rssi = 0;                           
    Security security = Security::UNKNOWN;  
  };
 
  using WifiCallback = LibXR::Callback<WifiError>;
 
  virtual ~WifiClient() = default;
 
  virtual bool Enable() override = 0;
 
  virtual void Disable() override = 0;
 
  virtual bool IsConnected() const override = 0;
 
  virtual IPAddressRaw GetIPAddress() const override = 0;
 
  virtual MACAddressRaw GetMACAddress() const override = 0;
 
  virtual WifiError Connect(const Config& config) = 0;
 
  virtual WifiError Disconnect() = 0;
 
  virtual WifiError Scan(ScanResult* out_list, size_t max_count, size_t& out_found) = 0;
 
  virtual int GetRSSI() const = 0;
};
 
}  // namespace LibXR