第5章 FreeRTOS操作系统移植（MDK版）

席萌0209

第5章       FreeRTOS操作系统移植（MDK版）

      本章教程将为大家介绍基于MDK的FreeRTOS操作系统移植。移植工作比较简单，只需要用户添加需要的源码文件，不需要做任何的底层工作，再添加三个宏定义即可。
      本章教程含Cortex-M3内核的STM32F103的移植和Cortex-M4内核的STM32F407以及F429的移植。
    5.1 移植前准备工作说明
    5.2 STM32F103移植FreeRTOS系统
    5.3 STM32F407移植FreeRTOS系统
    5.4 STM32F429移植FreeRTOS系统
    5.5         总结



5.1  移植前准备工作说明

1.     本章节的IDE开发环境使用MDK，用MDK4.7X或者MDK5.XX均可，保证支持STM32F103，F407和F429即可（不可以使用MDK4.7X以下版本，一方面是不支持F429，另外就是FreeRTOS V8.2.3要用到C代码中嵌套汇编代码，MDK4.7X以下版本是不支持的）。
2.     找一个简单的工程，最好是跑马灯之类的，越简单越好，我们就在这个简单的工程上面移植即可。
3.     大家使用的简单工程里面不能有SysTick，PendSV和SVC三个系统中断的使用，因为FreeRTOS系统要使用这三个中断。

席萌0209

5.2   STM32F103移植FreeRTOS系统

5.2.1      FreeRTOS操作系统移植

    首先准备好一个简单的裸机工程模板，工程模板的制作就不做讲解了，这里的重点是教大家移植FreeRTOS系统。准备好的工程模板如下图5.1所示（大家也可以制作其它任意的工程模板，不限制）：

图5.1 工程模板

    准备好工程模板后，就可以开始移植了。首先要做的就是将所有需要的源码文件放到工程模板里面。下面分六步和大家进行说明，当然，不限制必须使用下面的方法添加源码到工程，只要将需要的文件添加到工程模板即可。
第1步：从网址https://sourceforge.net/projects/freertos/files/FreeRTOS/V8.2.3/ 下载V8.2.3版本，这个是8.X系列里面最高版本了，9.0版本还处于测试阶段，我们暂不使用。

FreeRTOSV8.2.3.zip和FreeRTOSV8.2.3.exe内容是一样的，只是后缀为exe的压缩率更高些。下载后解压出来。

第2步：在工程模板创建FreeRTOS文件夹

第3步：添加源码文件到相应文件夹
（1）将FreeRTOSV8.2.3软件包中路径：FreeRTOSV8.2.3\\FreeRTOS\\Source里面如下所有文件

   

复制到刚刚创建的FreeRTOS文件夹下。
（2）文件夹User中还需要添加如下文件：

文件FreeRTOSConfig.h文件在FreeRTOSV8.2.3软件包中的中的路径：FreeRTOSV8.2.3\\FreeRTOS\\Demo\\CORTEX_STM32F103_Keil，其实就是官方整理好的配置文件。
（3）：将源码文件添加到MDK的工程项目中，添加后的效果如下：

    其中heap_4.c文件路径： FreeRTOS\\Source\\portable\\MemMang
    port.c和portmacro.h文件的路径：FreeRTOS\\Source\\portable\\RVDS\\ARM_CM3，由于STM32F103是M3内核的，所以移植文件也要添加M3内核的。


第4步：新创建一个includes.h文件，将所有的头文件都集中到这个头文件下。
    这样做的好处是引用头文件的时候，只添加这个头文件就可以了。includes.h文件放在了User文件夹中。然后再将这个文件也添加到MDK工程项目中(将.h文件添加到工程的好处是方便查看和修改)

    Includes.h文件中的内容如下：

1. /*
2. *********************************************************************************************************
3. *
4. *    模块名称 : 头文件汇总
5. *    文件名称 : includes.h
6. *    版    本 : V1.0
7. *    说    明 : 当前使用头文件汇总
8. *
9. *    修改记录 :
10. *        版本号    日期        作者     说明
11. *        V1.0    2015-08-02  Eric2013   首次发布
12. *
13. *    Copyright (C), 2015-2020, 安富莱电子 www.armfly.com
14. *
15. *********************************************************************************************************
16. */
18. #ifndef  __INCLUDES_H__
19. #define  __INCLUDES_H__
21. /*
22. *********************************************************************************************************
23. *                                         标准库
24. *********************************************************************************************************
25. */
26. #include  <stdarg.h>
27. #include  <stdio.h>
28. #include  <stdlib.h>
29. #include  <math.h>
32. /*
33. *********************************************************************************************************
34. *                                         其它库
35. *********************************************************************************************************
36. */
39. /*
40. *********************************************************************************************************
41. *                                           OS
42. *********************************************************************************************************
43. */
44. #include "FreeRTOS.h"
45. #include "task.h"
46. #include "queue.h"
47. #include "croutine.h"
50. /*
51. *********************************************************************************************************
52. *                                           宏定义
53. *********************************************************************************************************
54. */
57. /*
58. *********************************************************************************************************
59. *                                        APP / BSP
60. *********************************************************************************************************
61. */
63. #include  <bsp.h>
66. #endif
68. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

第5步：添加相应的头文件路径，在原来工程模板的基础上新添加的两个路径：

第6步：最后一步，同时也是最重要的一步，修改FreeRTOSConfig.h配置文件（用户根据自己的配置进行修改，不修改也是没问题的，我们这里进行修改主要是为了方便初学者学习），主要修改了以下两个方面：
    （1）添加宏定义__NVIC_PRIO_BITS，STM32系列产品优先级仅使用4位。
    （2）修改优先级相关的几个宏定义，具体修改了哪个可以对比原始文件查看。
    修改后在这个文件的末尾加上Systick，PendSV和SVC中断函数的宏定义，目的是将FreeRTOS移植文件port.c文件里面的中断服务程序映射到CMSIS定义的标准名称，这样就不需要用户去修改工程启动代码中这几个中断的名字了，很方便就实现了两个函数的统一。（移植过uCOS-II或者III的用户，对于这个问题估计深有体会，因为uCOS要修改启动文件，其实采用这里的方式更方便）

1. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
2. standard names. */
3. #define vPortSVCHandler     SVC_Handler
4. #define xPortPendSVHandler  PendSV_Handler
5. #define xPortSysTickHandler SysTick_Handler

复制代码

