UEFI中USB相关驱动的实现

刘德华海淀分华

已于 2022-02-22 17:15:05 修改

阅读量1.1k

点赞数

分类专栏：通信接口嵌入式文章标签： uefi usb xhci pci-e

于 2022-01-25 16:11:31 首次发布

本文链接：https://blog.csdn.net/qq_33559839/article/details/122679192

版权

本文探讨了UEFI环境下XHCI（Extensible Host Controller Interface）USB驱动的实现，涉及USB控制分类、热插拔原理、软件检测端口状态的方法。详细解析了USB_BUS结构体、USB_HUB_API类型定义、USB_INTERFACE以及UsbRootHubEnumeration函数，该函数通过UsbRootHubGetPortStatus获取端口状态，进一步理解XhciDxe驱动的工作流程。

摘要由CSDN通过智能技术生成

UEFI 中 XHCI 的实现

USB控制的分类:

 ohci 		uhci 		ehci		xhci
 
 Ohci:(open host controller interface)是支持USB1.1协议标准的，但是它不仅仅针对USB设备，
 	  还支持Apple的火线（firewire IEEE1394）接口。主要用于非x86的USB设备，如嵌入式设备的USB控制器。

 Uhci:(Universall host controller interface)是Intel主导的对USB1.0 1.1接口标准。与Ohci不兼容。
      Intel的VIA使用的就是uhci,和ohci相比uhci硬件设计比较简单，对应的软件驱动的任务比较重，实现的复杂。
      ohci硬件设计的比较复杂，软件驱动的任务就比较简单一些。所以ohci控制器的硬件成本比较高一些。

 Ehci:(Ehhanced host controller interface)是Intel主导的USB2.0协议标准，Ehci仅仅提供USB2.0的高速功能，
 	而依靠Uhci或者Ohci来提供对全速或者低速设备的支持。（Xhci同样如此，只提供高速功能）

 Xhci:(extensible host controller interface)是最新的USB3.0协议接口标准，在速度和节能，虚拟化等方面均有较大的提升。
 	支持各种速度的usb设备，对前面的2.0 1.0设备都兼容。USB3.0的驱动同样可以驱2.0的接口控制器。

 目前大部分键盘鼠标的控制器使用的是Ohci或者Uhci，而U盘等高速设备使用的是Ehci或者Xhci

热插拔实现的原理

 硬件设计：
 在最初的标准里，USB接头有4条线：电源，D-,D+,地线。后来OTG出现了，又增加了miniUSB接头。
 而miniUSB接头则有5条线，多了一条ID线, 用来标识身份用的。标准USB口只有A型和B型。
 其中每一型又分为插头和插座，例如A型插头，A型插座等。我们平常电脑上用的那种插座叫做A型USB插座，
 而相应的插头，叫做A型插头，例如U盘上那种。而像打印机上面那个插座，则是B型插座(比较四方的，没电脑上面那种扁)，
 相应的插头，就是B型插头。也许你见过一头方一头扁的USB延长线，没错了，扁的那头就叫做A型插头，
 而方的那头，就叫做B型插头，而相应的被插的那两个插座，就分别是A型插座和B型插座了。
 A型插头是插不进B型插座的，反之亦然。

 miniUSB也分为A型，B型，但增加了一个AB型.
 既然它叫做miniUSB,那么当然它就是很小的了，主要是给便携式设备用的，例如MP3、手机、数码相机等。
 USB是一主多从结构，即一个时刻只能有一台主机。像PC机就是一个主机，其它的只能是设备，
 因而两个设备之间是无法直接进行通信的。而USB OTG(on the go)的出现，则解决了这个矛盾：一个设备可以在某种场合下，
 改变身份，以主机的形式出现。因而就出现了AB型的miniUSB插座，不管是A型miniUSB插头，
 还是B型miniUSB插头，都可以插进去，而靠里面多出的那条ID线来识别它的身份：是主机还是从机。
 这样两个USB设备就可以直接连接起来，进行数据传送了。 像我们MP3上用的那中miniUSB插座，
 就是B型的miniUSB插座(注意,有一类miniUSB插座，似乎不是USB规范里面的，
 因为miniUSB接头应该有5条线,而这种插座只有4条线)。由于USB是支持热插拔的，因此它在接头的设计上也有相应的措施。
 USB插头的地引脚和电源引脚比较长，而两个数据引脚则比较短，这样在插入到插座中时，首先接通电源和地，
 然后再接通两个数据线。这样就可以保证电源在数据线之前接通，防止闩锁发生。至于USB电缆，通常我们不怎么关心，
 买现成的就行了，除非你是生产USB线缆的。在全速模式下需要使用带屏蔽的双绞电缆线，
 而低速模式模式则可以不用屏蔽和双绞。此外，USB协议规定，USB低速电缆长度不得超过3米，而全速电缆长度不得超过5米。
 这是因为线缆传输有延迟，要保证能够正确响应，就不能延迟太多。USB标准规定了里面信号线的颜色，
 其中Vbus为红色，D-为白色，D+为绿色，GND为黑色。然而，我见过很多USB线缆并没有遵循标准，
 所以大家在使用时要小心，用表测量一下比较可靠。

