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