其中vPortSVCHandler，xPortPendSVHandler和xPortSysTickHandler是在port.c文件里面定义的。SVC_Handler，PendSV_Handler和SysTick_Handler在startup_stm32f10x_hd.s文件里面进行了定义。
下面是FreeRTOSConfig.h配置文件的完整内容：

1. #ifndef FREERTOS_CONFIG_H
2. #define FREERTOS_CONFIG_H
4. /*-----------------------------------------------------------
5. * Application specific definitions.
6. *
7. * These definitions should be adjusted for your particular hardware and
8. * application requirements.
9. *
10. * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
11. * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
12. *
13. * See http://www.freertos.org/a00110.html.
14. *----------------------------------------------------------*/
16. #define configUSE_PREEMPTION         1
17. #define configUSE_IDLE_HOOK          0
18. #define configUSE_TICK_HOOK          0
19. #define configCPU_CLOCK_HZ           ( ( unsigned long ) 72000000 )  
20. #define configTICK_RATE_HZ           ( ( TickType_t ) 1000 )
21. #define configMAX_PRIORITIES         ( 5 )
22. #define configMINIMAL_STACK_SIZE      ( ( unsigned short ) 128 )
23. #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 17 * 1024 ) )
24. #define configMAX_TASK_NAME_LEN      ( 16 )
25. #define configUSE_TRACE_FACILITY      0
26. #define configUSE_16_BIT_TICKS       0
27. #define configIDLE_SHOULD_YIELD      1
29. /* Co-routine definitions. */
30. #define configUSE_CO_ROUTINES            0
31. #define configMAX_CO_ROUTINE_PRIORITIES ( 2 )
33. /* Set the following definitions to 1 to include the API function, or zero
34. to exclude the API function. */
36. #define INCLUDE_vTaskPrioritySet          1
37. #define INCLUDE_uxTaskPriorityGet         1
38. #define INCLUDE_vTaskDelete               1
39. #define INCLUDE_vTaskCleanUpResources      0
40. #define INCLUDE_vTaskSuspend              1
41. #define INCLUDE_vTaskDelayUntil           1
42. #define INCLUDE_vTaskDelay                1
44. /* Cortex-M specific definitions. */
45. #ifdef __NVIC_PRIO_BITS
46.      /* __BVIC_PRIO_BITS will be specified when CMSIS is being used. */
47.      #define configPRIO_BITS              __NVIC_PRIO_BITS
48. #else
49.      #define configPRIO_BITS              4        /* 15 priority levels */
50. #endif
52. /* The lowest interrupt priority that can be used in a call to a "set priority"
53. function. */
54. #define configLIBRARY_LOWEST_INTERRUPT_PRIORITY       0x0f
56. /* The highest interrupt priority that can be used by any interrupt service
57. routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
58. INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
59. PRIORITY THAN THIS! (higher priorities are lower numeric values. */
60. #define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY    0x01
62. /* Interrupt priorities used by the kernel port layer itself.  These are generic
63. to all Cortex-M ports, and do not rely on any particular library functions. */
64. #define configKERNEL_INTERRUPT_PRIORITY        ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
65. /* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
66. See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
67. #define configMAX_SYSCALL_INTERRUPT_PRIORITY   ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
68.    
69. /* Normal assert() semantics without relying on the provision of an assert.h
70. header file. */
71. #define configASSERT( x ) if( ( x ) == 0 ) { taskDISABLE_INTERRUPTS(); for( ;; ); }
72.    
73. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
74. standard names. */
75. #define vPortSVCHandler SVC_Handler
76. #define xPortPendSVHandler PendSV_Handler
77. #define xPortSysTickHandler SysTick_Handler
80. #endif /* FREERTOS_CONFIG_H */

复制代码

    至此，FreeRTOS的移植工作就完成了，剩下就是系统配置和应用了。其中系统配置，会在第7章专门进行讲解。

5.2.2     FreeRTOS操作系统应用实例

    FreeRTOSConfig.h配置文件里面几个重要选项说明：
1、#define configUSE_PREEMPTION        1
    使能抢占式调度器
2、#define configCPU_CLOCK_HZ      ( ( unsigned long ) 72000000 )   
    系统主频72MHz。
3、#define configTICK_RATE_HZ              ( ( TickType_t ) 1000 )
    系统时钟节拍1KHz，即1ms。
4、#define configMAX_PRIORITIES          ( 5 )
       定义可供用户使用的最大优先级数，如果这个定义的是5，那么用户可以使用的优先级号是0,1,2,3,4，不包含5，对于这一点，初学者要特别的注意。
5、#define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 17 * 1024 ) )
    定义堆大小，FreeRTOS内核，用户动态内存申请，任务栈等都需要用这个空间。
---------------------------------------------------------------------------------------------------
      经过上面的移植和配置之后，在main.c文件中添加如下代码，代码中简单地创建了四个用户任务：
vTaskTaskUserIF任务：接口消息处理，这里用作LED闪烁。
AppTaskLED任务    ：LED闪烁。
vTaskMsgPro 任务  ：消息处理，这里用作LED闪烁。
AppTaskStart任务  ：启动任务，也是最高优先级任务，这里实现LED闪烁。

