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