xref: /linux/drivers/usb/storage/initializers.c (revision 5fd54ace4721fc5ce2bb5aef6318fcf17f421460)
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  * Please see http://www.one-eyed-alien.net/~mdharm/linux-usb for more
23  * information about this driver.
24  *
25  * This program is free software; you can redistribute it and/or modify it
26  * under the terms of the GNU General Public License as published by the
27  * Free Software Foundation; either version 2, or (at your option) any
28  * later version.
29  *
30  * This program is distributed in the hope that it will be useful, but
31  * WITHOUT ANY WARRANTY; without even the implied warranty of
32  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
33  * General Public License for more details.
34  *
35  * You should have received a copy of the GNU General Public License along
36  * with this program; if not, write to the Free Software Foundation, Inc.,
37  * 675 Mass Ave, Cambridge, MA 02139, USA.
38  */
39 
40 #include <linux/errno.h>
41 
42 #include "usb.h"
43 #include "initializers.h"
44 #include "debug.h"
45 #include "transport.h"
46 
47 /*
48  * This places the Shuttle/SCM USB<->SCSI bridge devices in multi-target
49  * mode
50  */
51 int usb_stor_euscsi_init(struct us_data *us)
52 {
53 	int result;
54 
55 	usb_stor_dbg(us, "Attempting to init eUSCSI bridge...\n");
56 	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
57 			0x0C, USB_RECIP_INTERFACE | USB_TYPE_VENDOR,
58 			0x01, 0x0, NULL, 0x0, 5 * HZ);
59 	usb_stor_dbg(us, "-- result is %d\n", result);
60 
61 	return 0;
62 }
63 
64 /*
65  * This function is required to activate all four slots on the UCR-61S2B
66  * flash reader
67  */
68 int usb_stor_ucr61s2b_init(struct us_data *us)
69 {
70 	struct bulk_cb_wrap *bcb = (struct bulk_cb_wrap*) us->iobuf;
71 	struct bulk_cs_wrap *bcs = (struct bulk_cs_wrap*) us->iobuf;
72 	int res;
73 	unsigned int partial;
74 	static char init_string[] = "\xec\x0a\x06\x00$PCCHIPS";
75 
76 	usb_stor_dbg(us, "Sending UCR-61S2B initialization packet...\n");
77 
78 	bcb->Signature = cpu_to_le32(US_BULK_CB_SIGN);
79 	bcb->Tag = 0;
80 	bcb->DataTransferLength = cpu_to_le32(0);
81 	bcb->Flags = bcb->Lun = 0;
82 	bcb->Length = sizeof(init_string) - 1;
83 	memset(bcb->CDB, 0, sizeof(bcb->CDB));
84 	memcpy(bcb->CDB, init_string, sizeof(init_string) - 1);
85 
86 	res = usb_stor_bulk_transfer_buf(us, us->send_bulk_pipe, bcb,
87 			US_BULK_CB_WRAP_LEN, &partial);
88 	if (res)
89 		return -EIO;
90 
91 	usb_stor_dbg(us, "Getting status packet...\n");
92 	res = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe, bcs,
93 			US_BULK_CS_WRAP_LEN, &partial);
94 	if (res)
95 		return -EIO;
96 
97 	return 0;
98 }
99 
100 /* This places the HUAWEI E220 devices in multi-port mode */
101 int usb_stor_huawei_e220_init(struct us_data *us)
102 {
103 	int result;
104 
105 	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
106 				      USB_REQ_SET_FEATURE,
107 				      USB_TYPE_STANDARD | USB_RECIP_DEVICE,
108 				      0x01, 0x0, NULL, 0x0, 1 * HZ);
109 	usb_stor_dbg(us, "Huawei mode set result is %d\n", result);
110 	return 0;
111 }
112