開發板購買鏈接

https://item.taobao.com/item.htm?spm=a2oq0.12575281.0.0.50111deb2Ij1As&ft=t&id=626366733674

開發板簡介
開發環境搭建 windows
原始碼示例：
0_Hello Bug （ESP_LOGX與printf）工程模板/列印除錯輸出
1_LED LED亮滅控制
2_LED_Task 使用任務方式控制LED
3_LEDC_PWM 使用LEDC來控制LED實作呼吸燈效果
4_ADC_LightR 使用ADC讀取光敏電阻實作光照傳感
5_KEY_Short_Long 按鈕長按短按實作
6_TouchPad_Interrupt 電容觸摸中斷實作
7_WS2812_RMT 使用RMT實作RGB_LED彩虹變色示例
8_DHT11_RMT 使用RMT實作讀取DHT11溫濕度傳感器
9_SPI_SDCard 使用SPI總線實作TF卡檔案系統示例
10_IIC_ADXL345 使用IIC總線實作讀取ADXL345角度加速度傳感器
11_IIC_AT24C02 使用IIC總線實作小容量資料儲存測驗
12_IR_Rev_RMT 使用RMT實作紅外遙控接收解碼（NEC編碼）
13_IR_Send_RMT 使用RMT實作紅外資料發送（NEC編碼）
14_WIFI_Scan 附近WIFI信號掃描示例
15_WIFI_AP 創建軟AP示例
16_WIFI_AP_TCP_Server 在軟AP模式下實作TCP服務端
17_WIFI_AP_TCP_Client 在軟AP模式下實作TCP客戶端
18_WIFI_AP_UDP 在軟AP模式下實作UDP通訊
19_WIFI_STA 創建STA站模
20_WIFI_STA_TCP_Server 在站模式STA下實作TCP服務端
21_WIFI_STA_TCP_Client 在站模式STA下實作TCP客戶端
22_WIFI_STA_UDP 在站模式STA下實作UDP通訊
23_LVGL_Test LVGL圖形庫簡單示例

在ESP32的設計開發中，我們必然會需要使用到wifi或ble功能，今天就講解下如何將WIFI功能納入到ESP32中來，

在 ESP-IDF 中，整個網路協議堆疊包含的狀態定義在頭檔案 components/esp32/include/esp_event.h中，由列舉型別 system_event_id_t 定義

    SYSTEM_EVENT_WIFI_READY = 0,           /*!< ESP32 WiFi ready */
    SYSTEM_EVENT_SCAN_DONE,                /*!< ESP32 finish scanning AP */
    SYSTEM_EVENT_STA_START,                /*!< ESP32 station start */
    SYSTEM_EVENT_STA_STOP,                 /*!< ESP32 station stop */
    SYSTEM_EVENT_STA_CONNECTED,            /*!< ESP32 station connected to AP */
    SYSTEM_EVENT_STA_DISCONNECTED,         /*!< ESP32 station disconnected from AP */
    SYSTEM_EVENT_STA_AUTHMODE_CHANGE,      /*!< the auth mode of AP connected by ESP32 station changed */
    SYSTEM_EVENT_STA_GOT_IP,               /*!< ESP32 station got IP from connected AP */
    SYSTEM_EVENT_STA_LOST_IP,              /*!< ESP32 station lost IP and the IP is reset to 0 */
    SYSTEM_EVENT_STA_WPS_ER_SUCCESS,       /*!< ESP32 station wps succeeds in enrollee mode */
    SYSTEM_EVENT_STA_WPS_ER_FAILED,        /*!< ESP32 station wps fails in enrollee mode */
    SYSTEM_EVENT_STA_WPS_ER_TIMEOUT,       /*!< ESP32 station wps timeout in enrollee mode */
    SYSTEM_EVENT_STA_WPS_ER_PIN,           /*!< ESP32 station wps pin code in enrollee mode */
    SYSTEM_EVENT_STA_WPS_ER_PBC_OVERLAP,   /*!< ESP32 station wps overlap in enrollee mode */
    SYSTEM_EVENT_AP_START,                 /*!< ESP32 soft-AP start */
    SYSTEM_EVENT_AP_STOP,                  /*!< ESP32 soft-AP stop */
    SYSTEM_EVENT_AP_STACONNECTED,          /*!< a station connected to ESP32 soft-AP */
    SYSTEM_EVENT_AP_STADISCONNECTED,       /*!< a station disconnected from ESP32 soft-AP */
    SYSTEM_EVENT_AP_STAIPASSIGNED,         /*!< ESP32 soft-AP assign an IP to a connected station */
    SYSTEM_EVENT_AP_PROBEREQRECVED,        /*!< Receive probe request packet in soft-AP interface */
    SYSTEM_EVENT_GOT_IP6,                  /*!< ESP32 station or ap or ethernet interface v6IP addr is preferred */
    SYSTEM_EVENT_ETH_START,                /*!< ESP32 ethernet start */
    SYSTEM_EVENT_ETH_STOP,                 /*!< ESP32 ethernet stop */
    SYSTEM_EVENT_ETH_CONNECTED,            /*!< ESP32 ethernet phy link up */
    SYSTEM_EVENT_ETH_DISCONNECTED,         /*!< ESP32 ethernet phy link down */
    SYSTEM_EVENT_ETH_GOT_IP,               /*!< ESP32 ethernet got IP from connected AP */

