FreeRtos配置文件介绍

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

#include "sys.h"
#include "usart.h"
//针对不同的编译器调用不同的stdint.h文件
#if defined(__ICCARM__) || defined(__CC_ARM) || defined(__GNUC__)
    #include <stdint.h>
    extern uint32_t SystemCoreClock;
#endif

//断言，断言就是在代码中捕捉假设的，断言看作异常处理的高级形式，断言可以表示为一些布尔表达式，在表达式为真的时候启用或者禁止断言
//在测试的时候启用断言，在发布的时候禁止断言
//可以快速查找错误位置

#define vAssertCalled(char,int) printf("Error:%s,%d\r\n",char,int)
#define configASSERT(x) if((x)==0) vAssertCalled(__FILE__,__LINE__)

/***************************************************************************************************************/
/*                                        FreeRTOS基础配置配置选项                                              */
/***************************************************************************************************************/
/*置1:RTOS使用抢占式调度器；置0:ROS使用协作式调度器(时间片)
*
*注:在多任务管理机制上，操作系统可以分为抢占式和协作式两种。
*协作式操作系统是任务主动释放CPU后，切换到下一个任务。
*任务切换的时机完全取决于正在运行的任务
*/
#define configUSE_PREEMPTION                    1               
//1使能时间片调度（默认是使能的）
#define configUSE_TIME_SLICING                    1        

//某些运行FreeRros的硬件有两种方法选择下一个要执行的任务:
//通用方法和特定于硬件的方法(以下简称“特殊方法")。
//通用方法:
//1.confiGUSE PORT OPTIMISED TASK SELECTION 为0 或者硬件不支持这种特殊方法。
//2.可以用于所有FreeRros支持的硬件
//3.完全用c实现，效率略低于特殊方法
//4.不强制要求限制最大可用优先级数目特殊方法:
//特殊方法：
//1.必须将confiqUSE PORT OPTIMISED TASK SELECTION设置为1。
//2.依赖一个或多个特定架构的汇编指令(一般是类似计算前导零[CL2]指令)
//3.比通用方法更高效
//4.一般强制限定最大可用优先级数目为32-般是硬件计算前导零指令，如果所使用的，MCU没有这些硬件指令的话此宏应该设置为0!
#define configUSE_PORT_OPTIMISED_TASK_SELECTION    1                       

//置1:使能低功耗tickless模式；
//置0:保持系统节拍(tick)中断一直运行假设开启低功耗的话可能会导致下载出现问题，因为程序在睡眠中。                                                                                                                                            
#define configUSE_TICKLESS_IDLE                    0                     

//启用队列
#define configUSE_QUEUE_SETS                    1          

//写入实际的CPU内核时钟频率，也就是cpu指令执行频率，通常称为FclkFclk为供给CPU内核的时钟信号，
//我们所说的cpu主频为XXMH，就是指的这个时钟信号，相应的，1/Fc1k即为cpu时钟周期;
#define configCPU_CLOCK_HZ                        (SystemCoreClock)       

//RTOS系统节拍中断的频率，即一秒中断的次数，每次中断RTOS都会进行任务调度，一般配置为100~1000
#define configTICK_RATE_HZ                        (1000)          

//可使用的最大优先级，默认32，官方推荐32，优先级0~31，数值越小优先级越高
#define configMAX_PRIORITIES                    (32)                    

//空闲任务使用堆栈的大小，以下设置表示130x4字节；
//堆栈大小不是以字节为大小，而是以字为大小
#define configMINIMAL_STACK_SIZE                ((unsigned short)130) 

//任务名称字符串的大小 
#define configMAX_TASK_NAME_LEN                    (16)                  

//系统节拍计数器变量数据类型，1表示16为无符号整形，0表示32位无符号整型
#define configUSE_16_BIT_TICKS                    0                       
  
//空闲任务放弃CPU使用权给其他优先级的用户任务，1表示启用抢占式调度，2为用户任务优先级与空闲任务优先级相等，一般为1
#define configIDLE_SHOULD_YIELD                    1                      

//开启任务通知功能，默认开启
//每一个FreeRtos有一个32位的通知值，FreeRtos通知是向任务发送一个事件，并且接收任务的通知值是可以选择的
//他可以有效替换队列，二值信号量，计数信号量、事件组等，使用通知更灵活而且效率高
#define configUSE_TASK_NOTIFICATIONS            1                      

//使用互斥信号量
#define configUSE_MUTEXES                        1                      

//设置可以注册的信号量和消息队列的个数
#define configQUEUE_REGISTRY_SIZE            10
 
//大于0时启用堆栈溢出检测功能，如果使用此功能用户必须提供意个栈溢出钩子函数，
//如果使用的话此值可以为1或者2，因为有两种栈溢出检测方法
#define configCHECK_FOR_STACK_OVERFLOW            0                       
                                                                     
//使用递归互斥信号量                                                                   
#define configUSE_RECURSIVE_MUTEXES                1                      
#define configUSE_MALLOC_FAILED_HOOK            0                       
#define configUSE_APPLICATION_TASK_TAG            0                       
#define configUSE_COUNTING_SEMAPHORES            1                       

