Support ICC build .

[mirror_edk2.git] / MdeModulePkg / Bus / Usb / UsbMassStorageDxe / UsbMassBot.h

/** @file\r
\r
Copyright (c) 2007, 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
  UsbMassBot.h\r
\r
Abstract:\r
\r
  Defination for the USB mass storage Bulk-Only Transport protocol.\r
  This implementation is based on the "Universal Serial Bus Mass\r
  Storage Class Bulk-Only Transport" Revision 1.0, September 31, 1999.\r
\r
Revision History\r
\r
\r
**/\r
\r
#ifndef _EFI_USBMASS_BOT_H_\r
#define _EFI_USBMASS_BOT_H_\r
\r
enum {\r
  //\r
  // Usb Bulk-Only class specfic request\r
  //\r
  USB_BOT_RESET_REQUEST    = 0xFF,       // Bulk-Only Mass Storage Reset\r
  USB_BOT_GETLUN_REQUEST   = 0xFE,       // Get Max Lun\r
  USB_BOT_CBW_SIGNATURE    = 0x43425355, // dCBWSignature, tag the packet as CBW\r
  USB_BOT_CSW_SIGNATURE    = 0x53425355, // dCSWSignature, tag the packet as CSW\r
  USB_BOT_MAX_LUN          = 0x0F,       // Lun number is from 0 to 15\r
  USB_BOT_MAX_CMDLEN       = 16,         // Maxium number of command from command set\r
\r
  //\r
  // Usb BOT command block status values\r
  //\r
  USB_BOT_COMMAND_OK       = 0x00, // Command passed, good status\r
  USB_BOT_COMMAND_FAILED   = 0x01, // Command failed\r
  USB_BOT_COMMAND_ERROR    = 0x02, // Phase error, need to reset the device\r
\r
  //\r
  // Usb Bot retry to get CSW, refers to specification[BOT10-5.3, it says 2 times]\r
  //\r
  USB_BOT_RECV_CSW_RETRY       = 3,\r
\r
  //\r
  // Usb Bot wait device reset complete, set by experience\r
  //  \r
  USB_BOT_RESET_DEVICE_STALL   = 100 * USB_MASS_1_MILLISECOND,\r
  \r
  //\r
  // Usb Bot transport timeout, set by experience\r
  //\r
  USB_BOT_SEND_CBW_TIMEOUT     = 3 * USB_MASS_1_SECOND,\r
  USB_BOT_RECV_CSW_TIMEOUT     = 3 * USB_MASS_1_SECOND,\r
  USB_BOT_RESET_DEVICE_TIMEOUT = 3 * USB_MASS_1_SECOND\r
};\r
\r
//\r
// The CBW (Command Block Wrapper) and CSW (Command Status Wrapper)\r
// structures used by the Usb BOT protocol.\r
//\r
#pragma pack(1)\r
typedef struct {\r
  UINT32              Signature;\r
  UINT32              Tag;\r
  UINT32              DataLen;  // Length of data between CBW and CSW\r
  UINT8               Flag;     // Bit 7, 0 ~ Data-Out, 1 ~ Data-In\r
  UINT8               Lun;      // Lun number. Bits 0~3 are used\r
  UINT8               CmdLen;   // Length of the command. Bits 0~4 are used\r
  UINT8               CmdBlock[USB_BOT_MAX_CMDLEN];\r
} USB_BOT_CBW;\r
\r
typedef struct {\r
  UINT32              Signature;\r
  UINT32              Tag;\r
  UINT32              DataResidue;\r
  UINT8               CmdStatus;\r
} USB_BOT_CSW;\r
#pragma pack()\r
\r
//\r
// Put Interface at the first field is to make it easy to get by Context, which\r
// could be BOT/CBI Protocol instance\r
//\r
typedef struct {\r
  EFI_USB_INTERFACE_DESCRIPTOR  Interface;\r
  EFI_USB_ENDPOINT_DESCRIPTOR   *BulkInEndpoint;\r
  EFI_USB_ENDPOINT_DESCRIPTOR   *BulkOutEndpoint;\r
  UINT32                        CbwTag;\r
  EFI_USB_IO_PROTOCOL           *UsbIo;\r
} USB_BOT_PROTOCOL;\r
\r
extern USB_MASS_TRANSPORT mUsbBotTransport;\r
#endif\r