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, fmt: "Attempting to init eUSCSI bridge...\n");
39 result = usb_stor_control_msg(us, pipe: us->send_ctrl_pipe,
40 request: 0x0C, USB_RECIP_INTERFACE | USB_TYPE_VENDOR,
41 value: 0x01, index: 0x0, NULL, size: 0x0, timeout: 5 * HZ);
42 usb_stor_dbg(us, fmt: "-- 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, fmt: "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, pipe: us->send_bulk_pipe, buf: bcb,
70 US_BULK_CB_WRAP_LEN, act_len: &partial);
71 if (res)
72 return -EIO;
73
74 usb_stor_dbg(us, fmt: "Getting status packet...\n");
75 res = usb_stor_bulk_transfer_buf(us, pipe: us->recv_bulk_pipe, buf: bcs,
76 US_BULK_CS_WRAP_LEN, act_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, pipe: us->send_ctrl_pipe,
89 USB_REQ_SET_FEATURE,
90 USB_TYPE_STANDARD | USB_RECIP_DEVICE,
91 value: 0x01, index: 0x0, NULL, size: 0x0, timeout: 1 * HZ);
92 usb_stor_dbg(us, fmt: "Huawei mode set result is %d\n", result);
93 return 0;
94}
95

source code of linux/drivers/usb/storage/initializers.c