1. #include "includes.h"
5. /*
6. **********************************************************************************************************
7.                                                    函数声明
8. **********************************************************************************************************
9. */
10. static void vTaskTaskUserIF(void *pvParameters);
11. static void vTaskLED(void *pvParameters);
12. static void vTaskMsgPro(void *pvParameters);
13. static void vTaskStart(void *pvParameters);
14. static void AppTaskCreate (void);
16. /*
17. **********************************************************************************************************
18.                                                    变量声明
19. **********************************************************************************************************
20. */
21. static TaskHandle_t xHandleTaskUserIF = NULL;
22. static TaskHandle_t xHandleTaskLED = NULL;
23. static TaskHandle_t xHandleTaskMsgPro = NULL;
24. static TaskHandle_t xHandleTaskStart = NULL;
26. /*
27. *********************************************************************************************************
28. *    函 数 名: main
29. *    功能说明: 标准c程序入口。
30. *    形    参: 无
31. *    返 回 值: 无
32. *********************************************************************************************************
33. */
34. int main(void)
35. {
36.      /*
37.        在启动调度前，为了防止初始化STM32外设时有中断服务程序执行，这里禁止全局中断(除了NMI和HardFault)。
38.        这样做的好处是：
39.        1. 防止执行的中断服务程序中有FreeRTOS的API函数。
40.        2. 保证系统正常启动，不受别的中断影响。
41.        3. 关于是否关闭全局中断，大家根据自己的实际情况设置即可。
42.        在移植文件port.c中的函数prvStartFirstTask中会重新开启全局中断。通过指令cpsie i开启，__set_PRIMASK(1)
43.        和cpsie i是等效的。
44.      */
45.      __set_PRIMASK(1);
46.    
47.      /* 硬件初始化 */
48.      bsp_Init();
49.    
50.      /* 创建任务 */
51.      AppTaskCreate();
52.    
53.     /* 启动调度，开始执行任务 */
54.     vTaskStartScheduler();
56.      /*
57.        如果系统正常启动是不会运行到这里的，运行到这里极有可能是用于定时器任务或者空闲任务的
58.        heap空间不足造成创建失败，此要加大FreeRTOSConfig.h文件中定义的heap大小：
59.        #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 17 * 1024 ) )
60.      */
61.      while(1);
62. }
64. /*
65. *********************************************************************************************************
66. *    函 数 名: vTaskTaskUserIF
67. *    功能说明: 接口消息处理，这里用作LED闪烁
68. *    形    参: pvParameters 是在创建该任务时传递的形参
69. *    返 回 值: 无
70. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
71. *********************************************************************************************************
72. */
73. static void vTaskTaskUserIF(void *pvParameters)
74. {
75.     while(1)
76.     {
77.          bsp_LedToggle(1);
78.          vTaskDelay(100);
79.      }
80. }
82. /*
83. *********************************************************************************************************
84. *    函 数 名: vTaskLED
85. *    功能说明: LED闪烁
86. *    形    参: pvParameters 是在创建该任务时传递的形参
87. *    返 回 值: 无
88. *   优 先 级: 2
89. *********************************************************************************************************
90. */
91. static void vTaskLED(void *pvParameters)
92. {
93.     while(1)
94.     {
95.          bsp_LedToggle(2);
96.         vTaskDelay(200);
97.     }
98. }
100. /*
101. *********************************************************************************************************
102. *    函 数 名: vTaskMsgPro
103. *    功能说明: 信息处理，这里是用作LED闪烁   
104. *    形    参: pvParameters 是在创建该任务时传递的形参
105. *    返 回 值: 无
106. *   优 先 级: 3
107. *********************************************************************************************************
108. */
109. static void vTaskMsgPro(void *pvParameters)
110. {
111.     while(1)
112.     {
113.          bsp_LedToggle(3);
114.         vTaskDelay(300);
115.     }
116. }
118. /*
119. *********************************************************************************************************
120. *    函 数 名: vTaskStart
121. *    功能说明: 启动任务，也就是最高优先级任务，这里用作LED闪烁
122. *    形    参: pvParameters 是在创建该任务时传递的形参
123. *    返 回 值: 无
124. *   优 先 级: 4
125. *********************************************************************************************************
126. */
127. static void vTaskStart(void *pvParameters)
128. {
129.     while(1)
130.     {
131.          /* LED闪烁 */
132.          bsp_LedToggle(4);
133.         vTaskDelay(400);
134.     }
135. }
137. /*
138. *********************************************************************************************************
139. *    函 数 名: AppTaskCreate
140. *    功能说明: 创建应用任务
141. *    形    参: 无
142. *    返 回 值: 无
143. *********************************************************************************************************
144. */
145. static void AppTaskCreate (void)
146. {
147.     xTaskCreate( vTaskTaskUserIF,   /* 任务函数  */
148.                  "vTaskUserIF",     /* 任务名    */
149.                  512,               /* 任务栈大小，单位word，也就是4字节 */
150.                  NULL,              /* 任务参数  */
151.                  1,                 /* 任务优先级*/
152.                  &xHandleTaskUserIF );  /* 任务句柄  */
153.    
154.    
155.      xTaskCreate( vTaskLED,           /* 任务函数  */
156.                  "vTaskLED",         /* 任务名    */
157.                  512,                /* 任务栈大小，单位word，也就是4字节 */
158.                  NULL,               /* 任务参数  */
159.                  2,                  /* 任务优先级*/
160.                  &xHandleTaskLED ); /* 任务句柄  */
161.    
162.      xTaskCreate( vTaskMsgPro,            /* 任务函数  */
163.                  "vTaskMsgPro",           /* 任务名    */
164.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
165.                  NULL,                    /* 任务参数  */
166.                  3,                       /* 任务优先级*/
167.                  &xHandleTaskMsgPro );  /* 任务句柄  */
168.    
169.    
170.      xTaskCreate( vTaskStart,             /* 任务函数  */
171.                  "vTaskStart",            /* 任务名    */
172.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
173.                  NULL,                    /* 任务参数  */
174.                  4,                       /* 任务优先级*/
175.                  &xHandleTaskStart );   /* 任务句柄  */
176. }
177. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

除了创建的4个用户任务以外，还有空闲任务，这个任务是系统创建的。至此，FreeRTOS的工程就可以运行了，可以看到4个LED在闪烁。

席萌0209

5.3  STM32F407移植FreeRTOS系统


5.3.1     FreeRTOS操作系统移植

    首先准备好一个简单的裸机工程模板，工程模板的制作就不做讲解了，这里的重点是教大家移植FreeRTOS系统。准备好的工程模板如下图5.2所示（大家也可以制作其它任意的工程模板，不限制）：

图5.2 工程模板

    准备好工程模板后，就可以开始移植了。首先要做的就是将所有需要的源码文件放到工程模板里面。下面分六步为大家进行说明，当然，不限制必须使用下面的方法添加源码到工程，只要将需要的文件添加到工程模板即可。
第1步：从网址https://sourceforge.net/projects/freertos/files/FreeRTOS/V8.2.3/ 下载V8.2.3版本，这个是8.X系列里面最高版本了，9.0版本还处于测试阶段，我们暂不使用。

FreeRTOSV8.2.3.zip和FreeRTOSV8.2.3.exe内容是一样的，只是后缀为exe的压缩率更高些。下载后解压出来。

第2步：在工程模板创建FreeRTOS文件夹

第3步：添加源码文件到相应文件夹
（1）将FreeRTOSV8.2.3软件包中路径：FreeRTOSV8.2.3\\FreeRTOS\\Source里面如下所有文件

    复制到刚刚创建的FreeRTOS文件夹下。
