2、STM32F103HAL FreeRTOSConfig.h解析

风詺祈

已于 2024-05-27 17:40:22 修改

阅读量313

点赞数 4

分类专栏： FreeRTOS 文章标签： stm32 嵌入式硬件单片机

于 2024-05-15 17:55:38 首次发布

本文链接：https://blog.csdn.net/weixin_37933648/article/details/138910545

版权

FreeRTOS 专栏收录该内容

5 篇文章 0 订阅

订阅专栏

FreeRTOSConfig.h 文件中的配置项可分为三大类：“config”配置项、“INCLUDE”配置项和其他配置项

一、“config”配置项

1、configUSE_PREEMPTION

说明：
	设置系统的调度方式；
赋值：
	configUSE_PREEMPTION = 1 时，系统使用抢占式调度；
	configUSE_PREEMPTION = 0 时，系统使用协程式调度。
默认值：
	#define configUSE_PREEMPTION						1

2、configUSE_PORT_OPTIMISED_TASK_SELECTION

说明：
	选择下一个要执行的任务方式；
赋值：
	configUSE_PORT_OPTIMISED_TASK_SELECTION = 1 时，使用特殊方法；
	configUSE_PORT_OPTIMISED_TASK_SELECTION = 0 时，使用通用方法。
默认值：
	#define configUSE_PORT_OPTIMISED_TASK_SELECTION		1

3、configUSE_TICKLESS_IDLE

说明：
	系统是否进入低功耗模式；
赋值：
	configUSE_TICKLESS_IDLE = 1 时，使能 tickless 低功耗模式；
	configUSE_TICKLESS_IDLE = 0 时，禁止 tickless 低功耗模式。
默认值：
	#define configUSE_TICKLESS_IDLE						0

4、configCPU_CLOCK_HZ

说明：
	设置为CPU的内核时钟频率，单位为 Hz；
赋值：
	#define configCPU_CLOCK_HZ						(SystemCoreClock)	
默认值：
	#define configCPU_CLOCK_HZ			            ( ( unsigned long ) 72000000 )

5、configTICK_RATE_HZ

说明：
	设置FreeRTOS系统节拍的中断频率:，单位为 Hz；（1ms一次）	
默认值：
	#define configTICK_RATE_HZ			            ( ( TickType_t ) 1000 )

6、configMAX_PRIORITIES

说明：
	定义系统支持的最大任务优先级数量， 最大任务优先级数值为：configMAX_PRIORITIES-1；	
默认值：
	#define configMAX_PRIORITIES					(32)

7、configMINIMAL_STACK_SIZE

说明：
	设置空闲任务的栈空间大小，单位为word；	
默认值：
	#define configMINIMAL_STACK_SIZE				((unsigned short)128)

8、configMAX_TASK_NAME_LEN

说明：
	设置任务名的最大字符数；	
默认值：
	#define configMAX_TASK_NAME_LEN		            ( 16 )

9、configUSE_16_BIT_TICKS

说明：
	定义系统节拍计数器的数据类型；	
赋值：
	configUSE_16_BIT_TICKS = 1 时，系统节拍计数器的数据类型为 16 位无符号整形；
	configUSE_16_BIT_TICKS = 0 时，系统节拍计数器的数据类型为 32 为无符号整型。
默认值：
	#define configUSE_16_BIT_TICKS		            0

10、configIDLE_SHOULD_YIELD

说明：
	同等优先级的任务是否可抢占空闲任务；	
赋值：
	configIDLE_SHOULD_YIELD = 1 时，在抢占调度下，同等优先级的任务可抢占空闲任务；
	configIDLE_SHOULD_YIELD = 0 时，在抢占调度下，同等优先级的任务不抢占空闲任务。
默认值：
	#define configIDLE_SHOULD_YIELD		            1

11、configUSE_TASK_NOTIFICATIONS

说明：
	开启任务通知功能，当开启任务通知功能后，每个任务将多占用 8 字节的内存空间；	
赋值：
	configUSE_TASK_NOTIFICATIONS = 1 时，开启任务通知功能；
	configUSE_TASK_NOTIFICATIONS = 0 时，不开启任务通知功能。
默认值：
	#define configUSE_TASK_NOTIFICATIONS            0

12、configTASK_NOTIFICATION_ARRAY_ENTRIES

说明：
	定义任务通知数组的大小，使用前必须先开启configUSE_TASK_NOTIFICATIONS；	
赋值：
	#define configTASK_NOTIFICATION_ARRAY_ENTRIES	5
默认值：
	//#define configTASK_NOTIFICATION_ARRAY_ENTRIES	5

