《ESP32-S3使用指南—IDF版 V1.6》第五十章 WiFi热点实验

正点原子运营

第五十章 WiFi热点实验

1）实验平台：正点原子DNESP32S3开发板

2）章节摘自【正点原子】ESP32-S3使用指南—IDF版 V1.6

3）购买链接：https://detail.tmall.com/item.htm?&id=768499342659

4）全套实验源码+手册+视频下载地址：http://www.openedv.com/docs/boards/esp32/ATK-DNESP32S3.html

5）正点原子官方B站：https://space.bilibili.com/394620890

6）正点原子DNESP32S3开发板技术交流群：132780729





       本章节实验作者把ESP32-S3配置为AP模式，即创建连接热点，读者可使用手机连接该热点。AP模式相关知识请读者查看第二章节的内容。
       本章分为如下几个小节：
       50.1 硬件设计
       50.2 软件设计
       50.3 下载验证

       50.1 硬件设计

       1. 例程功能
       本章实验功能简介：当手机连接这个热点时，LCD显示该连接设备的MAC地址，断开时，LCD显示断开设备的MAC地址。

       2. 硬件资源

       1）LED灯
              LED-IO1

       2）XL9555
              IIC_INT-IO0（需在P5连接IO0）
              IIC_SDA-IO41
              IIC_SCL-IO42

       3）SPILCD
              CS-IO21
              SCK-IO12
              SDA-IO11
              DC-IO40（在P5端口，使用跳线帽将IO_SET和LCD_DC相连）
              PWR- IO1_3（XL9555）
              RST- IO1_2（XL9555）

       4）ESP32-S3内部WiFi

       3. 原理图
       本章实验使用的WiFi为ESP32-S3的片上资源，因此并没有相应的连接原理图。

       50.2 软件设计

       50.2.1 程序流程图
       程序流程图能帮助我们更好的理解一个工程的功能和实现的过程，对学习和设计工程有很好的主导作用。下面看看本实验的程序流程图：

图50.2.1.1 程序流程图

       50.2.2 程序解析
       在本章节实验中，我们只关心main.c文件内容即可，该文件内容如下：

1. i2c_obj_t i2c0_master;
   
2. static const char *TAG = "AP";
   
3. #define EXAMPLE_ESP_WIFI_SSID   "123"
   
4. #define EXAMPLE_ESP_WIFI_PASS   "123456789"
   
5. #define EXAMPLE_MAX_STA_CONN    5
   
6. #define MAC2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5]
   
7. #define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x"
   
8. static char lcd_buff[100] = {0};
   
9. 
   
10. 
    
11. /**
    
12. * @brief       WIFI链接糊掉函数
    
13. * [url=home.php?mod=space&uid=271674]@param[/url]       arg:传入网卡控制块
    
14. * @param       event_base:WIFI事件
    
15. * @param       event_id:事件ID
    
16. * @param       event_data:事件数据
    
17. * @retval      无
    
18. */
    
19. static void wifi_event_handler(void *arg, esp_event_base_t event_base,
    
20.                                int32_t event_id, void *event_data)
    
21. {
    
22.     /* 设备连接 */
    
23.     if (event_id == WIFI_EVENT_AP_STACONNECTED)
    
24.     {
    
25.         lcd_fill(0,90,320,240,WHITE);
    
26.         wifi_event_ap_staconnected_t *event = (wifi_event_ap_staconnected_t *)
    
27. event_data;
    
28.         ESP_LOGI(TAG, "station " MACSTR " join, AID=%d",
    
29.                  MAC2STR(event->mac), event->aid);
    
30.         sprintf(lcd_buff, "MACSTR:"MACSTR,MAC2STR(event->mac));
    
31.         lcd_show_string(0, 90, 320, 16, 16, lcd_buff, BLUE);
    
32.         lcd_show_string(0, 110, 320, 16, 16, "With device connection", BLUE);
    
33.     }
    
34.     /* 设备断开 */
    
35.     else if (event_id == WIFI_EVENT_AP_STADISCONNECTED)
    
36.     {
    
37.         wifi_event_ap_stadisconnected_t *event =
    
38.                                  (wifi_event_ap_stadisconnected_t *)event_data;
    
39.         ESP_LOGI(TAG, "station " MACSTR " leave, AID=%d",
    
40.                  MAC2STR(event->mac), event->aid);
    
41.         lcd_fill(0,90,320,320,WHITE);
    
42.         sprintf(lcd_buff, "Device disconnected:"MACSTR,MAC2STR(event->mac));
    
43.         lcd_show_string(0, 90, 320, 16, 16, lcd_buff, BLUE);
    
44.     }
    
45. }
    
