ESP32双核实操:xTaskCreate把任务拆到两个核

2026-11-17 13:25:08 46阅读 所属项目:ESP32 开发板

ESP32的片上系统里塞了两颗Xtensa 32位LX6微处理器,也就是core 0和core 1,出厂就是双核配置。但你在Arduino IDE里写完代码直接上传,所有代码默认只跑在core 1上,另一颗核全程看戏。想让它俩同时干活,得走FreeRTOS任务这条路。

ESP32双核FreeRTOS双任务封面图

这次把Random Nerd Tutorials那篇ESP32双核教程完整理了一遍:从查核函数xPortGetCoreID(),到xTaskCreatePinnedToCore()的七个参数,再到一个双LED跑双核的完整示例,按「新手能不能照着做出来」的标准把步骤捋顺。环境不用额外折腾,Arduino IDE对ESP32已经内置了FreeRTOS支持,装好ESP32板卡包就能写。

先搞清楚代码现在跑在哪个核

动手改代码之前,先确认现状。ESP32有个现成函数xPortGetCoreID(),返回当前代码所在的核编号。把它塞进setup()和loop()里各打印一次,烧进板子后打开串口监视器(115200波特率),你会看到两行输出都是core 1——这就是默认行为,Arduino框架把setup()和loop()都安排在了core 1上跑。

/*********
  Rui Santos
  Complete project details at https://randomnerdtutorials.com  
*********/

void setup() {
  Serial.begin(115200);
  Serial.print("setup() running on core ");
  Serial.println(xPortGetCoreID());
}

void loop() {
  Serial.print("loop() running on core ");
  Serial.println(xPortGetCoreID());
}

串口监视器输出setup与loop运行在core 1

另外有一条要先排查:不是所有ESP32都是双核。基于ESP32-S2、ESP32-C3、ESP32-C6、ESP32-H2的板子(比如ESP32-S2-Saola-1、ESP32-C3-DevKitM-1、Seeed Studio XIAO ESP32-C3这一类)只有单核,按核钉任务的玩法在那上面行不通。烧录失败或者函数行为对不上时,先回头查一眼手里的板子用的什么芯片,这里别踩。

用xTaskCreatePinnedToCore建任务

FreeRTOS把要干的活拆成「任务」(task):闪一个LED、采一轮传感器、发一次网络请求,都可以封装成一个任务。任务可以指定优先级,也可以指定落在哪个核上。优先级数值从0起步,0是最低,处理器会优先执行高优先级的任务。

想把某段代码钉到指定的核上,固定三步走。第一步,给任务建一个句柄,后面创建和删除都要用它:

TaskHandle_t Task1;

第二步,在setup()里用xTaskCreatePinnedToCore()创建任务。这个函数吃七个参数,其中优先级和核编号就在里面指定,最后一个参数就是要钉的核:

xTaskCreatePinnedToCore(
      Task1code, /* Function to implement the task */
      "Task1", /* Name of the task */
      10000,  /* Stack size in words */
      NULL,  /* Task input parameter */
      0,  /* Priority of the task */
      &Task1,  /* Task handle. */
      0); /* Core where the task should run */

第三步,写任务函数本体。for(;;)是无限循环,任务函数跑起来就跟loop()一个节奏,相当于给代码加了个第二loop:

Void Task1code( void * parameter) {
  for(;;) {
    Code for task 1 - infinite loop
    (...)
  }
}

想中途删掉某个任务,用vTaskDelete(),参数就是之前留着的任务句柄:

vTaskDelete(Task1);

双LED实例:两个核各闪各的

底稿示例用的硬件很朴素:ESP32 DOIT DEVKIT V1开发板(或者其他双核ESP32板)、两颗5mm LED、两个330欧电阻、面包板加杜邦线。接线不用动脑:每颗LED串一个330欧限流电阻接到GPIO,LED1接GPIO 2,LED2接GPIO 4,面包板上一摆就行。

两颗LED接GPIO2和GPIO4的面包板接线图

目标是Task1跑在core 0上、每1秒闪一次LED1;Task2跑在core 1上、每700毫秒闪一次LED2。两个周期故意错开,串口监视器一眼就能分辨谁在哪个核。完整代码如下,可以整段复制进Arduino IDE直接烧:

/*********
  Rui Santos
  Complete project details at https://randomnerdtutorials.com  
*********/

TaskHandle_t Task1;
TaskHandle_t Task2;

// LED pins
const int led1 = 2;
const int led2 = 4;

