RT-thread内核之对象管理系统源码分析

 1 /**
 2  * Base structure of Kernel object
 3  */
 4 struct rt_object
 5 {
 6     char       name[RT_NAME_MAX]; /*对象名称，RT_NAME_MAX在rtconfig.h中定义 */
 7     rt_uint8_t type; /*内核对象类型*/                                  
 8     rt_uint8_t flag; /*内核对象标志*/
 9 
10 #ifdef RT_USING_MODULE
11     void      *module_id; /*应用模块ID  */
12 #endif
13     rt_list_t  list; /*内核对象链表节点 */
14 };
15 typedef struct rt_object *rt_object_t; 

struct rt_list_node
{
    struct rt_list_node *next;  /*指向下一节点  */
    struct rt_list_node *prev;  /*指向前一节点  */
};
typedef struct rt_list_node rt_list_t; 
可以看出每个内核对象链表节点的结构体都包括的下一内核对象节点和前一内核对象节点                

 1 /**
 2  *  The object type can be one of the follows with specific
 3  *  macros enabled:
 4  *  - Thread
 5  *  - Semaphore
 6  *  - Mutex
 7  *  - Event
 8  *  - MailBox
 9  *  - MessageQueue
10  *  - MemHeap
11  *  - MemPool
12  *  - Device
13  *  - Timer
14  *  - Module
15  *  - Unknown
16  *  - Static
17  */
18 enum rt_object_class_type
19 {
20     RT_Object_Class_Thread = 0,   /*线程*/
21 #ifdef RT_USING_SEMAPHORE
22     RT_Object_Class_Semaphore,  /*信号量*/
23 #endif
24 #ifdef RT_USING_MUTEX
25     RT_Object_Class_Mutex,  /*互斥锁 */
26 #endif
27 #ifdef RT_USING_EVENT
28     RT_Object_Class_Event,   /*事件*/
29 #endif
30 #ifdef RT_USING_MAILBOX
31     RT_Object_Class_MailBox,   /*邮箱 */
32 #endif
33 #ifdef RT_USING_MESSAGEQUEUE
34     RT_Object_Class_MessageQueue,   /*消息队列 */
35 #endif
36 #ifdef RT_USING_MEMHEAP
37     RT_Object_Class_MemHeap,  /*内存堆 */
38 #endif
39 #ifdef RT_USING_MEMPOOL
40     RT_Object_Class_MemPool,  /*内存池 */
41 #endif
42 #ifdef RT_USING_DEVICE
43     RT_Object_Class_Device,  /*设备驱动 */
44 #endif
45     RT_Object_Class_Timer,  /*定时器 */
46 #ifdef RT_USING_MODULE
47     RT_Object_Class_Module,  /*模块 */
48 #endif
49     RT_Object_Class_Unknown,  /*未知类型，用于内核对象容器数组rt_object_container[RT_Object_Class_Unknown]中，表示当前所有使用的对象类型总数*/
50     RT_Object_Class_Static = 0x80  /*rt-thread以此位标志是否为系统内核对象*/
51 };

/**
 * The information of the kernel object
 */
struct rt_object_information
{
    enum rt_object_class_type type; /*内核对象类型  */
    rt_list_t  object_list; /*内核对象链表，该链表中包含同一类型的所有内核对象节点。内核对象静态（动态）初始化与脱离（删除）时，会在该链表中增加或移除相应内核对象节点*/
    rt_size_t  object_size; /*内核对象所占的大小 */
};

#define _OBJ_CONTAINER_LIST_INIT(c)     \    //内核对象容器的链表节点初始化,这里用一个宏来定义,链表起始节点的前一节点和后一节点在初始化时都指向该起始节点地址 
    {&(rt_object_container[c].object_list), &(rt_object_container[c].object_list)}

