cp210x.c 28.1 KB
Newer Older
L
Linus Torvalds 已提交
1
/*
2
 * Silicon Laboratories CP210x USB to RS232 serial adaptor driver
L
Linus Torvalds 已提交
3 4 5 6 7 8 9
 *
 * Copyright (C) 2005 Craig Shelley (craig@microtron.org.uk)
 *
 *	This program is free software; you can redistribute it and/or
 *	modify it under the terms of the GNU General Public License version
 *	2 as published by the Free Software Foundation.
 *
10 11 12 13
 * Support to set flow control line levels using TIOCMGET and TIOCMSET
 * thanks to Karl Hiramoto karl@hiramoto.org. RTSCTS hardware flow
 * control thanks to Munir Nassar nassarmu@real-time.com
 *
L
Linus Torvalds 已提交
14 15 16 17 18 19 20 21 22 23
 */

#include <linux/kernel.h>
#include <linux/errno.h>
#include <linux/slab.h>
#include <linux/tty.h>
#include <linux/tty_flip.h>
#include <linux/module.h>
#include <linux/moduleparam.h>
#include <linux/usb.h>
A
Alan Cox 已提交
24
#include <linux/uaccess.h>
25
#include <linux/usb/serial.h>
L
Linus Torvalds 已提交
26

27
#define DRIVER_DESC "Silicon Labs CP210x RS232 serial adaptor driver"
L
Linus Torvalds 已提交
28 29 30 31

/*
 * Function Prototypes
 */
32
static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *);
33
static void cp210x_close(struct usb_serial_port *);
J
Johan Hovold 已提交
34
static void cp210x_get_termios(struct tty_struct *, struct usb_serial_port *);
35
static void cp210x_get_termios_port(struct usb_serial_port *port,
36
	unsigned int *cflagp, unsigned int *baudp);
37 38
static void cp210x_change_speed(struct tty_struct *, struct usb_serial_port *,
							struct ktermios *);
39
static void cp210x_set_termios(struct tty_struct *, struct usb_serial_port *,
A
Alan Cox 已提交
40
							struct ktermios*);
41
static int cp210x_tiocmget(struct tty_struct *);
42 43
static int cp210x_tiocmset(struct tty_struct *, unsigned int, unsigned int);
static int cp210x_tiocmset_port(struct usb_serial_port *port,
44
		unsigned int, unsigned int);
45 46
static void cp210x_break_ctl(struct tty_struct *, int);
static int cp210x_startup(struct usb_serial *);
47
static void cp210x_release(struct usb_serial *);
A
Alan Cox 已提交
48
static void cp210x_dtr_rts(struct usb_serial_port *p, int on);
L
Linus Torvalds 已提交
49

