FreeRTOS config开始的宏

素颜马尾好姑娘i 2022-06-08 06:19 28阅读 0赞

FreeRTOSConfig.h系统配置文件中可以自定义，FreeRTOS.h中定义默认值

**configAPPLICATION\_ALLOCATED\_HEAP**  
默认情况下FreeRTOS的堆内存是由编译器来分配的，将宏configAPPLICATION\_ALLOCATED\_HEAP定义为1的话堆内存可以由用户自行设置（heap\_1.c、heap\_2.c、heap\_3.c、heap\_4.c和heap\_5.c）

/* Allocate the memory for the heap. */
    #if( configAPPLICATION_ALLOCATED_HEAP == 1 )
        /* The application writer has already defined the array used for the RTOS
        heap - probably so it can be placed in a special segment or address. */
        extern uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
    #else
        static uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
    #endif /* configAPPLICATION_ALLOCATED_HEAP */

**configASSERT**  
断言，类似 C 标准库中的 assert()函数，调试代码的时候可以检查传入的参数是否合理（调试阶段使用）

#ifndef configASSERT
        #define configASSERT( x )
        #define configASSERT_DEFINED 0
    #else
        #define configASSERT_DEFINED 1
    #endif

**configCHECK\_FOR\_STACK\_OVERFLOW**  
设置堆栈溢出检测，每个任务都有一个任务堆栈。如果使用函数xTaskCreate()创建一个任务的话那么这个任务的堆栈是自动从FreeRTOS的堆（ucHeap）中分配的。如果使用函数xTaskCreateStatic()创建任务的话任务堆栈是由用户设置的，参数pxStackBuffer为任务堆栈，一般是一个数组

使能堆栈检测功能（configCHECK\_FOR\_STACK\_OVERFLOW大于0），而且用户必须提供一个钩子函数（回调函数）。当内核检测到堆栈溢出以后就会调用这个钩子函数

/* Callback function prototypes. --------------------------*/
    #if( configCHECK_FOR_STACK_OVERFLOW > 0 )
        extern void vApplicationStackOverflowHook( TaskHandle_t xTask, char *pcTaskName );
    #endif

`configCHECK_FOR_STACK_OVERFLOW==1`：堆栈溢出检测方法 1。优点就是快  
`configCHECK_FOR_STACK_OVERFLOW==2`：堆栈溢出检测方法 2。能检测到几乎所有的堆栈溢出

**configCPU\_CLOCK\_HZ**  
CPU的频率

#define configCPU_CLOCK_HZ ( ( unsigned long ) 72000000 )

**configSUPPORT\_DYNAMIC\_ALLOCATION**  
1（默认）：在创建FreeRTOS的内核对象的时候所需要的RAM从FreeRTOS的堆中动态获取内存  
0：所需的RAM需要用户自行提供

#ifndef configSUPPORT_DYNAMIC_ALLOCATION
        /* Defaults to 1 for backward compatibility. */
        #define configSUPPORT_DYNAMIC_ALLOCATION 1
    #endif

**configENABLE\_BACKWARD\_COMPATIBILITY**

#ifndef configENABLE_BACKWARD_COMPATIBILITY
        #define configENABLE_BACKWARD_COMPATIBILITY 1
    #endif

#if configENABLE_BACKWARD_COMPATIBILITY == 1
        #define eTaskStateGet eTaskGetState
        #define portTickType TickType_t
        #define xTaskHandle TaskHandle_t
        #define xQueueHandle QueueHandle_t
        #define xSemaphoreHandle SemaphoreHandle_t
        #define xQueueSetHandle QueueSetHandle_t
        #define xQueueSetMemberHandle QueueSetMemberHandle_t
        #define xTimeOutType TimeOut_t
        #define xMemoryRegion MemoryRegion_t
        #define xTaskParameters TaskParameters_t
        #define xTaskStatusType TaskStatus_t
        #define xTimerHandle TimerHandle_t
        #define xCoRoutineHandle CoRoutineHandle_t
        #define pdTASK_HOOK_CODE TaskHookFunction_t
        #define portTICK_RATE_MS portTICK_PERIOD_MS
        #define pcTaskGetTaskName pcTaskGetName
        #define pcTimerGetTimerName pcTimerGetName
        #define pcQueueGetQueueName pcQueueGetName
        #define vTaskGetTaskInfo vTaskGetInfo
    
        /* Backward compatibility within the scheduler code only - these definitions are not really required but are included for completeness. */
        #define tmrTIMER_CALLBACK TimerCallbackFunction_t
        #define pdTASK_CODE TaskFunction_t
        #define xListItem ListItem_t
        #define xList List_t
    #endif /* configENABLE_BACKWARD_COMPATIBILITY */

