当前位置：首页 > news >正文

树莓派Pico RP2040上跑FreeRTOS，从点亮LED开始你的第一个RTOS任务（附完整CMake配置）

news 2026/5/4 22:49:55

树莓派Pico RP2040上跑FreeRTOS，从点亮LED开始你的第一个RTOS任务（附完整CMake配置）

第一次接触实时操作系统（RTOS）的开发者，往往会被任务调度、优先级、内存管理等概念吓退。但当你手头有一块树莓派Pico，搭载着双核Cortex-M0+和264KB SRAM，不尝试一下多任务编程实在有些可惜。本文将带你从最基础的LED闪烁任务开始，一步步在Pico上搭建FreeRTOS开发环境，并解释每个关键步骤背后的设计考量。

1. 环境准备与项目初始化

在开始之前，确保你已经具备以下条件：

树莓派Pico开发板
安装好ARM GCC工具链和CMake
熟悉基本的Pico SDK开发流程（如点亮LED、串口打印）

首先创建一个基础项目目录结构：

pico_freertos_demo/ ├── CMakeLists.txt ├── pico_sdk_import.cmake └── src/ └── main.c

初始的CMakeLists.txt文件内容如下：

cmake_minimum_required(VERSION 3.13) include(pico_sdk_import.cmake) project(pico_freertos_demo C CXX ASM) set(CMAKE_C_STANDARD 11) set(CMAKE_CXX_STANDARD 17) pico_sdk_init() add_executable(pico_freertos_demo src/main.c ) pico_add_extra_outputs(pico_freertos_demo) target_link_libraries(pico_freertos_demo pico_stdlib )

这个基础配置可以确保你的Pico项目能够正常编译和运行。测试时可以创建一个简单的main.c文件，通过串口输出"Hello World"来验证环境是否正确配置。

2. 集成FreeRTOS内核

FreeRTOS官方提供了内核源码仓库，我们可以将其作为git子模块添加到项目中：

git submodule add https://github.com/FreeRTOS/FreeRTOS-Kernel.git freertos

这会在项目目录下创建一个freertos文件夹，包含完整的FreeRTOS内核源码。接下来需要为FreeRTOS创建一个独立的CMake构建配置。在项目根目录下创建freertos/CMakeLists.txt：

add_library(freertos STATIC FreeRTOS-Kernel/event_groups.c FreeRTOS-Kernel/list.c FreeRTOS-Kernel/queue.c FreeRTOS-Kernel/stream_buffer.c FreeRTOS-Kernel/tasks.c FreeRTOS-Kernel/timers.c FreeRTOS-Kernel/portable/GCC/ARM_CM0/port.c FreeRTOS-Kernel/portable/MemMang/heap_4.c ) target_include_directories(freertos PUBLIC include FreeRTOS-Kernel/include FreeRTOS-Kernel/portable/GCC/ARM_CM0 )

几个关键点需要注意：

我们选择了heap_4.c内存管理方案，因为它支持内存碎片整理，适合长期运行的系统
RP2040的Cortex-M0+核心使用ARM_CM0端口层
所有必要的内核源文件都被显式列出，避免引入不必要的组件

3. 配置FreeRTOS参数

FreeRTOS的行为通过FreeRTOSConfig.h文件进行配置。在freertos/include目录下创建这个文件：

#ifndef FREERTOS_CONFIG_H #define FREERTOS_CONFIG_H #define configUSE_PREEMPTION 1 #define configUSE_IDLE_HOOK 0 #define configUSE_TICK_HOOK 0 #define configCPU_CLOCK_HZ (133000000) #define configTICK_RATE_HZ ((TickType_t)1000) #define configMAX_PRIORITIES (5) #define configMINIMAL_STACK_SIZE ((uint16_t)128) #define configTOTAL_HEAP_SIZE ((size_t)64 * 1024) #define configMAX_TASK_NAME_LEN (16) #define configUSE_16_BIT_TICKS 0 #define configIDLE_SHOULD_YIELD 1 #define configUSE_MUTEXES 1 #define configUSE_RECURSIVE_MUTEXES 1 #define configUSE_COUNTING_SEMAPHORES 1 #define configUSE_APPLICATION_TASK_TAG 0 #define configUSE_TASK_NOTIFICATIONS 1 #define configUSE_TRACE_FACILITY 0 #define configUSE_STATS_FORMATTING_FUNCTIONS 0 #define configCHECK_FOR_STACK_OVERFLOW 2 #define configQUEUE_REGISTRY_SIZE 10 #define configSUPPORT_STATIC_ALLOCATION 1 #define configSUPPORT_DYNAMIC_ALLOCATION 1 #define INCLUDE_vTaskPrioritySet 1 #define INCLUDE_uxTaskPriorityGet 1 #define INCLUDE_vTaskDelete 1 #define INCLUDE_vTaskSuspend 1 #define INCLUDE_xTaskDelayUntil 1 #define INCLUDE_xTaskGetCurrentTaskHandle 1 #define vPortSVCHandler SVC_Handler #define xPortPendSVHandler PendSV_Handler #define xPortSysTickHandler SysTick_Handler #endif /* FREERTOS_CONFIG_H */