（2）文件夹User中还需要添加如下文件：

    文件FreeRTOSConfig.h文件在FreeRTOSV8.2.3软件包中的中的路径：FreeRTOSV8.2.3\\FreeRTOS\\Demo\\CORTEX_M4F_STM32F407ZG-SK，其实就是官方整理好的配置文件。
第3步：将源码文件添加到MDK的工程项目中，添加后的效果如下：

    其中heap_4.c文件路径：FreeRTOS\\Source\\portable\\MemMang
    port.c和portmacro.h文件的路径：FreeRTOS\\ Source\\portable\\RVDS\\ARM_CM4F，由于STM32F407是M4内核的，所以移植文件也要添加M4内核的。
第4步：新创建一个includes.h文件，将所有的头文件都集中到这个头文件下。
    这样做的好处是引用头文件的时候，只添加这个头文件就可以了。includes.h文件放在了User文件夹中。然后再将这个文件也添加到MDK工程项目中(将.h文件添加到工程的好处是方便查看和修改)

    Includes.h文件中的内容如下：/*

1. /*
2. *********************************************************************************************************
3. *
4. *    模块名称 : 头文件汇总
5. *    文件名称 : includes.h
6. *    版    本 : V1.0
7. *    说    明 : 当前使用头文件汇总
8. *
9. *    修改记录 :
10. *        版本号    日期        作者     说明
11. *        V1.0    2015-08-02  Eric2013   首次发布
12. *
13. *    Copyright (C), 2015-2020, 安富莱电子 www.armfly.com
14. *
15. *********************************************************************************************************
16. */
18. #ifndef  __INCLUDES_H__
19. #define  __INCLUDES_H__
21. /*
22. *********************************************************************************************************
23. *                                         标准库
24. *********************************************************************************************************
25. */
26. #include  <stdarg.h>
27. #include  <stdio.h>
28. #include  <stdlib.h>
29. #include  <math.h>
32. /*
33. *********************************************************************************************************
34. *                                         其它库
35. *********************************************************************************************************
36. */
39. /*
40. *********************************************************************************************************
41. *                                           OS
42. *********************************************************************************************************
43. */
44. #include "FreeRTOS.h"
45. #include "task.h"
46. #include "queue.h"
47. #include "croutine.h"
50. /*
51. *********************************************************************************************************
52. *                                           宏定义
53. *********************************************************************************************************
54. */
57. /*
58. *********************************************************************************************************
59. *                                        APP / BSP
60. *********************************************************************************************************
61. */
63. #include  <bsp.h>
66. #endif
68. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

第5步：添加相应的头文件路径，在原来工程模板的基础上新添加的两个路径：

第6步：最后一步，同时也是最重要的一步，修改FreeRTOSConfig.h配置文件（用户根据自己的配置进行修改，不修改也是没问题的，我们这里进行修改主要是为了方便初学者学习），主要修改了以下两个方面：
    （1）添加宏定义__NVIC_PRIO_BITS，STM32系列产品优先级仅使用4位。
    （2）修改优先级相关的几个宏定义，具体修改了哪个可以对比原始文件查看。
    修改后在这个文件的末尾加上Systick，PendSV和SVC中断函数的宏定义，目的是将FreeRTOS移植文件port.c文件里面的中断服务程序映射到CMSIS定义的标准名称，这样就不需要用户去修改工程启动代码中这几个中断的名字了，很方便就实现了两个函数的统一。（移植过uCOS-II或者III的用户，对于这个问题估计深有体会，因为uCOS要修改启动文件，其实采用这里的方式更方便）

1. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
2. standard names. */
3. #define vPortSVCHandler     SVC_Handler
4. #define xPortPendSVHandler  PendSV_Handler
5. #define xPortSysTickHandler SysTick_Handler

复制代码

其中vPortSVCHandler，xPortPendSVHandler和xPortSysTickHandler是在port.c文件里面定义的。SVC_Handler，PendSV_Handler和SysTick_Handler在startup_stm32f10x_hd.s文件里面进行了定义。
下面是FreeRTOSConfig.h配置文件的完整内容：

1. #ifndef FREERTOS_CONFIG_H
2. #define FREERTOS_CONFIG_H
4. /*-----------------------------------------------------------
5. * Application specific definitions.
6. *
7. * These definitions should be adjusted for your particular hardware and
8. * application requirements.
9. *
10. * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
11. * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
12. *
13. * See http://www.freertos.org/a00110.html.
14. *----------------------------------------------------------*/
16. #define configUSE_PREEMPTION         1
17. #define configUSE_IDLE_HOOK          0
18. #define configUSE_TICK_HOOK          0
19. #define configCPU_CLOCK_HZ           ( ( unsigned long ) 168000000 )
20. #define configTICK_RATE_HZ           ( ( TickType_t ) 1000 )
21. #define configMAX_PRIORITIES         ( 5 )
22. #define configMINIMAL_STACK_SIZE      ( ( unsigned short ) 128 )
23. #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 30 * 1024 ) )
24. #define configMAX_TASK_NAME_LEN      ( 16 )
25. #define configUSE_TRACE_FACILITY      0
26. #define configUSE_16_BIT_TICKS       0
27. #define configIDLE_SHOULD_YIELD      1
29. /* Co-routine definitions. */
30. #define configUSE_CO_ROUTINES            0
31. #define configMAX_CO_ROUTINE_PRIORITIES ( 2 )
33. /* Set the following definitions to 1 to include the API function, or zero
34. to exclude the API function. */
36. #define INCLUDE_vTaskPrioritySet          1
37. #define INCLUDE_uxTaskPriorityGet         1
38. #define INCLUDE_vTaskDelete               1
39. #define INCLUDE_vTaskCleanUpResources      0
40. #define INCLUDE_vTaskSuspend              1
41. #define INCLUDE_vTaskDelayUntil           1
42. #define INCLUDE_vTaskDelay                1
44. /* Cortex-M specific definitions. */
45. #ifdef __NVIC_PRIO_BITS
46.      /* __BVIC_PRIO_BITS will be specified when CMSIS is being used. */
47.      #define configPRIO_BITS              __NVIC_PRIO_BITS
48. #else
49.      #define configPRIO_BITS              4        /* 15 priority levels */
50. #endif
52. /* The lowest interrupt priority that can be used in a call to a "set priority"
53. function. */
54. #define configLIBRARY_LOWEST_INTERRUPT_PRIORITY       0x0f
56. /* The highest interrupt priority that can be used by any interrupt service
57. routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
58. INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
59. PRIORITY THAN THIS! (higher priorities are lower numeric values. */
60. #define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY    0x01
62. /* Interrupt priorities used by the kernel port layer itself.  These are generic
63. to all Cortex-M ports, and do not rely on any particular library functions. */
64. #define configKERNEL_INTERRUPT_PRIORITY        ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
65. /* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
66. See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
67. #define configMAX_SYSCALL_INTERRUPT_PRIORITY   ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
68.    
69. /* Normal assert() semantics without relying on the provision of an assert.h
70. header file. */
71. #define configASSERT( x ) if( ( x ) == 0 ) { taskDISABLE_INTERRUPTS(); for( ;; ); }
72.    
73. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
74. standard names. */
75. #define vPortSVCHandler SVC_Handler
76. #define xPortPendSVHandler PendSV_Handler
77. #define xPortSysTickHandler SysTick_Handler
80. #endif /* FREERTOS_CONFIG_H */

