一、移植环境
系统：WIN7
MDK：keil v5.26
开发板：GD32F303C-EVAL
固件库：V1.0.2
FreeRTOS版本：V10.4.0
二、复制FreeRTOS到工程文件中
1> FreeRTOS简要介绍
FreeRTSO下载链接：https://www.freertos.org/a00104.html
将下载的文件解压，内容如下：FreeRTOS就是我们需要移植用到的，里面包含了官方移植的demo和内核文件，FreeRTOS-Plus里面包含了一些第三方的组件。
FreeRTOS文件夹内容如下：Demo文件夹下是官方在开发板移植好的demo，可以参考，Source文件夹下就是我们需要移植的内核文件。
Source文件夹内容如下：
2> 在准备好的工程下创建一个FreeRTOS文件夹下，将1>提到的Source文件中所有的内容复制到这个文件夹下：
删除上图中红框中的内容,如下：
在当前目录下新建一个文件夹src，将红框中的内容剪切到src文件夹下，如下图：
进入到portable文件夹下，只保留下图三个文件夹，其余全部删除，如下图：
其中keil文件夹下没有可以用的内容，MemMang下是官方给的5种内存管理的方法，没有好坏之分，都有优缺点，根据需要选一种方式即可。
三、添加FreeRTOS文件到工程
1> 添加src下的文件到工程
2> 添加portable/MemMang/heap_4文件到工程
3> 添加portable/RVDS/ARM_CM4F/port文件到工程，因为GD32F303内核是Cortex-M4F内核。
4> 添加相应的头文件路径
5>编译一下，提示如下错误
缺少FreeRTOSConfig.h这个头文件，我们在FreeRTOS源码中复制一个将这个路径下的（FreeRTOS\FreeRTOS\Demo\CORTEX_STM32F103_Keil）FreeRTOSConfig.h文件复制到工程中，并且添加到工程中，如下图：
6>再次编译，提示如下错误：
其实就是缺少一个宏定义，这里可以在FreeRTOSConfig.h中定义一个
再次编译发现没有错误了。
7>写一个简单的LED任务测试一下，如下图：
#include "gd32f30x.h"
#include "led.h"
#include "systick.h"
#include <stdio.h>
#include "FreeRTOS.h"
#include "task.h"
#define LED1_TASK_PRIO ( tskIDLE_PRIORITY + 2 )
void LED1_task(void * pvParameters);
int main(void)
{
/* 设置优先级分组为4,16个优先级全是抢占优先级 */
nvic_priority_group_set(NVIC_PRIGROUP_PRE4_SUB0);
GW_LedInit(LED1);
GW_LedInit(LED2);
xTaskCreate(LED1_task, "LED1", configMINIMAL_STACK_SIZE, NULL, LED1_TASK_PRIO, NULL);
/* start scheduler */
vTaskStartScheduler();
while(1){
}
}
void LED1_task(void * pvParameters)
{
for( ;; ){
/* toggle LED2 each 500ms */
GW_LedToggle(LED1);
vTaskDelay(300);
}
}
下载到开发板，发现并没有LED运行，仿真调试发现，MCU进入了硬件中断，如下图：
这里我们仔细看一下，FreeRTOSConfig.h这个文件的配置，源码如下：
#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H
/*-----------------------------------------------------------
* Application specific definitions.
*
* These definitions should be adjusted for your particular hardware and
* application requirements.
*
* THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
* FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
*
* See http://www.freertos.org/a00110.html
*----------------------------------------------------------*/
#define configUSE_PREEMPTION 1
#define configUSE_IDLE_HOOK 0
#define configUSE_TICK_HOOK 0
#define configCPU_CLOCK_HZ ( ( unsigned long ) 72000000 )
#define configTICK_RATE_HZ ( ( TickType_t ) 1000 )
#define configMAX_PRIORITIES ( 5 )
#define configMINIMAL_STACK_SIZE ( ( unsigned short ) 128 )
#define configTOTAL_HEAP_SIZE ( ( size_t ) ( 17 * 1024 ) )
#define configMAX_TASK_NAME_LEN ( 16 )
#define configUSE_TRACE_FACILITY 0
#define configUSE_16_BIT_TICKS 0
#define configIDLE_SHOULD_YIELD 1
由上面代码可以看出，这里系统时钟是需要更改的，configCPU_CLOCK_HZ这个是系统时钟，GD32F303是120Mhz的主频；configTOTAL_HEAP_SIZE设置堆得大小，这里设置了17KB的大小，而在启动代码里，堆设置了1KB，栈的大小也是设置的1KB，***注意：这三者的总和不能超过MCU自身的RAM大小。***如下图：
这里，我们将启动文件里的堆改成0x00000200(0.5KB)，configTOTAL_HEAP_SIZE也更改成20KB，更改如下：
#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H
#include "gd32f30x.h"
/*-----------------------------------------------------------
* Application specific definitions.
*
* These definitions should be adjusted for your particular hardware and
* application requirements.
*
* THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
* FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
*
* See http://www.freertos.org/a00110.html
*----------------------------------------------------------*/
extern uint32_t SystemCoreClock;
#define configUSE_PREEMPTION 1
#define configUSE_IDLE_HOOK 0
#define configUSE_TICK_HOOK 0
#define configCPU_CLOCK_HZ ( ( unsigned long ) SystemCoreClock )
#define configTICK_RATE_HZ ( ( TickType_t ) 1000 )
#define configMAX_PRIORITIES ( 5 )
#define configMINIMAL_STACK_SIZE ( ( unsigned short ) 128 )
#define configTOTAL_HEAP_SIZE ( ( size_t ) ( 20 * 1024 ) )
#define configMAX_TASK_NAME_LEN ( 16 )
#define configUSE_TRACE_FACILITY 0
#define configUSE_16_BIT_TICKS 0
#define configIDLE_SHOULD_YIELD 1
接下来编译进行下载，发现依旧会进入硬件中断，这就可能让人很崩溃了，这里需要了解一下FreeRTOS在Cortex内核中如何实现任务切换的机制，这里可以参考SVC & PendSV这篇博客，总的来说，既然想实现任务切换，就需要重新写这两个函数，之后在查看一下内核文件port.c，发现这里已经帮我们写好了，那就简单了，我们将gd32f30x_it.c文件里这两个中断函数给删掉，如下：
这里再次进行仿真下载调试，本以为可以万事大吉了，却还是被显示狠狠打脸了，仿真发现，程序死在了下面的循环中：
如上图，程序死在了SVC_Handler中断这，而我们上一步是把这个函数给删了，因为在上一步操作时，我们分析，内核文件port.c中帮我们重新写了这个函数，我们找到这个对应的函数如下：
呵呵，这就尴尬了，官方写的这个函数名称和启动文件中的中断入口函数名称不一致，既然如此，只能让这两个函数名联系到一起才行，我们在FreeRTOS.h中添加如下代码：
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler
这下总应该可以了吧，下载编译，发现灯点亮了，心里那个开心啊，可是下一秒哭的心都有了，创建的任务是灯闪烁，现在灯只是点亮了并没有闪烁。仿真调试，发现如下：
看到这个现象，心情放松了一下，和之前现象类似，那我们接着去port.c文件去找一下，果真被我找到了：如下：
那仿照之前的操作，在FreeRTOSConfig.h中添加：
#define xPortSysTickHandler SysTick_Handler
LED终于亮了，至此，FreeRTOS最基本的移植完成。
工程下载链接：GD32F303_FreeRTOS10400