LibXR::LinuxWifiClient Class Reference

Linux Wi-Fi 客户端实现 / Linux Wi-Fi client implementation. More...

#include <linux_wifi_client.hpp>

Inheritance diagram for LibXR::LinuxWifiClient:

Collaboration diagram for LibXR::LinuxWifiClient:

Public Member Functions
	LinuxWifiClient (const char *ifname=nullptr)
	构造客户端对象 / Construct client object
	~LinuxWifiClient () override
	析构函数 / Destructor
bool	Enable () override
	启用网络接口（WiFi） / Enable the network interface
void	Disable () override
	禁用网络接口（WiFi） / Disable the network interface
bool	IsConnected () const override
	检查是否已连接 / Check if currently connected
IPAddressRaw	GetIPAddress () const override
	获取当前 IP 地址 / Get current IP address
MACAddressRaw	GetMACAddress () const override
	获取当前 MAC 地址 / Get MAC address
WifiError	Connect (const Config &config) override
	连接到指定 WiFi 网络 / Connect to a WiFi network
WifiError	Disconnect () override
	断开当前 WiFi 连接 / Disconnect from the WiFi network
WifiError	Scan (ScanResult *out_list, size_t max_count, size_t &out_found) override
	扫描可用网络 / Scan for available WiFi networks
int	GetRSSI () const override
	获取当前 WiFi 信号强度（RSSI） / Get current signal strength
Public Member Functions inherited from LibXR::WifiClient
virtual	~WifiClient ()=default
	析构函数 / Destructor
Public Member Functions inherited from LibXR::NetworkInterface

Additional Inherited Members
Public Types inherited from LibXR::WifiClient
enum class	WifiError {   NONE , ALREADY_ENABLED , NOT_ENABLED , CONNECTION_TIMEOUT ,   AUTHENTICATION_FAILED , DHCP_FAILED , SSID_NOT_FOUND , INVALID_CONFIG ,   HARDWARE_FAILURE , SCAN_FAILED , UNKNOWN }
	WiFi 错误码 / Enumeration of WiFi error codes. More...
enum class	Security { OPEN , WPA2_PSK , WPA2_ENTERPRISE , UNKNOWN }
	WiFi 安全类型 / WiFi security types. More...
using	WifiCallback = LibXR::Callback<WifiError>
	WiFi 状态回调类型 / Callback type for WiFi status.

Detailed Description

Linux Wi-Fi 客户端实现 / Linux Wi-Fi client implementation.

Definition at line 25 of file linux_wifi_client.hpp.

Constructor & Destructor Documentation

LinuxWifiClient()

LibXR::LinuxWifiClient::LinuxWifiClient ( const char * ifname = nullptr )

inline

构造客户端对象 / Construct client object

Parameters

ifname

网卡名，空则自动探测 / Interface name, auto-detect when null

Definition at line 32 of file linux_wifi_client.hpp.

  {
    if (ifname)
    {
      strncpy(ifname_cstr_, ifname, sizeof(ifname_cstr_) - 1);
    }
    else
    {
      std::string iface = DetectWifiInterface();
      if (iface.empty())
      {
        XR_LOG_ERROR("Wi-Fi interface not found");
        REQUIRE(false);
      }
      else
      {
        strncpy(ifname_cstr_, iface.c_str(), sizeof(ifname_cstr_) - 1);
      }
    }
 
    socket_path_ = "/var/run/wpa_supplicant/" + std::string(ifname_cstr_);
  }

~LinuxWifiClient()

LibXR::LinuxWifiClient::~LinuxWifiClient ( )

inlineoverride

析构函数 / Destructor

Definition at line 58 of file linux_wifi_client.hpp.

  {
    Disconnect();
    if (ctrl_)
    {
      wpa_ctrl_close(ctrl_);
    }
  }

Member Function Documentation

Connect()

WifiError LibXR::LinuxWifiClient::Connect ( const Config & config )

inlineoverridevirtual

连接到指定 WiFi 网络 / Connect to a WiFi network

Parameters

[in]

config

WiFi 连接配置 / Configuration parameters

Returns

WifiError 连接结果 / Error code

Implements LibXR::WifiClient.

