3:USBD驱动详解
这一部分将要描述USBD(USB Host Driver)的典型应用。例如初始化，client注册，动态连接注册，设备配置，数据传输，同时还探讨了USBD内部设计的关键特性。这部分是VxWorks下USB驱动的核心。
1 初始化USBD：分为两步
(1)必须至少调用一次函数usbdInitialize()。在一个给定的系统中，usbdlnifialize()初始化内部USBD数据结构，并依次调用其它USB驱动栈模块的入口。usbdinitialize()可以在启动时调用一次，也可以对每一个设备各调用一次。USBD 自己记录了调用usbdInitialize()(‘+’)和usbdShutDown()(‘-’)的次数。只有大于等于1时才是真正初始化了，而等于0是关闭了。
...
/* Initialize the USBD. */
if (usbdInitialize () != OK)
return ERROR;
...
...
/* application code. */
...
...
/* Shut down the USBD. Note: we only execute this code if the return
* code from usbdInitialize() was OK. Note also that there’s really no
* reason to check the result of usbdShutdown().
*/
usbdShutdown ();
(2)用USBD 的lisbdHedAttaeh()函数来把至少一个HCD连接到USBD上。这一过程既可以在VxWorks启动时，也可以在运行时把HCD 连接到USBD 上去。后一种机制可以支持“热插拔”，而不用象前一种那样需要重新启动。
2 HCD的连接(attaching)与断开(detaching)
当HCD连接到USBD 时，调用者为usbdHedattaeh函数传递HCD执行入口(表HCD_EXEC_FUNC)和HCD连接参数(HCD attach parameter)。USBD用HCD FNC ATYACH 服务请求依次激活HCD的执行入口，传递同样的HCD attach参数。
需要强调虽然可以改变用HCD定义的参数，但是最好不应该有所改变。对于WindRiver提供的UHCI和OHCI的HCD，HCI attach参数是一个指向结构PCI_CFG_HEADER (定义在pciConstants.h) 的指针。
该结构用UHCI和OHCI主控制器的PCI配置头来初始化，而HCD用这个结构中的信息来定位，管理特定的主控制器。典型的，调用者用usbPeiClassFind ()和usbPciConfigHeaderGet()来得到想要的主控制器的PCI配置头- 这两个函数定义在usbPciLib 中(stubUsbarchPciLib.h中)。如果有UHCI或OHCI要连接到USBD，就要调用这些函数来获得每一个主控制器的PCI_CFG_HEADER。然后利用usbdHedAttaeh来激活已鉴别出的每一个主控制器。
注意：底层BSP可能不支持USB的HCD断开，因为当中断向量表重新使能时，如果还应用的是过期的向量表，会导致错误。
//挂接过程
UINT8 busNo;
UINT8 deviceNo;
UINT8 funcNo;
PCI_CFG_HEADER pciCfgHdr; /* PCI_CFG_HEADER defined in
pciConstants.h */
GENERIC_HANDLE uhciAttachToken; /* GENERIC_HANDLE defined in
usbHandleLib.h */
/* Locate the first (0th) UHCI controller. UHCI_CLASS, etc., are defined
* in usbUhci.h. The functions usbPciClassFind() and
* usbPciConfigHeaderGet() are exported by usbPciLib.
*/
if (!usbPciClassFind (UHCI_CLASS, UHCI_SUBCLASS, UHCI_PGMIF, 0,
&busNo, &deviceNo, &funcNo))
{
/* No UHCI controller was found. */
return ERROR;
}
usbPciConfigHeaderGet (busNo, deviceNo, funcNo, &pciCfgHdr);
/* Attach the UHCI HCD to the USBD. The function usbHcdUhciExec() is
* exported by usbHcdUhciLib.
*/
if (usbdHcdAttach (usbHcdUhciExec, &pciCfgHdr, &uhciAttachToken) != OK)
{
/* USBD failed to attach to UHCI HCD. */
return ERROR;
}
/* Attachment is complete. */
//取消挂接
/* Detach the UHCI HCD from the HCD. */
usbdHcdDetach (uhciAttachToken);
/* Detach is complete! */
3 启动顺序
必须在所有USBD函数前执行函数usbdInitialize()。存在以下两种调用方式：
(1)传统的“启动”初始化。执行顺序与其意义如下：
a．usbdInitialize()；
b．usbdPciClassFind()：定位一个USB主控制器；
c．usbdPeiConfigHeaderGet()：读USB主控制器配置头；
d．usbdHedAttaeh()：连接HCD，将其作为特定的主控制器：
e．调用USB class driver初始化入口点；
f．USB class driver调用usbdlnitialize()。
(2)“热插拔”调用。执行顺序与其意义如下：
Boot Code里调用：
a．USB class driver初始化入口点；
b．USB class driver调用usbdlnitialize()；
Hot-Swap code调用：
c．Hot-Swap 鉴别USB主控制器的连接或断开；
d．Usbdlnitialize()；
e．UsbdPciConfigHeaderGet()：读USB主控制器配置头；
f．UsbdHedAttaeh()：连接HCD，将其作为特定的主控制器。
因为热插拔可以在任何时刻发生，所以USBD和其Client都必须被写成可以动态识别USB设备被插入还是被拔出。当主控制器连接到系统时，USBD 自动地鉴别与其相连的设备，并通知相关的client；同样，拔出设备时，也要通知相关设备。重要的是，USBD 的client，比如USB class driver，在client初始化时，从不设想特定的设备已经出现；而在其他时候，这些驱动随时检查设备是否已经连接到系统上。
4 总线任务
对每一个连接到USBD 的主控制器，例如插入或拔出设备，USBD都会产生一个总线任务，来监控总线事件。一般情况下，这些任务是休眠的(不消耗CPU)，只有当USB hub报告它的一个端口有变化时，它们才被唤醒。每一个USBD总线任务有VxWorks任务名：UsbdBus。
虽然HCD委托USBD来管理，但有可能HCD 亲自监视主控制器事件。例如WindRiver提供了UHCI和OHCI的HCD来创造这样的任务。对于WindRiver的UHCI模块(usbHcdUheiLib)，后台任务只是被周期地唤醒，目的是为了检查超时IRP(用一个中断来通知OHCI根hub发生改变)。
用以在USBD和USB之问进行通信的client模块，除了调用usbdlnitialize()外，必须调用usbClientRegister()使其在USBD注册。当一个client注册到USBD时，USBD把每一个以后将要用到的client的数据结构定位，并跟踪那个client的请求。
对于每一个client，在client注册过程中，USBD还创建了一个callback任务。在成功注册client后，USBD返回一个句柄USBD_CLIENT_HANDLE。以下对USBD的调用，将会用到这个句柄。当所有句柄都不需要时，可以调用usbdClientUnregister()来释放每一个client的数据结构和callback任务。注意：此时所有client要求的任务都会被取消。
例如：注册一个叫USBD_TEST的client，再注销。
注册：usbdClientRegister("USBD_TEST，&usbdClientHandle)；
注销：usbdClientUnregister(usbdClientHandle)；
5 client回调(callback)任务
USB操作是严格遵守时序的。例如为使中断传输和同步传输正确工作．需要依靠时钟中断。在一个有几个不同client出现的主系统中．总是有可能出现一个client打断其它client传输事件的发生。WindRiver USBD建议用client callback任务来解决这个问题。许多USB事件可以导致一个USB client的callback任务。例如， 每当USBD 完成USB IRP后，client的IRP callback函数被激活。同样，当USBD识别出一个动态连接事件后，会激活一个或更多的动态attach callback操作。但不是马上激活这些回调操作， 而是安排合适的相应的USBD client的回调任务来执行callback。
一般的情况下，每一个client的callback任务处于“休眠”态(阻塞态)。每一个client的callback，继承了usbdClientRegister()产生的VxWorks任务优先级。这确保了每一个callback按其client的任务优先级来执行，而且可以利用优先级来写client，保证对时间要求严格的USB传输。由于每一个client有它自己的callback任务，因此在callback期间，它们有很大的灵活性决定可以做什么。例如，允许在不破坏USBD或其它USBD client性能的条件下，使callback执行代码运行至阻塞态。
Client callback task有VxWorks任务名：tUsbdCln。
6 USBD内部Client
当第一次初始化USBD时，由USBD产生并注册一个内部client，以跟踪USB请求。
USBD 可以产生什么类型的USB请求呢? 所有USBD与USB设备的传输，均利用调用USBD client的形式来完成。例如， 当一个设备第一次连接到系统时．USBD用一个控制管道(control pipe) 自动地创建设备需要的所有的control pipe，即USBD client要用usbdPipeCreate()来创建一个与USB endpoint0通话的通道，然后所有USBD 内部、外部client通过这个管道来发送诸如usbdDescriptorGet()或usbdFeatureGet()等的函数，进行操作。
所以，USBD 的一个机制就是USBD 循环利用它自己的entry point，而内部chent跟踪这些请求。
7 动态连接的注册
每当一个特定类型的设备插入或拔出时，USBD client都通知上一层。利用调用usbdDynamicAttachRegister()操作，client可以指定一个callback操作，以便可以获取这样的通知。
USB设备类型用class，subclass，protocol来区别。标准的USB 类在usb．h 中定义为USB_CLASS_XXXX。Subclass和protocol根据class来定义， 因此这些常数根据特定的class在头文件中定义。
有时， 一个client当利用usbdDynamicAttachRegister()进行注册时，只对特定的class，subclass，protocol感兴趣。例如，USB键盘类驱动usbkeyboardLib， 注册了Human Device Interface (HID) 类，subclass 是USB_SUBCLASS_HID_ BOOT，protocol是USB_PROTOCOL_HID_BOOT _KEYBOARD。通过callback机制的响应，每当一个设备完全符合这样的标准， 从设备上插入或拔出时，SBD便通知给keyboard class driver。而在其它情况下，client关注的范围更广泛了。常量USBD_NOTIFY(定义在usbdLib.h)可以替代任意的class，subclass，protocol。例如，USB打印机USB驱动，usbPrinterLib， 其class等于USB_CLASS_PRINTER，subclass 等于USB_SUBCLASS_PRINTER (usbPrinter.h)，protocol等于USBD_ NOTIFY_ ALL。典型的，当一个client只调用一次usbdDynamicAttachRegister()时，对一个client能拥有的并发通知请求数目没有限制。
8 Node ID
USB设备一般用USBD_NODE_ID来区别。从其作用来看，USBD_ NODE_ ID 是USBD 用来跟踪一个设备的句柄。它与USB设备真正的USB地址无关。这表明client并不真正关心想要了解设备是物理上与哪一个USB主控制器相连。应用为每个设备抽象定义的Node ID， 使client可以不用考虑物理设备的连接细节以及USB地址分配， 并允许USBD 在其内部对这些进行详细的管理。
当一个client通知有一个设备连接或断开时，USBD经常通过USBD_NODE_ID来定位设备。同样，当一个client想通过USBD与一个特定的设备通信时，它必须向USBD传递那个设备的USBD_NODE_ID。
9 总线编号(bus enumeration)操作
usbdLib模块提供了usbdBusCountGet()，usbdRootNodeldGet()，usbdHubPortCountGet()，usbdNodldGet()操作。它们被一起称作总线编号操作。它们使USBD Client对连接到每一个主控制器上的设备进行编号。
这些操作对于诊断程序和测试工具很有用，例如usbTool(WindRiver提供的一个测试工具)。但是，利用它们编号之后，调用者无法知道USB的拓扑结构是否变化。因此， 建议USB class driver的开发者不要用这些操作。
10 数据传输
一旦client配置完成一个设备，就开始利用USBD提供的管道和传输功能与设备进行数据交换。为了和设备交换数据，client必须先创建管道。作为结果，USBD得到了一个USBD_PIPE_HANDLE，它被用于随后对这个管道的所有client操作。
当client企图创建一个管道时，USBD会检查是否有足够的可用带宽。对于中断和同步传输，带宽限制是必需的。USBD不允许把90％ 以上的可用带宽分配给中断和同步管道；而对于控制和块传输，则没有带宽的限制。同时，保证至少10％ 的带宽用于控制传输，对块传输则不保证会提供任何可用带宽。
数据传输的具体过程：
(1)创建pipe ：usbdPipeCreate(usbdClient Handle，nodeld，endpoint，configvalue，interface，
USB_XFRTYPE_BULK，USB_ DIR_OUT，maxPacketSize，0，0，&outPipeHandle)；
(2)定义callback：ourlrpCallback(pvoid P)；
(3)初始化IRP的数据结构；
(4)发送IRP：usbdTransfer(usbdChentHandle，outPipeHandle，＆irp)。
4、 VxWorks下USB驱动编写流程
4.1 生成bootable工程，添加以下组件(根据不同硬件定制)：
hardware->buses->USB Hosts->OHCI
hardware->buses->USB Hosts->USB Host Stack
hardware->buses->USB Hosts->USB Host Init->OHCI Init
hardware->buses->USB Hosts->USB Host Init->USB Host Stack Init
此时编译后的内核在启动时如果出现Attach OHCI...OK，表示USB协议栈加载成功。
4.2 修改和检查config.h
/* USB Stuff */
#define INCLUDE_USB
#define INCLUDE_OHCI
#define INCLUDE_OHCI_INIT
#define INCLUDE_USB_INIT
#define INCLUDE_USB_MOUSE
#define INCLUDE_USB_KEYBOARD
#define INCLUDE_USB_MS_BULKONLY
#define INCLUDE_USB_MS_CBI
#define INCLUDE_USB_PRINTER
#define INCLUDE_USB_SPEAKER
//新增加，根据系统不同配制，可能不同
//IO 地址相关,该系统不采用动态PCI查找和影射
#define SL811H_IO_ADDR SL811H_MEMORY_START
#define SL811H_IO_ADDR_DATA ((SL811H_MEMORY_START) | 0x800000)
//中断相关
#define SL811H_INT_LVL INT_LVL_EXT_IRQ_0 /* PPC405GP UIC Interrupt 25 - External IRQ 0 */
#define SL811H_INT_VEC INT_VEC_EXT_IRQ_0 /* PPC405GP UIC Interrupt 25 - External IRQ 0 */
4.3 wrSbc405gp.h(特定系统配制文件)
#define SL811H_MEMORY_START 0x70000000
#define SL811H_MEMSIZE 0x10000000
4.4 sysLib.c,增加MMU属性配制
,{
(void *) SL811H_MEMORY_START,
(void *) SL811H_MEMORY_START,
SL811H_MEMSIZE,
VM_STATE_MASK_VALID | VM_STATE_MASK_WRITABLE | VM_STATE_MASK_CACHEABLE | VM_STATE_MASK_GUARDED,
VM_STATE_VALID | VM_STATE_WRITABLE | VM_STATE_CACHEABLE_NOT | VM_STATE_GUARDED
}
5.调用流程
5.1 USB Init
///////////////////////////////////////////////////////////////////////////////////////////
UINT16 cmdUsbInit()
{
UINT16 usbdVersion;
char usbdMfg [USBD_NAME_LEN+1];
UINT16 s;
/* if already initialized, just show a warning */
if (initialized)
{
printf( "Already initialized.\n");
return RET_CONTINUE;
}
/* Initialize the USBD */
s = usbdInitialize ();
printf( "usbdInitialize() returned %d\n", s);
if (s == OK)
{
/* Register ourselves with the USBD */
s = usbdClientRegister (PGM_NAME, &usbdClientHandle);
printf( "usbdClientRegister() returned %d\n", s);
if (s == OK)
{
printf( "usbdClientHandle = 0x%x\n", (UINT32) usbdClientHandle);
/* Display the USBD version */
if ((s = usbdVersionGet (&usbdVersion, usbdMfg)) != OK)
{
printf( "usbdVersionGet() returned %d\n", s);
}
else
{
printf( "USBD version = 0x%5.4x\n", usbdVersion);
printf( "USBD mfg = '%s'\n", usbdMfg);
}
if (s == OK)
initialized = TRUE;
}
}
if (s != OK)
{
printf( "initialization failed\n");
}
return RET_CONTINUE;
}
/////////////////////////////////////////////////////////////////////////////////////////////
5.2执行HCD挂接
SL811_IO_CFG sl811IOCfg = {
SL811H_IO_ADDR,
SL811H_IO_ADDR_DATA,
SL811H_INT_VEC,
SL811H_INT_LVL
};
进入usbdHcdAttach，
5.3 setups the expansion bus access profile.(硬件单板的总线连接方式不同而不同)
5.4硬件相关寄存器初始化（因为硬件不同，所以相关过程不一样）
5.5初始化中断处理进程
(pHost->intThread =
taskSpawn ("tSl811Int", 0, 0, 0x4000,
(FUNCPTR) intThread, (int) pHost,
0, 0, 0, 0, 0, 0, 0, 0, 0))==ERROR
5.6 挂接中断
*pResult = intConnect ((VOIDFUNCPTR *)INUM_TO_IVEC (pHost->sl811CfgHdr.intVec), \
routine, (int)arg); \
开中断；
有必要的话，复位硬件（大部分时候如此）
6：数据发送和接受过程
6.1写数据过程
A：bulkWrite
LOCAL UINT16 bulkWrite
(
long bytes,
FILE *fin, /* stream for input (if any) */
FILE *fout /* stream for output (if any) */
)
{
/* Initialize the BULK class driver */
char filePath[1000];
char buffer[BULK_DRIVE_BUFFER_SIZE];
UINT8 *ptr;
int fd;
UINT32 i;
UINT8 j=1,k=1;
UINT32 len=0;
sprintf(filePath,"%sbulkFile",BULK_DRIVE_NAME);
remove(filePath);
fd = open(filePath, O_CREAT | O_WRONLY, 0);
if (fd == ERROR)
fprintf (fout, "bulkWrite() error opening %s\n",filePath);
else
fprintf (fout, "bulkWrite() %s opened for write\n",filePath);
ptr = (UINT8 *) buffer;
for (i=1; i<=bytes; i++)
{
*ptr++ = j++;
len++;
if ( (i%BULK_DRIVE_BUFFER_SIZE)==0 || i==bytes )
{
if (len != write(fd,buffer,len))
{
fprintf (fout, "bulkWrite() error writing %u to %s\n",
i,filePath);
close(fd);
return ERROR;
}
if (i%BULK_DRIVE_DISPLAY_INTERVAL == 0)
{
fprintf (fout, "bulkWrite() wrote %u of %u bytes\n",
i,bytes);
}
len = 0;
k++;
j = k;
ptr = (UINT8 *) buffer;
}
}
close(fd);
fprintf (fout, "bulkWrite() wrote %u bytes to %s\n",i-1,filePath);
return RET_CONTINUE;
}
B：读数据过程
LOCAL UINT16 bulkRead
(
long bytes,
FILE *fin, /* stream for input (if any) */
FILE *fout /* stream for output (if any) */
)
{
/* Initialize the BULK class driver */
char filePath[1000];
char buffer[BULK_DRIVE_BUFFER_SIZE];
UINT8 *ptr;
int fd;
int i;
UINT8 j=1,k=1;
int len;
UINT32 totLen=0;
sprintf(filePath,"%sbulkFile",BULK_DRIVE_NAME);
fd = open(filePath, O_RDONLY, 0);
if (fd == ERROR)
fprintf (fout, "bulkRead() error opening %s\n",filePath);
else
fprintf (fout, "bulkRead() %s opened for read\n",filePath);
ptr = (UINT8 *) buffer;
while ((len=read(fd,buffer,BULK_DRIVE_BUFFER_SIZE)) > 0)
{
for (i=0; i<len; i++)
{
totLen++;
if (*ptr++ != j++)
{
fprintf (fout, "bulkRead() error %u != %u at %u from %s\n",
*(ptr-1),j-1,totLen,filePath);
close(fd);
return ERROR;
}
if (totLen%BULK_DRIVE_DISPLAY_INTERVAL == 0)
{
fprintf (fout, "bulkRead() verified %u of %u bytes\n",
totLen,bytes);
}
}
k++;
j = k;
ptr = (UINT8 *) buffer;
}
close(fd);
if (totLen==bytes)
{
fprintf (fout, "bulkRead() verified %u bytes from %s\n",
totLen,filePath);
}
else
{
fprintf (fout, "bulkRead() error reading at %u of %u in %s\n",
totLen,bytes,filePath);
return ERROR;
}
return RET_CONTINUE;
}
7:USB代码的注意点
这一周主要在研究USB代码的架构,发现一些问题:
(1) 数据是以祯的方式传输的,数据包的开头是一段同步字段,同步字段的结尾是PID开始的标志,包结束是以EOP为结束的标志.
(2) PE通过读出CSR以及Buffer里面的状态,来决定数据传输的可靠性,并不是PE来控制CSR
(3) 仲裁器仲裁总线传输和DMA传输, CSR[15]是DMA使能位,但是发现找不到DMA request 的触发,Wishbone部分并没有对这个信号进行相应的处理
(4) 从主机发过来的token会有两个token寄存器进行寄存,token的每个位都有相应的含义
(5) 主机每秒发送的祯的个数,祯在Top层有一个祯的计数器
(6) 在代码中,要保持信号的稳定性,往往都是采用计数器的方法,计数到一定时间后,再采样一次,这样来保持数据的稳定性
