硬汉嵌入式论坛

 找回密码
 立即注册
查看: 1111|回复: 2
收起左侧

[FreeRTOS] FreeRTOS这设计,。外部文件不方便引用他的任务控制块定义TCB_t

[复制链接]

1万

主题

6万

回帖

10万

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
106678
QQ
发表于 2023-7-7 08:26:24 | 显示全部楼层 |阅读模式
FreeRTOS 任务控制块结构体定义typedef struct tskTaskControlBlock放在了tasks.c文件里面,这样一来用户的文件如果想引用,非常不方便:

[C] 纯文本查看 复制代码
/*
 * Task control block.  A task control block (TCB) is allocated for each task,
 * and stores task state information, including a pointer to the task's context
 * (the task's run time environment, including register values)
 */
typedef struct tskTaskControlBlock                         /* The old naming convention is used to prevent breaking kernel aware debuggers. */
{
        volatile StackType_t        *pxTopOfStack;        /*< Points to the location of the last item placed on the tasks stack.  THIS MUST BE THE FIRST MEMBER OF THE TCB STRUCT. */

        #if ( portUSING_MPU_WRAPPERS == 1 )
                xMPU_SETTINGS        xMPUSettings;                /*< The MPU settings are defined as part of the port layer.  THIS MUST BE THE SECOND MEMBER OF THE TCB STRUCT. */
        #endif

        ListItem_t                        xStateListItem;        /*< The list that the state list item of a task is reference from denotes the state of that task (Ready, Blocked, Suspended ). */
        ListItem_t                        xEventListItem;                /*< Used to reference a task from an event list. */
        UBaseType_t                        uxPriority;                        /*< The priority of the task.  0 is the lowest priority. */
        StackType_t                        *pxStack;                        /*< Points to the start of the stack. */
        char                                pcTaskName[ configMAX_TASK_NAME_LEN ];/*< Descriptive name given to the task when created.  Facilitates debugging only. */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */

        #if ( ( portSTACK_GROWTH > 0 ) || ( configRECORD_STACK_HIGH_ADDRESS == 1 ) )
                StackType_t                *pxEndOfStack;                /*< Points to the highest valid address for the stack. */
        #endif

        #if ( portCRITICAL_NESTING_IN_TCB == 1 )
                UBaseType_t                uxCriticalNesting;        /*< Holds the critical section nesting depth for ports that do not maintain their own count in the port layer. */
        #endif

        #if ( configUSE_TRACE_FACILITY == 1 )
                UBaseType_t                uxTCBNumber;                /*< Stores a number that increments each time a TCB is created.  It allows debuggers to determine when a task has been deleted and then recreated. */
                UBaseType_t                uxTaskNumber;                /*< Stores a number specifically for use by third party trace code. */
        #endif

        #if ( configUSE_MUTEXES == 1 )
                UBaseType_t                uxBasePriority;                /*< The priority last assigned to the task - used by the priority inheritance mechanism. */
                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;        /*< Stores the amount of time the task has spent in the Running state. */
        #endif

        #if ( configUSE_NEWLIB_REENTRANT == 1 )
                /* Allocate a Newlib reent structure that is specific to this task.
                Note Newlib support has been included by popular demand, but is not
                used by the FreeRTOS maintainers themselves.  FreeRTOS is not
                responsible for resulting newlib operation.  User must be familiar with
                newlib and must provide system-wide implementations of the necessary
                stubs. Be warned that (at the time of writing) the current newlib design
                implements a system-wide malloc() that must be provided with locks. */
                struct        _reent xNewLib_reent;
        #endif

        #if( configUSE_TASK_NOTIFICATIONS == 1 )
                volatile uint32_t ulNotifiedValue;
                volatile uint8_t ucNotifyState;
        #endif

        /* See the comments in FreeRTOS.h with the definition of
        tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE. */
        #if( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE != 0 ) /*lint !e731 !e9029 Macro has been consolidated for readability reasons. */
                uint8_t        ucStaticallyAllocated;                 /*< Set to pdTRUE if the task is a statically allocated to ensure no attempt is made to free the memory. */
        #endif

        #if( INCLUDE_xTaskAbortDelay == 1 )
                uint8_t ucDelayAborted;
        #endif

        #if( configUSE_POSIX_ERRNO == 1 )
                int iTaskErrno;
        #endif

} tskTCB;

/* The old tskTCB name is maintained above then typedefed to the new TCB_t name
below to enable the use of older kernel aware debuggers. */
typedef tskTCB TCB_t;


官方提供的方式是在tasks.c文件末尾做了个宏定义,用户可以添加自己的测试内容。。。。。

[C] 纯文本查看 复制代码
/* Code below here allows additional code to be inserted into this source file,
especially where access to file scope functions and data is needed (for example
when performing module tests). */

#ifdef FREERTOS_MODULE_TEST
        #include "tasks_test_access_functions.h"
#endif


#if( configINCLUDE_FREERTOS_TASK_C_ADDITIONS_H == 1 )

        #include "freertos_tasks_c_additions.h"

        #ifdef FREERTOS_TASKS_C_ADDITIONS_INIT
                static void freertos_tasks_c_additions_init( void )
                {
                        FREERTOS_TASKS_C_ADDITIONS_INIT();
                }
        #endif

#endif

回复

使用道具 举报

1万

主题

6万

回帖

10万

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
106678
QQ
 楼主| 发表于 2023-7-7 11:00:54 | 显示全部楼层
FreeRTOS这设计有点迷,直接将自己的代码放在这个文件末尾了。
回复

使用道具 举报

0

主题

67

回帖

67

积分

初级会员

积分
67
发表于 2023-7-8 09:16:09 | 显示全部楼层
他的早期版本开始,一直是这样的,没有考虑后续版本需求问题。
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|小黑屋|Archiver|手机版|硬汉嵌入式论坛

GMT+8, 2024-4-29 08:39 , Processed in 0.187609 second(s), 25 queries .

Powered by Discuz! X3.4 Licensed

Copyright © 2001-2023, Tencent Cloud.

快速回复 返回顶部 返回列表