嵌入式 Linux 与 RTOS / 系统课时
准备 Cortex-M 实验工程
准备 Cortex-M 实验工程
本节把一个可启动、可串口输出的 Cortex-M 裸机工程扩展成 FreeRTOS Kernel 11.3.x 实验基线。重点不是绑定某块开发板,而是建立一条可重复验证的链路:工具链可用、启动与链接正确、内核源码和端口匹配、固件能下载,串口能看到调度器启动后的输出。
学习目标
- 检查 GCC 或厂商 IDE 工程是否具备可用的启动文件、链接脚本、系统时钟和串口输出。
- 正确加入 FreeRTOS Kernel、Cortex-M 端口层、堆实现与
FreeRTOSConfig.h。 - 通过 ELF 符号、下载日志和串口输出逐层确认实验环境可复现。
先固定工具链与裸机基线
如果使用 GCC,先确认交叉编译器和 Binutils 能从终端直接调用;厂商 IDE 用户也应确认实际使用的是哪套编译器,而不是只看 IDE 名称。下面命令本身可直接执行,不依赖具体芯片工程。
arm-none-eabi-gcc --version
arm-none-eabi-size --version预期输出
arm-none-eabi-gcc (...) <VERSION>
GNU size (...) <VERSION>版本字符串会随安装包不同而变化,只要两个命令都能正常返回且退出码为 0 即可。接着先让不含 FreeRTOS的基线工程通过三项检查:复位后能进入 main、系统时钟配置正确、串口能稳定打印一行启动信息。若裸机基线尚不稳定,不要把启动、链接或时钟问题带进 RTOS 集成阶段。
把 Kernel、端口层和内存管理接进工程
FreeRTOS Kernel 源码可以分成三类:与 CPU 无关的核心源码、与编译器和 Cortex-M 内核相关的 portable 端口、以及堆实现。端口目录必须与实际 Cortex-M 型号、是否使用 FPU 和编译器一致;例如 Cortex-M4F 工程不能随意换成另一个架构的 port.c。