//内核对象管理系统,这里用rt_object_information数组来实现
struct rt_object_information rt_object_container[RT_Object_Class_Unknown] =
{
    /* initialize object container - thread *///线程对象信息
    {RT_Object_Class_Thread, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Thread), sizeof(struct rt_thread)},
#ifdef RT_USING_SEMAPHORE
    /* initialize object container - semaphore *///信号量对象信息  
    {RT_Object_Class_Semaphore, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Semaphore), sizeof(struct rt_semaphore)},
#endif
#ifdef RT_USING_MUTEX
    /* initialize object container - mutex *///互斥锁对象信息  
    {RT_Object_Class_Mutex, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Mutex), sizeof(struct rt_mutex)},
#endif
#ifdef RT_USING_EVENT
    /* initialize object container - event *///事件对象信息  
    {RT_Object_Class_Event, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Event), sizeof(struct rt_event)},
#endif
#ifdef RT_USING_MAILBOX
    /* initialize object container - mailbox *///邮箱对象信息  
    {RT_Object_Class_MailBox, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_MailBox), sizeof(struct rt_mailbox)},
#endif
#ifdef RT_USING_MESSAGEQUEUE
    /* initialize object container - message queue *///消息队列对象信息  
    {RT_Object_Class_MessageQueue, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_MessageQueue), sizeof(struct rt_messagequeue)},
#endif
#ifdef RT_USING_MEMHEAP
    /* initialize object container - memory heap *///内存堆对象信息  
    {RT_Object_Class_MemHeap, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_MemHeap), sizeof(struct rt_memheap)},
#endif
#ifdef RT_USING_MEMPOOL
    /* initialize object container - memory pool *///内存池对象信息  
    {RT_Object_Class_MemPool, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_MemPool), sizeof(struct rt_mempool)},
#endif
#ifdef RT_USING_DEVICE
    /* initialize object container - device *///设备驱动对象信息  
    {RT_Object_Class_Device, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Device), sizeof(struct rt_device)},
#endif
    /* initialize object container - timer *///时钟对象信息
    {RT_Object_Class_Timer, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Timer), sizeof(struct rt_timer)},
#ifdef RT_USING_MODULE
    /* initialize object container - module *///模块对象信息  
    {RT_Object_Class_Module, _OBJ_CONTAINER_LIST_INIT(RT_Object_Class_Module), sizeof(struct rt_module)},
#endif
};

静态初始化：
对象初始化，实现上就是把对象放入到其相应的对象容器中，即将对象插入到对象容器链表中。
void rt_object_init(struct rt_object *object, enum rt_object_class_type type,const char *name)
动态初始化：
动态初始化首先要在rtconfig.h中定义RT_USING_HEAP宏。使用以上接口，首先根据对象类型来获取对象信息，然后从内存堆中分配对象所需内存空间，然后对该对象进行必要的初始化，最后将其插入到它所在的对象容器链表中。
rt_object_t rt_object_allocate(enum rt_object_class_type type, const char *name)

脱离：
使用该接口后，静态内核对象将从内核对象管理器中脱离，对象占用的内存不会被释放。
void rt_object_detach(rt_object_t object)
删除：
使用以上接口时，首先从对象容器中脱离对象，然后释放对象所占用的内存。
void rt_object_delete(rt_object_t object)

rt_bool_t rt_object_is_systemobject(rt_object_t object)
通常采用rt object init方式挂接到内核对象管理器中的对象是系统对象。

rt_object_t rt_object_find(const char *name, rt_uint8_t type)
使用以上接口时，在对象类型所对应的对象容器中遍历寻找指定对象，然后返回该对象，如果没有找到这样的对象，则返回空。

void rt_system_object_init(void)
自从0.3.0以后,RTT就已经没有必须再使用此接口来对内核对象初始化了,因此,此函数是空的,但在系统初始化时还会保留调用些函数

struct rt_object_information *rt_object_get_information(enum rt_object_class_type type)
{
    return &rt_object_container[type];
}
RTM_EXPORT(rt_object_get_information);