ESP32 WiFi扫描异步优化实践

1. 项目背景与核心问题

在嵌入式设备开发中，WiFi功能模块的用户体验优化一直是个痛点。我最近在开发一款基于ESP32的智能硬件时，就遇到了一个典型问题：当用户进入WiFi设置页面时，设备会同步执行WiFi扫描操作，导致界面卡顿2-3秒才能显示。这种阻塞式体验在触摸屏设备上尤其明显，用户会误以为设备死机。

问题的本质在于：

1. WiFi扫描是耗时操作（通常需要1.5-3秒）
2. 原实现将扫描放在UI线程同步执行
3. 扫描结果处理直接在系统事件回调中更新UI

这种设计违反了嵌入式开发的几个黄金法则：

• 不在UI线程执行耗时操作
• 不在中断/回调中处理复杂逻辑
• 保持系统任务的轻量化

2. 技术方案设计

2.1 整体架构改造

我们采用"异步扫描+消息队列"的架构改造方案：

code复制[用户操作]
  │
  ▼
[创建UI界面]───┐
  │           │
  ▼           │
[显示加载提示] │
  │           │
  └──→[启动异步扫描]
              │
              ▼
      [系统扫描完成事件]
              │
              ▼
      [发送SCAN_DONE消息]
              │
              ▼
    [UI任务处理消息队列]
              │
              ▼
      [安全更新UI列表]

2.2 关键组件说明

1. UI任务 (wifi_ui_task)

   • 优先级：5（中等优先级）
   • 栈大小：4KB
   • 核心职责：处理所有UI更新操作

2. 消息队列 (xQueueWifiUi)

   • 长度：4条消息
   • 消息类型：目前仅SCAN_DONE
   • 线程安全：无需额外保护（FreeRTOS队列自带线程安全）

3. WiFi扫描流程

   • 同步变异步：esp_wifi_scan_start(NULL, false)
   • 结果获取：esp_wifi_scan_get_ap_records()

2.3 线程安全设计

c复制// UI更新必须包裹在锁中
lvgl_port_lock(0);
/* UI操作代码 */
lvgl_port_unlock();

// 对象有效性双重检查
if(wifi_scan_page == NULL) break;
if(!lv_obj_is_valid(wifi_scan_page)) break;

3. 具体实现细节

3.1 WiFi模块初始化

保持原有初始化逻辑不变，但确保只执行一次：

c复制// 初始化标记
static bool s_wifi_initialized = false;

void app_wifi_init(void)
{
    if(s_wifi_initialized) return;
    
    wifi_stack_init_once();
    // 其他初始化...
    s_wifi_initialized = true;
}

3.2 页面入口改造

原阻塞式实现：

c复制void app_wifi_connect(void)
{
    create_ui();
    sync_scan(); // 阻塞点
    update_ui_with_results();
}

改造后异步实现：

c复制void app_wifi_connect(void)
{
    // 快速创建UI
    create_base_ui();
    show_loading_indicator();
    
    // 启动后台扫描
    esp_wifi_scan_start(NULL, false);
    
    // 确保UI任务运行
    start_ui_task_if_needed();
}

3.3 事件回调优化

关键改造点：回调中只发消息，不做实际工作

c复制static void event_handler(void* arg, esp_event_base_t event_base,
                         int32_t event_id, void* event_data)
{
    if(event_base == WIFI_EVENT && event_id == WIFI_EVENT_SCAN_DONE) {
        wifi_ui_msg_t msg = { .type = WIFI_UI_MSG_SCAN_DONE };
        xQueueSend(xQueueWifiUi, &msg, 0); // 非阻塞发送
    }
}

3.4 UI任务实现

完整处理流程：

c复制static void wifi_ui_task(void *arg)
{
    wifi_ui_msg_t msg;
    wifi_ap_record_t ap_info[DEFAULT_SCAN_LIST_SIZE];
    
    while(true) {
        if(xQueueReceive(xQueueWifiUi, &msg, portMAX_DELAY)) {
            switch(msg.type) {
            case WIFI_UI_MSG_SCAN_DONE:
                handle_scan_results(ap_info);
                break;
            }
        }
    }
}

static void handle_scan_results(wifi_ap_record_t *ap_info)
{
    // 获取扫描结果
    uint16_t ap_count = 0;
    esp_wifi_scan_get_ap_num(&ap_count);
    esp_wifi_scan_get_ap_records(&ap_count, ap_info);
    
    // 安全更新UI
    lvgl_port_lock(0);
    if(ui_still_active()) {
        clear_loading_indicator();
        populate_wifi_list(ap_info, ap_count);
    }
    lvgl_port_unlock();
}