V8.0.0之前的FreeRTOS中会使用到这些数据类型

**configGENERATE\_RUN\_TIME\_STATS**  
1：开启时间统计功能  
0：关闭时间统计功能

#if ( configGENERATE_RUN_TIME_STATS == 1 )
    
        #ifndef portCONFIGURE_TIMER_FOR_RUN_TIME_STATS /* 初始化一个外设来作为时间统计的基准时钟 */
            #error If configGENERATE_RUN_TIME_STATS is defined then portCONFIGURE_TIMER_FOR_RUN_TIME_STATS must also be defined.  portCONFIGURE_TIMER_FOR_RUN_TIME_STATS should call a port layer function to setup a peripheral timer/counter that can then be used as the run time counter time base.
        #endif /* portCONFIGURE_TIMER_FOR_RUN_TIME_STATS */
    
        #ifndef portGET_RUN_TIME_COUNTER_VALUE /* 返回当前基准时钟的时钟 值 */
            #ifndef portALT_GET_RUN_TIME_COUNTER_VALUE
                #error If configGENERATE_RUN_TIME_STATS is defined then either portGET_RUN_TIME_COUNTER_VALUE or portALT_GET_RUN_TIME_COUNTER_VALUE must also be defined.  See the examples provided and the FreeRTOS web site for more information.
            #endif /* portALT_GET_RUN_TIME_COUNTER_VALUE */
        #endif /* portGET_RUN_TIME_COUNTER_VALUE */
    
    #endif /* configGENERATE_RUN_TIME_STATS */

**configIDLE\_SHOULD\_YIELD**  
1：空闲任务会为处于同等优先级的用户任务让出CPU使用权  
0：空闲任务不会为其他处于同优先级的任务让出CPU使用权  
建议关闭这个功能，因为空闲任务用不了多少时间

#define configIDLE_SHOULD_YIELD 1

**configMAX\_CO\_ROUTINE\_PRIORITIES**  
设置可以分配给协程的最大优先级。协程的优先级可以从0到configMAX\_CO\_ROUTINE\_PRIORITIES-1 ，其中0是最低的优先级

#define configMAX_CO_ROUTINE_PRIORITIES ( 2 )

**configMAX\_PRIORITIES**  
设置任务的优先级数量。同上

#define configMAX_PRIORITIES ( 5 )

**configMAX\_TASK\_NAME\_LEN**  
设置任务名最大长度

#define configMAX_TASK_NAME_LEN ( 16 )

**configMINIMAL\_STACK\_SIZE**  
设置空闲任务的最小任务堆栈大小。以字为单位。比如在STM32上设置为100的话，那么真正的堆栈大小就是100\*4=400字节

#define configMINIMAL_STACK_SIZE ( ( unsigned short ) 128 )

**configNUM\_THREAD\_LOCAL\_STORAGE\_POINTERS**  
设置每个任务的本地存储指针数组大小

#ifndef configNUM_THREAD_LOCAL_STORAGE_POINTERS
        #define configNUM_THREAD_LOCAL_STORAGE_POINTERS 0
    #endif

**configQUEUE\_REGISTRY\_SIZE**  
设置可以注册的队列和信号量的最大数量。在使用内核调试器查看信号量和队列的时候需  
要设置此宏

#ifndef configQUEUE_REGISTRY_SIZE
        #define configQUEUE_REGISTRY_SIZE 0U
    #endif

**configSUPPORT\_STATIC\_ALLOCATION**  
1：在创建一些内核对象的时候需要用户指定RAM  
0：使用heap.c中的动态内存管理函数来自动的申请RAM

#ifndef configSUPPORT_STATIC_ALLOCATION
        /* Defaults to 0 for backward compatibility. */
        #define configSUPPORT_STATIC_ALLOCATION 0
    #endif

**configTICK\_RATE\_HZ**  
设置FreeRTOS的系统时钟节拍频率，单位为HZ

#define configTICK_RATE_HZ ( ( TickType_t ) 1000 )

**configTIMER\_QUEUE\_LENGTH**  
配置FreeRTOS软件定时器。FreeRTOS的软件定时器API函数会通过命令队列向软件定时器任务发送消息，此宏用来设置这个软件定时器的命令队列长度

