串口驱动概述
1. 启动顺序
在usrConfig.c 中,usrInit()调用sysHwInit(), 对系统硬件进行基本的初始化,使其处于安静状态。sysHwInit()[在sysLib.c 中]调用sysSerial.c 中的sysSerialHwInit()对BSP 串行器件
进行初始化,使其处于静态;sysSerialHwInit()再通过xxDevInit()复位串行通道。
在usrInit()函数的最后,产生根任务usrRoot()。usrRoot()调用sysClkConnect()。sysHwInit2()
主要安装系统中断, 它调用sysSerialHwInit2() 连接串行中断。如果定义了INCLUDE_TTY_DEV,而没有定义INCLUDE_TYCODRV_5_2,在usrRoot()任务中调用 ttyDrv()来初始化串行设备驱动,并通过ttyDevCreate()函数创建串行设备。
串行驱动是在VxWorks系统开始过程中被初始化的。
2. 编码步骤
(1)初始化
①定义系统可支持的串行通道数。
②初始化驱动的设备描述
③写设备初始化代码
(2)写入口程序
(3)写中断服务程序管理中断
(4)使用模板wind/target/src/drv/ssio/templateSio.c
3.详细步骤介绍
(1)定义系统可支持的串行通道数。
在config.h 中定义串口通道数NUM_TTY。
(2)初始化驱动的设备描述
TEMPLATE_CHAN 例子如下所示:
typedef struct { /* SIO_CHAN *MUST* be first */ SIO_CHAN sio; /* standard SIO_CHAN element */ UINT32 ioBase; UINT32 vecBase; UINT32 intLevel; /* callbacks */ STATUS (*getTxChar) (void *, char *); void (*putRcvChar) (void *, char); void (*errorRtn) (void *, int, void *, int); void * getTxArg; void * putRcvArg; 2 void * errorArg; /* misc */ int intConnect; /* intConnect done flag */ int baudFreq; /* current baud rate */ int mode; /* current mode (interrupt or poll) */ int clkFreq; /* input clock frequency */ uint_t options; /* Hardware options */ int scanMode; /* keyboard mapping mode */ } TEMPLATE_CHAN;
在XX_DRV 结构中每一个通道有一个XX_CHAN 结构。
在上面的例子中,TEMPLATE_CHAN 中的SIO_CHAN 必须被第一个定义!
SIO_CHAN 指向SIO_DRV_FUNCS, SIO_DRV_FUNCS 结构提供驱动的入口函数。
SIO_DRV_FUNCS 定义在wind/target/h/sioLib.h 中。如下:
struct sio_drv_funcs /* driver functions */ { int (*ioctl) ( SIO_CHAN * pSioChan, int cmd, void * arg ); int (*txStartup) ( SIO_CHAN * pSioChan ); int (*callbackInstall) ( SIO_CHAN * pSioChan, int callbackType, STATUS (*callback)(void *, ...), void * callbackArg ); int (*pollInput) ( SIO_CHAN * pSioChan, char * inChar ); int (*pollOutput) 3 ( SIO_CHAN * pSioChan, char outChar ); };
xxIoctl(): 支持设备特定的ioctl 命令
xxTxStartup(): 初始化一个传输循环(transmit cycle)
xxCallBackInstall(): 安装到高层协议的入口(I/O system,target agent(目标代理),等等)
xxPollInput() : 轮巡模式输入
xxPollOutPut() : 轮巡模式输出
a.启动发送循环
因为串口发送数据时需要启动,xxTxStartup()就是用来启动串口数据发送,当发送成功后会触发串口中断,中断根据缓存中是否还有数据来决定是否继续发送,当缓存清空后串口将恢复初始状态,并等待下一次传送的启动。
b.驱动回调安装程序
回调用于层间协作,上层将本层函数安装在下层,这个函数就是回调,而下层在一定条件下触发回调,例如作为一个驱动,是一个底层,他在收到一个数据时,除了完成本层的处理工作外,还将进行回调,将这个数据交给上层应用层来做进一步处理,这在分层的数据通信中很普遍。
int xxCallbackInstall (pSioChan,callbackType, callback, callbackArg)
pSioChan: 指向SIO_CHAN结构的指针
callbackTyp:SIO_CALLBACK_GET_TX_CHAR or SIO_CALLBACK_PUT_RCV_CHAR
callback: 指向回调函数的指针
callbackArg:传给回调函数的参数
/************************************************************************** * * templateCallbackInstall - install ISR callbacks to get/put chars * * This driver allows interrupt callbacks for transmitting characters * and receiving characters. In general, drivers may support other * types of callbacks too. * * RETURNS: OK on success, or ENOSYS for an unsupported callback type. */ LOCAL int templateCallbackInstall ( SIO_CHAN * pSioChan, /* channel */ int callbackType, /* type of callback */ STATUS (*callback)(void *,...), /* callback */ 4 void * callbackArg /* parameter to callback */ ) { TEMPLATE_CHAN * pChan = (TEMPLATE_CHAN *)pSioChan; { case SIO_CALLBACK_GET_TX_CHAR: pChan->getTxChar = (STATUS (*)(void *, char *))callback; pChan->getTxArg = callbackArg; return (OK); case SIO_CALLBACK_PUT_RCV_CHAR: pChan->putRcvChar = (void (*)(void *, char))callback; pChan->putRcvArg = callbackArg; return (OK); case SIO_CALLBACK_ERROR: pChan->errorRtn = (void (*)(void *, int, void *, int))callback; pChan->errorArg = callbackArg; return (OK); default: return (ENOSYS); } }
(3)驱动初始化:void xxDevInit (pxxDrv)
这个函数是用来复位芯片,使芯片处于安静的状态。
(4)写函数
用户通过I/O系统的write()操作是调用tyWrite()——在驱动列表中的ttyDrv的写入口函数。tyWrite()把数据拷贝到环形缓冲中,并且调用xxTxStartup( )来初始化一个发送周期。
当设备输出完毕后,设备就给CPU一个中断表示可以接受下一个字符,然后进入中断xxInTxt( )。函数xxIntTx ( )通过调用回调函数getTxChar从高层协议去字节,把字节写入到设备。如果需要的话清除中断。如果需要的话在没有数据等待发送的时候,复位发送中断。
(5)读函数
串口的读操作相对于写操作来说复杂一些。数据的读写有两种方式:查询式和中断式。
查询方式根据事先设定的时间间隔定时读端口,不论端口是否有数据,操作都要进行。所以查询方式并不能完全适应实时操作系统的及时相应要求,因此在嵌入式实时操作系统中应用的比较少。而中断方式(或者类似中断的机制)则使用比较多。VxWorks提供的Select函数,可以使任务阻塞在一个或者多个I/O设备上,并能制定最多所等待的时间。利用Select函数可以将读串口设备的操作阻塞在设备的读操作上,当有数据可读时,被阻塞的任务就继续向下执行,这是就可以对串口继续读操作,将数据从端口读入。因此可以将读端口的操作单独放在一个任务中,利用Select将任务阻塞在端口读操作,而当端口有数据时继续该任务。Select函数是一种类似于事件触发的机制,利用Select函数可以实现类似于中断的方式的数据读操作。
下面简单说明一下利用Select实现串口的读操作。
FOREVER {
/*清除等待设备集合中的读屏蔽位*/
FD_ZERO(&readFds);
/*初始化屏蔽位为等待串口状态*/
(SerialDevFd,& readFds);
Width = SerialDevFd + 1;
/*阻塞,等待串口设备变为就绪状态*/
if(select(width,& readFds,NULL,NULL,NULL) == ERROR) return (ERROR); if(FD_ISSET(SerialDevFd,&readFds)) { FOREVER { /*当端口仍有未读数据*/ If((DataLen = read(SerialDevFd,ComReadBuffer,MAX_IN_DATA)) == ERROR) { printf(“\nError in read comport”); return(ERROR); } if(DataLen == 0) breake;
/*处理所读出的数据,如将其写到缓存或直接处理*/ } } }
当采用中断方式读数据时,接收中断服务程序void xxIntRcv(pSioChan)实现从设备中读字节,并通过调用回调函数putRcvChar来将字节传给高层协议。
/************************************************************************** * * templateSioIntRcv - handle a channel's receive-character interrupt * * RETURNS: N/A */ LOCAL void templateSioIntRcv ( 6 TEMPLATE_CHAN * pChan /* channel generating the interrupt */ ) { char inChar; /* rcvr data */ char crData = 0; /* rcvr status */ STATUS status = OK; /* * TODO - * * Get status and data from the device. Determine if valid data is ready * or not. * * For PCI devices, do an immediate return if device is not asserting * an interrupt. */ TEMPLATE_SIO_READ8(pChan, TEMPLATE_CSR_ID, &crData); /* Check for error conditions */ if (crData & TEMPLATE_CR_OKAY) { TEMPLATE_SIO_READ8(pChan, TEMPLATE_DATA_ID, &inChar); #if 0 /* Keyboard emulation code */ /* * TODO - For a keyboard type device we would map the raw scan code * to ASCII, or other mapping. Do that here. */ if (pChan->scanMode == SIO_KYBD_MODE_ASCII) inChar = templateAsciiTbl[(UINT8)inChar]; #endif } else { /* * TODO - Determine precise error condition and perform * recovery actions. */ status = ERROR; 7 } /* * TODO - Typically, acknowledge the interrupt as soon as possible. * Usually before passing data or error conditions upstream. */ TEMPLATE_SIO_WRITE8(pChan, TEMPLATE_CSR_ID, TEMPLATE_RESET_INT); /* ack interrupt*/ if (status == ERROR) { /* send error notification upstream */ (*pChan->errorRtn) (pChan->errorArg, SIO_ERROR_UNKNWN, NULL, 0); } else { /* send data character upstream */ (*pChan->putRcvChar) (pChan->putRcvArg, inChar); } }
(6) I/O控制函数ioctl()
指向驱动的标准I/O控制接口函数。此函数为任何驱动提供主要的控制接口。为了实现标准的SIO设备的I/O控制,用以下的定义:
SIO_BAUD_SET 设定一个新的波特率
SIO_BAUD_GET 得到当前的波特率
SIO_HW_OPTS_SET 设定一个新的硬件属性
SIO_HW_OPTS_GET 得到当前的硬件属性
SIO_MODE_SET 设定一个新的操作模式
SIO_MODE_GET 得到当前的操作模式
SIO_AVAIL_MODES_GET 得到可能的模式
SIO_OPEN 打开一个通道
SIO_HUP 关闭一个通道
(7)修改sysSerial.c
在sysSerial.c中,主要需要修改三个函数,sysSerialHwInit( ),sysSerialHwInit2( ),sysSerialChanGet( )。
sysSerialHwInit( )主要完成以下功能:初始化和硬件相关的的驱动的XX_CHAN结构(例如寄存器地址);调用xxDevInit()来执行实际的设备初始化;设定标志位来标志ISR仍然没有被安装。此函数是被sysHwInit( )调用的。
sysSerialHwInit2( )主要是连接中断服务程序。在intConnect()中的第三个参数应该是指向
8
xx_CHAN结构的一个指针。此函数是由usrRoot任务在系统启动过程中由sysClkConnect()调用的。它设定标志位标志ISR已经被安装。
sysSerialChanGet( )主要是把通道号转换成一个SIO_CHAN结构的指针。 |