FreeRTOS學習記錄--任務創建函數詳解

来源:https://www.cnblogs.com/maxwell-01/archive/2022/04/05/16100999.html
-Advertisement-
Play Games

開局一張圖。一步一步分析就好。 (一)什麼是任務? 在多任務系統中,我們按照功能不同,把整個系統分割成一個個獨立的,且無法返回的函數,這個函數我們稱為任務;任務包含幾個屬性:任務堆棧,任務函數、任務控制塊、任務優先順序;下麵主要介紹一下任務控制塊,其他都比較容易理解。 (二)什麼是任務控制塊? 任務控 ...


開局一張圖。一步一步分析就好。

 

 

 

 

 

 

(一)什麼是任務?

  在多任務系統中,我們按照功能不同,把整個系統分割成一個個獨立的,且無法返回的函數,這個函數我們稱為任務;任務包含幾個屬性:任務堆棧,任務函數、任務控制塊、任務優先順序;下麵主要介紹一下任務控制塊,其他都比較容易理解。

(二)什麼是任務控制塊?

  任務控制塊內包含了該任務的全部信息,任務的執行需要通過任務調度器來控制,那麼任務調度器怎麼“控制”任務實體的呢?就要抓住任務的小辮子---“任務控制塊”,系統對任務的全部操作都可以通過任務控制塊來實現!它是一種特別的數據結構。

  在任務創建函數xTaskCreat()創建任務的時候就會自動給每個任務分配一個任務控制塊。

 

