Bootstrap

s3c2440 usb host

http://www.arm8.net/forum.php?mod=viewthread&tid=255

那么还必须先熟悉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;
}
;