50
static const struct usb_device_id id_table[] = {
51
	{ USB_DEVICE(0x045B, 0x0053) }, /* Renesas RX610 RX-Stick */
M
M Kondrin 已提交
52
	{ USB_DEVICE(0x0471, 0x066A) }, /* AKTAKOM ACE-1001 cable */
C
Craig Shelley 已提交
53
	{ USB_DEVICE(0x0489, 0xE000) }, /* Pirelli Broadband S.p.A, DP-L10 SIP/GSM Mobile */
54
	{ USB_DEVICE(0x0489, 0xE003) }, /* Pirelli Broadband S.p.A, DP-L10 SIP/GSM Mobile */
C
Craig Shelley 已提交
55
	{ USB_DEVICE(0x0745, 0x1000) }, /* CipherLab USB CCD Barcode Scanner 1000 */
56
	{ USB_DEVICE(0x08e6, 0x5501) }, /* Gemalto Prox-PU/CU contactless smartcard reader */
C
Craig Shelley 已提交
57
	{ USB_DEVICE(0x08FD, 0x000A) }, /* Digianswer A/S , ZigBee/802.15.4 MAC Device */
58 59
	{ USB_DEVICE(0x0BED, 0x1100) }, /* MEI (TM) Cashflow-SC Bill/Voucher Acceptor */
	{ USB_DEVICE(0x0BED, 0x1101) }, /* MEI series 2000 Combo Acceptor */
60
	{ USB_DEVICE(0x0FCF, 0x1003) }, /* Dynastream ANT development board */
61
	{ USB_DEVICE(0x0FCF, 0x1004) }, /* Dynastream ANT2USB */
C
Craig Shelley 已提交
62
	{ USB_DEVICE(0x0FCF, 0x1006) }, /* Dynastream ANT development board */
63
	{ USB_DEVICE(0x10A6, 0xAA26) }, /* Knock-off DCU-11 cable */
64 65
	{ USB_DEVICE(0x10AB, 0x10C5) }, /* Siemens MC60 Cable */
	{ USB_DEVICE(0x10B5, 0xAC70) }, /* Nokia CA-42 USB */
C
Craig Shelley 已提交
66
	{ USB_DEVICE(0x10C4, 0x0F91) }, /* Vstabi */
67 68
	{ USB_DEVICE(0x10C4, 0x1101) }, /* Arkham Technology DS101 Bus Monitor */
	{ USB_DEVICE(0x10C4, 0x1601) }, /* Arkham Technology DS101 Adapter */
C
Craig Shelley 已提交
69
	{ USB_DEVICE(0x10C4, 0x800A) }, /* SPORTident BSM7-D-USB main station */
70
	{ USB_DEVICE(0x10C4, 0x803B) }, /* Pololu USB-serial converter */
71 72
	{ USB_DEVICE(0x10C4, 0x8044) }, /* Cygnal Debug Adapter */
	{ USB_DEVICE(0x10C4, 0x804E) }, /* Software Bisque Paramount ME build-in converter */
C
Craig Shelley 已提交
73
	{ USB_DEVICE(0x10C4, 0x8053) }, /* Enfora EDG1228 */
74
	{ USB_DEVICE(0x10C4, 0x8054) }, /* Enfora GSM2228 */
V
Vitja Makarov 已提交
75
	{ USB_DEVICE(0x10C4, 0x8066) }, /* Argussoft In-System Programmer */
76
	{ USB_DEVICE(0x10C4, 0x806F) }, /* IMS USB to RS422 Converter Cable */
77
	{ USB_DEVICE(0x10C4, 0x807A) }, /* Crumb128 board */
78
	{ USB_DEVICE(0x10C4, 0x80C4) }, /* Cygnal Integrated Products, Inc., Optris infrared thermometer */
79
	{ USB_DEVICE(0x10C4, 0x80CA) }, /* Degree Controls Inc */
C
Craig Shelley 已提交
80
	{ USB_DEVICE(0x10C4, 0x80DD) }, /* Tracient RFID */
81
	{ USB_DEVICE(0x10C4, 0x80F6) }, /* Suunto sports instrument */
82
	{ USB_DEVICE(0x10C4, 0x8115) }, /* Arygon NFC/Mifare Reader */
83
	{ USB_DEVICE(0x10C4, 0x813D) }, /* Burnside Telecom Deskmobile */
C
Craig Shelley 已提交
84
	{ USB_DEVICE(0x10C4, 0x813F) }, /* Tams Master Easy Control */
85 86
	{ USB_DEVICE(0x10C4, 0x814A) }, /* West Mountain Radio RIGblaster P&P */
	{ USB_DEVICE(0x10C4, 0x814B) }, /* West Mountain Radio RIGtalk */
87
	{ USB_DEVICE(0x10C4, 0x8156) }, /* B&G H3000 link cable */
88
	{ USB_DEVICE(0x10C4, 0x815E) }, /* Helicomm IP-Link 1220-DVM */
C
Craig Shelley 已提交
89
	{ USB_DEVICE(0x10C4, 0x815F) }, /* Timewave HamLinkUSB */
90
	{ USB_DEVICE(0x10C4, 0x818B) }, /* AVIT Research USB to TTL */
91
	{ USB_DEVICE(0x10C4, 0x819F) }, /* MJS USB Toslink Switcher */
92
	{ USB_DEVICE(0x10C4, 0x81A6) }, /* ThinkOptics WavIt */
93
	{ USB_DEVICE(0x10C4, 0x81A9) }, /* Multiplex RC Interface */
C
Craig Shelley 已提交
94
	{ USB_DEVICE(0x10C4, 0x81AC) }, /* MSD Dash Hawk */
95
	{ USB_DEVICE(0x10C4, 0x81AD) }, /* INSYS USB Modem */
96 97
	{ USB_DEVICE(0x10C4, 0x81C8) }, /* Lipowsky Industrie Elektronik GmbH, Baby-JTAG */
	{ USB_DEVICE(0x10C4, 0x81E2) }, /* Lipowsky Industrie Elektronik GmbH, Baby-LIN */
J
Jeff Long 已提交
98
	{ USB_DEVICE(0x10C4, 0x81E7) }, /* Aerocomm Radio */
99
	{ USB_DEVICE(0x10C4, 0x81E8) }, /* Zephyr Bioharness */
C
Craig Shelley 已提交
100
	{ USB_DEVICE(0x10C4, 0x81F2) }, /* C1007 HF band RFID controller */
101
	{ USB_DEVICE(0x10C4, 0x8218) }, /* Lipowsky Industrie Elektronik GmbH, HARP-1 */
T
Tomasz K 已提交
102
	{ USB_DEVICE(0x10C4, 0x822B) }, /* Modem EDGE(GSM) Comander 2 */
L
Lucas De Marchi 已提交
103
	{ USB_DEVICE(0x10C4, 0x826B) }, /* Cygnal Integrated Products, Inc., Fasttrax GPS demonstration module */
104
	{ USB_DEVICE(0x10C4, 0x8293) }, /* Telegesis ETRX2USB */
C
Craig Shelley 已提交
105
	{ USB_DEVICE(0x10C4, 0x82F9) }, /* Procyon AVS */
106
	{ USB_DEVICE(0x10C4, 0x8341) }, /* Siemens MC35PU GPRS Modem */
C
Craig Shelley 已提交
107
	{ USB_DEVICE(0x10C4, 0x8382) }, /* Cygnal Integrated Products, Inc. */
108
	{ USB_DEVICE(0x10C4, 0x83A8) }, /* Amber Wireless AMB2560 */
C
Craig Shelley 已提交
109
	{ USB_DEVICE(0x10C4, 0x83D8) }, /* DekTec DTA Plus VHF/UHF Booster/Attenuator */
C
Craig Shelley 已提交
110
	{ USB_DEVICE(0x10C4, 0x8411) }, /* Kyocera GPS Module */
C
Craig Shelley 已提交
111
	{ USB_DEVICE(0x10C4, 0x8418) }, /* IRZ Automation Teleport SG-10 GSM/GPRS Modem */
A
Alex Stephens 已提交
112
	{ USB_DEVICE(0x10C4, 0x846E) }, /* BEI USB Sensor Interface (VCP) */
C
Craig Shelley 已提交
113
	{ USB_DEVICE(0x10C4, 0x8477) }, /* Balluff RFID */
114 115
	{ USB_DEVICE(0x10C4, 0x85EA) }, /* AC-Services IBUS-IF */
	{ USB_DEVICE(0x10C4, 0x85EB) }, /* AC-Services CIS-IBUS */
116
	{ USB_DEVICE(0x10C4, 0x85F8) }, /* Virtenio Preon32 */
117 118
	{ USB_DEVICE(0x10C4, 0x8664) }, /* AC-Services CAN-IF */
	{ USB_DEVICE(0x10C4, 0x8665) }, /* AC-Services OBD-IF */
119
	{ USB_DEVICE(0x10C4, 0xEA60) }, /* Silicon Labs factory default */
120
	{ USB_DEVICE(0x10C4, 0xEA61) }, /* Silicon Labs factory default */
121 122
	{ USB_DEVICE(0x10C4, 0xEA70) }, /* Silicon Labs factory default */
	{ USB_DEVICE(0x10C4, 0xEA80) }, /* Silicon Labs factory default */
123
	{ USB_DEVICE(0x10C4, 0xEA71) }, /* Infinity GPS-MIC-1 Radio Monophone */
C
Craig Shelley 已提交
124 125 126 127
	{ USB_DEVICE(0x10C4, 0xF001) }, /* Elan Digital Systems USBscope50 */
	{ USB_DEVICE(0x10C4, 0xF002) }, /* Elan Digital Systems USBwave12 */
	{ USB_DEVICE(0x10C4, 0xF003) }, /* Elan Digital Systems USBpulse100 */
	{ USB_DEVICE(0x10C4, 0xF004) }, /* Elan Digital Systems USBcount50 */
128
	{ USB_DEVICE(0x10C5, 0xEA61) }, /* Silicon Labs MobiData GPRS USB Modem */
C
Craig Shelley 已提交
129
	{ USB_DEVICE(0x10CE, 0xEA6A) }, /* Silicon Labs MobiData GPRS USB Modem 100EU */
130
	{ USB_DEVICE(0x13AD, 0x9999) }, /* Baltech card reader */
C
Craig Shelley 已提交
131
	{ USB_DEVICE(0x1555, 0x0004) }, /* Owen AC4 USB-RS485 Converter */
C
Craig Shelley 已提交
132 133
	{ USB_DEVICE(0x166A, 0x0201) }, /* Clipsal 5500PACA C-Bus Pascal Automation Controller */
	{ USB_DEVICE(0x166A, 0x0301) }, /* Clipsal 5800PC C-Bus Wireless PC Interface */
C
Craig Shelley 已提交
134
	{ USB_DEVICE(0x166A, 0x0303) }, /* Clipsal 5500PCU C-Bus USB interface */
C
Craig Shelley 已提交
135 136 137 138
	{ USB_DEVICE(0x166A, 0x0304) }, /* Clipsal 5000CT2 C-Bus Black and White Touchscreen */
	{ USB_DEVICE(0x166A, 0x0305) }, /* Clipsal C-5000CT2 C-Bus Spectrum Colour Touchscreen */
	{ USB_DEVICE(0x166A, 0x0401) }, /* Clipsal L51xx C-Bus Architectural Dimmer */
	{ USB_DEVICE(0x166A, 0x0101) }, /* Clipsal 5560884 C-Bus Multi-room Audio Matrix Switcher */
139
	{ USB_DEVICE(0x16D6, 0x0001) }, /* Jablotron serial interface */
140 141 142 143
	{ USB_DEVICE(0x16DC, 0x0010) }, /* W-IE-NE-R Plein & Baus GmbH PL512 Power Supply */
	{ USB_DEVICE(0x16DC, 0x0011) }, /* W-IE-NE-R Plein & Baus GmbH RCM Remote Control for MARATON Power Supply */
	{ USB_DEVICE(0x16DC, 0x0012) }, /* W-IE-NE-R Plein & Baus GmbH MPOD Multi Channel Power Supply */
	{ USB_DEVICE(0x16DC, 0x0015) }, /* W-IE-NE-R Plein & Baus GmbH CML Control, Monitoring and Data Logger */
144 145
	{ USB_DEVICE(0x17A8, 0x0001) }, /* Kamstrup Optical Eye/3-wire */
	{ USB_DEVICE(0x17A8, 0x0005) }, /* Kamstrup M-Bus Master MultiPort 250D */
C
Craig Shelley 已提交
146 147 148
	{ USB_DEVICE(0x17F4, 0xAAAA) }, /* Wavesense Jazz blood glucose meter */
	{ USB_DEVICE(0x1843, 0x0200) }, /* Vaisala USB Instrument Cable */
	{ USB_DEVICE(0x18EF, 0xE00F) }, /* ELV USB-I2C-Interface */
149
	{ USB_DEVICE(0x1BE3, 0x07A6) }, /* WAGO 750-923 USB Service Cable */
C
Craig Shelley 已提交
150 151
	{ USB_DEVICE(0x1E29, 0x0102) }, /* Festo CPX-USB */
	{ USB_DEVICE(0x1E29, 0x0501) }, /* Festo CMSP */
152
	{ USB_DEVICE(0x3195, 0xF190) }, /* Link Instruments MSO-19 */
C
Craig Shelley 已提交
153 154
	{ USB_DEVICE(0x3195, 0xF280) }, /* Link Instruments MSO-28 */
	{ USB_DEVICE(0x3195, 0xF281) }, /* Link Instruments MSO-28 */
C
Craig Shelley 已提交
155
	{ USB_DEVICE(0x413C, 0x9500) }, /* DW700 GPS USB interface */
156
	{ } /* Terminating Entry */
L
Linus Torvalds 已提交
157 158
};

