ESP32 平台的 WiFi 客户端实现 / WiFi client implementation for ESP32. More...

#include <esp_wifi_client.hpp>

Inheritance diagram for LibXR::ESP32WifiClient:

Collaboration diagram for LibXR::ESP32WifiClient:

Public Member Functions
bool	Enable () override
	启用网络接口（WiFi） / Enable the network interface

void	Disable () override
	禁用网络接口（WiFi） / Disable the network interface

WifiError	Connect (const Config &config) override
	连接到指定 WiFi 网络 / Connect to a WiFi network

WifiError	Disconnect () override
	断开当前 WiFi 连接 / Disconnect from the WiFi network

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	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

Static Private Member Functions
static void	EventHandler (void arg, esp_event_base_t event_base, int32_t event_id, void event_data)
	事件处理回调 / Event handler callback

Private Attributes
bool	enabled_ = false
	是否启用 / Whether WiFi is enabled

bool	connected_ = false
	是否连接 / Whether WiFi is connected

bool	got_ip_ = false
	是否获取 IP / Whether IP is acquired

char	ip_str_ [16] = {}
	当前 IP 字符串 / Current IP string

uint8_t	mac_ [6] = {}
	当前 MAC 缓存 / Cached MAC address

LibXR::Semaphore	semaphore_
	状态同步信号量 / Event wait semaphore

Static Private Attributes
static bool	is_initialized_
	ESP 网络是否已初始化 / Netif initialized.

static esp_netif_t *	netif_ = nullptr
	ESP 默认 netif 对象 / Default netif.

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

ESP32 平台的 WiFi 客户端实现 / WiFi client implementation for ESP32.

提供基于 ESP-IDF 的 WiFi 接口实现，包含连接、断开、扫描、RSSI 查询等功能，继承自抽象类 WifiClient 并实现其所有接口。

Definition at line 18 of file esp_wifi_client.hpp.

Constructor & Destructor Documentation

◆ ESP32WifiClient()

LibXR::ESP32WifiClient::ESP32WifiClient ( )

Definition at line 14 of file esp_wifi_client.cpp.

{
  if (!is_initialized_)
  {
    esp_netif_init();
    esp_event_loop_create_default();
    netif_ = esp_netif_create_default_wifi_sta();
 
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);
 
    is_initialized_ = true;
  }
}

◆ ~ESP32WifiClient()

LibXR::ESP32WifiClient::~ESP32WifiClient ( )

override

Definition at line 29 of file esp_wifi_client.cpp.

{
  if (enabled_)
  {
    Disable();
  }
}

Member Function Documentation

◆ Connect()

WifiClient::WifiError LibXR::ESP32WifiClient::Connect ( const Config & config )

overridevirtual

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

Parameters

[in] config WiFi 连接配置 / Configuration parameters

Returns: WifiError 连接结果 / Error code

Implements LibXR::WifiClient.

Definition at line 89 of file esp_wifi_client.cpp.

{
  if (!enabled_) return WifiError::NOT_ENABLED;
 
  wifi_config_t wifi_config{};
  std::strncpy(reinterpret_cast<char*>(wifi_config.sta.ssid), config.ssid,
               sizeof(wifi_config.sta.ssid));
  std::strncpy(reinterpret_cast<char*>(wifi_config.sta.password), config.password,
               sizeof(wifi_config.sta.password));
  esp_wifi_set_config(WIFI_IF_STA, &wifi_config);
  esp_wifi_connect();
 
  while (semaphore_.Wait(0) == ErrorCode::OK)
  {
  }
 
  semaphore_.Wait();
  if (!connected_) return WifiError::CONNECTION_TIMEOUT;
 
  semaphore_.Wait();
  if (!got_ip_) return WifiError::DHCP_FAILED;
 
  return WifiError::NONE;
}

◆ Disable()

void LibXR::ESP32WifiClient::Disable ( )

overridevirtual

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

Implements LibXR::WifiClient.

Definition at line 80 of file esp_wifi_client.cpp.

{
  if (!enabled_) return;
 
  esp_wifi_stop();
  enabled_ = false;
  connected_ = false;
}

◆ Disconnect()

WifiClient::WifiError LibXR::ESP32WifiClient::Disconnect ( )

overridevirtual

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

Returns: WifiError 断开结果 / Error code

Implements LibXR::WifiClient.

