FreeRTOSConfig.h 是 FreeRTOS 中的配置文件，通过配置该文件可以裁剪使用哪些 FreeRTOS 功能。

网站的 FreeRTOSConfig.h 配置文件很大有很多配置选项，但是有很多选项是有默认值的，我们只需配置我们使用的选项即可。

下面是一份 FreeRTOSConfig.h:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
/**
 * @file        : FreeRTOSConfig.h
 * @brief       : FreeRTOS 配置文件
 * @author      : 小土坡
 * @email       : xiaotupo@163.com
 * @version     : V1.0.1
 * @date        : 2024-6-9
 * @license     : 许可
 *
 * @github      : https://github.com/xiaotupo-com
 * @site        : https://xiaotupo.com
 *
 * @note        :
 *
 */

#ifndef __FREERTOS_CONFIG_H
#define __FREERTOS_CONFIG_H

#include "common_inc.h"

#ifdef AT32
#include "at32f413.h"
#endif

#ifdef STM32F1XX
#include "stm32f1xx.h"
#endif

#define configUSE_PREEMPTION 1 /* 1: 使用抢占式调度器，1: 使用合作式调度器 */

/**
 * 钩子函数配置：
 * 钩子函数的主要功能是用于函数的扩展，用户可以根据自己的需要往里面添加相关的测试函数。
 * 1：使能空闲任务钩子函数
 * 0：禁能空闲钩子函数
 */
#define configUSE_IDLE_HOOK 0

/**
 * 配置滴答定时器钩子函数；
 * 1: 使能滴答定时器中断里面执行的钩子函数
 * 0: 禁能滴答定时器里面执行的钩子函数
 */
#define configUSE_TICK_HOOK 1


/**
 * CPU 时钟频率设置：
 * AT32F413 最高 200MHz
 * STM32F1 最高 72MHz
 */
#define configCPU_CLOCK_HZ ((unsigned long)SystemCoreClock)

/**
 * 此参数用于定义系统时钟节拍数，单位Hz，一般取1000Hz即可。
 */
#define configTICK_RATE_HZ ((TickType_t)1000)

/**
 * 此参数用于定义可供用户使用的最大优先级数，如果这个定义的是5，那么用户可以使用的优先级号是0,1,2,3,4，不包含5，对于这一点，初学者要特别的注意。
 */
#define configMAX_PRIORITIES (8)

/**
 * 此参数用于定义空闲任务的栈空间大小，单位字，即4字节。
 */
#define configMINIMAL_STACK_SIZE ((unsigned short)128)

/**
 * 定义堆大小，FreeRTOS内核，用户动态内存申请，任务栈，任务创建，信号量创建，消息队列创建等都需要用这个空间。单位（字）。
 */
#define configTOTAL_HEAP_SIZE ((size_t)(5 * 1024))

/**
 * 定义任务名字的最大长度
 */
#define configMAX_TASK_NAME_LEN (16)

/**
 * 使能此配置将添加额外的结构体成员和函数，以此来协助可视化和**跟踪**
 * 在使用IAR中的FreeRTOS插件时要使能这个配置，否则无法显示任务栈的使用情况。
 * 1: 使能
 * 0: 禁能
 */
#define configUSE_TRACE_FACTLITY 0

/**
 * 系统时钟节拍计数使用TickType_t数据类型定义的。
 * 如果用户使能了宏定义 configUSE_16_BIT_TICKS，那么TickType_t定义的就是16位无符号数，如果没有使能，那么
 * TickType_t定义的就是32位无符号数。对于32位架构的处理器，一定要禁止此宏定义，即设置此宏定义数值为0即可。而16位无符号数类型主要用于8位和16位架构的处理器。
 */
#define configUSE_16_BIT_TICKS 0

/**
 * 定时器配置
 */
 #define configUSE_TIMERS 0                                          /* 1: 启用软件定时器 0: 禁用 */
#define configTIMER_TASK_PRIORITY (configMAX_PRIORITIES - 1)        /* 软件定时器优先级 */
#define configTIMER_QUEUE_LENGTH 5                                  /* 软件定时器队列长度 */
#define configTIMER_TASK_STACK_DEPTH (configMINIMAL_STACK_SIZE * 2) /* 软件定时器任务堆栈大小 */

#define configSUPPORT_DYNAMIC_ALLOCATION 1 // 支持动态分配，默认为 1

/**
 * 此参数用于使能与空闲任务同优先级的任务，只有满足以下两个条件时，此参数才有效果：
 * 1. 使能抢占式调度器。
 * 2. 有创建与空闲任务同优先级的任务。
 * 配置为1，就可以使能此特性了，实际应用中不建议用户使用此功能，将其配置为0即可。
 */
#define configIDLE_SHOULD_YIELD 0

/* Set the following definitions to 1 to include the API function, or zero
to exclude the API function. */

#define INCLUDE_vTaskPrioritySet 1      /* 使能 vTaskPrioritySet() 函数 */
#define INCLUDE_uxTaskPriorityGet 1     /* 使能 uxTaskPriorityGet() 函数*/
#define INCLUDE_vTaskDelete 1           /* 使能 vTaskDelete() 函数 */
#define INCLUDE_vTaskCleanUpResources 0 /* 禁能 vTaskCleanUpResources() 函数 */
#define INCLUDE_vTaskSuspend 1          /* 使能 vTaskSuspend() */
#define INCLUDE_vTaskDelayUntil 1       /* 使能 vTaskDelayUntil() 函数 */
#define INCLUDE_vTaskDelay 1            /* 使能 vTaskDelay() 函数 */
#define INCLUDE_xTaskGetHandle  1       /* 使能 xTaskGetHandle() 函数 */


#ifdef __NVIC_PRIO_BITS // __NVIC_PRIO_BITS 的定义在at32f413.h 中
	#define configPRIO_BITS __NVIC_PRIO_BITS
#else
// 芯片实现的优先级位数 （AT32 为4位）
#define configPRIO_BITS 4
#endif

// 设置 PendSV 和 SysTick 中断的优先级为最低优先级
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 0xF // 配置最低优先级

/* This is the raw value as per the Cortex-M3 NVIC.  Values can be 255
(lowest) to 0 (1?) (highest). */
#define configKERNEL_INTERRUPT_PRIORITY (configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))

#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 2 // 可以在最高为 5 的优先级的中断函数中调用 FreeRTOS 的 API 函数。
#define configMAX_SYSCALL_INTERRUPT_PRIORITY (configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))


/**
 * 此配置用于优化优先级列表中要执行的最高优先级任务的算法。对CM内核的移植文件，
 * 默认已经在文件portmacro.h文件中使能。
 * 0: 通用方式，任务优先级数量不限制，纯C编写，比专用方式效率低
 * 1：专用方式，比通用方式高效，有最大优先级数限制，通常限制为 32
 */
#define configUSE_PORT_OPTIMISED_TASK_SELECTIOIN 1

#define configUSE_TICKLESS_IDLE 0 /* 1: 使能 tickless 低功耗模式，0: 禁能tickless 低功耗模式 */

/**
 * xPortSysTickHandler,vPortSVCHandler,xPortPendSVHandler 是 FreeRTOS 源码中定义的
 * SysTick_Handler，SVC_Handler，PendSV_Handler 是启动文件 startup_stm32f103xe.s 要用的
 * 我们在 STM32CubeMX 的配置中取消了 SysTick_Handler，SVC_Handler，PendSV_Handler 者三个函数代码的生成
 * 这里把重命名了一下
 */
#define xPortSysTickHandler SysTick_Handler
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler

#endif /* __FREERTOS_CONFIG_H end! */