s3c2440提供了USB主机接口,它与OHCI v1.0完全兼容。要使用该功能,就必须熟悉OHCI v1.0规范;而要熟悉OHCI v1.0规范,那么还必须先熟悉USB v1.1协议。因此涉及到该部分的内容较多,要想正确使用s3c2440所提供的USB主机接口也不是一件容易的事情。在这里,我主要介绍USB设备枚举过程中所涉及到的一些知识,并给出具体的实现程序。
OHCI(Open HCI)是目前使用比较广泛的三种USB主机控制器规范之一。USB体系结构是由四个主要部分组成:客户软件/USB驱动,主机控制器驱动(HCD),主机控制器(HC)和USB驱动。前两者由软件实现,后两者由硬件实现。而OHCI就是规范了主机控制器驱动和主机控制器之间的接口,以及它们的基本操作。在主机控制器驱动和主机控制器之间,有两个通信通道,第一个是应用位于HC的一套可操作寄存器,它们包括控制寄存器、状态寄存器和列表指针寄存器;另一个通道是应用称为主机控制器通信域(HCCA)的共享内存。
USB定义了四种数据传输类型:控制传输、批量传输、中断传输和同步传输。在OHCI规范中把数据传输类型分为两类:周期传输和非周期传输。同步传输和中断传输属于周期传输,控制传输和批量传输属于非周期传输。USB定义了每帧的周期为1.0毫秒,为了保证每一帧都能发生周期传输和非周期传输,一般地,OHCI把每一帧的带宽分为四个部分,首先是发送SOF,然后是非周期传输,紧接着是周期传输,如果周期传输完毕后,还有时间,则剩余的时间仍然留给非周期传输。
端点描述符(ED)和传输描述符(TD)是两个最基本的通信模块。ED包含了一个端点的信息,它被HC用来管理使用端点。ED的典型参数包括端点地址、传输速度、最大数据包大小,另外ED还提供了TD链表的停靠地(锚点)。TD是一个依赖于ED的内存缓存区,用于与端点之间进行数据传输。当HC存取一个ED,并且找到一个有效的TD地址时,则HC就完成了一个简单的与端点之间的传输任务,这个端点是由ED确定,而所存取的数据内存地址由TD指定。当所有的被TD所定义的数据传输完毕后,TD就从ED中解链出来,并链接到完成列表中。这个完成列表能够被HCD所处理,以提供一些完成信息。
ED的数据结构长度为16字节,它的数据域有:
FA:USB的功能地址;
EN:USB功能内的端点地址;
D:数据流的传输方向,是IN,OUT,还是有TD来决定传输方向;
S:速度,全速还是低速;
K:用于设置跳过当前ED;
F:链接于ED的TD的形式,是通用TD格式还是同步TD格式;
MPS:数据传输的最大字节大小;
TailP:TD列表的尾指针;
H:用于停止当前TD列表的处理;
C:数据翻转进位位;
HeadP:TD列表的头指针;
NextED:下一个要处理的ED指针。
根据上述说明,我们可以定义ED为下面的数据类型:
typedef struct _ED {
volatile unsigned int Control;
volatile unsigned int TailP;
volatile unsigned int HeadP;
volatile unsigned int NextEd;
} ED, *P_ED;
由于ED必须是16字节地址对齐形式,因此我们必须用下面的形式来声明它的变量:
__align(16) ED ed;
我们可以用下面的函数来创建一个ED:
__inline void CreateEd(
unsigned int EDAddr, //ED地址指针
unsigned int MaxPacket, //MPS
unsigned int TDFormat, //F
unsigned int Skip, //K
unsigned int Speed, //S
unsigned int Direction, //D
unsigned int EndPt, //EN
unsigned int FuncAddress, //FA
unsigned int TDQTailPntr, //TailP
unsigned int TDQHeadPntr, //HeadP
unsigned int ToggleCarry, //C
unsigned int NextED) //NextED
{
P_ED pED = (P_ED) EDAddr;
pED->Control = (MaxPacket << 16) | (TDFormat << 15) |(Skip << 14) | (Speed << 13)
| Direction << 11) | (EndPt << 7) | FuncAddress;
pED->TailP = (TDQTailPntr & 0xFFFFFFF0);
pED->HeadP = (TDQHeadPntr & 0xFFFFFFF0) | (ToggleCarry << 1);
pED->NextEd = (NextED & 0xFFFFFFF0);
}
TD共有两种类型:通用TD和同步TD。通用TD用于中断、控制和批量端点,同步TD用于同步传输。在这里,我们只给出通用TD的数据结构和定义。
通用TD的数据结构长度也是16字节,它的数据域有:
R:缓存凑整,用于设置是否需要最后一个数据包的长度与所定义的长度一致;
DP:方向,是IN,OUT,还是SETUP;
DI:延时中断;
T:数据翻转;
EC:传输错误计数;
CC:条件码,为上一次企图传输的状态;
CBP:将要被传输的数据内存物理地址;
NextTD:下一个TD;
BE:将要被传输的数据内存物理末字节地址;
根据上述说明,我们可以定义通用TD为下面的数据类型:
typedef struct _TD {
volatile unsigned int Control;
volatile unsigned int CBP;
volatile unsigned int NextTD;
volatile unsigned int BE;
} TD, *P_TD;
由于通用TD必须是16字节地址对齐形式,因此我们必须用下面的形式来声明它的变量:
__align(16) TD td[4];
我们可以用下面的函数来创建一个通用TD:
__inline void CreateGenTd(
unsigned int GenTdAddr, //TD地址指针
unsigned int DataToggle, //T
unsigned int DelayInterrupt, //DI
unsigned int Direction, //DP
unsigned int BufRnding, //R
unsigned int CurBufPtr, //CBP
unsigned int NextTD, //NextTD
unsigned int BuffLen) //被传输的数据长度,由该变量可以得到BE
{
P_TD pTD = (P_TD) GenTdAddr;
pTD->Control = (DataToggle << 24) | (DelayInterrupt << 21)
| (Direction << 19) | (BufRnding << 18);
pTD->CBP = CurBufPtr;
pTD->NextTD = (NextTD & 0xFFFFFFF0);
pTD->BE = (BuffLen) ? CurBufPtr + BuffLen - 1 : CurBufPtr;
}
下面我们给出HCCA的数据结构,它的长度为256字节,包括128字节的HCCA中断表,2字节的HCCA帧数,2字节的HCCA便签(表示HC是否正在更新HCCA帧数),4字节的HCCA完成队列头指针,以及116字节的保留区。根据上述说明,我们可以定义HCCA为下面的数据类型:
typedef struct _HCCA {
volatile unsigned int HccaInterruptTable[32];
volatile unsigned short HccaFrameNumber;
volatile unsigned short HccaPad1;
volatile unsigned int HccaDoneHead;
volatile unsigned char reserved[116];
} HCCA, *P_HCCA;
由于HCCA必须是256字节地址对齐形式,因此我们必须用下面的形式来声明它的变量:
__align(256) HCCA hcca;
OHCI是基于寄存器层描述的USB主机控制器的规范,因此HC包含了一些片内可操作寄存器,这些寄存器同样可以被HCD所使用。下面我们就简单介绍OHCI中的寄存器。
HcRevision:HCI规范版本;
HcControl:HC的操作模式,CBSR——在非周期队列中,被服务的控制ED与批量ED之间的比例;CLE——下一帧控制队列处理使能;HCFS——USB主机控制器功能状态,包括复位、重新开始、操作和中止;
HcCommandStatus:HC接收来至HCD的命令,也可反映HC的当前状态,HCR——软件复位HC;CLF——确定是否有控制队列TD;
HcInterruptStatus:提供各种能够触发硬件中断事件的状态;
HcInterruptEnable:使能用于控制产生硬件中断事件的位;
HcInterruptDisable:无效用于控制产生硬件中断事件的位
HcHCCA:HCCA的物理地址;
HcPeriodCurrentED:当前同步或中断ED的物理地址;
HcControlHeadED:控制队列的第一个ED的物理地址;
HcControlCurrentED:当前控制对立ED的物理地址;
HcBulkHeadED:批量队列的第一个ED的物理地址;
HcBulkCurrentED:当前批量对立ED的物理地址;
HcDoneHead:被添加在完成队列中的最近一个TD的物理地址;
HcFmInterval:包含一个14位的FI——用于表示一帧之内所占用的比特时间,2个连续的SOFs,和一个15位PSMPS——用于表示在没有引发调度溢出下可发送或接收全速最大包大小,FI,PSMPS的推荐值为 0x2EDF和0x2778。
HcFmRemaining:14位的倒计数器,以表示当前帧所剩时间;
HcFmNumber:16位计数器,以提供时序参考;
HcPeriodicStart:14位可编程数值,以确定HC在什么时间开始执行周期队列;
HcLSThreshold:11位数值,用于确定是否在EOF之前执行最大8位LS包传输;
HcRhDescriptorA:第一个对跟集线器进行描述的寄存器;
HcRhDescriptorB:第二个对跟集线器进行描述的寄存器;
HcRhStatus:包括集线器状态域和集线器状态更改域;
HcRhPortStstus[1:NDP]:用于控制和报告每个端口上的事件,在s3c2440中,NDP为2
下面给出OHCI的初始化,它都是基于寄存器的。根据OHCI规范,HCD应该完成下列初始化步骤:
● 初始化HCCA数据内存单元
● 初始化可操作寄存器,以匹配当前设备数据状态
● 设置HcHCCA
● 设置HcInterruptEnable
● 设置HcControl
● 设置HcPeriodicStart
结合本文所介绍的实际内容,OHCI的初始化函数为:
void OHCIInit( )
{
unsigned int fminterval;
//复位
rHcControl = 0;
//写HCCA
rHcHCCA = (volatile unsigned )&hcca;
//设置帧间隔
fminterval = 0x2edf;
rHcFmInterval =((((fminterval - 210) * 6) / 7) << 16)| fminterval;
rHcPeriodicStart= (fminterval * 9) / 10;
//初始化HcDoneHead
rHcDoneHead = 0x00;
hcca.HccaDoneHead = 0x0000;
//设置HC为运行状态
rHcControl = 0x80;
}
主机对USB设备的识别过程称为设备枚举,因此枚举对于USB至关重要。在本文,只进行下列简单的5步枚举过程:
1、主机要求得到设备描述符,SETUP数据包为:0x80, 0x06,0x00,0x01,0x00,0x00,0x40,0x00,得到的数据长度最大为0x40;
2、第二个SETUP包是为设备分配一个地址,内容一般为:0x00,0x05,0x02,0x00,0x00,0x00,0x00,0x00。其中的02表示为设备分配的地址为0x02,以后我们再对该设备操作时,就只能使用0x02这个地址值;
3、主机用新的地址再次获取设备描述符,SETUP包为:0x80,0x06,0x00,0x01,0x00,0x00,0x12,0x00,与上次不同,这次得到数据长度时实际的数据长度0x12;
4、主机读取设备全部配置描述符,SETUP包为:0x80,0x06,0x00,0x02,0x00,0x00,0x40,0x00,由于主机不知道设备描述符的长度,因此这里只要求得到0x40个字节;
5、主机发送SETUP数据包:0x00,0x09,0x01,0x00,0x00,0x00,0x00,0x00,用以设置配置,允许所有端点进入工作状态。
对USB设备枚举我们只做了简单的介绍,关于枚举的其他步骤以及SETUP数据包各个字节的具体含义,请阅读USB协议的第9章。
下面我们就主要介绍OHCI规范是如何完成USB设备枚举的。前面我们已经介绍过了,OHCI数据传输主要依靠ED和TD,其中TD是挂靠在ED上的。ED主要用来设置传输的各种参数,TD则主要负责具体的数据传输。根据USB协议,USB的设备枚举只涉及控制传输。控制传输最少有两个事务阶段:建立和状态,控制传输可以有选择性地包括建立和状态阶段之间的数据阶段。在这里,控制写传输不需要数据阶段,而控制读需要在建立和状态之间添加主机要读取到的数据。一般来说,完成一次控制写传输需要3个TD:第一个发送Setup包,第二个用于接收握手或零长度的数据包,第三个用于发送状态;而完成一次控制读传输需要4个TD:第一个发送Setup包,第二个用于接收数据,第三个用于发送一个零长度的数据包,,第四个用于接收状态。
下面给出具体的USB设备枚举的函数。在进行枚举之前,主机一定要确认有USB设备的存在。正确情况下,在确认过程中,如果在一段给定时间没有检测到设备,则主机认为没有USB设备。“一段给定的时间”应该由定时器来完成。在这里,为了简化程序,我们只用计数来代替定时。
int USB_Enum()
{
int i;
//判断有无USB设备
for(i=0;i<100000;i++)
{
if (rHcRhPortStatus1 & 0x01)
{
rHcRhPortStatus1 = (1 << 4); // 端口复位
while (rHcRhPortStatus1 & (1 << 4))
; // 等待复位结束
rHcRhPortStatus1 = (1 << 1); // 使能该端口
break;
}
else if (rHcRhPortStatus2 & 0x01)
{
rHcRhPortStatus2 = (1 << 4); // 端口复位
while (rHcRhPortStatus2 & (1 << 4))
; // 等待复位结束
rHcRhPortStatus2 = (1 << 1); // 使能该端口
break;
}
}
if (i>90000)
return 0x44;
//第一步,主机得到设备描述符
CreateEd(
(unsigned int) &ed, // ED Address
64, // Max packet
0, // TD format
0, // Skip
0, // Speed
0x0, // Direction
0x0, // Endpoint
0x0, // Func Address,初始为0
(unsigned int) &td[3], // TDQTailPointer
(unsigned int) &td[0], // TDQHeadPointer
0, // ToggleCarry
0x0); // NextED
// 建立PID
CreateGenTd(
(unsigned int) &td[0], // TD Address
2, // Data Toggle
0x2, // DelayInterrupt
0x0, // Direction
1, // Buffer Rounding
(unsigned int) pSetup1, // Current Buffer Pointer,定义的全局变量数组
//const char pSetup1[8] = {0x80,0x06,0x00,0x01,0x00,0x00,0x40,0x00};
(unsigned int) &td[1], // Next TD
8); // Buffer Length
// 接收数据
CreateGenTd(
(unsigned int) &td[1], // TD Address
0, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
(unsigned int) pData1, // Current Buffer Pointer,定义的全局变量数组
// char pData1[0x40]; 通过读取该数组,可以获知设备描述符
(unsigned int) &td[2], // Next TD
0x40); // Buffer Length
// 零长度数据包
CreateGenTd(
(unsigned int) &td[2], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x1, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) &td[3], // Next TD
0x0); // Buffer Length
//接收状态
CreateGenTd(
(unsigned int) &td[3], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) 0, // Next TD
0x0); // Buffer Length
//设置寄存器
rHcControlHeadED = (unsigned int )& ed;
rHcControlCurrentED = (unsigned int )& ed;
// 控制列表处理使能,开始工作
rHcControl = 0x90;
//通知HC控制列表已填充
rHcCommandStatus = 0x02;
//第二步 为设备分配地址
CreateEd(
(unsigned int) &ed, // ED Address
64, // Max packet
0, // TD format
0, // Skip
0, // Speed
0x0, // Direction
0, // Endpoint
0, // Func Address
(unsigned int) &td[2], // TDQTailPointer
(unsigned int) &td[0], // TDQHeadPointer
0, // ToggleCarry
0x0); // NextED
//建立PID
CreateGenTd(
(unsigned int) &td[0], // TD Address
2, // Data Toggle
2, // DelayInterrupt
0, // Direction
1, // Buffer Rounding
(unsigned int) pSetup2, // Current Buffer Pointer,定义的全局变量数组
//const char pSetup2[8] = {0x00,0x05,0x02,0x00,0x00,0x00,0x00,0x00};
(unsigned int) &td[1], // Next TD
8); // Buffer Length
//接收零长度数据包
CreateGenTd(
(unsigned int) &td[1], // TD Address
0, // Data Toggle
2, // DelayInterrupt
2, // Direction
1, // Buffer Rounding
(unsigned int) 0, // Current Buffer Pointer
(unsigned int) &td[2], // Next TD
0); // Buffer Length
//发送状态
CreateGenTd(
(unsigned int) &td[2], // TD Address
3, // Data Toggle
2, // DelayInterrupt
1, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) 0, // Next TD
0x0); // Buffer Length
rHcControlHeadED = (unsigned int )& ed;
rHcControlCurrentED = (unsigned int )& ed;
rHcControl = 0x90;
rHcCommandStatus = 0x02;
//第三步,主机用新的地址再次获取设备描述符
CreateEd(
(unsigned int) &ed, // ED Address
64, // Max packet
0, // TD format
0, // Skip
0, // Speed
0x0, // Direction
0x0, // Endpoint
0x2, // Func Address,新的地址
(unsigned int) &td[3], // TDQTailPointer
(unsigned int) &td[0], // TDQHeadPointer
0, // ToggleCarry
0x0); // NextED
CreateGenTd(
(unsigned int) &td[0], // TD Address
2, // Data Toggle
0x2, // DelayInterrupt
0x0, // Direction
1, // Buffer Rounding
(unsigned int) pSetup3, // Current Buffer Pointer,定义的全局变量数组
//const char pSetup3[8] = {0x80,0x06,0x00,0x01,0x00,0x00,0x12,0x00};
(unsigned int) &td[1], // Next TD
8); // Buffer Length
CreateGenTd(
(unsigned int) &td[1], // TD Address
0, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
(unsigned int) pData3, // Current Buffer Pointer,定义的全局变量数组
// char pData3[0x12]; 通过读取该数组,可以获知设备描述符
(unsigned int) &td[2], // Next TD
0x12); // Buffer Length
CreateGenTd(
(unsigned int) &td[2], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x1, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) &td[3], // Next TD
0x0); // Buffer Length
CreateGenTd(
(unsigned int) &td[3], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) 0, // Next TD
0x0); // Buffer Length
rHcControlHeadED = (unsigned int )& ed;
rHcControlCurrentED = (unsigned int )& ed;
rHcControl = 0x90;
rHcCommandStatus = 0x02;
//第四步,主机读取设备全部配置描述符
CreateEd(
(unsigned int) &ed, // ED Address
64, // Max packet
0, // TD format
0, // Skip
0, // Speed
0x0, // Direction
0x0, // Endpoint
0x2, // Func Address
(unsigned int) &td[3], // TDQTailPointer
(unsigned int) &td[0], // TDQHeadPointer
0, // ToggleCarry
0x0); // NextED
CreateGenTd(
(unsigned int) &td[0], // TD Address
2, // Data Toggle
0x2, // DelayInterrupt
0x0, // Direction
1, // Buffer Rounding
(unsigned int) pSetup4, // Current Buffer Pointer,定义的全局变量数组
//const char pSetup4[8] = {0x80,0x06,0x00,0x02,0x00,0x00,0x40,0x00};
(unsigned int) &td[1], // Next TD
8); // Buffer Length
CreateGenTd(
(unsigned int) &td[1], // TD Address
0, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
(unsigned int) pData4, // Current Buffer Pointer,定义的全局变量数组
// char pData4[0x40]; 通过读取该数组,可以获知配置描述符
(unsigned int) &td[2], // Next TD
0x40); // Buffer Length
CreateGenTd(
(unsigned int) &td[2], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x1, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) &td[3], // Next TD
0x0); // Buffer Length
CreateGenTd(
(unsigned int) &td[3], // TD Address
3, // Data Toggle
0x2, // DelayInterrupt
0x2, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) 0, // Next TD
0x0); // Buffer Length
rHcControlHeadED = (unsigned int )& ed;
rHcControlCurrentED = (unsigned int )& ed;
rHcControl = 0x90;
rHcCommandStatus = 0x02;
//第五步,主机发送SETUP数据包,用以设置配置,允许所有端点进入工作状态。
CreateEd(
(unsigned int) &ed, // ED Address
64, // Max packet
0, // TD format
0, // Skip
0, // Speed
0x0, // Direction
0, // Endpoint
2, // Func Address
(unsigned int) &td[2], // TDQTailPointer
(unsigned int) &td[0], // TDQHeadPointer
0, // ToggleCarry
0x0); // NextED
CreateGenTd(
(unsigned int) &td[0], // TD Address
2, // Data Toggle
2, // DelayInterrupt
0, // Direction
1, // Buffer Rounding
(unsigned int) pSetup5, // Current Buffer Pointer,定义的全局变量数组
//const char pSetup5[8] = {0x00,0x09,0x01,0x00,0x00,0x00,0x00,0x00};
(unsigned int) &td[1], // Next TD
8); // Buffer Length
CreateGenTd(
(unsigned int) &td[1], // TD Address
0, // Data Toggle
2, // DelayInterrupt
2, // Direction
1, // Buffer Rounding
(unsigned int) 0, // Current Buffer Pointer
(unsigned int) &td[2], // Next TD
0); // Buffer Length
CreateGenTd(
(unsigned int) &td[2], // TD Address
3, // Data Toggle
2, // DelayInterrupt
1, // Direction
1, // Buffer Rounding
0x0, // Current Buffer Pointer
(unsigned int) 0, // Next TD
0x0); // Buffer Length
rHcControlHeadED = (unsigned int )& ed;
rHcControlCurrentED = (unsigned int )& ed;
rHcControl = 0x90;
rHcCommandStatus = 0x02;
return 0x88;
}