Fix track EDKT104: If a module use PCD, MSA of this module should use PcdLib libraryC...

[mirror_edk2.git] / EdkModulePkg / Bus / Usb / UsbBus / Dxe / usbbus.h

/*++\r
Copyright (c) 2006, Intel Corporation                                                         \r
All rights reserved. This program and the accompanying materials                          \r
are licensed and made available under the terms and conditions of the BSD License         \r
which accompanies this distribution.  The full text of the license may be found at        \r
http://opensource.org/licenses/bsd-license.php                                            \r
                                                                                          \r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
  Module Name:\r
\r
    usbbus.h\r
\r
  Abstract:\r
\r
    Header file for USB bus driver Interface\r
\r
  Revision History\r
\r
\r
\r
--*/\r
\r
#ifndef _EFI_USB_BUS_H\r
#define _EFI_USB_BUS_H\r
\r
\r
#include <IndustryStandard/Usb.h>\r
#include "hub.h"\r
#include "usbutil.h"\r
\r
//#ifdef EFI_DEBUG\r
extern UINTN  gUSBDebugLevel;\r
extern UINTN  gUSBErrorLevel;\r
//#endif\r
\r
#define MICROSECOND 10000\r
#define ONESECOND   (1000 * MICROSECOND)\r
#define BUSPOLLING_PERIOD ONESECOND\r
//\r
// We define some maximun value here\r
//\r
#define USB_MAXCONFIG               8\r
#define USB_MAXALTSETTING           4\r
#define USB_MAXINTERFACES           32\r
#define USB_MAXENDPOINTS            16\r
#define USB_MAXSTRINGS              16\r
#define USB_MAXLANID                16\r
#define USB_MAXCHILDREN             8\r
#define USB_MAXCONTROLLERS          4\r
\r
#define USB_IO_CONTROLLER_SIGNATURE EFI_SIGNATURE_32 ('u', 's', 'b', 'd')\r
\r
typedef struct {\r
  LIST_ENTRY      Link;\r
  UINT16          StringIndex;\r
  CHAR16          *String;\r
} STR_LIST_ENTRY;\r
\r
typedef struct {\r
  LIST_ENTRY                  Link;\r
  UINT16                      Toggle;\r
  EFI_USB_ENDPOINT_DESCRIPTOR EndpointDescriptor;\r
} ENDPOINT_DESC_LIST_ENTRY;\r
\r
typedef struct {\r
  LIST_ENTRY                    Link;\r
  EFI_USB_INTERFACE_DESCRIPTOR  InterfaceDescriptor;\r
  LIST_ENTRY                    EndpointDescListHead;\r
} INTERFACE_DESC_LIST_ENTRY;\r
\r
typedef struct {\r
  LIST_ENTRY                Link;\r
  EFI_USB_CONFIG_DESCRIPTOR CongfigDescriptor;\r
  LIST_ENTRY                InterfaceDescListHead;\r
  UINTN                     ActiveInterface;\r
} CONFIG_DESC_LIST_ENTRY;\r
\r
//\r
// Forward declaring\r
//\r
struct usb_io_device;\r
\r
//\r
// This is used to form the USB Controller Handle\r
//\r
typedef struct usb_io_controller_device {\r
  UINTN                           Signature;\r
  EFI_HANDLE                      Handle;\r
  EFI_USB_IO_PROTOCOL             UsbIo;\r
  EFI_DEVICE_PATH_PROTOCOL        *DevicePath;\r
  EFI_HANDLE                      HostController;\r
  UINT8                           CurrentConfigValue;\r
  UINT8                           InterfaceNumber;\r
  struct usb_io_device            *UsbDevice;\r
\r
  BOOLEAN                         IsUsbHub;\r
  BOOLEAN                         IsManagedByDriver;\r
\r
  //\r
  // Fields specified for USB Hub\r
  //\r
  EFI_EVENT                       HubNotify;\r
  UINT8                           HubEndpointAddress;\r
  UINT8                           StatusChangePort;\r
  UINT8                           DownstreamPorts;\r
\r
  UINT8                           ParentPort;\r
  struct usb_io_controller_device *Parent;\r
  struct usb_io_device            *Children[USB_MAXCHILDREN];\r
} USB_IO_CONTROLLER_DEVICE;\r
\r
#define USB_IO_CONTROLLER_DEVICE_FROM_USB_IO_THIS(a) \\r
    CR(a, USB_IO_CONTROLLER_DEVICE, UsbIo, USB_IO_CONTROLLER_SIGNATURE)\r
