vxworks字符设备驱动傻瓜教程

* 标准I/O函数

open(), create(), read(), write(), ioctl(), close() , remove()
各个函数的详细说明可参考Tornado的相关帮助文件。

* 字符设备驱动实例（头文件和源文件代码）
* 安装驱动/创建设备代码
* SELECT机制使用举例

/*****************************************************/
+++++++++++头文件：

/* 定义MYXXX_DEV结构体 */

typedef  struct
{
DEV_HDR   devHdr; /* 必须 */
SEL_WAKEUP_LIST selWakeupList; /* 支持SELECT机制 */

/* 自己定义的其他成员 */

BOOL      readyRead;
BOOL      readyWrite;
...
}
MYXXX_DEV;

/* 其他定义 */

+++++++++++源文件：

#include "vxWorks.h"
#include "iv.h"
#include "ioLib.h"
#include "iosLib.h"
#include "intLib.h"
#include "errnoLib.h"
#include "sysLib.h"

#include "drv/XXX/XXX.h"

LOCAL int myxxxDrvNum = 0;
LOCAL MYXXX_DEV  mymyxxxDev;

/* myxxxDrv() 安装驱动例程
   入口参数: 无
   返回值:
   ------OK: 驱动安装成功
   ------ERROR: 驱动安装失败
 */

STATUS myxxxDrv(void)
{
  if(myxxxDrvNum > 0)
  {
     return(OK); /* 驱动程序已经安装,直接返回 */
  }

 /* 驱动初始化代码 */
 
  
 /* 中断向量初始化 */
 if(intConnect(INUM_TO_IVEC(myxxx_INT_NUM), myxxxIntHandler, (int)(&mymyxxxDev)) == ERROR)
    return (ERROR);
 if(intEnable(myxxx_INT_NUM)==ERROR)
    return (ERROR);
 
 /* 调用iosDrvInstall()安装驱动 */
 if((myxxxDrvNum = iosDrvInstall(myxxxOpen, myxxxDelete, myxxxOpen, myxxxClose, /
     myxxxRead, myxxxWrite, myxxxIoctl)) == ERROR)
     return (ERROR);
  return (OK);
}

/* myxxxDevCreate()创建设备例程
   入口参数:
   ----devname: 所要创建的设备名称;
   返回值:
   ----OK: 创建设备成功;
   ----ERROR: 创建设备失败;  
  
 */

STATUS myxxxDevCreate(char * devName)
{
 MYXXX_DEV *pmyxxxDev = &mymyxxxDev;
 
 if(myxxxDrvNum < 1)
 {
  errnoSet(S_ioLib_NO_DRIVER);
  return (ERROR);
 }
 
 
 /* init pmyxxxDev */
 if( iosDevAdd(&pmyxxxDev->devHdr, devName, myxxxDrvNum) == ERROR)
 {
    return (ERROR);
 }

 selWakeupListInit(&pmyxxxDev->selWakeupList);
 /* init other */

 return (OK);
}

/*
 myxxxOpen() 打开设备
 入口参数: 参考open();
 返回值:
 -------ERROR:失败
 -------指向设备的句柄
 */
int myxxxOpen(DEV_HDR *pDevHdr, int option, int flags)
{
 MYXXX_DEV *pmyxxxDev = (MYXXX_DEV *)pDevHdr;

 if(pmyxxxDev == NULL)
 {
  return (ERROR);
 }
 

 return ((int)pDevHdr);
}

/*
 读设备

 */

int myxxxRead(int myxxxDevId, char *pBuf, int nBytes)
{
 MYXXX_DEV *pmyxxxDev = (MYXXX_DEV *)myxxxDevId;
 int ReadLength;
 
 ReadLength=0;
 if(pmyxxxDev == (MYXXX_DEV *)NULL)
 {
  return ERROR;
 }

 /*read code here*/
 
 return (ReadLength);
}

/* 写设备 */

int myxxxWrite(int myxxxDevId, char *pBuf, int nBytes)
{
 MYXXX_DEV *pmyxxxDev = (MYXXX_DEV *)myxxxDevId;
 int WriteLength = 0;
 
 if(pmyxxxDev == (MYXXX_DEV *)NULL)
 {
  return (ERROR);
 }
 
 return (WriteLength);
}

