FreeRTOS实时操作系统:如何在电脑上3步跑通第一个多任务Demo
【免费下载链接】FreeRTOS'Classic' FreeRTOS distribution. Started as Git clone of FreeRTOS SourceForge SVN repo. Submodules the kernel.项目地址: https://gitcode.com/GitHub_Trending/fr/FreeRTOS
设备要同时跑传感器采集、通信和界面时,裸机的 if-else 轮询开始顾此失彼。FreeRTOS 是一个 MIT 协议的嵌入式实时操作系统,提供任务调度、队列与软件定时器,这份仓库还附带上百个硬件平台的示例工程,适合从裸机转向 RTOS 的开发者。
从裸机轮询到任务调度:什么时候需要FreeRTOS
在 MCU 上写裸机,一个主循环加 while(1) 能应付单功能,但功能一多就露馅:通信处理卡住 50ms,采样窗口错过;界面刷新等一个超时标志,逻辑分支越写越多。根源是单一主循环一次只能做一件事,所有功能的时间片都要靠手工切分。
FreeRTOS 的思路是让每个功能以独立"任务(task)"运行:每个任务有自己的栈和优先级,内核以抢占方式自动切换——任务等数据时挂起,数据到了再唤醒。你不再需要手工安排"什么时候轮谁",调度器负责这件事。
这对读者意味着:工程结构从"一个大循环"变成"多个小任务 + 任务间通信",多任务问题的复杂度会明显下降。
三步跑通:在Windows模拟器里编译第一个FreeRTOS示例
没有开发板也能先跑起来:仓库自带 Windows 模拟器移植,把任务映射成线程,在 PC 上验证调度与通信逻辑。
第 1 步:获取代码(注意带上内核子模块)
git clone --recursive https://gitcode.com/GitHub_Trending/fr/FreeRTOS--recursive不能省:内核源码位于 FreeRTOS/Source/,它是 git submodule,不检出就是空壳目录。
第 2 步:看懂最小配置
每个 demo 目录都有一个 FreeRTOSConfig.h,模拟器的在 FreeRTOS/Demo/WIN32-MingW/FreeRTOSConfig.h,上手时最相关的 5 个宏:
#define configUSE_PREEMPTION 1 #define configTICK_RATE_HZ ( 1000 ) #define configMINIMAL_STACK_SIZE ( ( unsigned short ) 70 ) #define configTOTAL_HEAP_SIZE ( ( size_t ) ( 100 * 1024 ) ) #define configMAX_PRIORITIES ( 7 )分别控制抢占开关、Tick 频率、最小栈大小、总堆空间、优先级数量,以后移植到真实板子,改的也是这几项。
第 3 步:构建并运行 blinky 演示
进入模拟器目录执行 make(需 MinGW GCC):
cd FreeRTOS/Demo/WIN32-MingW make产物是 build/RTOSDemo.exe。演示分两档,由 main.c 里的mainCREATE_SIMPLE_BLINKY_DEMO_ONLY宏切换:1 为精简版,0 为完整测试版。精简版创建 "Tx"、"Rx" 两个任务和 1 个软件定时器,Tx 每 200ms 向队列写一个值,Rx 收到后打印。核心在 main_blinky.c 中只有 4 行:
xQueue = xQueueCreate( mainQUEUE_LENGTH, sizeof( uint32_t ) ); xTaskCreate( prvQueueReceiveTask, "Rx", configMINIMAL_STACK_SIZE, NULL, mainQUEUE_RECEIVE_TASK_PRIORITY, NULL ); xTaskCreate( prvQueueSendTask, "TX", configMINIMAL_STACK_SIZE, NULL, mainQUEUE_SEND_TASK_PRIORITY, NULL ); vTaskStartScheduler();建队列、建两个任务、启动调度器,之后控制权就交给内核了。习惯 Visual Studio 的话,FreeRTOS/Demo/WIN32-MSVC/ 下现成有 WIN32.sln 工程。
这对读者意味着:不花一分钱买硬件,10 分钟内就能看到任务创建、队列通信、调度器运转的完整闭环。
模块地图:仓库里值得先看的5个路径
| 路径 | 作用 |
|---|---|
| FreeRTOS/Source/ | 内核本体内核(submodule):tasks.c、queue.c、timers.c、heap_x.c |
| FreeRTOS/Demo/ | 各平台示例工程,一块板子一个目录,共 150+ 份 |
| FreeRTOS/Demo/Common/ | 所有平台共用的演示文件:队列测试、闪烁测试、通信测试 |
| FreeRTOS/Test/ | 质量验证:CBMC 形式化验证、CMock 单元测试、VeriFast |
| FreeRTOS-Plus/ | 扩展库:网络协议栈、CLI 命令行、AWS IoT 组件 |
按板子型号在 Demo/ 里找工程即可,例如 STM32F103 有 CORTEX_STM32F103_Keil/、CORTEX_STM32F103_IAR/ 等多套工具链版本,RISC-V 有 RISC-V_RV32_QEMU_VIRT_GCC 等。其余旧平台、网络 demo 目录先跳过。
这对读者意味着:移植到新板子通常是"照抄一份现有 Demo 的工程骨架,再替换启动代码和驱动",不用从零搭工程。
核心机制:任务如何被调度,队列如何传数据
先说调度器。启动后,内核按优先级维护就绪表,永远运行优先级最高的就绪任务;任务调用 vTaskDelay 或等待空队列时,被挪到阻塞表,CPU 立即切走,不空转。切换时机由 Tick 中断驱动,示例里 1ms 一跳。
再说队列,任务间通信的主通道。发送方 xQueueSend、接收方 xQueueReceive:队列为空时接收者自动阻塞,数据一到内核唤醒它,不需要轮询。队列内部函数如何互相协作,仓库测试目录里有一张调用关系图,能看到收发、加锁(prvLockQueue)、拷贝(prvCopyDataToQueue)、状态检查等内部路径:
常用队列 API 只有四个:
| API | 作用 |
|---|---|
| xQueueCreate | 创建队列,指定容量与元素大小 |
| xQueueSend | 入队,队列满时可阻塞等待 |
| xQueueReceive | 出队,队列空时阻塞等待 |
| xQueuePeek | 只查看队首,不移除 |
demo 里做周期任务用的是 vTaskDelayUntil(&xNextWakeTime, xBlockTime) 而不是 vTaskDelay,保证固定周期不累积漂移,这个写法值得照抄:
for( ; ; ) { vTaskDelayUntil( &xNextWakeTime, xBlockTime ); xQueueSend( xQueue, &ulValueToSend, 0U ); }这对读者意味着:抓住"任务干活、队列传活"这条主线,官方所有 demo 的源码都能读得下去。
新手避坑:3个高频问题
坑 1:FreeRTOS/Source 是空的,构建找不到内核现象:clone 后 FreeRTOS/Source/ 目录为空,make 报找不到 tasks.c。原因:内核是 git submodule,默认只记录提交指针不拉内容。做法:clone 时加--recursive,或对已有仓库执行git submodule update --init FreeRTOS/Source。
坑 2:模拟器里 200ms 的周期变得忽快忽慢现象:打印间隔不规律,拿模拟器的时间戳去校验功能。原因:Windows 移植把任务映射成线程,调度由宿主系统决定,Tick 不是实时时钟,main_blinky.c 头部注释明确说不要期待实时行为。做法:模拟器只验证任务逻辑和队列流转,时间相关结论留给真实 MCU。
坑 3:vTaskStartScheduler 返回后程序"安静地死了"现象:启动后没有任务输出,直接落进死循环。原因:堆不够——configTOTAL_HEAP_SIZE 不足以创建空闲任务和定时器任务,调度器无法正常起来。做法:加大 FreeRTOSConfig.h 中的 configTOTAL_HEAP_SIZE;移植真实板子后用 vPortGetFreeHeapSize() 确认余量健康。
继续深入:从示例源码走到你的板子
源码阅读按三个入口推进:tasks.c 里的任务状态机与就绪表、queue.c 里的阻塞唤醒逻辑、heap_1 到 heap_5 五种内存分配策略的差异。各平台的移植层在 FreeRTOS/Source/portable/ 下按架构分目录,移植时重点看 port.c 的上下文切换与 Tick 中断处理。工程说明可从 FreeRTOS/Demo/readme.md 入手,它列出了每个 demo 对应的文档页;遇到具体问题,官方论坛和社区维护的 demo 仓库活跃度更高。
一个现在就能做的小任务:在模拟器 blinky 演示里加第三个任务,每 500ms 调用 xQueueReceive 接收一个与 100、200 不同的值并打印来源——改完 make 重新运行,观察输出变化。做完这一次,你对"队列阻塞与唤醒"的理解会超过翻十页文档。
【免费下载链接】FreeRTOS'Classic' FreeRTOS distribution. Started as Git clone of FreeRTOS SourceForge SVN repo. Submodules the kernel.项目地址: https://gitcode.com/GitHub_Trending/fr/FreeRTOS
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考