[deliverable/linux.git] / drivers / usb / net / plusb.c

/*
 * PL-2301/2302 USB host-to-host link cables
 * Copyright (C) 2000-2005 by David Brownell
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

// #define	DEBUG			// error path messages, extra info
// #define	VERBOSE			// more; success messages

#include <linux/config.h>
#ifdef	CONFIG_USB_DEBUG
#   define DEBUG
#endif
#include <linux/module.h>
#include <linux/sched.h>
#include <linux/init.h>
#include <linux/netdevice.h>
#include <linux/etherdevice.h>
#include <linux/ethtool.h>
#include <linux/workqueue.h>
#include <linux/mii.h>
#include <linux/usb.h>

#include "usbnet.h"


/*
 * Prolific PL-2301/PL-2302 driver ... http://www.prolifictech.com
 *
 * The protocol and handshaking used here should be bug-compatible
 * with the Linux 2.2 "plusb" driver, by Deti Fliegl.
 *
 * HEADS UP:  this handshaking isn't all that robust.  This driver
 * gets confused easily if you unplug one end of the cable then
 * try to connect it again; you'll need to restart both ends. The
 * "naplink" software (used by some PlayStation/2 deveopers) does
 * the handshaking much better!   Also, sometimes this hardware
 * seems to get wedged under load.  Prolific docs are weak, and
 * don't identify differences between PL2301 and PL2302, much less
 * anything to explain the different PL2302 versions observed.
 */

/*
 * Bits 0-4 can be used for software handshaking; they're set from
 * one end, cleared from the other, "read" with the interrupt byte.
 */
#define	PL_S_EN		(1<<7)		/* (feature only) suspend enable */
/* reserved bit -- rx ready (6) ? */
#define	PL_TX_READY	(1<<5)		/* (interrupt only) transmit ready */
#define	PL_RESET_OUT	(1<<4)		/* reset output pipe */
#define	PL_RESET_IN	(1<<3)		/* reset input pipe */
#define	PL_TX_C		(1<<2)		/* transmission complete */
#define	PL_TX_REQ	(1<<1)		/* transmission received */
#define	PL_PEER_E	(1<<0)		/* peer exists */

static inline int
pl_vendor_req(struct usbnet *dev, u8 req, u8 val, u8 index)
{
	return usb_control_msg(dev->udev,
		usb_rcvctrlpipe(dev->udev, 0),
		req,
		USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
		val, index,
		NULL, 0,
		USB_CTRL_GET_TIMEOUT);
}

static inline int
pl_clear_QuickLink_features(struct usbnet *dev, int val)
{
	return pl_vendor_req(dev, 1, (u8) val, 0);
}

static inline int
pl_set_QuickLink_features(struct usbnet *dev, int val)
{
	return pl_vendor_req(dev, 3, (u8) val, 0);
}

static int pl_reset(struct usbnet *dev)
{
	/* some units seem to need this reset, others reject it utterly.
	 * FIXME be more like "naplink" or windows drivers.
	 */
	(void) pl_set_QuickLink_features(dev,
		PL_S_EN|PL_RESET_OUT|PL_RESET_IN|PL_PEER_E);
	return 0;
}

static const struct driver_info	prolific_info = {
	.description =	"Prolific PL-2301/PL-2302",
	.flags =	FLAG_NO_SETINT,
		/* some PL-2302 versions seem to fail usb_set_interface() */
	.reset =	pl_reset,
};


/*-------------------------------------------------------------------------*/

/*
 * Proilific's name won't normally be on the cables, and
 * may not be on the device.
 */

static const struct usb_device_id	products [] = {

{
	USB_DEVICE(0x067b, 0x0000),	// PL-2301
	.driver_info =	(unsigned long) &prolific_info,
}, {
	USB_DEVICE(0x067b, 0x0001),	// PL-2302
	.driver_info =	(unsigned long) &prolific_info,
},

	{ },		// END
};
MODULE_DEVICE_TABLE(usb, products);

static struct usb_driver plusb_driver = {
	.owner =	THIS_MODULE,
	.name =		"plusb",
	.id_table =	products,
	.probe =	usbnet_probe,
	.disconnect =	usbnet_disconnect,
	.suspend =	usbnet_suspend,
	.resume =	usbnet_resume,
};

static int __init plusb_init(void)
{
 	return usb_register(&plusb_driver);
}
module_init(plusb_init);

static void __exit plusb_exit(void)
{
 	usb_deregister(&plusb_driver);
}
module_exit(plusb_exit);