13、configUSE_MUTEXES

说明：
	是否使能互斥信号量；	
赋值：
	configUSE_MUTEXES = 1 时，使能互斥信号量；
	configUSE_MUTEXES = 0 时，禁止互斥信号量。
默认值：
	#define configUSE_MUTEXES						0

14、configUSE_RECURSIVE_MUTEXES

说明：
	是否使能递归互斥信号量；	
赋值：
	configUSE_RECURSIVE_MUTEXES = 1 时，使能递归互斥信号量；
	configUSE_RECURSIVE_MUTEXES = 0 时，禁止递归互斥信号量。
默认值：
	#define configUSE_RECURSIVE_MUTEXES				0

15、configUSE_COUNTING_SEMAPHORES

说明：
	是否使能计数型信号量；	
赋值：
	configUSE_COUNTING_SEMAPHORES = 1 时，使能计数型信号量；
	configUSE_COUNTING_SEMAPHORES = 0 时，禁止计数型信号量。
默认值：
	#define configUSE_COUNTING_SEMAPHORES 			0

16、configQUEUE_REGISTRY_SIZE

说明：
	定义可以注册的队列和信号量的最大数量，仅用于调试使用；	
赋值：
	#define configQUEUE_REGISTRY_SIZE				8
默认值：
	//#define configQUEUE_REGISTRY_SIZE				8

17、configUSE_QUEUE_SETS

说明：
	是否使能队列集；	
赋值：
	configUSE_QUEUE_SETS = 1 时，使能队列集；
	configUSE_QUEUE_SETS = 0 时，禁止队列集。
默认值：
	#define configUSE_QUEUE_SETS					0

18、configUSE_TIME_SLICING

说明：
	是否使能时间片调度；	
赋值：
	configUSE_TIME_SLICING = 1 时，使能时间片调度；
	configUSE_TIME_SLICING = 0 时，禁止时间片调度。
默认值：
	#define configUSE_TIME_SLICING					1

19、configUSE_NEWLIB_REENTRANT

说明：
	是否为每个任务分配一个 NewLib 重入结构体；	
赋值：
	configUSE_NEWLIB_REENTRANT = 1 时，为每个创建的任务的任务控制块分配一个NewLib重入结构体；
	configUSE_NEWLIB_REENTRANT = 0 时，不为每个创建的任务的任务控制块分配一个NewLib重入结构体。
默认值：
	#define configUSE_NEWLIB_REENTRANT				0

20、configNUM_THREAD_LOCAL_STORAGE_POINTERS

说明：
	是否在任务控制块中分配一个线程本地存储指着数组；	
赋值：
	configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 时，为线程本地存储指针数组的元素个数；
	configNUM_THREAD_LOCAL_STORAGE_POINTERS = 0 时，禁用线程本地存储指针数组。
默认值：
	#define configNUM_THREAD_LOCAL_STORAGE_POINTERS	0

21、configSUPPORT_STATIC_ALLOCATION

说明：
	是否支持使用静态方式管理内存；	
赋值：
	configSUPPORT_STATIC_ALLOCATION = 1 时，支持使用静态方式管理内存，同时用户需要自己提供vApplicationGetIdleTaskMemory() 和 vApplicationGetTimerTaskMemory()两个回调函数；
	configSUPPORT_STATIC_ALLOCATION = 0 时，禁用使用静态方式管理内存。
默认值：
	#define configSUPPORT_STATIC_ALLOCATION			0

22、configSUPPORT_DYNAMIC_ALLOCATION

说明：
	是否支持使用动态方式管理内存；	
赋值：
	configSUPPORT_DYNAMIC_ALLOCATION = 1 时，支持使用动态方式管理内存；
	configSUPPORT_DYNAMIC_ALLOCATION = 0 时，禁用使用动态方式管理内存。
默认值：
	#define configSUPPORT_DYNAMIC_ALLOCATION		1

23、configTOTAL_HEAP_SIZE

说明：
	设置动态内存管理的内存堆大小，单位为Byte；	
赋值：
	configTOTAL_HEAP_SIZE > 0 ，仅用于动态方式管理内存，必须先配置configSUPPORT_DYNAMIC_ALLOCATION = 1；
默认值：
	#define configTOTAL_HEAP_SIZE		            ( ( size_t ) ( 16 * 1024 ) )

24、configAPPLICATION_ALLOCATED_HEAP

说明：
	用户自己分配动态内存，用于外扩内存（如sram, sdram）时候分配内存空间；	