/* 设备控制 */
int myxxxIoctl(int myxxxDevId, int cmd, int arg)
{

 MYXXX_DEV *pmyxxxDev = (MYXXX_DEV *)myxxxDevId;
 int status;
 UCHAR temp;
 
 status = OK;
 switch(cmd)
 {
  case FIOSELECT:
   selNodeAdd(&pmyxxxDev->selWakeupList, (SEL_WAKEUP_NODE *)arg);
   if((selWakeupType((SEL_WAKEUP_NODE *)arg) == SELREAD) && (pmyxxxDev->readyRead))
       selWakeup((SEL_WAKEUP_NODE *)arg);
   if((selWakeupType((SEL_WAKEUP_NODE *)arg) == SELWRITE) && (pmyxxxDev->readyWrite))
       selWakeup((SEL_WAKEUP_NODE *)arg);
   break;
  case FIOUNSELECT:
   selNodeDelete(&pmyxxxDev->selWakeupList, (SEL_WAKEUP_NODE *)arg);
   break;
 
  /* other cmd */
  default:
   errnoSet(S_ioLib_UNKNOWN_REQUEST);
   status = ERROR; 
 }
 return (status);
}

/* 关闭设备 */
int myxxxClose(int myxxxDevId)
{
 MYXXX_DEV *pmyxxxDev = (MYXXX_DEV *)myxxxDevId;
 
 if(pmyxxxDev == (MYXXX_DEV *)NULL)
 {
  return (ERROR);
 }
 /* */
 pmyxxxDev->opened = FALSE;
 return (OK);
}

/* 删除设备 */
STATUS myxxxDelete(char *devName)
{
 DEV_HDR *pDevHdr;
 char *pNameTail;

 /* search dev */
 pDevHdr = iosDevFind(devName, &pNameTail);
 if(pDevHdr == NULL || *pNameTail != '/0')
    return (ERROR);

 /* release resourse sample sam wakeup signal */

 /* uninstall */
 iosDevDelete(pDevHdr);
 return (OK);
}

/* 设备中断处理 *
void myxxxIntHandler(int myxxxDevId)
{
 
 /* interrupt process */

 selWakeupAll(&myxxxDev->selWakeupList,SELREAD); /* 若支持SELECT机制 */

 selWakeupAll(&myxxxDev->selWakeupList,SELWRITE); /* 若支持SELECT机制 */
}

/*************************************************************/
应用程序中安装驱动和创建设备代码:

/* 包含的头文件 */

myxxxDrv(); /* 安装驱动 */
myxxxDevCreate(“/myxxxDev"); /* 创建设备 */

/*************************************************************/
SELECT机制的使用

使用SELECT可以在设备没有准备好读写之前将此任务挂起，只到设备准备好或者超时，
从而提高系统运行效率。用户可以通过调用select()函数来达到这一目的。具体用法如下：

在驱动程序中SELECT的初始化以及在ioctl()如何支持SELECT请参考上面的示例代码；

需要注意的是，SELECT机制只能用于字符型的设备驱动，并且是可选的（非必需）。

SELECT机制使用举例=>

SELECT使用一个名为fd_set的结构体来实现，一个fd_set结构体可以看作一个位数组，每个位代表
所要读写的文件描述符。可以用下列宏来对fd_set进行操作：

FD_SET(fd,&fdset)    在fdset中设置fd标志位；
FD_CLR(fd,&fdset)    清除fdset中的fd标志位;
FD_ZERO(fd,&fdset)   清楚fdset中的所有标志位;
FD_ISSET(fd,&fdset)  测试fdset中的fd位是否被置位；

select()函数原型：

int select (width, pReadFds, pWriteFds,pExceptFds, pTimeOut)

其中 width: 要检查的fdset中的标志位的最大宽度；
     pReadFds:指向结构体fdset的指针，其中包含了要读文件的描述符；
     pWriteFds:指向结构体fdset的指针，其中包含了要写文件的描述符；
     pExceptFds:指向结构体fdset的指针，其中包含了异常文件的描述符；（未实现）
     pTimeOut:指向结构体timeval的指针，NULL代表无限等待；
返回值：准备好的文件描述符的个数，0表示超时或者出错（如不支持SELECT）；
     返回时，结构体fdset中的各个位被修改，只有那些已经准备好的相应位被置位。
应用举例：

struct fd_set readFds;
int fds[NUM_FDS], width = 0;
FD_ZERO (&readFds);
for (i=0; i<NUM_FDS; i++)
{
  FD_SET (fds[i], &readFds);
  width = (fds[i] > width) ? fds[i] : width;
}
width++;
if (select(width, &readFds,NULL,NULL,NULL) == ERROR)
    return (ERROR);
for (i=0; i<NUM_FDS; i++)
{
  if (FD_ISSET (fds[i], &readFds))
  {
  /* do something now that fds[i] is ready */

  }
}