A
Alan Cox 已提交
159
MODULE_DEVICE_TABLE(usb, id_table);
L
Linus Torvalds 已提交
160

161
struct cp210x_serial_private {
162 163 164
	__u8			bInterfaceNumber;
};

165
static struct usb_serial_driver cp210x_device = {
166 167
	.driver = {
		.owner =	THIS_MODULE,
J
Johan Hovold 已提交
168
		.name =		"cp210x",
169
	},
L
Linus Torvalds 已提交
170 171
	.id_table		= id_table,
	.num_ports		= 1,
172
	.bulk_in_size		= 256,
173
	.bulk_out_size		= 256,
174 175 176 177
	.open			= cp210x_open,
	.close			= cp210x_close,
	.break_ctl		= cp210x_break_ctl,
	.set_termios		= cp210x_set_termios,
J
Johan Hovold 已提交
178
	.tiocmget		= cp210x_tiocmget,
179 180
	.tiocmset		= cp210x_tiocmset,
	.attach			= cp210x_startup,
181
	.release		= cp210x_release,
182
	.dtr_rts		= cp210x_dtr_rts
L
Linus Torvalds 已提交
183 184
};

185 186 187 188
static struct usb_serial_driver * const serial_drivers[] = {
	&cp210x_device, NULL
};

189
/* Config request types */
190 191 192 193
#define REQTYPE_HOST_TO_INTERFACE	0x41
#define REQTYPE_INTERFACE_TO_HOST	0xc1
#define REQTYPE_HOST_TO_DEVICE	0x40
#define REQTYPE_DEVICE_TO_HOST	0xc0
L
Linus Torvalds 已提交
194

