趁中午休息时间撸点货-FreeRTOS配置文件注释

技术范儿

1. /*
   
2.     FreeRTOS V8.2.3 - Copyright (C) 2015 Real Time Engineers Ltd.
   
3.     All rights reserved
   
4. 
   
5.     VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
   
6. 
   
7.     This file is part of the FreeRTOS distribution.
   
8. 
   
9.     FreeRTOS is free software; you can redistribute it and/or modify it under
   
10.     the terms of the GNU General Public License (version 2) as published by the
    
11.     Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
    
12. 
    
13.     ***************************************************************************
    
14.     >>!   NOTE: The modification to the GPL is included to allow you to     !<<
    
15.     >>!   distribute a combined work that includes FreeRTOS without being   !<<
    
16.     >>!   obliged to provide the source code for proprietary components     !<<
    
17.     >>!   outside of the FreeRTOS kernel.                                   !<<
    
18.     ***************************************************************************
    
19. 
    
20.     FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
    
21.     WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
    
22.     FOR A PARTICULAR PURPOSE.  Full license text is available on the following
    
23.     link: http://www.freertos.org/a00114.html
    
24. 
    
25.     ***************************************************************************
    
26.      *                                                                       *
    
27.      *    FreeRTOS provides completely free yet professionally developed,    *
    
28.      *    robust, strictly quality controlled, supported, and cross          *
    
29.      *    platform software that is more than just the market leader, it     *
    
30.      *    is the industry's de facto standard.                               *
    
31.      *                                                                       *
    
32.      *    Help yourself get started quickly while simultaneously helping     *
    
33.      *    to support the FreeRTOS project by purchasing a FreeRTOS           *
    
34.      *    tutorial book, reference manual, or both:                          *
    
35.      *    http://www.FreeRTOS.org/Documentation                              *
    
36.      *                                                                       *
    
37.     ***************************************************************************
    
38. 
    
39.     http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
    
40.     the FAQ page "My application does not run, what could be wrong?".  Have you
    
41.     defined configASSERT()?
    
42. 
    
43.     http://www.FreeRTOS.org/support - In return for receiving this top quality
    
44.     embedded software for free we request you assist our global community by
    
45.     participating in the support forum.
    
46. 
    
47.     http://www.FreeRTOS.org/training - Investing in training allows your team to
    
48.     be as productive as possible as early as possible.  Now you can receive
    
49.     FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
    
50.     Ltd, and the world's leading authority on the world's leading RTOS.
    
51. 
    
52.     http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
    
53.     including FreeRTOS+Trace - an indispensable productivity tool, a DOS
    
54.     compatible FAT file system, and our tiny thread aware UDP/IP stack.
    
55. 
    
56.     http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
    
57.     Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
    
58. 
    
59.     http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
    
60.     Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
    
61.     licenses offer ticketed support, indemnification and commercial middleware.
    
62. 
    
63.     http://www.SafeRTOS.com - High Integrity Systems also provide a safety
    
64.     engineered and independently SIL3 certified version for use in safety and
    
65.     mission critical applications that require provable dependability.
    
66. 
    
67.     1 tab == 4 spaces!
    
68. */
    
69. 
    
70. #ifndef FREERTOS_CONFIG_H
    
71. #define FREERTOS_CONFIG_H
    
72. 
    
73. /*-----------------------------------------------------------
    
74. * Application specific definitions.
    
75. *
    
76. * These definitions should be adjusted for your particular hardware and
    
77. * application requirements.
    
78. *
    
79. * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
    
80. * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
    
81. *
    
82. * See http://www.freertos.org/a00110.html.
    
83. *----------------------------------------------------------*/
    
84. 
    
85. #define configUSE_PREEMPTION 1//配置为1 使能抢占式调度器。配置为0使用合作式任务调度内核
    
86. #define configUSE_IDLE_HOOK 0
    
87. #define configUSE_TICK_HOOK 0
    
88. #define configCPU_CLOCK_HZ (SystemCoreClock)//定义CPU主频
    
89. #define configTICK_RATE_HZ ((TickType_t)1000)//系统节拍数
    
90. #define configMAX_PRIORITIES (5)//最大优先级数量
    
91. #define configMINIMAL_STACK_SIZE ((unsigned short)90)//堆栈大小
    
92. #define configTOTAL_HEAP_SIZE ((size_t)(10 * 1024))//定义堆大小
    
93. #define configMAX_TASK_NAME_LEN (10)//任务名最大长度
    
94. #define configUSE_TRACE_FACILITY 1//协助可视化跟踪和调试使用IAR需要设置为1
    
