前言
/ A. I+ e5 m$ J3 k本篇文章带大家了解FreeRTOS里面的FreeRTOSConfig.h文件,此文基于正点原子FreeRTOS手册讲解。

一、文件讲解
源码:
: Q  O0 |" Y; N  r& u

1. /* USER CODE BEGIN Header */
   : B" T7 w8 _2 b* V, n' E
2. /*
   , b, ]" @  M) N) ^5 K
3. * FreeRTOS Kernel V10.0.1
   
4. * Copyright (C) 2017 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
   
5. *
   ! e: Y: k1 b3 a8 N  ]. f8 i, Q
6. * Permission is hereby granted, free of charge, to any person obtaining a copy of
   
7. * this software and associated documentation files (the "Software"), to deal in
   
8. * the Software without restriction, including without limitation the rights to
   
9. * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
     B9 q8 \# b8 g3 E# ~
10. * the Software, and to permit persons to whom the Software is furnished to do so,
    
11. * subject to the following conditions:
    
12. *
    
13. * The above copyright notice and this permission notice shall be included in all
    " U) O3 V! \( W$ j- N
14. * copies or substantial portions of the Software.
    + e8 T& u- O* ~( X/ n5 g2 e
15. *
    : @/ I) f' f: C4 ^
16. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    
17. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
    
18. * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
    
19. * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
    " I+ @6 S, l; p0 S0 _, ~# a
20. * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
    
21. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
    
22. *
    
23. 
    ! ?* p1 f! W# e* c1 m; a- O
24. *
    ! P( z# s, l4 o
25. * 1 tab == 4 spaces!
    
26. */
    
27. /* USER CODE END Header */
    ( g: W" H! c; a/ k, T8 m
28. 
    
29. #ifndef FREERTOS_CONFIG_H
    + j6 ^: }0 m" i" ^; V8 N% }
30. #define FREERTOS_CONFIG_H
    
31. 
    
32. /*-----------------------------------------------------------
    
33. * Application specific definitions.
    
34. *
    
35. * These definitions should be adjusted for your particular hardware and
    
36. * application requirements.
    6 H5 `' N# E9 A" A" S
37. *
    
38. * These parameters and more are described within the 'configuration' section of the
    
39. * FreeRTOS API documentation available on the FreeRTOS.org web site.
    
40. *
    # p: J+ \# l6 v9 C
41. 
    3 b; V: D* y. R6 F! q5 W4 B
42. *----------------------------------------------------------*/
    : s% A( a% O; m- o8 \$ H
43. 
    
44. /* USER CODE BEGIN Includes */
    
45. /* Section where include file can be added */
    
46. /* USER CODE END Includes */
    0 [2 h3 e( t$ F' q
47. 
    
48. /* Ensure definitions are only used by the compiler, and not by the assembler. */
    / d; k) Z$ [% |6 S* F: {  f2 M
49. #if defined(__ICCARM__) || defined(__CC_ARM) || defined(__GNUC__)
    
50.   #include <stdint.h>
    
51.   extern uint32_t SystemCoreClock;
    - U2 m) T! x" r. ]6 u2 h
52. #endif
    
53. #define configUSE_PREEMPTION                     1
      _& I( P) @* x0 ?
54. #define configSUPPORT_STATIC_ALLOCATION          1
    
55. #define configSUPPORT_DYNAMIC_ALLOCATION         1
    
56. #define configUSE_IDLE_HOOK                      0
    : S- ~& F% t1 G: m3 ^
57. #define configUSE_TICK_HOOK                      0
    ! ]  G6 u+ u/ \: [  a/ Q; l
58. #define configCPU_CLOCK_HZ                       ( SystemCoreClock )
    
59. #define configTICK_RATE_HZ                       ((TickType_t)1000)
    + O. B% E8 O& p3 Z
60. #define configMAX_PRIORITIES                     ( 7 )
    5 r$ w) |+ [: Z+ T4 [) F$ |
61. #define configMINIMAL_STACK_SIZE                 ((uint16_t)128)
    
62. #define configTOTAL_HEAP_SIZE                    ((size_t)3072)
    2 v! O$ K) g9 L0 b) }. ?6 `
63. #define configMAX_TASK_NAME_LEN                  ( 16 )
    + l( g0 I) P! w, T
64. #define configUSE_16_BIT_TICKS                   0
    ( h, K* G  H% y" c# ?( b5 l
65. #define configUSE_MUTEXES                        1
    
66. #define configQUEUE_REGISTRY_SIZE                8
    3 e3 c8 \; x/ Y2 V% W. a
67. #define configUSE_PORT_OPTIMISED_TASK_SELECTION  1
    
68. 
    
69. /* Co-routine definitions. */
    
70. #define configUSE_CO_ROUTINES                    0
    
71. #define configMAX_CO_ROUTINE_PRIORITIES          ( 2 )
    
72. 
    
73. /* Set the following definitions to 1 to include the API function, or zero
    - f, O3 {0 G1 g; x" F/ J! {9 E
74. to exclude the API function. */
    
75. #define INCLUDE_vTaskPrioritySet            1
    
76. #define INCLUDE_uxTaskPriorityGet           1
    9 w$ l2 J6 g( X3 i. \. t5 s7 B
77. #define INCLUDE_vTaskDelete                 1
    
78. #define INCLUDE_vTaskCleanUpResources       0
    
79. #define INCLUDE_vTaskSuspend                1
    
80. #define INCLUDE_vTaskDelayUntil             0
    6 K1 i; K! m- @" c& r. N
81. #define INCLUDE_vTaskDelay                  1
    7 I# Q* \$ g0 _6 V9 o+ v. {4 J
82. #define INCLUDE_xTaskGetSchedulerState      1
    
83. 
    / P* B( x& h$ ?
84. 
    
85. //Tickless
    
86. #define configUSE_TICKLESS_IDLE             1//启用tickless低功耗
    
87. #define configEXPECTED_IDLE_TIME_BEFORE_SLEEP       3
    
88. 
    
89. /* Cortex-M specific definitions. */
    2 ?, n. j6 P: _9 \7 ~" I5 W
90. #ifdef __NVIC_PRIO_BITS
    
91. /* __BVIC_PRIO_BITS will be specified when CMSIS is being used. */
    + y; v8 Y0 z- L
92. #define configPRIO_BITS         __NVIC_PRIO_BITS
    
93. #else
    / `, {$ ^5 O% h' T4 b+ O
94. #define configPRIO_BITS         4
    * K$ G, y# Q' B9 M" @9 p
95. #endif
    
96. 
    , g- j+ ~" z+ M: |: }: z  C  I
97. /* The lowest interrupt priority that can be used in a call to a "set priority"
    
98. function. */
    ) B* p. m/ u# h& D