195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219
/* Config request codes */
#define CP210X_IFC_ENABLE	0x00
#define CP210X_SET_BAUDDIV	0x01
#define CP210X_GET_BAUDDIV	0x02
#define CP210X_SET_LINE_CTL	0x03
#define CP210X_GET_LINE_CTL	0x04
#define CP210X_SET_BREAK	0x05
#define CP210X_IMM_CHAR		0x06
#define CP210X_SET_MHS		0x07
#define CP210X_GET_MDMSTS	0x08
#define CP210X_SET_XON		0x09
#define CP210X_SET_XOFF		0x0A
#define CP210X_SET_EVENTMASK	0x0B
#define CP210X_GET_EVENTMASK	0x0C
#define CP210X_SET_CHAR		0x0D
#define CP210X_GET_CHARS	0x0E
#define CP210X_GET_PROPS	0x0F
#define CP210X_GET_COMM_STATUS	0x10
#define CP210X_RESET		0x11
#define CP210X_PURGE		0x12
#define CP210X_SET_FLOW		0x13
#define CP210X_GET_FLOW		0x14
#define CP210X_EMBED_EVENTS	0x15
#define CP210X_GET_EVENTSTATE	0x16
#define CP210X_SET_CHARS	0x19
220 221
#define CP210X_GET_BAUDRATE	0x1D
#define CP210X_SET_BAUDRATE	0x1E
222 223

/* CP210X_IFC_ENABLE */
L
Linus Torvalds 已提交
224 225 226
#define UART_ENABLE		0x0001
#define UART_DISABLE		0x0000

227
/* CP210X_(SET|GET)_BAUDDIV */
L
Linus Torvalds 已提交
228 229
#define BAUD_RATE_GEN_FREQ	0x384000

230
/* CP210X_(SET|GET)_LINE_CTL */
L
Linus Torvalds 已提交
231
#define BITS_DATA_MASK		0X0f00
232
#define BITS_DATA_5		0X0500
L
Linus Torvalds 已提交
233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248
#define BITS_DATA_6		0X0600
#define BITS_DATA_7		0X0700
#define BITS_DATA_8		0X0800
#define BITS_DATA_9		0X0900

#define BITS_PARITY_MASK	0x00f0
#define BITS_PARITY_NONE	0x0000
#define BITS_PARITY_ODD		0x0010
#define BITS_PARITY_EVEN	0x0020
#define BITS_PARITY_MARK	0x0030
#define BITS_PARITY_SPACE	0x0040

#define BITS_STOP_MASK		0x000f
#define BITS_STOP_1		0x0000
#define BITS_STOP_1_5		0x0001
#define BITS_STOP_2		0x0002
249

250
/* CP210X_SET_BREAK */
C
Craig Shelley 已提交
251 252
#define BREAK_ON		0x0001
#define BREAK_OFF		0x0000
L
Linus Torvalds 已提交
253

254
/* CP210X_(SET_MHS|GET_MDMSTS) */
255 256 257 258 259 260 261 262
#define CONTROL_DTR		0x0001
#define CONTROL_RTS		0x0002
#define CONTROL_CTS		0x0010
#define CONTROL_DSR		0x0020
#define CONTROL_RING		0x0040
#define CONTROL_DCD		0x0080
#define CONTROL_WRITE_DTR	0x0100
#define CONTROL_WRITE_RTS	0x0200
L
Linus Torvalds 已提交
263

264
/*
265 266
 * cp210x_get_config
 * Reads from the CP210x configuration registers
267 268 269 270
 * 'size' is specified in bytes.
 * 'data' is a pointer to a pre-allocated array of integers large
 * enough to hold 'size' bytes (with 4 bytes to each integer)
 */
271
static int cp210x_get_config(struct usb_serial_port *port, u8 request,
272
		unsigned int *data, int size)
L
Linus Torvalds 已提交
273 274
{
	struct usb_serial *serial = port->serial;
275
	struct cp210x_serial_private *spriv = usb_get_serial_data(serial);
276
	__le32 *buf;
277 278 279
	int result, i, length;

	/* Number of integers required to contain the array */
J
Johan Hovold 已提交
280
	length = (((size - 1) | 3) + 1) / 4;
281

282
	buf = kcalloc(length, sizeof(__le32), GFP_KERNEL);
283
	if (!buf) {
284
		dev_err(&port->dev, "%s - out of memory.\n", __func__);
285 286
		return -ENOMEM;
	}
L
Linus Torvalds 已提交
287

288
	/* Issue the request, attempting to read 'size' bytes */
A
Alan Cox 已提交
289
	result = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
290
				request, REQTYPE_INTERFACE_TO_HOST, 0x0000,
291
				spriv->bInterfaceNumber, buf, size,
292
				USB_CTRL_GET_TIMEOUT);
L
Linus Torvalds 已提交
293

294
	/* Convert data into an array of integers */
A
Alan Cox 已提交
295
	for (i = 0; i < length; i++)
296
		data[i] = le32_to_cpu(buf[i]);
L
Linus Torvalds 已提交
297

298
	kfree(buf);
L
Linus Torvalds 已提交
299

300
	if (result != size) {
301 302
		dev_dbg(&port->dev, "%s - Unable to send config request, request=0x%x size=%d result=%d\n",
			__func__, request, size, result);
303 304 305 306
		if (result > 0)
			result = -EPROTO;

		return result;
307
	}
L
Linus Torvalds 已提交
308

309
	return 0;
L
Linus Torvalds 已提交
310 311
}

312
/*
313 314
 * cp210x_set_config
 * Writes to the CP210x configuration registers
315 316 317
 * Values less than 16 bits wide are sent directly
 * 'size' is specified in bytes.
 */
318
static int cp210x_set_config(struct usb_serial_port *port, u8 request,
319
		unsigned int *data, int size)
