drivers/usb/storage/initializers.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * Special Initializers for certain USB Mass Storage devices
   4  *
   5  * Current development and maintenance by:
   6  *   (c) 1999, 2000 Matthew Dharm ([email protected])
   7  *
   8  * This driver is based on the 'USB Mass Storage Class' document. This
   9  * describes in detail the protocol used to communicate with such
  10  * devices.  Clearly, the designers had SCSI and ATAPI commands in
  11  * mind when they created this document.  The commands are all very
  12  * similar to commands in the SCSI-II and ATAPI specifications.
  13  *
  14  * It is important to note that in a number of cases this class
  15  * exhibits class-specific exemptions from the USB specification.
  16  * Notably the usage of NAK, STALL and ACK differs from the norm, in
  17  * that they are used to communicate wait, failed and OK on commands.
  18  *
  19  * Also, for certain devices, the interrupt endpoint is used to convey
  20  * status of a command.
  21  *
  22  * Please see http://www.one-eyed-alien.net/~mdharm/linux-usb for more
  23  * information about this driver.
  24  */
  25
  26 #include <linux/errno.h>
  27
  28 #include "usb.h"
  29 #include "initializers.h"
  30 #include "debug.h"
  31 #include "transport.h"
  32
  33 /*
  34  * This places the Shuttle/SCM USB<->SCSI bridge devices in multi-target
  35  * mode
  36  */
  37 int usb_stor_euscsi_init(struct us_data *us)
  38 {
  39         int result;
  40
  41         usb_stor_dbg(us, "Attempting to init eUSCSI bridge...\n");
  42         result = usb_stor_control_msg(us, us->send_ctrl_pipe,
  43                         0x0C, USB_RECIP_INTERFACE | USB_TYPE_VENDOR,
  44                         0x01, 0x0, NULL, 0x0, 5 * HZ);
  45         usb_stor_dbg(us, "-- result is %d\n", result);
  46
  47         return 0;
  48 }
  49
  50 /*
  51  * This function is required to activate all four slots on the UCR-61S2B
  52  * flash reader
  53  */
  54 int usb_stor_ucr61s2b_init(struct us_data *us)
  55 {
  56         struct bulk_cb_wrap *bcb = (struct bulk_cb_wrap*) us->iobuf;
  57         struct bulk_cs_wrap *bcs = (struct bulk_cs_wrap*) us->iobuf;
  58         int res;
  59         unsigned int partial;
  60         static char init_string[] = "\xec\x0a\x06\x00$PCCHIPS";
  61
  62         usb_stor_dbg(us, "Sending UCR-61S2B initialization packet...\n");
  63
  64         bcb->Signature = cpu_to_le32(US_BULK_CB_SIGN);
  65         bcb->Tag = 0;
  66         bcb->DataTransferLength = cpu_to_le32(0);
  67         bcb->Flags = bcb->Lun = 0;
  68         bcb->Length = sizeof(init_string) - 1;
  69         memset(bcb->CDB, 0, sizeof(bcb->CDB));
  70         memcpy(bcb->CDB, init_string, sizeof(init_string) - 1);
  71
  72         res = usb_stor_bulk_transfer_buf(us, us->send_bulk_pipe, bcb,
  73                         US_BULK_CB_WRAP_LEN, &partial);
  74         if (res)
  75                 return -EIO;
  76
  77         usb_stor_dbg(us, "Getting status packet...\n");
  78         res = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe, bcs,
  79                         US_BULK_CS_WRAP_LEN, &partial);
  80         if (res)
  81                 return -EIO;
  82
  83         return 0;
  84 }
  85
  86 /* This places the HUAWEI E220 devices in multi-port mode */
  87 int usb_stor_huawei_e220_init(struct us_data *us)
  88 {
  89         int result;
  90
  91         result = usb_stor_control_msg(us, us->send_ctrl_pipe,
  92                                       USB_REQ_SET_FEATURE,
  93                                       USB_TYPE_STANDARD | USB_RECIP_DEVICE,
  94                                       0x01, 0x0, NULL, 0x0, 1 * HZ);
  95         usb_stor_dbg(us, "Huawei mode set result is %d\n", result);
  96         return 0;
  97 }