嵌入式 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 名称。下面命令本身可直接执行,不依赖具体芯片工程。

bash
arm-none-eabi-gcc --version
arm-none-eabi-size --version

预期输出

text
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。

Cortex-M 工程接入 FreeRTOS 的文件关系

若工程使用 CMake,可以在已经存在的 firmware 目标上追加 FreeRTOS 源文件。下面是片段示例,依赖上下文是工程已定义 firmware 目标,并把 FREERTOS_KERNEL 与 FREERTOS_PORT_DIR 指向实际目录。

cmake
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 的值需要按目标芯片和中断规划确认。

c
#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;如果你的构建目录不同,替换对应路径。

bash
arm-none-eabi-nm -g --defined-only build/firmware.elf | grep -E 'Reset_Handler|vTaskStartScheduler|xTaskCreate'
arm-none-eabi-size build/firmware.elf

预期输出

text
<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。

c
#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 的工程可以执行下面命令,把接口和目标配置替换为本机实际文件。

bash
openocd -f <INTERFACE_CFG> -f <TARGET_CFG> -c "program build/firmware.elf verify reset exit"

预期输出

text
<OpenOCD initialization log>
** Programming Finished **
** Verify Started **
** Verified OK **
** Resetting Target **

然后打开串口终端。若已安装 PySerial,可以直接运行:

bash
python -m serial.tools.miniterm <PORT> 115200

预期输出

text
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 符号检查、下载校验和串口心跳三层都通过后,这个工程就可以作为后续队列、互斥量、软件定时器和中断同步实验的共同基线。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 Cortex-M 实验工程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通