1. 课程导入与开发环境搭建
欢迎进入《Renesas RA FreeRTOS系统工程》课程。本章的目标不是立刻写出复杂的多任务程序，而是先把“跑起来”这件事做扎实：认识RA MCU产品线的定位，理解FreeRTOS在RA生态中的角色，安装e² studio与FSP，并创建第一个能点亮LED的RA FreeRTOS工程。只要这条链路打通，后续的任务调度、队列、信号量、事件组等内容才有可靠的落脚点。
1.1 RA MCU产品线概览
RA是Renesas基于Arm Cortex-M内核的通用MCU家族，按性能与资源大致分为入门、主流、高性能几个层级。入门级如RA2系列，常见Cortex-M23内核，主频多在48MHz左右，适合成本敏感、控制逻辑简单的场景；主流级RA4系列多采用Cortex-M4或M33，主频可达100MHz以上，带FPU、DMA、丰富串口与定时器，是学习FreeRTOS最合适的起点；高性能RA6系列则面向Cortex-M33/M85，主频可达200MHz甚至更高，带TFT控制器、以太网、USB高速等外设，适合图形界面、工业网关等应用；RA8系列基于Cortex-M85，面向更高算力与AI边缘场景。
对初学者而言，选择RA4M1或RA4M2这类主流型号最稳妥：资料多、FSP支持完善、开发板价格适中。需要特别关注几个与FreeRTOS直接相关的资源：SRAM容量决定能创建多少任务与队列；SysTick与NVIC决定系统节拍和中断优先级；DMA与DTC影响数据搬运效率；SCI/UART用于打印调试信息。这些参数在选型时就要有意识地和后续RTOS配置对应起来。
1.2 FreeRTOS在RA生态中的定位
FreeRTOS是一个轻量级实时内核，提供任务调度、队列、信号量、互斥量、事件组、软件定时器、任务通知等机制。在RA生态中，它并不是“外挂”的第三方库，而是通过FSP（Flexible Software Package）以中间件形式集成：FSP提供HAL驱动、BSP、RTOS适配层，FreeRTOS作为可选RTOS被纳入FSP的组件体系。这意味着你可以在FSP配置器中直接勾选FreeRTOS，由工具生成初始化代码、任务创建框架和中断优先级配置，而不必手工移植内核。
这种集成带来两个关键好处：一是中断与RTOS的优先级管理由FSP统一协调，减少“中断里调用非FromISR API”这类常见错误；二是外设驱动与RTOS对象可以一起配置，例如用队列在UART中断与任务之间传递数据。理解“FSP是底座、FreeRTOS是调度核心、HAL是外设接口”这三层关系，是后续工程组织的基础。
1.3 e² studio与FSP安装
开发环境由两部分组成：e² studio是IDE，负责编辑、编译、调试；FSP是软件包，提供驱动、中间件和配置器。推荐从Renesas官网下载“e² studio installer”，安装时勾选对应RA系列的FSP版本。安装路径不要含中文和空格，避免编译工具链路径解析异常。安装完成后首次启动，选择工作空间目录，建议单独建一个英文路径，例如D:\RA_Workspace。
安装过程中会一并部署GCC Arm Embedded工具链、J-Link/ E2 Lite调试驱动以及FSP的代码生成器。若使用EK-RA4M2或RA4M1开发板，板载调试器通常是J-Link OB或E2 Lite，驱动会自动识别。安装完成后可在e² studio的“Renesas View”中确认FSP版本，例如FSP 5.3.0对应FreeRTOS 10.4.x内核，版本匹配能避免API差异带来的编译问题。
1.4 创建第一个RA FreeRTOS工程并点亮LED
下面以EK-RA4M2为例，走一遍完整流程。打开e² studio，选择File → New → Renesas C/C++ Project → Renesas RA，在器件选择页选中R7FA4M2AD3CFP（根据实际板卡型号选择），工程名设为RA_FreeRTOS_LED，工具链选GCC Arm Embedded，RTOS选项选择FreeRTOS。点击Finish后，FSP配置器会自动打开。
在FSP配置器的“Stacks”页添加两个模块：一是FreeRTOS内核，二是GPIO驱动。GPIO配置中，选择板载用户LED对应的引脚，例如P405，模式设为Output，初始电平Low。接着在“Threads”页新建一个任务，名称led_task，优先级设为1（数值越大优先级越高），栈大小设为512字，入口函数填led_task_entry。FSP会据此生成任务创建代码和调度器启动代码。
在生成的led_task_entry函数中写入闪烁逻辑。注意FreeRTOS中延时必须使用vTaskDelay，不能用裸机死循环延时，否则会阻塞调度器。示例代码如下：
void led_task_entry(void *pvParameters)
{
FSP_PARAMETER_NOT_USED(pvParameters);
while (1)
{
R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05, BSP_IO_LEVEL_HIGH);
vTaskDelay(pdMS_TO_TICKS(500));
R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05, BSP_IO_LEVEL_LOW);
vTaskDelay(pdMS_TO_TICKS(500));
}
}编译前检查“Build Configuration”是否为Debug，点击Build。若出现undefined reference to vTaskDelay，说明FreeRTOS组件未正确加入，回到FSP配置器确认Stacks中FreeRTOS已启用并重新生成代码。编译通过后连接开发板，选择调试配置为J-Link或E2 Lite，点击Debug。程序下载后应看到LED以约1Hz频率闪烁，占空比接近50%。
如何判断“真正跑在FreeRTOS上”而不是裸机延时？可以在任务中翻转另一个GPIO，或用调试器查看uxTaskGetNumberOfTasks()返回值是否为1以上，也可以在FSP配置器中确认configUSE_PREEMPTION为1。若LED闪烁但周期明显偏长，检查configTICK_RATE_HZ是否被设为1000，以及pdMS_TO_TICKS换算是否正确。