ESP-IDF esp_wifi.h

### 关于 `esp_wifi.h` 头文件的文档与示例

#### 文档说明
在 ESP-IDF 编程指南中提供了详细的关于 `esp_wifi.h` 的介绍以及如何使用该头文件下的函数接口[^2]。此部分涵盖了 Wi-Fi 初始化、配置、连接管理等功能。

对于更深入的理解，可以查阅官方提供的 API 参考手册，在其中能够找到每一个具体功能函数的具体参数解释及其返回值定义等信息。这些资料通常位于安装目录下或在线访问最新版本的手册获取最全面的信息。

#### 示例代码展示
下面给出一段基于 `esp_wifi.h` 实现 STA (Station) 模式的简单例子：

#include "esp_wifi.h"
#include "nvs_flash.h"

static const char *TAG = "wifi station";

void wifi_init_sta(void)
{
    //初始化 NVS
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
      ESP_ERROR_CHECK(nvs_flash_erase());
      ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    static wifi_config_t cfg = {
        .sta = {
            .ssid     = CONFIG_ESP_WIFI_SSID,
            .password = CONFIG_ESP_WIFI_PASSWORD,
        },
    };

    //启动Wi-Fi并设置为STA模式
    ESP_ERROR_CHECK(esp_netif_init());
    ESP_ERROR_CHECK(esp_event_loop_create_default());
    wifi_init_config_t conf = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&conf));
    
    ESP_LOGI(TAG, "Setting WiFi configuration SSID %s...", cfg.sta.ssid);
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA)); 
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &cfg));  
    ESP_ERROR_CHECK(esp_wifi_start());

    ESP_LOGI(TAG,"Waiting for connection...");
}

// 主程序入口处调用上述方法即可完成Wi-Fi连接操作

这段代码展示了如何通过调用 `esp_wifi.h` 提供的相关API来建立一个Wi-Fi客户端连接过程[^5]。