\r
//\r
// This is used to keep the topology of USB bus\r
//\r
struct _usb_bus_controller_device;\r
\r
typedef struct usb_io_device {\r
  UINT8                             DeviceAddress;\r
  BOOLEAN                           IsConfigured;\r
  BOOLEAN                           IsSlowDevice;\r
  EFI_USB_DEVICE_DESCRIPTOR         DeviceDescriptor;\r
  LIST_ENTRY                        ConfigDescListHead;\r
  CONFIG_DESC_LIST_ENTRY            *ActiveConfig;\r
  UINT16                            LangID[USB_MAXLANID];\r
\r
  struct _usb_bus_controller_device *BusController;\r
\r
  //\r
  // Track the controller handle\r
  //\r
  UINT8                             NumOfControllers;\r
  USB_IO_CONTROLLER_DEVICE          *UsbController[USB_MAXCONTROLLERS];\r
\r
} USB_IO_DEVICE;\r
\r
//\r
// Usb Bus Controller device strcuture\r
//\r
#define EFI_USB_BUS_PROTOCOL_GUID \\r
 { 0x2B2F68CC, 0x0CD2, 0x44cf, { 0x8E, 0x8B, 0xBB, 0xA2, 0x0B, 0x1B, 0x5B, 0x75  } }\r
\r
typedef struct _EFI_USB_BUS_PROTOCOL {\r
  UINT64  Reserved;\r
} EFI_USB_BUS_PROTOCOL;\r
\r
#define USB_BUS_DEVICE_SIGNATURE  EFI_SIGNATURE_32 ('u', 'b', 'u', 's')\r
\r
typedef struct _usb_bus_controller_device {\r
  UINTN                     Signature;\r
\r
  EFI_USB_BUS_PROTOCOL      BusIdentify;\r
  EFI_USB_HC_PROTOCOL       *UsbHCInterface;\r
  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;\r
  UINT8                     AddressPool[16];\r
  USB_IO_DEVICE             *Root;\r
} USB_BUS_CONTROLLER_DEVICE;\r
\r
#define USB_BUS_CONTROLLER_DEVICE_FROM_THIS(a) \\r
    CR(a, USB_BUS_CONTROLLER_DEVICE, BusIdentify, USB_BUS_DEVICE_SIGNATURE)\r
\r
\r
//\r
// Global Variables\r
//\r
extern EFI_DRIVER_BINDING_PROTOCOL  gUsbBusDriverBinding;\r
extern EFI_COMPONENT_NAME_PROTOCOL  gUsbBusComponentName;\r
extern EFI_GUID                     gUSBBusDriverGuid;\r
\r
//\r
// Usb Device Configuration functions\r
//\r
BOOLEAN\r
IsHub (\r
  IN USB_IO_CONTROLLER_DEVICE     *Dev\r
  );\r
\r
EFI_STATUS\r
UsbGetStringtable (\r
  IN  USB_IO_DEVICE     *UsbIoDevice\r
  );\r
\r
EFI_STATUS\r
UsbGetAllConfigurations (\r
  IN  USB_IO_DEVICE     *UsbIoDevice\r
  );\r
\r
EFI_STATUS\r
UsbSetConfiguration (\r
  IN  USB_IO_DEVICE     *Dev,\r
  IN  UINTN             ConfigurationValue\r
  );\r
\r
EFI_STATUS\r
UsbSetDefaultConfiguration (\r
  IN  USB_IO_DEVICE     *Dev\r
  );\r
\r
//\r
// Device Deconfiguration functions\r
//\r
VOID\r
UsbDestroyAllConfiguration (\r
  IN USB_IO_DEVICE     *UsbIoDevice\r
  );\r
\r
EFI_STATUS\r
DoHubConfig (\r
  IN USB_IO_CONTROLLER_DEVICE     *HubIoDevice\r
  );\r
\r
VOID\r
GetDeviceEndPointMaxPacketLength (\r
  IN EFI_USB_IO_PROTOCOL    *UsbIo,\r
  IN  UINT8                 EndpointAddr,\r
  OUT UINT8                 *MaxPacketLength\r
  );\r
\r
VOID\r
GetDataToggleBit (\r
  IN EFI_USB_IO_PROTOCOL    *UsbIo,\r
  IN  UINT8                 EndpointAddr,\r
  OUT UINT8                 *DataToggle\r
  );\r
\r
VOID\r
SetDataToggleBit (\r
  IN EFI_USB_IO_PROTOCOL    *UsbIo,\r
  IN UINT8                  EndpointAddr,\r
  IN UINT8                  DataToggle\r
  );\r
\r
INTERFACE_DESC_LIST_ENTRY *\r
FindInterfaceListEntry (\r
  IN EFI_USB_IO_PROTOCOL    *This\r
  );\r
\r
ENDPOINT_DESC_LIST_ENTRY *\r
FindEndPointListEntry (\r
  IN EFI_USB_IO_PROTOCOL    *This,\r
  IN UINT8                  EndPointAddress\r
  );\r
\r
\r
EFI_STATUS\r
IsDeviceDisconnected (\r
  IN USB_IO_CONTROLLER_DEVICE    *UsbIoController,\r
  IN OUT BOOLEAN                 *Disconnected\r
  );\r
\r
EFI_STATUS\r
UsbDeviceDeConfiguration (\r
  IN USB_IO_DEVICE     *UsbIoDevice\r
  );\r
\r
\r
#endif\r