[mirror_ubuntu-focal-kernel.git] / drivers / usb / storage / initializers.c

// SPDX-License-Identifier: GPL-2.0+
/*
 * Special Initializers for certain USB Mass Storage devices
 *
 * Current development and maintenance by:
 *   (c) 1999, 2000 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
 *
 * This driver is based on the 'USB Mass Storage Class' document. This
 * describes in detail the protocol used to communicate with such
 * devices.  Clearly, the designers had SCSI and ATAPI commands in
 * mind when they created this document.  The commands are all very
 * similar to commands in the SCSI-II and ATAPI specifications.
 *
 * It is important to note that in a number of cases this class
 * exhibits class-specific exemptions from the USB specification.
 * Notably the usage of NAK, STALL and ACK differs from the norm, in
 * that they are used to communicate wait, failed and OK on commands.
 *
 * Also, for certain devices, the interrupt endpoint is used to convey
 * status of a command.
 */

#include <linux/errno.h>

#include "usb.h"
#include "initializers.h"
#include "debug.h"
#include "transport.h"

/*
 * This places the Shuttle/SCM USB<->SCSI bridge devices in multi-target
 * mode
 */
int usb_stor_euscsi_init(struct us_data *us)
{
	int result;

	usb_stor_dbg(us, "Attempting to init eUSCSI bridge...\n");
	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
			0x0C, USB_RECIP_INTERFACE | USB_TYPE_VENDOR,
			0x01, 0x0, NULL, 0x0, 5 * HZ);
	usb_stor_dbg(us, "-- result is %d\n", result);

	return 0;
}

/*
 * This function is required to activate all four slots on the UCR-61S2B
 * flash reader
 */
int usb_stor_ucr61s2b_init(struct us_data *us)
{
	struct bulk_cb_wrap *bcb = (struct bulk_cb_wrap*) us->iobuf;
	struct bulk_cs_wrap *bcs = (struct bulk_cs_wrap*) us->iobuf;
	int res;
	unsigned int partial;
	static char init_string[] = "\xec\x0a\x06\x00$PCCHIPS";

	usb_stor_dbg(us, "Sending UCR-61S2B initialization packet...\n");

	bcb->Signature = cpu_to_le32(US_BULK_CB_SIGN);
	bcb->Tag = 0;
	bcb->DataTransferLength = cpu_to_le32(0);
	bcb->Flags = bcb->Lun = 0;
	bcb->Length = sizeof(init_string) - 1;
	memset(bcb->CDB, 0, sizeof(bcb->CDB));
	memcpy(bcb->CDB, init_string, sizeof(init_string) - 1);

	res = usb_stor_bulk_transfer_buf(us, us->send_bulk_pipe, bcb,
			US_BULK_CB_WRAP_LEN, &partial);
	if (res)
		return -EIO;

	usb_stor_dbg(us, "Getting status packet...\n");
	res = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe, bcs,
			US_BULK_CS_WRAP_LEN, &partial);
	if (res)
		return -EIO;

	return 0;
}

/* This places the HUAWEI E220 devices in multi-port mode */
int usb_stor_huawei_e220_init(struct us_data *us)
{
	int result;

	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
				      USB_REQ_SET_FEATURE,
				      USB_TYPE_STANDARD | USB_RECIP_DEVICE,
				      0x01, 0x0, NULL, 0x0, 1 * HZ);
	usb_stor_dbg(us, "Huawei mode set result is %d\n", result);
	return 0;
}
Commit	Line	Data
5fd54ace	1	// SPDX-License-Identifier: GPL-2.0+
f0183a33 FB	2	/*
f0183a33 FB	3	* Special Initializers for certain USB Mass Storage devices
1da177e4 LT	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.
1da177e4 LT	21	*/
1da177e4 LT	22
1da177e4 LT	23	#include <linux/errno.h>
	24
	25	#include "usb.h"
	26	#include "initializers.h"
	27	#include "debug.h"
	28	#include "transport.h"
	29
f0183a33 FB	30	/*
	31	* This places the Shuttle/SCM USB<->SCSI bridge devices in multi-target
	32	* mode
	33	*/
1da177e4 LT	34	int usb_stor_euscsi_init(struct us_data *us)
	35	{
	36	int result;
	37
191648d0	38	usb_stor_dbg(us, "Attempting to init eUSCSI bridge...\n");
1da177e4 LT	39	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
1da177e4 LT	40	0x0C, USB_RECIP_INTERFACE \| USB_TYPE_VENDOR,
eab77694	41	0x01, 0x0, NULL, 0x0, 5 * HZ);
191648d0	42	usb_stor_dbg(us, "-- result is %d\n", result);
1da177e4 LT	43
	44	return 0;
	45	}
	46
f0183a33 FB	47	/*
	48	* This function is required to activate all four slots on the UCR-61S2B
	49	* flash reader
	50	*/
1da177e4 LT	51	int 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;
0354c1ac MS	55	int res;
0354c1ac MS	56	unsigned int partial;
1da177e4 LT	57	static char init_string[] = "\xec\x0a\x06\x00$PCCHIPS";
1da177e4 LT	58
191648d0	59	usb_stor_dbg(us, "Sending UCR-61S2B initialization packet...\n");
1da177e4 LT	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);
e05b8e6e PZ	71	if (res)
e05b8e6e PZ	72	return -EIO;
1da177e4	73
191648d0	74	usb_stor_dbg(us, "Getting status packet...\n");
1da177e4 LT	75	res = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe, bcs,
1da177e4 LT	76	US_BULK_CS_WRAP_LEN, &partial);
e05b8e6e PZ	77	if (res)
e05b8e6e PZ	78	return -EIO;
1da177e4	79
e05b8e6e	80	return 0;
1da177e4	81	}
d853d872	82
ab4b7164 BM	83	/* This places the HUAWEI E220 devices in multi-port mode */
ab4b7164 BM	84	int usb_stor_huawei_e220_init(struct us_data *us)
d853d872 JW	85	{
	86	int result;
	87
d853d872 JW	88	result = usb_stor_control_msg(us, us->send_ctrl_pipe,
	89	USB_REQ_SET_FEATURE,
	90	USB_TYPE_STANDARD \| USB_RECIP_DEVICE,
a88098bd	91	0x01, 0x0, NULL, 0x0, 1 * HZ);
191648d0	92	usb_stor_dbg(us, "Huawei mode set result is %d\n", result);
d0defb85	93	return 0;
d853d872	94	}