typedef struct tskTaskControlBlock
{
    volatile StackType_t    *pxTopOfStack;    /*任務堆棧棧頂指針*/

    #if ( portUSING_MPU_WRAPPERS == 1 )
        xMPU_SETTINGS    xMPUSettings;        /*MPU相關設置*/
    #endif

    ListItem_t            xStateListItem;        /*狀態列表項,這是一個內置在TCB控制塊中的一個鏈表節點,通過這個節點,將任務掛到其他鏈表中
比如就緒列表,阻塞列表,掛起列表等*/
ListItem_t xEventListItem; /*事件列表項,用於引用事件列表中的任務*/ UBaseType_t uxPriority; /*任務優先順序*/ StackType_t *pxStack; /*任務堆棧起始地址,是一個棧底*/ char pcTaskName[ configMAX_TASK_NAME_LEN ]; /*任務名字*/ #if ( portSTACK_GROWTH > 0 ) StackType_t *pxEndOfStack; /*任務堆棧棧底*/ #endif #if ( portCRITICAL_NESTING_IN_TCB == 1 ) UBaseType_t uxCriticalNesting; /*臨界區嵌套深度*/ #endif #if ( configUSE_TRACE_FACILITY == 1 ) UBaseType_t uxTCBNumber; /*debug的時候用到*/ UBaseType_t uxTaskNumber; /*trace的時候用到*/ #endif #if ( configUSE_MUTEXES == 1 ) UBaseType_t uxBasePriority; /*任務基礎優先順序,優先順序反轉時用到*/ UBaseType_t uxMutexesHeld; /*任務獲取到的互斥信號量個數*/ #endif #if ( configUSE_APPLICATION_TASK_TAG == 1 ) TaskHookFunction_t pxTaskTag; #endif #if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 ) //與本地存儲有關 void *pvThreadLocalStoragePointers[ configNUM_THREAD_LOCAL_STORAGE_POINTERS ]; #endif #if( configGENERATE_RUN_TIME_STATS == 1 ) uint32_t ulRunTimeCounter; /*用來記錄任務運行總時間*/ #endif #if ( configUSE_NEWLIB_REENTRANT == 1 ) struct _reent xNewLib_reent; /*定義一個newlib結構體變數*/ #endif #if( configUSE_TASK_NOTIFICATIONS == 1 ) /*任務通知相關變數*/ volatile uint32_t ulNotifiedValue; /*任務通知值*/ volatile uint8_t ucNotifyState; /*任務通知狀態*/ #endif /* 用來標記任務是動態創建還是靜態創建*/ #if( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE != 0 ) uint8_t ucStaticallyAllocated; /*靜態創建此變數為pdTURE;動態創建此變數為pdFALSE*/ #endif #if( INCLUDE_xTaskAbortDelay == 1 ) uint8_t ucDelayAborted; #endif } tskTCB;

註:#if 開頭的都是條件編譯,咱們可以先不用理解。基本結構如下:

 

 

  

   指針pxStack指向堆棧的起始位置,任務創建時會分配指定數目的任務堆棧,申請堆棧記憶體函數返回的指針就被賦給該變數。

   很多剛接觸FreeRTOS的人會分不清指針pxTopOfStack和pxStack的區別,這裡簡單說一下:pxTopOfStack指向當前堆棧棧頂,隨著進棧出棧,pxTopOfStack指向的位置是會變化的;pxStack指向當前堆棧的起始位置,一經分配後,堆棧起始位置就固定了,不會被改變了。那麼為什麼需要pxStack變數呢,這是因為隨著任務的運行,堆棧可能會溢出,在堆棧向下增長的系統中,這個變數可用於檢查堆棧是否溢出;如果在堆棧向上增長的系統中,要想確定堆棧是否溢出,還需要另外一個變數pxEndOfStack來輔助診斷是否堆棧溢出。

(三)任務是怎麼創建出來的?

  任務有兩種創建方式,動態創建靜態創建,兩者的區別就是: 靜態創建時候任務控制塊和任務堆棧的記憶體是由用戶自己定義的,任務刪除的時候,記憶體不能自動釋放。動態創建,任務堆棧和任務控制塊的記憶體是由系統自動創建的,自動釋放的。

  動態創建任務的函數為 xTaskCreate();

BaseType_t xTaskCreate(  TaskFunction_t    pxTaskCode,        //任務函數的名稱
                        const char * const pcName,            //任務的名稱
                        const uint16_t usStackDepth,          //任務堆棧大小
                        void * const pvParameters,             //任務的形參
                        UBaseType_t uxPriority,                 //任務優先順序
                        TaskHandle_t * const pxCreatedTask )    //  用於傳回一個任務句柄,創建任務後使用這個句柄引用(控制)任務。本質上是一個空指針。
{
    TCB_t *pxNewTCB;
    BaseType_t xReturn;
            
    #define portSTACK_GROWTH    //-1表示滿減棧
    #if( portSTACK_GROWTH > 0 ){
    }
    #else{ /* portSTACK_GROWTH<0  代表堆棧向下增長 */
        StackType_t *pxStack;
        /* 任務棧記憶體分配,stm32是向下增長的堆棧,獲取到的pxStack 是一個棧底的指針*/
        pxStack = ( StackType_t *) pvPortMalloc(((( size_t) usStackDepth ) * sizeof( StackType_t))); 
        if( pxStack != NULL ){
            /* 任務控制塊記憶體分配 */
            pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) ); 
            if( pxNewTCB != NULL ){
                /* 賦值棧地址 */
                pxNewTCB->pxStack = pxStack;
            }
            else{
                /* 釋放棧空間 */
                vPortFree( pxStack );
            }
        }
        else{
            /* 沒有分配成功 */
            pxNewTCB = NULL;
        }
    }
    #endif /* portSTACK_GROWTH */

    if( pxNewTCB != NULL )
    {
        /* 新建任務初始化 */
        prvInitialiseNewTask( pxTaskCode, pcName, ( uint32_t ) usStackDepth, pvParameters, uxPriority, pxCreatedTask, pxNewTCB, NULL );
        /* 把任務添加到就緒列表中 */
        prvAddNewTaskToReadyList( pxNewTCB );
        xReturn = pdPASS;
    }
    else{
        xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY;
    }

    return xReturn;
}

 

之後,又調用了函數 prvInitialiseNewTask()來新建任務初始化。我們看看下麵是如何定義的。