赋值：
	configAPPLICATION_ALLOCATED_HEAP = 1 时，用户需要自行创建FreeRTOS的内存堆，否则FreeRTOS的内存堆将由编译器进行分配；
	configAPPLICATION_ALLOCATED_HEAP = 0 时，禁用使用自定义动态分配内存。
默认值：
	#define configAPPLICATION_ALLOCATED_HEAP		0

25、configSTACK_ALLOCATION_FROM_SEPARATE_HEAP

说明：
	用于自定义动态创建和删除任务时，任务栈内存的申请与释放函数开启；	
赋值：
	configSTACK_ALLOCATION_FROM_SEPARATE_HEAP = 1 时，用户需要用户需提供 pvPortMallocStack()和 vPortFreeStack()函数；
	configSTACK_ALLOCATION_FROM_SEPARATE_HEAP = 0 时，禁用开启自定义任务栈内存的申请与释放。
默认值：
	#define configSTACK_ALLOCATION_FROM_SEPARATE_HEAP	0

26、configUSE_IDLE_HOOK

说明：
	是否使用空闲任务钩子函数；	
赋值：
	configUSE_IDLE_HOOK = 1 时，使能使用空闲任务钩子函数，且需自定义相关钩子函数；
	configUSE_IDLE_HOOK = 0 时，禁用使用空闲任务钩子函数。
默认值：
	#define configUSE_IDLE_HOOK 					0

27、configUSE_TICK_HOOK

说明：
	是否使用系统时钟节拍中断钩子函数；	
赋值：
	configUSE_TICK_HOOK = 1 时，使能使用系统时钟节拍中断钩子函数，且需自定义相关钩子函数；
	configUSE_TICK_HOOK = 0 时，禁用使用系统时钟节拍中断钩子函数。
默认值：
	#define configUSE_TICK_HOOK						0

28、configCHECK_FOR_STACK_OVERFLOW

说明：
	是否使能栈溢出检测；	
赋值：
	configCHECK_FOR_STACK_OVERFLOW = 1 时，使用栈溢出检测方法1；
	configCHECK_FOR_STACK_OVERFLOW = 2 时，使用栈溢出检测方法2；
	configCHECK_FOR_STACK_OVERFLOW = 0 时，禁用使用栈溢出检测方法。
默认值：
	#define configCHECK_FOR_STACK_OVERFLOW			0

29、configUSE_MALLOC_FAILED_HOOK

说明：
	是否使用动态内存分配失败钩子函数；	
赋值：
	configUSE_MALLOC_FAILED_HOOK = 1 时，使能使用动态内存分配失败钩子函数，且需自定义相关钩子函数；
	configUSE_MALLOC_FAILED_HOOK = 0 时，禁用使用动态内存分配失败钩子函数。
默认值：
	#define configUSE_MALLOC_FAILED_HOOK			0

30、configUSE_DAEMON_TASK_STARTUP_HOOK

说明：
	是否使用定时器服务任务首次执行前的钩子函数；	
赋值：
	configUSE_DEAMON_TASK_STARTUP_HOOK = 1 时，使能使用定时器服务任务首次执行前的钩子函数，且需自定义相关钩子函数；
	configUSE_DEAMON_TASK_STARTUP_HOOK = 0 时，禁用使用定时器服务任务首次执行前的钩子函数。
默认值：
	#define configUSE_DEAMON_TASK_STARTUP_HOOK		0

31、configGENERATE_RUN_TIME_STATS

说明：
	是否使能任务运行时间统计功能；	
赋值：
	configGENERATE_RUN_TIME_STATS = 1 时，使能使能任务运行时间统计功能，且需自定义两个函数：
		portCONFIGURE_TIMER_FOR_RUN_TIME_STATS()，一般是完成定时器的初始化，来配置任务运行时间统计功能；
		portGET_RUN_TIME_COUNTER_VALUE()，用于获取定时器的计时值。
	configGENERATE_RUN_TIME_STATS = 0 时，禁用使能任务运行时间统计功能。
默认值：
	#define configGENERATE_RUN_TIME_STATS			0

32、configUSE_TRACE_FACILITY

说明：
	是否使能可视化跟踪调试；	
赋值：
	configUSE_TRACE_FACILITY = 1 时，使能使能可视化跟踪调试；
	configUSE_TRACE_FACILITY = 0 时，禁用使能可视化跟踪调试。
默认值：
	#define configUSE_TRACE_FACILITY				0

33、configUSE_STATS_FORMATTING_FUNCTIONS

说明：
	是否使能可视化跟踪调试；	
