Commit | Line | Data |
---|---|---|
4324fd49 DB |
1 | /* |
2 | * CDC Ethernet based networking peripherals | |
3 | * Copyright (C) 2003-2005 by David Brownell | |
ad55d71a | 4 | * Copyright (C) 2006 by Ole Andre Vadla Ravnas (ActiveSync) |
4324fd49 DB |
5 | * |
6 | * This program is free software; you can redistribute it and/or modify | |
7 | * it under the terms of the GNU General Public License as published by | |
8 | * the Free Software Foundation; either version 2 of the License, or | |
9 | * (at your option) any later version. | |
10 | * | |
11 | * This program is distributed in the hope that it will be useful, | |
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | * GNU General Public License for more details. | |
15 | * | |
16 | * You should have received a copy of the GNU General Public License | |
9cb00073 | 17 | * along with this program; if not, see <http://www.gnu.org/licenses/>. |
4324fd49 DB |
18 | */ |
19 | ||
20 | // #define DEBUG // error path messages, extra info | |
21 | // #define VERBOSE // more; success messages | |
22 | ||
4324fd49 | 23 | #include <linux/module.h> |
4324fd49 DB |
24 | #include <linux/netdevice.h> |
25 | #include <linux/etherdevice.h> | |
4324fd49 DB |
26 | #include <linux/ethtool.h> |
27 | #include <linux/workqueue.h> | |
28 | #include <linux/mii.h> | |
29 | #include <linux/usb.h> | |
a8c28f23 | 30 | #include <linux/usb/cdc.h> |
3692e94f | 31 | #include <linux/usb/usbnet.h> |
4324fd49 DB |
32 | |
33 | ||
8857ec28 | 34 | #if IS_ENABLED(CONFIG_USB_NET_RNDIS_HOST) |
ad55d71a OAVR |
35 | |
36 | static int is_rndis(struct usb_interface_descriptor *desc) | |
37 | { | |
8e95a202 JP |
38 | return (desc->bInterfaceClass == USB_CLASS_COMM && |
39 | desc->bInterfaceSubClass == 2 && | |
40 | desc->bInterfaceProtocol == 0xff); | |
ad55d71a OAVR |
41 | } |
42 | ||
43 | static int is_activesync(struct usb_interface_descriptor *desc) | |
44 | { | |
8e95a202 JP |
45 | return (desc->bInterfaceClass == USB_CLASS_MISC && |
46 | desc->bInterfaceSubClass == 1 && | |
47 | desc->bInterfaceProtocol == 1); | |
ad55d71a OAVR |
48 | } |
49 | ||
7e99eedd TB |
50 | static int is_wireless_rndis(struct usb_interface_descriptor *desc) |
51 | { | |
8e95a202 JP |
52 | return (desc->bInterfaceClass == USB_CLASS_WIRELESS_CONTROLLER && |
53 | desc->bInterfaceSubClass == 1 && | |
54 | desc->bInterfaceProtocol == 3); | |
7e99eedd TB |
55 | } |
56 | ||
ad55d71a OAVR |
57 | #else |
58 | ||
59 | #define is_rndis(desc) 0 | |
60 | #define is_activesync(desc) 0 | |
7e99eedd | 61 | #define is_wireless_rndis(desc) 0 |
ad55d71a OAVR |
62 | |
63 | #endif | |
64 | ||
21851264 JS |
65 | static const u8 mbm_guid[16] = { |
66 | 0xa3, 0x17, 0xa8, 0x8b, 0x04, 0x5e, 0x4f, 0x01, | |
67 | 0xa6, 0x07, 0xc0, 0xff, 0xcb, 0x7e, 0x39, 0x2a, | |
68 | }; | |
69 | ||
d80c679b OB |
70 | static void usbnet_cdc_update_filter(struct usbnet *dev) |
71 | { | |
72 | struct cdc_state *info = (void *) &dev->data; | |
73 | struct usb_interface *intf = info->control; | |
74 | ||
75 | u16 cdc_filter = | |
76 | USB_CDC_PACKET_TYPE_ALL_MULTICAST | USB_CDC_PACKET_TYPE_DIRECTED | | |
77 | USB_CDC_PACKET_TYPE_BROADCAST; | |
78 | ||
79 | /* FIXME cdc-ether has some multicast code too, though it complains | |
80 | * in routine cases. info->ether describes the multicast support. | |
81 | * Implement that here, manipulating the cdc filter as needed. | |
82 | */ | |
83 | ||
84 | usb_control_msg(dev->udev, | |
85 | usb_sndctrlpipe(dev->udev, 0), | |
86 | USB_CDC_SET_ETHERNET_PACKET_FILTER, | |
87 | USB_TYPE_CLASS | USB_RECIP_INTERFACE, | |
88 | cdc_filter, | |
89 | intf->cur_altsetting->desc.bInterfaceNumber, | |
90 | NULL, | |
91 | 0, | |
92 | USB_CTRL_SET_TIMEOUT | |
93 | ); | |
94 | } | |
95 | ||
8857ec28 | 96 | /* probes control interface, claims data interface, collects the bulk |
4324fd49 DB |
97 | * endpoints, activates data interface (if needed), maybe sets MTU. |
98 | * all pure cdc, except for certain firmware workarounds, and knowing | |
99 | * that rndis uses one different rule. | |
100 | */ | |
101 | int usbnet_generic_cdc_bind(struct usbnet *dev, struct usb_interface *intf) | |
102 | { | |
103 | u8 *buf = intf->cur_altsetting->extra; | |
104 | int len = intf->cur_altsetting->extralen; | |
105 | struct usb_interface_descriptor *d; | |
106 | struct cdc_state *info = (void *) &dev->data; | |
107 | int status; | |
108 | int rndis; | |
6eddcb4c | 109 | bool android_rndis_quirk = false; |
4324fd49 | 110 | struct usb_driver *driver = driver_of(intf); |
21851264 JS |
111 | struct usb_cdc_mdlm_desc *desc = NULL; |
112 | struct usb_cdc_mdlm_detail_desc *detail = NULL; | |
4324fd49 | 113 | |
8857ec28 | 114 | if (sizeof(dev->data) < sizeof(*info)) |
4324fd49 DB |
115 | return -EDOM; |
116 | ||
117 | /* expect strict spec conformance for the descriptors, but | |
118 | * cope with firmware which stores them in the wrong place | |
119 | */ | |
120 | if (len == 0 && dev->udev->actconfig->extralen) { | |
121 | /* Motorola SB4100 (and others: Brad Hards says it's | |
122 | * from a Broadcom design) put CDC descriptors here | |
123 | */ | |
124 | buf = dev->udev->actconfig->extra; | |
125 | len = dev->udev->actconfig->extralen; | |
f5260f02 | 126 | dev_dbg(&intf->dev, "CDC descriptors on config\n"); |
4324fd49 DB |
127 | } |
128 | ||
4149b72e DB |
129 | /* Maybe CDC descriptors are after the endpoint? This bug has |
130 | * been seen on some 2Wire Inc RNDIS-ish products. | |
131 | */ | |
132 | if (len == 0) { | |
133 | struct usb_host_endpoint *hep; | |
134 | ||
135 | hep = intf->cur_altsetting->endpoint; | |
136 | if (hep) { | |
137 | buf = hep->extra; | |
138 | len = hep->extralen; | |
139 | } | |
140 | if (len) | |
141 | dev_dbg(&intf->dev, | |
142 | "CDC descriptors on endpoint\n"); | |
143 | } | |
144 | ||
4324fd49 DB |
145 | /* this assumes that if there's a non-RNDIS vendor variant |
146 | * of cdc-acm, it'll fail RNDIS requests cleanly. | |
147 | */ | |
8e95a202 JP |
148 | rndis = (is_rndis(&intf->cur_altsetting->desc) || |
149 | is_activesync(&intf->cur_altsetting->desc) || | |
150 | is_wireless_rndis(&intf->cur_altsetting->desc)); | |
4324fd49 | 151 | |
8857ec28 | 152 | memset(info, 0, sizeof(*info)); |
4324fd49 DB |
153 | info->control = intf; |
154 | while (len > 3) { | |
8857ec28 | 155 | if (buf[1] != USB_DT_CS_INTERFACE) |
4324fd49 DB |
156 | goto next_desc; |
157 | ||
158 | /* use bDescriptorSubType to identify the CDC descriptors. | |
159 | * We expect devices with CDC header and union descriptors. | |
160 | * For CDC Ethernet we need the ethernet descriptor. | |
161 | * For RNDIS, ignore two (pointless) CDC modem descriptors | |
162 | * in favor of a complicated OID-based RPC scheme doing what | |
163 | * CDC Ethernet achieves with a simple descriptor. | |
164 | */ | |
8857ec28 | 165 | switch (buf[2]) { |
4324fd49 DB |
166 | case USB_CDC_HEADER_TYPE: |
167 | if (info->header) { | |
168 | dev_dbg(&intf->dev, "extra CDC header\n"); | |
169 | goto bad_desc; | |
170 | } | |
171 | info->header = (void *) buf; | |
8857ec28 | 172 | if (info->header->bLength != sizeof(*info->header)) { |
4324fd49 DB |
173 | dev_dbg(&intf->dev, "CDC header len %u\n", |
174 | info->header->bLength); | |
175 | goto bad_desc; | |
176 | } | |
177 | break; | |
ad55d71a OAVR |
178 | case USB_CDC_ACM_TYPE: |
179 | /* paranoia: disambiguate a "real" vendor-specific | |
180 | * modem interface from an RNDIS non-modem. | |
181 | */ | |
182 | if (rndis) { | |
afaee82c | 183 | struct usb_cdc_acm_descriptor *acm; |
ad55d71a | 184 | |
afaee82c DB |
185 | acm = (void *) buf; |
186 | if (acm->bmCapabilities) { | |
ad55d71a OAVR |
187 | dev_dbg(&intf->dev, |
188 | "ACM capabilities %02x, " | |
189 | "not really RNDIS?\n", | |
afaee82c | 190 | acm->bmCapabilities); |
ad55d71a OAVR |
191 | goto bad_desc; |
192 | } | |
193 | } | |
194 | break; | |
4324fd49 DB |
195 | case USB_CDC_UNION_TYPE: |
196 | if (info->u) { | |
197 | dev_dbg(&intf->dev, "extra CDC union\n"); | |
198 | goto bad_desc; | |
199 | } | |
200 | info->u = (void *) buf; | |
8857ec28 | 201 | if (info->u->bLength != sizeof(*info->u)) { |
4324fd49 DB |
202 | dev_dbg(&intf->dev, "CDC union len %u\n", |
203 | info->u->bLength); | |
204 | goto bad_desc; | |
205 | } | |
206 | ||
207 | /* we need a master/control interface (what we're | |
208 | * probed with) and a slave/data interface; union | |
209 | * descriptors sort this all out. | |
210 | */ | |
211 | info->control = usb_ifnum_to_if(dev->udev, | |
212 | info->u->bMasterInterface0); | |
213 | info->data = usb_ifnum_to_if(dev->udev, | |
214 | info->u->bSlaveInterface0); | |
215 | if (!info->control || !info->data) { | |
216 | dev_dbg(&intf->dev, | |
217 | "master #%u/%p slave #%u/%p\n", | |
218 | info->u->bMasterInterface0, | |
219 | info->control, | |
220 | info->u->bSlaveInterface0, | |
221 | info->data); | |
6eddcb4c BM |
222 | /* fall back to hard-wiring for RNDIS */ |
223 | if (rndis) { | |
224 | android_rndis_quirk = true; | |
225 | goto next_desc; | |
226 | } | |
4324fd49 DB |
227 | goto bad_desc; |
228 | } | |
229 | if (info->control != intf) { | |
230 | dev_dbg(&intf->dev, "bogus CDC Union\n"); | |
231 | /* Ambit USB Cable Modem (and maybe others) | |
232 | * interchanges master and slave interface. | |
233 | */ | |
234 | if (info->data == intf) { | |
235 | info->data = info->control; | |
236 | info->control = intf; | |
237 | } else | |
238 | goto bad_desc; | |
239 | } | |
240 | ||
1fc4c84d BM |
241 | /* some devices merge these - skip class check */ |
242 | if (info->control == info->data) | |
243 | goto next_desc; | |
244 | ||
4324fd49 DB |
245 | /* a data interface altsetting does the real i/o */ |
246 | d = &info->data->cur_altsetting->desc; | |
247 | if (d->bInterfaceClass != USB_CLASS_CDC_DATA) { | |
248 | dev_dbg(&intf->dev, "slave class %u\n", | |
249 | d->bInterfaceClass); | |
250 | goto bad_desc; | |
251 | } | |
252 | break; | |
253 | case USB_CDC_ETHERNET_TYPE: | |
254 | if (info->ether) { | |
255 | dev_dbg(&intf->dev, "extra CDC ether\n"); | |
256 | goto bad_desc; | |
257 | } | |
258 | info->ether = (void *) buf; | |
8857ec28 | 259 | if (info->ether->bLength != sizeof(*info->ether)) { |
4324fd49 DB |
260 | dev_dbg(&intf->dev, "CDC ether len %u\n", |
261 | info->ether->bLength); | |
262 | goto bad_desc; | |
263 | } | |
264 | dev->hard_mtu = le16_to_cpu( | |
265 | info->ether->wMaxSegmentSize); | |
266 | /* because of Zaurus, we may be ignoring the host | |
267 | * side link address we were given. | |
268 | */ | |
269 | break; | |
21851264 JS |
270 | case USB_CDC_MDLM_TYPE: |
271 | if (desc) { | |
272 | dev_dbg(&intf->dev, "extra MDLM descriptor\n"); | |
273 | goto bad_desc; | |
274 | } | |
275 | ||
276 | desc = (void *)buf; | |
277 | ||
278 | if (desc->bLength != sizeof(*desc)) | |
279 | goto bad_desc; | |
280 | ||
281 | if (memcmp(&desc->bGUID, mbm_guid, 16)) | |
282 | goto bad_desc; | |
283 | break; | |
284 | case USB_CDC_MDLM_DETAIL_TYPE: | |
285 | if (detail) { | |
286 | dev_dbg(&intf->dev, "extra MDLM detail descriptor\n"); | |
287 | goto bad_desc; | |
288 | } | |
289 | ||
290 | detail = (void *)buf; | |
291 | ||
292 | if (detail->bGuidDescriptorType == 0) { | |
293 | if (detail->bLength < (sizeof(*detail) + 1)) | |
294 | goto bad_desc; | |
295 | } else | |
296 | goto bad_desc; | |
297 | break; | |
4324fd49 DB |
298 | } |
299 | next_desc: | |
8857ec28 FP |
300 | len -= buf[0]; /* bLength */ |
301 | buf += buf[0]; | |
4324fd49 DB |
302 | } |
303 | ||
786e3dfb BD |
304 | /* Microsoft ActiveSync based and some regular RNDIS devices lack the |
305 | * CDC descriptors, so we'll hard-wire the interfaces and not check | |
306 | * for descriptors. | |
6eddcb4c BM |
307 | * |
308 | * Some Android RNDIS devices have a CDC Union descriptor pointing | |
309 | * to non-existing interfaces. Ignore that and attempt the same | |
310 | * hard-wired 0 and 1 interfaces. | |
ad55d71a | 311 | */ |
6eddcb4c | 312 | if (rndis && (!info->u || android_rndis_quirk)) { |
ad55d71a OAVR |
313 | info->control = usb_ifnum_to_if(dev->udev, 0); |
314 | info->data = usb_ifnum_to_if(dev->udev, 1); | |
6eddcb4c | 315 | if (!info->control || !info->data || info->control != intf) { |
ad55d71a | 316 | dev_dbg(&intf->dev, |
786e3dfb | 317 | "rndis: master #0/%p slave #1/%p\n", |
ad55d71a OAVR |
318 | info->control, |
319 | info->data); | |
320 | goto bad_desc; | |
321 | } | |
322 | ||
323 | } else if (!info->header || !info->u || (!rndis && !info->ether)) { | |
4324fd49 DB |
324 | dev_dbg(&intf->dev, "missing cdc %s%s%sdescriptor\n", |
325 | info->header ? "" : "header ", | |
326 | info->u ? "" : "union ", | |
327 | info->ether ? "" : "ether "); | |
328 | goto bad_desc; | |
329 | } | |
330 | ||
331 | /* claim data interface and set it up ... with side effects. | |
332 | * network traffic can't flow until an altsetting is enabled. | |
333 | */ | |
1fc4c84d BM |
334 | if (info->data != info->control) { |
335 | status = usb_driver_claim_interface(driver, info->data, dev); | |
336 | if (status < 0) | |
337 | return status; | |
338 | } | |
4324fd49 DB |
339 | status = usbnet_get_endpoints(dev, info->data); |
340 | if (status < 0) { | |
341 | /* ensure immediate exit from usbnet_disconnect */ | |
342 | usb_set_intfdata(info->data, NULL); | |
1fc4c84d BM |
343 | if (info->data != info->control) |
344 | usb_driver_release_interface(driver, info->data); | |
4324fd49 DB |
345 | return status; |
346 | } | |
347 | ||
348 | /* status endpoint: optional for CDC Ethernet, not RNDIS (or ACM) */ | |
1fc4c84d BM |
349 | if (info->data != info->control) |
350 | dev->status = NULL; | |
4324fd49 DB |
351 | if (info->control->cur_altsetting->desc.bNumEndpoints == 1) { |
352 | struct usb_endpoint_descriptor *desc; | |
353 | ||
354 | dev->status = &info->control->cur_altsetting->endpoint [0]; | |
355 | desc = &dev->status->desc; | |
8e95a202 JP |
356 | if (!usb_endpoint_is_int_in(desc) || |
357 | (le16_to_cpu(desc->wMaxPacketSize) | |
358 | < sizeof(struct usb_cdc_notification)) || | |
359 | !desc->bInterval) { | |
4324fd49 DB |
360 | dev_dbg(&intf->dev, "bad notification endpoint\n"); |
361 | dev->status = NULL; | |
362 | } | |
363 | } | |
364 | if (rndis && !dev->status) { | |
365 | dev_dbg(&intf->dev, "missing RNDIS status endpoint\n"); | |
366 | usb_set_intfdata(info->data, NULL); | |
367 | usb_driver_release_interface(driver, info->data); | |
368 | return -ENODEV; | |
369 | } | |
c472ab68 ON |
370 | |
371 | /* Some devices don't initialise properly. In particular | |
372 | * the packet filter is not reset. There are devices that | |
373 | * don't do reset all the way. So the packet filter should | |
374 | * be set to a sane initial value. | |
375 | */ | |
d80c679b OB |
376 | usbnet_cdc_update_filter(dev); |
377 | ||
4324fd49 DB |
378 | return 0; |
379 | ||
380 | bad_desc: | |
381 | dev_info(&dev->udev->dev, "bad CDC descriptors\n"); | |
382 | return -ENODEV; | |
383 | } | |
384 | EXPORT_SYMBOL_GPL(usbnet_generic_cdc_bind); | |
385 | ||
386 | void usbnet_cdc_unbind(struct usbnet *dev, struct usb_interface *intf) | |
387 | { | |
388 | struct cdc_state *info = (void *) &dev->data; | |
389 | struct usb_driver *driver = driver_of(intf); | |
390 | ||
1fc4c84d BM |
391 | /* combined interface - nothing to do */ |
392 | if (info->data == info->control) | |
393 | return; | |
394 | ||
4324fd49 DB |
395 | /* disconnect master --> disconnect slave */ |
396 | if (intf == info->control && info->data) { | |
397 | /* ensure immediate exit from usbnet_disconnect */ | |
398 | usb_set_intfdata(info->data, NULL); | |
399 | usb_driver_release_interface(driver, info->data); | |
400 | info->data = NULL; | |
401 | } | |
402 | ||
403 | /* and vice versa (just in case) */ | |
404 | else if (intf == info->data && info->control) { | |
405 | /* ensure immediate exit from usbnet_disconnect */ | |
406 | usb_set_intfdata(info->control, NULL); | |
407 | usb_driver_release_interface(driver, info->control); | |
408 | info->control = NULL; | |
409 | } | |
410 | } | |
411 | EXPORT_SYMBOL_GPL(usbnet_cdc_unbind); | |
412 | ||
8857ec28 | 413 | /* Communications Device Class, Ethernet Control model |
4324fd49 DB |
414 | * |
415 | * Takes two interfaces. The DATA interface is inactive till an altsetting | |
416 | * is selected. Configuration data includes class descriptors. There's | |
417 | * an optional status endpoint on the control interface. | |
418 | * | |
419 | * This should interop with whatever the 2.4 "CDCEther.c" driver | |
420 | * (by Brad Hards) talked with, with more functionality. | |
8857ec28 | 421 | */ |
4324fd49 DB |
422 | |
423 | static void dumpspeed(struct usbnet *dev, __le32 *speeds) | |
424 | { | |
a475f603 JP |
425 | netif_info(dev, timer, dev->net, |
426 | "link speeds: %u kbps up, %u kbps down\n", | |
427 | __le32_to_cpu(speeds[0]) / 1000, | |
428 | __le32_to_cpu(speeds[1]) / 1000); | |
4324fd49 DB |
429 | } |
430 | ||
7a635ea9 | 431 | void usbnet_cdc_status(struct usbnet *dev, struct urb *urb) |
4324fd49 DB |
432 | { |
433 | struct usb_cdc_notification *event; | |
434 | ||
8857ec28 | 435 | if (urb->actual_length < sizeof(*event)) |
4324fd49 DB |
436 | return; |
437 | ||
438 | /* SPEED_CHANGE can get split into two 8-byte packets */ | |
439 | if (test_and_clear_bit(EVENT_STS_SPLIT, &dev->flags)) { | |
440 | dumpspeed(dev, (__le32 *) urb->transfer_buffer); | |
441 | return; | |
442 | } | |
443 | ||
444 | event = urb->transfer_buffer; | |
445 | switch (event->bNotificationType) { | |
446 | case USB_CDC_NOTIFY_NETWORK_CONNECTION: | |
a475f603 JP |
447 | netif_dbg(dev, timer, dev->net, "CDC: carrier %s\n", |
448 | event->wValue ? "on" : "off"); | |
a6bda459 | 449 | usbnet_link_change(dev, !!event->wValue, 0); |
4324fd49 DB |
450 | break; |
451 | case USB_CDC_NOTIFY_SPEED_CHANGE: /* tx/rx rates */ | |
a475f603 JP |
452 | netif_dbg(dev, timer, dev->net, "CDC: speed change (len %d)\n", |
453 | urb->actual_length); | |
8857ec28 | 454 | if (urb->actual_length != (sizeof(*event) + 8)) |
4324fd49 DB |
455 | set_bit(EVENT_STS_SPLIT, &dev->flags); |
456 | else | |
457 | dumpspeed(dev, (__le32 *) &event[1]); | |
458 | break; | |
459 | /* USB_CDC_NOTIFY_RESPONSE_AVAILABLE can happen too (e.g. RNDIS), | |
460 | * but there are no standard formats for the response data. | |
461 | */ | |
462 | default: | |
60b86755 JP |
463 | netdev_err(dev->net, "CDC: unexpected notification %02x!\n", |
464 | event->bNotificationType); | |
4324fd49 DB |
465 | break; |
466 | } | |
467 | } | |
7a635ea9 | 468 | EXPORT_SYMBOL_GPL(usbnet_cdc_status); |
4324fd49 | 469 | |
7a635ea9 | 470 | int usbnet_cdc_bind(struct usbnet *dev, struct usb_interface *intf) |
4324fd49 DB |
471 | { |
472 | int status; | |
473 | struct cdc_state *info = (void *) &dev->data; | |
474 | ||
d632eb1b GKH |
475 | BUILD_BUG_ON((sizeof(((struct usbnet *)0)->data) |
476 | < sizeof(struct cdc_state))); | |
477 | ||
4324fd49 DB |
478 | status = usbnet_generic_cdc_bind(dev, intf); |
479 | if (status < 0) | |
480 | return status; | |
481 | ||
03ad032b | 482 | status = usbnet_get_ethernet_addr(dev, info->ether->iMACAddress); |
4324fd49 DB |
483 | if (status < 0) { |
484 | usb_set_intfdata(info->data, NULL); | |
485 | usb_driver_release_interface(driver_of(intf), info->data); | |
486 | return status; | |
487 | } | |
488 | ||
4324fd49 DB |
489 | return 0; |
490 | } | |
7a635ea9 | 491 | EXPORT_SYMBOL_GPL(usbnet_cdc_bind); |
4324fd49 DB |
492 | |
493 | static const struct driver_info cdc_info = { | |
494 | .description = "CDC Ethernet Device", | |
c261344d | 495 | .flags = FLAG_ETHER | FLAG_POINTTOPOINT, |
7a635ea9 | 496 | .bind = usbnet_cdc_bind, |
4324fd49 | 497 | .unbind = usbnet_cdc_unbind, |
7a635ea9 | 498 | .status = usbnet_cdc_status, |
a5e40708 | 499 | .manage_power = usbnet_manage_power, |
4324fd49 DB |
500 | }; |
501 | ||
b3c914aa | 502 | static const struct driver_info wwan_info = { |
e1e499ee MH |
503 | .description = "Mobile Broadband Network Device", |
504 | .flags = FLAG_WWAN, | |
7a635ea9 | 505 | .bind = usbnet_cdc_bind, |
e1e499ee | 506 | .unbind = usbnet_cdc_unbind, |
7a635ea9 | 507 | .status = usbnet_cdc_status, |
a5e40708 | 508 | .manage_power = usbnet_manage_power, |
e1e499ee MH |
509 | }; |
510 | ||
4324fd49 DB |
511 | /*-------------------------------------------------------------------------*/ |
512 | ||
b3c914aa | 513 | #define HUAWEI_VENDOR_ID 0x12D1 |
4e6304b8 | 514 | #define NOVATEL_VENDOR_ID 0x1410 |
68d8318b | 515 | #define ZTE_VENDOR_ID 0x19D2 |
0370acd4 | 516 | #define DELL_VENDOR_ID 0x413C |
ac718b69 | 517 | #define REALTEK_VENDOR_ID 0x0bda |
43779f8d | 518 | #define SAMSUNG_VENDOR_ID 0x04e8 |
4324fd49 | 519 | |
8857ec28 FP |
520 | static const struct usb_device_id products[] = { |
521 | /* BLACKLIST !! | |
4324fd49 DB |
522 | * |
523 | * First blacklist any products that are egregiously nonconformant | |
524 | * with the CDC Ethernet specs. Minor braindamage we cope with; when | |
525 | * they're not even trying, needing a separate driver is only the first | |
526 | * of the differences to show up. | |
527 | */ | |
528 | ||
529 | #define ZAURUS_MASTER_INTERFACE \ | |
530 | .bInterfaceClass = USB_CLASS_COMM, \ | |
531 | .bInterfaceSubClass = USB_CDC_SUBCLASS_ETHERNET, \ | |
532 | .bInterfaceProtocol = USB_CDC_PROTO_NONE | |
533 | ||
534 | /* SA-1100 based Sharp Zaurus ("collie"), or compatible; | |
535 | * wire-incompatible with true CDC Ethernet implementations. | |
536 | * (And, it seems, needlessly so...) | |
537 | */ | |
538 | { | |
539 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
540 | | USB_DEVICE_ID_MATCH_DEVICE, | |
541 | .idVendor = 0x04DD, | |
542 | .idProduct = 0x8004, | |
543 | ZAURUS_MASTER_INTERFACE, | |
544 | .driver_info = 0, | |
545 | }, | |
546 | ||
547 | /* PXA-25x based Sharp Zaurii. Note that it seems some of these | |
548 | * (later models especially) may have shipped only with firmware | |
549 | * advertising false "CDC MDLM" compatibility ... but we're not | |
550 | * clear which models did that, so for now let's assume the worst. | |
551 | */ | |
552 | { | |
553 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
554 | | USB_DEVICE_ID_MATCH_DEVICE, | |
555 | .idVendor = 0x04DD, | |
556 | .idProduct = 0x8005, /* A-300 */ | |
557 | ZAURUS_MASTER_INTERFACE, | |
558 | .driver_info = 0, | |
559 | }, { | |
560 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
561 | | USB_DEVICE_ID_MATCH_DEVICE, | |
562 | .idVendor = 0x04DD, | |
563 | .idProduct = 0x8006, /* B-500/SL-5600 */ | |
564 | ZAURUS_MASTER_INTERFACE, | |
565 | .driver_info = 0, | |
566 | }, { | |
567 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
8857ec28 | 568 | | USB_DEVICE_ID_MATCH_DEVICE, |
4324fd49 DB |
569 | .idVendor = 0x04DD, |
570 | .idProduct = 0x8007, /* C-700 */ | |
571 | ZAURUS_MASTER_INTERFACE, | |
572 | .driver_info = 0, | |
573 | }, { | |
574 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
575 | | USB_DEVICE_ID_MATCH_DEVICE, | |
576 | .idVendor = 0x04DD, | |
577 | .idProduct = 0x9031, /* C-750 C-760 */ | |
578 | ZAURUS_MASTER_INTERFACE, | |
579 | .driver_info = 0, | |
580 | }, { | |
581 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
582 | | USB_DEVICE_ID_MATCH_DEVICE, | |
583 | .idVendor = 0x04DD, | |
584 | .idProduct = 0x9032, /* SL-6000 */ | |
585 | ZAURUS_MASTER_INTERFACE, | |
586 | .driver_info = 0, | |
587 | }, { | |
588 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
589 | | USB_DEVICE_ID_MATCH_DEVICE, | |
590 | .idVendor = 0x04DD, | |
591 | /* reported with some C860 units */ | |
592 | .idProduct = 0x9050, /* C-860 */ | |
593 | ZAURUS_MASTER_INTERFACE, | |
594 | .driver_info = 0, | |
595 | }, | |
596 | ||
efcaa205 DB |
597 | /* Olympus has some models with a Zaurus-compatible option. |
598 | * R-1000 uses a FreeScale i.MXL cpu (ARMv4T) | |
599 | */ | |
600 | { | |
601 | .match_flags = USB_DEVICE_ID_MATCH_INT_INFO | |
602 | | USB_DEVICE_ID_MATCH_DEVICE, | |
603 | .idVendor = 0x07B4, | |
604 | .idProduct = 0x0F02, /* R-1000 */ | |
605 | ZAURUS_MASTER_INTERFACE, | |
606 | .driver_info = 0, | |
607 | }, | |
608 | ||
7a635ea9 AZ |
609 | /* LG Electronics VL600 wants additional headers on every frame */ |
610 | { | |
611 | USB_DEVICE_AND_INTERFACE_INFO(0x1004, 0x61aa, USB_CLASS_COMM, | |
612 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
6d74eb94 | 613 | .driver_info = 0, |
7a635ea9 AZ |
614 | }, |
615 | ||
ee932bf9 ST |
616 | /* Logitech Harmony 900 - uses the pseudo-MDLM (BLAN) driver */ |
617 | { | |
618 | USB_DEVICE_AND_INTERFACE_INFO(0x046d, 0xc11f, USB_CLASS_COMM, | |
619 | USB_CDC_SUBCLASS_MDLM, USB_CDC_PROTO_NONE), | |
620 | .driver_info = 0, | |
621 | }, | |
622 | ||
f8295ec2 DW |
623 | /* Novatel USB551L and MC551 - handled by qmi_wwan */ |
624 | { | |
c39ba1c2 DW |
625 | USB_DEVICE_AND_INTERFACE_INFO(NOVATEL_VENDOR_ID, 0xB001, USB_CLASS_COMM, |
626 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
f8295ec2 DW |
627 | .driver_info = 0, |
628 | }, | |
629 | ||
630 | /* Novatel E362 - handled by qmi_wwan */ | |
631 | { | |
c39ba1c2 DW |
632 | USB_DEVICE_AND_INTERFACE_INFO(NOVATEL_VENDOR_ID, 0x9010, USB_CLASS_COMM, |
633 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
f8295ec2 DW |
634 | .driver_info = 0, |
635 | }, | |
636 | ||
0370acd4 DW |
637 | /* Dell Wireless 5800 (Novatel E362) - handled by qmi_wwan */ |
638 | { | |
639 | USB_DEVICE_AND_INTERFACE_INFO(DELL_VENDOR_ID, 0x8195, USB_CLASS_COMM, | |
640 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
641 | .driver_info = 0, | |
642 | }, | |
643 | ||
644 | /* Dell Wireless 5800 (Novatel E362) - handled by qmi_wwan */ | |
645 | { | |
646 | USB_DEVICE_AND_INTERFACE_INFO(DELL_VENDOR_ID, 0x8196, USB_CLASS_COMM, | |
647 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
648 | .driver_info = 0, | |
649 | }, | |
650 | ||
7fdb7846 DW |
651 | /* Dell Wireless 5804 (Novatel E371) - handled by qmi_wwan */ |
652 | { | |
653 | USB_DEVICE_AND_INTERFACE_INFO(DELL_VENDOR_ID, 0x819b, USB_CLASS_COMM, | |
654 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
655 | .driver_info = 0, | |
656 | }, | |
657 | ||
7b5939ba YY |
658 | /* Novatel Expedite E371 - handled by qmi_wwan */ |
659 | { | |
660 | USB_DEVICE_AND_INTERFACE_INFO(NOVATEL_VENDOR_ID, 0x9011, USB_CLASS_COMM, | |
661 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
662 | .driver_info = 0, | |
663 | }, | |
664 | ||
45d213f5 DW |
665 | /* AnyDATA ADU960S - handled by qmi_wwan */ |
666 | { | |
667 | USB_DEVICE_AND_INTERFACE_INFO(0x16d5, 0x650a, USB_CLASS_COMM, | |
668 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
669 | .driver_info = 0, | |
670 | }, | |
671 | ||
c2020be3 BM |
672 | /* Huawei E1820 - handled by qmi_wwan */ |
673 | { | |
674 | USB_DEVICE_INTERFACE_NUMBER(HUAWEI_VENDOR_ID, 0x14ac, 1), | |
675 | .driver_info = 0, | |
676 | }, | |
677 | ||
ac718b69 | 678 | /* Realtek RTL8152 Based USB 2.0 Ethernet Adapters */ |
ac718b69 | 679 | { |
680 | USB_DEVICE_AND_INTERFACE_INFO(REALTEK_VENDOR_ID, 0x8152, USB_CLASS_COMM, | |
681 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
682 | .driver_info = 0, | |
683 | }, | |
c073f666 | 684 | |
685 | /* Realtek RTL8153 Based USB 3.0 Ethernet Adapters */ | |
686 | { | |
687 | USB_DEVICE_AND_INTERFACE_INFO(REALTEK_VENDOR_ID, 0x8153, USB_CLASS_COMM, | |
688 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
689 | .driver_info = 0, | |
690 | }, | |
ac718b69 | 691 | |
10c32717 | 692 | /* Samsung USB Ethernet Adapters */ |
693 | { | |
694 | USB_DEVICE_AND_INTERFACE_INFO(SAMSUNG_VENDOR_ID, 0xa101, USB_CLASS_COMM, | |
695 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
696 | .driver_info = 0, | |
697 | }, | |
698 | ||
8857ec28 | 699 | /* WHITELIST!!! |
4324fd49 DB |
700 | * |
701 | * CDC Ether uses two interfaces, not necessarily consecutive. | |
702 | * We match the main interface, ignoring the optional device | |
703 | * class so we could handle devices that aren't exclusively | |
704 | * CDC ether. | |
705 | * | |
706 | * NOTE: this match must come AFTER entries blacklisting devices | |
707 | * because of bugs/quirks in a given product (like Zaurus, above). | |
708 | */ | |
709 | { | |
68d8318b | 710 | /* ZTE (Vodafone) K3805-Z */ |
d82a7f54 FP |
711 | USB_DEVICE_AND_INTERFACE_INFO(ZTE_VENDOR_ID, 0x1003, USB_CLASS_COMM, |
712 | USB_CDC_SUBCLASS_ETHERNET, | |
713 | USB_CDC_PROTO_NONE), | |
68d8318b ABSS |
714 | .driver_info = (unsigned long)&wwan_info, |
715 | }, { | |
716 | /* ZTE (Vodafone) K3806-Z */ | |
d82a7f54 FP |
717 | USB_DEVICE_AND_INTERFACE_INFO(ZTE_VENDOR_ID, 0x1015, USB_CLASS_COMM, |
718 | USB_CDC_SUBCLASS_ETHERNET, | |
719 | USB_CDC_PROTO_NONE), | |
68d8318b ABSS |
720 | .driver_info = (unsigned long)&wwan_info, |
721 | }, { | |
722 | /* ZTE (Vodafone) K4510-Z */ | |
d82a7f54 FP |
723 | USB_DEVICE_AND_INTERFACE_INFO(ZTE_VENDOR_ID, 0x1173, USB_CLASS_COMM, |
724 | USB_CDC_SUBCLASS_ETHERNET, | |
725 | USB_CDC_PROTO_NONE), | |
68d8318b ABSS |
726 | .driver_info = (unsigned long)&wwan_info, |
727 | }, { | |
728 | /* ZTE (Vodafone) K3770-Z */ | |
d82a7f54 FP |
729 | USB_DEVICE_AND_INTERFACE_INFO(ZTE_VENDOR_ID, 0x1177, USB_CLASS_COMM, |
730 | USB_CDC_SUBCLASS_ETHERNET, | |
731 | USB_CDC_PROTO_NONE), | |
68d8318b ABSS |
732 | .driver_info = (unsigned long)&wwan_info, |
733 | }, { | |
734 | /* ZTE (Vodafone) K3772-Z */ | |
d82a7f54 FP |
735 | USB_DEVICE_AND_INTERFACE_INFO(ZTE_VENDOR_ID, 0x1181, USB_CLASS_COMM, |
736 | USB_CDC_SUBCLASS_ETHERNET, | |
737 | USB_CDC_PROTO_NONE), | |
68d8318b | 738 | .driver_info = (unsigned long)&wwan_info, |
00928204 FP |
739 | }, { |
740 | /* Telit modules */ | |
741 | USB_VENDOR_AND_INTERFACE_INFO(0x1bc7, USB_CLASS_COMM, | |
742 | USB_CDC_SUBCLASS_ETHERNET, USB_CDC_PROTO_NONE), | |
743 | .driver_info = (kernel_ulong_t) &wwan_info, | |
4e6304b8 | 744 | }, { |
4324fd49 DB |
745 | USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ETHERNET, |
746 | USB_CDC_PROTO_NONE), | |
747 | .driver_info = (unsigned long) &cdc_info, | |
cac477e8 | 748 | }, { |
21851264 JS |
749 | USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_MDLM, |
750 | USB_CDC_PROTO_NONE), | |
b3c914aa | 751 | .driver_info = (unsigned long)&wwan_info, |
21851264 | 752 | |
b3c914aa DW |
753 | }, { |
754 | /* Various Huawei modems with a network port like the UMG1831 */ | |
d82a7f54 FP |
755 | USB_VENDOR_AND_INTERFACE_INFO(HUAWEI_VENDOR_ID, USB_CLASS_COMM, |
756 | USB_CDC_SUBCLASS_ETHERNET, 255), | |
b3c914aa | 757 | .driver_info = (unsigned long)&wwan_info, |
4324fd49 | 758 | }, |
8857ec28 | 759 | { }, /* END */ |
4324fd49 DB |
760 | }; |
761 | MODULE_DEVICE_TABLE(usb, products); | |
762 | ||
763 | static struct usb_driver cdc_driver = { | |
4324fd49 DB |
764 | .name = "cdc_ether", |
765 | .id_table = products, | |
766 | .probe = usbnet_probe, | |
767 | .disconnect = usbnet_disconnect, | |
768 | .suspend = usbnet_suspend, | |
769 | .resume = usbnet_resume, | |
7f515790 | 770 | .reset_resume = usbnet_resume, |
69ee472f | 771 | .supports_autosuspend = 1, |
e1f12eb6 | 772 | .disable_hub_initiated_lpm = 1, |
4324fd49 DB |
773 | }; |
774 | ||
d632eb1b | 775 | module_usb_driver(cdc_driver); |
4324fd49 DB |
776 | |
777 | MODULE_AUTHOR("David Brownell"); | |
778 | MODULE_DESCRIPTION("USB CDC Ethernet devices"); | |
779 | MODULE_LICENSE("GPL"); |