**configTIMER\_TASK\_PRIORITY**  
设置软件定时器任务的任务优先级

**configTIMER\_TASK\_STACK\_DEPTH**  
设置定时器服务任务的任务堆栈大小

**configTOTAL\_HEAP\_SIZE**  
设置堆大小。如果使用了动态内存管理的话

**configUSE\_16\_BIT\_TICKS**  
设置系统节拍计数器变量数据类型  
1：TickType\_t是16位的  
0：TickType\_t是32位的

#define configUSE_16_BIT_TICKS 0

**configUSE\_CO\_ROUTINES**  
1：启用协程，协程可以节省开销  
0：关闭。建议关闭

#define configUSE_CO_ROUTINES 0

**configUSE\_COUNTING\_SEMAPHORES**  
1：启用计数型信号量

#ifndef configUSE_COUNTING_SEMAPHORES
        #define configUSE_COUNTING_SEMAPHORES 0
    #endif

**configUSE\_IDLE\_HOOK**  
1：使用空闲任务钩子函数。用户需要实现空闲任务钩子函数

#define configUSE_IDLE_HOOK 0

**configUSE\_MALLOC\_FAILED\_HOOK**  
1：使用内存分配失败钩子函数。用户需要实现内存分配失败钩子函数

#ifndef configUSE_MALLOC_FAILED_HOOK
        #define configUSE_MALLOC_FAILED_HOOK 0
    #endif

**configUSE\_MUTEXES**  
1：使用互斥信号量

#ifndef configUSE_MUTEXES
        #define configUSE_MUTEXES 0
    #endif

**configUSE\_PORT\_OPTIMISED\_TASK\_SELECTION**  
选择下一个要运行的任务  
1：硬件的特殊指令  
0：C语言来实现

#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
        #define configUSE_PORT_OPTIMISED_TASK_SELECTION 0
    #endif

**configUSE\_PREEMPTION**  
1：使用抢占式调度器。每个时钟节拍中断中进行任务切换  
0：使用协程。任务切换：

> 一个任务调用了函数 taskYIELD()  
> 一个任务调用了可以使任务进入阻塞态的 API 函数  
> 应用程序明确定义了在中断中执行上下文切换

#define configUSE_PREEMPTION 1

**configUSE\_QUEUE\_SETS**  
1：启用队列集功能

#ifndef configUSE_QUEUE_SETS
        #define configUSE_QUEUE_SETS 0
    #endif

**configUSE\_RECURSIVE\_MUTEXES**  
1：使用递归互斥信号量

#ifndef configUSE_RECURSIVE_MUTEXES
        #define configUSE_RECURSIVE_MUTEXES 0
    #endif

**configUSE\_TASK\_NOTIFICATIONS**  
1：使用任务通知功能

#ifndef configUSE_TASK_NOTIFICATIONS
        #define configUSE_TASK_NOTIFICATIONS 1
    #endif

**configUSE\_TICK\_HOOK**  
1：使能时间片钩子函数。用户需要实现时间片钩子函数

#define configUSE_TICK_HOOK 0

**configUSE\_TICKLESS\_IDLE**  
1：使能低功耗tickless模式

#ifndef configUSE_TICKLESS_IDLE
        #define configUSE_TICKLESS_IDLE 0
    #endif

**configUSE\_TIMERS**  
1：使用软件定时器

#ifndef configUSE_TIMERS
        #define configUSE_TIMERS 0
    #endif

**configUSE\_TIME\_SLICING**  
0：不在时钟节拍中断中执行相同优先级任务的任务切换

#ifndef configUSE_TIME_SLICING
        #define configUSE_TIME_SLICING 1
    #endif

**configUSE\_TRACE\_FACILITY**  
1：启用可视化跟踪调试

#define configUSE_TRACE_FACILITY 0

FreeRTOS config开始的宏

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关【FreeRTOS】FreeRTOS计数信号量

相关 FreeRTOS队列

相关 Spring Cloud Config 使用说明(1) -- 快速开始

相关 FreeRTOS使用

相关 RTX_Config.c 宏定义详解

相关 FreeRTOS高级篇5---FreeRTOS队列分析

相关 FreeRTOS系列第17篇---FreeRTOS队列

相关 FreeRTOS 之二 Tracealyzer for FreeRTOS（FreeRTOS+Trace）详解（源码解析+移植）

相关 FreeRTOS config开始的宏

相关 FreeRTOS 移植