赋值：
	configUSE_STATS_FORMATTING_FUNCTIONS = 1 时，必须configUSE_TRACE_FACILITY = 1，则可以开启vTaskList()和vTaskGetRunTimeStats()函数，使能可视化跟踪调试；
	configUSE_STATS_FORMATTING_FUNCTIONS = 0 时，禁用使能可视化跟踪调试。
默认值：
	#define configUSE_STATS_FORMATTING_FUNCTIONS	0

34、configUSE_TIMERS

说明：
	是否启用软件定时器功能；	
赋值：
	configUSE_TIMERS = 1 时，启用软件定时器功能；
	configUSE_TIMERS = 0 时，不启用软件定时器功能。
默认值：
	#define configUSE_TIMERS						0

35、configTIMER_TASK_PRIORITY

说明：
	设置软件定时器处理任务的优先级；	
赋值：
	configTIMER_TASK_PRIORITY > 0 时，必须configUSE_TIMERS = 1，才可以配置软件定时器优先级；
默认值：
	#define configTIMER_TASK_PRIORITY		        (configMAX_PRIORITIES-1)

36、configTIMER_QUEUE_LENGTH

说明：
	设置软件定时器队列的长度，软件定时器的开启、停止与销毁等操作都是通过队列实现的；	
赋值：
	configTIMER_QUEUE_LENGTH > 0 时，必须configUSE_TIMERS = 1，才可以配置软件定时器队列长度；
默认值：
	#define configTIMER_QUEUE_LENGTH		        5

37、configTIMER_TASK_STACK_DEPTH

说明：
	设置软件定时器处理任务的栈空间大小；	
赋值：
	configTIMER_TASK_STACK_DEPTH > 0 时，必须configUSE_TIMERS = 1，才可以配置软件定时器处理任务的栈空间大小；
默认值：
	#define configTIMER_TASK_STACK_DEPTH	        (configMINIMAL_STACK_SIZE*2)

38、定义中断相关配置

#ifdef __NVIC_PRIO_BITS
	#define configPRIO_BITS       		        		__NVIC_PRIO_BITS
#else
	#define configPRIO_BITS       		        		4                  
#endif
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY			15                      //中断最低优先级
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY	5                       //系统可管理的最高中断优先级
#define configKERNEL_INTERRUPT_PRIORITY 				( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
#define configMAX_SYSCALL_INTERRUPT_PRIORITY 			( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )

39、断言

vAssertCalled(char, int)：辅助配置宏 configASSERT( x )以通过串口打印相关信息；
configASSERT( x )：是FreeRTOS 操作系统的断言，会对表达式x进行判断：当x为假时，断言失败，表明程序出错，于是使用宏 vAssertCalled(char, int)通过串口打印相关的错误信息。

二、“INCLUDE”配置项

说明：
	“INCLUDE”配置项被定义为1时，其对应的API函数则会加入编译；为0时，API函数就不会加入编译，以减少不必要的系统开销；	
	
默认值：
	#define INCLUDE_vTaskPrioritySet	 		1	//设置任务优先级
	#define	INCLUDE_uxTaskPriorityGet 			1	//获取任务优先级
	#define INCLUDE_vTaskDelete 				1	//删除任务
	#define INCLUDE_vTaskSuspend 				1	//挂起任务
	#define INCLUDE_xResumeFromISR 				0	//恢复在中断中挂起的任务
	#define INCLUDE_vTaskDelayUntil 			1	//任务绝对延时
	#define INCLUDE_vTaskDelay 					1	//任务延时
	#define INCLUDE_xTaskGetSchedulerState 		0	//获取任务调度器状态
	#define INCLUDE_xTaskGetCurrentTaskHandle 	0	//获取当前任务的任务句柄
	#define INCLUDE_uxTaskGetStackHighWaterMark 0	//获取任务堆栈历史剩余最小值
	#define INCLUDE_xTaskGetIdleTaskHandle 		0	//获取空闲任务的任务句柄
	#define INCLUDE_eTaskGetState 				1	//获取任务状态
	#define INCLUDE_xEventGroupSetBitFromISR 	0	//在中断中设置事件标志位
	#define INCLUDE_xTimerPendFunctionCall 		1	//将函数的执行挂到定时器服务任务
	#define INCLUDE_xTaskAbortDelay 			0	//中断任务延时
	#define INCLUDE_xTaskGetHandle 				0	//通过任务名获取任务句柄
	#define INCLUDE_xTaskResumeFromISR 			0	//恢复在中断中挂起的任务

三、其他配置项

说明：有三个中断函数已经在FreeRTOS中已经实现，需要重新定义成他们函数！
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler
#define xPortSysTickHandler SysTick_Handler