FreeRTOS学习记录2-熟悉FreeRTOSConfig.h文件

刚开始学习FreeRTOS时不建议大家上来就进行移植工作，我是直接参照armfly的教程来的，我觉得先把操作系统用起来，慢慢尝试着在实践当中去体会内核的相关特性，学完之后回过头来再进行移植，那时候已经就能水到渠成了。今天先熟悉下FreeRTOS的FreeRTOSConfig.h文件，进行过移植的朋友应该都知道，源码里面是不包含这个文件的，但是官方在不同平台下已经进行了大量的移植工作，所以我们直接从相关的平台下将FreeRTOS的FreeRTOSConfig.h文件拷贝到过程当中，然后再进行修改。

下面我将每一个配置文件的含义及用法注释一下（注释在上，宏定义在下）：

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H


/***************************************************************************************************************/
/*                                        FreeRTOS基础配置配置选项                                             */
/***************************************************************************************************************/

/* 1使用抢占式内核，0使用协程 */

#define configUSE_PREEMPTION 1

/* 1使能时间片调度(默认式使能的) */

#define configUSE_TIME_SLICING 1

/* 1启用特殊方法来选择下一个要运行的任务  一般是硬件计算前导零指令，如果所使用的MCU没有这些硬件指令的话此宏应该设置为0！*/

#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1           

  

/* 1启用低功耗tickless模式 */

#define configUSE_TICKLESS_IDLE 0          

/* 为1时启用队列 */    

#define configUSE_QUEUE_SETS 1        

/* CPU频率 */     

#define configCPU_CLOCK_HZ (SystemCoreClock)     

 

/* 时钟节拍频率，这里设置为1000，周期就是1ms */

#define configTICK_RATE_HZ  (1000)      

       

/* 可使用的最大优先级 */

#define configMAX_PRIORITIES     (32)       

     

/* 空闲任务使用的堆栈大小 */     

#define configMINIMAL_STACK_SIZE ((unsigned short)130)  

/* 任务名字字符串长度 */

#define configMAX_TASK_NAME_LEN    (16)            

/* 系统节拍计数器变量数据类型，1表示为16位无符号整形，0表示为32位无符号整形 */    
#define configUSE_16_BIT_TICKS 0         

 /* 为1时空闲任务放弃CPU使用权给其他同优先级的用户任务 */    

#define configIDLE_SHOULD_YIELD 1             

/* 为1时开启任务通知功能，默认开启 */ 

#define configUSE_TASK_NOTIFICATIONS            1   

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

/* 不为0时表示启用队列记录，具体的值是可以记录的队列和信号量最大数目。 */   
#define configQUEUE_REGISTRY_SIZE 8                                                                                 

/*大于0时启用堆栈溢出检测功能，如果使用此功能用户必须提供一个栈溢出钩子函数，如果使用的话此值可以为1或者2，因为有两种栈溢出检测方法。  */
#define configCHECK_FOR_STACK_OVERFLOW 0            

/* 为1时使用递归互斥信号量 */
#define configUSE_RECURSIVE_MUTEXES 1            

/* 1使用内存申请失败钩子函数 */  
#define configUSE_MALLOC_FAILED_HOOK 0              

#define configUSE_APPLICATION_TASK_TAG 0       

 /* 为1时使用计数信号量 */               
#define configUSE_COUNTING_SEMAPHORES 1              


/***************************************************************************************************************/
/*                                FreeRTOS与内存申请有关配置选项                                                 */
/***************************************************************************************************************/

/* 支持动态内存申请 */
#define configSUPPORT_DYNAMIC_ALLOCATION         1     

/* 系统所有总的堆大小 */         
#define configTOTAL_HEAP_SIZE ((size_t)(30*1024))  

/***************************************************************************************************************/
/*                                FreeRTOS与钩子函数有关的配置选项                                             */
/***************************************************************************************************************/

/* 1，使用空闲钩子；0，不使用 */
#define configUSE_IDLE_HOOK 0           

/* 1，使用时间片钩子；0，不使用 */   
#define configUSE_TICK_HOOK 0              


/***************************************************************************************************************/
/*                                FreeRTOS与运行时间和任务状态收集有关的配置选项                     */
/***************************************************************************************************************/

/* 为1时启用运行时间统计功能 */
#define configGENERATE_RUN_TIME_STATS         0            

/*为1启用可视化跟踪调试*/  
#define configUSE_TRACE_FACILITY 1              

/* 与宏configUSE_TRACE_FACILITY同时为1时会编译下面3个函数prvWriteNameToBuffer(),vTaskList(),vTaskGetRunTimeStats() */
#define configUSE_STATS_FORMATTING_FUNCTIONS 1              
                                                                        
/***************************************************************************************************************/
/*                                FreeRTOS与协程有关的配置选项                                                     */
/***************************************************************************************************************/

/* 为1时启用协程，启用协程以后必须添加文件croutine.c */
#define configUSE_CO_ROUTINES           0       

/* 协程的有效优先级数目 */       
#define configMAX_CO_ROUTINE_PRIORITIES         ( 2 )        


/***************************************************************************************************************/
/*                                FreeRTOS与软件定时器有关的配置选项                                          */
/***************************************************************************************************************/

/* 为1时启用软件定时器 */
#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     

/* 系统可管理的最高中断优先级（FreeRTOS关闭中断时是采用关某一级以下的中断源，高于此中断的不会被关闭） */                 
#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) )


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


#endif /* FREERTOS_CONFIG_H */