認證方式

    WIFI_AUTH_OPEN = 0,         /**< authenticate mode : open */
    WIFI_AUTH_WEP,              /**< authenticate mode : WEP */
    WIFI_AUTH_WPA_PSK,          /**< authenticate mode : WPA_PSK */
    WIFI_AUTH_WPA2_PSK,         /**< authenticate mode : WPA2_PSK */
    WIFI_AUTH_WPA_WPA2_PSK,     /**< authenticate mode : WPA_WPA2_PSK */
    WIFI_AUTH_WPA2_ENTERPRISE,  /**< authenticate mode : WPA2_ENTERPRISE */
    WIFI_AUTH_WPA3_PSK,         /**< authenticate mode : WPA3_PSK */
    WIFI_AUTH_WPA2_WPA3_PSK,    /**< authenticate mode : WPA2_WPA3_PSK */

事件回圈庫是esp提供的一種事件處理方法，而默認事件回圈是用于系統事件（例如WiFi事件）的特殊回圈型別，這里創建一個默認事件回圈用以處理wifi連接事件


    ESP_ERROR_CHECK(esp_event_loop_create_default()); // 創建默認事件回圈

一、撰寫代碼

先參考必要頭檔案

// WIFI_Scan Example

#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/event_groups.h"
#include "esp_wifi.h"
#include "esp_log.h"
#include "esp_event.h"
#include "nvs_flash.h"
#include "freertos/event_groups.h"

WIFI事件處理函式


