1. 认识ESP32-C3的WiFi功能
ESP32-C3作为乐鑫推出的高性价比物联网芯片,其WiFi功能绝对是开发者的心头好。我刚开始接触这块芯片时,也被它强大的网络能力惊艳到了。不同于传统单片机需要外接WiFi模块,ESP32-C3内置了完整的2.4GHz WiFi解决方案,这意味着你只需要一根天线就能搞定无线连接。
这块芯片最吸引我的地方在于它支持多种工作模式:既能当普通设备连接路由器(STA模式),也能自己变身热点(AP模式),还能两种模式同时运行。记得我第一次用它开热点时,手机真的搜到了"ESP32_AP"这个SSID,虽然当时还没联网,但那种成就感至今难忘。
不过要注意的是,ESP32-C3目前只支持2.4GHz频段,不支持5GHz。这个限制在实际开发中要特别注意,特别是在一些5GHz WiFi普及率高的场景。我有个朋友就踩过坑,死活连不上家里的5G WiFi,后来才发现是这个原因。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础操作:WiFi扫描实战
2.1 最简单的WiFi扫描实现
先来看看最基础的WiFi扫描功能。这个功能特别适合新手入门,因为它不需要任何网络配置,就能获取周围的热点信息。下面这段代码是我调试过最稳定的版本:
c复制#include "esp_wifi.h"
#include "esp_log.h"
#define SCAN_LIST_SIZE 16
static const char *TAG = "WiFiScan";
void scan_results() {
wifi_ap_record_t ap_info[SCAN_LIST_SIZE];
uint16_t ap_count = 0;
esp_wifi_scan_get_ap_records(&SCAN_LIST_SIZE, ap_info);
esp_wifi_scan_get_ap_num(&ap_count);
ESP_LOGI(TAG, "发现%d个热点", ap_count);
for(int i=0; i<ap_count && i<SCAN_LIST_SIZE; i++) {
ESP_LOGI(TAG, "SSID: %s, 信号强度: %d, 信道: %d",
ap_info[i].ssid, ap_info[i].rssi, ap_info[i].primary);
}
}
void app_main() {
// 初始化NVS
ESP_ERROR_CHECK(nvs_flash_init());
// WiFi初始化
wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
ESP_ERROR_CHECK(esp_wifi_init(&cfg));
ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
ESP_ERROR_CHECK(esp_wifi_start());
// 开始扫描
ESP_ERROR_CHECK(esp_wifi_scan_start(NULL, true));
scan_results();
}
烧录这段代码后,你会在串口监视器看到附近所有WiFi热点的SSID、信号强度和信道信息。我在办公室测试时,最多一次扫到了23个热点,ESP32-C3的扫描能力确实不错。
2.2 进阶:使用事件回调的扫描方式
上面的代码虽然简单,但有个明显缺点——它是阻塞式的。在实际项目中,我们更推荐使用事件回调的方式。这种方式更符合物联网设备的实际工作场景,不会阻塞主线程。
c复制static void wifi_event_handler(void* arg, esp_event_base_t event_base,
int32_t event_id, void