复制代码

    至此，FreeRTOS的移植工作就完成了，剩下就是系统配置和应用了。其中系统配置，会在第7章专门进行讲解。

5.3.2     FreeRTOS操作系统应用实例


    FreeRTOSConfig.h配置文件里面几个重要选项说明：
1、#define configUSE_PREEMPTION        1
    使能抢占式调度器
2、#define configCPU_CLOCK_HZ      ( ( unsigned long ) 168000000 )  
    系统主频168MHz。
3、#define configTICK_RATE_HZ                     ( ( TickType_t ) 1000 )
    系统时钟节拍1KHz，即1ms。
4、#define configMAX_PRIORITIES          ( 5 )
    定义可供用户使用的最大优先级数，如果这个定义的是5，那么用户可以使用的优先级号是0,1,2,3,4，不包含5，对于这一点，初学者要特别的注意。
5、#define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 30 * 1024 ) )
    定义堆大小，FreeRTOS内核，用户动态内存申请，任务栈等都需要用这个空间。
---------------------------------------------------------------------------------------------------
    经过上面的移植和配置之后，在main.c文件中添加如下代码，代码中简单的创建了四个用户任务：
vTaskTaskUserIF任务：接口消息处理，这里用作LED闪烁。
AppTaskLED任务    ：LED闪烁。
vTaskMsgPro 任务  ：消息处理，这里用作LED闪烁。
AppTaskStart任务  ：启动任务，也是最高优先级任务，这里实现LED闪烁。

1. #include "includes.h"
5. /*
6. **********************************************************************************************************
7.                                                    函数声明
8. **********************************************************************************************************
9. */
10. static void vTaskTaskUserIF(void *pvParameters);
11. static void vTaskLED(void *pvParameters);
12. static void vTaskMsgPro(void *pvParameters);
13. static void vTaskStart(void *pvParameters);
14. static void AppTaskCreate (void);
16. /*
17. **********************************************************************************************************
18.                                                    变量声明
19. **********************************************************************************************************
20. */
21. static TaskHandle_t xHandleTaskUserIF = NULL;
22. static TaskHandle_t xHandleTaskLED = NULL;
23. static TaskHandle_t xHandleTaskMsgPro = NULL;
24. static TaskHandle_t xHandleTaskStart = NULL;
26. /*
27. *********************************************************************************************************
28. *    函 数 名: main
29. *    功能说明: 标准c程序入口。
30. *    形    参: 无
31. *    返 回 值: 无
32. *********************************************************************************************************
33. */
34. int main(void)
35. {
36.      /*
37.        在启动调度前，为了防止初始化STM32外设时有中断服务程序执行，这里禁止全局中断(除了NMI和HardFault)。
38.        这样做的好处是：
39.        1. 防止执行的中断服务程序中有FreeRTOS的API函数。
40.        2. 保证系统正常启动，不受别的中断影响。
41.        3. 关于是否关闭全局中断，大家根据自己的实际情况设置即可。
42.        在移植文件port.c中的函数prvStartFirstTask中会重新开启全局中断。通过指令cpsie i开启，__set_PRIMASK(1)
43.        和cpsie i是等效的。
44.      */
45.      __set_PRIMASK(1);
46.    
47.      /* 硬件初始化 */
48.      bsp_Init();
49.    
50.      /* 创建任务 */
51.      AppTaskCreate();
52.    
53.     /* 启动调度，开始执行任务 */
54.     vTaskStartScheduler();
56.      /*
57.        如果系统正常启动是不会运行到这里的，运行到这里极有可能是用于定时器任务或者空闲任务的
58.        heap空间不足造成创建失败，此要加大FreeRTOSConfig.h文件中定义的heap大小：
59.        #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 17 * 1024 ) )
60.      */
61.      while(1);
63. }
65. /*
66. *********************************************************************************************************
67. *    函 数 名: vTaskTaskUserIF
68. *    功能说明: 接口消息处理，这里用作LED闪烁
69. *    形    参: pvParameters 是在创建该任务时传递的形参
70. *    返 回 值: 无
71. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
72. *********************************************************************************************************
73. */
74. static void vTaskTaskUserIF(void *pvParameters)
75. {
76.     while(1)
77.     {
78.          bsp_LedToggle(1);
79.          vTaskDelay(100);
80.      }
81. }
83. /*
84. *********************************************************************************************************
85. *    函 数 名: vTaskLED
86. *    功能说明: LED闪烁
87. *    形    参: pvParameters 是在创建该任务时传递的形参
88. *    返 回 值: 无
89. *   优 先 级: 2
90. *********************************************************************************************************
91. */
92. static void vTaskLED(void *pvParameters)
93. {
94.     while(1)
95.     {
96.          bsp_LedToggle(2);
97.         vTaskDelay(200);
98.     }
99. }
101. /*
102. *********************************************************************************************************
103. *    函 数 名: vTaskMsgPro
104. *    功能说明: 信息处理，这里是用作LED闪烁   
105. *    形    参: pvParameters 是在创建该任务时传递的形参
106. *    返 回 值: 无
107. *   优 先 级: 3
108. *********************************************************************************************************
109. */
110. static void vTaskMsgPro(void *pvParameters)
111. {
112.     while(1)
113.     {
114.          bsp_LedToggle(3);
115.         vTaskDelay(300);
116.     }
117. }
119. /*
120. *********************************************************************************************************
121. *    函 数 名: vTaskStart
122. *    功能说明: 启动任务，也就是最高优先级任务，这里用作LED闪烁
123. *    形    参: pvParameters 是在创建该任务时传递的形参
124. *    返 回 值: 无
125. *   优 先 级: 4
126. *********************************************************************************************************
127. */
128. static void vTaskStart(void *pvParameters)
129. {
130.     while(1)
131.     {
132.          /* LED闪烁 */
133.          bsp_LedToggle(4);
134.         vTaskDelay(400);
135.     }
136. }
138. /*
139. *********************************************************************************************************
140. *    函 数 名: AppTaskCreate
141. *    功能说明: 创建应用任务
142. *    形    参: 无
143. *    返 回 值: 无
144. *********************************************************************************************************
145. */
146. static void AppTaskCreate (void)
147. {
148.     xTaskCreate( vTaskTaskUserIF,   /* 任务函数  */
149.                  "vTaskUserIF",     /* 任务名    */
150.                  512,               /* 任务栈大小，单位word，也就是4字节 */
151.                  NULL,              /* 任务参数  */
152.                  1,                  /* 任务优先级*/
153.                  &xHandleTaskUserIF );  /* 任务句柄  */
154.    
155.    
156.      xTaskCreate( vTaskLED,           /* 任务函数  */
157.                  "vTaskLED",         /* 任务名    */
158.                  512,                /* 任务栈大小，单位word，也就是4字节 */
159.                  NULL,               /* 任务参数  */
160.                  2,                  /* 任务优先级*/
161.                  &xHandleTaskLED ); /* 任务句柄  */
162.    
163.      xTaskCreate( vTaskMsgPro,            /* 任务函数  */
164.                  "vTaskMsgPro",           /* 任务名    */
165.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
166.                  NULL,                    /* 任务参数  */
167.                  3,                       /* 任务优先级*/
168.                  &xHandleTaskMsgPro );  /* 任务句柄  */
169.    
170.    
171.      xTaskCreate( vTaskStart,             /* 任务函数  */
172.                  "vTaskStart",            /* 任务名    */
173.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
174.                  NULL,                    /* 任务参数  */
175.                  4,                       /* 任务优先级*/
176.                  &xHandleTaskStart );   /* 任务句柄  */
177. }
178. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