// wifi 事件
static esp_err_t event_handler(void *ctx, system_event_t *event)
{
	switch (event->event_id)
	{
	case SYSTEM_EVENT_WIFI_READY:			// ESP32 WIFI就緒
		ESP_LOGI(TAG, "event-->ESP32 WiFi ready");
		break;
	case SYSTEM_EVENT_SCAN_DONE:			// 掃描AP完成
		ESP_LOGI(TAG, "event-->ESP32 finish scanning AP");
		break;
	case SYSTEM_EVENT_STA_START:			// 開始STA模式
		ESP_LOGI(TAG, "event-->ESP32 station start");
		break;
	case SYSTEM_EVENT_STA_STOP:				// 停止STA模式
		ESP_LOGI(TAG, "event-->ESP32 station stop");
		break;
	case SYSTEM_EVENT_STA_CONNECTED:		// STA模式連接到AP
		ESP_LOGI(TAG, "event-->ESP32 station connected to AP");
		break;
	case SYSTEM_EVENT_STA_DISCONNECTED:		// STA模式斷開與AP的連接
		ESP_LOGI(TAG, "event-->ESP32 station disconnected from AP");
		break;
	case SYSTEM_EVENT_STA_AUTHMODE_CHANGE:	// ESP32 Station連接的AP的驗證模式已更改
		ESP_LOGI(TAG, "event-->the auth mode of AP connected by ESP32 station changed");
		break;
	case SYSTEM_EVENT_STA_GOT_IP:			// ESP32 Station從連接的AP獲取到IP
		ESP_LOGI(TAG, "event-->ESP32 station got IP from connected AP");
		break;		
	case SYSTEM_EVENT_STA_LOST_IP:			// ESP32 Station丟失IP或IP重置
		ESP_LOGI(TAG, "event-->ESP32 station lost IP and the IP is reset to 0");
		break;
	case SYSTEM_EVENT_STA_WPS_ER_SUCCESS:	// ESP32 station wps在注冊模式下成功
		ESP_LOGI(TAG, "event--> ESP32 station wps succeeds in enrollee mode");
		break;
	case SYSTEM_EVENT_STA_WPS_ER_FAILED:	// ESP32 station wps在注冊模式下失敗
		ESP_LOGI(TAG, "event--> ESP32 station wps fails in enrollee mode");
		break;
	case SYSTEM_EVENT_STA_WPS_ER_TIMEOUT:	// ESP32 station wps在注冊模式超時
		ESP_LOGI(TAG, "event--> ESP32 station wps timeout in enrollee mode");
		break;
	case SYSTEM_EVENT_STA_WPS_ER_PIN:		// ESP32 Station WPS密碼在登記人模式下
		ESP_LOGI(TAG, "event--> ESP32 station wps pin code in enrollee mode");
		break;
	case SYSTEM_EVENT_STA_WPS_ER_PBC_OVERLAP:// ESP32 station wps在登記人模式下重疊
		ESP_LOGI(TAG, "event--> ESP32 station wps overlap in enrollee mode");
		break;
	case SYSTEM_EVENT_AP_START:				// ESP32 AP模式開始
		ESP_LOGI(TAG, "event--> ESP32 soft-AP start");
		break;
	case SYSTEM_EVENT_AP_STOP:				// ESP32 AP模式停止
		ESP_LOGI(TAG, "event--> ESP32 soft-AP stop");
		break;
	case SYSTEM_EVENT_AP_STACONNECTED:		// ESP32 AP模式下，有站接入此AP
		ESP_LOGI(TAG, "event--> a station connected to ESP32 soft-AP ");
		break;
	case SYSTEM_EVENT_AP_STADISCONNECTED:	// ESP32 AP模式下，有站斷開此AP
		ESP_LOGI(TAG, "event--> a station disconnected from ESP32 soft-AP ");
		break;
	case SYSTEM_EVENT_AP_STAIPASSIGNED:		// ESP32 AP模式下，為連接的站分配IP
		ESP_LOGI(TAG, "event--> ESP32 soft-AP assign an IP to a connected station");
		break;
	case SYSTEM_EVENT_AP_PROBEREQRECVED:	// ESP32 AP模式下，在soft-AP介面中接收探測請求資料包
		ESP_LOGI(TAG, "event--> Receive probe request packet in soft-AP interface");
		break;
	default:
		break;
	}
	return ESP_OK;
}

列印WIFI的認證方式

static void print_auth_mode(int authmode)
{
	switch (authmode) {
	case WIFI_AUTH_OPEN:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_OPEN");
		break;
	case WIFI_AUTH_WEP:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WEP");
		break;
	case WIFI_AUTH_WPA_PSK:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA_PSK");
		break;
	case WIFI_AUTH_WPA2_PSK:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA2_PSK");
		break;
	case WIFI_AUTH_WPA_WPA2_PSK:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA_WPA2_PSK");
		break;
	case WIFI_AUTH_WPA2_ENTERPRISE:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA2_ENTERPRISE");
		break;
	case WIFI_AUTH_WPA3_PSK:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA3_PSK");
		break;
	case WIFI_AUTH_WPA2_WPA3_PSK:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_WPA2_WPA3_PSK");
		break;
	default:
		ESP_LOGI(TAG, "Authmode \tWIFI_AUTH_UNKNOWN");
		break;
	}
}

列印WIFI的加密方式

static void print_cipher_type(int pairwise_cipher, int group_cipher)
{
	switch (pairwise_cipher) {
	case WIFI_CIPHER_TYPE_NONE:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_NONE");
		break;
	case WIFI_CIPHER_TYPE_WEP40:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_WEP40");
		break;
	case WIFI_CIPHER_TYPE_WEP104:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_WEP104");
		break;
	case WIFI_CIPHER_TYPE_TKIP:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_TKIP");
		break;
	case WIFI_CIPHER_TYPE_CCMP:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_CCMP");
		break;
	case WIFI_CIPHER_TYPE_TKIP_CCMP:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_TKIP_CCMP");
		break;
	default:
		ESP_LOGI(TAG, "Pairwise Cipher \tWIFI_CIPHER_TYPE_UNKNOWN");
		break;
	}

	switch (group_cipher) {
	case WIFI_CIPHER_TYPE_NONE:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_NONE");
		break;
	case WIFI_CIPHER_TYPE_WEP40:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_WEP40");
		break;
	case WIFI_CIPHER_TYPE_WEP104:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_WEP104");
		break;
	case WIFI_CIPHER_TYPE_TKIP:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_TKIP");
		break;
	case WIFI_CIPHER_TYPE_CCMP:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_CCMP");
		break;
	case WIFI_CIPHER_TYPE_TKIP_CCMP:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_TKIP_CCMP");
		break;
	default:
		ESP_LOGI(TAG, "Group Cipher \tWIFI_CIPHER_TYPE_UNKNOWN");
		break;
	}
}