/***************************************************************************************************************/
/*                                FreeRTOS与内存相关的配置选项                                              */
/***************************************************************************************************************/
#define configSUPPORT_DYNAMIC_ALLOCATION        1                    
#define configTOTAL_HEAP_SIZE                    ((size_t)(20*1024))    
/***************************************************************************************************************/
/*                                FreeRTOS与钩子函数有关的配置选项                                              */
/***************************************************************************************************************/
/*
置1：使用空闲钩子(Idle Hook类似于回调函数);置0：忽略空闲钩子
空闲任务钩子是一个函数，这个函数由用户来实现，
FreeRros规定了函数的名字和参数:void vapplicationIdleHook(void)，
这个函数在每个空闲任务周期都会被调用
对于已经删除的RTOS任务，空闲任务可以释放分配给它们的堆内存。
因此必须保证空闲任务可以被CPU执行
使用空闲钧子函数设置cPu进入省电模式是很常见的
不可以调用会引起空闲任务阻塞的API函数
*/
#define configUSE_IDLE_HOOK                        0   

/* 置1:使用时间片钩子(rick Hook);置0:忽略时间片钩子

//时间片钩子是一个函数，这个函数由用户来实现，
//FreeRTos规定了函数的名字和参数:void vApplicationrickHook(void)
//时间片中断可以周期性的调用
//函数必须非常短小，不能大量使用堆栈
//不能调用以"FrOmISR"或"FROM ISR"结尾的API函数
//xraskincrementrick函数是在xportsysrickiandler中断函数中被调用的。因此，vpplicationrickHook()函数执行的时间必须很短才行*
*/
#define configUSE_TICK_HOOK                        0                    
/***************************************************************************************************************/
/*                                FreeRTOS与运行时间和任务状态收集有关的配置选项                                */
/***************************************************************************************************************/
//启用运行时间统计功能
#define configGENERATE_RUN_TIME_STATS            0                     
//启用可视化跟踪调试
#define configUSE_TRACE_FACILITY                1
//与宏configUSE_TRACE_FACILITY同时为1时会编译下面3个函数
//prvWriteNameToBuffer()
//vTaskList()
//vTaskGetRunTimeStats()
#define configUSE_STATS_FORMATTING_FUNCTIONS    1                 
                                                                       
                                                                        
/***************************************************************************************************************/
/*                                FreeRTOS与协程有关的配置选项                                                  */
/***************************************************************************************************************/
//启用协程，启用协程以后必须添加文件croutine.c
#define configUSE_CO_ROUTINES                     0         
//协程的有效优先级数目
#define configMAX_CO_ROUTINE_PRIORITIES         ( 2 )                 

/***************************************************************************************************************/
/*                                FreeRTOS与软件定时器有关的配置选项                                           */
/***************************************************************************************************************/
//启用软件定时器
#define configUSE_TIMERS                        1    
//软件定时器优先级
#define configTIMER_TASK_PRIORITY                (configMAX_PRIORITIES-1)       
//软件定时器队列长度
#define configTIMER_QUEUE_LENGTH                5  
//软件定时器任务堆栈的大小
#define configTIMER_TASK_STACK_DEPTH            (configMINIMAL_STACK_SIZE*2)  

/***************************************************************************************************************/
/*                                FreeRTOS可选函数配置选项                                                     */
/***************************************************************************************************************/
#define INCLUDE_xTaskGetSchedulerState          1                       
#define INCLUDE_vTaskPrioritySet                1
#define INCLUDE_uxTaskPriorityGet                1
#define INCLUDE_vTaskDelete                        1
#define INCLUDE_vTaskCleanUpResources            1
#define INCLUDE_vTaskSuspend                    1
#define INCLUDE_vTaskDelayUntil                    1
#define INCLUDE_vTaskDelay                        1
#define INCLUDE_eTaskGetState                    1
#define INCLUDE_xTimerPendFunctionCall            1

/***************************************************************************************************************/
/*                                FreeRTOS与中断有关的配置选项                                                  */
/***************************************************************************************************************/
#ifdef __NVIC_PRIO_BITS
    #define configPRIO_BITS               __NVIC_PRIO_BITS
#else
    #define configPRIO_BITS               4                  
#endif

//中断最低优先级
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY            15 

//系统可管理的最高中断优先级，配置BasePri寄存器，如果设置为5，不响应比这个5更低的优先级
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY    5        

       
//需要配置Systic和PendSV的偏移量
#define configKERNEL_INTERRUPT_PRIORITY         ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )

#define configMAX_SYSCALL_INTERRUPT_PRIORITY     ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )

/***************************************************************************************************************/
/*                                FreeRTOS与中断服务函数有关的配置选项                                     */
/***************************************************************************************************************/
#define xPortPendSVHandler     PendSV_Handler
#define vPortSVCHandler     SVC_Handler

#endif /* FREERTOS_CONFIG_H */