L
Linus Torvalds 已提交
320 321
{
	struct usb_serial *serial = port->serial;
322
	struct cp210x_serial_private *spriv = usb_get_serial_data(serial);
323
	__le32 *buf;
324
	int result, i, length;
L
Linus Torvalds 已提交
325

326
	/* Number of integers required to contain the array */
J
Johan Hovold 已提交
327
	length = (((size - 1) | 3) + 1) / 4;
328

329
	buf = kmalloc(length * sizeof(__le32), GFP_KERNEL);
330
	if (!buf) {
J
Johan Hovold 已提交
331
		dev_err(&port->dev, "%s - out of memory.\n", __func__);
332 333 334 335 336 337 338 339
		return -ENOMEM;
	}

	/* Array of integers into bytes */
	for (i = 0; i < length; i++)
		buf[i] = cpu_to_le32(data[i]);

	if (size > 2) {
A
Alan Cox 已提交
340
		result = usb_control_msg(serial->dev,
341
				usb_sndctrlpipe(serial->dev, 0),
342
				request, REQTYPE_HOST_TO_INTERFACE, 0x0000,
343
				spriv->bInterfaceNumber, buf, size,
344
				USB_CTRL_SET_TIMEOUT);
345
	} else {
A
Alan Cox 已提交
346
		result = usb_control_msg(serial->dev,
347
				usb_sndctrlpipe(serial->dev, 0),
348
				request, REQTYPE_HOST_TO_INTERFACE, data[0],
349
				spriv->bInterfaceNumber, NULL, 0,
350
				USB_CTRL_SET_TIMEOUT);
L
Linus Torvalds 已提交
351 352
	}

353 354 355
	kfree(buf);

	if ((size > 2 && result != size) || result < 0) {
356 357
		dev_dbg(&port->dev, "%s - Unable to send request, request=0x%x size=%d result=%d\n",
			__func__, request, size, result);
358 359 360 361
		if (result > 0)
			result = -EPROTO;

		return result;
362
	}
L
Linus Torvalds 已提交
363 364 365 366

	return 0;
}

367
/*
368 369
 * cp210x_set_config_single
 * Convenience function for calling cp210x_set_config on single data values
370 371
 * without requiring an integer pointer
 */
372
static inline int cp210x_set_config_single(struct usb_serial_port *port,
373 374
		u8 request, unsigned int data)
{
375
	return cp210x_set_config(port, request, &data, 2);
376 377
}

378
/*
379
 * cp210x_quantise_baudrate
380 381
 * Quantises the baud rate as per AN205 Table 1
 */
J
Johan Hovold 已提交
382 383
static unsigned int cp210x_quantise_baudrate(unsigned int baud)
{
384 385
	if (baud <= 300)
		baud = 300;
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412
	else if (baud <= 600)      baud = 600;
	else if (baud <= 1200)     baud = 1200;
	else if (baud <= 1800)     baud = 1800;
	else if (baud <= 2400)     baud = 2400;
	else if (baud <= 4000)     baud = 4000;
	else if (baud <= 4803)     baud = 4800;
	else if (baud <= 7207)     baud = 7200;
	else if (baud <= 9612)     baud = 9600;
	else if (baud <= 14428)    baud = 14400;
	else if (baud <= 16062)    baud = 16000;
	else if (baud <= 19250)    baud = 19200;
	else if (baud <= 28912)    baud = 28800;
	else if (baud <= 38601)    baud = 38400;
	else if (baud <= 51558)    baud = 51200;
	else if (baud <= 56280)    baud = 56000;
	else if (baud <= 58053)    baud = 57600;
	else if (baud <= 64111)    baud = 64000;
	else if (baud <= 77608)    baud = 76800;
	else if (baud <= 117028)   baud = 115200;
	else if (baud <= 129347)   baud = 128000;
	else if (baud <= 156868)   baud = 153600;
	else if (baud <= 237832)   baud = 230400;
	else if (baud <= 254234)   baud = 250000;
	else if (baud <= 273066)   baud = 256000;
	else if (baud <= 491520)   baud = 460800;
	else if (baud <= 567138)   baud = 500000;
	else if (baud <= 670254)   baud = 576000;
413 414 415 416
	else if (baud < 1000000)
		baud = 921600;
	else if (baud > 2000000)
		baud = 2000000;
417 418 419
	return baud;
}

420
static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *port)
L
Linus Torvalds 已提交
421 422 423
{
	int result;

424 425 426 427 428
	result = cp210x_set_config_single(port, CP210X_IFC_ENABLE,
								UART_ENABLE);
	if (result) {
		dev_err(&port->dev, "%s - Unable to enable UART\n", __func__);
		return result;
L
Linus Torvalds 已提交
429 430
	}

431
	/* Configure the termios structure */
432
	cp210x_get_termios(tty, port);
433

434 435 436 437
	/* The baud rate must be initialised on cp2104 */
	if (tty)
		cp210x_change_speed(tty, port, NULL);

438
	return usb_serial_generic_open(tty, port);
L
Linus Torvalds 已提交
439 440
}

441
static void cp210x_close(struct usb_serial_port *port)
L
Linus Torvalds 已提交
442
{
443
	usb_serial_generic_close(port);
L
Linus Torvalds 已提交
444

445 446
	mutex_lock(&port->serial->disc_mutex);
	if (!port->serial->disconnected)
447
		cp210x_set_config_single(port, CP210X_IFC_ENABLE, UART_DISABLE);
448
	mutex_unlock(&port->serial->disc_mutex);
L
Linus Torvalds 已提交
449 450
}

451
/*
452
 * cp210x_get_termios
453 454 455 456
 * Reads the baud rate, data bits, parity, stop bits and flow control mode
 * from the device, corrects any unsupported values, and configures the
 * termios structure to reflect the state of the device
 */
457
static void cp210x_get_termios(struct tty_struct *tty,
458 459 460 461 462
	struct usb_serial_port *port)
{
	unsigned int baud;

	if (tty) {
463
		cp210x_get_termios_port(tty->driver_data,
464
			&tty->termios.c_cflag, &baud);
465
		tty_encode_baud_rate(tty, baud, baud);
J
Johan Hovold 已提交
466
	} else {
467 468
		unsigned int cflag;
		cflag = 0;
469
		cp210x_get_termios_port(port, &cflag, &baud);
470 471 472 473
	}
}