初始化WIFI 配置掃描模式開始掃描列印掃描到的AP資訊

// 初始化WIFI 配置掃描模式 開始掃描 列印掃描到的AP資訊
static void wifi_scan(void)
{
	ESP_ERROR_CHECK(esp_netif_init());					// 初始化底層TCP/IP堆疊，在應用程式啟動時，應該呼叫此函式一次
	ESP_ERROR_CHECK(esp_event_loop_create_default());	// 創建默認事件回圈
	esp_netif_t *sta_netif = esp_netif_create_default_wifi_sta();// 創建一個默認的WIFI-STA網路介面，
	assert(sta_netif);									// 如果初始化錯誤，此API將中止
	wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
	ESP_ERROR_CHECK(esp_wifi_init(&cfg));				// 使用默認wifi初始化配置

	uint16_t number = DEFAULT_SCAN_LIST_SIZE;			// 默認掃描串列大小
	wifi_ap_record_t ap_info[DEFAULT_SCAN_LIST_SIZE];	// AP資訊結構體大小
	uint16_t ap_count = 0;								// 初始化AP數量0
	memset(ap_info, 0, sizeof(ap_info));				// 初始化AP資訊結構體

	ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));	// 設定WiFi的作業模式為 STA
	ESP_ERROR_CHECK(esp_wifi_start());					// 啟動WiFi連接
	ESP_ERROR_CHECK(esp_wifi_scan_start(NULL, true));	// 開始掃描WIFI(默認配置，阻塞方式)
	ESP_ERROR_CHECK(esp_wifi_scan_get_ap_records(&number, ap_info));// 獲取搜索的具體AP資訊
	ESP_ERROR_CHECK(esp_wifi_scan_get_ap_num(&ap_count));		//接入點的數量
	ESP_LOGI(TAG, "Total APs scanned = %u", ap_count);
	for (int i = 0; (i < DEFAULT_SCAN_LIST_SIZE) && (i < ap_count); i++) {
		ESP_LOGI(TAG, "SSID \t\t%s", ap_info[i].ssid);		// 列印WIFI名稱
		ESP_LOGI(TAG, "RSSI \t\t%d", ap_info[i].rssi);		// 列印信號強度	
		print_auth_mode(ap_info[i].authmode);				// 列印認證方式
		if (ap_info[i].authmode != WIFI_AUTH_WEP) {
			print_cipher_type(ap_info[i].pairwise_cipher, ap_info[i].group_cipher);
		}
		ESP_LOGI(TAG, "Channel \t\t%d\n", ap_info[i].primary);
	}
}

主函式

// 主函式
void app_main(void)
{
	ESP_LOGI(TAG, "APP Start......");
	// Initialize 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 );
	wifi_scan();
}

二、下載測驗

打開ESP-IDF Command Prompt

cd命令進入此工程目錄

cd F:\ESP32_DevBoard_File\14_WIFI_Scan

查看電腦設備管理器中開發板的串口號

執行idf.py -p COM9 flash monitor從串口9下載并運行打開口顯示設備除錯資訊 Ctrl+c退出運行

轉載請註明出處，本文鏈接：https://www.uj5u.com/ruanti/5680.html

標籤：其他

上一篇：ESP32 開發筆記(三）原始碼示例 11_IIC_AT24C02 使用IIC總線實作EEPROM小容量資料儲存測驗

下一篇：ESP32 開發筆記(三）原始碼示例 7_WS2812_RMT 使用ESP32的RMT實作彩虹變色效果

ESP32 開發筆記(三）原始碼示例 14_WIFI_Scan 附近WIFI信號掃描示例

一、撰寫代碼

二、下載測驗