void setup() {
  Serial.begin(115200); 
  pinMode(led1, OUTPUT);
  pinMode(led2, OUTPUT);

  //create a task that will be executed in the Task1code() function, with priority 1 and executed on core 0
  xTaskCreatePinnedToCore(
                    Task1code,   /* Task function. */
                    "Task1",     /* name of task. */
                    10000,       /* Stack size of task */
                    NULL,        /* parameter of the task */
                    1,           /* priority of the task */
                    &Task1,      /* Task handle to keep track of created task */
                    0);          /* pin task to core 0 */                  
  delay(500); 

  //create a task that will be executed in the Task2code() function, with priority 1 and executed on core 1
  xTaskCreatePinnedToCore(
                    Task2code,   /* Task function. */
                    "Task2",     /* name of task. */
                    10000,       /* Stack size of task */
                    NULL,        /* parameter of the task */
                    1,           /* priority of the task */
                    &Task2,      /* Task handle to keep track of created task */
                    1);          /* pin task to core 1 */
    delay(500); 
}

//Task1code: blinks an LED every 1000 ms
void Task1code( void * pvParameters ){
  Serial.print("Task1 running on core ");
  Serial.println(xPortGetCoreID());

  for(;;){
    digitalWrite(led1, HIGH);
    delay(1000);
    digitalWrite(led1, LOW);
    delay(1000);
  } 
}

//Task2code: blinks an LED every 700 ms
void Task2code( void * pvParameters ){
  Serial.print("Task2 running on core ");
  Serial.println(xPortGetCoreID());

  for(;;){
    digitalWrite(led2, HIGH);
    delay(700);
    digitalWrite(led2, LOW);
    delay(700);
  }
}

void loop() {
  
}

代码逐段拆:七个参数各管什么

程序开头给两个任务各建了句柄Task1和Task2,LED引脚声明为GPIO 2和GPIO 4。setup()里先Serial.begin(115200)初始化串口,再用pinMode()把两个引脚设为输出,然后连续两次调用xTaskCreatePinnedToCore(),中间各delay(500)隔开,给任务留启动时间。

重点看这七个参数。第一个是任务函数名Task1code;第二个是任务名"Task1",调试时好认;第三个10000是栈大小,注意单位是word不是字节;第四个NULL表示不给任务传参;第五个1是优先级;第六个&Task1是句柄,留着以后vTaskDelete()用;第七个是核编号——Task1填0,Task2填1。

两个任务函数开头都先打印一次xPortGetCoreID(),方便在串口监视器里确认任务真的落在指定的核上。Task1code里的for(;;)循环以1秒为周期拉高拉低led1,Task2code同款结构,周期改成700毫秒。最后的loop()是空的——loop()本身就跑在core 1上,其实可以直接把Task2的代码写进loop()里,教程为了演示才专门建了两个任务;真项目里按任务组织代码通常更清爽。

串口监视器打印Task1与Task2运行所在核

演示结果与三条提醒

烧录时确认板子型号和COM口选对,打开115200的串口监视器,应该能看到Task1 running on core 0和Task2 running on core 1两行输出,说明任务确实各就各位。电路那边,一个LED按1秒周期闪,另一个按700毫秒周期闪,节奏明显错开,这就是两个核在同时干活。

双核双LED实验实物演示

三条提醒收尾。一是栈大小10000的单位是word,任务里要塞大数组、大结构体之前先掂量栈够不够;二是LED只是练手,真项目里更常见的分工是一个核采传感器、另一个核做数据的上报处理,两边互不拖累;三是这套写法的价值不只在提速,更在于把两段活彻底隔离——一边卡住,另一边照跑不误。

对经常做实机部署的人来说,双核分工是ESP32最值得先吃透的特性之一。把任务钉核这套动作练熟,后面再上手队列、信号量这些FreeRTOS机制,就是顺路的事。


作者:写launch的皮皮
链接:https://www.aiddithome.com/p/491735af3d21b.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
刷着刷着入坑了
1楼 · 2026-11-17 13:26:14

提醒单核板子那段很必要,我手头就有块C3的,之前照S2教程跑一直报错,查了半天才发现根本不是双核,白折腾一晚上。

好说好说
2楼 · 2026-11-17 13:26:14

for(;;)当第二loop用这个说法挺妙的,比文档里那些绕来绕去的解释好懂多了。

电烙铁爱好者
3楼 · 2026-11-17 13:26:13

这篇把我上次折腾ESP32时一直没搞明白的点讲透了。之前以为双核就是速度快一倍,看完才知道loop()默认钉在core 1,core 0一直闲着,白白浪费。照着xTaskCreatePinnedToCore那个七参数表把温湿度采集钉到core 0、显示逻辑留在core 1之后,两边再也不互相卡了。栈大小那个word单位确实容易踩,我第一次填小了任务直接重启,后来才反应过来。

阿强焊点总飞
4楼 · 2026-11-17 13:26:13

GPIO 2和GPIO 4接LED这个例子选得好,周期一个1秒一个700毫秒,串口里Task1 core 0、Task2 core 1一眼就能看懂双核是咋回事。