/*
474 475
 * cp210x_get_termios_port
 * This is the heart of cp210x_get_termios which always uses a &usb_serial_port.
476
 */
477
static void cp210x_get_termios_port(struct usb_serial_port *port,
478
	unsigned int *cflagp, unsigned int *baudp)
L
Linus Torvalds 已提交
479
{
480
	struct device *dev = &port->dev;
481
	unsigned int cflag, modem_ctl[4];
482 483
	unsigned int baud;
	unsigned int bits;
L
Linus Torvalds 已提交
484

485
	cp210x_get_config(port, CP210X_GET_BAUDRATE, &baud, 4);
L
Linus Torvalds 已提交
486

487
	dev_dbg(dev, "%s - baud rate = %d\n", __func__, baud);
488
	*baudp = baud;
A
Alan Cox 已提交
489

490
	cflag = *cflagp;
L
Linus Torvalds 已提交
491

492
	cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
493
	cflag &= ~CSIZE;
A
Alan Cox 已提交
494 495
	switch (bits & BITS_DATA_MASK) {
	case BITS_DATA_5:
496
		dev_dbg(dev, "%s - data bits = 5\n", __func__);
A
Alan Cox 已提交
497 498 499
		cflag |= CS5;
		break;
	case BITS_DATA_6:
500
		dev_dbg(dev, "%s - data bits = 6\n", __func__);
A
Alan Cox 已提交
501 502 503
		cflag |= CS6;
		break;
	case BITS_DATA_7:
504
		dev_dbg(dev, "%s - data bits = 7\n", __func__);
A
Alan Cox 已提交
505 506 507
		cflag |= CS7;
		break;
	case BITS_DATA_8:
508
		dev_dbg(dev, "%s - data bits = 8\n", __func__);
A
Alan Cox 已提交
509 510 511
		cflag |= CS8;
		break;
	case BITS_DATA_9:
512
		dev_dbg(dev, "%s - data bits = 9 (not supported, using 8 data bits)\n", __func__);
A
Alan Cox 已提交
513 514 515
		cflag |= CS8;
		bits &= ~BITS_DATA_MASK;
		bits |= BITS_DATA_8;
516
		cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
A
Alan Cox 已提交
517 518
		break;
	default:
519
		dev_dbg(dev, "%s - Unknown number of data bits, using 8\n", __func__);
A
Alan Cox 已提交
520 521 522
		cflag |= CS8;
		bits &= ~BITS_DATA_MASK;
		bits |= BITS_DATA_8;
523
		cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
A
Alan Cox 已提交
524
		break;
L
Linus Torvalds 已提交
525 526
	}

A
Alan Cox 已提交
527 528
	switch (bits & BITS_PARITY_MASK) {
	case BITS_PARITY_NONE:
529
		dev_dbg(dev, "%s - parity = NONE\n", __func__);
A
Alan Cox 已提交
530 531 532
		cflag &= ~PARENB;
		break;
	case BITS_PARITY_ODD:
533
		dev_dbg(dev, "%s - parity = ODD\n", __func__);
A
Alan Cox 已提交
534 535 536
		cflag |= (PARENB|PARODD);
		break;
	case BITS_PARITY_EVEN:
537
		dev_dbg(dev, "%s - parity = EVEN\n", __func__);
A
Alan Cox 已提交
538 539 540 541
		cflag &= ~PARODD;
		cflag |= PARENB;
		break;
	case BITS_PARITY_MARK:
542
		dev_dbg(dev, "%s - parity = MARK\n", __func__);
543
		cflag |= (PARENB|PARODD|CMSPAR);
A
Alan Cox 已提交
544 545
		break;
	case BITS_PARITY_SPACE:
546
		dev_dbg(dev, "%s - parity = SPACE\n", __func__);
547 548
		cflag &= ~PARODD;
		cflag |= (PARENB|CMSPAR);
A
Alan Cox 已提交
549 550
		break;
	default:
551
		dev_dbg(dev, "%s - Unknown parity mode, disabling parity\n", __func__);
A
Alan Cox 已提交
552 553
		cflag &= ~PARENB;
		bits &= ~BITS_PARITY_MASK;
554
		cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
A
Alan Cox 已提交
555
		break;
L
Linus Torvalds 已提交
556 557 558
	}

	cflag &= ~CSTOPB;
A
Alan Cox 已提交
559 560
	switch (bits & BITS_STOP_MASK) {
	case BITS_STOP_1:
561
		dev_dbg(dev, "%s - stop bits = 1\n", __func__);
A
Alan Cox 已提交
562 563
		break;
	case BITS_STOP_1_5:
564
		dev_dbg(dev, "%s - stop bits = 1.5 (not supported, using 1 stop bit)\n", __func__);
A
Alan Cox 已提交
565
		bits &= ~BITS_STOP_MASK;
566
		cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
A
Alan Cox 已提交
567 568
		break;
	case BITS_STOP_2:
569
		dev_dbg(dev, "%s - stop bits = 2\n", __func__);
A
Alan Cox 已提交
570 571 572
		cflag |= CSTOPB;
		break;
	default:
573
		dev_dbg(dev, "%s - Unknown number of stop bits, using 1 stop bit\n", __func__);
A
Alan Cox 已提交
574
		bits &= ~BITS_STOP_MASK;
575
		cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
A
Alan Cox 已提交
576
		break;
L
Linus Torvalds 已提交
577 578
	}

579
	cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
580
	if (modem_ctl[0] & 0x0008) {
581
		dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
582 583
		cflag |= CRTSCTS;
	} else {
584
		dev_dbg(dev, "%s - flow control = NONE\n", __func__);
585 586 587
		cflag &= ~CRTSCTS;
	}

588
	*cflagp = cflag;
L
Linus Torvalds 已提交
589 590
}