若工程使用 CMake,可以在已经存在的 firmware 目标上追加 FreeRTOS 源文件。下面是片段示例,依赖上下文是工程已定义 firmware 目标,并把 FREERTOS_KERNEL 与 FREERTOS_PORT_DIR 指向实际目录。
target_sources(firmware PRIVATE
${FREERTOS_KERNEL}/tasks.c
${FREERTOS_KERNEL}/queue.c
${FREERTOS_KERNEL}/list.c
${FREERTOS_KERNEL}/timers.c
${FREERTOS_KERNEL}/event_groups.c
${FREERTOS_KERNEL}/stream_buffer.c
${FREERTOS_PORT_DIR}/port.c
${FREERTOS_KERNEL}/portable/MemMang/heap_4.c
)
target_include_directories(firmware PRIVATE
${FREERTOS_KERNEL}/include
${FREERTOS_PORT_DIR}
${CMAKE_CURRENT_SOURCE_DIR}
)这段配置生效后,构建系统会把 Kernel 核心、所选 Cortex-M 端口和 heap_4.c 一起编译,并允许源码包含 FreeRTOS.h 与 task.h。验证方法是在最终 ELF 中确认调度器和任务 API 符号已经被链接。
FreeRTOSConfig.h 至少要给出调度方式、Tick、优先级、堆与需要启用的 API。Cortex-M 中断优先级还依赖芯片的 __NVIC_PRIO_BITS,不要直接复制别的开发板数值。下面是片段示例,展示本实验必须关注的项目;configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 的值需要按目标芯片和中断规划确认。
#pragma once
#include <stdint.h>
#include "device_header.h"
#define configUSE_PREEMPTION 1
#define configCPU_CLOCK_HZ SystemCoreClock
#define configTICK_RATE_HZ ((TickType_t)1000)
#define configMAX_PRIORITIES 5
#define configMINIMAL_STACK_SIZE ((uint16_t)128)
#define configTOTAL_HEAP_SIZE ((size_t)(16 * 1024))
#define configUSE_16_BIT_TICKS 0
#define configSUPPORT_DYNAMIC_ALLOCATION 1
#define configUSE_MUTEXES 1
#define INCLUDE_vTaskDelay 1
#define configPRIO_BITS __NVIC_PRIO_BITS
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY ((1U << configPRIO_BITS) - 1U)
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5U
#define configKERNEL_INTERRUPT_PRIORITY (configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8U - configPRIO_BITS))
#define configMAX_SYSCALL_INTERRUPT_PRIORITY (configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8U - configPRIO_BITS))
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler
#define xPortSysTickHandler SysTick_Handler这份配置依赖芯片头文件提供 SystemCoreClock 与 __NVIC_PRIO_BITS。如果目标器件的可用优先级位数不足以容纳值 5U,必须改成合法且符合系统中断分层的值。三个 Handler 映射让 FreeRTOS Cortex-M 端口使用向量表中的 SVC、PendSV 与 SysTick 名称;若厂商框架已经实现 SysTick_Handler,要先解决重复定义或 Tick 所有权冲突。
编译后先验证 ELF,而不是直接猜运行问题
完成源码接入后,重新构建工程,然后检查最终 ELF 是否同时包含复位入口和 FreeRTOS 关键符号。下面命令假设产物名为 build/firmware.elf;如果你的构建目录不同,替换对应路径。
arm-none-eabi-nm -g --defined-only build/firmware.elf | grep -E 'Reset_Handler|vTaskStartScheduler|xTaskCreate'
arm-none-eabi-size build/firmware.elf预期输出
<ADDR> T Reset_Handler
<ADDR> T vTaskStartScheduler
<ADDR> T xTaskCreate
text data bss dec hex filename
<SIZE> <SIZE> <SIZE> <SIZE> <SIZE> build/firmware.elf地址和段大小会随芯片、优化级别和链接脚本变化。若 Reset_Handler 缺失,优先检查启动文件和链接脚本;若 FreeRTOS 符号缺失,检查 Kernel 源文件是否真的加入目标,或是否被链接器当作未引用代码裁剪。
启动调度器并从串口确认任务运行
为了验证“内核不仅编译进去了,而且真的开始调度”,可以在裸机基线的 main 中创建一个最小心跳任务。下面是片段示例,依赖上下文是板级代码已经提供 board_init(),并且 puts() 已重定向到可用 UART。
#include <stdio.h>
#include "FreeRTOS.h"
#include "task.h"
static void heartbeat_task(void *arg)
{
(void)arg;
for (;;) {
puts("freertos heartbeat");
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
int main(void)
{
board_init();
BaseType_t ok = xTaskCreate(
heartbeat_task,
"heartbeat",
256,
NULL,
1,
NULL
);
if (ok != pdPASS) {
puts("task create failed");
for (;;) {
}
}
puts("starting scheduler");
vTaskStartScheduler();
puts("scheduler returned");
for (;;) {
}
}验证时先下载 ELF。使用 OpenOCD 的工程可以执行下面命令,把接口和目标配置替换为本机实际文件。
openocd -f <INTERFACE_CFG> -f <TARGET_CFG> -c "program build/firmware.elf verify reset exit"预期输出
<OpenOCD initialization log>
** Programming Finished **
** Verify Started **
** Verified OK **
** Resetting Target **然后打开串口终端。若已安装 PySerial,可以直接运行:
python -m serial.tools.miniterm <PORT> 115200预期输出
starting scheduler
freertos heartbeat
freertos heartbeat
freertos heartbeat<PORT> 在 Windows 可能是 COM<ID>,在 Linux/macOS 可能是 /dev/<DEVICE>;实际名称不同是正常的。心跳大约每秒出现一次,说明启动文件、时钟、Kernel、端口层、堆、SysTick/PendSV/SVC 以及 UART 输出这条链路已经基本贯通。
按症状定位最常见的集成失败
链接阶段报 undefined reference 到 vPortSVCHandler、xPortPendSVHandler 或端口相关符号时,通常是 port.c 没有加入,或选错了 portable 目录。若出现 SysTick_Handler 多重定义,则是 FreeRTOS Handler 映射与厂商 HAL 的 Tick 实现发生冲突,需要明确谁拥有 SysTick。
如果程序在 vTaskStartScheduler() 后立刻进入 HardFault,优先核对 Cortex-M 端口是否匹配 FPU/内核型号、FreeRTOSConfig.h 的中断优先级配置是否符合该芯片、主栈和任务堆是否落在有效 RAM。若能启动但任务创建失败,则先看 configTOTAL_HEAP_SIZE 和任务栈大小,不要先怀疑调度器。
当 ELF 符号检查、下载校验和串口心跳三层都通过后,这个工程就可以作为后续队列、互斥量、软件定时器和中断同步实验的共同基线。