99. #define configLIBRARY_LOWEST_INTERRUPT_PRIORITY   15
    
100. 
     
101. /* The highest interrupt priority that can be used by any interrupt service
     7 R- F- y, A; {4 P+ C
102. routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
     
103. INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
     
104. PRIORITY THAN THIS! (higher priorities are lower numeric values. */
     ' y( U: c5 e9 P3 Y8 [) q. r
105. #define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5
     7 {! z& \+ {0 P# b  A/ u& j
106. 
     3 f: B$ u7 d8 u- c  f' Y
107. /* Interrupt priorities used by the kernel port layer itself.  These are generic
     
108. to all Cortex-M ports, and do not rely on any particular library functions. */
     
109. #define configKERNEL_INTERRUPT_PRIORITY                 ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
     
110. /* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
     0 P/ n2 J+ o5 d3 m
111. See <a href="http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html." target="_blank">http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html.</a> */
     ' R1 a# T9 i! {% G& x+ O0 f
112. #define configMAX_SYSCALL_INTERRUPT_PRIORITY         ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
     
113. 
     
114. /* Normal assert() semantics without relying on the provision of an assert.h
     
115. header file. */
     
116. /* USER CODE BEGIN 1 */
     . R$ D1 @3 ]+ C, q4 ]0 i! ?  |
117. #define configASSERT( x ) if ((x) == 0) {taskDISABLE_INTERRUPTS(); for( ;; );}
     
118. /* USER CODE END 1 */
     
119. 
     ' a0 ^4 x1 b) J" ~+ U- @
120. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
     
121. standard names. */
     " x7 h9 w$ w+ F1 Q( n( b: B
122. #define vPortSVCHandler    SVC_Handler
     
123. #define xPortPendSVHandler PendSV_Handler
     
124. 
     7 f& Y5 v( a& `) b+ p. }/ S
125. /* IMPORTANT: This define is commented when used with STM32Cube firmware, when the timebase source is SysTick,
     
126.               to prevent overwriting SysTick_Handler defined within STM32Cube HAL */
     
127. 
     ' `" S$ {/ L! i) D, t% G
128. #define xPortSysTickHandler SysTick_Handler
     
129. 
     9 L5 S$ }( H1 i( [- k6 U2 @% K9 o
130. /* USER CODE BEGIN Defines */
     
131. /* Section where parameter definitions can be added (for instance, to override default ones in FreeRTOS.h) */
     
132. /* USER CODE END Defines */
     9 v  ~' [2 H. m; j1 A) Q) R1 |
133. 
     
134. #endif /* FREERTOS_CONFIG_H */
     8 @: O# J# i$ M$ ^

复制代码

FreeRTOS 的配置基本是通过在 FreeRTOSConfig.h 中使用“#define”这样的语句来定义宏定义实现的。
" v* q5 ?9 f2 V; Q4 M) k2 }这些宏定义都有特殊的含义，我们就调其中一个讲解。

1. #define configGENERATE_RUN_TIME_STATS                1
   5 d" `) F# O( P  r* r. O5 e

复制代码

2 ]) s% \6 V' b3 Q7 m; g: e+ b将此宏设置为1开启时间统计功能，相应的 API 函数会被编译，为 0 时关闭时间统计功能。
) ~' @* {' k" y! Z其他的宏作用也和这个差不多，当设置为1时就可以使能某些函数，设置为0函数就不可用。
其他宏大家可以自己看看，一般cubeMX生成代码后都会自动配置一些宏。
, L5 D" c  |# N/ L8 Z& }; Z+ n
总结
FreeRTOSConfig.h文件简单解析就到这里。
! T# j' c% A4 b
4 ?0 S, u3 @6 d) Y! [8 O  @