除了创建的4个用户任务以外，还有空闲任务，这个任务是系统创建的。至此，FreeRTOS的工程就可以运行了。可以看到4个LED在闪烁。

席萌0209

5.4  STM32F429移植FreeRTOS系统


5.4.1     FreeRTOS操作系统移植

    首先准备好一个简单的裸机工程模板，工程模板的制作就不做讲解了，这里的重点是教大家移植FreeRTOS系统。准备好的工程模板如下图5.3所示（大家也可以制作其它任意的工程模板，不限制）：

图5.3 工程模板

    准备好工程模板后，就可以开始移植了。首先要做的就是将所有需要的源码文件放到工程模板里面。下面分六步和大家进行说明，当然，不限制必须使用下面的方法添加源码到工程，只要将需要的文件添加到工程模板即可。
第1步：从网址https://sourceforge.net/projects/freertos/files/FreeRTOS/V8.2.3/ 下载V8.2.3版本，这个是8.X系列里面最高版本了，9.0版本还处于测试阶段，我们暂不使用。

FreeRTOSV8.2.3.zip和FreeRTOSV8.2.3.exe内容是一样的，只是后缀为exe的压缩率更高些。下载后解压出来。
第2步：在工程模板创建FreeRTOS文件夹

第3步：添加源码文件到相应文件夹
（1）将FreeRTOSV8.2.3软件包中路径：FreeRTOSV8.2.3\\FreeRTOS\\Source里面如下所有文件

    复制到刚刚创建的FreeRTOS文件夹下。
（2）文件夹User中还需要添加如下文件：

    文件FreeRTOSConfig.h文件在FreeRTOSV8.2.3软件包中的中的路径：
    FreeRTOSV8.2.3\\ FreeRTOS\\Demo\\CORTEX_M4F_STM32F407ZG-SK，其实就是官方整理好的配置文件（官方没有F429的例子，使用F407的即可，配置是相同的）。
第3步：将源码文件添加到MDK的工程项目中
    添加后的效果如下：

    其中heap_4.c文件路径：FreeRTOS\\Source\\portable\\MemMang
    port.c和portmacro.h文件的路径：FreeRTOS\\ Source\\portable\\RVDS\\ARM_CM4F，由于STM32F429是M4内核的，所以移植文件也要添加M4内核的。
第4步：新创建一个includes.h文件，将所有的头文件都集中到这个头文件下。
    这样做的好处是引用头文件的时候，只添加这个头文件就可以了。includes.h文件放在了User文件夹中。然后再将这个文件也添加到MDK工程项目中(将.h文件添加到工程的好处是方便查看和修改)

    Includes.h文件中的内容如下：/*

1. /*
2. *********************************************************************************************************
3. *
4. *    模块名称 : 头文件汇总
5. *    文件名称 : includes.h
6. *    版    本 : V1.0
7. *    说    明 : 当前使用头文件汇总
8. *
9. *    修改记录 :
10. *        版本号    日期        作者     说明
11. *        V1.0    2015-08-02  Eric2013   首次发布
12. *
13. *    Copyright (C), 2015-2020, 安富莱电子 www.armfly.com
14. *
15. *********************************************************************************************************
16. */
18. #ifndef  __INCLUDES_H__
19. #define  __INCLUDES_H__
21. /*
22. *********************************************************************************************************
23. *                                         标准库
24. *********************************************************************************************************
25. */
26. #include  <stdarg.h>
27. #include  <stdio.h>
28. #include  <stdlib.h>
29. #include  <math.h>
32. /*
33. *********************************************************************************************************
34. *                                         其它库
35. *********************************************************************************************************
36. */
39. /*
40. *********************************************************************************************************
41. *                                           OS
42. *********************************************************************************************************
43. */
44. #include "FreeRTOS.h"
45. #include "task.h"
46. #include "queue.h"
47. #include "croutine.h"
50. /*
51. *********************************************************************************************************
52. *                                           宏定义
53. *********************************************************************************************************
54. */
57. /*
58. *********************************************************************************************************
59. *                                        APP / BSP
60. *********************************************************************************************************
61. */
63. #include  <bsp.h>
66. #endif
68. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

第5步：添加相应的头文件路径，在原来工程模板的基础上新添加的两个路径：

