]>
Commit | Line | Data |
---|---|---|
c91ce3b6 BM |
1 | /* |
2 | * Copyright (C) ST-Ericsson 2010-2012 | |
3 | * Contact: Alexey Orishko <alexey.orishko@stericsson.com> | |
4 | * Original author: Hans Petter Selasky <hans.petter.selasky@stericsson.com> | |
5 | * | |
6 | * USB Host Driver for Network Control Model (NCM) | |
7 | * http://www.usb.org/developers/devclass_docs/NCM10.zip | |
8 | * | |
9 | * The NCM encoding, decoding and initialization logic | |
10 | * derives from FreeBSD 8.x. if_cdce.c and if_cdcereg.h | |
11 | * | |
12 | * This software is available to you under a choice of one of two | |
13 | * licenses. You may choose this file to be licensed under the terms | |
14 | * of the GNU General Public License (GPL) Version 2 or the 2-clause | |
15 | * BSD license listed below: | |
16 | * | |
17 | * Redistribution and use in source and binary forms, with or without | |
18 | * modification, are permitted provided that the following conditions | |
19 | * are met: | |
20 | * 1. Redistributions of source code must retain the above copyright | |
21 | * notice, this list of conditions and the following disclaimer. | |
22 | * 2. Redistributions in binary form must reproduce the above copyright | |
23 | * notice, this list of conditions and the following disclaimer in the | |
24 | * documentation and/or other materials provided with the distribution. | |
25 | * | |
26 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND | |
27 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
28 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
29 | * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | |
30 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
31 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
32 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
33 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
34 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
35 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
36 | * SUCH DAMAGE. | |
37 | */ | |
38 | ||
9bf211a3 GS |
39 | #define CDC_NCM_COMM_ALTSETTING_NCM 0 |
40 | #define CDC_NCM_COMM_ALTSETTING_MBIM 1 | |
41 | ||
42 | #define CDC_NCM_DATA_ALTSETTING_NCM 1 | |
43 | #define CDC_NCM_DATA_ALTSETTING_MBIM 2 | |
44 | ||
c91ce3b6 BM |
45 | /* CDC NCM subclass 3.2.1 */ |
46 | #define USB_CDC_NCM_NDP16_LENGTH_MIN 0x10 | |
47 | ||
48 | /* Maximum NTB length */ | |
49 | #define CDC_NCM_NTB_MAX_SIZE_TX 32768 /* bytes */ | |
50 | #define CDC_NCM_NTB_MAX_SIZE_RX 32768 /* bytes */ | |
51 | ||
52 | /* Minimum value for MaxDatagramSize, ch. 6.2.9 */ | |
53 | #define CDC_NCM_MIN_DATAGRAM_SIZE 1514 /* bytes */ | |
54 | ||
55 | /* Minimum value for MaxDatagramSize, ch. 8.1.3 */ | |
56 | #define CDC_MBIM_MIN_DATAGRAM_SIZE 2048 /* bytes */ | |
57 | ||
58 | #define CDC_NCM_MIN_TX_PKT 512 /* bytes */ | |
59 | ||
60 | /* Default value for MaxDatagramSize */ | |
61 | #define CDC_NCM_MAX_DATAGRAM_SIZE 8192 /* bytes */ | |
62 | ||
63 | /* | |
64 | * Maximum amount of datagrams in NCM Datagram Pointer Table, not counting | |
65 | * the last NULL entry. | |
66 | */ | |
67 | #define CDC_NCM_DPT_DATAGRAMS_MAX 40 | |
68 | ||
69 | /* Restart the timer, if amount of datagrams is less than given value */ | |
70 | #define CDC_NCM_RESTART_TIMER_DATAGRAM_CNT 3 | |
71 | #define CDC_NCM_TIMER_PENDING_CNT 2 | |
72 | #define CDC_NCM_TIMER_INTERVAL (400UL * NSEC_PER_USEC) | |
73 | ||
74 | /* The following macro defines the minimum header space */ | |
75 | #define CDC_NCM_MIN_HDR_SIZE \ | |
76 | (sizeof(struct usb_cdc_ncm_nth16) + sizeof(struct usb_cdc_ncm_ndp16) + \ | |
77 | (CDC_NCM_DPT_DATAGRAMS_MAX + 1) * sizeof(struct usb_cdc_ncm_dpe16)) | |
78 | ||
79 | #define CDC_NCM_NDP_SIZE \ | |
80 | (sizeof(struct usb_cdc_ncm_ndp16) + \ | |
81 | (CDC_NCM_DPT_DATAGRAMS_MAX + 1) * sizeof(struct usb_cdc_ncm_dpe16)) | |
82 | ||
9bf211a3 GS |
83 | #define cdc_ncm_comm_intf_is_mbim(x) ((x)->desc.bInterfaceSubClass == USB_CDC_SUBCLASS_MBIM && \ |
84 | (x)->desc.bInterfaceProtocol == USB_CDC_PROTO_NONE) | |
85 | #define cdc_ncm_data_intf_is_mbim(x) ((x)->desc.bInterfaceProtocol == USB_CDC_MBIM_PROTO_NTB) | |
86 | ||
c91ce3b6 BM |
87 | struct cdc_ncm_ctx { |
88 | struct usb_cdc_ncm_ntb_parameters ncm_parm; | |
89 | struct hrtimer tx_timer; | |
90 | struct tasklet_struct bh; | |
91 | ||
92 | const struct usb_cdc_ncm_desc *func_desc; | |
93 | const struct usb_cdc_mbim_desc *mbim_desc; | |
94 | const struct usb_cdc_header_desc *header_desc; | |
95 | const struct usb_cdc_union_desc *union_desc; | |
96 | const struct usb_cdc_ether_desc *ether_desc; | |
97 | ||
98 | struct net_device *netdev; | |
99 | struct usb_device *udev; | |
100 | struct usb_host_endpoint *in_ep; | |
101 | struct usb_host_endpoint *out_ep; | |
102 | struct usb_host_endpoint *status_ep; | |
103 | struct usb_interface *intf; | |
104 | struct usb_interface *control; | |
105 | struct usb_interface *data; | |
106 | ||
107 | struct sk_buff *tx_curr_skb; | |
108 | struct sk_buff *tx_rem_skb; | |
109 | __le32 tx_rem_sign; | |
110 | ||
111 | spinlock_t mtx; | |
112 | atomic_t stop; | |
113 | ||
114 | u32 tx_timer_pending; | |
115 | u32 tx_curr_frame_num; | |
116 | u32 rx_speed; | |
117 | u32 tx_speed; | |
118 | u32 rx_max; | |
119 | u32 tx_max; | |
120 | u32 max_datagram_size; | |
121 | u16 tx_max_datagrams; | |
122 | u16 tx_remainder; | |
123 | u16 tx_modulus; | |
124 | u16 tx_ndp_modulus; | |
125 | u16 tx_seq; | |
126 | u16 rx_seq; | |
127 | u16 connected; | |
128 | }; | |
129 | ||
1e8bbe6c | 130 | extern u8 cdc_ncm_select_altsetting(struct usbnet *dev, struct usb_interface *intf); |
c91ce3b6 BM |
131 | extern int cdc_ncm_bind_common(struct usbnet *dev, struct usb_interface *intf, u8 data_altsetting); |
132 | extern void cdc_ncm_unbind(struct usbnet *dev, struct usb_interface *intf); | |
133 | extern struct sk_buff *cdc_ncm_fill_tx_frame(struct cdc_ncm_ctx *ctx, struct sk_buff *skb, __le32 sign); | |
134 | extern int cdc_ncm_rx_verify_nth16(struct cdc_ncm_ctx *ctx, struct sk_buff *skb_in); | |
135 | extern int cdc_ncm_rx_verify_ndp16(struct sk_buff *skb_in, int ndpoffset); |