2. RA MCU硬件架构与FreeRTOS移植基础

FreeRTOS 在 RA MCU 上能否稳定运行，取决于三个硬件前提是否被正确理解：Cortex-M 内核的异常与栈模型、RA 的时钟与中断系统、以及内存映射与启动流程。移植层代码看似只有几个文件，但它对硬件的假设全部来自这三处。本节先把硬件侧的关键机制讲清楚，再落到 FreeRTOS 移植层的文件结构与启动顺序上。

Cortex-M 内核：FreeRTOS 依赖的三个硬件特性

RA 系列使用 Arm Cortex-M23/M33/M4 等内核，FreeRTOS 的移植层直接依赖以下机制。第一是双栈指针：MSP（主栈指针）用于异常处理和内核启动阶段，PSP（进程栈指针）用于任务上下文。FreeRTOS 在任务切换时通过 CONTROL 寄存器把线程模式切换到使用 PSP，从而让每个任务拥有独立栈空间。第二是PendSV 异常：它被配置为最低优先级，用于执行上下文切换。这样设计的原因是，当更高优先级中断到来时，PendSV 会被推迟，避免在中断服务程序中间强行切换任务。第三是SVC 异常：FreeRTOS 在启动调度器时用 SVC 触发第一次任务切换，把控制权从 MSP 交给第一个任务的 PSP。

理解这三个机制后，就能明白为什么 port.c 中必须实现 xPortPendSVHandler、vPortSVCHandler 和 xPortSysTickHandler 三个汇编入口，并且它们要与启动文件中的向量表名称一致。若名称不匹配，链接阶段不会报错，但运行时第一次任务切换就会跳转到默认死循环。

RA 时钟系统：SysTick 与任务节拍的来源

FreeRTOS 的节拍中断默认由 Cortex-M 内核的 SysTick 定时器产生，而 SysTick 的时钟源来自 RA 的时钟树。以 RA6M5 为例，典型路径是：外部晶振或内部 HOCO 作为主时钟源，经 PLL 倍频后得到系统时钟 ICLK，再经分频得到 SysTick 的参考时钟。假设 ICLK 配置为 200 MHz，SysTick 使用 ICLK/8 作为时钟源，则 SysTick 计数频率为 25 MHz。若 configTICK_RATE_HZ 设为 1000，则重装载值为 25000-1。这个计算关系必须在移植时核对，否则会出现节拍偏快或偏慢。

需要特别注意的是，RA 的 R_BSP 在 SystemInit() 中完成时钟初始化，而 FreeRTOS 的 vPortSetupTimerInterrupt() 通常在调度器启动时才配置 SysTick。因此时钟树必须先于 FreeRTOS 初始化完成，否则 SysTick 的重装载值会基于错误的 ICLK 计算。

中断控制器：ICU 与 FreeRTOS 中断优先级的关系

RA 的中断控制单元 ICU 管理 NVIC 的中断使能与优先级。Cortex-M 的优先级数值越小优先级越高，而 FreeRTOS 用 configMAX_SYSCALL_INTERRUPT_PRIORITY 划出一条分界线：优先级高于该阈值的中断不受 FreeRTOS 临界区屏蔽，也不能调用任何 FreeRTOS API；优先级低于或等于该阈值的中断可以被 taskENTER_CRITICAL() 屏蔽，并且允许调用 FromISR 系列 API。

在 RA 上配置时，需要把 configMAX_SYSCALL_INTERRUPT_PRIORITY 设置为一个合理的值，例如 5（对应 NVIC 优先级寄存器中的高 4 位）。然后检查所有使用 FreeRTOS API 的中断，其 ICU 优先级必须不低于该阈值。若某个中断优先级设为 2 却调用了 xQueueSendFromISR()，运行时可能破坏内核数据结构，表现为队列计数错乱或任务无法唤醒。

内存映射与启动流程

RA MCU 的 Flash 从 0x00000000 开始映射，复位后内核从该地址读取初始 MSP 和复位向量。向量表的前两项分别是栈顶地址和 Reset_Handler。启动文件 startup.c 或 startup_ra.s 负责把 .data 段从 Flash 复制到 SRAM，清零 .bss 段，然后调用 SystemInit() 配置时钟，最后跳转到 main()。

FreeRTOS 的堆空间通常由 configTOTAL_HEAP_SIZE 决定，使用 heap_4.c 时这块空间是静态数组，位于 .bss 段。任务栈、队列、信号量都从这里分配。因此启动流程中 .bss 清零必须发生在 vTaskStartScheduler() 之前，否则堆管理结构会包含随机值。RA 的启动文件已经保证这一点，但若手动修改链接脚本把堆放到未初始化区域，就需要自行确认。

移植层文件结构与关键配置

一个可运行的 RA FreeRTOS 工程通常包含以下文件。内核文件 tasks.c、queue.c、list.c、timers.c 与硬件无关；移植文件 port.c 和 portmacro.h 提供 Cortex-M 相关的汇编入口和宏；FreeRTOSConfig.h 是工程级配置，决定节拍频率、最大优先级数、堆大小和 API 裁剪。以 RA6M5 为例，一份可用的配置片段如下：

#define configTICK_RATE_HZ              (1000)
#define configMAX_PRIORITIES            (8)
#define configTOTAL_HEAP_SIZE           (32 * 1024)
#define configMAX_SYSCALL_INTERRUPT_PRIORITY  (5)
#define configKERNEL_INTERRUPT_PRIORITY       (15)
#define configUSE_PREEMPTION            (1)
#define configUSE_IDLE_HOOK             (0)
#define configUSE_TICK_HOOK             (0)

其中 configKERNEL_INTERRUPT_PRIORITY 必须设为最低优先级（数值最大），因为 PendSV 和 SysTick 都使用它。若把它设得比某个外设中断还高，PendSV 就可能在外设 ISR 执行期间被触发，导致上下文切换发生在不安全的时刻。

启动顺序与首次任务切换

完整的启动顺序是：复位 → Reset_Handler → SystemInit()（配置时钟和向量表偏移）→ main() → 调用 xTaskCreate() 创建至少一个任务 → 调用 vTaskStartScheduler()。调度器内部会创建空闲任务，初始化 SysTick，然后执行 SVC 0 指令。SVC 异常处理程序 vPortSVCHandler 从就绪列表中取出最高优先级任务，把它的栈指针写入 PSP，切换到线程模式并跳转到任务入口。从这一刻起，任务开始运行，SysTick 每 1 ms 触发一次 xTaskIncrementTick()，必要时置位 PendSV 触发任务切换。