MODULE_AUTHOR("David Brownell");
MODULE_DESCRIPTION("Prolific PL-2301/2302 USB Host to Host Link Driver");
MODULE_LICENSE("GPL");
Commit	Line	Data
090ffa9d DB	1	/*
	2	* PL-2301/2302 USB host-to-host link cables
	3	* Copyright (C) 2000-2005 by David Brownell
	4	*
	5	* This program is free software; you can redistribute it and/or modify
	6	* it under the terms of the GNU General Public License as published by
	7	* the Free Software Foundation; either version 2 of the License, or
	8	* (at your option) any later version.
	9	*
	10	* This program is distributed in the hope that it will be useful,
	11	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	13	* GNU General Public License for more details.
	14	*
	15	* You should have received a copy of the GNU General Public License
	16	* along with this program; if not, write to the Free Software
	17	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	18	*/
	19
	20	// #define DEBUG // error path messages, extra info
	21	// #define VERBOSE // more; success messages
	22
	23	#include <linux/config.h>
	24	#ifdef CONFIG_USB_DEBUG
	25	# define DEBUG
	26	#endif
	27	#include <linux/module.h>
	28	#include <linux/sched.h>
	29	#include <linux/init.h>
	30	#include <linux/netdevice.h>
	31	#include <linux/etherdevice.h>
	32	#include <linux/ethtool.h>
	33	#include <linux/workqueue.h>
	34	#include <linux/mii.h>
	35	#include <linux/usb.h>
	36
	37	#include "usbnet.h"
	38
	39
	40	/*
	41	* Prolific PL-2301/PL-2302 driver ... http://www.prolifictech.com
	42	*
	43	* The protocol and handshaking used here should be bug-compatible
	44	* with the Linux 2.2 "plusb" driver, by Deti Fliegl.
	45	*
	46	* HEADS UP: this handshaking isn't all that robust. This driver
	47	* gets confused easily if you unplug one end of the cable then
	48	* try to connect it again; you'll need to restart both ends. The
	49	* "naplink" software (used by some PlayStation/2 deveopers) does
	50	* the handshaking much better! Also, sometimes this hardware
	51	* seems to get wedged under load. Prolific docs are weak, and
	52	* don't identify differences between PL2301 and PL2302, much less
	53	* anything to explain the different PL2302 versions observed.
	54	*/
	55
	56	/*
	57	* Bits 0-4 can be used for software handshaking; they're set from
	58	* one end, cleared from the other, "read" with the interrupt byte.
	59	*/
	60	#define PL_S_EN (1<<7) /* (feature only) suspend enable */
	61	/* reserved bit -- rx ready (6) ? */
	62	#define PL_TX_READY (1<<5) /* (interrupt only) transmit ready */
	63	#define PL_RESET_OUT (1<<4) /* reset output pipe */
	64	#define PL_RESET_IN (1<<3) /* reset input pipe */
65	#define PL_TX_C (1<<2) /* transmission complete */
66	#define PL_TX_REQ (1<<1) /* transmission received */
67	#define PL_PEER_E (1<<0) /* peer exists */
68
69	static inline int
70	pl_vendor_req(struct usbnet *dev, u8 req, u8 val, u8 index)
71	{
72	return usb_control_msg(dev->udev,
73	usb_rcvctrlpipe(dev->udev, 0),
74	req,
75	USB_DIR_IN \| USB_TYPE_VENDOR \| USB_RECIP_DEVICE,
76	val, index,
77	NULL, 0,
78	USB_CTRL_GET_TIMEOUT);
79	}
80
81	static inline int
82	pl_clear_QuickLink_features(struct usbnet *dev, int val)
83	{
84	return pl_vendor_req(dev, 1, (u8) val, 0);
85	}
86
87	static inline int
88	pl_set_QuickLink_features(struct usbnet *dev, int val)
89	{
90	return pl_vendor_req(dev, 3, (u8) val, 0);
91	}
92
93	static int pl_reset(struct usbnet *dev)
94	{
95	/* some units seem to need this reset, others reject it utterly.
96	* FIXME be more like "naplink" or windows drivers.
97	*/
98	(void) pl_set_QuickLink_features(dev,
99	PL_S_EN\|PL_RESET_OUT\|PL_RESET_IN\|PL_PEER_E);
100	return 0;
101	}
102
103	static const struct driver_info prolific_info = {
104	.description = "Prolific PL-2301/PL-2302",
105	.flags = FLAG_NO_SETINT,
106	/* some PL-2302 versions seem to fail usb_set_interface() */
107	.reset = pl_reset,
108	};
109
110
111	/-------------------------------------------------------------------------/
112
113	/*
114	* Proilific's name won't normally be on the cables, and
115	* may not be on the device.
116	*/
117
118	static const struct usb_device_id products [] = {
119
120	{
121	USB_DEVICE(0x067b, 0x0000), // PL-2301
122	.driver_info = (unsigned long) &prolific_info,
123	}, {
124	USB_DEVICE(0x067b, 0x0001), // PL-2302
125	.driver_info = (unsigned long) &prolific_info,
126	},
127
128	{ }, // END
129	};
130	MODULE_DEVICE_TABLE(usb, products);
131
132	static struct usb_driver plusb_driver = {
133	.owner = THIS_MODULE,
134	.name = "plusb",
135	.id_table = products,
136	.probe = usbnet_probe,
137	.disconnect = usbnet_disconnect,
138	.suspend = usbnet_suspend,
139	.resume = usbnet_resume,
140	};
141
142	static int __init plusb_init(void)
143	{
144	return usb_register(&plusb_driver);
145	}
146	module_init(plusb_init);
147
148	static void __exit plusb_exit(void)
149	{
150	usb_deregister(&plusb_driver);
151	}
152	module_exit(plusb_exit);
153
154	MODULE_AUTHOR("David Brownell");
155	MODULE_DESCRIPTION("Prolific PL-2301/2302 USB Host to Host Link Driver");
156	MODULE_LICENSE("GPL");