591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621
/*
 * CP2101 supports the following baud rates:
 *
 *	300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 14400, 19200, 28800,
 *	38400, 56000, 57600, 115200, 128000, 230400, 460800, 921600
 *
 * CP2102 and CP2103 support the following additional rates:
 *
 *	4000, 16000, 51200, 64000, 76800, 153600, 250000, 256000, 500000,
 *	576000
 *
 * The device will map a requested rate to a supported one, but the result
 * of requests for rates greater than 1053257 is undefined (see AN205).
 *
 * CP2104, CP2105 and CP2110 support most rates up to 2M, 921k and 1M baud,
 * respectively, with an error less than 1%. The actual rates are determined
 * by
 *
 *	div = round(freq / (2 x prescale x request))
 *	actual = freq / (2 x prescale x div)
 *
 * For CP2104 and CP2105 freq is 48Mhz and prescale is 4 for request <= 365bps
 * or 1 otherwise.
 * For CP2110 freq is 24Mhz and prescale is 4 for request <= 300bps or 1
 * otherwise.
 */
static void cp210x_change_speed(struct tty_struct *tty,
		struct usb_serial_port *port, struct ktermios *old_termios)
{
	u32 baud;

622
	baud = tty->termios.c_ospeed;
623

624 625
	/* This maps the requested rate to a rate valid on cp2102 or cp2103,
	 * or to an arbitrary rate in [1M,2M].
626 627 628 629 630
	 *
	 * NOTE: B0 is not implemented.
	 */
	baud = cp210x_quantise_baudrate(baud);

631
	dev_dbg(&port->dev, "%s - setting baud rate to %u\n", __func__, baud);
632 633 634 635 636 637 638 639 640 641 642 643
	if (cp210x_set_config(port, CP210X_SET_BAUDRATE, &baud,
							sizeof(baud))) {
		dev_warn(&port->dev, "failed to set baud rate to %u\n", baud);
		if (old_termios)
			baud = old_termios->c_ospeed;
		else
			baud = 9600;
	}

	tty_encode_baud_rate(tty, baud, baud);
}

644
static void cp210x_set_termios(struct tty_struct *tty,
A
Alan Cox 已提交
645
		struct usb_serial_port *port, struct ktermios *old_termios)
L
Linus Torvalds 已提交
646
{
647
	struct device *dev = &port->dev;
A
Alan Cox 已提交
648
	unsigned int cflag, old_cflag;
649
	unsigned int bits;
650
	unsigned int modem_ctl[4];
L
Linus Torvalds 已提交
651

652
	dev_dbg(dev, "%s - port %d\n", __func__, port->number);
L
Linus Torvalds 已提交
653

A
Alan Cox 已提交
654
	if (!tty)
L
Linus Torvalds 已提交
655
		return;
A
Alan Cox 已提交
656

657
	cflag = tty->termios.c_cflag;
658
	old_cflag = old_termios->c_cflag;
659

660
	if (tty->termios.c_ospeed != old_termios->c_ospeed)
661
		cp210x_change_speed(tty, port, old_termios);
L
Linus Torvalds 已提交
662

663
	/* If the number of data bits is to be updated */
L
Linus Torvalds 已提交
664
	if ((cflag & CSIZE) != (old_cflag & CSIZE)) {
665
		cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
666 667
		bits &= ~BITS_DATA_MASK;
		switch (cflag & CSIZE) {
A
Alan Cox 已提交
668 669
		case CS5:
			bits |= BITS_DATA_5;
670
			dev_dbg(dev, "%s - data bits = 5\n", __func__);
A
Alan Cox 已提交
671 672 673
			break;
		case CS6:
			bits |= BITS_DATA_6;
674
			dev_dbg(dev, "%s - data bits = 6\n", __func__);
A
Alan Cox 已提交
675 676 677
			break;
		case CS7:
			bits |= BITS_DATA_7;
678
			dev_dbg(dev, "%s - data bits = 7\n", __func__);
A
Alan Cox 已提交
679 680 681
			break;
		case CS8:
			bits |= BITS_DATA_8;
682
			dev_dbg(dev, "%s - data bits = 8\n", __func__);
A
Alan Cox 已提交
683 684 685
			break;
		/*case CS9:
			bits |= BITS_DATA_9;
686
			dev_dbg(dev, "%s - data bits = 9\n", __func__);
A
Alan Cox 已提交
687 688
			break;*/
		default:
689
			dev_dbg(dev, "cp210x driver does not support the number of bits requested, using 8 bit mode\n");
J
Johan Hovold 已提交
690 691
			bits |= BITS_DATA_8;
			break;
L
Linus Torvalds 已提交
692
		}
693
		if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
694
			dev_dbg(dev, "Number of data bits requested not supported by device\n");
L
Linus Torvalds 已提交
695 696
	}

697 698
	if ((cflag     & (PARENB|PARODD|CMSPAR)) !=
	    (old_cflag & (PARENB|PARODD|CMSPAR))) {
699
		cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
700 701
		bits &= ~BITS_PARITY_MASK;
		if (cflag & PARENB) {
702
			if (cflag & CMSPAR) {
703 704 705 706 707 708 709
				if (cflag & PARODD) {
					bits |= BITS_PARITY_MARK;
					dev_dbg(dev, "%s - parity = MARK\n", __func__);
				} else {
					bits |= BITS_PARITY_SPACE;
					dev_dbg(dev, "%s - parity = SPACE\n", __func__);
				}
L
Linus Torvalds 已提交
710
			} else {
711 712 713 714 715 716 717
				if (cflag & PARODD) {
					bits |= BITS_PARITY_ODD;
					dev_dbg(dev, "%s - parity = ODD\n", __func__);
				} else {
					bits |= BITS_PARITY_EVEN;
					dev_dbg(dev, "%s - parity = EVEN\n", __func__);
				}
L
Linus Torvalds 已提交
718 719
			}
		}
720
		if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
721
			dev_dbg(dev, "Parity mode not supported by device\n");
L
Linus Torvalds 已提交
722 723 724
	}

	if ((cflag & CSTOPB) != (old_cflag & CSTOPB)) {
725
		cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
726 727 728
		bits &= ~BITS_STOP_MASK;
		if (cflag & CSTOPB) {
			bits |= BITS_STOP_2;
729
			dev_dbg(dev, "%s - stop bits = 2\n", __func__);
L
Linus Torvalds 已提交
730 731
		} else {
			bits |= BITS_STOP_1;
732
			dev_dbg(dev, "%s - stop bits = 1\n", __func__);
L
Linus Torvalds 已提交
733
		}
734
		if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
735
			dev_dbg(dev, "Number of stop bits requested not supported by device\n");
L
Linus Torvalds 已提交
736
	}
737 738

	if ((cflag & CRTSCTS) != (old_cflag & CRTSCTS)) {
739
		cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
740 741 742
		dev_dbg(dev, "%s - read modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x\n",
			__func__, modem_ctl[0], modem_ctl[1],
			modem_ctl[2], modem_ctl[3]);
743 744 745 746 747

		if (cflag & CRTSCTS) {
			modem_ctl[0] &= ~0x7B;
			modem_ctl[0] |= 0x09;
			modem_ctl[1] = 0x80;
748
			dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
749 750 751 752
		} else {
			modem_ctl[0] &= ~0x7B;
			modem_ctl[0] |= 0x01;
			modem_ctl[1] |= 0x40;
753
			dev_dbg(dev, "%s - flow control = NONE\n", __func__);
754 755
		}

756 757 758
		dev_dbg(dev, "%s - write modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x\n",
			__func__, modem_ctl[0], modem_ctl[1],
			modem_ctl[2], modem_ctl[3]);
759
		cp210x_set_config(port, CP210X_SET_FLOW, modem_ctl, 16);
760 761 762 763
	}

}

