FreeRTOS 11.0.1中vTaskList与vTaskListTasks在RP2040上失效问题

核心问题1：主函数中调度器启动后的代码永远不会执行 #

vTaskStartScheduler()启动FreeRTOS调度器后，系统会接管CPU并开始调度任务，该函数不会正常返回（除非堆内存不足导致调度器启动失败）。你主函数中vTaskStartScheduler()之后的vTaskList()和printf()代码根本没有执行机会，这是串口无输出的直接原因。

核心问题2：单独创建任务调用vTaskList时程序无法运行 #

大概率是以下原因导致：

• 任务栈空间不足：vTaskList()需要足够的栈空间来完成任务信息的格式化操作，默认256字节栈可能不够。
• 堆内存不足：cyw43_arch_init()会创建自身的任务，加上你的自定义任务，默认堆内存可能无法容纳所有任务创建请求。
• 配置缺失：虽然你已经开启了必要的宏，但部分辅助配置可能未正确设置。

具体修复步骤 #

1. 调整代码结构，将vTaskList调用移至专用任务中 #

删除主函数中调度器后的无效代码，创建一个专门用于打印任务列表的调试任务，并分配足够的栈空间：

#include <stdio.h>
#include "pico/stdlib.h"
#include "cyw43_arch.h"
#include "FreeRTOS.h"
#include "task.h"

void external_led_task(void *param) {
    while (1) {
        cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 1);
        vTaskDelay(pdMS_TO_TICKS(500));
        cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 0);
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

void onboard_led_task(void *param) {
    const uint LED_PIN = PICO_DEFAULT_LED_PIN;
    gpio_init(LED_PIN);
    gpio_set_dir(LED_PIN, GPIO_OUT);
    while (1) {
        gpio_put(LED_PIN, 1);
        vTaskDelay(pdMS_TO_TICKS(1000));
        gpio_put(LED_PIN, 0);
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

// 调试任务：定期打印任务列表
void debug_task(void *param) {
    char pcWriteBuffer[2048]; // 分配足够大的缓冲区存储任务列表
    while (1) {
        vTaskList(pcWriteBuffer);
        printf("===== FreeRTOS Task List =====\n");
        printf("%s\n", pcWriteBuffer);
        vTaskDelay(pdMS_TO_TICKS(2000)); // 每2秒刷新一次
    }
}

int main() {
    stdio_init_all();
    if (cyw43_arch_init()) {
        printf("CYW43 initialization failed\n");
        return -1;
    }

    // 创建任务：给调试任务分配1024字节栈空间
    xTaskCreate(external_led_task, "ExtLED", 256, NULL, 3, NULL);
    xTaskCreate(onboard_led_task, "OnboardLED", 256, NULL, 3, NULL);
    xTaskCreate(debug_task, "Debug", 1024, NULL, 3, NULL);

    vTaskStartScheduler();

    // 以下代码仅在调度器启动失败时执行
    printf("FreeRTOS scheduler failed to start\n");
    while(1);
}

2. 调整FreeRTOS配置参数 #

修改FreeRTOSConfig.h，确保堆内存和辅助配置满足需求：

// 已有的必要配置
#define configUSE_TRACE_FACILITY                1
#define configUSE_STATS_FORMATTING_FUNCTIONS    1

// 增大堆内存（根据任务数量调整，建议16K以上）
#define configTOTAL_HEAP_SIZE                   (16 * 1024)

// 确保任务名称长度足够（默认16，一般无需修改）
#define configMAX_TASK_NAME_LEN                 16

3. 排查其他可能问题 #

• 确认minicom串口配置：波特率115200、8位数据位、无校验、1位停止位，关闭硬件流控。
• 避免使用vTaskListTasks：该函数部分FreeRTOS版本未提供，优先使用标准的vTaskList。
• 检查任务创建返回值：可以通过xTaskCreate的返回值确认任务是否创建成功，比如：

  BaseType_t ret = xTaskCreate(debug_task, "Debug", 1024, NULL, 3, NULL);
  if (ret != pdPASS) {
      printf("Failed to create debug task\n");
  }
  

内容的提问来源于stack exchange，提问作者bogan