VxWorks 6.9 内核编程指导之读书笔记 -- VxWorks Kernel application （二）

#1 内核对象的静态实例化

内核对象的静态实例化

任务的静态实例化

VX_TASK宏用来在编译时声明一个任务对象。该宏带有2个参数：任务名和栈大小。不像taskSpawn函数，任务名称可以是NULL。VX_TASK的任务名称必须指定。栈大小是非零值并且是编译时常量。

VX_TASK_INSTANTIATE宏被VX_TASK用来初始化和创建任务，等价于taskSpawn函数的功能。VX_TASK_INITIALIZE宏杯VX_TASK初始化任务并让任务处于SUSPEND状态，直到稍后调用taskActivate函数来激活。

VX_TASK_INSTANTIATE返回发起的任务ID，或者错误码。VX_TASK和VX_TASK_INITIALIZE必须使用相同的任务名。

#include <vxWorks.h>
#include <taskLib.h>
VX_TASK(myTask,4096);
int myTaskId;

STATUS initializeFunction (void)
    {
    myTaskId = VX_TASK_INSTANTIATE(myTask, 100, 0, 4096, pEntry, 
                                   0,1,2,3,4,5,6,7,8,9);
   if (myTaskId != ERROR)
       return (OK);                /* instantiation succeeded */
   else
       return (ERROR);
    }

为了初始化任务并使它处于SUSPEND状态，必须使用VX_TASK_INITALIZE宏。并在稍后使用taskActivate函数来运行该任务。VX_TASK_INSTANIATE和taskActivate使用相同的参数。

#include <vxWorks.h>
#include <taskLib.h>
VX_TASK(myTask,4096);
int myTaskId;
STATUS initializeFunction (void)
{
    myTaskId = VX_TASK_INITIALIZE(myTask, 100, 0, 4096, pEntry, 
                                  0,1,2,3,4,5,6,7,8,9);
   if (myTaskId != NULL)
       {
       taskActivate (myTaskId);
       return (OK);
       }
   else
       return (ERROR);
}

更多信息，请参阅taskLib的API手册。

信号量的静态实例化

VX_BINARY_SEMAPHORE,VX_COUNTING_SEMAPHORE,VX_MUTEX_SEMAPHORE和VX_READ_WRITE_SEMAPHORE宏分别用来在编译时定义二进制信号量、计数信号量、互斥信号量。这些必须以信号量名称作为参数。

这些信号量通过semBInitialize，semCInitialzie，semMInitialize和semRWInitialize函数来初始化定义的信号量。semXInitialize函数等价于semXCreate函数。

VX_XXX_SEMAPHORE和semXInitialize函数必须使用相同的信号量名称。semXInitialize函数返回信号量的ID。

#include <vxWorks.h>
#include <semLib.h>

VX_BINARY_SEMAPHORE(mySemB);   /* declare the semaphore */
SEM_ID mySemBId;               /* semaphore ID for further operations */
STATUS initializeFunction (void)
{
    if ((mySemBId = semBInitialize (mysemB, options, 0)) == NULL)
         return (ERROR);      /* initialization failed */
    else
         return (OK);
}

消息队列的静态实例化

VX_MSG_Q用来在编译时声明消息队列对象。带有3个参数：名称，消息队列最大数量及每个消息的最大尺寸。msgQInitialize函数在运行时初始化消息队列使之可用。宏和函数的参数必须保持一致。

#include <vxWorks.h>
#include <msgQLib.h>
VX_MSG_Q(myMsgQ,100,16);         /* declare the msgQ */
MSG_Q_ID myMsgQId;               /* MsgQ ID to send/receive messages */
STATUS initializeFunction (void)
{
    if ((myMsgQId = msgQInitialize (myMsgQ, 100, 16, options)) == NULL)
         return (ERROR);      /* initialization failed */
    else 
         return (OK);
}

看门狗时钟的静态实例化

VX_WDOG在编译时声明看门狗时钟。带有一个参数，看门狗名称。wdInitialize函数在运行时初始化看门狗时钟。

#include <vxWorks.h>
#include <wdLib.h>
VX_WDOG(myWdog);    /* declare the watchdog */
WDOG_ID myWdogId;   /* watchdog ID for further operations */
STATUS initializeFunction (void)
{
    if ((myWdogId = wdInitialize (myWdog)) == NULL) 
         return (ERROR);       /* initialization failed */
    else
         return (OK);
}