Definition at line 114 of file esp_wifi_client.cpp.

{
  if (!enabled_) return WifiError::NOT_ENABLED;
  if (!connected_) return WifiError::NONE;
 
  while (semaphore_.Wait(0) == ErrorCode::OK)
  {
  }
  esp_wifi_disconnect();
  semaphore_.Wait();
 
  return WifiError::NONE;
}

◆ Enable()

bool LibXR::ESP32WifiClient::Enable ( )

overridevirtual

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

Returns: true 表示成功 / true if enabled successfully

Implements LibXR::WifiClient.

Definition at line 37 of file esp_wifi_client.cpp.

{
  if (enabled_) return true;
 
  esp_wifi_set_mode(WIFI_MODE_STA);
 
  esp_event_handler_register(WIFI_EVENT, WIFI_EVENT_STA_CONNECTED, &EventHandler, this);
  esp_event_handler_register(WIFI_EVENT, WIFI_EVENT_STA_DISCONNECTED, &EventHandler,
                             this);
  esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &EventHandler, this);
  esp_event_handler_register(IP_EVENT, IP_EVENT_STA_LOST_IP, &EventHandler, this);
 
  esp_wifi_start();
  enabled_ = true;
 
  wifi_config_t cfg;
  esp_err_t err = esp_wifi_get_config(WIFI_IF_STA, &cfg);
  if (err == ESP_OK && cfg.sta.ssid[0] != 0)
  {
    esp_wifi_connect();
    semaphore_.Wait();
    if (!connected_) return true;
 
    semaphore_.Wait();
    if (!got_ip_) return true;
  }
 
  wifi_ap_record_t ap_info;
  if (esp_wifi_sta_get_ap_info(&ap_info) == ESP_OK)
  {
    connected_ = true;
    got_ip_ = true;
 
    esp_netif_ip_info_t ip_info;
    if (esp_netif_get_ip_info(netif_, &ip_info) == ESP_OK)
    {
      esp_ip4addr_ntoa(&ip_info.ip, ip_str_, sizeof(ip_str_));
    }
  }
 
  return true;
}

◆ EventHandler()

void LibXR::ESP32WifiClient::EventHandler	(	void *	arg,
		esp_event_base_t	event_base,
		int32_t	event_id,
		void *	event_data )

staticprivate

事件处理回调 / Event handler callback

Parameters

arg	用户数据 / User pointer
event_base	事件域 / Event base type
event_id	事件编号 / Event ID
event_data	附加数据 / Event payload

Definition at line 175 of file esp_wifi_client.cpp.

{
  auto* self = static_cast<ESP32WifiClient*>(arg);
 
  if (event_base == WIFI_EVENT)
  {
    switch (event_id)
    {
      case WIFI_EVENT_STA_CONNECTED:
        self->connected_ = true;
        self->semaphore_.Post();
        break;
      case WIFI_EVENT_STA_DISCONNECTED:
        self->connected_ = false;
        self->semaphore_.Post();
        break;
      default:
        break;
    }
  }
 
  if (event_base == IP_EVENT)
  {
    switch (event_id)
    {
      case IP_EVENT_STA_GOT_IP:
      {
        ip_event_got_ip_t* event = reinterpret_cast<ip_event_got_ip_t*>(event_data);
        self->got_ip_ = true;
        esp_ip4addr_ntoa(&event->ip_info.ip, self->ip_str_, sizeof(self->ip_str_));
        self->semaphore_.Post();
        break;
      }
      case IP_EVENT_STA_LOST_IP:
        self->got_ip_ = false;
        break;
    }
  }
}

◆ GetIPAddress()

IPAddressRaw LibXR::ESP32WifiClient::GetIPAddress ( ) const

overridevirtual

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

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

Implements LibXR::WifiClient.

Definition at line 130 of file esp_wifi_client.cpp.

{
  return IPAddressRaw::FromString(ip_str_);
}

◆ GetMACAddress()

MACAddressRaw LibXR::ESP32WifiClient::GetMACAddress ( ) const

overridevirtual

获取当前 MAC 地址 / Get MAC address

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

Implements LibXR::WifiClient.

Definition at line 135 of file esp_wifi_client.cpp.

{
  uint8_t mac[6] = {};
  esp_wifi_get_mac(WIFI_IF_STA, mac);
  MACAddressRaw result;
  std::memcpy(result.bytes, mac, 6);
  return result;
}

