F4 freeRTOS系统配置文件分析

1.配置文件做用

• 使用配置文件来裁剪freeRTOS的功能,进行个性化配置
• 使用CubeMX的话,ST公司已经默认配置好了环境

2.配置文件详解

2.1配置文件

• 参考文章

• 此处选用freeRTOS官方例程下面的配置文件FreeRTOSConfig.h

/*
 * FreeRTOS Kernel V10.3.1
 * 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.
 *
 * http://www.FreeRTOS.org
 * http://aws.amazon.com/freertos
 *
 * 1 tab == 4 spaces!
 */

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

/*-----------------------------------------------------------
 * Application specific definitions.
 *
 * These definitions should be adjusted for your particular hardware and
 * application requirements.
 *
 * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
 * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE. 
 *
 * See http://www.freertos.org/a00110.html
 *----------------------------------------------------------*/

#define configUSE_PREEMPTION		1
#define configUSE_IDLE_HOOK			0
#define configUSE_TICK_HOOK			0
#define configCPU_CLOCK_HZ			( ( unsigned long ) 72000000 )	
#define configTICK_RATE_HZ			( ( TickType_t ) 1000 )
#define configMAX_PRIORITIES		( 5 )
#define configMINIMAL_STACK_SIZE	( ( unsigned short ) 128 )
#define configTOTAL_HEAP_SIZE		( ( size_t ) ( 17 * 1024 ) )
#define configMAX_TASK_NAME_LEN		( 16 )
#define configUSE_TRACE_FACILITY	0
#define configUSE_16_BIT_TICKS		0
#define configIDLE_SHOULD_YIELD		1

/* Co-routine definitions. */
#define configUSE_CO_ROUTINES 		0
#define configMAX_CO_ROUTINE_PRIORITIES ( 2 )

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

#define INCLUDE_vTaskPrioritySet		1
#define INCLUDE_uxTaskPriorityGet		1
#define INCLUDE_vTaskDelete				1
#define INCLUDE_vTaskCleanUpResources	0
#define INCLUDE_vTaskSuspend			1
#define INCLUDE_vTaskDelayUntil			1
#define INCLUDE_vTaskDelay				1

/* This is the raw value as per the Cortex-M3 NVIC.  Values can be 255
(lowest) to 0 (1?) (highest). */
#define configKERNEL_INTERRUPT_PRIORITY 		255
/* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
#define configMAX_SYSCALL_INTERRUPT_PRIORITY 	191 /* equivalent to 0xb0, or priority 11. */


/* This is the value being used as per the ST library which permits 16
priority values, 0 to 15.  This must correspond to the
configKERNEL_INTERRUPT_PRIORITY setting.  Here 15 corresponds to the lowest
NVIC value of 255. */
#define configLIBRARY_KERNEL_INTERRUPT_PRIORITY	15

#endif /* FREERTOS_CONFIG_H */

• 各项文件描述

参数名称	参数说明	说明
configUSE_PREEMPTION	定义调度器模式	1:抢占,0:协做
configCPU_CLOCK_HZ	定义CPU时钟主频,单位Hz
configTICK_RATE_HZ	定义系统时钟节拍数,即操做系统任务调度的周期	通常取1000Hz,即1ms.osDelay(1000)函数单位就是这个,此处为1000*1ms=1s
configMAX_PRIORITIES	可供用户使用的最大优先级数	若是这个定义的是5,那么用户能够使用的优先级号是0,1,2,3,4,不包含5
configMINIMAL_STACK_SIZE	空闲任务的栈空间大小	单位为字,即4字节
configMAX_TASK_NAME_LEN	任务名最大字符数	末尾的结束符 '\0'也要计算在内
configUSE_16_BIT_TICKS	系统时钟节拍计数使用TickType_t数据类型定义	若是用户使能了宏定义 configUSE_16_BIT_TICKS,那么TickType_t定义的就是16位无符号数，若是没有使能，那么TickType_t定义的就是32位无符号数.对于32位架构的处理器，必定要禁止此宏定义，即设置此宏定义数值为0便可。而16位无符号数类型主要用于8位和16位架构的处理器。
configIDLE_SHOULD_YIELD	使能与空闲任务同优先级的任务	只有知足如下两个条件时,此参数才有效果.(1.使能抢占式调度器;2.有建立与空闲任务同优先级的任务),通常不建议配置,将其配置为0便可
configUSE_MUTEXES	使能互斥锁	1:使能互斥信号量,2:禁止互斥信号量
configUSE_RECURSIVE_MUTEXES	使能递归互斥信号量	1:使能,0:禁止
configUSE_COUNTING_SEMAPHORES	使能计数信号量	1:使能,0:禁止
configQUEUE_REGISTRY_SIZE	设置能够注册的信号量和消息队列个数
configAPPLICATION_TASK_TAG	使能任务标记
configENABLE_BACKWARD_COMPATIBILITY	使能新版本对老版本的兼容特性	1:使能,0:禁止
configUSE_TICKLESS_IDLE	此配置用于使能tickless低功耗模式	1:使能,0:禁止
configUSE_TASK_NOTIFICATIONS	使能任务间直接的消息传递，包含信号量，事件标志组和消息邮箱	1:使能,0:禁止

• 在CubeMX可进行界面配置

• 内存管理

参数名称	参数说明
MEMORY_ALLOCATION	定义内存分配模式
TOTAL_HEAP_SIZE	定义动态内存分配总长度
HEAP_NUMBER	定义动态内存管理方式

• 任务运行信息获取配置

参数名称	参数说明
GENERATE_RUN_TIME_STATS	使能任务运行状态参数统计
USE_TRACE_FACILITY	是否额外添加结构体成员和函数
USE_STATS_FORMATTING_FUNCTIONS	用户配置宏定义,configUSE_TRACE_FACILITY和configUSE_STATS_FORMATTING_FUNCTIONS都为1的时候,将使能函数vTaskList()与vTaskGetRunTimeStats(),两者有一个为0那么这两个函数都将被禁能

• 软件定时器

参数名称	参数说明
USE_TIMERS	使能软件定时器

• 中断优先级

参数名称	参数说明
LIBRARY_LOWEST_INTERRUPT_PRIORITY	配置freeRTOS使用到的SysTick中断和PendSV中断的优先级,在NVIC分组设置为4的状况下,此宏定义范围是0-15,即专门配置抢占优先级.此处配置为0x0f,即SysTick和PendSV都是配置为最低优先级,实际建议配置最低优先级
LIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY	定义了受freeRTOS管理的最高优先级中断

2.2include配置

• 在此须要使能相关函数API,若是不使能那么相关函数将不能使用