ipheth.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581
  1. /*
  2. * ipheth.c - Apple iPhone USB Ethernet driver
  3. *
  4. * Copyright (c) 2009 Diego Giagio <diego@giagio.com>
  5. * All rights reserved.
  6. *
  7. * Redistribution and use in source and binary forms, with or without
  8. * modification, are permitted provided that the following conditions
  9. * are met:
  10. * 1. Redistributions of source code must retain the above copyright
  11. * notice, this list of conditions and the following disclaimer.
  12. * 2. Redistributions in binary form must reproduce the above copyright
  13. * notice, this list of conditions and the following disclaimer in the
  14. * documentation and/or other materials provided with the distribution.
  15. * 3. Neither the name of GIAGIO.COM nor the names of its contributors
  16. * may be used to endorse or promote products derived from this software
  17. * without specific prior written permission.
  18. *
  19. * Alternatively, provided that this notice is retained in full, this
  20. * software may be distributed under the terms of the GNU General
  21. * Public License ("GPL") version 2, in which case the provisions of the
  22. * GPL apply INSTEAD OF those given above.
  23. *
  24. * The provided data structures and external interfaces from this code
  25. * are not restricted to be used by modules with a GPL compatible license.
  26. *
  27. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  28. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  29. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  30. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  31. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  32. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  33. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  34. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  35. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  36. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  37. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  38. * DAMAGE.
  39. *
  40. *
  41. * Attention: iPhone device must be paired, otherwise it won't respond to our
  42. * driver. For more info: http://giagio.com/wiki/moin.cgi/iPhoneEthernetDriver
  43. *
  44. */
  45. #include <linux/kernel.h>
  46. #include <linux/errno.h>
  47. #include <linux/init.h>
  48. #include <linux/slab.h>
  49. #include <linux/module.h>
  50. #include <linux/netdevice.h>
  51. #include <linux/etherdevice.h>
  52. #include <linux/ethtool.h>
  53. #include <linux/usb.h>
  54. #include <linux/workqueue.h>
  55. #define USB_VENDOR_APPLE 0x05ac
  56. #define USB_PRODUCT_IPHONE 0x1290
  57. #define USB_PRODUCT_IPHONE_3G 0x1292
  58. #define USB_PRODUCT_IPHONE_3GS 0x1294
  59. #define USB_PRODUCT_IPHONE_4 0x1297
  60. #define USB_PRODUCT_IPHONE_4_VZW 0x129c
  61. #define USB_PRODUCT_IPHONE_4S 0x12a0
  62. #define IPHETH_USBINTF_CLASS 255
  63. #define IPHETH_USBINTF_SUBCLASS 253
  64. #define IPHETH_USBINTF_PROTO 1
  65. #define IPHETH_BUF_SIZE 1516
  66. #define IPHETH_IP_ALIGN 2 /* padding at front of URB */
  67. #define IPHETH_TX_TIMEOUT (5 * HZ)
  68. #define IPHETH_INTFNUM 2
  69. #define IPHETH_ALT_INTFNUM 1
  70. #define IPHETH_CTRL_ENDP 0x00
  71. #define IPHETH_CTRL_BUF_SIZE 0x40
  72. #define IPHETH_CTRL_TIMEOUT (5 * HZ)
  73. #define IPHETH_CMD_GET_MACADDR 0x00
  74. #define IPHETH_CMD_CARRIER_CHECK 0x45
  75. #define IPHETH_CARRIER_CHECK_TIMEOUT round_jiffies_relative(1 * HZ)
  76. #define IPHETH_CARRIER_ON 0x04
  77. static struct usb_device_id ipheth_table[] = {
  78. { USB_DEVICE_AND_INTERFACE_INFO(
  79. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE,
  80. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  81. IPHETH_USBINTF_PROTO) },
  82. { USB_DEVICE_AND_INTERFACE_INFO(
  83. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE_3G,
  84. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  85. IPHETH_USBINTF_PROTO) },
  86. { USB_DEVICE_AND_INTERFACE_INFO(
  87. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE_3GS,
  88. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  89. IPHETH_USBINTF_PROTO) },
  90. { USB_DEVICE_AND_INTERFACE_INFO(
  91. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE_4,
  92. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  93. IPHETH_USBINTF_PROTO) },
  94. { USB_DEVICE_AND_INTERFACE_INFO(
  95. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE_4_VZW,
  96. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  97. IPHETH_USBINTF_PROTO) },
  98. { USB_DEVICE_AND_INTERFACE_INFO(
  99. USB_VENDOR_APPLE, USB_PRODUCT_IPHONE_4S,
  100. IPHETH_USBINTF_CLASS, IPHETH_USBINTF_SUBCLASS,
  101. IPHETH_USBINTF_PROTO) },
  102. { }
  103. };
  104. MODULE_DEVICE_TABLE(usb, ipheth_table);
  105. struct ipheth_device {
  106. struct usb_device *udev;
  107. struct usb_interface *intf;
  108. struct net_device *net;
  109. struct sk_buff *tx_skb;
  110. struct urb *tx_urb;
  111. struct urb *rx_urb;
  112. unsigned char *tx_buf;
  113. unsigned char *rx_buf;
  114. unsigned char *ctrl_buf;
  115. u8 bulk_in;
  116. u8 bulk_out;
  117. struct delayed_work carrier_work;
  118. };
  119. static int ipheth_rx_submit(struct ipheth_device *dev, gfp_t mem_flags);
  120. static int ipheth_alloc_urbs(struct ipheth_device *iphone)
  121. {
  122. struct urb *tx_urb = NULL;
  123. struct urb *rx_urb = NULL;
  124. u8 *tx_buf = NULL;
  125. u8 *rx_buf = NULL;
  126. tx_urb = usb_alloc_urb(0, GFP_KERNEL);
  127. if (tx_urb == NULL)
  128. goto error_nomem;
  129. rx_urb = usb_alloc_urb(0, GFP_KERNEL);
  130. if (rx_urb == NULL)
  131. goto free_tx_urb;
  132. tx_buf = usb_alloc_coherent(iphone->udev, IPHETH_BUF_SIZE,
  133. GFP_KERNEL, &tx_urb->transfer_dma);
  134. if (tx_buf == NULL)
  135. goto free_rx_urb;
  136. rx_buf = usb_alloc_coherent(iphone->udev, IPHETH_BUF_SIZE,
  137. GFP_KERNEL, &rx_urb->transfer_dma);
  138. if (rx_buf == NULL)
  139. goto free_tx_buf;
  140. iphone->tx_urb = tx_urb;
  141. iphone->rx_urb = rx_urb;
  142. iphone->tx_buf = tx_buf;
  143. iphone->rx_buf = rx_buf;
  144. return 0;
  145. free_tx_buf:
  146. usb_free_coherent(iphone->udev, IPHETH_BUF_SIZE, tx_buf,
  147. tx_urb->transfer_dma);
  148. free_rx_urb:
  149. usb_free_urb(rx_urb);
  150. free_tx_urb:
  151. usb_free_urb(tx_urb);
  152. error_nomem:
  153. return -ENOMEM;
  154. }
  155. static void ipheth_free_urbs(struct ipheth_device *iphone)
  156. {
  157. usb_free_coherent(iphone->udev, IPHETH_BUF_SIZE, iphone->rx_buf,
  158. iphone->rx_urb->transfer_dma);
  159. usb_free_coherent(iphone->udev, IPHETH_BUF_SIZE, iphone->tx_buf,
  160. iphone->tx_urb->transfer_dma);
  161. usb_free_urb(iphone->rx_urb);
  162. usb_free_urb(iphone->tx_urb);
  163. }
  164. static void ipheth_kill_urbs(struct ipheth_device *dev)
  165. {
  166. usb_kill_urb(dev->tx_urb);
  167. usb_kill_urb(dev->rx_urb);
  168. }
  169. static void ipheth_rcvbulk_callback(struct urb *urb)
  170. {
  171. struct ipheth_device *dev;
  172. struct sk_buff *skb;
  173. int status;
  174. char *buf;
  175. int len;
  176. dev = urb->context;
  177. if (dev == NULL)
  178. return;
  179. status = urb->status;
  180. switch (status) {
  181. case -ENOENT:
  182. case -ECONNRESET:
  183. case -ESHUTDOWN:
  184. return;
  185. case 0:
  186. break;
  187. default:
  188. err("%s: urb status: %d", __func__, status);
  189. return;
  190. }
  191. if (urb->actual_length <= IPHETH_IP_ALIGN) {
  192. dev->net->stats.rx_length_errors++;
  193. return;
  194. }
  195. len = urb->actual_length - IPHETH_IP_ALIGN;
  196. buf = urb->transfer_buffer + IPHETH_IP_ALIGN;
  197. skb = dev_alloc_skb(len);
  198. if (!skb) {
  199. err("%s: dev_alloc_skb: -ENOMEM", __func__);
  200. dev->net->stats.rx_dropped++;
  201. return;
  202. }
  203. memcpy(skb_put(skb, len), buf, len);
  204. skb->dev = dev->net;
  205. skb->protocol = eth_type_trans(skb, dev->net);
  206. dev->net->stats.rx_packets++;
  207. dev->net->stats.rx_bytes += len;
  208. netif_rx(skb);
  209. ipheth_rx_submit(dev, GFP_ATOMIC);
  210. }
  211. static void ipheth_sndbulk_callback(struct urb *urb)
  212. {
  213. struct ipheth_device *dev;
  214. int status = urb->status;
  215. dev = urb->context;
  216. if (dev == NULL)
  217. return;
  218. if (status != 0 &&
  219. status != -ENOENT &&
  220. status != -ECONNRESET &&
  221. status != -ESHUTDOWN)
  222. err("%s: urb status: %d", __func__, status);
  223. dev_kfree_skb_irq(dev->tx_skb);
  224. netif_wake_queue(dev->net);
  225. }
  226. static int ipheth_carrier_set(struct ipheth_device *dev)
  227. {
  228. struct usb_device *udev = dev->udev;
  229. int retval;
  230. retval = usb_control_msg(udev,
  231. usb_rcvctrlpipe(udev, IPHETH_CTRL_ENDP),
  232. IPHETH_CMD_CARRIER_CHECK, /* request */
  233. 0xc0, /* request type */
  234. 0x00, /* value */
  235. 0x02, /* index */
  236. dev->ctrl_buf, IPHETH_CTRL_BUF_SIZE,
  237. IPHETH_CTRL_TIMEOUT);
  238. if (retval < 0) {
  239. err("%s: usb_control_msg: %d", __func__, retval);
  240. return retval;
  241. }
  242. if (dev->ctrl_buf[0] == IPHETH_CARRIER_ON)
  243. netif_carrier_on(dev->net);
  244. else
  245. netif_carrier_off(dev->net);
  246. return 0;
  247. }
  248. static void ipheth_carrier_check_work(struct work_struct *work)
  249. {
  250. struct ipheth_device *dev = container_of(work, struct ipheth_device,
  251. carrier_work.work);
  252. ipheth_carrier_set(dev);
  253. schedule_delayed_work(&dev->carrier_work, IPHETH_CARRIER_CHECK_TIMEOUT);
  254. }
  255. static int ipheth_get_macaddr(struct ipheth_device *dev)
  256. {
  257. struct usb_device *udev = dev->udev;
  258. struct net_device *net = dev->net;
  259. int retval;
  260. retval = usb_control_msg(udev,
  261. usb_rcvctrlpipe(udev, IPHETH_CTRL_ENDP),
  262. IPHETH_CMD_GET_MACADDR, /* request */
  263. 0xc0, /* request type */
  264. 0x00, /* value */
  265. 0x02, /* index */
  266. dev->ctrl_buf,
  267. IPHETH_CTRL_BUF_SIZE,
  268. IPHETH_CTRL_TIMEOUT);
  269. if (retval < 0) {
  270. err("%s: usb_control_msg: %d", __func__, retval);
  271. } else if (retval < ETH_ALEN) {
  272. err("%s: usb_control_msg: short packet: %d bytes",
  273. __func__, retval);
  274. retval = -EINVAL;
  275. } else {
  276. memcpy(net->dev_addr, dev->ctrl_buf, ETH_ALEN);
  277. retval = 0;
  278. }
  279. return retval;
  280. }
  281. static int ipheth_rx_submit(struct ipheth_device *dev, gfp_t mem_flags)
  282. {
  283. struct usb_device *udev = dev->udev;
  284. int retval;
  285. usb_fill_bulk_urb(dev->rx_urb, udev,
  286. usb_rcvbulkpipe(udev, dev->bulk_in),
  287. dev->rx_buf, IPHETH_BUF_SIZE,
  288. ipheth_rcvbulk_callback,
  289. dev);
  290. dev->rx_urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  291. retval = usb_submit_urb(dev->rx_urb, mem_flags);
  292. if (retval)
  293. err("%s: usb_submit_urb: %d", __func__, retval);
  294. return retval;
  295. }
  296. static int ipheth_open(struct net_device *net)
  297. {
  298. struct ipheth_device *dev = netdev_priv(net);
  299. struct usb_device *udev = dev->udev;
  300. int retval = 0;
  301. usb_set_interface(udev, IPHETH_INTFNUM, IPHETH_ALT_INTFNUM);
  302. retval = ipheth_carrier_set(dev);
  303. if (retval)
  304. return retval;
  305. retval = ipheth_rx_submit(dev, GFP_KERNEL);
  306. if (retval)
  307. return retval;
  308. schedule_delayed_work(&dev->carrier_work, IPHETH_CARRIER_CHECK_TIMEOUT);
  309. netif_start_queue(net);
  310. return retval;
  311. }
  312. static int ipheth_close(struct net_device *net)
  313. {
  314. struct ipheth_device *dev = netdev_priv(net);
  315. cancel_delayed_work_sync(&dev->carrier_work);
  316. netif_stop_queue(net);
  317. return 0;
  318. }
  319. static int ipheth_tx(struct sk_buff *skb, struct net_device *net)
  320. {
  321. struct ipheth_device *dev = netdev_priv(net);
  322. struct usb_device *udev = dev->udev;
  323. int retval;
  324. /* Paranoid */
  325. if (skb->len > IPHETH_BUF_SIZE) {
  326. WARN(1, "%s: skb too large: %d bytes\n", __func__, skb->len);
  327. dev->net->stats.tx_dropped++;
  328. dev_kfree_skb_irq(skb);
  329. return NETDEV_TX_OK;
  330. }
  331. memcpy(dev->tx_buf, skb->data, skb->len);
  332. if (skb->len < IPHETH_BUF_SIZE)
  333. memset(dev->tx_buf + skb->len, 0, IPHETH_BUF_SIZE - skb->len);
  334. usb_fill_bulk_urb(dev->tx_urb, udev,
  335. usb_sndbulkpipe(udev, dev->bulk_out),
  336. dev->tx_buf, IPHETH_BUF_SIZE,
  337. ipheth_sndbulk_callback,
  338. dev);
  339. dev->tx_urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  340. retval = usb_submit_urb(dev->tx_urb, GFP_ATOMIC);
  341. if (retval) {
  342. err("%s: usb_submit_urb: %d", __func__, retval);
  343. dev->net->stats.tx_errors++;
  344. dev_kfree_skb_irq(skb);
  345. } else {
  346. dev->tx_skb = skb;
  347. dev->net->stats.tx_packets++;
  348. dev->net->stats.tx_bytes += skb->len;
  349. netif_stop_queue(net);
  350. }
  351. return NETDEV_TX_OK;
  352. }
  353. static void ipheth_tx_timeout(struct net_device *net)
  354. {
  355. struct ipheth_device *dev = netdev_priv(net);
  356. err("%s: TX timeout", __func__);
  357. dev->net->stats.tx_errors++;
  358. usb_unlink_urb(dev->tx_urb);
  359. }
  360. static struct net_device_stats *ipheth_stats(struct net_device *net)
  361. {
  362. struct ipheth_device *dev = netdev_priv(net);
  363. return &dev->net->stats;
  364. }
  365. static u32 ipheth_ethtool_op_get_link(struct net_device *net)
  366. {
  367. struct ipheth_device *dev = netdev_priv(net);
  368. return netif_carrier_ok(dev->net);
  369. }
  370. static struct ethtool_ops ops = {
  371. .get_link = ipheth_ethtool_op_get_link
  372. };
  373. static const struct net_device_ops ipheth_netdev_ops = {
  374. .ndo_open = &ipheth_open,
  375. .ndo_stop = &ipheth_close,
  376. .ndo_start_xmit = &ipheth_tx,
  377. .ndo_tx_timeout = &ipheth_tx_timeout,
  378. .ndo_get_stats = &ipheth_stats,
  379. };
  380. static int ipheth_probe(struct usb_interface *intf,
  381. const struct usb_device_id *id)
  382. {
  383. struct usb_device *udev = interface_to_usbdev(intf);
  384. struct usb_host_interface *hintf;
  385. struct usb_endpoint_descriptor *endp;
  386. struct ipheth_device *dev;
  387. struct net_device *netdev;
  388. int i;
  389. int retval;
  390. netdev = alloc_etherdev(sizeof(struct ipheth_device));
  391. if (!netdev)
  392. return -ENOMEM;
  393. netdev->netdev_ops = &ipheth_netdev_ops;
  394. netdev->watchdog_timeo = IPHETH_TX_TIMEOUT;
  395. strcpy(netdev->name, "eth%d");
  396. dev = netdev_priv(netdev);
  397. dev->udev = udev;
  398. dev->net = netdev;
  399. dev->intf = intf;
  400. /* Set up endpoints */
  401. hintf = usb_altnum_to_altsetting(intf, IPHETH_ALT_INTFNUM);
  402. if (hintf == NULL) {
  403. retval = -ENODEV;
  404. err("Unable to find alternate settings interface");
  405. goto err_endpoints;
  406. }
  407. for (i = 0; i < hintf->desc.bNumEndpoints; i++) {
  408. endp = &hintf->endpoint[i].desc;
  409. if (usb_endpoint_is_bulk_in(endp))
  410. dev->bulk_in = endp->bEndpointAddress;
  411. else if (usb_endpoint_is_bulk_out(endp))
  412. dev->bulk_out = endp->bEndpointAddress;
  413. }
  414. if (!(dev->bulk_in && dev->bulk_out)) {
  415. retval = -ENODEV;
  416. err("Unable to find endpoints");
  417. goto err_endpoints;
  418. }
  419. dev->ctrl_buf = kmalloc(IPHETH_CTRL_BUF_SIZE, GFP_KERNEL);
  420. if (dev->ctrl_buf == NULL) {
  421. retval = -ENOMEM;
  422. goto err_alloc_ctrl_buf;
  423. }
  424. retval = ipheth_get_macaddr(dev);
  425. if (retval)
  426. goto err_get_macaddr;
  427. INIT_DELAYED_WORK(&dev->carrier_work, ipheth_carrier_check_work);
  428. retval = ipheth_alloc_urbs(dev);
  429. if (retval) {
  430. err("error allocating urbs: %d", retval);
  431. goto err_alloc_urbs;
  432. }
  433. usb_set_intfdata(intf, dev);
  434. SET_NETDEV_DEV(netdev, &intf->dev);
  435. SET_ETHTOOL_OPS(netdev, &ops);
  436. retval = register_netdev(netdev);
  437. if (retval) {
  438. err("error registering netdev: %d", retval);
  439. retval = -EIO;
  440. goto err_register_netdev;
  441. }
  442. dev_info(&intf->dev, "Apple iPhone USB Ethernet device attached\n");
  443. return 0;
  444. err_register_netdev:
  445. ipheth_free_urbs(dev);
  446. err_alloc_urbs:
  447. err_get_macaddr:
  448. err_alloc_ctrl_buf:
  449. kfree(dev->ctrl_buf);
  450. err_endpoints:
  451. free_netdev(netdev);
  452. return retval;
  453. }
  454. static void ipheth_disconnect(struct usb_interface *intf)
  455. {
  456. struct ipheth_device *dev;
  457. dev = usb_get_intfdata(intf);
  458. if (dev != NULL) {
  459. unregister_netdev(dev->net);
  460. ipheth_kill_urbs(dev);
  461. ipheth_free_urbs(dev);
  462. kfree(dev->ctrl_buf);
  463. free_netdev(dev->net);
  464. }
  465. usb_set_intfdata(intf, NULL);
  466. dev_info(&intf->dev, "Apple iPhone USB Ethernet now disconnected\n");
  467. }
  468. static struct usb_driver ipheth_driver = {
  469. .name = "ipheth",
  470. .probe = ipheth_probe,
  471. .disconnect = ipheth_disconnect,
  472. .id_table = ipheth_table,
  473. };
  474. static int __init ipheth_init(void)
  475. {
  476. int retval;
  477. retval = usb_register(&ipheth_driver);
  478. if (retval) {
  479. err("usb_register failed: %d", retval);
  480. return retval;
  481. }
  482. return 0;
  483. }
  484. static void __exit ipheth_exit(void)
  485. {
  486. usb_deregister(&ipheth_driver);
  487. }
  488. module_init(ipheth_init);
  489. module_exit(ipheth_exit);
  490. MODULE_AUTHOR("Diego Giagio <diego@giagio.com>");
  491. MODULE_DESCRIPTION("Apple iPhone USB Ethernet driver");
  492. MODULE_LICENSE("Dual BSD/GPL");