static void prvInitialiseNewTask(TaskFunction_t            pxTaskCode,
                                 const char * const       pcName,
                                 const uint32_t         ulStackDepth,
                                 void * const             pvParameters,
                                 UBaseType_t             uxPriority,
                                 TaskHandle_t * const     pxCreatedTask,
                                 TCB_t *                pxNewTCB,    //任務控制塊
                                 const MemoryRegion_t * const xRegions ){
    StackType_t *pxTopOfStack;
    UBaseType_t x;

    /* 計算棧頂的地址 */
    #if( portSTACK_GROWTH < 0 ){
        /* 把棧空間的高地址分配給棧頂 */
        pxTopOfStack = pxNewTCB->pxStack + ( ulStackDepth - ( uint32_t ) 1 );
        /* 棧對齊----棧要8位元組對齊 */
        pxTopOfStack = (StackType_t *)(((portPOINTER_SIZE_TYPE) pxTopOfStack) & (~((portPOINTER_SIZE_TYPE)portBYTE_ALIGNMENT_MASK))); 
        /* 檢查是否有錯誤 */
        configASSERT((((portPOINTER_SIZE_TYPE) pxTopOfStack & (portPOINTER_SIZE_TYPE) portBYTE_ALIGNMENT_MASK) == 0UL));
    }
    #else /* portSTACK_GROWTH */
    {
    }
    #endif /* portSTACK_GROWTH */

    /* 存儲任務名稱 */
    for( x = ( UBaseType_t ) 0; x < ( UBaseType_t ) configMAX_TASK_NAME_LEN; x++ ){
        pxNewTCB->pcTaskName[ x ] = pcName[ x ];

        if( pcName[ x ] == 0x00 ){
            break;
        }
        else{
            mtCOVERAGE_TEST_MARKER();
        }
    }

    /* \0補齊字元串 */
    pxNewTCB->pcTaskName[ configMAX_TASK_NAME_LEN - 1 ] = '\0';
    /* 判斷任務分配的優先順序,是否大於最大值  如果超過最大值,賦值最大值 */
    if( uxPriority >= ( UBaseType_t ) configMAX_PRIORITIES ){
        uxPriority = ( UBaseType_t ) configMAX_PRIORITIES - ( UBaseType_t ) 1U;
    }
    else{
        mtCOVERAGE_TEST_MARKER();
    }
    /* 賦值任務優先順序到任務控制塊 */
    pxNewTCB->uxPriority = uxPriority;
    /* 任務狀態表 事件表初始化 */
    vListInitialiseItem( &( pxNewTCB->xStateListItem ) );
    vListInitialiseItem( &( pxNewTCB->xEventListItem ) );
    /* 設置任務控制塊中的狀態列表項的成員變數ower ,是屬於PxNewTCB(擁有該結點的內核對象) */
    listSET_LIST_ITEM_OWNER( &( pxNewTCB->xStateListItem ), pxNewTCB );
    /*更改事件列表項中的成員變數xItemValue的值,目的是列表在排列的時候,是按照優先順序由大到小排列 */
    listSET_LIST_ITEM_VALUE( &( pxNewTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) uxPriority ); 
/*設置任務控制塊中事件列表項的成員變數ower,同上*/ listSET_LIST_ITEM_OWNER(
&( pxNewTCB->xEventListItem ), pxNewTCB ); #if( portUSING_MPU_WRAPPERS == 1 ){ } #else{ /* portUSING_MPU_WRAPPERS */ /* 初始化任務堆棧,之後返回任務棧頂 */ pxNewTCB->pxTopOfStack = pxPortInitialiseStack( pxTopOfStack, pxTaskCode, pvParameters ); } #endif /* portUSING_MPU_WRAPPERS */ if( ( void * ) pxCreatedTask != NULL ){ /* 任務句柄指向任務控制塊 */ *pxCreatedTask = ( TaskHandle_t ) pxNewTCB; } else{ mtCOVERAGE_TEST_MARKER(); } }

   prvInitialiseNewTask()函數的形參,出來xTaskCreat()的形參之外,又多出來pxNewTCB和xRegions兩個形參;

