#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H
//針對不同的編譯器調(diào)用不同的stdint.h文件
//并確保stdint只被編譯器使用，不被匯編器使用
#if defined(__ICCARM__) || defined(__CC_ARM) || defined(__GNUC__)
#include <stdint.h>
extern uint32_t SystemCoreClock;
#endif
/***********************************************************************************************************************/
/*                                         FreeRTOS基礎(chǔ)配置配置選項                                                   */
/**********************************************************************************************************************/
//#define configOVERRIDE_DEFAULT_TICK_CONFIGURATION 1 //使用非systick中斷作為調(diào)度時鐘
#define configUSE_PREEMPTION                    1   //置1：RTOS使用搶占式調(diào)度器；置0：RTOS使用協(xié)作式調(diào)度器（時間片）
/* 注：
* 在多任務(wù)管理機(jī)制上，操作系統(tǒng)可以分為搶占式和協(xié)作式兩種。
* 搶占式：根據(jù)任務(wù)的優(yōu)先級，優(yōu)先級高的任務(wù)就緒后，獲取CPU的使用權(quán)。
* 協(xié)作式：任務(wù)主動釋放CPU后，切換到下一個任務(wù)。
*/
#define configUSE_TIME_SLICING					1	//1：使能時間片調(diào)度(默認(rèn)是使能的)
/* 注：
* 為了實現(xiàn)時間片輪轉(zhuǎn)調(diào)度，系統(tǒng)把所有就緒進(jìn)程按先入先出的原則排成一個隊列。新來的進(jìn)程加到就緒隊列末尾。
* 每當(dāng)執(zhí)行進(jìn)程調(diào)度時，進(jìn)程調(diào)度程序總是選出就緒隊列的隊首進(jìn)程，讓它在CPU上運行一個時間片的時間。
* 當(dāng)進(jìn)程用完分給它的時間片后，系統(tǒng)的計時器發(fā)出時鐘中斷，調(diào)度程序便停止該進(jìn)程的運行，把它放入就緒隊列的末尾；
* 然后，把CPU分給就緒隊列的隊首進(jìn)程，同樣也讓它運行一個時間片，如此往復(fù)。
*/
#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1   //1：使用特殊方法選擇下一個要執(zhí)行的任務(wù)（硬件支持）
/* 注：
* 某些運行FreeRTOS的硬件有兩種方法選擇下一個要執(zhí)行的任務(wù)：通用方法和特定于硬件的方法（以下簡稱“特殊方法”）。
* 通用方法：
*      1.configUSE_PORT_OPTIMISED_TASK_SELECTION 為 0 或者硬件不支持這種特殊方法。
*      2.可以用于所有FreeRTOS支持的硬件
*      3.完全用C實現(xiàn)，效率略低于特殊方法。
*      4.不強(qiáng)制要求限制最大可用優(yōu)先級數(shù)目
* 特殊方法：
*      1.必須將configUSE_PORT_OPTIMISED_TASK_SELECTION設(shè)置為1。
*      2.依賴一個或多個特定架構(gòu)的匯編指令（一般是類似計算前導(dǎo)零[CLZ]指令）。
*      3.比通用方法更高效
*      4.一般強(qiáng)制限定最大可用優(yōu)先級數(shù)目為32
* 一般是硬件計算前導(dǎo)零指令，如果所使用的，MCU沒有這些硬件指令的話此宏應(yīng)該設(shè)置為0！
*/
#define configUSE_TICKLESS_IDLE                 0   //0：不啟用低功耗tickless模式
/* 注：
* 置1：使能低功耗tickless模式；置0：保持系統(tǒng)節(jié)拍（tick）中斷一直運行
*
* 假設(shè)開啟低功耗的話可能會導(dǎo)致下載出現(xiàn)問題，因為程序在睡眠中,可用以下辦法解決
* 下載方法：
*      1.將開發(fā)版正常連接好
*      2.按住復(fù)位按鍵，點擊下載瞬間松開復(fù)位按鍵
*
*      1.通過跳線帽將 BOOT 0 接高電平(3.3V)
*      2.重新上電，下載
*
* 			1.使用FlyMcu擦除一下芯片，然后進(jìn)行下載
*			STMISP -> 清除芯片(z)
*/
#define configUSE_QUEUE_SETS                     1  //1：啟用隊列集合
/* 注：
* 隊列集合：用于對多個隊列以及信號量進(jìn)行“監(jiān)聽”，
* 只要其中不管哪一個有消息到來，都可以讓任務(wù)退出阻塞狀態(tài)。
*/
#define configCPU_CLOCK_HZ                      (SystemCoreClock) //CPU頻率
/* 注：
* 寫入實際的CPU內(nèi)核時鐘頻率，也就是CPU指令執(zhí)行頻率，通常稱為Fclk
* Fclk為供給CPU內(nèi)核的時鐘信號，我們所說的cpu主頻為 XX MHz，
* 就是指的這個時鐘信號，相應(yīng)的，1/Fclk即為cpu時鐘周期；
*/
#define configTICK_RATE_HZ                      (( TickType_t )1000) //時鐘節(jié)拍頻率1000HZ，周期就是1ms
/* 注：
* RTOS系統(tǒng)節(jié)拍中斷的頻率。
* 即一秒中斷的次數(shù)，每次中斷RTOS都會進(jìn)行任務(wù)調(diào)度
*/
#define configMAX_PRIORITIES                    (32)  //可使用的最大優(yōu)先級
/* 注：
* 設(shè)置任務(wù)優(yōu)先級時，數(shù)字越小，優(yōu)先級越高
*/
#define configMINIMAL_STACK_SIZE                ((unsigned short)128)   //空閑任務(wù)使用的堆棧大小
/* 注：
* 空閑任務(wù)就是CPU無事可做的時候，操作系統(tǒng)為了不讓CPU閑著，強(qiáng)行讓它做的一個任務(wù)
* 空閑任務(wù)是FreeRTOS不可缺少的任務(wù)，因為FreeRTOS設(shè)計要求必須至少有一個任務(wù)處于運行狀態(tài)。
*/
#define configMAX_TASK_NAME_LEN					(16)    //任務(wù)名字字符串的長度
#define configUSE_16_BIT_TICKS					0       //系統(tǒng)節(jié)拍計數(shù)器變量的數(shù)據(jù)類型，
//1表示為16位無符號整形，0表示為32位無符號整形
#define configIDLE_SHOULD_YIELD					1       //1：空閑任務(wù)放棄CPU使用權(quán)給其他同優(yōu)先級的用戶任務(wù)
#define configUSE_TASK_NOTIFICATIONS            1       //1：開啟任務(wù)通知功能，默認(rèn)開啟
#define configUSE_MUTEXES                       1       //1：使用互斥信號量
#define configQUEUE_REGISTRY_SIZE				8       //設(shè)置可以注冊的信號量和消息隊列個數(shù)
#define configCHECK_FOR_STACK_OVERFLOW			0       //不使用堆棧溢出檢測功能
/* 注：
* 大于0時啟用堆棧溢出檢測功能，如果使用此功能
* 用戶必須提供一個棧溢出鉤子函數(shù)，如果使用的話
* 此值可以為1或者2，因為有兩種棧溢出檢測方法 */
#define configUSE_RECURSIVE_MUTEXES			    1       //1：使用遞歸互斥信號量
#define configUSE_COUNTING_SEMAPHORES		    1       //1：使用計數(shù)信號量
#define configUSE_APPLICATION_TASK_TAG		    0       //不可為任務(wù)分配標(biāo)簽（默認(rèn)不可）
/*****************************************************************
FreeRTOS與內(nèi)存申請有關(guān)配置選項
*****************************************************************/
#define configSUPPORT_DYNAMIC_ALLOCATION        1       //支持動態(tài)內(nèi)存申請
#define configTOTAL_HEAP_SIZE					((size_t)(32*1024)) //系統(tǒng)所有總的堆大小
/***************************************************************
FreeRTOS與鉤子函數(shù)有關(guān)的配置選項
**************************************************************/
#define configUSE_IDLE_HOOK						0   //置1：使用空閑鉤子；置0：忽略空閑鉤子
/* 注：
* 空閑任務(wù)鉤子是一個函數(shù)，這個函數(shù)由用戶來實現(xiàn)，
* FreeRTOS規(guī)定了函數(shù)的名字和參數(shù)：void vApplicationIdleHook(void )，
* 這個函數(shù)在每個空閑任務(wù)周期都會被調(diào)用
* 對于已經(jīng)刪除的RTOS任務(wù)，空閑任務(wù)可以釋放分配給它們的堆棧內(nèi)存。
* 因此必須保證空閑任務(wù)可以被CPU執(zhí)行
* 使用空閑鉤子函數(shù)設(shè)置CPU進(jìn)入省電模式是很常見的
* 不可以調(diào)用 會引起空閑任務(wù)阻塞 的API函數(shù)
*/
#define configUSE_TICK_HOOK			            0   //置1：使用時間片鉤子；置0：忽略時間片鉤子
/* 注：
* 時間片鉤子是一個函數(shù)，這個函數(shù)由用戶來實現(xiàn)，
* FreeRTOS規(guī)定了函數(shù)的名字和參數(shù)：void vApplicationTickHook(void )
* 時間片中斷可以周期性的調(diào)用
* 函數(shù)必須非常短小，不能大量使用堆棧，
* 不能調(diào)用以”FromISR" 或 "FROM_ISR”結(jié)尾的API函數(shù)
*/
/*xTaskIncrementTick函數(shù)是在xPortSysTickHandler中斷函數(shù)中被調(diào)用的。因此，vApplicationTickHook()函數(shù)執(zhí)行的時間必須很短才行*/
//使用內(nèi)存申請失敗鉤子函數(shù)
#define configUSE_MALLOC_FAILED_HOOK			0   //不使用內(nèi)存申請失敗鉤子函數(shù)
/********************************************************************
FreeRTOS與運行時間和任務(wù)狀態(tài)收集有關(guān)的配置選項
**********************************************************************/
#define configGENERATE_RUN_TIME_STATS	        0  //不啟用運行時間統(tǒng)計功能(一般調(diào)試的使用用)
#define configUSE_TRACE_FACILITY		        1  //啟用可視化跟蹤調(diào)試
#define configUSE_STATS_FORMATTING_FUNCTIONS	1
/* 與宏configUSE_TRACE_FACILITY同時為1時會編譯下面3個函數(shù)
* prvWriteNameToBuffer()
* vTaskList(),
* vTaskGetRunTimeStats()
*/
/********************************************************************
FreeRTOS與協(xié)程有關(guān)的配置選項
*********************************************************************/
#define configUSE_CO_ROUTINES 	                0       //1：啟用協(xié)程，啟用協(xié)程以后必須添加文件croutine.c
#define configMAX_CO_ROUTINE_PRIORITIES         ( 2 )   //協(xié)程的有效優(yōu)先級數(shù)目
/***********************************************************************
FreeRTOS與軟件定時器有關(guān)的配置選項
**********************************************************************/
#define configUSE_TIMERS	                    1   //1：啟用軟件定時器
#define configTIMER_TASK_PRIORITY		        ( 2 )       //設(shè)置軟件定時器優(yōu)先級
#define configTIMER_QUEUE_LENGTH		        10          //軟件定時器隊列長度
#define configTIMER_TASK_STACK_DEPTH	        (configMINIMAL_STACK_SIZE*2)    //軟件定時器任務(wù)堆棧大小
/************************************************************
FreeRTOS可選函數(shù)配置選項
************************************************************/
#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
#define INCLUDE_uxTaskGetStackHighWaterMark     1
#define INCLUDE_xTaskGetHandle                  1
/******************************************************************
FreeRTOS與中斷有關(guān)的配置選項
******************************************************************/
#ifdef __NVIC_PRIO_BITS
#define configPRIO_BITS       		__NVIC_PRIO_BITS
#else
#define configPRIO_BITS       		4
#endif
//由于STM32是4位的中斷優(yōu)先級控制，所以此處為4（不同的MCU不同）
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY			15     //中斷最低優(yōu)先級
//4位優(yōu)先級全部分組給主優(yōu)先級，所以總共有16位優(yōu)先級配置：0-15--優(yōu)先級最低的為15
//不同的MCU不同
#define configKERNEL_INTERRUPT_PRIORITY 		( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )	/* 240 */
//設(shè)置內(nèi)核中斷優(yōu)先級，這個宏是用來設(shè)置PendSV和滴答定時器的中斷優(yōu)先級的，port.c中使用到
//此處的左移四位的原因是：STM32采用的是從MSB開始的高四位作為優(yōu)先級配置
//其實這個宏定義可以簡化成：#define configKERNEL_INTERRUPT_PRIORITY 0xF0
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY	5      //設(shè)置系統(tǒng)可管理的最大優(yōu)先級
//這個就是 BASEPRI 寄存器說的那個閾值優(yōu)先級，這里我設(shè)置為了 5。
//也就是高于 5 的優(yōu)先級(優(yōu)先級數(shù)小于 5)不歸 FreeRTOS 管理！
//這個是給人看的，下面一個宏是給系統(tǒng)看的
#define configMAX_SYSCALL_INTERRUPT_PRIORITY 	( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
//此處需要左移四位的原因：同上
//低于此優(yōu)先級的中斷可以安全的調(diào)用 FreeRTOS 的 API 函數(shù)，高于此優(yōu)先級的中斷 FreeRTOS 是不能禁止的，
//中斷服務(wù)函數(shù)也不能調(diào)用 FreeRTOS 的 API 函數(shù)！
//也就是：#define configMAX_SYSCALL_INTERRUPT_PRIORITY  0x50
/*
*	以上配置的結(jié)果就是：
*	優(yōu)先級為0-4的中斷  不會被FreeRTOS禁止，不會因為執(zhí)行FreeRTOS內(nèi)核而延時，中斷不可調(diào)用FreeRTOS的API函數(shù)
*	優(yōu)先級為5-15的中斷 能夠被FreeRTOS禁止，可以調(diào)用以 FromISR 結(jié)尾的FreeRTOS API函數(shù)，并且它們可以中斷嵌套
* 	所以：不掉用任何FreeRTOS API的中斷可以使用所有的中斷優(yōu)先級，并且它們可以中斷嵌套
*	那些對實時性要求嚴(yán)格的任務(wù)就可以使用0-4的優(yōu)先級，比如四軸飛行器中的壁障檢測
*/
/****************************************************************
FreeRTOS與中斷服務(wù)函數(shù)有關(guān)的配置選項
****************************************************************/
#define xPortPendSVHandler 	PendSV_Handler
#define vPortSVCHandler 	SVC_Handler
//#define xPortSysTickHandler SysTickHandler 自行在delay.c函數(shù)中實現(xiàn)
#endif /* FREERTOS_CONFIG_H */