95. #define configUSE_16_BIT_TICKS 0//计数器为32bit试用与ARM处理器
    
96. #define configIDLE_SHOULD_YIELD 1//使能与空闲任务同优先级的任务
    
97. #define configUSE_MUTEXES 1//互斥信号量使能与禁止
    
98. #define configQUEUE_REGISTRY_SIZE 8//注册队列和信号量的个数
    
99. #define configCHECK_FOR_STACK_OVERFLOW 0//堆栈溢出检测
    
100. #define configUSE_RECURSIVE_MUTEXES 1//使能与禁止递归互斥信号量
     
101. #define configUSE_MALLOC_FAILED_HOOK 0//使能与禁止系统内部的动态内存申请函数
     
102. #define configUSE_APPLICATION_TASK_TAG 0//使能与禁止分配任务的标签值
     
103. #define configUSE_COUNTING_SEMAPHORES 1//使能与禁止计数信号量
     
104. #define configGENERATE_RUN_TIME_STATS 0//使能与禁止任务运行参数状态统计
     
105. #define configUSE_TIME_SLICING 1//使能与禁止时间片调度
     
106. 
     
107. /* Co-routine definitions. */
     
108. #define configUSE_CO_ROUTINES 0//使能与禁止合作式任务调度
     
109. #define configMAX_CO_ROUTINE_PRIORITIES 10//最大的合作式优先级任务数
     
110. 
     
111. /* Software timer definitions. */
     
112. #define configUSE_TIMERS 1//禁止与使能软定时器
     
113. #define configTIMER_TASK_PRIORITY (2)//配置定时器任务的优先级
     
114. #define configTIMER_QUEUE_LENGTH 10//配置软件定时器任务队列长度
     
115. #define configTIMER_TASK_STACK_DEPTH (configMINIMAL_STACK_SIZE * 2)//配置定时器任务堆栈大小
     
116. 
     
117. /* Set the following definitions to 1 to include the API function, or zero
     
118. to exclude the API function. */
     
119. #define INCLUDE_vTaskPrioritySet 1 //设置任务优先级
     
120. #define INCLUDE_uxTaskPriorityGet 1 //获取任务优先级
     
121. #define INCLUDE_vTaskDelete 1 //允许删除任务
     
122. #define INCLUDE_vTaskCleanUpResources 1
     
123. #define INCLUDE_vTaskSuspend 1
     
124. #define INCLUDE_vTaskDelayUntil 1//频率实现延时
     
125. #define INCLUDE_vTaskDelay 1  //延时函数可用
     
126. 
     
127. /* Cortex-M specific definitions. */
     
128. #ifdef __NVIC_PRIO_BITS
     
129. /* __BVIC_PRIO_BITS will be specified when CMSIS is being used. */
     
130. #define configPRIO_BITS __NVIC_PRIO_BITS
     
131. #else
     
132. #define configPRIO_BITS 4 /* 15 priority levels */
     
133. #endif
     
134. 
     
135. /* The lowest interrupt priority that can be used in a call to a "set priority"
     
136. function. */
     
137. #define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 0xf
     
138. 
     
139. /* The highest interrupt priority that can be used by any interrupt service
     
140. routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
     
141. INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
     
142. PRIORITY THAN THIS! (higher priorities are lower numeric values. */
     
143. #define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5
     
144. 
     
145. /* Interrupt priorities used by the kernel port layer itself.  These are generic
     
146. to all Cortex-M ports, and do not rely on any particular library functions. */
     
147. #define configKERNEL_INTERRUPT_PRIORITY (configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
     
148. /* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
     
149. See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
     
150. #define configMAX_SYSCALL_INTERRUPT_PRIORITY (configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
     
151. 
     
152. /* Normal assert() semantics without relying on the provision of an assert.h
     
153. header file. */
     
154. #define configASSERT(x)           \
     
155.     if ((x) == 0)                 \
     
156.     {                             \
     
157.         taskDISABLE_INTERRUPTS(); \
     
158.         for (;;)                  \
     
159.             ;                     \
     
160.     }
     
161. 
     
162. /* Definitions that map the FreeRTOS port interrupt handlers to their CMSIS
     
163. standard names. */
     
164. #define vPortSVCHandler SVC_Handler
     
165. #define xPortPendSVHandler PendSV_Handler
     
166. #define xPortSysTickHandler SysTick_Handler
     
167. 
     
168. #endif /* FREERTOS_CONFIG_H */
     

复制代码

阅读全文

shaoziyang

不错，赞一个。

kingsings

中午都不休息

lkl0305

楼主辛苦了，赞一个