第三章 FreeRTOSConfig.h 配置文件解读

原创已于 2025-07-09 11:02:20 修改 · 209 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#嵌入式 #freeRtos

于 2025-07-07 15:08:43 首次发布

FreeRTOSConfig.h 配置文件作用：对FreeRTOS的功能进行配置和裁剪，以及API函数的使能等。

官网中文说明：https://www.freertos.org/zh-cn-cmn-s/a00110.html

整体的配置项可以分为三类：

INCLUDE开头：一般是“INCLUDE_函数名”，函数的使能，1表示可用，0表示禁用。
config开头：FreeRTOS的一些功能配置，比如基本配置、内存配置、钩子配置、中断配置等。

其他配置：PendSV宏定义、SVC宏定义

/*
 * FreeRTOS V202212.01
 * Copyright (C) 2020 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of
 * this software and associated documentation files (the "Software"), to deal in
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 * the Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 * https://www.FreeRTOS.org
 * https://github.com/FreeRTOS
 *
 */

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H
 /*-----------------------------------------------------------
  * 调度器基础配置
  *----------------------------------------------------------*/
#include "gd32f30x.h"
extern uint32_t SystemCoreClock;



/* 1: 抢占式调度器, 0: 协程式调度器*/
#define configUSE_PREEMPTION		1
/* 1: 使用硬件计算下一个要运行的任务（硬件） 0:使用软件算法计算下一个要运行的任务（通用的方式） - 效率较低  */
#define configUSE_PORT_OPTIMISED_TASK_SELECTION         1

/* 是否使用空闲任务钩子函数（空闲任务循环中执行的用户代码） */
#define configUSE_IDLE_HOOK			0
/* 是否使用滴答定时器钩子函数（每个滴答中断中执行的用户代码） */
#define configUSE_TICK_HOOK			0
/* CPU时钟频率（Hz），直接使用系统时钟变量 */
#define configCPU_CLOCK_HZ			SystemCoreClock

/* 定义SysTick时钟频率，只有当SysTick时钟频率与内核时钟频率不同时才可以定义,单位: Hz, 默认: 不定义 */
//#define configSYSTICK_CLOCK_HZ    (configCPU_CLOCK_HZ / 8)

/* 滴答定时器的中断频率（Hz），决定了系统时钟精度 */
#define configTICK_RATE_HZ			( ( TickType_t ) 1000 )
/*
定义任务优先级的最大值  ARM32的最大优先级为32  0-32 值越大优先级越大
每个可用优先级都会占用 RTOS 内核中的一些 RAM，因此不应将此值设置得高于应用程序 实际需要的数量。
*/
#define configMAX_PRIORITIES		( 6 )

/*
空闲任务的栈空间大小 以字为单位 而不是字节
针对 Cortex-M3/M4 内核（32 位架构） 1 个字 = 32 位 = 4 字节
这里的 128 表示 128 个字（Word），每个字占 4 字节，因此实际栈空间为 512 字节。
设置空闲任务的任务栈的作用？
    处理上下文切换、中断嵌套等内核操作
    若应用中使用 vTaskDelete()，被删除任务的清理工作也在空闲任务中执行
*/
#define configMINIMAL_STACK_SIZE	( ( unsigned short ) 128 )


/* FreeRTOS堆内存大小（17KB），用于动态创建任务、队列等 */
#define configTOTAL_HEAP_SIZE		( ( size_t ) ( 17 * 1024 ) )
/* 定义任务名最大字符数, 默认: 16 */
#define configMAX_TASK_NAME_LEN		( 16 )
/* 是否启用可视化跟踪调试功能 */
#define configUSE_TRACE_FACILITY	0

/* 1:使用16位滴答定时器 0: 使用32位滴答定时器  */
#define configUSE_16_BIT_TICKS		0
/*当宏 configIDLE_SHOULD_YIELD 设置为 1 时，在抢占调度下，同等优先级的任务可抢占 空闲任务，并延用空闲任务剩余的时间片。 */
#define configIDLE_SHOULD_YIELD		1

/*
1: 使能任务间直接的消息传递,包括信号量、事件标志组和消息邮箱  默认: 0
 当开启任务通 知功能后，每个任务将多占用 8 字节的内存空间。
*/
#define configUSE_TASK_NOTIFICATIONS                    0
 /* 1: 使能互斥信号量, 默认: 0 */
#define configUSE_MUTEXES                               0
/* 1: 使能递归互斥信号量, 默认: 0 */
#define configUSE_RECURSIVE_MUTEXES                     0
/* 1: 使能计数信号量, 默认: 0 */
#define configUSE_COUNTING_SEMAPHORES                   0
/* 1: 使能队列集, 默认: 0 */
#define configUSE_QUEUE_SETS                            1
/* 1: 使能时间片调度, 默认: 1 */
#define configUSE_TIME_SLICING                          1
/* 定义任务堆栈深度的数据类型, 默认: uint16_t */
#define configSTACK_DEPTH_TYPE                          uint16_t
/* 1: 使能软件定时器, 默认: 0 */
#define configUSE_TIMERS                                1
/* 定义软件定时器任务的优先级, 无默认configUSE_TIMERS为1时需定义 */
#define configTIMER_TASK_PRIORITY                       ( configMAX_PRIORITIES - 1 )
/*设置软件定时器命令队列的长度*/
#define configTIMER_QUEUE_LENGTH                            10
/*设置分配给软件定时器服务/守护进程任务的堆栈深度*/
#define configTIMER_TASK_STACK_DEPTH                        configMINIMAL_STACK_SIZE
/*-----------------------------------------------------------
 * API函数包含配置
 * 控制哪些FreeRTOS API函数会被编译进最终代码
 *----------------------------------------------------------*/

#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()函数 */

 /*-----------------------------------------------------------
  * 中断优先级配置
  * 注意： Cortex-M3/M4内核使用4位中断优先级，数值越小优先级越高
  *----------------------------------------------------------*/

#ifdef __NVIC_PRIO_BITS
#define configPRIO_BITS __NVIC_PRIO_BITS
#else
#define configPRIO_BITS 4
#endif

/* 中断最低优先级 */
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY       15   
/* FreeRTOS可管理的最高中断优先级 */
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY  5 
//  将中断优先级值转换为NVIC原始值（8位）  计算公式：优先级值 << (8 - 有效位数)
#define configKERNEL_INTERRUPT_PRIORITY         						( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
#define configMAX_SYSCALL_INTERRUPT_PRIORITY      				  ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )


#ifdef SYS_SUPPORT_OS
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler
#define xPortSysTickHandler SysTick_Handler
#endif
#endif /* FREERTOS_CONFIG_H */