1 /* 2 * ether.c -- Ethernet gadget driver, with CDC and non-CDC options 3 * 4 * Copyright (C) 2003-2005,2008 David Brownell 5 * Copyright (C) 2003-2004 Robert Schwebel, Benedikt Spranger 6 * Copyright (C) 2008 Nokia Corporation 7 * 8 * SPDX-License-Identifier: GPL-2.0+ 9 */ 10 11 #include <common.h> 12 #include <asm/errno.h> 13 #include <linux/netdevice.h> 14 #include <linux/usb/ch9.h> 15 #include <linux/usb/cdc.h> 16 #include <linux/usb/gadget.h> 17 #include <net.h> 18 #include <usb.h> 19 #include <malloc.h> 20 #include <memalign.h> 21 #include <linux/ctype.h> 22 23 #include "gadget_chips.h" 24 #include "rndis.h" 25 26 #define USB_NET_NAME "usb_ether" 27 28 #define atomic_read 29 extern struct platform_data brd; 30 31 32 unsigned packet_received, packet_sent; 33 34 /* 35 * Ethernet gadget driver -- with CDC and non-CDC options 36 * Builds on hardware support for a full duplex link. 37 * 38 * CDC Ethernet is the standard USB solution for sending Ethernet frames 39 * using USB. Real hardware tends to use the same framing protocol but look 40 * different for control features. This driver strongly prefers to use 41 * this USB-IF standard as its open-systems interoperability solution; 42 * most host side USB stacks (except from Microsoft) support it. 43 * 44 * This is sometimes called "CDC ECM" (Ethernet Control Model) to support 45 * TLA-soup. "CDC ACM" (Abstract Control Model) is for modems, and a new 46 * "CDC EEM" (Ethernet Emulation Model) is starting to spread. 47 * 48 * There's some hardware that can't talk CDC ECM. We make that hardware 49 * implement a "minimalist" vendor-agnostic CDC core: same framing, but 50 * link-level setup only requires activating the configuration. Only the 51 * endpoint descriptors, and product/vendor IDs, are relevant; no control 52 * operations are available. Linux supports it, but other host operating 53 * systems may not. (This is a subset of CDC Ethernet.) 54 * 55 * It turns out that if you add a few descriptors to that "CDC Subset", 56 * (Windows) host side drivers from MCCI can treat it as one submode of 57 * a proprietary scheme called "SAFE" ... without needing to know about 58 * specific product/vendor IDs. So we do that, making it easier to use 59 * those MS-Windows drivers. Those added descriptors make it resemble a 60 * CDC MDLM device, but they don't change device behavior at all. (See 61 * MCCI Engineering report 950198 "SAFE Networking Functions".) 62 * 63 * A third option is also in use. Rather than CDC Ethernet, or something 64 * simpler, Microsoft pushes their own approach: RNDIS. The published 65 * RNDIS specs are ambiguous and appear to be incomplete, and are also 66 * needlessly complex. They borrow more from CDC ACM than CDC ECM. 67 */ 68 #define ETH_ALEN 6 /* Octets in one ethernet addr */ 69 #define ETH_HLEN 14 /* Total octets in header. */ 70 #define ETH_ZLEN 60 /* Min. octets in frame sans FCS */ 71 #define ETH_DATA_LEN 1500 /* Max. octets in payload */ 72 #define ETH_FRAME_LEN PKTSIZE_ALIGN /* Max. octets in frame sans FCS */ 73 74 #define DRIVER_DESC "Ethernet Gadget" 75 /* Based on linux 2.6.27 version */ 76 #define DRIVER_VERSION "May Day 2005" 77 78 static const char shortname[] = "ether"; 79 static const char driver_desc[] = DRIVER_DESC; 80 81 #define RX_EXTRA 20 /* guard against rx overflows */ 82 83 #ifndef CONFIG_USB_ETH_RNDIS 84 #define rndis_uninit(x) do {} while (0) 85 #define rndis_deregister(c) do {} while (0) 86 #define rndis_exit() do {} while (0) 87 #endif 88 89 /* CDC and RNDIS support the same host-chosen outgoing packet filters. */ 90 #define DEFAULT_FILTER (USB_CDC_PACKET_TYPE_BROADCAST \ 91 |USB_CDC_PACKET_TYPE_ALL_MULTICAST \ 92 |USB_CDC_PACKET_TYPE_PROMISCUOUS \ 93 |USB_CDC_PACKET_TYPE_DIRECTED) 94 95 #define USB_CONNECT_TIMEOUT (3 * CONFIG_SYS_HZ) 96 97 /*-------------------------------------------------------------------------*/ 98 99 struct eth_dev { 100 struct usb_gadget *gadget; 101 struct usb_request *req; /* for control responses */ 102 struct usb_request *stat_req; /* for cdc & rndis status */ 103 104 u8 config; 105 struct usb_ep *in_ep, *out_ep, *status_ep; 106 const struct usb_endpoint_descriptor 107 *in, *out, *status; 108 109 struct usb_request *tx_req, *rx_req; 110 111 struct eth_device *net; 112 struct net_device_stats stats; 113 unsigned int tx_qlen; 114 115 unsigned zlp:1; 116 unsigned cdc:1; 117 unsigned rndis:1; 118 unsigned suspended:1; 119 unsigned network_started:1; 120 u16 cdc_filter; 121 unsigned long todo; 122 int mtu; 123 #define WORK_RX_MEMORY 0 124 int rndis_config; 125 u8 host_mac[ETH_ALEN]; 126 }; 127 128 /* 129 * This version autoconfigures as much as possible at run-time. 130 * 131 * It also ASSUMES a self-powered device, without remote wakeup, 132 * although remote wakeup support would make sense. 133 */ 134 135 /*-------------------------------------------------------------------------*/ 136 static struct eth_dev l_ethdev; 137 static struct eth_device l_netdev; 138 static struct usb_gadget_driver eth_driver; 139 140 /*-------------------------------------------------------------------------*/ 141 142 /* "main" config is either CDC, or its simple subset */ 143 static inline int is_cdc(struct eth_dev *dev) 144 { 145 #if !defined(CONFIG_USB_ETH_SUBSET) 146 return 1; /* only cdc possible */ 147 #elif !defined(CONFIG_USB_ETH_CDC) 148 return 0; /* only subset possible */ 149 #else 150 return dev->cdc; /* depends on what hardware we found */ 151 #endif 152 } 153 154 /* "secondary" RNDIS config may sometimes be activated */ 155 static inline int rndis_active(struct eth_dev *dev) 156 { 157 #ifdef CONFIG_USB_ETH_RNDIS 158 return dev->rndis; 159 #else 160 return 0; 161 #endif 162 } 163 164 #define subset_active(dev) (!is_cdc(dev) && !rndis_active(dev)) 165 #define cdc_active(dev) (is_cdc(dev) && !rndis_active(dev)) 166 167 #define DEFAULT_QLEN 2 /* double buffering by default */ 168 169 /* peak bulk transfer bits-per-second */ 170 #define HS_BPS (13 * 512 * 8 * 1000 * 8) 171 #define FS_BPS (19 * 64 * 1 * 1000 * 8) 172 173 #ifdef CONFIG_USB_GADGET_DUALSPEED 174 #define DEVSPEED USB_SPEED_HIGH 175 176 #ifdef CONFIG_USB_ETH_QMULT 177 #define qmult CONFIG_USB_ETH_QMULT 178 #else 179 #define qmult 5 180 #endif 181 182 /* for dual-speed hardware, use deeper queues at highspeed */ 183 #define qlen(gadget) \ 184 (DEFAULT_QLEN*((gadget->speed == USB_SPEED_HIGH) ? qmult : 1)) 185 186 static inline int BITRATE(struct usb_gadget *g) 187 { 188 return (g->speed == USB_SPEED_HIGH) ? HS_BPS : FS_BPS; 189 } 190 191 #else /* full speed (low speed doesn't do bulk) */ 192 193 #define qmult 1 194 195 #define DEVSPEED USB_SPEED_FULL 196 197 #define qlen(gadget) DEFAULT_QLEN 198 199 static inline int BITRATE(struct usb_gadget *g) 200 { 201 return FS_BPS; 202 } 203 #endif 204 205 /*-------------------------------------------------------------------------*/ 206 207 /* 208 * DO NOT REUSE THESE IDs with a protocol-incompatible driver!! Ever!! 209 * Instead: allocate your own, using normal USB-IF procedures. 210 */ 211 212 /* 213 * Thanks to NetChip Technologies for donating this product ID. 214 * It's for devices with only CDC Ethernet configurations. 215 */ 216 #define CDC_VENDOR_NUM 0x0525 /* NetChip */ 217 #define CDC_PRODUCT_NUM 0xa4a1 /* Linux-USB Ethernet Gadget */ 218 219 /* 220 * For hardware that can't talk CDC, we use the same vendor ID that 221 * ARM Linux has used for ethernet-over-usb, both with sa1100 and 222 * with pxa250. We're protocol-compatible, if the host-side drivers 223 * use the endpoint descriptors. bcdDevice (version) is nonzero, so 224 * drivers that need to hard-wire endpoint numbers have a hook. 225 * 226 * The protocol is a minimal subset of CDC Ether, which works on any bulk 227 * hardware that's not deeply broken ... even on hardware that can't talk 228 * RNDIS (like SA-1100, with no interrupt endpoint, or anything that 229 * doesn't handle control-OUT). 230 */ 231 #define SIMPLE_VENDOR_NUM 0x049f /* Compaq Computer Corp. */ 232 #define SIMPLE_PRODUCT_NUM 0x505a /* Linux-USB "CDC Subset" Device */ 233 234 /* 235 * For hardware that can talk RNDIS and either of the above protocols, 236 * use this ID ... the windows INF files will know it. Unless it's 237 * used with CDC Ethernet, Linux 2.4 hosts will need updates to choose 238 * the non-RNDIS configuration. 239 */ 240 #define RNDIS_VENDOR_NUM 0x0525 /* NetChip */ 241 #define RNDIS_PRODUCT_NUM 0xa4a2 /* Ethernet/RNDIS Gadget */ 242 243 /* 244 * Some systems will want different product identifers published in the 245 * device descriptor, either numbers or strings or both. These string 246 * parameters are in UTF-8 (superset of ASCII's 7 bit characters). 247 */ 248 249 /* 250 * Emulating them in eth_bind: 251 * static ushort idVendor; 252 * static ushort idProduct; 253 */ 254 255 #if defined(CONFIG_USBNET_MANUFACTURER) 256 static char *iManufacturer = CONFIG_USBNET_MANUFACTURER; 257 #else 258 static char *iManufacturer = "U-boot"; 259 #endif 260 261 /* These probably need to be configurable. */ 262 static ushort bcdDevice; 263 static char *iProduct; 264 static char *iSerialNumber; 265 266 static char dev_addr[18]; 267 268 static char host_addr[18]; 269 270 271 /*-------------------------------------------------------------------------*/ 272 273 /* 274 * USB DRIVER HOOKUP (to the hardware driver, below us), mostly 275 * ep0 implementation: descriptors, config management, setup(). 276 * also optional class-specific notification interrupt transfer. 277 */ 278 279 /* 280 * DESCRIPTORS ... most are static, but strings and (full) configuration 281 * descriptors are built on demand. For now we do either full CDC, or 282 * our simple subset, with RNDIS as an optional second configuration. 283 * 284 * RNDIS includes some CDC ACM descriptors ... like CDC Ethernet. But 285 * the class descriptors match a modem (they're ignored; it's really just 286 * Ethernet functionality), they don't need the NOP altsetting, and the 287 * status transfer endpoint isn't optional. 288 */ 289 290 #define STRING_MANUFACTURER 1 291 #define STRING_PRODUCT 2 292 #define STRING_ETHADDR 3 293 #define STRING_DATA 4 294 #define STRING_CONTROL 5 295 #define STRING_RNDIS_CONTROL 6 296 #define STRING_CDC 7 297 #define STRING_SUBSET 8 298 #define STRING_RNDIS 9 299 #define STRING_SERIALNUMBER 10 300 301 /* holds our biggest descriptor (or RNDIS response) */ 302 #define USB_BUFSIZ 256 303 304 /* 305 * This device advertises one configuration, eth_config, unless RNDIS 306 * is enabled (rndis_config) on hardware supporting at least two configs. 307 * 308 * NOTE: Controllers like superh_udc should probably be able to use 309 * an RNDIS-only configuration. 310 * 311 * FIXME define some higher-powered configurations to make it easier 312 * to recharge batteries ... 313 */ 314 315 #define DEV_CONFIG_VALUE 1 /* cdc or subset */ 316 #define DEV_RNDIS_CONFIG_VALUE 2 /* rndis; optional */ 317 318 static struct usb_device_descriptor 319 device_desc = { 320 .bLength = sizeof device_desc, 321 .bDescriptorType = USB_DT_DEVICE, 322 323 .bcdUSB = __constant_cpu_to_le16(0x0200), 324 325 .bDeviceClass = USB_CLASS_COMM, 326 .bDeviceSubClass = 0, 327 .bDeviceProtocol = 0, 328 329 .idVendor = __constant_cpu_to_le16(CDC_VENDOR_NUM), 330 .idProduct = __constant_cpu_to_le16(CDC_PRODUCT_NUM), 331 .iManufacturer = STRING_MANUFACTURER, 332 .iProduct = STRING_PRODUCT, 333 .bNumConfigurations = 1, 334 }; 335 336 static struct usb_otg_descriptor 337 otg_descriptor = { 338 .bLength = sizeof otg_descriptor, 339 .bDescriptorType = USB_DT_OTG, 340 341 .bmAttributes = USB_OTG_SRP, 342 }; 343 344 static struct usb_config_descriptor 345 eth_config = { 346 .bLength = sizeof eth_config, 347 .bDescriptorType = USB_DT_CONFIG, 348 349 /* compute wTotalLength on the fly */ 350 .bNumInterfaces = 2, 351 .bConfigurationValue = DEV_CONFIG_VALUE, 352 .iConfiguration = STRING_CDC, 353 .bmAttributes = USB_CONFIG_ATT_ONE | USB_CONFIG_ATT_SELFPOWER, 354 .bMaxPower = 1, 355 }; 356 357 #ifdef CONFIG_USB_ETH_RNDIS 358 static struct usb_config_descriptor 359 rndis_config = { 360 .bLength = sizeof rndis_config, 361 .bDescriptorType = USB_DT_CONFIG, 362 363 /* compute wTotalLength on the fly */ 364 .bNumInterfaces = 2, 365 .bConfigurationValue = DEV_RNDIS_CONFIG_VALUE, 366 .iConfiguration = STRING_RNDIS, 367 .bmAttributes = USB_CONFIG_ATT_ONE | USB_CONFIG_ATT_SELFPOWER, 368 .bMaxPower = 1, 369 }; 370 #endif 371 372 /* 373 * Compared to the simple CDC subset, the full CDC Ethernet model adds 374 * three class descriptors, two interface descriptors, optional status 375 * endpoint. Both have a "data" interface and two bulk endpoints. 376 * There are also differences in how control requests are handled. 377 * 378 * RNDIS shares a lot with CDC-Ethernet, since it's a variant of the 379 * CDC-ACM (modem) spec. Unfortunately MSFT's RNDIS driver is buggy; it 380 * may hang or oops. Since bugfixes (or accurate specs, letting Linux 381 * work around those bugs) are unlikely to ever come from MSFT, you may 382 * wish to avoid using RNDIS. 383 * 384 * MCCI offers an alternative to RNDIS if you need to connect to Windows 385 * but have hardware that can't support CDC Ethernet. We add descriptors 386 * to present the CDC Subset as a (nonconformant) CDC MDLM variant called 387 * "SAFE". That borrows from both CDC Ethernet and CDC MDLM. You can 388 * get those drivers from MCCI, or bundled with various products. 389 */ 390 391 #ifdef CONFIG_USB_ETH_CDC 392 static struct usb_interface_descriptor 393 control_intf = { 394 .bLength = sizeof control_intf, 395 .bDescriptorType = USB_DT_INTERFACE, 396 397 .bInterfaceNumber = 0, 398 /* status endpoint is optional; this may be patched later */ 399 .bNumEndpoints = 1, 400 .bInterfaceClass = USB_CLASS_COMM, 401 .bInterfaceSubClass = USB_CDC_SUBCLASS_ETHERNET, 402 .bInterfaceProtocol = USB_CDC_PROTO_NONE, 403 .iInterface = STRING_CONTROL, 404 }; 405 #endif 406 407 #ifdef CONFIG_USB_ETH_RNDIS 408 static const struct usb_interface_descriptor 409 rndis_control_intf = { 410 .bLength = sizeof rndis_control_intf, 411 .bDescriptorType = USB_DT_INTERFACE, 412 413 .bInterfaceNumber = 0, 414 .bNumEndpoints = 1, 415 .bInterfaceClass = USB_CLASS_COMM, 416 .bInterfaceSubClass = USB_CDC_SUBCLASS_ACM, 417 .bInterfaceProtocol = USB_CDC_ACM_PROTO_VENDOR, 418 .iInterface = STRING_RNDIS_CONTROL, 419 }; 420 #endif 421 422 static const struct usb_cdc_header_desc header_desc = { 423 .bLength = sizeof header_desc, 424 .bDescriptorType = USB_DT_CS_INTERFACE, 425 .bDescriptorSubType = USB_CDC_HEADER_TYPE, 426 427 .bcdCDC = __constant_cpu_to_le16(0x0110), 428 }; 429 430 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 431 432 static const struct usb_cdc_union_desc union_desc = { 433 .bLength = sizeof union_desc, 434 .bDescriptorType = USB_DT_CS_INTERFACE, 435 .bDescriptorSubType = USB_CDC_UNION_TYPE, 436 437 .bMasterInterface0 = 0, /* index of control interface */ 438 .bSlaveInterface0 = 1, /* index of DATA interface */ 439 }; 440 441 #endif /* CDC || RNDIS */ 442 443 #ifdef CONFIG_USB_ETH_RNDIS 444 445 static const struct usb_cdc_call_mgmt_descriptor call_mgmt_descriptor = { 446 .bLength = sizeof call_mgmt_descriptor, 447 .bDescriptorType = USB_DT_CS_INTERFACE, 448 .bDescriptorSubType = USB_CDC_CALL_MANAGEMENT_TYPE, 449 450 .bmCapabilities = 0x00, 451 .bDataInterface = 0x01, 452 }; 453 454 static const struct usb_cdc_acm_descriptor acm_descriptor = { 455 .bLength = sizeof acm_descriptor, 456 .bDescriptorType = USB_DT_CS_INTERFACE, 457 .bDescriptorSubType = USB_CDC_ACM_TYPE, 458 459 .bmCapabilities = 0x00, 460 }; 461 462 #endif 463 464 #ifndef CONFIG_USB_ETH_CDC 465 466 /* 467 * "SAFE" loosely follows CDC WMC MDLM, violating the spec in various 468 * ways: data endpoints live in the control interface, there's no data 469 * interface, and it's not used to talk to a cell phone radio. 470 */ 471 472 static const struct usb_cdc_mdlm_desc mdlm_desc = { 473 .bLength = sizeof mdlm_desc, 474 .bDescriptorType = USB_DT_CS_INTERFACE, 475 .bDescriptorSubType = USB_CDC_MDLM_TYPE, 476 477 .bcdVersion = __constant_cpu_to_le16(0x0100), 478 .bGUID = { 479 0x5d, 0x34, 0xcf, 0x66, 0x11, 0x18, 0x11, 0xd6, 480 0xa2, 0x1a, 0x00, 0x01, 0x02, 0xca, 0x9a, 0x7f, 481 }, 482 }; 483 484 /* 485 * since "usb_cdc_mdlm_detail_desc" is a variable length structure, we 486 * can't really use its struct. All we do here is say that we're using 487 * the submode of "SAFE" which directly matches the CDC Subset. 488 */ 489 static const u8 mdlm_detail_desc[] = { 490 6, 491 USB_DT_CS_INTERFACE, 492 USB_CDC_MDLM_DETAIL_TYPE, 493 494 0, /* "SAFE" */ 495 0, /* network control capabilities (none) */ 496 0, /* network data capabilities ("raw" encapsulation) */ 497 }; 498 499 #endif 500 501 static const struct usb_cdc_ether_desc ether_desc = { 502 .bLength = sizeof(ether_desc), 503 .bDescriptorType = USB_DT_CS_INTERFACE, 504 .bDescriptorSubType = USB_CDC_ETHERNET_TYPE, 505 506 /* this descriptor actually adds value, surprise! */ 507 .iMACAddress = STRING_ETHADDR, 508 .bmEthernetStatistics = __constant_cpu_to_le32(0), /* no statistics */ 509 .wMaxSegmentSize = __constant_cpu_to_le16(ETH_FRAME_LEN), 510 .wNumberMCFilters = __constant_cpu_to_le16(0), 511 .bNumberPowerFilters = 0, 512 }; 513 514 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 515 516 /* 517 * include the status endpoint if we can, even where it's optional. 518 * use wMaxPacketSize big enough to fit CDC_NOTIFY_SPEED_CHANGE in one 519 * packet, to simplify cancellation; and a big transfer interval, to 520 * waste less bandwidth. 521 * 522 * some drivers (like Linux 2.4 cdc-ether!) "need" it to exist even 523 * if they ignore the connect/disconnect notifications that real aether 524 * can provide. more advanced cdc configurations might want to support 525 * encapsulated commands (vendor-specific, using control-OUT). 526 * 527 * RNDIS requires the status endpoint, since it uses that encapsulation 528 * mechanism for its funky RPC scheme. 529 */ 530 531 #define LOG2_STATUS_INTERVAL_MSEC 5 /* 1 << 5 == 32 msec */ 532 #define STATUS_BYTECOUNT 16 /* 8 byte header + data */ 533 534 static struct usb_endpoint_descriptor 535 fs_status_desc = { 536 .bLength = USB_DT_ENDPOINT_SIZE, 537 .bDescriptorType = USB_DT_ENDPOINT, 538 539 .bEndpointAddress = USB_DIR_IN, 540 .bmAttributes = USB_ENDPOINT_XFER_INT, 541 .wMaxPacketSize = __constant_cpu_to_le16(STATUS_BYTECOUNT), 542 .bInterval = 1 << LOG2_STATUS_INTERVAL_MSEC, 543 }; 544 #endif 545 546 #ifdef CONFIG_USB_ETH_CDC 547 548 /* the default data interface has no endpoints ... */ 549 550 static const struct usb_interface_descriptor 551 data_nop_intf = { 552 .bLength = sizeof data_nop_intf, 553 .bDescriptorType = USB_DT_INTERFACE, 554 555 .bInterfaceNumber = 1, 556 .bAlternateSetting = 0, 557 .bNumEndpoints = 0, 558 .bInterfaceClass = USB_CLASS_CDC_DATA, 559 .bInterfaceSubClass = 0, 560 .bInterfaceProtocol = 0, 561 }; 562 563 /* ... but the "real" data interface has two bulk endpoints */ 564 565 static const struct usb_interface_descriptor 566 data_intf = { 567 .bLength = sizeof data_intf, 568 .bDescriptorType = USB_DT_INTERFACE, 569 570 .bInterfaceNumber = 1, 571 .bAlternateSetting = 1, 572 .bNumEndpoints = 2, 573 .bInterfaceClass = USB_CLASS_CDC_DATA, 574 .bInterfaceSubClass = 0, 575 .bInterfaceProtocol = 0, 576 .iInterface = STRING_DATA, 577 }; 578 579 #endif 580 581 #ifdef CONFIG_USB_ETH_RNDIS 582 583 /* RNDIS doesn't activate by changing to the "real" altsetting */ 584 585 static const struct usb_interface_descriptor 586 rndis_data_intf = { 587 .bLength = sizeof rndis_data_intf, 588 .bDescriptorType = USB_DT_INTERFACE, 589 590 .bInterfaceNumber = 1, 591 .bAlternateSetting = 0, 592 .bNumEndpoints = 2, 593 .bInterfaceClass = USB_CLASS_CDC_DATA, 594 .bInterfaceSubClass = 0, 595 .bInterfaceProtocol = 0, 596 .iInterface = STRING_DATA, 597 }; 598 599 #endif 600 601 #ifdef CONFIG_USB_ETH_SUBSET 602 603 /* 604 * "Simple" CDC-subset option is a simple vendor-neutral model that most 605 * full speed controllers can handle: one interface, two bulk endpoints. 606 * 607 * To assist host side drivers, we fancy it up a bit, and add descriptors 608 * so some host side drivers will understand it as a "SAFE" variant. 609 */ 610 611 static const struct usb_interface_descriptor 612 subset_data_intf = { 613 .bLength = sizeof subset_data_intf, 614 .bDescriptorType = USB_DT_INTERFACE, 615 616 .bInterfaceNumber = 0, 617 .bAlternateSetting = 0, 618 .bNumEndpoints = 2, 619 .bInterfaceClass = USB_CLASS_COMM, 620 .bInterfaceSubClass = USB_CDC_SUBCLASS_MDLM, 621 .bInterfaceProtocol = 0, 622 .iInterface = STRING_DATA, 623 }; 624 625 #endif /* SUBSET */ 626 627 static struct usb_endpoint_descriptor 628 fs_source_desc = { 629 .bLength = USB_DT_ENDPOINT_SIZE, 630 .bDescriptorType = USB_DT_ENDPOINT, 631 632 .bEndpointAddress = USB_DIR_IN, 633 .bmAttributes = USB_ENDPOINT_XFER_BULK, 634 .wMaxPacketSize = __constant_cpu_to_le16(64), 635 }; 636 637 static struct usb_endpoint_descriptor 638 fs_sink_desc = { 639 .bLength = USB_DT_ENDPOINT_SIZE, 640 .bDescriptorType = USB_DT_ENDPOINT, 641 642 .bEndpointAddress = USB_DIR_OUT, 643 .bmAttributes = USB_ENDPOINT_XFER_BULK, 644 .wMaxPacketSize = __constant_cpu_to_le16(64), 645 }; 646 647 static const struct usb_descriptor_header *fs_eth_function[11] = { 648 (struct usb_descriptor_header *) &otg_descriptor, 649 #ifdef CONFIG_USB_ETH_CDC 650 /* "cdc" mode descriptors */ 651 (struct usb_descriptor_header *) &control_intf, 652 (struct usb_descriptor_header *) &header_desc, 653 (struct usb_descriptor_header *) &union_desc, 654 (struct usb_descriptor_header *) ðer_desc, 655 /* NOTE: status endpoint may need to be removed */ 656 (struct usb_descriptor_header *) &fs_status_desc, 657 /* data interface, with altsetting */ 658 (struct usb_descriptor_header *) &data_nop_intf, 659 (struct usb_descriptor_header *) &data_intf, 660 (struct usb_descriptor_header *) &fs_source_desc, 661 (struct usb_descriptor_header *) &fs_sink_desc, 662 NULL, 663 #endif /* CONFIG_USB_ETH_CDC */ 664 }; 665 666 static inline void fs_subset_descriptors(void) 667 { 668 #ifdef CONFIG_USB_ETH_SUBSET 669 /* behavior is "CDC Subset"; extra descriptors say "SAFE" */ 670 fs_eth_function[1] = (struct usb_descriptor_header *) &subset_data_intf; 671 fs_eth_function[2] = (struct usb_descriptor_header *) &header_desc; 672 fs_eth_function[3] = (struct usb_descriptor_header *) &mdlm_desc; 673 fs_eth_function[4] = (struct usb_descriptor_header *) &mdlm_detail_desc; 674 fs_eth_function[5] = (struct usb_descriptor_header *) ðer_desc; 675 fs_eth_function[6] = (struct usb_descriptor_header *) &fs_source_desc; 676 fs_eth_function[7] = (struct usb_descriptor_header *) &fs_sink_desc; 677 fs_eth_function[8] = NULL; 678 #else 679 fs_eth_function[1] = NULL; 680 #endif 681 } 682 683 #ifdef CONFIG_USB_ETH_RNDIS 684 static const struct usb_descriptor_header *fs_rndis_function[] = { 685 (struct usb_descriptor_header *) &otg_descriptor, 686 /* control interface matches ACM, not Ethernet */ 687 (struct usb_descriptor_header *) &rndis_control_intf, 688 (struct usb_descriptor_header *) &header_desc, 689 (struct usb_descriptor_header *) &call_mgmt_descriptor, 690 (struct usb_descriptor_header *) &acm_descriptor, 691 (struct usb_descriptor_header *) &union_desc, 692 (struct usb_descriptor_header *) &fs_status_desc, 693 /* data interface has no altsetting */ 694 (struct usb_descriptor_header *) &rndis_data_intf, 695 (struct usb_descriptor_header *) &fs_source_desc, 696 (struct usb_descriptor_header *) &fs_sink_desc, 697 NULL, 698 }; 699 #endif 700 701 /* 702 * usb 2.0 devices need to expose both high speed and full speed 703 * descriptors, unless they only run at full speed. 704 */ 705 706 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 707 static struct usb_endpoint_descriptor 708 hs_status_desc = { 709 .bLength = USB_DT_ENDPOINT_SIZE, 710 .bDescriptorType = USB_DT_ENDPOINT, 711 712 .bmAttributes = USB_ENDPOINT_XFER_INT, 713 .wMaxPacketSize = __constant_cpu_to_le16(STATUS_BYTECOUNT), 714 .bInterval = LOG2_STATUS_INTERVAL_MSEC + 4, 715 }; 716 #endif /* CONFIG_USB_ETH_CDC */ 717 718 static struct usb_endpoint_descriptor 719 hs_source_desc = { 720 .bLength = USB_DT_ENDPOINT_SIZE, 721 .bDescriptorType = USB_DT_ENDPOINT, 722 723 .bmAttributes = USB_ENDPOINT_XFER_BULK, 724 .wMaxPacketSize = __constant_cpu_to_le16(512), 725 }; 726 727 static struct usb_endpoint_descriptor 728 hs_sink_desc = { 729 .bLength = USB_DT_ENDPOINT_SIZE, 730 .bDescriptorType = USB_DT_ENDPOINT, 731 732 .bmAttributes = USB_ENDPOINT_XFER_BULK, 733 .wMaxPacketSize = __constant_cpu_to_le16(512), 734 }; 735 736 static struct usb_qualifier_descriptor 737 dev_qualifier = { 738 .bLength = sizeof dev_qualifier, 739 .bDescriptorType = USB_DT_DEVICE_QUALIFIER, 740 741 .bcdUSB = __constant_cpu_to_le16(0x0200), 742 .bDeviceClass = USB_CLASS_COMM, 743 744 .bNumConfigurations = 1, 745 }; 746 747 static const struct usb_descriptor_header *hs_eth_function[11] = { 748 (struct usb_descriptor_header *) &otg_descriptor, 749 #ifdef CONFIG_USB_ETH_CDC 750 /* "cdc" mode descriptors */ 751 (struct usb_descriptor_header *) &control_intf, 752 (struct usb_descriptor_header *) &header_desc, 753 (struct usb_descriptor_header *) &union_desc, 754 (struct usb_descriptor_header *) ðer_desc, 755 /* NOTE: status endpoint may need to be removed */ 756 (struct usb_descriptor_header *) &hs_status_desc, 757 /* data interface, with altsetting */ 758 (struct usb_descriptor_header *) &data_nop_intf, 759 (struct usb_descriptor_header *) &data_intf, 760 (struct usb_descriptor_header *) &hs_source_desc, 761 (struct usb_descriptor_header *) &hs_sink_desc, 762 NULL, 763 #endif /* CONFIG_USB_ETH_CDC */ 764 }; 765 766 static inline void hs_subset_descriptors(void) 767 { 768 #ifdef CONFIG_USB_ETH_SUBSET 769 /* behavior is "CDC Subset"; extra descriptors say "SAFE" */ 770 hs_eth_function[1] = (struct usb_descriptor_header *) &subset_data_intf; 771 hs_eth_function[2] = (struct usb_descriptor_header *) &header_desc; 772 hs_eth_function[3] = (struct usb_descriptor_header *) &mdlm_desc; 773 hs_eth_function[4] = (struct usb_descriptor_header *) &mdlm_detail_desc; 774 hs_eth_function[5] = (struct usb_descriptor_header *) ðer_desc; 775 hs_eth_function[6] = (struct usb_descriptor_header *) &hs_source_desc; 776 hs_eth_function[7] = (struct usb_descriptor_header *) &hs_sink_desc; 777 hs_eth_function[8] = NULL; 778 #else 779 hs_eth_function[1] = NULL; 780 #endif 781 } 782 783 #ifdef CONFIG_USB_ETH_RNDIS 784 static const struct usb_descriptor_header *hs_rndis_function[] = { 785 (struct usb_descriptor_header *) &otg_descriptor, 786 /* control interface matches ACM, not Ethernet */ 787 (struct usb_descriptor_header *) &rndis_control_intf, 788 (struct usb_descriptor_header *) &header_desc, 789 (struct usb_descriptor_header *) &call_mgmt_descriptor, 790 (struct usb_descriptor_header *) &acm_descriptor, 791 (struct usb_descriptor_header *) &union_desc, 792 (struct usb_descriptor_header *) &hs_status_desc, 793 /* data interface has no altsetting */ 794 (struct usb_descriptor_header *) &rndis_data_intf, 795 (struct usb_descriptor_header *) &hs_source_desc, 796 (struct usb_descriptor_header *) &hs_sink_desc, 797 NULL, 798 }; 799 #endif 800 801 802 /* maxpacket and other transfer characteristics vary by speed. */ 803 static inline struct usb_endpoint_descriptor * 804 ep_desc(struct usb_gadget *g, struct usb_endpoint_descriptor *hs, 805 struct usb_endpoint_descriptor *fs) 806 { 807 if (gadget_is_dualspeed(g) && g->speed == USB_SPEED_HIGH) 808 return hs; 809 return fs; 810 } 811 812 /*-------------------------------------------------------------------------*/ 813 814 /* descriptors that are built on-demand */ 815 816 static char manufacturer[50]; 817 static char product_desc[40] = DRIVER_DESC; 818 static char serial_number[20]; 819 820 /* address that the host will use ... usually assigned at random */ 821 static char ethaddr[2 * ETH_ALEN + 1]; 822 823 /* static strings, in UTF-8 */ 824 static struct usb_string strings[] = { 825 { STRING_MANUFACTURER, manufacturer, }, 826 { STRING_PRODUCT, product_desc, }, 827 { STRING_SERIALNUMBER, serial_number, }, 828 { STRING_DATA, "Ethernet Data", }, 829 { STRING_ETHADDR, ethaddr, }, 830 #ifdef CONFIG_USB_ETH_CDC 831 { STRING_CDC, "CDC Ethernet", }, 832 { STRING_CONTROL, "CDC Communications Control", }, 833 #endif 834 #ifdef CONFIG_USB_ETH_SUBSET 835 { STRING_SUBSET, "CDC Ethernet Subset", }, 836 #endif 837 #ifdef CONFIG_USB_ETH_RNDIS 838 { STRING_RNDIS, "RNDIS", }, 839 { STRING_RNDIS_CONTROL, "RNDIS Communications Control", }, 840 #endif 841 { } /* end of list */ 842 }; 843 844 static struct usb_gadget_strings stringtab = { 845 .language = 0x0409, /* en-us */ 846 .strings = strings, 847 }; 848 849 /*============================================================================*/ 850 DEFINE_CACHE_ALIGN_BUFFER(u8, control_req, USB_BUFSIZ); 851 852 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 853 DEFINE_CACHE_ALIGN_BUFFER(u8, status_req, STATUS_BYTECOUNT); 854 #endif 855 856 /*============================================================================*/ 857 858 /* 859 * one config, two interfaces: control, data. 860 * complications: class descriptors, and an altsetting. 861 */ 862 static int 863 config_buf(struct usb_gadget *g, u8 *buf, u8 type, unsigned index, int is_otg) 864 { 865 int len; 866 const struct usb_config_descriptor *config; 867 const struct usb_descriptor_header **function; 868 int hs = 0; 869 870 if (gadget_is_dualspeed(g)) { 871 hs = (g->speed == USB_SPEED_HIGH); 872 if (type == USB_DT_OTHER_SPEED_CONFIG) 873 hs = !hs; 874 } 875 #define which_fn(t) (hs ? hs_ ## t ## _function : fs_ ## t ## _function) 876 877 if (index >= device_desc.bNumConfigurations) 878 return -EINVAL; 879 880 #ifdef CONFIG_USB_ETH_RNDIS 881 /* 882 * list the RNDIS config first, to make Microsoft's drivers 883 * happy. DOCSIS 1.0 needs this too. 884 */ 885 if (device_desc.bNumConfigurations == 2 && index == 0) { 886 config = &rndis_config; 887 function = which_fn(rndis); 888 } else 889 #endif 890 { 891 config = ð_config; 892 function = which_fn(eth); 893 } 894 895 /* for now, don't advertise srp-only devices */ 896 if (!is_otg) 897 function++; 898 899 len = usb_gadget_config_buf(config, buf, USB_BUFSIZ, function); 900 if (len < 0) 901 return len; 902 ((struct usb_config_descriptor *) buf)->bDescriptorType = type; 903 return len; 904 } 905 906 /*-------------------------------------------------------------------------*/ 907 908 static void eth_start(struct eth_dev *dev, gfp_t gfp_flags); 909 static int alloc_requests(struct eth_dev *dev, unsigned n, gfp_t gfp_flags); 910 911 static int 912 set_ether_config(struct eth_dev *dev, gfp_t gfp_flags) 913 { 914 int result = 0; 915 struct usb_gadget *gadget = dev->gadget; 916 917 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 918 /* status endpoint used for RNDIS and (optionally) CDC */ 919 if (!subset_active(dev) && dev->status_ep) { 920 dev->status = ep_desc(gadget, &hs_status_desc, 921 &fs_status_desc); 922 dev->status_ep->driver_data = dev; 923 924 result = usb_ep_enable(dev->status_ep, dev->status); 925 if (result != 0) { 926 debug("enable %s --> %d\n", 927 dev->status_ep->name, result); 928 goto done; 929 } 930 } 931 #endif 932 933 dev->in = ep_desc(gadget, &hs_source_desc, &fs_source_desc); 934 dev->in_ep->driver_data = dev; 935 936 dev->out = ep_desc(gadget, &hs_sink_desc, &fs_sink_desc); 937 dev->out_ep->driver_data = dev; 938 939 /* 940 * With CDC, the host isn't allowed to use these two data 941 * endpoints in the default altsetting for the interface. 942 * so we don't activate them yet. Reset from SET_INTERFACE. 943 * 944 * Strictly speaking RNDIS should work the same: activation is 945 * a side effect of setting a packet filter. Deactivation is 946 * from REMOTE_NDIS_HALT_MSG, reset from REMOTE_NDIS_RESET_MSG. 947 */ 948 if (!cdc_active(dev)) { 949 result = usb_ep_enable(dev->in_ep, dev->in); 950 if (result != 0) { 951 debug("enable %s --> %d\n", 952 dev->in_ep->name, result); 953 goto done; 954 } 955 956 result = usb_ep_enable(dev->out_ep, dev->out); 957 if (result != 0) { 958 debug("enable %s --> %d\n", 959 dev->out_ep->name, result); 960 goto done; 961 } 962 } 963 964 done: 965 if (result == 0) 966 result = alloc_requests(dev, qlen(gadget), gfp_flags); 967 968 /* on error, disable any endpoints */ 969 if (result < 0) { 970 if (!subset_active(dev) && dev->status_ep) 971 (void) usb_ep_disable(dev->status_ep); 972 dev->status = NULL; 973 (void) usb_ep_disable(dev->in_ep); 974 (void) usb_ep_disable(dev->out_ep); 975 dev->in = NULL; 976 dev->out = NULL; 977 } else if (!cdc_active(dev)) { 978 /* 979 * activate non-CDC configs right away 980 * this isn't strictly according to the RNDIS spec 981 */ 982 eth_start(dev, GFP_ATOMIC); 983 } 984 985 /* caller is responsible for cleanup on error */ 986 return result; 987 } 988 989 static void eth_reset_config(struct eth_dev *dev) 990 { 991 if (dev->config == 0) 992 return; 993 994 debug("%s\n", __func__); 995 996 rndis_uninit(dev->rndis_config); 997 998 /* 999 * disable endpoints, forcing (synchronous) completion of 1000 * pending i/o. then free the requests. 1001 */ 1002 1003 if (dev->in) { 1004 usb_ep_disable(dev->in_ep); 1005 if (dev->tx_req) { 1006 usb_ep_free_request(dev->in_ep, dev->tx_req); 1007 dev->tx_req = NULL; 1008 } 1009 } 1010 if (dev->out) { 1011 usb_ep_disable(dev->out_ep); 1012 if (dev->rx_req) { 1013 usb_ep_free_request(dev->out_ep, dev->rx_req); 1014 dev->rx_req = NULL; 1015 } 1016 } 1017 if (dev->status) 1018 usb_ep_disable(dev->status_ep); 1019 1020 dev->rndis = 0; 1021 dev->cdc_filter = 0; 1022 dev->config = 0; 1023 } 1024 1025 /* 1026 * change our operational config. must agree with the code 1027 * that returns config descriptors, and altsetting code. 1028 */ 1029 static int eth_set_config(struct eth_dev *dev, unsigned number, 1030 gfp_t gfp_flags) 1031 { 1032 int result = 0; 1033 struct usb_gadget *gadget = dev->gadget; 1034 1035 if (gadget_is_sa1100(gadget) 1036 && dev->config 1037 && dev->tx_qlen != 0) { 1038 /* tx fifo is full, but we can't clear it...*/ 1039 error("can't change configurations"); 1040 return -ESPIPE; 1041 } 1042 eth_reset_config(dev); 1043 1044 switch (number) { 1045 case DEV_CONFIG_VALUE: 1046 result = set_ether_config(dev, gfp_flags); 1047 break; 1048 #ifdef CONFIG_USB_ETH_RNDIS 1049 case DEV_RNDIS_CONFIG_VALUE: 1050 dev->rndis = 1; 1051 result = set_ether_config(dev, gfp_flags); 1052 break; 1053 #endif 1054 default: 1055 result = -EINVAL; 1056 /* FALL THROUGH */ 1057 case 0: 1058 break; 1059 } 1060 1061 if (result) { 1062 if (number) 1063 eth_reset_config(dev); 1064 usb_gadget_vbus_draw(dev->gadget, 1065 gadget_is_otg(dev->gadget) ? 8 : 100); 1066 } else { 1067 char *speed; 1068 unsigned power; 1069 1070 power = 2 * eth_config.bMaxPower; 1071 usb_gadget_vbus_draw(dev->gadget, power); 1072 1073 switch (gadget->speed) { 1074 case USB_SPEED_FULL: 1075 speed = "full"; break; 1076 #ifdef CONFIG_USB_GADGET_DUALSPEED 1077 case USB_SPEED_HIGH: 1078 speed = "high"; break; 1079 #endif 1080 default: 1081 speed = "?"; break; 1082 } 1083 1084 dev->config = number; 1085 printf("%s speed config #%d: %d mA, %s, using %s\n", 1086 speed, number, power, driver_desc, 1087 rndis_active(dev) 1088 ? "RNDIS" 1089 : (cdc_active(dev) 1090 ? "CDC Ethernet" 1091 : "CDC Ethernet Subset")); 1092 } 1093 return result; 1094 } 1095 1096 /*-------------------------------------------------------------------------*/ 1097 1098 #ifdef CONFIG_USB_ETH_CDC 1099 1100 /* 1101 * The interrupt endpoint is used in CDC networking models (Ethernet, ATM) 1102 * only to notify the host about link status changes (which we support) or 1103 * report completion of some encapsulated command (as used in RNDIS). Since 1104 * we want this CDC Ethernet code to be vendor-neutral, we don't use that 1105 * command mechanism; and only one status request is ever queued. 1106 */ 1107 static void eth_status_complete(struct usb_ep *ep, struct usb_request *req) 1108 { 1109 struct usb_cdc_notification *event = req->buf; 1110 int value = req->status; 1111 struct eth_dev *dev = ep->driver_data; 1112 1113 /* issue the second notification if host reads the first */ 1114 if (event->bNotificationType == USB_CDC_NOTIFY_NETWORK_CONNECTION 1115 && value == 0) { 1116 __le32 *data = req->buf + sizeof *event; 1117 1118 event->bmRequestType = 0xA1; 1119 event->bNotificationType = USB_CDC_NOTIFY_SPEED_CHANGE; 1120 event->wValue = __constant_cpu_to_le16(0); 1121 event->wIndex = __constant_cpu_to_le16(1); 1122 event->wLength = __constant_cpu_to_le16(8); 1123 1124 /* SPEED_CHANGE data is up/down speeds in bits/sec */ 1125 data[0] = data[1] = cpu_to_le32(BITRATE(dev->gadget)); 1126 1127 req->length = STATUS_BYTECOUNT; 1128 value = usb_ep_queue(ep, req, GFP_ATOMIC); 1129 debug("send SPEED_CHANGE --> %d\n", value); 1130 if (value == 0) 1131 return; 1132 } else if (value != -ECONNRESET) { 1133 debug("event %02x --> %d\n", 1134 event->bNotificationType, value); 1135 if (event->bNotificationType == 1136 USB_CDC_NOTIFY_SPEED_CHANGE) { 1137 l_ethdev.network_started = 1; 1138 printf("USB network up!\n"); 1139 } 1140 } 1141 req->context = NULL; 1142 } 1143 1144 static void issue_start_status(struct eth_dev *dev) 1145 { 1146 struct usb_request *req = dev->stat_req; 1147 struct usb_cdc_notification *event; 1148 int value; 1149 1150 /* 1151 * flush old status 1152 * 1153 * FIXME ugly idiom, maybe we'd be better with just 1154 * a "cancel the whole queue" primitive since any 1155 * unlink-one primitive has way too many error modes. 1156 * here, we "know" toggle is already clear... 1157 * 1158 * FIXME iff req->context != null just dequeue it 1159 */ 1160 usb_ep_disable(dev->status_ep); 1161 usb_ep_enable(dev->status_ep, dev->status); 1162 1163 /* 1164 * 3.8.1 says to issue first NETWORK_CONNECTION, then 1165 * a SPEED_CHANGE. could be useful in some configs. 1166 */ 1167 event = req->buf; 1168 event->bmRequestType = 0xA1; 1169 event->bNotificationType = USB_CDC_NOTIFY_NETWORK_CONNECTION; 1170 event->wValue = __constant_cpu_to_le16(1); /* connected */ 1171 event->wIndex = __constant_cpu_to_le16(1); 1172 event->wLength = 0; 1173 1174 req->length = sizeof *event; 1175 req->complete = eth_status_complete; 1176 req->context = dev; 1177 1178 value = usb_ep_queue(dev->status_ep, req, GFP_ATOMIC); 1179 if (value < 0) 1180 debug("status buf queue --> %d\n", value); 1181 } 1182 1183 #endif 1184 1185 /*-------------------------------------------------------------------------*/ 1186 1187 static void eth_setup_complete(struct usb_ep *ep, struct usb_request *req) 1188 { 1189 if (req->status || req->actual != req->length) 1190 debug("setup complete --> %d, %d/%d\n", 1191 req->status, req->actual, req->length); 1192 } 1193 1194 #ifdef CONFIG_USB_ETH_RNDIS 1195 1196 static void rndis_response_complete(struct usb_ep *ep, struct usb_request *req) 1197 { 1198 if (req->status || req->actual != req->length) 1199 debug("rndis response complete --> %d, %d/%d\n", 1200 req->status, req->actual, req->length); 1201 1202 /* done sending after USB_CDC_GET_ENCAPSULATED_RESPONSE */ 1203 } 1204 1205 static void rndis_command_complete(struct usb_ep *ep, struct usb_request *req) 1206 { 1207 struct eth_dev *dev = ep->driver_data; 1208 int status; 1209 1210 /* received RNDIS command from USB_CDC_SEND_ENCAPSULATED_COMMAND */ 1211 status = rndis_msg_parser(dev->rndis_config, (u8 *) req->buf); 1212 if (status < 0) 1213 error("%s: rndis parse error %d", __func__, status); 1214 } 1215 1216 #endif /* RNDIS */ 1217 1218 /* 1219 * The setup() callback implements all the ep0 functionality that's not 1220 * handled lower down. CDC has a number of less-common features: 1221 * 1222 * - two interfaces: control, and ethernet data 1223 * - Ethernet data interface has two altsettings: default, and active 1224 * - class-specific descriptors for the control interface 1225 * - class-specific control requests 1226 */ 1227 static int 1228 eth_setup(struct usb_gadget *gadget, const struct usb_ctrlrequest *ctrl) 1229 { 1230 struct eth_dev *dev = get_gadget_data(gadget); 1231 struct usb_request *req = dev->req; 1232 int value = -EOPNOTSUPP; 1233 u16 wIndex = le16_to_cpu(ctrl->wIndex); 1234 u16 wValue = le16_to_cpu(ctrl->wValue); 1235 u16 wLength = le16_to_cpu(ctrl->wLength); 1236 1237 /* 1238 * descriptors just go into the pre-allocated ep0 buffer, 1239 * while config change events may enable network traffic. 1240 */ 1241 1242 debug("%s\n", __func__); 1243 1244 req->complete = eth_setup_complete; 1245 switch (ctrl->bRequest) { 1246 1247 case USB_REQ_GET_DESCRIPTOR: 1248 if (ctrl->bRequestType != USB_DIR_IN) 1249 break; 1250 switch (wValue >> 8) { 1251 1252 case USB_DT_DEVICE: 1253 device_desc.bMaxPacketSize0 = gadget->ep0->maxpacket; 1254 value = min(wLength, (u16) sizeof device_desc); 1255 memcpy(req->buf, &device_desc, value); 1256 break; 1257 case USB_DT_DEVICE_QUALIFIER: 1258 if (!gadget_is_dualspeed(gadget)) 1259 break; 1260 value = min(wLength, (u16) sizeof dev_qualifier); 1261 memcpy(req->buf, &dev_qualifier, value); 1262 break; 1263 1264 case USB_DT_OTHER_SPEED_CONFIG: 1265 if (!gadget_is_dualspeed(gadget)) 1266 break; 1267 /* FALLTHROUGH */ 1268 case USB_DT_CONFIG: 1269 value = config_buf(gadget, req->buf, 1270 wValue >> 8, 1271 wValue & 0xff, 1272 gadget_is_otg(gadget)); 1273 if (value >= 0) 1274 value = min(wLength, (u16) value); 1275 break; 1276 1277 case USB_DT_STRING: 1278 value = usb_gadget_get_string(&stringtab, 1279 wValue & 0xff, req->buf); 1280 1281 if (value >= 0) 1282 value = min(wLength, (u16) value); 1283 1284 break; 1285 } 1286 break; 1287 1288 case USB_REQ_SET_CONFIGURATION: 1289 if (ctrl->bRequestType != 0) 1290 break; 1291 if (gadget->a_hnp_support) 1292 debug("HNP available\n"); 1293 else if (gadget->a_alt_hnp_support) 1294 debug("HNP needs a different root port\n"); 1295 value = eth_set_config(dev, wValue, GFP_ATOMIC); 1296 break; 1297 case USB_REQ_GET_CONFIGURATION: 1298 if (ctrl->bRequestType != USB_DIR_IN) 1299 break; 1300 *(u8 *)req->buf = dev->config; 1301 value = min(wLength, (u16) 1); 1302 break; 1303 1304 case USB_REQ_SET_INTERFACE: 1305 if (ctrl->bRequestType != USB_RECIP_INTERFACE 1306 || !dev->config 1307 || wIndex > 1) 1308 break; 1309 if (!cdc_active(dev) && wIndex != 0) 1310 break; 1311 1312 /* 1313 * PXA hardware partially handles SET_INTERFACE; 1314 * we need to kluge around that interference. 1315 */ 1316 if (gadget_is_pxa(gadget)) { 1317 value = eth_set_config(dev, DEV_CONFIG_VALUE, 1318 GFP_ATOMIC); 1319 /* 1320 * PXA25x driver use non-CDC ethernet gadget. 1321 * But only _CDC and _RNDIS code can signalize 1322 * that network is working. So we signalize it 1323 * here. 1324 */ 1325 l_ethdev.network_started = 1; 1326 debug("USB network up!\n"); 1327 goto done_set_intf; 1328 } 1329 1330 #ifdef CONFIG_USB_ETH_CDC 1331 switch (wIndex) { 1332 case 0: /* control/master intf */ 1333 if (wValue != 0) 1334 break; 1335 if (dev->status) { 1336 usb_ep_disable(dev->status_ep); 1337 usb_ep_enable(dev->status_ep, dev->status); 1338 } 1339 1340 value = 0; 1341 break; 1342 case 1: /* data intf */ 1343 if (wValue > 1) 1344 break; 1345 usb_ep_disable(dev->in_ep); 1346 usb_ep_disable(dev->out_ep); 1347 1348 /* 1349 * CDC requires the data transfers not be done from 1350 * the default interface setting ... also, setting 1351 * the non-default interface resets filters etc. 1352 */ 1353 if (wValue == 1) { 1354 if (!cdc_active(dev)) 1355 break; 1356 usb_ep_enable(dev->in_ep, dev->in); 1357 usb_ep_enable(dev->out_ep, dev->out); 1358 dev->cdc_filter = DEFAULT_FILTER; 1359 if (dev->status) 1360 issue_start_status(dev); 1361 eth_start(dev, GFP_ATOMIC); 1362 } 1363 value = 0; 1364 break; 1365 } 1366 #else 1367 /* 1368 * FIXME this is wrong, as is the assumption that 1369 * all non-PXA hardware talks real CDC ... 1370 */ 1371 debug("set_interface ignored!\n"); 1372 #endif /* CONFIG_USB_ETH_CDC */ 1373 1374 done_set_intf: 1375 break; 1376 case USB_REQ_GET_INTERFACE: 1377 if (ctrl->bRequestType != (USB_DIR_IN|USB_RECIP_INTERFACE) 1378 || !dev->config 1379 || wIndex > 1) 1380 break; 1381 if (!(cdc_active(dev) || rndis_active(dev)) && wIndex != 0) 1382 break; 1383 1384 /* for CDC, iff carrier is on, data interface is active. */ 1385 if (rndis_active(dev) || wIndex != 1) 1386 *(u8 *)req->buf = 0; 1387 else { 1388 /* *(u8 *)req->buf = netif_carrier_ok (dev->net) ? 1 : 0; */ 1389 /* carrier always ok ...*/ 1390 *(u8 *)req->buf = 1 ; 1391 } 1392 value = min(wLength, (u16) 1); 1393 break; 1394 1395 #ifdef CONFIG_USB_ETH_CDC 1396 case USB_CDC_SET_ETHERNET_PACKET_FILTER: 1397 /* 1398 * see 6.2.30: no data, wIndex = interface, 1399 * wValue = packet filter bitmap 1400 */ 1401 if (ctrl->bRequestType != (USB_TYPE_CLASS|USB_RECIP_INTERFACE) 1402 || !cdc_active(dev) 1403 || wLength != 0 1404 || wIndex > 1) 1405 break; 1406 debug("packet filter %02x\n", wValue); 1407 dev->cdc_filter = wValue; 1408 value = 0; 1409 break; 1410 1411 /* 1412 * and potentially: 1413 * case USB_CDC_SET_ETHERNET_MULTICAST_FILTERS: 1414 * case USB_CDC_SET_ETHERNET_PM_PATTERN_FILTER: 1415 * case USB_CDC_GET_ETHERNET_PM_PATTERN_FILTER: 1416 * case USB_CDC_GET_ETHERNET_STATISTIC: 1417 */ 1418 1419 #endif /* CONFIG_USB_ETH_CDC */ 1420 1421 #ifdef CONFIG_USB_ETH_RNDIS 1422 /* 1423 * RNDIS uses the CDC command encapsulation mechanism to implement 1424 * an RPC scheme, with much getting/setting of attributes by OID. 1425 */ 1426 case USB_CDC_SEND_ENCAPSULATED_COMMAND: 1427 if (ctrl->bRequestType != (USB_TYPE_CLASS|USB_RECIP_INTERFACE) 1428 || !rndis_active(dev) 1429 || wLength > USB_BUFSIZ 1430 || wValue 1431 || rndis_control_intf.bInterfaceNumber 1432 != wIndex) 1433 break; 1434 /* read the request, then process it */ 1435 value = wLength; 1436 req->complete = rndis_command_complete; 1437 /* later, rndis_control_ack () sends a notification */ 1438 break; 1439 1440 case USB_CDC_GET_ENCAPSULATED_RESPONSE: 1441 if ((USB_DIR_IN|USB_TYPE_CLASS|USB_RECIP_INTERFACE) 1442 == ctrl->bRequestType 1443 && rndis_active(dev) 1444 /* && wLength >= 0x0400 */ 1445 && !wValue 1446 && rndis_control_intf.bInterfaceNumber 1447 == wIndex) { 1448 u8 *buf; 1449 u32 n; 1450 1451 /* return the result */ 1452 buf = rndis_get_next_response(dev->rndis_config, &n); 1453 if (buf) { 1454 memcpy(req->buf, buf, n); 1455 req->complete = rndis_response_complete; 1456 rndis_free_response(dev->rndis_config, buf); 1457 value = n; 1458 } 1459 /* else stalls ... spec says to avoid that */ 1460 } 1461 break; 1462 #endif /* RNDIS */ 1463 1464 default: 1465 debug("unknown control req%02x.%02x v%04x i%04x l%d\n", 1466 ctrl->bRequestType, ctrl->bRequest, 1467 wValue, wIndex, wLength); 1468 } 1469 1470 /* respond with data transfer before status phase? */ 1471 if (value >= 0) { 1472 debug("respond with data transfer before status phase\n"); 1473 req->length = value; 1474 req->zero = value < wLength 1475 && (value % gadget->ep0->maxpacket) == 0; 1476 value = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC); 1477 if (value < 0) { 1478 debug("ep_queue --> %d\n", value); 1479 req->status = 0; 1480 eth_setup_complete(gadget->ep0, req); 1481 } 1482 } 1483 1484 /* host either stalls (value < 0) or reports success */ 1485 return value; 1486 } 1487 1488 /*-------------------------------------------------------------------------*/ 1489 1490 static void rx_complete(struct usb_ep *ep, struct usb_request *req); 1491 1492 static int rx_submit(struct eth_dev *dev, struct usb_request *req, 1493 gfp_t gfp_flags) 1494 { 1495 int retval = -ENOMEM; 1496 size_t size; 1497 1498 /* 1499 * Padding up to RX_EXTRA handles minor disagreements with host. 1500 * Normally we use the USB "terminate on short read" convention; 1501 * so allow up to (N*maxpacket), since that memory is normally 1502 * already allocated. Some hardware doesn't deal well with short 1503 * reads (e.g. DMA must be N*maxpacket), so for now don't trim a 1504 * byte off the end (to force hardware errors on overflow). 1505 * 1506 * RNDIS uses internal framing, and explicitly allows senders to 1507 * pad to end-of-packet. That's potentially nice for speed, 1508 * but means receivers can't recover synch on their own. 1509 */ 1510 1511 debug("%s\n", __func__); 1512 if (!req) 1513 return -EINVAL; 1514 1515 size = (ETHER_HDR_SIZE + dev->mtu + RX_EXTRA); 1516 size += dev->out_ep->maxpacket - 1; 1517 if (rndis_active(dev)) 1518 size += sizeof(struct rndis_packet_msg_type); 1519 size -= size % dev->out_ep->maxpacket; 1520 1521 /* 1522 * Some platforms perform better when IP packets are aligned, 1523 * but on at least one, checksumming fails otherwise. Note: 1524 * RNDIS headers involve variable numbers of LE32 values. 1525 */ 1526 1527 req->buf = (u8 *)net_rx_packets[0]; 1528 req->length = size; 1529 req->complete = rx_complete; 1530 1531 retval = usb_ep_queue(dev->out_ep, req, gfp_flags); 1532 1533 if (retval) 1534 error("rx submit --> %d", retval); 1535 1536 return retval; 1537 } 1538 1539 static void rx_complete(struct usb_ep *ep, struct usb_request *req) 1540 { 1541 struct eth_dev *dev = ep->driver_data; 1542 1543 debug("%s: status %d\n", __func__, req->status); 1544 switch (req->status) { 1545 /* normal completion */ 1546 case 0: 1547 if (rndis_active(dev)) { 1548 /* we know MaxPacketsPerTransfer == 1 here */ 1549 int length = rndis_rm_hdr(req->buf, req->actual); 1550 if (length < 0) 1551 goto length_err; 1552 req->length -= length; 1553 req->actual -= length; 1554 } 1555 if (req->actual < ETH_HLEN || ETH_FRAME_LEN < req->actual) { 1556 length_err: 1557 dev->stats.rx_errors++; 1558 dev->stats.rx_length_errors++; 1559 debug("rx length %d\n", req->length); 1560 break; 1561 } 1562 1563 dev->stats.rx_packets++; 1564 dev->stats.rx_bytes += req->length; 1565 break; 1566 1567 /* software-driven interface shutdown */ 1568 case -ECONNRESET: /* unlink */ 1569 case -ESHUTDOWN: /* disconnect etc */ 1570 /* for hardware automagic (such as pxa) */ 1571 case -ECONNABORTED: /* endpoint reset */ 1572 break; 1573 1574 /* data overrun */ 1575 case -EOVERFLOW: 1576 dev->stats.rx_over_errors++; 1577 /* FALLTHROUGH */ 1578 default: 1579 dev->stats.rx_errors++; 1580 break; 1581 } 1582 1583 packet_received = 1; 1584 } 1585 1586 static int alloc_requests(struct eth_dev *dev, unsigned n, gfp_t gfp_flags) 1587 { 1588 1589 dev->tx_req = usb_ep_alloc_request(dev->in_ep, 0); 1590 1591 if (!dev->tx_req) 1592 goto fail1; 1593 1594 dev->rx_req = usb_ep_alloc_request(dev->out_ep, 0); 1595 1596 if (!dev->rx_req) 1597 goto fail2; 1598 1599 return 0; 1600 1601 fail2: 1602 usb_ep_free_request(dev->in_ep, dev->tx_req); 1603 fail1: 1604 error("can't alloc requests"); 1605 return -1; 1606 } 1607 1608 static void tx_complete(struct usb_ep *ep, struct usb_request *req) 1609 { 1610 struct eth_dev *dev = ep->driver_data; 1611 1612 debug("%s: status %s\n", __func__, (req->status) ? "failed" : "ok"); 1613 switch (req->status) { 1614 default: 1615 dev->stats.tx_errors++; 1616 debug("tx err %d\n", req->status); 1617 /* FALLTHROUGH */ 1618 case -ECONNRESET: /* unlink */ 1619 case -ESHUTDOWN: /* disconnect etc */ 1620 break; 1621 case 0: 1622 dev->stats.tx_bytes += req->length; 1623 } 1624 dev->stats.tx_packets++; 1625 1626 packet_sent = 1; 1627 } 1628 1629 static inline int eth_is_promisc(struct eth_dev *dev) 1630 { 1631 /* no filters for the CDC subset; always promisc */ 1632 if (subset_active(dev)) 1633 return 1; 1634 return dev->cdc_filter & USB_CDC_PACKET_TYPE_PROMISCUOUS; 1635 } 1636 1637 #if 0 1638 static int eth_start_xmit (struct sk_buff *skb, struct net_device *net) 1639 { 1640 struct eth_dev *dev = netdev_priv(net); 1641 int length = skb->len; 1642 int retval; 1643 struct usb_request *req = NULL; 1644 unsigned long flags; 1645 1646 /* apply outgoing CDC or RNDIS filters */ 1647 if (!eth_is_promisc (dev)) { 1648 u8 *dest = skb->data; 1649 1650 if (is_multicast_ethaddr(dest)) { 1651 u16 type; 1652 1653 /* ignores USB_CDC_PACKET_TYPE_MULTICAST and host 1654 * SET_ETHERNET_MULTICAST_FILTERS requests 1655 */ 1656 if (is_broadcast_ethaddr(dest)) 1657 type = USB_CDC_PACKET_TYPE_BROADCAST; 1658 else 1659 type = USB_CDC_PACKET_TYPE_ALL_MULTICAST; 1660 if (!(dev->cdc_filter & type)) { 1661 dev_kfree_skb_any (skb); 1662 return 0; 1663 } 1664 } 1665 /* ignores USB_CDC_PACKET_TYPE_DIRECTED */ 1666 } 1667 1668 spin_lock_irqsave(&dev->req_lock, flags); 1669 /* 1670 * this freelist can be empty if an interrupt triggered disconnect() 1671 * and reconfigured the gadget (shutting down this queue) after the 1672 * network stack decided to xmit but before we got the spinlock. 1673 */ 1674 if (list_empty(&dev->tx_reqs)) { 1675 spin_unlock_irqrestore(&dev->req_lock, flags); 1676 return 1; 1677 } 1678 1679 req = container_of (dev->tx_reqs.next, struct usb_request, list); 1680 list_del (&req->list); 1681 1682 /* temporarily stop TX queue when the freelist empties */ 1683 if (list_empty (&dev->tx_reqs)) 1684 netif_stop_queue (net); 1685 spin_unlock_irqrestore(&dev->req_lock, flags); 1686 1687 /* no buffer copies needed, unless the network stack did it 1688 * or the hardware can't use skb buffers. 1689 * or there's not enough space for any RNDIS headers we need 1690 */ 1691 if (rndis_active(dev)) { 1692 struct sk_buff *skb_rndis; 1693 1694 skb_rndis = skb_realloc_headroom (skb, 1695 sizeof (struct rndis_packet_msg_type)); 1696 if (!skb_rndis) 1697 goto drop; 1698 1699 dev_kfree_skb_any (skb); 1700 skb = skb_rndis; 1701 rndis_add_hdr (skb); 1702 length = skb->len; 1703 } 1704 req->buf = skb->data; 1705 req->context = skb; 1706 req->complete = tx_complete; 1707 1708 /* use zlp framing on tx for strict CDC-Ether conformance, 1709 * though any robust network rx path ignores extra padding. 1710 * and some hardware doesn't like to write zlps. 1711 */ 1712 req->zero = 1; 1713 if (!dev->zlp && (length % dev->in_ep->maxpacket) == 0) 1714 length++; 1715 1716 req->length = length; 1717 1718 /* throttle highspeed IRQ rate back slightly */ 1719 if (gadget_is_dualspeed(dev->gadget)) 1720 req->no_interrupt = (dev->gadget->speed == USB_SPEED_HIGH) 1721 ? ((atomic_read(&dev->tx_qlen) % qmult) != 0) 1722 : 0; 1723 1724 retval = usb_ep_queue (dev->in_ep, req, GFP_ATOMIC); 1725 switch (retval) { 1726 default: 1727 DEBUG (dev, "tx queue err %d\n", retval); 1728 break; 1729 case 0: 1730 net->trans_start = jiffies; 1731 atomic_inc (&dev->tx_qlen); 1732 } 1733 1734 if (retval) { 1735 drop: 1736 dev->stats.tx_dropped++; 1737 dev_kfree_skb_any (skb); 1738 spin_lock_irqsave(&dev->req_lock, flags); 1739 if (list_empty (&dev->tx_reqs)) 1740 netif_start_queue (net); 1741 list_add (&req->list, &dev->tx_reqs); 1742 spin_unlock_irqrestore(&dev->req_lock, flags); 1743 } 1744 return 0; 1745 } 1746 1747 /*-------------------------------------------------------------------------*/ 1748 #endif 1749 1750 static void eth_unbind(struct usb_gadget *gadget) 1751 { 1752 struct eth_dev *dev = get_gadget_data(gadget); 1753 1754 debug("%s...\n", __func__); 1755 rndis_deregister(dev->rndis_config); 1756 rndis_exit(); 1757 1758 /* we've already been disconnected ... no i/o is active */ 1759 if (dev->req) { 1760 usb_ep_free_request(gadget->ep0, dev->req); 1761 dev->req = NULL; 1762 } 1763 if (dev->stat_req) { 1764 usb_ep_free_request(dev->status_ep, dev->stat_req); 1765 dev->stat_req = NULL; 1766 } 1767 1768 if (dev->tx_req) { 1769 usb_ep_free_request(dev->in_ep, dev->tx_req); 1770 dev->tx_req = NULL; 1771 } 1772 1773 if (dev->rx_req) { 1774 usb_ep_free_request(dev->out_ep, dev->rx_req); 1775 dev->rx_req = NULL; 1776 } 1777 1778 /* unregister_netdev (dev->net);*/ 1779 /* free_netdev(dev->net);*/ 1780 1781 dev->gadget = NULL; 1782 set_gadget_data(gadget, NULL); 1783 } 1784 1785 static void eth_disconnect(struct usb_gadget *gadget) 1786 { 1787 eth_reset_config(get_gadget_data(gadget)); 1788 /* FIXME RNDIS should enter RNDIS_UNINITIALIZED */ 1789 } 1790 1791 static void eth_suspend(struct usb_gadget *gadget) 1792 { 1793 /* Not used */ 1794 } 1795 1796 static void eth_resume(struct usb_gadget *gadget) 1797 { 1798 /* Not used */ 1799 } 1800 1801 /*-------------------------------------------------------------------------*/ 1802 1803 #ifdef CONFIG_USB_ETH_RNDIS 1804 1805 /* 1806 * The interrupt endpoint is used in RNDIS to notify the host when messages 1807 * other than data packets are available ... notably the REMOTE_NDIS_*_CMPLT 1808 * messages, but also REMOTE_NDIS_INDICATE_STATUS_MSG and potentially even 1809 * REMOTE_NDIS_KEEPALIVE_MSG. 1810 * 1811 * The RNDIS control queue is processed by GET_ENCAPSULATED_RESPONSE, and 1812 * normally just one notification will be queued. 1813 */ 1814 1815 static void rndis_control_ack_complete(struct usb_ep *ep, 1816 struct usb_request *req) 1817 { 1818 struct eth_dev *dev = ep->driver_data; 1819 1820 debug("%s...\n", __func__); 1821 if (req->status || req->actual != req->length) 1822 debug("rndis control ack complete --> %d, %d/%d\n", 1823 req->status, req->actual, req->length); 1824 1825 if (!l_ethdev.network_started) { 1826 if (rndis_get_state(dev->rndis_config) 1827 == RNDIS_DATA_INITIALIZED) { 1828 l_ethdev.network_started = 1; 1829 printf("USB RNDIS network up!\n"); 1830 } 1831 } 1832 1833 req->context = NULL; 1834 1835 if (req != dev->stat_req) 1836 usb_ep_free_request(ep, req); 1837 } 1838 1839 static char rndis_resp_buf[8] __attribute__((aligned(sizeof(__le32)))); 1840 1841 static int rndis_control_ack(struct eth_device *net) 1842 { 1843 struct eth_dev *dev = &l_ethdev; 1844 int length; 1845 struct usb_request *resp = dev->stat_req; 1846 1847 /* in case RNDIS calls this after disconnect */ 1848 if (!dev->status) { 1849 debug("status ENODEV\n"); 1850 return -ENODEV; 1851 } 1852 1853 /* in case queue length > 1 */ 1854 if (resp->context) { 1855 resp = usb_ep_alloc_request(dev->status_ep, GFP_ATOMIC); 1856 if (!resp) 1857 return -ENOMEM; 1858 resp->buf = rndis_resp_buf; 1859 } 1860 1861 /* 1862 * Send RNDIS RESPONSE_AVAILABLE notification; 1863 * USB_CDC_NOTIFY_RESPONSE_AVAILABLE should work too 1864 */ 1865 resp->length = 8; 1866 resp->complete = rndis_control_ack_complete; 1867 resp->context = dev; 1868 1869 *((__le32 *) resp->buf) = __constant_cpu_to_le32(1); 1870 *((__le32 *) (resp->buf + 4)) = __constant_cpu_to_le32(0); 1871 1872 length = usb_ep_queue(dev->status_ep, resp, GFP_ATOMIC); 1873 if (length < 0) { 1874 resp->status = 0; 1875 rndis_control_ack_complete(dev->status_ep, resp); 1876 } 1877 1878 return 0; 1879 } 1880 1881 #else 1882 1883 #define rndis_control_ack NULL 1884 1885 #endif /* RNDIS */ 1886 1887 static void eth_start(struct eth_dev *dev, gfp_t gfp_flags) 1888 { 1889 if (rndis_active(dev)) { 1890 rndis_set_param_medium(dev->rndis_config, 1891 NDIS_MEDIUM_802_3, 1892 BITRATE(dev->gadget)/100); 1893 rndis_signal_connect(dev->rndis_config); 1894 } 1895 } 1896 1897 static int eth_stop(struct eth_dev *dev) 1898 { 1899 #ifdef RNDIS_COMPLETE_SIGNAL_DISCONNECT 1900 unsigned long ts; 1901 unsigned long timeout = CONFIG_SYS_HZ; /* 1 sec to stop RNDIS */ 1902 #endif 1903 1904 if (rndis_active(dev)) { 1905 rndis_set_param_medium(dev->rndis_config, NDIS_MEDIUM_802_3, 0); 1906 rndis_signal_disconnect(dev->rndis_config); 1907 1908 #ifdef RNDIS_COMPLETE_SIGNAL_DISCONNECT 1909 /* Wait until host receives OID_GEN_MEDIA_CONNECT_STATUS */ 1910 ts = get_timer(0); 1911 while (get_timer(ts) < timeout) 1912 usb_gadget_handle_interrupts(0); 1913 #endif 1914 1915 rndis_uninit(dev->rndis_config); 1916 dev->rndis = 0; 1917 } 1918 1919 return 0; 1920 } 1921 1922 /*-------------------------------------------------------------------------*/ 1923 1924 static int is_eth_addr_valid(char *str) 1925 { 1926 if (strlen(str) == 17) { 1927 int i; 1928 char *p, *q; 1929 uchar ea[6]; 1930 1931 /* see if it looks like an ethernet address */ 1932 1933 p = str; 1934 1935 for (i = 0; i < 6; i++) { 1936 char term = (i == 5 ? '\0' : ':'); 1937 1938 ea[i] = simple_strtol(p, &q, 16); 1939 1940 if ((q - p) != 2 || *q++ != term) 1941 break; 1942 1943 p = q; 1944 } 1945 1946 /* Now check the contents. */ 1947 return is_valid_ethaddr(ea); 1948 } 1949 return 0; 1950 } 1951 1952 static u8 nibble(unsigned char c) 1953 { 1954 if (likely(isdigit(c))) 1955 return c - '0'; 1956 c = toupper(c); 1957 if (likely(isxdigit(c))) 1958 return 10 + c - 'A'; 1959 return 0; 1960 } 1961 1962 static int get_ether_addr(const char *str, u8 *dev_addr) 1963 { 1964 if (str) { 1965 unsigned i; 1966 1967 for (i = 0; i < 6; i++) { 1968 unsigned char num; 1969 1970 if ((*str == '.') || (*str == ':')) 1971 str++; 1972 num = nibble(*str++) << 4; 1973 num |= (nibble(*str++)); 1974 dev_addr[i] = num; 1975 } 1976 if (is_valid_ethaddr(dev_addr)) 1977 return 0; 1978 } 1979 return 1; 1980 } 1981 1982 static int eth_bind(struct usb_gadget *gadget) 1983 { 1984 struct eth_dev *dev = &l_ethdev; 1985 u8 cdc = 1, zlp = 1, rndis = 1; 1986 struct usb_ep *in_ep, *out_ep, *status_ep = NULL; 1987 int status = -ENOMEM; 1988 int gcnum; 1989 u8 tmp[7]; 1990 1991 /* these flags are only ever cleared; compiler take note */ 1992 #ifndef CONFIG_USB_ETH_CDC 1993 cdc = 0; 1994 #endif 1995 #ifndef CONFIG_USB_ETH_RNDIS 1996 rndis = 0; 1997 #endif 1998 /* 1999 * Because most host side USB stacks handle CDC Ethernet, that 2000 * standard protocol is _strongly_ preferred for interop purposes. 2001 * (By everyone except Microsoft.) 2002 */ 2003 if (gadget_is_pxa(gadget)) { 2004 /* pxa doesn't support altsettings */ 2005 cdc = 0; 2006 } else if (gadget_is_musbhdrc(gadget)) { 2007 /* reduce tx dma overhead by avoiding special cases */ 2008 zlp = 0; 2009 } else if (gadget_is_sh(gadget)) { 2010 /* sh doesn't support multiple interfaces or configs */ 2011 cdc = 0; 2012 rndis = 0; 2013 } else if (gadget_is_sa1100(gadget)) { 2014 /* hardware can't write zlps */ 2015 zlp = 0; 2016 /* 2017 * sa1100 CAN do CDC, without status endpoint ... we use 2018 * non-CDC to be compatible with ARM Linux-2.4 "usb-eth". 2019 */ 2020 cdc = 0; 2021 } 2022 2023 gcnum = usb_gadget_controller_number(gadget); 2024 if (gcnum >= 0) 2025 device_desc.bcdDevice = cpu_to_le16(0x0300 + gcnum); 2026 else { 2027 /* 2028 * can't assume CDC works. don't want to default to 2029 * anything less functional on CDC-capable hardware, 2030 * so we fail in this case. 2031 */ 2032 error("controller '%s' not recognized", 2033 gadget->name); 2034 return -ENODEV; 2035 } 2036 2037 /* 2038 * If there's an RNDIS configuration, that's what Windows wants to 2039 * be using ... so use these product IDs here and in the "linux.inf" 2040 * needed to install MSFT drivers. Current Linux kernels will use 2041 * the second configuration if it's CDC Ethernet, and need some help 2042 * to choose the right configuration otherwise. 2043 */ 2044 if (rndis) { 2045 #if defined(CONFIG_USB_RNDIS_VENDOR_ID) && defined(CONFIG_USB_RNDIS_PRODUCT_ID) 2046 device_desc.idVendor = 2047 __constant_cpu_to_le16(CONFIG_USB_RNDIS_VENDOR_ID); 2048 device_desc.idProduct = 2049 __constant_cpu_to_le16(CONFIG_USB_RNDIS_PRODUCT_ID); 2050 #else 2051 device_desc.idVendor = 2052 __constant_cpu_to_le16(RNDIS_VENDOR_NUM); 2053 device_desc.idProduct = 2054 __constant_cpu_to_le16(RNDIS_PRODUCT_NUM); 2055 #endif 2056 sprintf(product_desc, "RNDIS/%s", driver_desc); 2057 2058 /* 2059 * CDC subset ... recognized by Linux since 2.4.10, but Windows 2060 * drivers aren't widely available. (That may be improved by 2061 * supporting one submode of the "SAFE" variant of MDLM.) 2062 */ 2063 } else { 2064 #if defined(CONFIG_USB_CDC_VENDOR_ID) && defined(CONFIG_USB_CDC_PRODUCT_ID) 2065 device_desc.idVendor = cpu_to_le16(CONFIG_USB_CDC_VENDOR_ID); 2066 device_desc.idProduct = cpu_to_le16(CONFIG_USB_CDC_PRODUCT_ID); 2067 #else 2068 if (!cdc) { 2069 device_desc.idVendor = 2070 __constant_cpu_to_le16(SIMPLE_VENDOR_NUM); 2071 device_desc.idProduct = 2072 __constant_cpu_to_le16(SIMPLE_PRODUCT_NUM); 2073 } 2074 #endif 2075 } 2076 /* support optional vendor/distro customization */ 2077 if (bcdDevice) 2078 device_desc.bcdDevice = cpu_to_le16(bcdDevice); 2079 if (iManufacturer) 2080 strlcpy(manufacturer, iManufacturer, sizeof manufacturer); 2081 if (iProduct) 2082 strlcpy(product_desc, iProduct, sizeof product_desc); 2083 if (iSerialNumber) { 2084 device_desc.iSerialNumber = STRING_SERIALNUMBER, 2085 strlcpy(serial_number, iSerialNumber, sizeof serial_number); 2086 } 2087 2088 /* all we really need is bulk IN/OUT */ 2089 usb_ep_autoconfig_reset(gadget); 2090 in_ep = usb_ep_autoconfig(gadget, &fs_source_desc); 2091 if (!in_ep) { 2092 autoconf_fail: 2093 error("can't autoconfigure on %s\n", 2094 gadget->name); 2095 return -ENODEV; 2096 } 2097 in_ep->driver_data = in_ep; /* claim */ 2098 2099 out_ep = usb_ep_autoconfig(gadget, &fs_sink_desc); 2100 if (!out_ep) 2101 goto autoconf_fail; 2102 out_ep->driver_data = out_ep; /* claim */ 2103 2104 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 2105 /* 2106 * CDC Ethernet control interface doesn't require a status endpoint. 2107 * Since some hosts expect one, try to allocate one anyway. 2108 */ 2109 if (cdc || rndis) { 2110 status_ep = usb_ep_autoconfig(gadget, &fs_status_desc); 2111 if (status_ep) { 2112 status_ep->driver_data = status_ep; /* claim */ 2113 } else if (rndis) { 2114 error("can't run RNDIS on %s", gadget->name); 2115 return -ENODEV; 2116 #ifdef CONFIG_USB_ETH_CDC 2117 } else if (cdc) { 2118 control_intf.bNumEndpoints = 0; 2119 /* FIXME remove endpoint from descriptor list */ 2120 #endif 2121 } 2122 } 2123 #endif 2124 2125 /* one config: cdc, else minimal subset */ 2126 if (!cdc) { 2127 eth_config.bNumInterfaces = 1; 2128 eth_config.iConfiguration = STRING_SUBSET; 2129 2130 /* 2131 * use functions to set these up, in case we're built to work 2132 * with multiple controllers and must override CDC Ethernet. 2133 */ 2134 fs_subset_descriptors(); 2135 hs_subset_descriptors(); 2136 } 2137 2138 usb_gadget_set_selfpowered(gadget); 2139 2140 /* For now RNDIS is always a second config */ 2141 if (rndis) 2142 device_desc.bNumConfigurations = 2; 2143 2144 if (gadget_is_dualspeed(gadget)) { 2145 if (rndis) 2146 dev_qualifier.bNumConfigurations = 2; 2147 else if (!cdc) 2148 dev_qualifier.bDeviceClass = USB_CLASS_VENDOR_SPEC; 2149 2150 /* assumes ep0 uses the same value for both speeds ... */ 2151 dev_qualifier.bMaxPacketSize0 = device_desc.bMaxPacketSize0; 2152 2153 /* and that all endpoints are dual-speed */ 2154 hs_source_desc.bEndpointAddress = 2155 fs_source_desc.bEndpointAddress; 2156 hs_sink_desc.bEndpointAddress = 2157 fs_sink_desc.bEndpointAddress; 2158 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 2159 if (status_ep) 2160 hs_status_desc.bEndpointAddress = 2161 fs_status_desc.bEndpointAddress; 2162 #endif 2163 } 2164 2165 if (gadget_is_otg(gadget)) { 2166 otg_descriptor.bmAttributes |= USB_OTG_HNP, 2167 eth_config.bmAttributes |= USB_CONFIG_ATT_WAKEUP; 2168 eth_config.bMaxPower = 4; 2169 #ifdef CONFIG_USB_ETH_RNDIS 2170 rndis_config.bmAttributes |= USB_CONFIG_ATT_WAKEUP; 2171 rndis_config.bMaxPower = 4; 2172 #endif 2173 } 2174 2175 2176 /* network device setup */ 2177 dev->net = &l_netdev; 2178 2179 dev->cdc = cdc; 2180 dev->zlp = zlp; 2181 2182 dev->in_ep = in_ep; 2183 dev->out_ep = out_ep; 2184 dev->status_ep = status_ep; 2185 2186 /* 2187 * Module params for these addresses should come from ID proms. 2188 * The host side address is used with CDC and RNDIS, and commonly 2189 * ends up in a persistent config database. It's not clear if 2190 * host side code for the SAFE thing cares -- its original BLAN 2191 * thing didn't, Sharp never assigned those addresses on Zaurii. 2192 */ 2193 get_ether_addr(dev_addr, dev->net->enetaddr); 2194 2195 memset(tmp, 0, sizeof(tmp)); 2196 memcpy(tmp, dev->net->enetaddr, sizeof(dev->net->enetaddr)); 2197 2198 get_ether_addr(host_addr, dev->host_mac); 2199 2200 sprintf(ethaddr, "%02X%02X%02X%02X%02X%02X", 2201 dev->host_mac[0], dev->host_mac[1], 2202 dev->host_mac[2], dev->host_mac[3], 2203 dev->host_mac[4], dev->host_mac[5]); 2204 2205 if (rndis) { 2206 status = rndis_init(); 2207 if (status < 0) { 2208 error("can't init RNDIS, %d", status); 2209 goto fail; 2210 } 2211 } 2212 2213 /* 2214 * use PKTSIZE (or aligned... from u-boot) and set 2215 * wMaxSegmentSize accordingly 2216 */ 2217 dev->mtu = PKTSIZE_ALIGN; /* RNDIS does not like this, only 1514, TODO*/ 2218 2219 /* preallocate control message data and buffer */ 2220 dev->req = usb_ep_alloc_request(gadget->ep0, GFP_KERNEL); 2221 if (!dev->req) 2222 goto fail; 2223 dev->req->buf = control_req; 2224 dev->req->complete = eth_setup_complete; 2225 2226 /* ... and maybe likewise for status transfer */ 2227 #if defined(CONFIG_USB_ETH_CDC) || defined(CONFIG_USB_ETH_RNDIS) 2228 if (dev->status_ep) { 2229 dev->stat_req = usb_ep_alloc_request(dev->status_ep, 2230 GFP_KERNEL); 2231 if (!dev->stat_req) { 2232 usb_ep_free_request(dev->status_ep, dev->req); 2233 2234 goto fail; 2235 } 2236 dev->stat_req->buf = status_req; 2237 dev->stat_req->context = NULL; 2238 } 2239 #endif 2240 2241 /* finish hookup to lower layer ... */ 2242 dev->gadget = gadget; 2243 set_gadget_data(gadget, dev); 2244 gadget->ep0->driver_data = dev; 2245 2246 /* 2247 * two kinds of host-initiated state changes: 2248 * - iff DATA transfer is active, carrier is "on" 2249 * - tx queueing enabled if open *and* carrier is "on" 2250 */ 2251 2252 printf("using %s, OUT %s IN %s%s%s\n", gadget->name, 2253 out_ep->name, in_ep->name, 2254 status_ep ? " STATUS " : "", 2255 status_ep ? status_ep->name : "" 2256 ); 2257 printf("MAC %02x:%02x:%02x:%02x:%02x:%02x\n", 2258 dev->net->enetaddr[0], dev->net->enetaddr[1], 2259 dev->net->enetaddr[2], dev->net->enetaddr[3], 2260 dev->net->enetaddr[4], dev->net->enetaddr[5]); 2261 2262 if (cdc || rndis) 2263 printf("HOST MAC %02x:%02x:%02x:%02x:%02x:%02x\n", 2264 dev->host_mac[0], dev->host_mac[1], 2265 dev->host_mac[2], dev->host_mac[3], 2266 dev->host_mac[4], dev->host_mac[5]); 2267 2268 if (rndis) { 2269 u32 vendorID = 0; 2270 2271 /* FIXME RNDIS vendor id == "vendor NIC code" == ? */ 2272 2273 dev->rndis_config = rndis_register(rndis_control_ack); 2274 if (dev->rndis_config < 0) { 2275 fail0: 2276 eth_unbind(gadget); 2277 debug("RNDIS setup failed\n"); 2278 status = -ENODEV; 2279 goto fail; 2280 } 2281 2282 /* these set up a lot of the OIDs that RNDIS needs */ 2283 rndis_set_host_mac(dev->rndis_config, dev->host_mac); 2284 if (rndis_set_param_dev(dev->rndis_config, dev->net, dev->mtu, 2285 &dev->stats, &dev->cdc_filter)) 2286 goto fail0; 2287 if (rndis_set_param_vendor(dev->rndis_config, vendorID, 2288 manufacturer)) 2289 goto fail0; 2290 if (rndis_set_param_medium(dev->rndis_config, 2291 NDIS_MEDIUM_802_3, 0)) 2292 goto fail0; 2293 printf("RNDIS ready\n"); 2294 } 2295 return 0; 2296 2297 fail: 2298 error("%s failed, status = %d", __func__, status); 2299 eth_unbind(gadget); 2300 return status; 2301 } 2302 2303 /*-------------------------------------------------------------------------*/ 2304 2305 static int usb_eth_init(struct eth_device *netdev, bd_t *bd) 2306 { 2307 struct eth_dev *dev = &l_ethdev; 2308 struct usb_gadget *gadget; 2309 unsigned long ts; 2310 unsigned long timeout = USB_CONNECT_TIMEOUT; 2311 2312 if (!netdev) { 2313 error("received NULL ptr"); 2314 goto fail; 2315 } 2316 2317 board_usb_init(0, USB_INIT_DEVICE); 2318 2319 /* Configure default mac-addresses for the USB ethernet device */ 2320 #ifdef CONFIG_USBNET_DEV_ADDR 2321 strlcpy(dev_addr, CONFIG_USBNET_DEV_ADDR, sizeof(dev_addr)); 2322 #endif 2323 #ifdef CONFIG_USBNET_HOST_ADDR 2324 strlcpy(host_addr, CONFIG_USBNET_HOST_ADDR, sizeof(host_addr)); 2325 #endif 2326 /* Check if the user overruled the MAC addresses */ 2327 if (getenv("usbnet_devaddr")) 2328 strlcpy(dev_addr, getenv("usbnet_devaddr"), 2329 sizeof(dev_addr)); 2330 2331 if (getenv("usbnet_hostaddr")) 2332 strlcpy(host_addr, getenv("usbnet_hostaddr"), 2333 sizeof(host_addr)); 2334 2335 if (!is_eth_addr_valid(dev_addr)) { 2336 error("Need valid 'usbnet_devaddr' to be set"); 2337 goto fail; 2338 } 2339 if (!is_eth_addr_valid(host_addr)) { 2340 error("Need valid 'usbnet_hostaddr' to be set"); 2341 goto fail; 2342 } 2343 2344 if (usb_gadget_register_driver(ð_driver) < 0) 2345 goto fail; 2346 2347 dev->network_started = 0; 2348 2349 packet_received = 0; 2350 packet_sent = 0; 2351 2352 gadget = dev->gadget; 2353 usb_gadget_connect(gadget); 2354 2355 if (getenv("cdc_connect_timeout")) 2356 timeout = simple_strtoul(getenv("cdc_connect_timeout"), 2357 NULL, 10) * CONFIG_SYS_HZ; 2358 ts = get_timer(0); 2359 while (!l_ethdev.network_started) { 2360 /* Handle control-c and timeouts */ 2361 if (ctrlc() || (get_timer(ts) > timeout)) { 2362 error("The remote end did not respond in time."); 2363 goto fail; 2364 } 2365 usb_gadget_handle_interrupts(0); 2366 } 2367 2368 packet_received = 0; 2369 rx_submit(dev, dev->rx_req, 0); 2370 return 0; 2371 fail: 2372 return -1; 2373 } 2374 2375 static int usb_eth_send(struct eth_device *netdev, void *packet, int length) 2376 { 2377 int retval; 2378 void *rndis_pkt = NULL; 2379 struct eth_dev *dev = &l_ethdev; 2380 struct usb_request *req = dev->tx_req; 2381 unsigned long ts; 2382 unsigned long timeout = USB_CONNECT_TIMEOUT; 2383 2384 debug("%s:...\n", __func__); 2385 2386 /* new buffer is needed to include RNDIS header */ 2387 if (rndis_active(dev)) { 2388 rndis_pkt = malloc(length + 2389 sizeof(struct rndis_packet_msg_type)); 2390 if (!rndis_pkt) { 2391 error("No memory to alloc RNDIS packet"); 2392 goto drop; 2393 } 2394 rndis_add_hdr(rndis_pkt, length); 2395 memcpy(rndis_pkt + sizeof(struct rndis_packet_msg_type), 2396 packet, length); 2397 packet = rndis_pkt; 2398 length += sizeof(struct rndis_packet_msg_type); 2399 } 2400 req->buf = packet; 2401 req->context = NULL; 2402 req->complete = tx_complete; 2403 2404 /* 2405 * use zlp framing on tx for strict CDC-Ether conformance, 2406 * though any robust network rx path ignores extra padding. 2407 * and some hardware doesn't like to write zlps. 2408 */ 2409 req->zero = 1; 2410 if (!dev->zlp && (length % dev->in_ep->maxpacket) == 0) 2411 length++; 2412 2413 req->length = length; 2414 #if 0 2415 /* throttle highspeed IRQ rate back slightly */ 2416 if (gadget_is_dualspeed(dev->gadget)) 2417 req->no_interrupt = (dev->gadget->speed == USB_SPEED_HIGH) 2418 ? ((dev->tx_qlen % qmult) != 0) : 0; 2419 #endif 2420 dev->tx_qlen = 1; 2421 ts = get_timer(0); 2422 packet_sent = 0; 2423 2424 retval = usb_ep_queue(dev->in_ep, req, GFP_ATOMIC); 2425 2426 if (!retval) 2427 debug("%s: packet queued\n", __func__); 2428 while (!packet_sent) { 2429 if (get_timer(ts) > timeout) { 2430 printf("timeout sending packets to usb ethernet\n"); 2431 return -1; 2432 } 2433 usb_gadget_handle_interrupts(0); 2434 } 2435 if (rndis_pkt) 2436 free(rndis_pkt); 2437 2438 return 0; 2439 drop: 2440 dev->stats.tx_dropped++; 2441 return -ENOMEM; 2442 } 2443 2444 static int usb_eth_recv(struct eth_device *netdev) 2445 { 2446 struct eth_dev *dev = &l_ethdev; 2447 2448 usb_gadget_handle_interrupts(0); 2449 2450 if (packet_received) { 2451 debug("%s: packet received\n", __func__); 2452 if (dev->rx_req) { 2453 net_process_received_packet(net_rx_packets[0], 2454 dev->rx_req->length); 2455 packet_received = 0; 2456 2457 rx_submit(dev, dev->rx_req, 0); 2458 } else 2459 error("dev->rx_req invalid"); 2460 } 2461 return 0; 2462 } 2463 2464 void usb_eth_halt(struct eth_device *netdev) 2465 { 2466 struct eth_dev *dev = &l_ethdev; 2467 2468 if (!netdev) { 2469 error("received NULL ptr"); 2470 return; 2471 } 2472 2473 /* If the gadget not registered, simple return */ 2474 if (!dev->gadget) 2475 return; 2476 2477 /* 2478 * Some USB controllers may need additional deinitialization here 2479 * before dropping pull-up (also due to hardware issues). 2480 * For example: unhandled interrupt with status stage started may 2481 * bring the controller to fully broken state (until board reset). 2482 * There are some variants to debug and fix such cases: 2483 * 1) In the case of RNDIS connection eth_stop can perform additional 2484 * interrupt handling. See RNDIS_COMPLETE_SIGNAL_DISCONNECT definition. 2485 * 2) 'pullup' callback in your UDC driver can be improved to perform 2486 * this deinitialization. 2487 */ 2488 eth_stop(dev); 2489 2490 usb_gadget_disconnect(dev->gadget); 2491 2492 /* Clear pending interrupt */ 2493 if (dev->network_started) { 2494 usb_gadget_handle_interrupts(0); 2495 dev->network_started = 0; 2496 } 2497 2498 usb_gadget_unregister_driver(ð_driver); 2499 board_usb_cleanup(0, USB_INIT_DEVICE); 2500 } 2501 2502 static struct usb_gadget_driver eth_driver = { 2503 .speed = DEVSPEED, 2504 2505 .bind = eth_bind, 2506 .unbind = eth_unbind, 2507 2508 .setup = eth_setup, 2509 .reset = eth_disconnect, 2510 .disconnect = eth_disconnect, 2511 2512 .suspend = eth_suspend, 2513 .resume = eth_resume, 2514 }; 2515 2516 int usb_eth_initialize(bd_t *bi) 2517 { 2518 struct eth_device *netdev = &l_netdev; 2519 2520 strlcpy(netdev->name, USB_NET_NAME, sizeof(netdev->name)); 2521 2522 netdev->init = usb_eth_init; 2523 netdev->send = usb_eth_send; 2524 netdev->recv = usb_eth_recv; 2525 netdev->halt = usb_eth_halt; 2526 2527 #ifdef CONFIG_MCAST_TFTP 2528 #error not supported 2529 #endif 2530 eth_register(netdev); 2531 return 0; 2532 } 2533