第6步：最后一步，同时也是最重要的一步，修改FreeRTOSConfig.h配置文件（用户根据自己的配置进行修改，不修改也是没问题的，我们这里进行修改主要是为了方便初学者学习），主要修改了以下两个方面：
（1）添加宏定义__NVIC_PRIO_BITS，STM32系列产品优先级仅使用4位。
（2）修改优先级相关的几个宏定义，具体修改了哪个可以对比原始文件查看。
    修改后在这个文件的末尾加上Systick，PendSV和SVC中断函数的宏定义，目的是将FreeRTOS移植文件port.c文件里面的中断服务程序映射到CMSIS定义的标准名称，这样就不需要用户去修改工程启动代码中这几个中断的名字了，很方便就实现了两个函数的统一。（移植过uCOS-II或者III的用户，对于这个问题估计深有体会，因为uCOS要修改启动文件，其实采用这里的方式更方便）

1. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
2. standard names. */
3. #define vPortSVCHandler     SVC_Handler
4. #define xPortPendSVHandler  PendSV_Handler
5. #define xPortSysTickHandler SysTick_Handler

复制代码

其中vPortSVCHandler，xPortPendSVHandler和xPortSysTickHandler是在port.c文件里面定义的。SVC_Handler，PendSV_Handler和SysTick_Handler在startup_stm32f10x_hd.s文件里面进行了定义。
下面是FreeRTOSConfig.h配置文件的完整内容：

1. #ifndef FREERTOS_CONFIG_H
2. #define FREERTOS_CONFIG_H
4. /*-----------------------------------------------------------
5. * Application specific definitions.
6. *
7. * These definitions should be adjusted for your particular hardware and
8. * application requirements.
9. *
10. * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
11. * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
12. *
13. * See http://www.freertos.org/a00110.html.
14. *----------------------------------------------------------*/
16. #define configUSE_PREEMPTION         1
17. #define configUSE_IDLE_HOOK          0
18. #define configUSE_TICK_HOOK          0
19. #define configCPU_CLOCK_HZ           ( ( unsigned long ) 168000000 )
20. #define configTICK_RATE_HZ           ( ( TickType_t ) 1000 )
21. #define configMAX_PRIORITIES         ( 5 )
22. #define configMINIMAL_STACK_SIZE      ( ( unsigned short ) 128 )
23. #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 30 * 1024 ) )
24. #define configMAX_TASK_NAME_LEN      ( 16 )
25. #define configUSE_TRACE_FACILITY      0
26. #define configUSE_16_BIT_TICKS       0
27. #define configIDLE_SHOULD_YIELD      1
29. /* Co-routine definitions. */
30. #define configUSE_CO_ROUTINES            0
31. #define configMAX_CO_ROUTINE_PRIORITIES ( 2 )
33. /* Set the following definitions to 1 to include the API function, or zero
34. to exclude the API function. */
36. #define INCLUDE_vTaskPrioritySet          1
37. #define INCLUDE_uxTaskPriorityGet         1
38. #define INCLUDE_vTaskDelete               1
39. #define INCLUDE_vTaskCleanUpResources      0
40. #define INCLUDE_vTaskSuspend              1
41. #define INCLUDE_vTaskDelayUntil           1
42. #define INCLUDE_vTaskDelay                1
44. /* Cortex-M specific definitions. */
45. #ifdef __NVIC_PRIO_BITS
46.      /* __BVIC_PRIO_BITS will be specified when CMSIS is being used. */
47.      #define configPRIO_BITS              __NVIC_PRIO_BITS
48. #else
49.      #define configPRIO_BITS              4        /* 15 priority levels */
50. #endif
52. /* The lowest interrupt priority that can be used in a call to a "set priority"
53. function. */
54. #define configLIBRARY_LOWEST_INTERRUPT_PRIORITY       0x0f
56. /* The highest interrupt priority that can be used by any interrupt service
57. routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
58. INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
59. PRIORITY THAN THIS! (higher priorities are lower numeric values. */
60. #define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY    0x01
62. /* Interrupt priorities used by the kernel port layer itself.  These are generic
63. to all Cortex-M ports, and do not rely on any particular library functions. */
64. #define configKERNEL_INTERRUPT_PRIORITY        ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
65. /* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
66. See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
67. #define configMAX_SYSCALL_INTERRUPT_PRIORITY   ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
68.    
69. /* Normal assert() semantics without relying on the provision of an assert.h
70. header file. */
71. #define configASSERT( x ) if( ( x ) == 0 ) { taskDISABLE_INTERRUPTS(); for( ;; ); }
72.    
73. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
74. standard names. */
75. #define vPortSVCHandler SVC_Handler
76. #define xPortPendSVHandler PendSV_Handler
77. #define xPortSysTickHandler SysTick_Handler
80. #endif /* FREERTOS_CONFIG_H */

复制代码

    至此，FreeRTOS的移植工作就完成了，剩下就是系统配置和应用了。其中系统配置，会在第7章专门进行讲解。

5.4.2     FreeRTOS操作系统应用实例


    FreeRTOSConfig.h配置文件里面几个重要选项说明：
1、#define configUSE_PREEMPTION        1
    使能抢占式调度器
2、#define configCPU_CLOCK_HZ      ( ( unsigned long ) 168000000 )  
    系统主频168MHz。
3、#define configTICK_RATE_HZ                     ( ( TickType_t ) 1000 )
    系统时钟节拍1KHz，即1ms。
5、#define configMAX_PRIORITIES          ( 5 )
    定义可供用户使用的最大优先级数，如果这个定义的是5，那么用户可以使用的优先级号是0,1,2,3,4，不包含5，对于这一点，初学者要特别的注意。
6、#define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 30 * 1024 ) )
    定义堆大小，FreeRTOS内核，用户动态内存申请，任务栈等都需要用这个空间。
---------------------------------------------------------------------------------------------------
    经过上面的移植和配置之后，在main.c文件中添加如下代码，代码中简单的创建了四个用户任务：
vTaskTaskUserIF任务：接口消息处理，这里用作LED闪烁。
AppTaskLED任务 ：LED闪烁。
vTaskMsgPro任务：消息处理，这里用作LED闪烁。
AppTaskStart任务：启动任务，也是最高优先级任务，这里实现LED闪烁。