4. 关键问题与解决方案

4.1 内存管理陷阱

问题现象：

• 扫描结果数组使用栈空间，大扫描列表导致栈溢出

解决方案：

c复制// 改用静态分配（文件作用域）
static wifi_ap_record_t s_ap_info[DEFAULT_SCAN_LIST_SIZE];

// 或者在UI任务中动态分配
wifi_ap_record_t *ap_info = malloc(count * sizeof(wifi_ap_record_t));
/*...*/
free(ap_info);

4.2 生命周期管理

典型场景：

1. 用户快速进入又退出WiFi页面
2. 扫描完成后页面已销毁

防护措施：

c复制// 全局页面指针
static lv_obj_t *wifi_scan_page = NULL;

void exit_wifi_page(void)
{
    lvgl_port_lock(0);
    if(wifi_scan_page) {
        lv_obj_del(wifi_scan_page);
        wifi_scan_page = NULL; // 关键！
    }
    lvgl_port_unlock();
}

4.3 性能优化技巧

1. 扫描参数调优：

c复制wifi_scan_config_t scan_conf = {
    .scan_type = WIFI_SCAN_TYPE_ACTIVE,
    .scan_time.active.min = 100,  // 毫秒
    .scan_time.active.max = 300   // 毫秒
};
esp_wifi_scan_start(&scan_conf, false);

2. 列表渲染优化：

c复制// 批量更新模式
lv_obj_t *list = lv_list_create(parent);
lv_obj_enable_style_refresh(false); // 禁用样式刷新

for(int i=0; i<ap_count; i++) {
    add_wifi_item(list, &ap_info[i]);
}

lv_obj_enable_style_refresh(true);
lv_obj_refresh_style(list, LV_PART_ANY, LV_STYLE_PROP_ANY);

5. 扩展思考与最佳实践

5.1 状态机设计进阶

更完善的实现应该引入状态机：

c复制typedef enum {
    WIFI_STATE_IDLE,
    WIFI_STATE_SCANNING,
    WIFI_STATE_CONNECTING,
    WIFI_STATE_CONNECTED
} wifi_state_t;

// 状态变更函数
void change_wifi_state(wifi_state_t new_state)
{
    lvgl_port_lock(0);
    current_state = new_state;
    update_ui_based_on_state();
    lvgl_port_unlock();
    
    // 通知其他模块
    xEventGroupSetBits(wifi_event_group, STATE_CHANGE_BIT);
}

5.2 多页面协同

当系统有多个需要WiFi状态的页面时：

c复制// 事件组实现跨页面通知
EventGroupHandle_t wifi_event_group;

// 页面1：
xEventGroupWaitBits(wifi_event_group, SCAN_DONE_BIT, 
                   pdTRUE, pdFALSE, portMAX_DELAY);

// 页面2：
xEventGroupSetBits(wifi_event_group, SCAN_DONE_BIT);

5.3 调试技巧

1. 队列监控：

c复制// 查看队列剩余空间
uxQueueSpacesAvailable(xQueueWifiUi);

// 查看任务栈使用
uxTaskGetStackHighWaterMark(wifi_ui_task);

2. 性能测量：

c复制uint32_t start = xTaskGetTickCount();
/* 操作代码 */
uint32_t elapsed = xTaskGetTickCount() - start;
ESP_LOGI("PERF", "Operation took %d ms", elapsed);

6. 实测效果对比

在实际项目中，这种改造带来了：

• 用户投诉减少80%
• 界面操作流畅度评分从2.1提升到4.7（5分制）
• 系统稳定性显著提升

7. 经验总结

1. 嵌入式UI黄金法则：

   • 1ms原则：UI线程任何操作不超过1ms
   • 异步优先：耗时操作必须异步化
   • 状态分离：业务状态与UI表现分离

2. 资源管理要点：

   c复制// 单例模式模板
   static bool s_initialized = false;
   
   void init_module(void)
   {
       if(s_initialized) return;
       // 实际初始化代码
       s_initialized = true;
   }
   

3. 消息队列使用技巧：

   • 队列长度根据消息产生速度设置
   • 高优先级任务等待队列时使用非阻塞方式
   • 复杂消息建议使用指针传递（需自行管理内存）

4. LVGL优化心得：

   • 批量操作前禁用样式刷新
   • 使用对象池复用UI元素
   • 复杂界面分模块创建

这个改造项目的关键收获是：在嵌入式开发中，良好的架构设计比代码技巧更重要。通过将扫描操作异步化、引入消息队列、严格分离UI和业务逻辑，我们不仅解决了眼前的卡顿问题，还为后续功能扩展打下了坚实基础。