後面又調用了 pxPortInitialiseStack(StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters)
來初始化任務堆棧。
StackType_t *pxPortInitialiseStack(StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters){
    pxTopOfStack--;        /* 入棧程式狀態寄存器 */
    *pxTopOfStack = portINITIAL_XPSR;    /* xPSR */
    
    pxTopOfStack--;        /* 入棧PC指針 */
    *pxTopOfStack = ( ( StackType_t ) pxCode ) & portSTART_ADDRESS_MASK;    /* PC */
    
    pxTopOfStack--;        /* 入棧LR鏈接寄存器 */
    *pxTopOfStack = ( StackType_t ) prvTaskExitError;    /* LR */
    
    pxTopOfStack -= 5;    /* 跳過R12, R3, R2 and R1這四個寄存器,不初始化 */
    *pxTopOfStack = ( StackType_t ) pvParameters;    /* R0作為傳參入棧 */
    
    pxTopOfStack--;        /* 保存EXC_RETURN的值,用於退出SVC或PendSV中斷時候,處理器處於什麼狀態*/
    *pxTopOfStack = portINITIAL_EXEC_RETURN;
    
    pxTopOfStack -= 8;    /* 跳過R11, R10, R9, R8, R7, R6, R5 and R4這8個寄存器,不初始化 */
    return pxTopOfStack;    /*最終返回棧頂*/

初始化堆棧完成之後堆棧如下圖:

 

 層層深入完畢,現在我們返回到xTaskCreat()函數後面,看看  prvAddNewTaskToReadyList( pxNewTCB ); 函數是怎麼把任務添加到就緒列表中!

static void prvAddNewTaskToReadyList( TCB_t *pxNewTCB )
{
   
    taskENTER_CRITICAL();
    {
        uxCurrentNumberOfTasks++;
        if( pxCurrentTCB == NULL )   //正在運行的任務塊為NULL,沒有任務運行;
        {
            pxCurrentTCB = pxNewTCB;  //將新任務控制塊賦值給pxCurrentTCB
 
            if( uxCurrentNumberOfTasks == ( UBaseType_t ) 1 ) //為1說明正在創建的任務是第一個任務。
            {
     
                prvInitialiseTaskLists();   //初始化列表,就緒列表、阻塞列表等等
            }
            else
            {
                mtCOVERAGE_TEST_MARKER();
            }
        }
        else
        {
   
            if( xSchedulerRunning == pdFALSE ) //判斷任務調度器是否運行,pdfalse代表沒有運行
            {
                if( pxCurrentTCB->uxPriority <= pxNewTCB->uxPriority )
                {
                    pxCurrentTCB = pxNewTCB;// 將新創建的任務控制塊賦值給當前任務控制塊
                }
                else
                {
                    mtCOVERAGE_TEST_MARKER();
                }
            }
            else
            {
                mtCOVERAGE_TEST_MARKER();
            }
        }
 
        uxTaskNumber++;  // 用於任務控制塊編號
 
        #if ( configUSE_TRACE_FACILITY == 1 )
        {
            pxNewTCB->uxTCBNumber = uxTaskNumber;
        }
        #endif /* configUSE_TRACE_FACILITY */
        traceTASK_CREATE( pxNewTCB );
 
        prvAddTaskToReadyList( pxNewTCB );  //將任務添加到就緒列表
 
        portSETUP_TCB( pxNewTCB ); 
    }
    taskEXIT_CRITICAL();
 
    if( xSchedulerRunning != pdFALSE )  //如果任務調調度器在運行,新任務優先順序比正在運行的優先順序高
    {

        if( pxCurrentTCB->uxPriority < pxNewTCB->uxPriority )
        {
            taskYIELD_IF_USING_PREEMPTION();  //調用此函數完成一次任務切換
        }
        else
        {
            mtCOVERAGE_TEST_MARKER();
        }
    }
    else
    {
        mtCOVERAGE_TEST_MARKER();
    }
}

   一定要耐心分析,別無他法,加油!不難。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 本文實時更新原址:https://ebitencookbook.vercel.app/docs/CookBook_Start/class1 第一課 安裝 Ebiten 歡迎大家來到 Ebiten 中文教程. 今天我們正式開始學習Ebiten的開發. 安裝開發環境 也可以參照官方教程(中文文檔): h ...
  • 安裝pyinstaller,打包python文件 法一 1.打開Windows電腦的cmd(Windows+r)。 2.輸入 pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller (這是順利的情況!) 我自己安裝的時 ...
  • 07-Formatted & File I/O、 I/O steams、 formatted I/O、 fmt functions、 file I/O、 Practice ① I/O、 Always check the err、 Practice ② I/O、 Pra... ...
  • * Properties:屬性集合類。是一個可以和IO流相結合使用的集合類。 * Properties 可保存在流中或從流中載入。屬性列表中每個鍵及其對應值都是一個字元串。 package cn.itcast_08; import java.util.Properties; import java. ...
  • 1.環境準備 1.雲伺服器或者虛擬機 2.Centos 系統 3.下載XFtp 和 XShell 2.安裝Docker 1.首先刪除系統中舊版本Docker或者殘留文件 #卸載所有 yum remove docker \ docker-client \ docker-client-latest \ ...
  • 1.環境準備 環境準備的統一資源提取碼為:1234 1.下載 VMware14中文版 14.1.3 VM14虛擬機 2.下載CentOs系統,建議版本最低7.0+ 3.安裝虛擬機,如果有雲伺服器,就不需要安裝虛擬機了 4.下載XFtp 和 XShell 5.下載Redis在Linux系統下的安裝包, ...
  • 痞子衡嵌入式半月刊: 第 52 期 這裡分享嵌入式領域有用有趣的項目/工具以及一些熱點新聞,農曆年分二十四節氣,希望在每個交節之日準時發佈一期。 本期刊是開源項目(GitHub: JayHeng/pzh-mcu-bi-weekly),歡迎提交 issue,投稿或推薦你知道的嵌入式那些事兒。 上期回顧 ...
  • (一)任務刪除函數詳解 直接上代碼! void vTaskDelete( TaskHandle_t xTaskToDelete ){ TCB_t *pxTCB; taskENTER_CRITICAL(); { /* 獲取要刪除任務的任務控制塊,參數是任務句柄,如果參數為當前正在執行的任務句柄,那麼返 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...