1 // Driver for USB Mass Storage compliant devices
7 #include <linux/usb_usual.h>
8 #include <linux/blkdev.h>
9 #include <linux/completion.h>
10 #include <linux/mutex.h>
11 #include <scsi/scsi_host.h>
19 * Unusual device list definitions
22 struct us_unusual_dev
{
23 const char* vendorName
;
24 const char* productName
;
27 int (*initFunction
)(struct us_data
*);
31 #define REG_CARD_STATUS 0xFF83
32 #define REG_HW_TRAP1 0xFF89
34 // SRB Status. Refers /usr/include/wine/wine/wnaspi32.h & SCSI sense key
35 #define SS_SUCCESS 0x00 // No Sense
36 #define SS_NOT_READY 0x02
37 #define SS_MEDIUM_ERR 0x03
38 #define SS_HW_ERR 0x04
39 #define SS_ILLEGAL_REQUEST 0x05
40 #define SS_UNIT_ATTENTION 0x06
43 #define SD_INIT1_PATTERN 1
44 #define SD_INIT2_PATTERN 2
45 #define SD_RW_PATTERN 3
46 #define MS_INIT_PATTERN 4
47 #define MSP_RW_PATTERN 5
48 #define MS_RW_PATTERN 6
49 #define SM_INIT_PATTERN 7
50 #define SM_RW_PATTERN 8
55 typedef struct _SD_STATUS
{
64 } SD_STATUS
, *PSD_STATUS
;
66 typedef struct _MS_STATUS
{
75 } MS_STATUS
, *PMS_STATUS
;
77 typedef struct _SM_STATUS
{
84 } SM_STATUS
, *PSM_STATUS
;
87 #define SD_BLOCK_LEN 9 // 2^9 = 512 Bytes, The HW maximum read/write data length
89 /* Dynamic bitflag definitions (us->dflags): used in set_bit() etc. */
90 #define US_FLIDX_URB_ACTIVE 0 /* current_urb is in use */
91 #define US_FLIDX_SG_ACTIVE 1 /* current_sg is in use */
92 #define US_FLIDX_ABORTING 2 /* abort is in progress */
93 #define US_FLIDX_DISCONNECTING 3 /* disconnect in progress */
94 #define US_FLIDX_RESETTING 4 /* device reset in progress */
95 #define US_FLIDX_TIMED_OUT 5 /* SCSI midlayer timed out */
96 #define US_FLIDX_DONT_SCAN 6 /* don't scan (disconnect) */
99 #define USB_STOR_STRING_LEN 32
102 * We provide a DMA-mapped I/O buffer for use with small USB transfers.
103 * It turns out that CB[I] needs a 12-byte buffer and Bulk-only needs a
104 * 31-byte buffer. But Freecom needs a 64-byte buffer, so that's the
105 * size we'll allocate.
108 #define US_IOBUF_SIZE 64 /* Size of the DMA-mapped I/O buffer */
109 #define US_SENSE_SIZE 18 /* Size of the autosense data buffer */
111 typedef int (*trans_cmnd
)(struct scsi_cmnd
*, struct us_data
*);
112 typedef int (*trans_reset
)(struct us_data
*);
113 typedef void (*proto_cmnd
)(struct scsi_cmnd
*, struct us_data
*);
114 typedef void (*extra_data_destructor
)(void *); /* extra data destructor */
115 typedef void (*pm_hook
)(struct us_data
*, int); /* power management hook */
120 /* we allocate one of these for every device that we remember */
122 /* The device we're working with
123 * It's important to note:
124 * (o) you must hold dev_mutex to change pusb_dev
126 struct mutex dev_mutex
; /* protect pusb_dev */
127 struct usb_device
*pusb_dev
; /* this usb_device */
128 struct usb_interface
*pusb_intf
; /* this interface */
129 struct us_unusual_dev
*unusual_dev
; /* device-filter entry */
130 unsigned long fflags
; /* fixed flags from filter */
131 unsigned long dflags
; /* dynamic atomic bitflags */
132 unsigned int send_bulk_pipe
; /* cached pipe values */
133 unsigned int recv_bulk_pipe
;
134 unsigned int send_ctrl_pipe
;
135 unsigned int recv_ctrl_pipe
;
136 unsigned int recv_intr_pipe
;
138 /* information about the device */
139 char *transport_name
;
141 __le32 bcs_signature
;
146 u8 ifnum
; /* interface number */
147 u8 ep_bInterval
; /* interrupt interval */
149 /* function pointers for this device */
150 trans_cmnd transport
; /* transport function */
151 trans_reset transport_reset
; /* transport device reset */
152 proto_cmnd proto_handler
; /* protocol handler */
154 /* SCSI interfaces */
155 struct scsi_cmnd
*srb
; /* current srb */
156 unsigned int tag
; /* current dCBWTag */
158 /* control and bulk communications data */
159 struct urb
*current_urb
; /* USB requests */
160 struct usb_ctrlrequest
*cr
; /* control requests */
161 struct usb_sg_request current_sg
; /* scatter-gather req. */
162 unsigned char *iobuf
; /* I/O buffer */
163 unsigned char *sensebuf
; /* sense data buffer */
164 dma_addr_t cr_dma
; /* buffer DMA addresses */
165 dma_addr_t iobuf_dma
;
166 struct task_struct
*ctl_thread
; /* the control thread */
168 /* mutual exclusion and synchronization structures */
169 struct completion cmnd_ready
; /* to sleep thread on */
170 struct completion notify
; /* thread begin/end */
171 wait_queue_head_t delay_wait
; /* wait during scan, reset */
172 struct completion scanning_done
; /* wait for scan thread */
174 /* subdriver information */
175 void *extra
; /* Any extra data */
176 extra_data_destructor extra_destructor
;/* extra data destructor */
178 pm_hook suspend_resume_hook
;
185 //----- SD Control Data ----------------
186 //SD_REGISTER SD_Regs;
195 BYTE SD20_HIGH_CAPACITY
;
199 BYTE MMC_HIGH_CAPACITY
;
201 //----- MS Control Data ----------------
203 DWORD MSP_TotalBlock
;
204 MS_LibControl MS_Lib
;
208 //----- SM Control Data ----------------
217 //------Power Managerment ---------------
218 BOOLEAN Power_IsResum
;
221 /* Convert between us_data and the corresponding Scsi_Host */
222 static inline struct Scsi_Host
*us_to_host(struct us_data
*us
) {
223 return container_of((void *) us
, struct Scsi_Host
, hostdata
);
225 static inline struct us_data
*host_to_us(struct Scsi_Host
*host
) {
226 return (struct us_data
*) host
->hostdata
;
229 /* Function to fill an inquiry response. See usb.c for details */
230 extern void fill_inquiry_response(struct us_data
*us
,
231 unsigned char *data
, unsigned int data_len
);
233 /* The scsi_lock() and scsi_unlock() macros protect the sm_state and the
234 * single queue element srb for write access */
235 #define scsi_unlock(host) spin_unlock_irq(host->host_lock)
236 #define scsi_lock(host) spin_lock_irq(host->host_lock)