[RISC-V] FreeRTOS移植实战：从零搭建工程目录与源码裁剪-洪萨配资

1. 为什么需要从零搭建FreeRTOS工程目录？

第一次接触FreeRTOS源码的朋友可能会被它庞大的文件结构吓到——官方源码包解压后足足有几十MB，包含Demo、Test、Plus等多个看似重要的文件夹。但实际移植到RISC-V平台（比如Andes N25）时，你会发现90%的内容都用不上。

我在去年移植到N25核心时就犯过"全盘复制"的错误：直接把整个FreeRTOS文件夹扔进工程，结果编译时遇到各种路径冲突，最后生成的固件比实际需求大了300KB。后来通过逐步裁剪，最终只保留了不到20个关键文件，系统运行效率反而更高。

合理的目录结构应该像搭积木——只选择必要的模块。比如：

核心调度器（在Source文件夹）
RISC-V专用移植层（portable/GCC/RISC-V）
内存管理方案（portable/MemMang）
应用层代码（自定义App文件夹）

这种结构不仅编译更快，后续升级FreeRTOS版本时也只需替换对应模块，不会影响其他代码。下面我会用实际案例展示如何一步步搭建这个"积木城堡"。

2. 获取与初步筛选源码

2.1 下载官方源码包

目前FreeRTOS最新稳定版是V202212.01（截至2023年8月），官网提供两种下载方式：

打包下载：包含所有Demo和测试代码（约45MB）
最小化下载：仅核心源码（约2MB）

对于RISC-V移植，我推荐用完整包然后手动裁剪：

wget https://downloads.freertos.org/v10.5.1/FreeRTOSv10.5.1.zip unzip FreeRTOSv10.5.1.zip -d riscv_freertos

解压后你会看到这些关键内容：

FreeRTOS/ ├── Demo/ # 各平台示例项目（可删除） ├── License/ # 许可证文件（保留） ├── Source/ # 核心源码（重点保留） │ ├── include/ # 头文件 │ ├── portable/ # 平台相关代码 │ └── tasks.c # 任务调度器等核心 └── Test/ # 验证代码（可删除）

2.2 第一轮"瘦身"手术

先删除明显不需要的部分：

Demo文件夹：里面的RISC-V示例（如RV32M1_Vega）通常过于复杂，且与具体开发板强相关
Test文件夹：功能测试代码对移植无帮助
Plus文件夹：TCP/IP栈等高级功能初期用不到

保留的目录应该精简到这样：

FreeRTOS/ ├── License/ └── Source/ ├── include/ ├── portable/ └── 核心C文件（tasks.c等）

3. 深度裁剪与目录重构

3.1 处理portable文件夹

portable目录是移植的关键，但里面包含几十种编译器/芯片的支持代码。对于RISC-V平台：

保留GCC/RISC-V：这是针对RISC-V架构的移植层
- port.c：处理器特定实现（如上下文切换）
- portasm.S：汇编级优化
选择内存管理方案：MemMang下有5种heap实现
- heap_4.c：最推荐，支持内存碎片合并
删除其他无关平台：如ARM_CM4、IAR等

操作示例：

cd FreeRTOS/Source/portable rm -rf GCC/ARM_CM3 IAR/ MemMang/heap_1.c # 删除其他平台

3.2 建立应用层目录

新建App目录存放用户代码，建议结构：

App/ ├── FreeRTOSConfig.h # 系统配置（如任务栈大小） ├── main.c # 用户任务入口 └── BSP/ # 板级支持包 ├── riscv_hal.c # 硬件抽象层 └── led.c # 外设驱动

关键配置示例（FreeRTOSConfig.h片段）：

#define configUSE_PREEMPTION 1 // 启用抢占式调度 #define configCPU_CLOCK_HZ 50000000 // Andes N25主频 #define configTICK_RATE_HZ 1000 // 系统节拍1kHz

4. 链接脚本与启动文件适配

4.1 修改链接脚本

RISC-V芯片的链接脚本需要明确FreeRTOS堆栈位置。以常见的riscv32-unknown-elf-ld为例：

MEMORY { FLASH (rx) : ORIGIN = 0x20000000, LENGTH = 256K RAM (rwx) : ORIGIN = 0x80000000, LENGTH = 64K } /* 在SECTIONS中添加FreeRTOS堆 */ ._freertos_heap (NOLOAD) : { . = ALIGN(8); _sheap = .; . = . + 20K; /* 保留20KB给FreeRTOS */ _eheap = .; } > RAM

4.2 启动文件调整

在RISC-V的start.S中需要：

初始化FreeRTOS所需的时钟中断（MTIME）
设置PendSV和SysTick中断优先级
指向prvPortStartFirstTask作为复位后的第一个C函数

关键汇编代码：

.section .text .global _start _start: /* 设置mtvec为中断向量表 */ la t0, freertos_vector_table csrw mtvec, t0 /* 跳转到FreeRTOS启动函数 */ call prvPortStartFirstTask

5. 验证与调试技巧

完成目录搭建后，可以用最小测试程序验证：

// main.c #include "FreeRTOS.h" #include "task.h" void blink_task(void *pv) { while(1) { LED_TOGGLE(); vTaskDelay(500/portTICK_PERIOD_MS); } } int main() { xTaskCreate(blink_task, "blink", 128, NULL, 1, NULL); vTaskStartScheduler(); while(1); }

调试时重点关注：