transport.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:5k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /* Driver for USB Mass Storage compliant devices
  2.  * Transport Functions Header File
  3.  *
  4.  * $Id: transport.h,v 1.15 2001/03/17 20:06:23 jrmayfield Exp $
  5.  *
  6.  * Current development and maintenance by:
  7.  *   (c) 1999, 2000 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
  8.  *
  9.  * This driver is based on the 'USB Mass Storage Class' document. This
  10.  * describes in detail the protocol used to communicate with such
  11.  * devices.  Clearly, the designers had SCSI and ATAPI commands in
  12.  * mind when they created this document.  The commands are all very
  13.  * similar to commands in the SCSI-II and ATAPI specifications.
  14.  *
  15.  * It is important to note that in a number of cases this class
  16.  * exhibits class-specific exemptions from the USB specification.
  17.  * Notably the usage of NAK, STALL and ACK differs from the norm, in
  18.  * that they are used to communicate wait, failed and OK on commands.
  19.  *
  20.  * Also, for certain devices, the interrupt endpoint is used to convey
  21.  * status of a command.
  22.  *
  23.  * Please see http://www.one-eyed-alien.net/~mdharm/linux-usb for more
  24.  * information about this driver.
  25.  *
  26.  * This program is free software; you can redistribute it and/or modify it
  27.  * under the terms of the GNU General Public License as published by the
  28.  * Free Software Foundation; either version 2, or (at your option) any
  29.  * later version.
  30.  *
  31.  * This program is distributed in the hope that it will be useful, but
  32.  * WITHOUT ANY WARRANTY; without even the implied warranty of
  33.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  34.  * General Public License for more details.
  35.  *
  36.  * You should have received a copy of the GNU General Public License along
  37.  * with this program; if not, write to the Free Software Foundation, Inc.,
  38.  * 675 Mass Ave, Cambridge, MA 02139, USA.
  39.  */
  40. #ifndef _TRANSPORT_H_
  41. #define _TRANSPORT_H_
  42. #include <linux/config.h>
  43. #include <linux/blk.h>
  44. #include "usb.h"
  45. #include "scsi.h"
  46. /* Protocols */
  47. #define US_PR_CBI 0x00 /* Control/Bulk/Interrupt */
  48. #define US_PR_CB 0x01 /* Control/Bulk w/o interrupt */
  49. #define US_PR_BULK 0x50 /* bulk only */
  50. #ifdef CONFIG_USB_STORAGE_HP8200e
  51. #define US_PR_SCM_ATAPI 0x80 /* SCM-ATAPI bridge */
  52. #endif
  53. #ifdef CONFIG_USB_STORAGE_SDDR09
  54. #define US_PR_EUSB_SDDR09 0x81 /* SCM-SCSI bridge for
  55. SDDR-09 */
  56. #endif
  57. #define US_PR_DPCM_USB  0xf0 /* Combination CB/SDDR09 */
  58. #ifdef CONFIG_USB_STORAGE_FREECOM
  59. #define US_PR_FREECOM   0xf1            /* Freecom */
  60. #endif
  61. #ifdef CONFIG_USB_STORAGE_DATAFAB
  62. #define US_PR_DATAFAB   0xf2            /* Datafab chipsets */
  63. #endif
  64. #ifdef CONFIG_USB_STORAGE_JUMPSHOT
  65. #define US_PR_JUMPSHOT  0xf3            /* Lexar Jumpshot */
  66. #endif
  67. /*
  68.  * Bulk only data structures
  69.  */
  70. /* command block wrapper */
  71. struct bulk_cb_wrap {
  72. __u32 Signature; /* contains 'USBC' */
  73. __u32 Tag; /* unique per command id */
  74. __u32 DataTransferLength; /* size of data */
  75. __u8 Flags; /* direction in bit 0 */
  76. __u8 Lun; /* LUN normally 0 */
  77. __u8 Length; /* of of the CDB */
  78. __u8 CDB[16]; /* max command */
  79. };
  80. #define US_BULK_CB_WRAP_LEN 31
  81. #define US_BULK_CB_SIGN 0x43425355 /*spells out USBC */
  82. #define US_BULK_FLAG_IN 1
  83. #define US_BULK_FLAG_OUT 0
  84. /* command status wrapper */
  85. struct bulk_cs_wrap {
  86. __u32 Signature; /* should = 'USBS' */
  87. __u32 Tag; /* same as original command */
  88. __u32 Residue; /* amount not transferred */
  89. __u8 Status; /* see below */
  90. __u8 Filler[18];
  91. };
  92. #define US_BULK_CS_WRAP_LEN 13
  93. #define US_BULK_CS_SIGN 0x53425355 /* spells out 'USBS' */
  94. #define US_BULK_STAT_OK 0
  95. #define US_BULK_STAT_FAIL 1
  96. #define US_BULK_STAT_PHASE 2
  97. /* bulk-only class specific requests */
  98. #define US_BULK_RESET_REQUEST 0xff
  99. #define US_BULK_GET_MAX_LUN 0xfe
  100. /*
  101.  * us_bulk_transfer() return codes
  102.  */
  103. #define US_BULK_TRANSFER_GOOD 0  /* good transfer                 */
  104. #define US_BULK_TRANSFER_SHORT 1  /* transfered less than expected */
  105. #define US_BULK_TRANSFER_FAILED 2  /* transfer died in the middle   */
  106. #define US_BULK_TRANSFER_ABORTED 3  /* transfer canceled             */
  107. /*
  108.  * Transport return codes
  109.  */
  110. #define USB_STOR_TRANSPORT_GOOD    0   /* Transport good, command good    */
  111. #define USB_STOR_TRANSPORT_FAILED  1   /* Transport good, command failed   */
  112. #define USB_STOR_TRANSPORT_ERROR   2   /* Transport bad (i.e. device dead) */
  113. #define USB_STOR_TRANSPORT_ABORTED 3   /* Transport aborted                */
  114. /*
  115.  * CBI accept device specific command
  116.  */
  117. #define US_CBI_ADSC 0
  118. extern void usb_stor_CBI_irq(struct urb*);
  119. extern int usb_stor_CBI_transport(Scsi_Cmnd*, struct us_data*);
  120. extern int usb_stor_CB_transport(Scsi_Cmnd*, struct us_data*);
  121. extern int usb_stor_CB_reset(struct us_data*);
  122. extern int usb_stor_Bulk_transport(Scsi_Cmnd*, struct us_data*);
  123. extern int usb_stor_Bulk_max_lun(struct us_data*);
  124. extern int usb_stor_Bulk_reset(struct us_data*);
  125. extern unsigned int usb_stor_transfer_length(Scsi_Cmnd*);
  126. extern void usb_stor_invoke_transport(Scsi_Cmnd*, struct us_data*);
  127. extern int usb_stor_transfer_partial(struct us_data*, char*, int);
  128. extern int usb_stor_bulk_msg(struct us_data*, void*, int, unsigned int,
  129. unsigned int*);
  130. extern int usb_stor_control_msg(struct us_data*, unsigned int, u8, u8,
  131. u16, u16, void*, u16);
  132. extern void usb_stor_transfer(Scsi_Cmnd*, struct us_data*);
  133. extern int usb_stor_clear_halt(struct usb_device*, int );
  134. #endif