2 * f_phonet.c -- USB CDC Phonet function
4 * Copyright (C) 2007-2008 Nokia Corporation. All rights reserved.
6 * Author: Rémi Denis-Courmont
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * version 2 as published by the Free Software Foundation.
14 #include <linux/slab.h>
15 #include <linux/kernel.h>
16 #include <linux/module.h>
17 #include <linux/device.h>
19 #include <linux/netdevice.h>
20 #include <linux/if_ether.h>
21 #include <linux/if_phonet.h>
22 #include <linux/if_arp.h>
24 #include <linux/usb/ch9.h>
25 #include <linux/usb/cdc.h>
26 #include <linux/usb/composite.h>
31 #define PN_MEDIA_USB 0x1B
33 #if (PAGE_SIZE % MAXPACKET)
34 #error MAXPACKET must divide PAGE_SIZE!
37 /*-------------------------------------------------------------------------*/
45 struct usb_function function
;
50 struct net_device
*dev
;
51 struct usb_ep
*in_ep
, *out_ep
;
53 struct usb_request
*in_req
;
54 struct usb_request
*out_reqv
[0];
57 static int phonet_rxq_size
= 17;
59 static inline struct f_phonet
*func_to_pn(struct usb_function
*f
)
61 return container_of(f
, struct f_phonet
, function
);
64 /*-------------------------------------------------------------------------*/
66 #define USB_CDC_SUBCLASS_PHONET 0xfe
67 #define USB_CDC_PHONET_TYPE 0xab
69 static struct usb_interface_descriptor
70 pn_control_intf_desc
= {
71 .bLength
= sizeof pn_control_intf_desc
,
72 .bDescriptorType
= USB_DT_INTERFACE
,
74 /* .bInterfaceNumber = DYNAMIC, */
75 .bInterfaceClass
= USB_CLASS_COMM
,
76 .bInterfaceSubClass
= USB_CDC_SUBCLASS_PHONET
,
79 static const struct usb_cdc_header_desc
81 .bLength
= sizeof pn_header_desc
,
82 .bDescriptorType
= USB_DT_CS_INTERFACE
,
83 .bDescriptorSubType
= USB_CDC_HEADER_TYPE
,
84 .bcdCDC
= cpu_to_le16(0x0110),
87 static const struct usb_cdc_header_desc
89 .bLength
= sizeof pn_phonet_desc
,
90 .bDescriptorType
= USB_DT_CS_INTERFACE
,
91 .bDescriptorSubType
= USB_CDC_PHONET_TYPE
,
92 .bcdCDC
= cpu_to_le16(0x1505), /* ??? */
95 static struct usb_cdc_union_desc
97 .bLength
= sizeof pn_union_desc
,
98 .bDescriptorType
= USB_DT_CS_INTERFACE
,
99 .bDescriptorSubType
= USB_CDC_UNION_TYPE
,
101 /* .bMasterInterface0 = DYNAMIC, */
102 /* .bSlaveInterface0 = DYNAMIC, */
105 static struct usb_interface_descriptor
106 pn_data_nop_intf_desc
= {
107 .bLength
= sizeof pn_data_nop_intf_desc
,
108 .bDescriptorType
= USB_DT_INTERFACE
,
110 /* .bInterfaceNumber = DYNAMIC, */
111 .bAlternateSetting
= 0,
113 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
116 static struct usb_interface_descriptor
117 pn_data_intf_desc
= {
118 .bLength
= sizeof pn_data_intf_desc
,
119 .bDescriptorType
= USB_DT_INTERFACE
,
121 /* .bInterfaceNumber = DYNAMIC, */
122 .bAlternateSetting
= 1,
124 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
127 static struct usb_endpoint_descriptor
129 .bLength
= USB_DT_ENDPOINT_SIZE
,
130 .bDescriptorType
= USB_DT_ENDPOINT
,
132 .bEndpointAddress
= USB_DIR_OUT
,
133 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
136 static struct usb_endpoint_descriptor
138 .bLength
= USB_DT_ENDPOINT_SIZE
,
139 .bDescriptorType
= USB_DT_ENDPOINT
,
141 .bEndpointAddress
= USB_DIR_OUT
,
142 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
143 .wMaxPacketSize
= cpu_to_le16(MAXPACKET
),
146 static struct usb_endpoint_descriptor
147 pn_fs_source_desc
= {
148 .bLength
= USB_DT_ENDPOINT_SIZE
,
149 .bDescriptorType
= USB_DT_ENDPOINT
,
151 .bEndpointAddress
= USB_DIR_IN
,
152 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
155 static struct usb_endpoint_descriptor
156 pn_hs_source_desc
= {
157 .bLength
= USB_DT_ENDPOINT_SIZE
,
158 .bDescriptorType
= USB_DT_ENDPOINT
,
160 .bEndpointAddress
= USB_DIR_IN
,
161 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
162 .wMaxPacketSize
= cpu_to_le16(512),
165 static struct usb_descriptor_header
*fs_pn_function
[] = {
166 (struct usb_descriptor_header
*) &pn_control_intf_desc
,
167 (struct usb_descriptor_header
*) &pn_header_desc
,
168 (struct usb_descriptor_header
*) &pn_phonet_desc
,
169 (struct usb_descriptor_header
*) &pn_union_desc
,
170 (struct usb_descriptor_header
*) &pn_data_nop_intf_desc
,
171 (struct usb_descriptor_header
*) &pn_data_intf_desc
,
172 (struct usb_descriptor_header
*) &pn_fs_sink_desc
,
173 (struct usb_descriptor_header
*) &pn_fs_source_desc
,
177 static struct usb_descriptor_header
*hs_pn_function
[] = {
178 (struct usb_descriptor_header
*) &pn_control_intf_desc
,
179 (struct usb_descriptor_header
*) &pn_header_desc
,
180 (struct usb_descriptor_header
*) &pn_phonet_desc
,
181 (struct usb_descriptor_header
*) &pn_union_desc
,
182 (struct usb_descriptor_header
*) &pn_data_nop_intf_desc
,
183 (struct usb_descriptor_header
*) &pn_data_intf_desc
,
184 (struct usb_descriptor_header
*) &pn_hs_sink_desc
,
185 (struct usb_descriptor_header
*) &pn_hs_source_desc
,
189 /*-------------------------------------------------------------------------*/
191 static int pn_net_open(struct net_device
*dev
)
193 netif_wake_queue(dev
);
197 static int pn_net_close(struct net_device
*dev
)
199 netif_stop_queue(dev
);
203 static void pn_tx_complete(struct usb_ep
*ep
, struct usb_request
*req
)
205 struct f_phonet
*fp
= ep
->driver_data
;
206 struct net_device
*dev
= fp
->dev
;
207 struct sk_buff
*skb
= req
->context
;
209 switch (req
->status
) {
211 dev
->stats
.tx_packets
++;
212 dev
->stats
.tx_bytes
+= skb
->len
;
215 case -ESHUTDOWN
: /* disconnected */
216 case -ECONNRESET
: /* disabled */
217 dev
->stats
.tx_aborted_errors
++;
219 dev
->stats
.tx_errors
++;
222 dev_kfree_skb_any(skb
);
223 netif_wake_queue(dev
);
226 static int pn_net_xmit(struct sk_buff
*skb
, struct net_device
*dev
)
228 struct phonet_port
*port
= netdev_priv(dev
);
230 struct usb_request
*req
;
233 if (skb
->protocol
!= htons(ETH_P_PHONET
))
236 spin_lock_irqsave(&port
->lock
, flags
);
238 if (unlikely(!fp
)) /* race with carrier loss */
242 req
->buf
= skb
->data
;
243 req
->length
= skb
->len
;
244 req
->complete
= pn_tx_complete
;
248 if (unlikely(usb_ep_queue(fp
->in_ep
, req
, GFP_ATOMIC
)))
251 netif_stop_queue(dev
);
255 spin_unlock_irqrestore(&port
->lock
, flags
);
259 dev
->stats
.tx_dropped
++;
264 static int pn_net_mtu(struct net_device
*dev
, int new_mtu
)
266 if ((new_mtu
< PHONET_MIN_MTU
) || (new_mtu
> PHONET_MAX_MTU
))
272 static const struct net_device_ops pn_netdev_ops
= {
273 .ndo_open
= pn_net_open
,
274 .ndo_stop
= pn_net_close
,
275 .ndo_start_xmit
= pn_net_xmit
,
276 .ndo_change_mtu
= pn_net_mtu
,
279 static void pn_net_setup(struct net_device
*dev
)
282 dev
->type
= ARPHRD_PHONET
;
283 dev
->flags
= IFF_POINTOPOINT
| IFF_NOARP
;
284 dev
->mtu
= PHONET_DEV_MTU
;
285 dev
->hard_header_len
= 1;
286 dev
->dev_addr
[0] = PN_MEDIA_USB
;
288 dev
->tx_queue_len
= 1;
290 dev
->netdev_ops
= &pn_netdev_ops
;
291 dev
->destructor
= free_netdev
;
292 dev
->header_ops
= &phonet_header_ops
;
295 /*-------------------------------------------------------------------------*/
298 * Queue buffer for data from the host
301 pn_rx_submit(struct f_phonet
*fp
, struct usb_request
*req
, gfp_t gfp_flags
)
306 page
= __skb_alloc_page(gfp_flags
| __GFP_NOMEMALLOC
, NULL
);
310 req
->buf
= page_address(page
);
311 req
->length
= PAGE_SIZE
;
314 err
= usb_ep_queue(fp
->out_ep
, req
, gfp_flags
);
320 static void pn_rx_complete(struct usb_ep
*ep
, struct usb_request
*req
)
322 struct f_phonet
*fp
= ep
->driver_data
;
323 struct net_device
*dev
= fp
->dev
;
324 struct page
*page
= req
->context
;
327 int status
= req
->status
;
331 spin_lock_irqsave(&fp
->rx
.lock
, flags
);
334 skb
= fp
->rx
.skb
= netdev_alloc_skb(dev
, 12);
335 if (req
->actual
< req
->length
) /* Last fragment */
337 spin_unlock_irqrestore(&fp
->rx
.lock
, flags
);
342 if (skb
->len
== 0) { /* First fragment */
343 skb
->protocol
= htons(ETH_P_PHONET
);
344 skb_reset_mac_header(skb
);
345 /* Can't use pskb_pull() on page in IRQ */
346 memcpy(skb_put(skb
, 1), page_address(page
), 1);
349 skb_add_rx_frag(skb
, skb_shinfo(skb
)->nr_frags
, page
,
350 skb
->len
<= 1, req
->actual
, PAGE_SIZE
);
353 if (req
->actual
< req
->length
) { /* Last fragment */
355 dev
->stats
.rx_packets
++;
356 dev
->stats
.rx_bytes
+= skb
->len
;
362 /* Do not resubmit in these cases: */
363 case -ESHUTDOWN
: /* disconnect */
364 case -ECONNABORTED
: /* hw reset */
365 case -ECONNRESET
: /* dequeued (unlink or netif down) */
369 /* Do resubmit in these cases: */
370 case -EOVERFLOW
: /* request buffer overflow */
371 dev
->stats
.rx_over_errors
++;
373 dev
->stats
.rx_errors
++;
380 pn_rx_submit(fp
, req
, GFP_ATOMIC
| __GFP_COLD
);
383 /*-------------------------------------------------------------------------*/
385 static void __pn_reset(struct usb_function
*f
)
387 struct f_phonet
*fp
= func_to_pn(f
);
388 struct net_device
*dev
= fp
->dev
;
389 struct phonet_port
*port
= netdev_priv(dev
);
391 netif_carrier_off(dev
);
394 usb_ep_disable(fp
->out_ep
);
395 usb_ep_disable(fp
->in_ep
);
397 dev_kfree_skb_irq(fp
->rx
.skb
);
402 static int pn_set_alt(struct usb_function
*f
, unsigned intf
, unsigned alt
)
404 struct f_phonet
*fp
= func_to_pn(f
);
405 struct usb_gadget
*gadget
= fp
->function
.config
->cdev
->gadget
;
407 if (intf
== pn_control_intf_desc
.bInterfaceNumber
)
408 /* control interface, no altsetting */
409 return (alt
> 0) ? -EINVAL
: 0;
411 if (intf
== pn_data_intf_desc
.bInterfaceNumber
) {
412 struct net_device
*dev
= fp
->dev
;
413 struct phonet_port
*port
= netdev_priv(dev
);
415 /* data intf (0: inactive, 1: active) */
419 spin_lock(&port
->lock
);
424 if (config_ep_by_speed(gadget
, f
, fp
->in_ep
) ||
425 config_ep_by_speed(gadget
, f
, fp
->out_ep
)) {
426 fp
->in_ep
->desc
= NULL
;
427 fp
->out_ep
->desc
= NULL
;
428 spin_unlock(&port
->lock
);
431 usb_ep_enable(fp
->out_ep
);
432 usb_ep_enable(fp
->in_ep
);
435 fp
->out_ep
->driver_data
= fp
;
436 fp
->in_ep
->driver_data
= fp
;
438 netif_carrier_on(dev
);
439 for (i
= 0; i
< phonet_rxq_size
; i
++)
440 pn_rx_submit(fp
, fp
->out_reqv
[i
], GFP_ATOMIC
| __GFP_COLD
);
442 spin_unlock(&port
->lock
);
449 static int pn_get_alt(struct usb_function
*f
, unsigned intf
)
451 struct f_phonet
*fp
= func_to_pn(f
);
453 if (intf
== pn_control_intf_desc
.bInterfaceNumber
)
456 if (intf
== pn_data_intf_desc
.bInterfaceNumber
) {
457 struct phonet_port
*port
= netdev_priv(fp
->dev
);
460 spin_lock(&port
->lock
);
461 alt
= port
->usb
!= NULL
;
462 spin_unlock(&port
->lock
);
469 static void pn_disconnect(struct usb_function
*f
)
471 struct f_phonet
*fp
= func_to_pn(f
);
472 struct phonet_port
*port
= netdev_priv(fp
->dev
);
475 /* remain disabled until set_alt */
476 spin_lock_irqsave(&port
->lock
, flags
);
478 spin_unlock_irqrestore(&port
->lock
, flags
);
481 /*-------------------------------------------------------------------------*/
483 static int pn_bind(struct usb_configuration
*c
, struct usb_function
*f
)
485 struct usb_composite_dev
*cdev
= c
->cdev
;
486 struct usb_gadget
*gadget
= cdev
->gadget
;
487 struct f_phonet
*fp
= func_to_pn(f
);
491 struct f_phonet_opts
*phonet_opts
;
493 phonet_opts
= container_of(f
->fi
, struct f_phonet_opts
, func_inst
);
496 * in drivers/usb/gadget/configfs.c:configfs_composite_bind()
497 * configurations are bound in sequence with list_for_each_entry,
498 * in each configuration its functions are bound in sequence
499 * with list_for_each_entry, so we assume no race condition
500 * with regard to phonet_opts->bound access
502 if (!phonet_opts
->bound
) {
503 gphonet_set_gadget(phonet_opts
->net
, gadget
);
504 status
= gphonet_register_netdev(phonet_opts
->net
);
507 phonet_opts
->bound
= true;
510 /* Reserve interface IDs */
511 status
= usb_interface_id(c
, f
);
514 pn_control_intf_desc
.bInterfaceNumber
= status
;
515 pn_union_desc
.bMasterInterface0
= status
;
517 status
= usb_interface_id(c
, f
);
520 pn_data_nop_intf_desc
.bInterfaceNumber
= status
;
521 pn_data_intf_desc
.bInterfaceNumber
= status
;
522 pn_union_desc
.bSlaveInterface0
= status
;
524 /* Reserve endpoints */
526 ep
= usb_ep_autoconfig(gadget
, &pn_fs_sink_desc
);
530 ep
->driver_data
= fp
; /* Claim */
532 ep
= usb_ep_autoconfig(gadget
, &pn_fs_source_desc
);
536 ep
->driver_data
= fp
; /* Claim */
538 pn_hs_sink_desc
.bEndpointAddress
= pn_fs_sink_desc
.bEndpointAddress
;
539 pn_hs_source_desc
.bEndpointAddress
= pn_fs_source_desc
.bEndpointAddress
;
541 /* Do not try to bind Phonet twice... */
542 status
= usb_assign_descriptors(f
, fs_pn_function
, hs_pn_function
,
547 /* Incoming USB requests */
549 for (i
= 0; i
< phonet_rxq_size
; i
++) {
550 struct usb_request
*req
;
552 req
= usb_ep_alloc_request(fp
->out_ep
, GFP_KERNEL
);
556 req
->complete
= pn_rx_complete
;
557 fp
->out_reqv
[i
] = req
;
560 /* Outgoing USB requests */
561 fp
->in_req
= usb_ep_alloc_request(fp
->in_ep
, GFP_KERNEL
);
565 INFO(cdev
, "USB CDC Phonet function\n");
566 INFO(cdev
, "using %s, OUT %s, IN %s\n", cdev
->gadget
->name
,
567 fp
->out_ep
->name
, fp
->in_ep
->name
);
571 for (i
= 0; i
< phonet_rxq_size
&& fp
->out_reqv
[i
]; i
++)
572 usb_ep_free_request(fp
->out_ep
, fp
->out_reqv
[i
]);
574 usb_free_all_descriptors(f
);
576 fp
->out_ep
->driver_data
= NULL
;
578 fp
->in_ep
->driver_data
= NULL
;
579 ERROR(cdev
, "USB CDC Phonet: cannot autoconfigure\n");
583 static inline struct f_phonet_opts
*to_f_phonet_opts(struct config_item
*item
)
585 return container_of(to_config_group(item
), struct f_phonet_opts
,
589 CONFIGFS_ATTR_STRUCT(f_phonet_opts
);
590 static ssize_t
f_phonet_attr_show(struct config_item
*item
,
591 struct configfs_attribute
*attr
,
594 struct f_phonet_opts
*opts
= to_f_phonet_opts(item
);
595 struct f_phonet_opts_attribute
*f_phonet_opts_attr
=
596 container_of(attr
, struct f_phonet_opts_attribute
, attr
);
599 if (f_phonet_opts_attr
->show
)
600 ret
= f_phonet_opts_attr
->show(opts
, page
);
604 static void phonet_attr_release(struct config_item
*item
)
606 struct f_phonet_opts
*opts
= to_f_phonet_opts(item
);
608 usb_put_function_instance(&opts
->func_inst
);
611 static struct configfs_item_operations phonet_item_ops
= {
612 .release
= phonet_attr_release
,
613 .show_attribute
= f_phonet_attr_show
,
616 static ssize_t
f_phonet_ifname_show(struct f_phonet_opts
*opts
, char *page
)
618 return gether_get_ifname(opts
->net
, page
, PAGE_SIZE
);
621 static struct f_phonet_opts_attribute f_phonet_ifname
=
622 __CONFIGFS_ATTR_RO(ifname
, f_phonet_ifname_show
);
624 static struct configfs_attribute
*phonet_attrs
[] = {
625 &f_phonet_ifname
.attr
,
629 static struct config_item_type phonet_func_type
= {
630 .ct_item_ops
= &phonet_item_ops
,
631 .ct_attrs
= phonet_attrs
,
632 .ct_owner
= THIS_MODULE
,
635 static void phonet_free_inst(struct usb_function_instance
*f
)
637 struct f_phonet_opts
*opts
;
639 opts
= container_of(f
, struct f_phonet_opts
, func_inst
);
641 gphonet_cleanup(opts
->net
);
643 free_netdev(opts
->net
);
647 static struct usb_function_instance
*phonet_alloc_inst(void)
649 struct f_phonet_opts
*opts
;
651 opts
= kzalloc(sizeof(*opts
), GFP_KERNEL
);
653 return ERR_PTR(-ENOMEM
);
655 opts
->func_inst
.free_func_inst
= phonet_free_inst
;
656 opts
->net
= gphonet_setup_default();
657 if (IS_ERR(opts
->net
)) {
658 struct net_device
*net
= opts
->net
;
660 return ERR_CAST(net
);
663 config_group_init_type_name(&opts
->func_inst
.group
, "",
666 return &opts
->func_inst
;
669 static void phonet_free(struct usb_function
*f
)
671 struct f_phonet
*phonet
;
673 phonet
= func_to_pn(f
);
677 static void pn_unbind(struct usb_configuration
*c
, struct usb_function
*f
)
679 struct f_phonet
*fp
= func_to_pn(f
);
682 /* We are already disconnected */
684 usb_ep_free_request(fp
->in_ep
, fp
->in_req
);
685 for (i
= 0; i
< phonet_rxq_size
; i
++)
687 usb_ep_free_request(fp
->out_ep
, fp
->out_reqv
[i
]);
689 usb_free_all_descriptors(f
);
692 static struct usb_function
*phonet_alloc(struct usb_function_instance
*fi
)
695 struct f_phonet_opts
*opts
;
698 size
= sizeof(*fp
) + (phonet_rxq_size
* sizeof(struct usb_request
*));
699 fp
= kzalloc(size
, GFP_KERNEL
);
701 return ERR_PTR(-ENOMEM
);
703 opts
= container_of(fi
, struct f_phonet_opts
, func_inst
);
706 fp
->function
.name
= "phonet";
707 fp
->function
.bind
= pn_bind
;
708 fp
->function
.unbind
= pn_unbind
;
709 fp
->function
.set_alt
= pn_set_alt
;
710 fp
->function
.get_alt
= pn_get_alt
;
711 fp
->function
.disable
= pn_disconnect
;
712 fp
->function
.free_func
= phonet_free
;
713 spin_lock_init(&fp
->rx
.lock
);
715 return &fp
->function
;
718 struct net_device
*gphonet_setup_default(void)
720 struct net_device
*dev
;
721 struct phonet_port
*port
;
723 /* Create net device */
724 dev
= alloc_netdev(sizeof(*port
), "upnlink%d", pn_net_setup
);
726 return ERR_PTR(-ENOMEM
);
728 port
= netdev_priv(dev
);
729 spin_lock_init(&port
->lock
);
730 netif_carrier_off(dev
);
735 void gphonet_set_gadget(struct net_device
*net
, struct usb_gadget
*g
)
737 SET_NETDEV_DEV(net
, &g
->dev
);
740 int gphonet_register_netdev(struct net_device
*net
)
744 status
= register_netdev(net
);
751 void gphonet_cleanup(struct net_device
*dev
)
753 unregister_netdev(dev
);
756 DECLARE_USB_FUNCTION_INIT(phonet
, phonet_alloc_inst
, phonet_alloc
);
757 MODULE_AUTHOR("Rémi Denis-Courmont");
758 MODULE_LICENSE("GPL");