Thomas Gleixner | 1ccea77 | 2019-05-19 15:51:43 +0200 | [diff] [blame] | 1 | // SPDX-License-Identifier: GPL-2.0-or-later |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 2 | /* |
| 3 | * PL-2301/2302 USB host-to-host link cables |
| 4 | * Copyright (C) 2000-2005 by David Brownell |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 5 | */ |
| 6 | |
| 7 | // #define DEBUG // error path messages, extra info |
| 8 | // #define VERBOSE // more; success messages |
| 9 | |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 10 | #include <linux/module.h> |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 11 | #include <linux/netdevice.h> |
| 12 | #include <linux/etherdevice.h> |
| 13 | #include <linux/ethtool.h> |
| 14 | #include <linux/workqueue.h> |
| 15 | #include <linux/mii.h> |
| 16 | #include <linux/usb.h> |
Jussi Kivilinna | 3692e94 | 2008-01-26 00:51:45 +0200 | [diff] [blame] | 17 | #include <linux/usb/usbnet.h> |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 18 | |
| 19 | |
| 20 | /* |
Justin P. Mattock | 631dd1a | 2010-10-18 11:03:14 +0200 | [diff] [blame] | 21 | * Prolific PL-2301/PL-2302 driver ... http://www.prolific.com.tw/ |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 22 | * |
| 23 | * The protocol and handshaking used here should be bug-compatible |
| 24 | * with the Linux 2.2 "plusb" driver, by Deti Fliegl. |
| 25 | * |
| 26 | * HEADS UP: this handshaking isn't all that robust. This driver |
| 27 | * gets confused easily if you unplug one end of the cable then |
| 28 | * try to connect it again; you'll need to restart both ends. The |
Diego Viola | a69f0e2 | 2016-03-27 20:58:15 -0300 | [diff] [blame] | 29 | * "naplink" software (used by some PlayStation/2 developers) does |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 30 | * the handshaking much better! Also, sometimes this hardware |
| 31 | * seems to get wedged under load. Prolific docs are weak, and |
| 32 | * don't identify differences between PL2301 and PL2302, much less |
| 33 | * anything to explain the different PL2302 versions observed. |
simon | 647da40 | 2011-04-06 21:40:14 +0000 | [diff] [blame] | 34 | * |
| 35 | * NOTE: pl2501 has several modes, including pl2301 and pl2302 |
| 36 | * compatibility. Some docs suggest the difference between 2301 |
| 37 | * and 2302 is only to make MS-Windows use a different driver... |
| 38 | * |
| 39 | * pl25a1 glue based on patch from Tony Gibbs. Prolific "docs" on |
| 40 | * this chip are as usual incomplete about what control messages |
| 41 | * are supported. |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 42 | */ |
| 43 | |
| 44 | /* |
| 45 | * Bits 0-4 can be used for software handshaking; they're set from |
| 46 | * one end, cleared from the other, "read" with the interrupt byte. |
| 47 | */ |
| 48 | #define PL_S_EN (1<<7) /* (feature only) suspend enable */ |
| 49 | /* reserved bit -- rx ready (6) ? */ |
| 50 | #define PL_TX_READY (1<<5) /* (interrupt only) transmit ready */ |
| 51 | #define PL_RESET_OUT (1<<4) /* reset output pipe */ |
| 52 | #define PL_RESET_IN (1<<3) /* reset input pipe */ |
| 53 | #define PL_TX_C (1<<2) /* transmission complete */ |
| 54 | #define PL_TX_REQ (1<<1) /* transmission received */ |
| 55 | #define PL_PEER_E (1<<0) /* peer exists */ |
| 56 | |
| 57 | static inline int |
| 58 | pl_vendor_req(struct usbnet *dev, u8 req, u8 val, u8 index) |
| 59 | { |
Ming Lei | 7cdd2487 | 2012-10-24 19:47:01 +0000 | [diff] [blame] | 60 | return usbnet_read_cmd(dev, req, |
| 61 | USB_DIR_IN | USB_TYPE_VENDOR | |
| 62 | USB_RECIP_DEVICE, |
| 63 | val, index, NULL, 0); |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 64 | } |
| 65 | |
| 66 | static inline int |
| 67 | pl_clear_QuickLink_features(struct usbnet *dev, int val) |
| 68 | { |
| 69 | return pl_vendor_req(dev, 1, (u8) val, 0); |
| 70 | } |
| 71 | |
| 72 | static inline int |
| 73 | pl_set_QuickLink_features(struct usbnet *dev, int val) |
| 74 | { |
| 75 | return pl_vendor_req(dev, 3, (u8) val, 0); |
| 76 | } |
| 77 | |
| 78 | static int pl_reset(struct usbnet *dev) |
| 79 | { |
simon | 5325e92 | 2011-04-06 21:40:15 +0000 | [diff] [blame] | 80 | int status; |
| 81 | |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 82 | /* some units seem to need this reset, others reject it utterly. |
| 83 | * FIXME be more like "naplink" or windows drivers. |
| 84 | */ |
simon | 5325e92 | 2011-04-06 21:40:15 +0000 | [diff] [blame] | 85 | status = pl_set_QuickLink_features(dev, |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 86 | PL_S_EN|PL_RESET_OUT|PL_RESET_IN|PL_PEER_E); |
simon | 5325e92 | 2011-04-06 21:40:15 +0000 | [diff] [blame] | 87 | if (status != 0 && netif_msg_probe(dev)) |
| 88 | netif_dbg(dev, link, dev->net, "pl_reset --> %d\n", status); |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 89 | return 0; |
| 90 | } |
| 91 | |
| 92 | static const struct driver_info prolific_info = { |
Roman Spychała | 6f2aee0 | 2017-04-20 12:04:10 +0200 | [diff] [blame] | 93 | .description = "Prolific PL-2301/PL-2302/PL-25A1/PL-27A1", |
Arnd Bergmann | c261344 | 2011-04-01 20:12:02 -0700 | [diff] [blame] | 94 | .flags = FLAG_POINTTOPOINT | FLAG_NO_SETINT, |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 95 | /* some PL-2302 versions seem to fail usb_set_interface() */ |
| 96 | .reset = pl_reset, |
| 97 | }; |
| 98 | |
| 99 | |
| 100 | /*-------------------------------------------------------------------------*/ |
| 101 | |
| 102 | /* |
| 103 | * Proilific's name won't normally be on the cables, and |
| 104 | * may not be on the device. |
| 105 | */ |
| 106 | |
| 107 | static const struct usb_device_id products [] = { |
| 108 | |
simon | 647da40 | 2011-04-06 21:40:14 +0000 | [diff] [blame] | 109 | /* full speed cables */ |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 110 | { |
| 111 | USB_DEVICE(0x067b, 0x0000), // PL-2301 |
| 112 | .driver_info = (unsigned long) &prolific_info, |
| 113 | }, { |
| 114 | USB_DEVICE(0x067b, 0x0001), // PL-2302 |
| 115 | .driver_info = (unsigned long) &prolific_info, |
| 116 | }, |
| 117 | |
simon | 647da40 | 2011-04-06 21:40:14 +0000 | [diff] [blame] | 118 | /* high speed cables */ |
| 119 | { |
| 120 | USB_DEVICE(0x067b, 0x25a1), /* PL-25A1, no eeprom */ |
| 121 | .driver_info = (unsigned long) &prolific_info, |
| 122 | }, { |
| 123 | USB_DEVICE(0x050d, 0x258a), /* Belkin F5U258/F5U279 (PL-25A1) */ |
| 124 | .driver_info = (unsigned long) &prolific_info, |
Ben Shelton | 42c972a | 2015-02-16 13:47:06 -0600 | [diff] [blame] | 125 | }, { |
| 126 | USB_DEVICE(0x3923, 0x7825), /* National Instruments USB |
| 127 | * Host-to-Host Cable |
| 128 | */ |
| 129 | .driver_info = (unsigned long) &prolific_info, |
Roman Spychała | 6f2aee0 | 2017-04-20 12:04:10 +0200 | [diff] [blame] | 130 | |
| 131 | }, |
| 132 | |
| 133 | /* super speed cables */ |
| 134 | { |
| 135 | USB_DEVICE(0x067b, 0x27a1), /* PL-27A1, no eeprom |
| 136 | * also: goobay Active USB 3.0 |
| 137 | * Data Link, |
| 138 | * Unitek Y-3501 |
| 139 | */ |
| 140 | .driver_info = (unsigned long) &prolific_info, |
simon | 647da40 | 2011-04-06 21:40:14 +0000 | [diff] [blame] | 141 | }, |
| 142 | |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 143 | { }, // END |
| 144 | }; |
| 145 | MODULE_DEVICE_TABLE(usb, products); |
| 146 | |
| 147 | static struct usb_driver plusb_driver = { |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 148 | .name = "plusb", |
| 149 | .id_table = products, |
| 150 | .probe = usbnet_probe, |
| 151 | .disconnect = usbnet_disconnect, |
| 152 | .suspend = usbnet_suspend, |
| 153 | .resume = usbnet_resume, |
Sarah Sharp | e1f12eb | 2012-04-23 10:08:51 -0700 | [diff] [blame] | 154 | .disable_hub_initiated_lpm = 1, |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 155 | }; |
| 156 | |
Greg Kroah-Hartman | d632eb1 | 2011-11-18 09:44:20 -0800 | [diff] [blame] | 157 | module_usb_driver(plusb_driver); |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 158 | |
| 159 | MODULE_AUTHOR("David Brownell"); |
Roman Spychała | 6f2aee0 | 2017-04-20 12:04:10 +0200 | [diff] [blame] | 160 | MODULE_DESCRIPTION("Prolific PL-2301/2302/25A1/27A1 USB Host to Host Link Driver"); |
David Brownell | 090ffa9 | 2005-08-31 09:54:50 -0700 | [diff] [blame] | 161 | MODULE_LICENSE("GPL"); |