xref: /linux/drivers/usb/gadget/legacy/tcm_usb_gadget.c (revision c771600c6af14749609b49565ffb4cac2959710d)
15fd54aceSGreg Kroah-Hartman // SPDX-License-Identifier: GPL-2.0
2c52661d6SSebastian Andrzej Siewior /* Target based USB-Gadget
3c52661d6SSebastian Andrzej Siewior  *
4c52661d6SSebastian Andrzej Siewior  * UAS protocol handling, target callbacks, configfs handling,
5c52661d6SSebastian Andrzej Siewior  * BBB (USB Mass Storage Class Bulk-Only (BBB) and Transport protocol handling.
6c52661d6SSebastian Andrzej Siewior  *
7c52661d6SSebastian Andrzej Siewior  * Author: Sebastian Andrzej Siewior <bigeasy at linutronix dot de>
8c52661d6SSebastian Andrzej Siewior  */
9c52661d6SSebastian Andrzej Siewior #include <linux/kernel.h>
10c52661d6SSebastian Andrzej Siewior #include <linux/module.h>
11c52661d6SSebastian Andrzej Siewior #include <linux/types.h>
12c52661d6SSebastian Andrzej Siewior #include <linux/string.h>
13c52661d6SSebastian Andrzej Siewior #include <linux/configfs.h>
14c52661d6SSebastian Andrzej Siewior #include <linux/ctype.h>
15c52661d6SSebastian Andrzej Siewior #include <linux/usb/ch9.h>
16c52661d6SSebastian Andrzej Siewior #include <linux/usb/composite.h>
17c52661d6SSebastian Andrzej Siewior #include <linux/usb/gadget.h>
18c52661d6SSebastian Andrzej Siewior #include <linux/usb/storage.h>
19c52661d6SSebastian Andrzej Siewior #include <scsi/scsi_tcq.h>
20c52661d6SSebastian Andrzej Siewior #include <target/target_core_base.h>
21c52661d6SSebastian Andrzej Siewior #include <target/target_core_fabric.h>
22*5f60d5f6SAl Viro #include <linux/unaligned.h>
23c52661d6SSebastian Andrzej Siewior 
2400240714SAndrzej Pietrasiewicz #include "u_tcm.h"
25c52661d6SSebastian Andrzej Siewior 
267d16e8d3SSebastian Andrzej Siewior USB_GADGET_COMPOSITE_OPTIONS();
277d16e8d3SSebastian Andrzej Siewior 
28c52661d6SSebastian Andrzej Siewior #define UAS_VENDOR_ID	0x0525	/* NetChip */
29c52661d6SSebastian Andrzej Siewior #define UAS_PRODUCT_ID	0xa4a5	/* Linux-USB File-backed Storage Gadget */
30c52661d6SSebastian Andrzej Siewior 
31c52661d6SSebastian Andrzej Siewior static struct usb_device_descriptor usbg_device_desc = {
32c52661d6SSebastian Andrzej Siewior 	.bLength =		sizeof(usbg_device_desc),
33c52661d6SSebastian Andrzej Siewior 	.bDescriptorType =	USB_DT_DEVICE,
340aecfc1bSIgor Kotrasinski 	/* .bcdUSB = DYNAMIC */
35c52661d6SSebastian Andrzej Siewior 	.bDeviceClass =		USB_CLASS_PER_INTERFACE,
36c52661d6SSebastian Andrzej Siewior 	.idVendor =		cpu_to_le16(UAS_VENDOR_ID),
37c52661d6SSebastian Andrzej Siewior 	.idProduct =		cpu_to_le16(UAS_PRODUCT_ID),
38c52661d6SSebastian Andrzej Siewior 	.bNumConfigurations =   1,
39c52661d6SSebastian Andrzej Siewior };
40c52661d6SSebastian Andrzej Siewior 
41c3978ed3SAndrzej Pietrasiewicz #define USB_G_STR_CONFIG USB_GADGET_FIRST_AVAIL_IDX
42c3978ed3SAndrzej Pietrasiewicz 
43c52661d6SSebastian Andrzej Siewior static struct usb_string	usbg_us_strings[] = {
448c45fbcdSColin Ian King 	[USB_GADGET_MANUFACTURER_IDX].s	= "Target Manufacturer",
45276e2e4fSSebastian Andrzej Siewior 	[USB_GADGET_PRODUCT_IDX].s	= "Target Product",
46276e2e4fSSebastian Andrzej Siewior 	[USB_GADGET_SERIAL_IDX].s	= "000000000001",
4718786da4SSebastian Andrzej Siewior 	[USB_G_STR_CONFIG].s		= "default config",
48c52661d6SSebastian Andrzej Siewior 	{ },
49c52661d6SSebastian Andrzej Siewior };
50c52661d6SSebastian Andrzej Siewior 
51c52661d6SSebastian Andrzej Siewior static struct usb_gadget_strings usbg_stringtab = {
52c52661d6SSebastian Andrzej Siewior 	.language = 0x0409,
53c52661d6SSebastian Andrzej Siewior 	.strings = usbg_us_strings,
54c52661d6SSebastian Andrzej Siewior };
55c52661d6SSebastian Andrzej Siewior 
56c52661d6SSebastian Andrzej Siewior static struct usb_gadget_strings *usbg_strings[] = {
57c52661d6SSebastian Andrzej Siewior 	&usbg_stringtab,
58c52661d6SSebastian Andrzej Siewior 	NULL,
59c52661d6SSebastian Andrzej Siewior };
60c52661d6SSebastian Andrzej Siewior 
6100240714SAndrzej Pietrasiewicz static struct usb_function_instance *fi_tcm;
6200240714SAndrzej Pietrasiewicz static struct usb_function *f_tcm;
6300240714SAndrzej Pietrasiewicz 
guas_unbind(struct usb_composite_dev * cdev)64c52661d6SSebastian Andrzej Siewior static int guas_unbind(struct usb_composite_dev *cdev)
65c52661d6SSebastian Andrzej Siewior {
6600240714SAndrzej Pietrasiewicz 	if (!IS_ERR_OR_NULL(f_tcm))
6700240714SAndrzej Pietrasiewicz 		usb_put_function(f_tcm);
6800240714SAndrzej Pietrasiewicz 
6900240714SAndrzej Pietrasiewicz 	return 0;
7000240714SAndrzej Pietrasiewicz }
7100240714SAndrzej Pietrasiewicz 
tcm_do_config(struct usb_configuration * c)7200240714SAndrzej Pietrasiewicz static int tcm_do_config(struct usb_configuration *c)
7300240714SAndrzej Pietrasiewicz {
7400240714SAndrzej Pietrasiewicz 	int status;
7500240714SAndrzej Pietrasiewicz 
7600240714SAndrzej Pietrasiewicz 	f_tcm = usb_get_function(fi_tcm);
7700240714SAndrzej Pietrasiewicz 	if (IS_ERR(f_tcm))
7800240714SAndrzej Pietrasiewicz 		return PTR_ERR(f_tcm);
7900240714SAndrzej Pietrasiewicz 
8000240714SAndrzej Pietrasiewicz 	status = usb_add_function(c, f_tcm);
8100240714SAndrzej Pietrasiewicz 	if (status < 0) {
8200240714SAndrzej Pietrasiewicz 		usb_put_function(f_tcm);
8300240714SAndrzej Pietrasiewicz 		return status;
8400240714SAndrzej Pietrasiewicz 	}
8500240714SAndrzej Pietrasiewicz 
86c52661d6SSebastian Andrzej Siewior 	return 0;
87c52661d6SSebastian Andrzej Siewior }
88c52661d6SSebastian Andrzej Siewior 
89c52661d6SSebastian Andrzej Siewior static struct usb_configuration usbg_config_driver = {
90c52661d6SSebastian Andrzej Siewior 	.label                  = "Linux Target",
91c52661d6SSebastian Andrzej Siewior 	.bConfigurationValue    = 1,
92c52661d6SSebastian Andrzej Siewior 	.bmAttributes           = USB_CONFIG_ATT_SELFPOWER,
93c52661d6SSebastian Andrzej Siewior };
94c52661d6SSebastian Andrzej Siewior 
9500240714SAndrzej Pietrasiewicz static int usbg_attach(struct usb_function_instance *f);
9600240714SAndrzej Pietrasiewicz static void usbg_detach(struct usb_function_instance *f);
97c52661d6SSebastian Andrzej Siewior 
usb_target_bind(struct usb_composite_dev * cdev)98c52661d6SSebastian Andrzej Siewior static int usb_target_bind(struct usb_composite_dev *cdev)
99c52661d6SSebastian Andrzej Siewior {
100c52661d6SSebastian Andrzej Siewior 	int ret;
101c52661d6SSebastian Andrzej Siewior 
10218786da4SSebastian Andrzej Siewior 	ret = usb_string_ids_tab(cdev, usbg_us_strings);
10318786da4SSebastian Andrzej Siewior 	if (ret)
10418786da4SSebastian Andrzej Siewior 		return ret;
10518786da4SSebastian Andrzej Siewior 
10618786da4SSebastian Andrzej Siewior 	usbg_device_desc.iManufacturer =
107276e2e4fSSebastian Andrzej Siewior 		usbg_us_strings[USB_GADGET_MANUFACTURER_IDX].id;
108276e2e4fSSebastian Andrzej Siewior 	usbg_device_desc.iProduct = usbg_us_strings[USB_GADGET_PRODUCT_IDX].id;
109276e2e4fSSebastian Andrzej Siewior 	usbg_device_desc.iSerialNumber =
110276e2e4fSSebastian Andrzej Siewior 		usbg_us_strings[USB_GADGET_SERIAL_IDX].id;
11118786da4SSebastian Andrzej Siewior 	usbg_config_driver.iConfiguration =
11218786da4SSebastian Andrzej Siewior 		usbg_us_strings[USB_G_STR_CONFIG].id;
11318786da4SSebastian Andrzej Siewior 
11400240714SAndrzej Pietrasiewicz 	ret = usb_add_config(cdev, &usbg_config_driver, tcm_do_config);
1157d16e8d3SSebastian Andrzej Siewior 	if (ret)
1167d16e8d3SSebastian Andrzej Siewior 		return ret;
1177d16e8d3SSebastian Andrzej Siewior 	usb_composite_overwrite_options(cdev, &coverwrite);
118c52661d6SSebastian Andrzej Siewior 	return 0;
119c52661d6SSebastian Andrzej Siewior }
120c52661d6SSebastian Andrzej Siewior 
121c94e289fSArnd Bergmann static struct usb_composite_driver usbg_driver = {
122c52661d6SSebastian Andrzej Siewior 	.name           = "g_target",
123c52661d6SSebastian Andrzej Siewior 	.dev            = &usbg_device_desc,
124c52661d6SSebastian Andrzej Siewior 	.strings        = usbg_strings,
125c52661d6SSebastian Andrzej Siewior 	.max_speed      = USB_SPEED_SUPER,
12603e42bd5SSebastian Andrzej Siewior 	.bind		= usb_target_bind,
127c52661d6SSebastian Andrzej Siewior 	.unbind         = guas_unbind,
128c52661d6SSebastian Andrzej Siewior };
129c52661d6SSebastian Andrzej Siewior 
usbg_attach(struct usb_function_instance * f)13000240714SAndrzej Pietrasiewicz static int usbg_attach(struct usb_function_instance *f)
131c52661d6SSebastian Andrzej Siewior {
13203e42bd5SSebastian Andrzej Siewior 	return usb_composite_probe(&usbg_driver);
133c52661d6SSebastian Andrzej Siewior }
134c52661d6SSebastian Andrzej Siewior 
usbg_detach(struct usb_function_instance * f)13500240714SAndrzej Pietrasiewicz static void usbg_detach(struct usb_function_instance *f)
136c52661d6SSebastian Andrzej Siewior {
137c52661d6SSebastian Andrzej Siewior 	usb_composite_unregister(&usbg_driver);
138c52661d6SSebastian Andrzej Siewior }
139c52661d6SSebastian Andrzej Siewior 
usb_target_gadget_init(void)140c52661d6SSebastian Andrzej Siewior static int __init usb_target_gadget_init(void)
141c52661d6SSebastian Andrzej Siewior {
14200240714SAndrzej Pietrasiewicz 	struct f_tcm_opts *tcm_opts;
14300240714SAndrzej Pietrasiewicz 
14400240714SAndrzej Pietrasiewicz 	fi_tcm = usb_get_function_instance("tcm");
14500240714SAndrzej Pietrasiewicz 	if (IS_ERR(fi_tcm))
14600240714SAndrzej Pietrasiewicz 		return PTR_ERR(fi_tcm);
14700240714SAndrzej Pietrasiewicz 
14800240714SAndrzej Pietrasiewicz 	tcm_opts = container_of(fi_tcm, struct f_tcm_opts, func_inst);
14900240714SAndrzej Pietrasiewicz 	mutex_lock(&tcm_opts->dep_lock);
15000240714SAndrzej Pietrasiewicz 	tcm_opts->tcm_register_callback = usbg_attach;
15100240714SAndrzej Pietrasiewicz 	tcm_opts->tcm_unregister_callback = usbg_detach;
15200240714SAndrzej Pietrasiewicz 	tcm_opts->dependent = THIS_MODULE;
15300240714SAndrzej Pietrasiewicz 	tcm_opts->can_attach = true;
15400240714SAndrzej Pietrasiewicz 	tcm_opts->has_dep = true;
15500240714SAndrzej Pietrasiewicz 	mutex_unlock(&tcm_opts->dep_lock);
15600240714SAndrzej Pietrasiewicz 
15700240714SAndrzej Pietrasiewicz 	fi_tcm->set_inst_name(fi_tcm, "tcm-legacy");
15800240714SAndrzej Pietrasiewicz 
15900240714SAndrzej Pietrasiewicz 	return 0;
160c52661d6SSebastian Andrzej Siewior }
161c52661d6SSebastian Andrzej Siewior module_init(usb_target_gadget_init);
162c52661d6SSebastian Andrzej Siewior 
usb_target_gadget_exit(void)163c52661d6SSebastian Andrzej Siewior static void __exit usb_target_gadget_exit(void)
164c52661d6SSebastian Andrzej Siewior {
16500240714SAndrzej Pietrasiewicz 	if (!IS_ERR_OR_NULL(fi_tcm))
16600240714SAndrzej Pietrasiewicz 		usb_put_function_instance(fi_tcm);
16700240714SAndrzej Pietrasiewicz 
168c52661d6SSebastian Andrzej Siewior }
169c52661d6SSebastian Andrzej Siewior module_exit(usb_target_gadget_exit);
170c52661d6SSebastian Andrzej Siewior 
171c52661d6SSebastian Andrzej Siewior MODULE_AUTHOR("Sebastian Andrzej Siewior <bigeasy@linutronix.de>");
172c52661d6SSebastian Andrzej Siewior MODULE_DESCRIPTION("usb-gadget fabric");
173c52661d6SSebastian Andrzej Siewior MODULE_LICENSE("GPL v2");
174