Definition at line 151 of file linux_wifi_client.hpp.

  {
    std::string out;
    SendCommand("REMOVE_NETWORK all", out);
    SendCommand("ADD_NETWORK", out);
    int netid = atoi(out.c_str());
    if (netid < 0)
    {
      XR_LOG_ERROR("ADD_NETWORK failed: %s", out.c_str());
      return WifiError::HARDWARE_FAILURE;
    }
 
    std::stringstream cmd;
    cmd << "SET_NETWORK " << netid << " ssid \"" << config.ssid << "\"";
    if (!SendCommand(cmd.str().c_str(), out) || out.find("OK") == std::string::npos)
    {
      XR_LOG_ERROR("SET_NETWORK ssid failed: %s", out.c_str());
      return WifiError::AUTHENTICATION_FAILED;
    }
 
    cmd.str("");
    cmd << "SET_NETWORK " << netid << " psk \"" << config.password << "\"";
    if (!SendCommand(cmd.str().c_str(), out) || out.find("OK") == std::string::npos)
    {
      XR_LOG_ERROR("SET_NETWORK psk failed: %s", out.c_str());
      return WifiError::AUTHENTICATION_FAILED;
    }
 
    std::vector<std::string> cleanup_cmds = {
        "key_mgmt WPA-PSK", "eap NONE", "phase1 \"\"", "identity \"\"", "password \"\"",
    };
    for (const auto& line : cleanup_cmds)
    {
      cmd.str("");
      cmd << "SET_NETWORK " << netid << " " << line;
      SendCommand(cmd.str().c_str(), out);
    }
 
    cmd.str("");
    cmd << "ENABLE_NETWORK " << netid;
    if (!SendCommand(cmd.str().c_str(), out) || out.find("OK") == std::string::npos)
    {
      XR_LOG_ERROR("ENABLE_NETWORK failed: %s", out.c_str());
      return WifiError::HARDWARE_FAILURE;
    }
 
    cmd.str("");
    cmd << "SELECT_NETWORK " << netid;
    SendCommand(cmd.str().c_str(), out);
 
    const int TIMEOUT_MS = 30000;
    const int INTERVAL_MS = 300;
    int elapsed = 0;
 
    while (elapsed < TIMEOUT_MS)
    {
      std::string status;
      SendCommand("STATUS", status);
 
      if (status.find("wpa_state=COMPLETED") != std::string::npos)
      {
        XR_LOG_PASS("Wi-Fi Connected to SSID: %s", config.ssid);
        return WifiError::NONE;
      }
 
      if (status.find("wpa_state=INACTIVE") != std::string::npos)
      {
        XR_LOG_ERROR("Wi-Fi Connection failed: %s", status.c_str());
        return WifiError::AUTHENTICATION_FAILED;
      }
 
      LibXR::Thread::Sleep(INTERVAL_MS);
      elapsed += INTERVAL_MS;
    }
 
    XR_LOG_ERROR("Wi-Fi Connection timeout");
    return WifiError::CONNECTION_TIMEOUT;
  }

Disable()

void LibXR::LinuxWifiClient::Disable ( )

inlineoverridevirtual

禁用网络接口（WiFi） / Disable the network interface

Implements LibXR::WifiClient.

Definition at line 83 of file linux_wifi_client.hpp.

  {
    Disconnect();
    if (ctrl_)
    {
      wpa_ctrl_close(ctrl_);
      ctrl_ = nullptr;
    }
  }

Disconnect()

WifiError LibXR::LinuxWifiClient::Disconnect ( )

inlineoverridevirtual

断开当前 WiFi 连接 / Disconnect from the WiFi network

Returns

WifiError 断开结果 / Error code

Implements LibXR::WifiClient.

Definition at line 230 of file linux_wifi_client.hpp.

  {
    std::string out;
    SendCommand("DISCONNECT", out);
    SendCommand("REMOVE_NETWORK all", out);
    if (IsConnected())
    {
      return WifiError::UNKNOWN;
    }
    return WifiError::NONE;
  }

Enable()

bool LibXR::LinuxWifiClient::Enable ( )

inlineoverridevirtual

启用网络接口（WiFi） / Enable the network interface

Returns

true 表示成功 / true if enabled successfully

Implements LibXR::WifiClient.

Definition at line 67 of file linux_wifi_client.hpp.

  {
    if (ctrl_)
    {
      return true;
    }
    ctrl_ = wpa_ctrl_open(socket_path_.c_str());
    if (ctrl_)
    {
      XR_LOG_PASS("Wi-Fi enabled: %s", socket_path_.c_str());
      return true;
    }
    XR_LOG_ERROR("Wi-Fi enable failed: %s", socket_path_.c_str());
    return false;
  }

GetIPAddress()

IPAddressRaw LibXR::LinuxWifiClient::GetIPAddress ( ) const

inlineoverridevirtual