46. 
    
47. /**
    
48. * @brief       WIFI初始化
    
49. * @param       无
    
50. * @retval      无
    
51. */
    
52. static void wifi_init_softap(void)
    
53. {
    
54.     /* 初始化网卡 */
    
55.     ESP_ERROR_CHECK(esp_netif_init());
    
56. 
    
57.     /* 创建新的事件循环 */
    
58.     ESP_ERROR_CHECK(esp_event_loop_create_default());
    
59.     /* 使用默认配置初始化包括netif的Wi-Fi */
    
60.     esp_netif_create_default_wifi_ap();
    
61.     wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    
62.     ESP_ERROR_CHECK(esp_wifi_init(&cfg));
    
63. 
    
64. ESP_ERROR_CHECK(esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID,
    
65.                 &wifi_event_handler, NULL));
    
66.     /* 配置WIFI */
    
67.     wifi_config_t wifi_config = {
    
68.         .ap = {
    
69.             .ssid = EXAMPLE_ESP_WIFI_SSID,
    
70.             .ssid_len = strlen(EXAMPLE_ESP_WIFI_SSID),
    
71.             .password = EXAMPLE_ESP_WIFI_PASS,
    
72.             .max_connection = EXAMPLE_MAX_STA_CONN,
    
73.             .authmode = WIFI_AUTH_WPA_WPA2_PSK
    
74.         },
    
75.     };
    
76. 
    
77.     if (strlen(EXAMPLE_ESP_WIFI_PASS) == 0)
    
78.     {
    
79.         wifi_config.ap.authmode = WIFI_AUTH_OPEN;
    
80.     }
    
81.     ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));
    
82.     ESP_ERROR_CHECK(esp_wifi_set_config(ESP_IF_WIFI_AP, &wifi_config));
    
83.     ESP_ERROR_CHECK(esp_wifi_start());
    
84. esp_netif_ip_info_t ip_info;
    
85. /* 获取当前设备的IP地址 */
    
86. esp_netif_get_ip_info(esp_netif_get_handle_from_ifkey("WIFI_AP_DEF"),
    
87.                       &ip_info);
    
88.     char ip_addr[16];
    
89.     inet_ntoa_r(ip_info.ip.addr, ip_addr, 16);
    
90.     ESP_LOGI(TAG, "Set up softAP with IP: %s", ip_addr);
    
91.     ESP_LOGI(TAG, "wifi_init_softap finished. SSID:'%s' password:'%s'",
    
92.              EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    
93.    
    
94.     lcd_show_string(0, 90, 240, 16, 16, "wifi connecting......", BLUE);
    
95. }
    
96. 
    
97. /**
    
98. * @brief       程序入口
    
99. * @param       无
    
100. * @retval      无
     
101. */
     
102. void app_main(void)
     
103. {
     
104.     /* 省略部分代码..... */
     
105.     wifi_init_softap();
     
106.     while (1)
     
107.     {
     
108.         LED_TOGGLE();
     
109.         vTaskDelay(500);
     
110.     }
     
111. }

复制代码

       上述源码相对简单，主要将ESP32-S3设备配置为AP模式，即作为热点设备。然后，设置热点设备的账号、密码、安全模式等参数。在WiFi事件回调函数中，当有外部设备请求连接时，程序会在LCD上显示连接设备的MAC地址等信息。而当外部设备从连接状态断开时，LCD会显示当前断开的外部设备MAC地址。

       50.3 下载验证
       程序下载成功后，我们利用手机连接ESP32-S3热点设备，当手机连接热点设备成功时，LCD显示手机的MAC地址等信息，当手机从已连接状态断开时，LCD显示断开的外部设备的MAC地址。下图为连接成功的LCD显示效果图。

图50.3.1 外部设备连接热点设备

       下图为外部设备从已连接状态断开效果图，如下所示。

图50.3.2 外部设备断开热点设备