ESP32双核任务亲和性实战：WiFi协议栈钉Core0、应用逻辑放Core1的配置与踩坑指南

一、为什么需要任务亲和性

ESP32是双核Xtensa LX6，FreeRTOS SMP调度器默认允许任务在任意核心运行。WiFi协议栈（wifi、tcpip、esp_timer等任务）对时序敏感，若与应用任务频繁跨核迁移，会带来：

  • 缓存失效与上下文切换开销增加
  • WiFi收发延迟抖动，TCP吞吐下降
  • 应用实时任务被协议栈抢占，控制周期不稳定

把WiFi协议栈任务钉在Core0、应用逻辑放Core1，可形成“通信核+应用核”的分工，减少干扰。

二、原理：亲和性与调度

FreeRTOS提供xTaskCreatePinnedToCore()，最后一个参数xCoreID指定核心（0或1）。ESP-IDF中WiFi相关任务由协议栈内部创建，可通过esp_netif和esp_wifi的配置间接影响，但更可靠的做法是：

  • 应用任务显式PinnedToCore(..., 1)
  • 在menuconfig中开启CONFIG_FREERTOS_UNICORE=n，并设置CONFIG_ESP32_WIFI_TASK_CORE_ID=0（部分IDF版本提供）
  • 对无法直接钉核的协议栈任务，通过优先级与vTaskPrioritySet配合，避免其迁移到Core1

注意：tcpip任务默认在Core0，esp_timer任务也倾向Core0。应用任务放Core1后，跨核通信必须使用线程安全队列。

三、配置步骤

  1. idf.py menuconfig → Component config → FreeRTOS → 确认双核开启。
  2. Component config → ESP32-specific → WiFi → 设置WiFi任务核心为Core0（若选项存在）。
  3. 应用任务统一用xTaskCreatePinnedToCore创建，核心号传1。
  4. 中断分配：WiFi中断默认Core0，应用外设中断可绑定Core1（esp_intr_alloc带核心参数）。
  5. 跨核数据用xQueueCreate/xQueueSend，不要用全局变量裸传。

四、完整代码示例

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "nvs_flash.h"

static QueueHandle_t s_cmd_q;

// 应用任务：固定在Core1
typedef struct { int cmd; int arg; } app_cmd_t;

static void app_task(void *arg)
{
    app_cmd_t c;
    for (;;) {
        if (xQueueReceive(s_cmd_q, &c, portMAX_DELAY) == pdTRUE) {
            // 应用逻辑，例如电机控制、传感器采样
            printf("app core=%d cmd=%d\n", xPortGetCoreID(), c.cmd);
        }
    }
}

// WiFi事件回调运行在协议栈上下文（Core0）
static void wifi_event_handler(void *arg, esp_event_base_t base,
                               int32_t id, void *data)
{
    if (base == WIFI_EVENT && id == WIFI_EVENT_STA_CONNECTED) {
        app_cmd_t c = { .cmd = 1, .arg = 0 };
        xQueueSend(s_cmd_q, &c, 0); // 跨核投递
    }
}

void app_main(void)
{
    nvs_flash_init();
    esp_netif_init();
    esp_event_loop_create_default();

    s_cmd_q = xQueueCreate(8, sizeof(app_cmd_t));

    // 应用任务钉在Core1，优先级低于WiFi任务
    xTaskCreatePinnedToCore(app_task, "app", 4096, NULL, 5, NULL, 1);

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);
    esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID,
                               wifi_event_handler, NULL);

    wifi_config_t wc = { .sta = { .ssid = "AP", .password = "12345678" } };
    esp_wifi_set_mode(WIFI_MODE_STA);
    esp_wifi_set_config(WIFI_IF_STA, &wc);
    esp_wifi_start();
    esp_wifi_connect();
}

五、踩坑与注意事项

  • 看门狗：Core1应用任务若长时间阻塞，会触发任务看门狗。循环中加vTaskDelay或喂狗。
  • 优先级反转：应用任务优先级不要高于WiFi任务（通常tcpip为18），否则会饿死协议栈。
  • 跨核队列阻塞：xQueueSend在中断/事件回调中必须用FromISR版本或超时0。
  • Flash操作：写Flash会暂停另一核缓存，Core1高频任务需避开写Flash时段。
  • 日志串口：printf在双核下可能交错，建议用ESP_LOGI并控制频率。
  • 中断亲和：外设中断默认可能落在Core0，需用esp_intr_alloc指定核心，避免打断WiFi。

六、小结

双核亲和性不是“钉上就完事”，而是围绕WiFi协议栈的时序特性做任务划分。Core0保通信，Core1跑实时逻辑，配合跨核队列与合理优先级，才能获得稳定的吞吐与响应。