软件上如何检测port 是否有U盘插入

 在uefi的公共模块中UsbBusDxe中，USBBusControllerDriverStart函数，如果依赖的Protocolg 如 EfiDevicePathProtocolGuid
 已经安装，然后检测UsbBusId Protocol是否安装，如果没有安装，执行UsbBusBuildProtocol这个函数，这个函数主要初始化
 USB_BUS这样一个变量，来初始化USB BUS。（UsbBus Protocol是依赖与PCIBUS的，pci又依赖于PCI Host Bridege,
 他们之间的安装关系如下：**HostBride->PciBus->UsbBus->Xhci/Ehci**).

Status = UsbBusBuildProtocol (This, Controller, RemainingDevicePath);

/**
Install Usb Bus Protocol on host controller, and start the Usb bus.

@param This                    The USB bus driver binding instance.
@param Controller              The controller to check.
@param RemainingDevicePath     The remaining device patch.

@retval EFI_SUCCESS            The controller is controlled by the usb bus.
@retval EFI_ALREADY_STARTED    The controller is already controlled by the usb bus.
@retval EFI_OUT_OF_RESOURCES   Failed to allocate resources.

**/
EFI_STATUS
EFIAPI
UsbBusBuildProtocol (
IN EFI_DRIVER_BINDING_PROTOCOL  *This,
IN EFI_HANDLE                   Controller,
IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath
)
{
     
USB_BUS                 *UsbBus;
USB_DEVICE              *RootHub;
USB_INTERFACE           *RootIf;
EFI_STATUS              Status;
EFI_STATUS              Status2;

**UsbBus = AllocateZeroPool (sizeof (USB_BUS));**

if (UsbBus == NULL) {
     
	return EFI_OUT_OF_RESOURCES;
}	                                                                                                                                                                                                                                                            

UsbBus->Signature  = USB_BUS_SIGNATURE;
UsbBus->HostHandle = Controller;
UsbBus->MaxDevices = USB_MAX_DEVICES;

Status = gBS->OpenProtocol (
	            Controller,
    	        &gEfiDevicePathProtocolGuid,
        	    (VOID **) &UsbBus->DevicePath,
            	This->DriverBindingHandle,
              	Controller,
              	EFI_OPEN_PROTOCOL_BY_DRIVER
              	);   

if (EFI_ERROR (Status)) {
     
	DEBUG ((EFI_D_ERROR, "UsbBusStart: Failed to open device path %r\n", Status));

	FreePool (UsbBus);
	return Status;
}

 //
// Get USB_HC2/USB_HC host controller protocol (EHCI/UHCI).
// This is for backward compatibility with EFI 1.x. In UEFI
// 2.x, USB_HC2 replaces USB_HC. We will open both USB_HC2
// and USB_HC because EHCI driver will install both protocols
// (for the same reason). If we don't consume both of them,
// the unconsumed one may be opened by others.
//
Status = gBS->OpenProtocol (
	            Controller,
    	         &gEfiUsb2HcProtocolGuid,
        	     (VOID **) &(UsbBus->Usb2Hc),
            	 This->DriverBindingHandle,
              	 Controller,
              	 EFI_OPEN_PROTOCOL_BY_DRIVER
              	 );

Status2 = gBS->OpenProtocol (
	               Controller,
    	           &gEfiUsbHcProtocolGuid,
        	       (VOID **) &(UsbBus->UsbHc),
            	   This->DriverBindingHandle,
               		Controller,
               		EFI_OPEN_PROTOCOL_BY_DRIVER
               		);

if (EFI_ERROR (Status) && EFI_ERROR (Status2)) {
     
	DEBUG ((EFI_D_ERROR, "UsbBusStart: Failed to open USB_HC/USB2_HC %r\n", Status));

	Status = EFI_DEVICE_ERROR;
	goto CLOSE_HC;
}

if (!EFI_ERROR (Status)) {
     
	//
	// The EFI_USB2_HC_PROTOCOL is produced for XHCI support.
	// Then its max supported devices are 256. Otherwise it's 128.
	//
	ASSERT (UsbBus->Usb2Hc != NULL);
	if (UsbBus->Usb2Hc->MajorRevision == 0x3) {
     
  	UsbBus->MaxDevices = 256;
	}
}
			
//  
//fix up Ehci not work add by loongson  
// 
UsbHcReset (UsbBus, 	EFI_USB_HC_RESET_GLOBAL); 	 				  
UsbHcSetState (UsbBus, EfiUsbHcStateOperational);


//
// Install an EFI_USB_BUS_PROTOCOL to host controller to identify it.
//
Status = gBS->InstallProtocolInterface (
	              &Controller,
    	          &gEfiCallerIdGuid,
        	      EFI_NATIVE_INTERFACE,
            	  &UsbBus->BusId
              	);

if (EFI_ERROR (Status)) {
     
	DEBUG ((EFI_D_ERROR, "UsbBusStart: Failed to install bus protocol %r\n", Status));
	goto CLOSE_HC;
}

//
// Initial the wanted child device path list, and add first RemainingDevicePath
  //
InitializeListHead (&UsbBus->WantedUsbIoDPList);
Status = UsbBusAddWantedUsbIoDP (&UsbBus->BusId, RemainingDevicePath);
  ASSERT (!EFI_ERROR (Status));
//
// Create a fake usb device for root hub
//
RootHub = AllocateZeroPool (sizeof (USB_DEVICE));

if (RootHub == NULL) {
     
	Status = EFI_OUT_OF_RESOURCES;
	goto UNINSTALL_USBBUS;
}
  RootIf = AllocateZeroPool (sizeof (USB_INTERFACE));

if (RootIf == NULL) {
     
	FreePool (RootHub);
	Status = EFI_OUT_OF_RESOURCES;
	goto FREE_ROOTHUB;
}

RootHub->Bus            = UsbBus;
RootHub->NumOfInterface = 1;
RootHub->Interfaces[0]  = RootIf;
RootHub->Tier           = 0;
RootIf->Signature       = USB_INTERFACE_SIGNATURE;
RootIf->Device          = RootHub;
RootIf->DevicePath      = UsbBus->DevicePath;

//
// Report Status Code here since we will enumerate the USB devices
 //
REPORT_STATUS_CODE_WITH_DEVICE_PATH (
	EFI_PROGRESS_CODE,
	(EFI_IO_BUS_USB | EFI_IOB_PC_DETECT),
	UsbBus->DevicePath
	);

Status                  = mUsbRootHubApi.Init (RootIf);

if (EFI_ERROR (Status)) {
     
	DEBUG ((EFI_D_ERROR, "UsbBusStart: Failed to init root hub %r\n", Status));
	goto FREE_ROOTHUB;
}

UsbBus->Devices[0]

最低0.47元/天解锁文章

刘德华海淀分华

关注

0
点赞
踩
2

收藏

觉得还不错? 一键收藏
打赏
0
评论
UEFI中USB相关驱动的实现

UEFI 中 USB相关驱动调试总结USB控制的分类: ohci uhci ehci xhci Ohci:(open host controller interface)是支持USB1.1协议标准的，但是它不仅仅针对USB设备，还支持Apple的火线（firewire IEEE1394）接口。主要用于非x86的USB设备，如嵌入式设备的USB控制器。 Uhci:(Universall host controller interface)是Intel主导的对USB1.0 1
复制链接

扫一扫