ESP32 开发笔记(三)源码示例 14_WIFI_Scan 附近WIFI信号扫描示例

开发板购买连接windows

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图形库简单示例app

在ESP32的设计开发中,咱们必然会须要使用到wifi或ble功能,今天就讲解下如何将WIFI功能归入到ESP32中来。函数

 

在 ESP-IDF 中,整个网络协议栈包含的状态定义在头文件 components/esp32/include/esp_event.h中,由枚举类型 system_event_id_t 定义oop

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链接事件ui

ESP_ERROR_CHECK(esp_event_loop_create_default()); // 建立默认事件循环

1、编写代码

先引用必要头文件编码

// 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的认证方式.net

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();
}

2、下载测试

打开ESP-IDF Command Prompt

cd命令进入此工程目录

cd F:\ESP32_DevBoard_File\14_WIFI_Scan

查看电脑设备管理器中开发板的串口号

执行idf.py -p COM9 flash monitor从串口9下载并运行打开口显示设备调试信息   Ctrl+c退出运行