这份配置针对RP2040做了以下优化：

设置正确的CPU时钟频率（133MHz）
分配64KB内存给FreeRTOS堆
启用任务通知等实用功能
配置了正确的异常处理程序名称

4. 创建第一个RTOS任务

现在我们可以修改main.c来创建第一个FreeRTOS任务。我们将实现一个经典的LED闪烁任务：

#include "pico/stdlib.h" #include "FreeRTOS.h" #include "task.h" #define LED_TASK_STACK_SIZE 512 #define LED_TASK_PRIORITY (tskIDLE_PRIORITY + 1) static void led_task(void *arg) { const uint LED_PIN = PICO_DEFAULT_LED_PIN; gpio_init(LED_PIN); gpio_set_dir(LED_PIN, GPIO_OUT); while (true) { gpio_put(LED_PIN, 1); vTaskDelay(pdMS_TO_TICKS(500)); gpio_put(LED_PIN, 0); vTaskDelay(pdMS_TO_TICKS(500)); } } int main() { stdio_init_all(); TaskHandle_t led_task_handle = NULL; xTaskCreate(led_task, "LED Blinky", LED_TASK_STACK_SIZE, NULL, LED_TASK_PRIORITY, &led_task_handle); vTaskStartScheduler(); while (1) { // 不应该执行到这里 } }

关键点解析：

xTaskCreate函数创建新任务，需要指定任务函数、名称、栈大小、优先级等参数
vTaskDelay使用FreeRTOS的tick计数实现精确延时
pdMS_TO_TICKS宏将毫秒转换为系统tick数
任务栈大小设置为512字（2048字节），对于简单任务足够

5. 最终CMake配置整合

最后，我们需要修改项目根目录的CMakeLists.txt来整合所有组件：

cmake_minimum_required(VERSION 3.13) include(pico_sdk_import.cmake) project(pico_freertos_demo C CXX ASM) set(CMAKE_C_STANDARD 11) set(CMAKE_CXX_STANDARD 17) pico_sdk_init() add_subdirectory(freertos) add_executable(pico_freertos_demo src/main.c ) pico_add_extra_outputs(pico_freertos_demo) target_link_libraries(pico_freertos_demo pico_stdlib freertos hardware_uart )

构建项目时，确保使用以下命令设置正确的编译选项：

mkdir build && cd build cmake -DPICO_SDK_PATH=/path/to/pico-sdk .. make -j4

6. 调试与优化技巧

在实际开发中，你可能会遇到以下问题及解决方案：

USB权限问题（Linux系统）

sudo chmod a+rw /dev/ttyACM0

栈溢出检测在FreeRTOSConfig.h中启用栈溢出检查：

#define configCHECK_FOR_STACK_OVERFLOW 2

任务监控添加以下代码可以打印任务运行状态：

void print_task_stats() { TaskStatus_t *pxTaskStatusArray; volatile UBaseType_t uxArraySize, x; unsigned long ulTotalRunTime; uxArraySize = uxTaskGetNumberOfTasks(); pxTaskStatusArray = pvPortMalloc(uxArraySize * sizeof(TaskStatus_t)); if (pxTaskStatusArray != NULL) { uxArraySize = uxTaskGetSystemState(pxTaskStatusArray, uxArraySize, &ulTotalRunTime); for (x = 0; x < uxArraySize; x++) { printf("Task: %s \tPriority: %lu \tStack High Water Mark: %u\n", pxTaskStatusArray[x].pcTaskName, pxTaskStatusArray[x].uxCurrentPriority, pxTaskStatusArray[x].usStackHighWaterMark); } vPortFree(pxTaskStatusArray); } }

内存使用分析FreeRTOS提供了内存使用统计功能，在配置文件中启用：

#define configUSE_TRACE_FACILITY 1 #define configUSE_STATS_FORMATTING_FUNCTIONS 1

然后可以通过以下函数获取内存信息：

extern size_t xPortGetFreeHeapSize(void); extern size_t xPortGetMinimumEverFreeHeapSize(void);

7. 进阶：使用双核特性

RP2040的双核特性可以与FreeRTOS结合使用。虽然FreeRTOS本身不直接支持多核调度，但我们可以通过以下方式利用第二个核心：

#include "pico/multicore.h" void core1_entry() { while (true) { // 第二个核心的任务代码 } } int main() { stdio_init_all(); multicore_launch_core1(core1_entry); // FreeRTOS初始化代码... vTaskStartScheduler(); while (1) {} }

注意事项：