获取当前 IP 地址 / Get current IP address

Returns

当前 IP 地址（结构形式） / Current IP address in raw form

Implements LibXR::WifiClient.

Definition at line 103 of file linux_wifi_client.hpp.

  {
    char cmd[128];
    auto ans = snprintf(cmd, sizeof(cmd), "ip -4 addr show %s | grep inet", ifname_cstr_);
    UNUSED(ans);
    FILE* fp = popen(cmd, "r");
    if (!fp)
    {
      return {};
    }
 
    char buf[64] = {};
    IPAddressRaw ip = {};
    if (fgets(buf, sizeof(buf), fp))
    {
      char ip_str[32] = {};
      auto ret = sscanf(buf, " inet %[^/]", ip_str);
      UNUSED(ret);
      ip = IPAddressRaw::FromString(ip_str);
    }
    pclose(fp);
    return ip;
  }

GetMACAddress()

MACAddressRaw LibXR::LinuxWifiClient::GetMACAddress ( ) const

inlineoverridevirtual

获取当前 MAC 地址 / Get MAC address

Returns

当前 MAC 地址（结构形式） / Current MAC address in raw form

Implements LibXR::WifiClient.

Definition at line 127 of file linux_wifi_client.hpp.

  {
    char path[128];
    auto ans = snprintf(path, sizeof(path), "/sys/class/net/%s/address", ifname_cstr_);
    UNUSED(ans);
    FILE* fp = fopen(path, "r");
    if (!fp)
    {
      return {};
    }
 
    char mac_str[32] = {};
    if (!fgets(mac_str, sizeof(mac_str), fp))
    {
      auto ans = fclose(fp);
      UNUSED(ans);
      return {};
    }
    auto ret = fclose(fp);
    UNUSED(ret);
    mac_str[strcspn(mac_str, "\n")] = 0;
    return MACAddressRaw::FromString(mac_str);
  }

GetRSSI()

int LibXR::LinuxWifiClient::GetRSSI ( ) const

inlineoverridevirtual

获取当前 WiFi 信号强度（RSSI） / Get current signal strength

Returns

信号强度（dBm） / Signal strength in dBm

Implements LibXR::WifiClient.

Definition at line 274 of file linux_wifi_client.hpp.

  {
    std::string out;
    SendCommand("SIGNAL_POLL", out);
    auto pos = out.find("RSSI=");
    return pos != std::string::npos ? atoi(out.c_str() + pos + 5) : 0;
  }

IsConnected()

bool LibXR::LinuxWifiClient::IsConnected ( ) const

inlineoverridevirtual

检查是否已连接 / Check if currently connected

Returns

true 如果连接上了 / true if connected

Implements LibXR::WifiClient.

Definition at line 93 of file linux_wifi_client.hpp.

  {
    std::string out;
    if (!SendCommand("STATUS", out))
    {
      return false;
    }
    return out.find("wpa_state=COMPLETED") != std::string::npos;
  }

Scan()

WifiError LibXR::LinuxWifiClient::Scan ( ScanResult * out_list, size_t max_count, size_t & out_found )

inlineoverridevirtual

扫描可用网络 / Scan for available WiFi networks

Parameters

[out]	out_list	扫描结果数组 / Output list buffer
[in]	max_count	最大可填入数量 / Max result count
[out]	out_found	实际找到数量 / Number found

Returns

WifiError 错误码 / Scan result code

Implements LibXR::WifiClient.

Definition at line 242 of file linux_wifi_client.hpp.

  {
    std::string out;
    SendCommand("SCAN", out);
    sleep(2);
    SendCommand("SCAN_RESULTS", out);
 
    std::istringstream ss(out);
    std::string line;
    out_found = 0;
    std::getline(ss, line);
    while (std::getline(ss, line) && out_found < max_count)
    {
      std::istringstream ls(line);
      std::string bssid, freq, signal, flags, ssid;
      ls >> bssid >> freq >> signal >> flags;
      std::getline(ls, ssid);
      if (!ssid.empty() && ssid[0] == '\t')
      {
        ssid.erase(0, 1);
      }
 
      auto& r = out_list[out_found++];
      strncpy(r.ssid, ssid.c_str(), sizeof(r.ssid) - 1);
      r.rssi = atoi(signal.c_str());
      r.security =
          (flags.find("WPA2") != std::string::npos) ? Security::WPA2_PSK : Security::OPEN;
    }
 
    return WifiError::NONE;
  }

---

The documentation for this class was generated from the following file:

• driver/linux/linux_wifi_client.hpp