◆ GetRSSI()

int LibXR::ESP32WifiClient::GetRSSI ( ) const

overridevirtual

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

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

Implements LibXR::WifiClient.

Definition at line 216 of file esp_wifi_client.cpp.

{
  if (!connected_) return -127;
 
  wifi_ap_record_t ap_info;
  if (esp_wifi_sta_get_ap_info(&ap_info) == ESP_OK)
  {
    return ap_info.rssi;
  }
  return -127;
}

◆ IsConnected()

bool LibXR::ESP32WifiClient::IsConnected ( ) const

overridevirtual

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

Returns: true 如果连接上了 / true if connected

Implements LibXR::WifiClient.

Definition at line 128 of file esp_wifi_client.cpp.

128{ return connected_; }

◆ Scan()

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

overridevirtual

扫描可用网络 / 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 144 of file esp_wifi_client.cpp.

{
  wifi_scan_config_t scan_config = {};
  if (esp_wifi_scan_start(&scan_config, true) != ESP_OK)
  {
    return WifiError::SCAN_FAILED;
  }
 
  uint16_t ap_num = 0;
  esp_wifi_scan_get_ap_num(&ap_num);
  if (ap_num > max_count) ap_num = max_count;
 
  wifi_ap_record_t ap_records[20] = {};
  esp_wifi_scan_get_ap_records(&ap_num, ap_records);
 
  out_found = ap_num;
  for (int i = 0; i < ap_num; ++i)
  {
    std::strncpy(out_list[i].ssid, reinterpret_cast<const char*>(ap_records[i].ssid),
                 sizeof(out_list[i].ssid));
    out_list[i].rssi = ap_records[i].rssi;
    out_list[i].security = (ap_records[i].authmode == WIFI_AUTH_OPEN) ? Security::OPEN
                           : (ap_records[i].authmode == WIFI_AUTH_WPA2_PSK)
                               ? Security::WPA2_PSK
                               : Security::UNKNOWN;
  }
 
  return WifiError::NONE;
}

Field Documentation

◆ connected_

bool LibXR::ESP32WifiClient::connected_ = false

private

是否连接 / Whether WiFi is connected

Definition at line 59 of file esp_wifi_client.hpp.

◆ enabled_

bool LibXR::ESP32WifiClient::enabled_ = false

private

是否启用 / Whether WiFi is enabled

Definition at line 58 of file esp_wifi_client.hpp.

◆ got_ip_

bool LibXR::ESP32WifiClient::got_ip_ = false

private

是否获取 IP / Whether IP is acquired

Definition at line 60 of file esp_wifi_client.hpp.

◆ ip_str_

char LibXR::ESP32WifiClient::ip_str_[16] = {}

private

当前 IP 字符串 / Current IP string

Definition at line 61 of file esp_wifi_client.hpp.

61{};

◆ is_initialized_

bool LibXR::ESP32WifiClient::is_initialized_

inlinestaticprivate

Initial value:

=

false

ESP 网络是否已初始化 / Netif initialized.

Definition at line 54 of file esp_wifi_client.hpp.

◆ mac_

uint8_t LibXR::ESP32WifiClient::mac_[6] = {}

private

当前 MAC 缓存 / Cached MAC address

Definition at line 62 of file esp_wifi_client.hpp.

62{};

◆ netif_

esp_netif_t* LibXR::ESP32WifiClient::netif_ = nullptr

inlinestaticprivate

ESP 默认 netif 对象 / Default netif.

Definition at line 56 of file esp_wifi_client.hpp.

◆ semaphore_

LibXR::Semaphore LibXR::ESP32WifiClient::semaphore_

private

状态同步信号量 / Event wait semaphore

Definition at line 64 of file esp_wifi_client.hpp.

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

driver/esp/esp_wifi_client.hpp
driver/esp/esp_wifi_client.cpp

Public Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ESP32WifiClient()

◆ ~ESP32WifiClient()

Member Function Documentation

◆ Connect()

◆ Disable()

◆ Disconnect()

◆ Enable()

◆ EventHandler()

◆ GetIPAddress()

◆ GetMACAddress()

◆ GetRSSI()

◆ IsConnected()

◆ Scan()

Field Documentation

◆ connected_

◆ enabled_

◆ got_ip_

◆ ip_str_

◆ is_initialized_

◆ mac_

◆ netif_

◆ semaphore_