1. #include "includes.h"
5. /*
6. **********************************************************************************************************
7.                                                    函数声明
8. **********************************************************************************************************
9. */
10. static void vTaskTaskUserIF(void *pvParameters);
11. static void vTaskLED(void *pvParameters);
12. static void vTaskMsgPro(void *pvParameters);
13. static void vTaskStart(void *pvParameters);
14. static void AppTaskCreate (void);
16. /*
17. **********************************************************************************************************
18.                                                    变量声明
19. **********************************************************************************************************
20. */
21. static TaskHandle_t xHandleTaskUserIF = NULL;
22. static TaskHandle_t xHandleTaskLED = NULL;
23. static TaskHandle_t xHandleTaskMsgPro = NULL;
24. static TaskHandle_t xHandleTaskStart = NULL;
26. /*
27. *********************************************************************************************************
28. *    函 数 名: main
29. *    功能说明: 标准c程序入口。
30. *    形    参: 无
31. *    返 回 值: 无
32. *********************************************************************************************************
33. */
34. int main(void)
35. {
36.      /*
37.        在启动调度前，为了防止初始化STM32外设时有中断服务程序执行，这里禁止全局中断(除了NMI和HardFault)。
38.        这样做的好处是：
39.        1. 防止执行的中断服务程序中有FreeRTOS的API函数。
40.        2. 保证系统正常启动，不受别的中断影响。
41.        3. 关于是否关闭全局中断，大家根据自己的实际情况设置即可。
42.        在移植文件port.c中的函数prvStartFirstTask中会重新开启全局中断。通过指令cpsie i开启，__set_PRIMASK(1)
43.        和cpsie i是等效的。
44.      */
45.      __set_PRIMASK(1);
46.    
47.      /* 硬件初始化 */
48.      bsp_Init();
49.    
50.      /* 创建任务 */
51.      AppTaskCreate();
52.    
53.     /* 启动调度，开始执行任务 */
54.     vTaskStartScheduler();
56.      /*
57.        如果系统正常启动是不会运行到这里的，运行到这里极有可能是用于定时器任务或者空闲任务的
58.        heap空间不足造成创建失败，此要加大FreeRTOSConfig.h文件中定义的heap大小：
59.        #define configTOTAL_HEAP_SIZE        ( ( size_t ) ( 17 * 1024 ) )
60.      */
61.      while(1);
63. }
65. /*
66. *********************************************************************************************************
67. *    函 数 名: vTaskTaskUserIF
68. *    功能说明: 接口消息处理，这里用作LED闪烁
69. *    形    参: pvParameters 是在创建该任务时传递的形参
70. *    返 回 值: 无
71. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
72. *********************************************************************************************************
73. */
74. static void vTaskTaskUserIF(void *pvParameters)
75. {
76.     while(1)
77.     {
78.          bsp_LedToggle(1);
79.          vTaskDelay(100);
80.      }
81. }
83. /*
84. *********************************************************************************************************
85. *    函 数 名: vTaskLED
86. *    功能说明: LED闪烁
87. *    形    参: pvParameters 是在创建该任务时传递的形参
88. *    返 回 值: 无
89. *   优 先 级: 2
90. *********************************************************************************************************
91. */
92. static void vTaskLED(void *pvParameters)
93. {
94.     while(1)
95.     {
96.          bsp_LedToggle(2);
97.         vTaskDelay(200);
98.     }
99. }
101. /*
102. *********************************************************************************************************
103. *    函 数 名: vTaskMsgPro
104. *    功能说明: 信息处理，这里是用作LED闪烁   
105. *    形    参: pvParameters 是在创建该任务时传递的形参
106. *    返 回 值: 无
107. *   优 先 级: 3
108. *********************************************************************************************************
109. */
110. static void vTaskMsgPro(void *pvParameters)
111. {
112.     while(1)
113.     {
114.         bsp_LedToggle(3);
115.         vTaskDelay(300);
116.     }
117. }
119. /*
120. *********************************************************************************************************
121. *    函 数 名: vTaskStart
122. *    功能说明: 启动任务，也就是最高优先级任务，这里用作LED闪烁
123. *    形    参: pvParameters 是在创建该任务时传递的形参
124. *    返 回 值: 无
125. *   优 先 级: 4
126. *********************************************************************************************************
127. */
128. static void vTaskStart(void *pvParameters)
129. {
130.     while(1)
131.     {
132.          /* LED闪烁 */
133.         bsp_LedToggle(4);
134.         vTaskDelay(400);
135.     }
136. }
138. /*
139. *********************************************************************************************************
140. *    函 数 名: AppTaskCreate
141. *    功能说明: 创建应用任务
142. *    形    参: 无
143. *    返 回 值: 无
144. *********************************************************************************************************
145. */
146. static void AppTaskCreate (void)
147. {
148.     xTaskCreate( vTaskTaskUserIF,   /* 任务函数  */
149.                  "vTaskUserIF",     /* 任务名    */
150.                  512,               /* 任务栈大小，单位word，也就是4字节 */
151.                  NULL,              /* 任务参数  */
152.                  1,                 /* 任务优先级*/
153.                  &xHandleTaskUserIF );  /* 任务句柄  */
154.    
155.    
156.      xTaskCreate( vTaskLED,           /* 任务函数  */
157.                  "vTaskLED",         /* 任务名    */
158.                  512,                /* 任务栈大小，单位word，也就是4字节 */
159.                  NULL,               /* 任务参数  */
160.                  2,                  /* 任务优先级*/
161.                  &xHandleTaskLED ); /* 任务句柄  */
162.    
163.      xTaskCreate( vTaskMsgPro,            /* 任务函数  */
164.                  "vTaskMsgPro",           /* 任务名    */
165.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
166.                  NULL,                    /* 任务参数  */
167.                  3,                       /* 任务优先级*/
168.                  &xHandleTaskMsgPro );  /* 任务句柄  */
169.    
170.    
171.      xTaskCreate( vTaskStart,             /* 任务函数  */
172.                  "vTaskStart",            /* 任务名    */
173.                  512,                     /* 任务栈大小，单位word，也就是4字节 */
174.                  NULL,                    /* 任务参数  */
175.                  4,                       /* 任务优先级*/
176.                  &xHandleTaskStart );   /* 任务句柄  */
177. }
178. /***************************** 安富莱电子 www.armfly.com (END OF FILE) *********************************/

复制代码

除了创建的4个用户任务以外，还有空闲任务，这个任务是系统创建的。至此，FreeRTOS的工程就可以运行了，可以看到4个LED在闪烁。

席萌0209

5.5  总结

    本章节为大家讲解了FreeRTOS的移植方法，移植比较简单。另一个重要内容是系统文件配置，在教程的第7章会为大家详细讲解这一部分。

liwi163

受益匪浅啊。。[s:151]

倔强顽童小焱

讲的挺详细的，让我这个初学者一看就能懂个大概