J
Johan Hovold 已提交
764
static int cp210x_tiocmset(struct tty_struct *tty,
765 766
		unsigned int set, unsigned int clear)
{
A
Alan Cox 已提交
767
	struct usb_serial_port *port = tty->driver_data;
768
	return cp210x_tiocmset_port(port, set, clear);
769 770
}

771
static int cp210x_tiocmset_port(struct usb_serial_port *port,
772 773
		unsigned int set, unsigned int clear)
{
774
	unsigned int control = 0;
775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792

	if (set & TIOCM_RTS) {
		control |= CONTROL_RTS;
		control |= CONTROL_WRITE_RTS;
	}
	if (set & TIOCM_DTR) {
		control |= CONTROL_DTR;
		control |= CONTROL_WRITE_DTR;
	}
	if (clear & TIOCM_RTS) {
		control &= ~CONTROL_RTS;
		control |= CONTROL_WRITE_RTS;
	}
	if (clear & TIOCM_DTR) {
		control &= ~CONTROL_DTR;
		control |= CONTROL_WRITE_DTR;
	}

793
	dev_dbg(&port->dev, "%s - control = 0x%.4x\n", __func__, control);
794

795
	return cp210x_set_config(port, CP210X_SET_MHS, &control, 2);
796 797
}

A
Alan Cox 已提交
798 799 800
static void cp210x_dtr_rts(struct usb_serial_port *p, int on)
{
	if (on)
801
		cp210x_tiocmset_port(p, TIOCM_DTR|TIOCM_RTS, 0);
A
Alan Cox 已提交
802
	else
803
		cp210x_tiocmset_port(p, 0, TIOCM_DTR|TIOCM_RTS);
A
Alan Cox 已提交
804 805
}

J
Johan Hovold 已提交
806
static int cp210x_tiocmget(struct tty_struct *tty)
807
{
A
Alan Cox 已提交
808
	struct usb_serial_port *port = tty->driver_data;
809 810
	unsigned int control;
	int result;
811

812
	cp210x_get_config(port, CP210X_GET_MDMSTS, &control, 1);
813 814 815 816 817 818 819 820

	result = ((control & CONTROL_DTR) ? TIOCM_DTR : 0)
		|((control & CONTROL_RTS) ? TIOCM_RTS : 0)
		|((control & CONTROL_CTS) ? TIOCM_CTS : 0)
		|((control & CONTROL_DSR) ? TIOCM_DSR : 0)
		|((control & CONTROL_RING)? TIOCM_RI  : 0)
		|((control & CONTROL_DCD) ? TIOCM_CD  : 0);

821
	dev_dbg(&port->dev, "%s - control = 0x%.2x\n", __func__, control);
822 823

	return result;
L
Linus Torvalds 已提交
824 825
}

J
Johan Hovold 已提交
826
static void cp210x_break_ctl(struct tty_struct *tty, int break_state)
L
Linus Torvalds 已提交
827
{
A
Alan Cox 已提交
828
	struct usb_serial_port *port = tty->driver_data;
829
	unsigned int state;
L
Linus Torvalds 已提交
830 831 832 833 834

	if (break_state == 0)
		state = BREAK_OFF;
	else
		state = BREAK_ON;
835 836
	dev_dbg(&port->dev, "%s - turning break %s\n", __func__,
		state == BREAK_OFF ? "off" : "on");
837
	cp210x_set_config(port, CP210X_SET_BREAK, &state, 2);
L
Linus Torvalds 已提交
838 839
}

840
static int cp210x_startup(struct usb_serial *serial)
L
Linus Torvalds 已提交
841
{
842 843
	struct usb_host_interface *cur_altsetting;
	struct cp210x_serial_private *spriv;
844

845
	/* cp210x buffers behave strangely unless device is reset */
L
Linus Torvalds 已提交
846
	usb_reset_device(serial->dev);
847

848 849 850
	spriv = kzalloc(sizeof(*spriv), GFP_KERNEL);
	if (!spriv)
		return -ENOMEM;
851

852 853
	cur_altsetting = serial->interface->cur_altsetting;
	spriv->bInterfaceNumber = cur_altsetting->desc.bInterfaceNumber;
854

855
	usb_set_serial_data(serial, spriv);
856

L
Linus Torvalds 已提交
857 858 859
	return 0;
}

860 861
static void cp210x_release(struct usb_serial *serial)
{
862
	struct cp210x_serial_private *spriv;
863

864 865
	spriv = usb_get_serial_data(serial);
	kfree(spriv);
866 867
}

868
module_usb_serial_driver(serial_drivers, id_table);
L
Linus Torvalds 已提交
869 870 871

MODULE_DESCRIPTION(DRIVER_DESC);
MODULE_LICENSE("GPL");