1 // SPDX-License-Identifier: GPL-2.0+
3 * f_obex.c -- USB CDC OBEX function driver
5 * Copyright (C) 2008 Nokia Corporation
6 * Contact: Felipe Balbi <felipe.balbi@nokia.com>
8 * Based on f_acm.c by Al Borchers and David Brownell.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
16 /* #define VERBOSE_DEBUG */
18 #include <linux/slab.h>
19 #include <linux/kernel.h>
20 #include <linux/device.h>
21 #include <linux/module.h>
27 * This CDC OBEX function support just packages a TTY-ish byte stream.
28 * A user mode server will put it into "raw" mode and handle all the
29 * relevant protocol details ... this is just a kernel passthrough.
30 * When possible, we prevent gadget enumeration until that server is
31 * ready to handle the commands.
42 static inline struct f_obex
*func_to_obex(struct usb_function
*f
)
44 return container_of(f
, struct f_obex
, port
.func
);
47 static inline struct f_obex
*port_to_obex(struct gserial
*p
)
49 return container_of(p
, struct f_obex
, port
);
52 /*-------------------------------------------------------------------------*/
54 #define OBEX_CTRL_IDX 0
55 #define OBEX_DATA_IDX 1
57 static struct usb_string obex_string_defs
[] = {
58 [OBEX_CTRL_IDX
].s
= "CDC Object Exchange (OBEX)",
59 [OBEX_DATA_IDX
].s
= "CDC OBEX Data",
60 { }, /* end of list */
63 static struct usb_gadget_strings obex_string_table
= {
64 .language
= 0x0409, /* en-US */
65 .strings
= obex_string_defs
,
68 static struct usb_gadget_strings
*obex_strings
[] = {
73 /*-------------------------------------------------------------------------*/
75 static struct usb_interface_descriptor obex_control_intf
= {
76 .bLength
= sizeof(obex_control_intf
),
77 .bDescriptorType
= USB_DT_INTERFACE
,
78 .bInterfaceNumber
= 0,
80 .bAlternateSetting
= 0,
82 .bInterfaceClass
= USB_CLASS_COMM
,
83 .bInterfaceSubClass
= USB_CDC_SUBCLASS_OBEX
,
86 static struct usb_interface_descriptor obex_data_nop_intf
= {
87 .bLength
= sizeof(obex_data_nop_intf
),
88 .bDescriptorType
= USB_DT_INTERFACE
,
89 .bInterfaceNumber
= 1,
91 .bAlternateSetting
= 0,
93 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
96 static struct usb_interface_descriptor obex_data_intf
= {
97 .bLength
= sizeof(obex_data_intf
),
98 .bDescriptorType
= USB_DT_INTERFACE
,
99 .bInterfaceNumber
= 2,
101 .bAlternateSetting
= 1,
103 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
106 static struct usb_cdc_header_desc obex_cdc_header_desc
= {
107 .bLength
= sizeof(obex_cdc_header_desc
),
108 .bDescriptorType
= USB_DT_CS_INTERFACE
,
109 .bDescriptorSubType
= USB_CDC_HEADER_TYPE
,
110 .bcdCDC
= cpu_to_le16(0x0120),
113 static struct usb_cdc_union_desc obex_cdc_union_desc
= {
114 .bLength
= sizeof(obex_cdc_union_desc
),
115 .bDescriptorType
= USB_DT_CS_INTERFACE
,
116 .bDescriptorSubType
= USB_CDC_UNION_TYPE
,
117 .bMasterInterface0
= 1,
118 .bSlaveInterface0
= 2,
121 static struct usb_cdc_obex_desc obex_desc
= {
122 .bLength
= sizeof(obex_desc
),
123 .bDescriptorType
= USB_DT_CS_INTERFACE
,
124 .bDescriptorSubType
= USB_CDC_OBEX_TYPE
,
125 .bcdVersion
= cpu_to_le16(0x0100),
128 /* High-Speed Support */
130 static struct usb_endpoint_descriptor obex_hs_ep_out_desc
= {
131 .bLength
= USB_DT_ENDPOINT_SIZE
,
132 .bDescriptorType
= USB_DT_ENDPOINT
,
134 .bEndpointAddress
= USB_DIR_OUT
,
135 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
136 .wMaxPacketSize
= cpu_to_le16(512),
139 static struct usb_endpoint_descriptor obex_hs_ep_in_desc
= {
140 .bLength
= USB_DT_ENDPOINT_SIZE
,
141 .bDescriptorType
= USB_DT_ENDPOINT
,
143 .bEndpointAddress
= USB_DIR_IN
,
144 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
145 .wMaxPacketSize
= cpu_to_le16(512),
148 static struct usb_descriptor_header
*hs_function
[] = {
149 (struct usb_descriptor_header
*) &obex_control_intf
,
150 (struct usb_descriptor_header
*) &obex_cdc_header_desc
,
151 (struct usb_descriptor_header
*) &obex_desc
,
152 (struct usb_descriptor_header
*) &obex_cdc_union_desc
,
154 (struct usb_descriptor_header
*) &obex_data_nop_intf
,
155 (struct usb_descriptor_header
*) &obex_data_intf
,
156 (struct usb_descriptor_header
*) &obex_hs_ep_in_desc
,
157 (struct usb_descriptor_header
*) &obex_hs_ep_out_desc
,
161 /* Full-Speed Support */
163 static struct usb_endpoint_descriptor obex_fs_ep_in_desc
= {
164 .bLength
= USB_DT_ENDPOINT_SIZE
,
165 .bDescriptorType
= USB_DT_ENDPOINT
,
167 .bEndpointAddress
= USB_DIR_IN
,
168 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
171 static struct usb_endpoint_descriptor obex_fs_ep_out_desc
= {
172 .bLength
= USB_DT_ENDPOINT_SIZE
,
173 .bDescriptorType
= USB_DT_ENDPOINT
,
175 .bEndpointAddress
= USB_DIR_OUT
,
176 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
179 static struct usb_descriptor_header
*fs_function
[] = {
180 (struct usb_descriptor_header
*) &obex_control_intf
,
181 (struct usb_descriptor_header
*) &obex_cdc_header_desc
,
182 (struct usb_descriptor_header
*) &obex_desc
,
183 (struct usb_descriptor_header
*) &obex_cdc_union_desc
,
185 (struct usb_descriptor_header
*) &obex_data_nop_intf
,
186 (struct usb_descriptor_header
*) &obex_data_intf
,
187 (struct usb_descriptor_header
*) &obex_fs_ep_in_desc
,
188 (struct usb_descriptor_header
*) &obex_fs_ep_out_desc
,
192 /*-------------------------------------------------------------------------*/
194 static int obex_set_alt(struct usb_function
*f
, unsigned intf
, unsigned alt
)
196 struct f_obex
*obex
= func_to_obex(f
);
197 struct usb_composite_dev
*cdev
= f
->config
->cdev
;
199 if (intf
== obex
->ctrl_id
) {
203 dev_dbg(&cdev
->gadget
->dev
,
204 "reset obex ttyGS%d control\n", obex
->port_num
);
206 } else if (intf
== obex
->data_id
) {
210 if (obex
->port
.in
->enabled
) {
211 dev_dbg(&cdev
->gadget
->dev
,
212 "reset obex ttyGS%d\n", obex
->port_num
);
213 gserial_disconnect(&obex
->port
);
216 if (!obex
->port
.in
->desc
|| !obex
->port
.out
->desc
) {
217 dev_dbg(&cdev
->gadget
->dev
,
218 "init obex ttyGS%d\n", obex
->port_num
);
219 if (config_ep_by_speed(cdev
->gadget
, f
,
221 config_ep_by_speed(cdev
->gadget
, f
,
223 obex
->port
.out
->desc
= NULL
;
224 obex
->port
.in
->desc
= NULL
;
230 dev_dbg(&cdev
->gadget
->dev
,
231 "activate obex ttyGS%d\n", obex
->port_num
);
232 gserial_connect(&obex
->port
, obex
->port_num
);
246 static int obex_get_alt(struct usb_function
*f
, unsigned intf
)
248 struct f_obex
*obex
= func_to_obex(f
);
250 return obex
->cur_alt
;
253 static void obex_disable(struct usb_function
*f
)
255 struct f_obex
*obex
= func_to_obex(f
);
256 struct usb_composite_dev
*cdev
= f
->config
->cdev
;
258 dev_dbg(&cdev
->gadget
->dev
, "obex ttyGS%d disable\n", obex
->port_num
);
259 gserial_disconnect(&obex
->port
);
262 /*-------------------------------------------------------------------------*/
264 static void obex_connect(struct gserial
*g
)
266 struct f_obex
*obex
= port_to_obex(g
);
267 struct usb_composite_dev
*cdev
= g
->func
.config
->cdev
;
270 status
= usb_function_activate(&g
->func
);
272 dev_dbg(&cdev
->gadget
->dev
,
273 "obex ttyGS%d function activate --> %d\n",
274 obex
->port_num
, status
);
277 static void obex_disconnect(struct gserial
*g
)
279 struct f_obex
*obex
= port_to_obex(g
);
280 struct usb_composite_dev
*cdev
= g
->func
.config
->cdev
;
283 status
= usb_function_deactivate(&g
->func
);
285 dev_dbg(&cdev
->gadget
->dev
,
286 "obex ttyGS%d function deactivate --> %d\n",
287 obex
->port_num
, status
);
290 /*-------------------------------------------------------------------------*/
292 /* Some controllers can't support CDC OBEX ... */
293 static inline bool can_support_obex(struct usb_configuration
*c
)
295 /* Since the first interface is a NOP, we can ignore the
296 * issue of multi-interface support on most controllers.
298 * Altsettings are mandatory, however...
300 if (!gadget_is_altset_supported(c
->cdev
->gadget
))
303 /* everything else is *probably* fine ... */
307 static int obex_bind(struct usb_configuration
*c
, struct usb_function
*f
)
309 struct usb_composite_dev
*cdev
= c
->cdev
;
310 struct f_obex
*obex
= func_to_obex(f
);
311 struct usb_string
*us
;
315 if (!can_support_obex(c
))
318 us
= usb_gstrings_attach(cdev
, obex_strings
,
319 ARRAY_SIZE(obex_string_defs
));
322 obex_control_intf
.iInterface
= us
[OBEX_CTRL_IDX
].id
;
323 obex_data_nop_intf
.iInterface
= us
[OBEX_DATA_IDX
].id
;
324 obex_data_intf
.iInterface
= us
[OBEX_DATA_IDX
].id
;
326 /* allocate instance-specific interface IDs, and patch descriptors */
328 status
= usb_interface_id(c
, f
);
331 obex
->ctrl_id
= status
;
333 obex_control_intf
.bInterfaceNumber
= status
;
334 obex_cdc_union_desc
.bMasterInterface0
= status
;
336 status
= usb_interface_id(c
, f
);
339 obex
->data_id
= status
;
341 obex_data_nop_intf
.bInterfaceNumber
= status
;
342 obex_data_intf
.bInterfaceNumber
= status
;
343 obex_cdc_union_desc
.bSlaveInterface0
= status
;
345 /* allocate instance-specific endpoints */
348 ep
= usb_ep_autoconfig(cdev
->gadget
, &obex_fs_ep_in_desc
);
353 ep
= usb_ep_autoconfig(cdev
->gadget
, &obex_fs_ep_out_desc
);
358 /* support all relevant hardware speeds... we expect that when
359 * hardware is dual speed, all bulk-capable endpoints work at
363 obex_hs_ep_in_desc
.bEndpointAddress
=
364 obex_fs_ep_in_desc
.bEndpointAddress
;
365 obex_hs_ep_out_desc
.bEndpointAddress
=
366 obex_fs_ep_out_desc
.bEndpointAddress
;
368 status
= usb_assign_descriptors(f
, fs_function
, hs_function
, NULL
,
373 dev_dbg(&cdev
->gadget
->dev
, "obex ttyGS%d: %s speed IN/%s OUT/%s\n",
375 gadget_is_dualspeed(c
->cdev
->gadget
) ? "dual" : "full",
376 obex
->port
.in
->name
, obex
->port
.out
->name
);
381 ERROR(cdev
, "%s/%p: can't bind, err %d\n", f
->name
, f
, status
);
386 static inline struct f_serial_opts
*to_f_serial_opts(struct config_item
*item
)
388 return container_of(to_config_group(item
), struct f_serial_opts
,
392 static void obex_attr_release(struct config_item
*item
)
394 struct f_serial_opts
*opts
= to_f_serial_opts(item
);
396 usb_put_function_instance(&opts
->func_inst
);
399 static struct configfs_item_operations obex_item_ops
= {
400 .release
= obex_attr_release
,
403 static ssize_t
f_obex_port_num_show(struct config_item
*item
, char *page
)
405 return sprintf(page
, "%u\n", to_f_serial_opts(item
)->port_num
);
408 CONFIGFS_ATTR_RO(f_obex_
, port_num
);
410 static struct configfs_attribute
*acm_attrs
[] = {
411 &f_obex_attr_port_num
,
415 static struct config_item_type obex_func_type
= {
416 .ct_item_ops
= &obex_item_ops
,
417 .ct_attrs
= acm_attrs
,
418 .ct_owner
= THIS_MODULE
,
421 static void obex_free_inst(struct usb_function_instance
*f
)
423 struct f_serial_opts
*opts
;
425 opts
= container_of(f
, struct f_serial_opts
, func_inst
);
426 gserial_free_line(opts
->port_num
);
430 static struct usb_function_instance
*obex_alloc_inst(void)
432 struct f_serial_opts
*opts
;
435 opts
= kzalloc(sizeof(*opts
), GFP_KERNEL
);
437 return ERR_PTR(-ENOMEM
);
439 opts
->func_inst
.free_func_inst
= obex_free_inst
;
440 ret
= gserial_alloc_line(&opts
->port_num
);
445 config_group_init_type_name(&opts
->func_inst
.group
, "",
448 return &opts
->func_inst
;
451 static void obex_free(struct usb_function
*f
)
455 obex
= func_to_obex(f
);
459 static void obex_unbind(struct usb_configuration
*c
, struct usb_function
*f
)
461 usb_free_all_descriptors(f
);
464 static struct usb_function
*obex_alloc(struct usb_function_instance
*fi
)
467 struct f_serial_opts
*opts
;
469 /* allocate and initialize one new instance */
470 obex
= kzalloc(sizeof(*obex
), GFP_KERNEL
);
472 return ERR_PTR(-ENOMEM
);
474 opts
= container_of(fi
, struct f_serial_opts
, func_inst
);
476 obex
->port_num
= opts
->port_num
;
478 obex
->port
.connect
= obex_connect
;
479 obex
->port
.disconnect
= obex_disconnect
;
481 obex
->port
.func
.name
= "obex";
482 /* descriptors are per-instance copies */
483 obex
->port
.func
.bind
= obex_bind
;
484 obex
->port
.func
.unbind
= obex_unbind
;
485 obex
->port
.func
.set_alt
= obex_set_alt
;
486 obex
->port
.func
.get_alt
= obex_get_alt
;
487 obex
->port
.func
.disable
= obex_disable
;
488 obex
->port
.func
.free_func
= obex_free
;
489 obex
->port
.func
.bind_deactivated
= true;
491 return &obex
->port
.func
;
494 DECLARE_USB_FUNCTION_INIT(obex
, obex_alloc_inst
, obex_alloc
);
495 MODULE_AUTHOR("Felipe Balbi");
496 MODULE_LICENSE("GPL");