LXR linux/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 (mdharm-usb@one-eyed-alien.net)
   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
  23#include <linux/errno.h>
  24
  25#include "usb.h"
  26#include "initializers.h"
  27#include "debug.h"
  28#include "transport.h"
  29
  30/*
  31 * This places the Shuttle/SCM USB<->SCSI bridge devices in multi-target
  32 * mode
  33 */
  34int usb_stor_euscsi_init(struct us_data *us)
  35{
  36        int result;
  37
  38        usb_stor_dbg(us, "Attempting to init eUSCSI bridge...\n");
  39        result = usb_stor_control_msg(us, us->send_ctrl_pipe,
  40                        0x0C, USB_RECIP_INTERFACE | USB_TYPE_VENDOR,
  41                        0x01, 0x0, NULL, 0x0, 5 * HZ);
  42        usb_stor_dbg(us, "-- result is %d\n", result);
  43
  44        return 0;
  45}
  46
  47/*
  48 * This function is required to activate all four slots on the UCR-61S2B
  49 * flash reader
  50 */
  51int usb_stor_ucr61s2b_init(struct us_data *us)
  52{
  53        struct bulk_cb_wrap *bcb = (struct bulk_cb_wrap*) us->iobuf;
  54        struct bulk_cs_wrap *bcs = (struct bulk_cs_wrap*) us->iobuf;
  55        int res;
  56        unsigned int partial;
  57        static char init_string[] = "\xec\x0a\x06\x00$PCCHIPS";
  58
  59        usb_stor_dbg(us, "Sending UCR-61S2B initialization packet...\n");
  60
  61        bcb->Signature = cpu_to_le32(US_BULK_CB_SIGN);
  62        bcb->Tag = 0;
  63        bcb->DataTransferLength = cpu_to_le32(0);
  64        bcb->Flags = bcb->Lun = 0;
  65        bcb->Length = sizeof(init_string) - 1;
  66        memset(bcb->CDB, 0, sizeof(bcb->CDB));
  67        memcpy(bcb->CDB, init_string, sizeof(init_string) - 1);
  68
  69        res = usb_stor_bulk_transfer_buf(us, us->send_bulk_pipe, bcb,
  70                        US_BULK_CB_WRAP_LEN, &partial);
  71        if (res)
  72                return -EIO;
  73
  74        usb_stor_dbg(us, "Getting status packet...\n");
  75        res = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe, bcs,
  76                        US_BULK_CS_WRAP_LEN, &partial);
  77        if (res)
  78                return -EIO;
  79
  80        return 0;
  81}
  82
  83/* This places the HUAWEI E220 devices in multi-port mode */
  84int usb_stor_huawei_e220_init(struct us_data *us)
  85{
  86        int result;
  87
  88        result = usb_stor_control_msg(us, us->send_ctrl_pipe,
  89                                      USB_REQ_SET_FEATURE,
  90                                      USB_TYPE_STANDARD | USB_RECIP_DEVICE,
  91                                      0x01, 0x0, NULL, 0x0, 1 * HZ);
  92        usb_stor_dbg(us, "Huawei mode set result is %d\n", result);
  93        return 0;
  94}
  95