cp210x.c 28.4 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 28 29

/*
 * Version Information
 */
30
#define DRIVER_VERSION "v0.09"
31
#define DRIVER_DESC "Silicon Labs CP210x RS232 serial adaptor driver"
L
Linus Torvalds 已提交
32 33 34 35

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

55
static bool debug;
L
Linus Torvalds 已提交
56

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

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

167 168 169 170
struct cp210x_port_private {
	__u8			bInterfaceNumber;
};

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

191 192 193 194
static struct usb_serial_driver * const serial_drivers[] = {
	&cp210x_device, NULL
};

195
/* Config request types */
196 197 198 199
#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 已提交
200

201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225
/* 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
226 227
#define CP210X_GET_BAUDRATE	0x1D
#define CP210X_SET_BAUDRATE	0x1E
228 229

/* CP210X_IFC_ENABLE */
L
Linus Torvalds 已提交
230 231 232
#define UART_ENABLE		0x0001
#define UART_DISABLE		0x0000

233
/* CP210X_(SET|GET)_BAUDDIV */
L
Linus Torvalds 已提交
234 235
#define BAUD_RATE_GEN_FREQ	0x384000

236
/* CP210X_(SET|GET)_LINE_CTL */
L
Linus Torvalds 已提交
237
#define BITS_DATA_MASK		0X0f00
238
#define BITS_DATA_5		0X0500
L
Linus Torvalds 已提交
239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254
#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
255

256
/* CP210X_SET_BREAK */
C
Craig Shelley 已提交
257 258
#define BREAK_ON		0x0001
#define BREAK_OFF		0x0000
L
Linus Torvalds 已提交
259

260
/* CP210X_(SET_MHS|GET_MDMSTS) */
261 262 263 264 265 266 267 268
#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 已提交
269

270
/*
271 272
 * cp210x_get_config
 * Reads from the CP210x configuration registers
273 274 275 276
 * '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)
 */
277
static int cp210x_get_config(struct usb_serial_port *port, u8 request,
278
		unsigned int *data, int size)
L
Linus Torvalds 已提交
279 280
{
	struct usb_serial *serial = port->serial;
281
	struct cp210x_port_private *port_priv = usb_get_serial_port_data(port);
282
	__le32 *buf;
283 284 285 286 287
	int result, i, length;

	/* Number of integers required to contain the array */
	length = (((size - 1) | 3) + 1)/4;

288
	buf = kcalloc(length, sizeof(__le32), GFP_KERNEL);
289
	if (!buf) {
290
		dev_err(&port->dev, "%s - out of memory.\n", __func__);
291 292
		return -ENOMEM;
	}
L
Linus Torvalds 已提交
293

294
	/* Issue the request, attempting to read 'size' bytes */
A
Alan Cox 已提交
295
	result = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
296
				request, REQTYPE_INTERFACE_TO_HOST, 0x0000,
297 298
				port_priv->bInterfaceNumber, buf, size,
				USB_CTRL_GET_TIMEOUT);
L
Linus Torvalds 已提交
299

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

304
	kfree(buf);
L
Linus Torvalds 已提交
305

306
	if (result != size) {
307 308
		dev_dbg(&port->dev, "%s - Unable to send config request, request=0x%x size=%d result=%d\n",
			__func__, request, size, result);
309 310 311 312
		if (result > 0)
			result = -EPROTO;

		return result;
313
	}
L
Linus Torvalds 已提交
314

315
	return 0;
L
Linus Torvalds 已提交
316 317
}

318
/*
319 320
 * cp210x_set_config
 * Writes to the CP210x configuration registers
321 322 323
 * Values less than 16 bits wide are sent directly
 * 'size' is specified in bytes.
 */
324
static int cp210x_set_config(struct usb_serial_port *port, u8 request,
325
		unsigned int *data, int size)
L
Linus Torvalds 已提交
326 327
{
	struct usb_serial *serial = port->serial;
328
	struct cp210x_port_private *port_priv = usb_get_serial_port_data(port);
329
	__le32 *buf;
330
	int result, i, length;
L
Linus Torvalds 已提交
331

332 333 334
	/* Number of integers required to contain the array */
	length = (((size - 1) | 3) + 1)/4;

335
	buf = kmalloc(length * sizeof(__le32), GFP_KERNEL);
336 337
	if (!buf) {
		dev_err(&port->dev, "%s - out of memory.\n",
338
				__func__);
339 340 341 342 343 344 345 346
		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 已提交
347
		result = usb_control_msg(serial->dev,
348
				usb_sndctrlpipe(serial->dev, 0),
349
				request, REQTYPE_HOST_TO_INTERFACE, 0x0000,
350 351
				port_priv->bInterfaceNumber, buf, size,
				USB_CTRL_SET_TIMEOUT);
352
	} else {
A
Alan Cox 已提交
353
		result = usb_control_msg(serial->dev,
354
				usb_sndctrlpipe(serial->dev, 0),
355
				request, REQTYPE_HOST_TO_INTERFACE, data[0],
356 357
				port_priv->bInterfaceNumber, NULL, 0,
				USB_CTRL_SET_TIMEOUT);
L
Linus Torvalds 已提交
358 359
	}

360 361 362
	kfree(buf);

	if ((size > 2 && result != size) || result < 0) {
363 364
		dev_dbg(&port->dev, "%s - Unable to send request, request=0x%x size=%d result=%d\n",
			__func__, request, size, result);
365 366 367 368
		if (result > 0)
			result = -EPROTO;

		return result;
369
	}
L
Linus Torvalds 已提交
370 371 372 373

	return 0;
}

374
/*
375 376
 * cp210x_set_config_single
 * Convenience function for calling cp210x_set_config on single data values
377 378
 * without requiring an integer pointer
 */
379
static inline int cp210x_set_config_single(struct usb_serial_port *port,
380 381
		u8 request, unsigned int data)
{
382
	return cp210x_set_config(port, request, &data, 2);
383 384
}

385
/*
386
 * cp210x_quantise_baudrate
387 388
 * Quantises the baud rate as per AN205 Table 1
 */
389
static unsigned int cp210x_quantise_baudrate(unsigned int baud) {
390 391
	if (baud <= 300)
		baud = 300;
392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418
	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;
419 420 421 422
	else if (baud < 1000000)
		baud = 921600;
	else if (baud > 2000000)
		baud = 2000000;
423 424 425
	return baud;
}

426
static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *port)
L
Linus Torvalds 已提交
427 428 429
{
	int result;

430 431 432 433 434
	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 已提交
435 436
	}

437
	/* Configure the termios structure */
438
	cp210x_get_termios(tty, port);
439

440 441 442 443
	/* The baud rate must be initialised on cp2104 */
	if (tty)
		cp210x_change_speed(tty, port, NULL);

444
	return usb_serial_generic_open(tty, port);
L
Linus Torvalds 已提交
445 446
}

447
static void cp210x_close(struct usb_serial_port *port)
L
Linus Torvalds 已提交
448
{
449
	usb_serial_generic_close(port);
L
Linus Torvalds 已提交
450

451 452
	mutex_lock(&port->serial->disc_mutex);
	if (!port->serial->disconnected)
453
		cp210x_set_config_single(port, CP210X_IFC_ENABLE, UART_DISABLE);
454
	mutex_unlock(&port->serial->disc_mutex);
L
Linus Torvalds 已提交
455 456
}

457
/*
458
 * cp210x_get_termios
459 460 461 462
 * 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
 */
463
static void cp210x_get_termios(struct tty_struct *tty,
464 465 466 467 468
	struct usb_serial_port *port)
{
	unsigned int baud;

	if (tty) {
469
		cp210x_get_termios_port(tty->driver_data,
470 471 472 473 474 475 476
			&tty->termios->c_cflag, &baud);
		tty_encode_baud_rate(tty, baud, baud);
	}

	else {
		unsigned int cflag;
		cflag = 0;
477
		cp210x_get_termios_port(port, &cflag, &baud);
478 479 480 481
	}
}

/*
482 483
 * cp210x_get_termios_port
 * This is the heart of cp210x_get_termios which always uses a &usb_serial_port.
484
 */
485
static void cp210x_get_termios_port(struct usb_serial_port *port,
486
	unsigned int *cflagp, unsigned int *baudp)
L
Linus Torvalds 已提交
487
{
488
	struct device *dev = &port->dev;
489
	unsigned int cflag, modem_ctl[4];
490 491
	unsigned int baud;
	unsigned int bits;
L
Linus Torvalds 已提交
492

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

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

498
	cflag = *cflagp;
L
Linus Torvalds 已提交
499

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

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

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

587
	cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
588
	if (modem_ctl[0] & 0x0008) {
589
		dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
590 591
		cflag |= CRTSCTS;
	} else {
592
		dev_dbg(dev, "%s - flow control = NONE\n", __func__);
593 594 595
		cflag &= ~CRTSCTS;
	}

596
	*cflagp = cflag;
L
Linus Torvalds 已提交
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 622 623 624 625 626 627 628 629 630 631
/*
 * 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;

	baud = tty->termios->c_ospeed;

632 633
	/* This maps the requested rate to a rate valid on cp2102 or cp2103,
	 * or to an arbitrary rate in [1M,2M].
634 635 636 637 638
	 *
	 * NOTE: B0 is not implemented.
	 */
	baud = cp210x_quantise_baudrate(baud);

639
	dev_dbg(&port->dev, "%s - setting baud rate to %u\n", __func__, baud);
640 641 642 643 644 645 646 647 648 649 650 651
	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);
}

652
static void cp210x_set_termios(struct tty_struct *tty,
A
Alan Cox 已提交
653
		struct usb_serial_port *port, struct ktermios *old_termios)
L
Linus Torvalds 已提交
654
{
655
	struct device *dev = &port->dev;
A
Alan Cox 已提交
656
	unsigned int cflag, old_cflag;
657
	unsigned int bits;
658
	unsigned int modem_ctl[4];
L
Linus Torvalds 已提交
659

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

A
Alan Cox 已提交
662
	if (!tty)
L
Linus Torvalds 已提交
663
		return;
A
Alan Cox 已提交
664

A
Alan Cox 已提交
665
	cflag = tty->termios->c_cflag;
666
	old_cflag = old_termios->c_cflag;
667 668 669

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

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

705 706
	if ((cflag     & (PARENB|PARODD|CMSPAR)) !=
	    (old_cflag & (PARENB|PARODD|CMSPAR))) {
707
		cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
708 709
		bits &= ~BITS_PARITY_MASK;
		if (cflag & PARENB) {
710
			if (cflag & CMSPAR) {
711 712 713 714 715 716 717
				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 已提交
718
			} else {
719 720 721 722 723 724 725
				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 已提交
726 727
			}
		}
728
		if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
729
			dev_dbg(dev, "Parity mode not supported by device\n");
L
Linus Torvalds 已提交
730 731 732
	}

	if ((cflag & CSTOPB) != (old_cflag & CSTOPB)) {
733
		cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
L
Linus Torvalds 已提交
734 735 736
		bits &= ~BITS_STOP_MASK;
		if (cflag & CSTOPB) {
			bits |= BITS_STOP_2;
737
			dev_dbg(dev, "%s - stop bits = 2\n", __func__);
L
Linus Torvalds 已提交
738 739
		} else {
			bits |= BITS_STOP_1;
740
			dev_dbg(dev, "%s - stop bits = 1\n", __func__);
L
Linus Torvalds 已提交
741
		}
742
		if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
743
			dev_dbg(dev, "Number of stop bits requested not supported by device\n");
L
Linus Torvalds 已提交
744
	}
745 746

	if ((cflag & CRTSCTS) != (old_cflag & CRTSCTS)) {
747
		cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
748 749 750
		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]);
751 752 753 754 755

		if (cflag & CRTSCTS) {
			modem_ctl[0] &= ~0x7B;
			modem_ctl[0] |= 0x09;
			modem_ctl[1] = 0x80;
756
			dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
757 758 759 760
		} else {
			modem_ctl[0] &= ~0x7B;
			modem_ctl[0] |= 0x01;
			modem_ctl[1] |= 0x40;
761
			dev_dbg(dev, "%s - flow control = NONE\n", __func__);
762 763
		}

764 765 766
		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]);
767
		cp210x_set_config(port, CP210X_SET_FLOW, modem_ctl, 16);
768 769 770 771
	}

}

772
static int cp210x_tiocmset (struct tty_struct *tty,
773 774
		unsigned int set, unsigned int clear)
{
A
Alan Cox 已提交
775
	struct usb_serial_port *port = tty->driver_data;
776
	return cp210x_tiocmset_port(port, set, clear);
777 778
}

779
static int cp210x_tiocmset_port(struct usb_serial_port *port,
780 781
		unsigned int set, unsigned int clear)
{
782
	unsigned int control = 0;
783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800

	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;
	}

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

803
	return cp210x_set_config(port, CP210X_SET_MHS, &control, 2);
804 805
}

A
Alan Cox 已提交
806 807 808
static void cp210x_dtr_rts(struct usb_serial_port *p, int on)
{
	if (on)
809
		cp210x_tiocmset_port(p, TIOCM_DTR|TIOCM_RTS, 0);
A
Alan Cox 已提交
810
	else
811
		cp210x_tiocmset_port(p, 0, TIOCM_DTR|TIOCM_RTS);
A
Alan Cox 已提交
812 813
}

814
static int cp210x_tiocmget (struct tty_struct *tty)
815
{
A
Alan Cox 已提交
816
	struct usb_serial_port *port = tty->driver_data;
817 818
	unsigned int control;
	int result;
819

820
	cp210x_get_config(port, CP210X_GET_MDMSTS, &control, 1);
821 822 823 824 825 826 827 828

	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);

829
	dev_dbg(&port->dev, "%s - control = 0x%.2x\n", __func__, control);
830 831

	return result;
L
Linus Torvalds 已提交
832 833
}

834
static void cp210x_break_ctl (struct tty_struct *tty, int break_state)
L
Linus Torvalds 已提交
835
{
A
Alan Cox 已提交
836
	struct usb_serial_port *port = tty->driver_data;
837
	unsigned int state;
L
Linus Torvalds 已提交
838 839 840 841 842

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

848
static int cp210x_startup(struct usb_serial *serial)
L
Linus Torvalds 已提交
849
{
850 851 852
	struct cp210x_port_private *port_priv;
	int i;

853
	/* cp210x buffers behave strangely unless device is reset */
L
Linus Torvalds 已提交
854
	usb_reset_device(serial->dev);
855 856 857 858 859 860 861 862 863 864 865 866

	for (i = 0; i < serial->num_ports; i++) {
		port_priv = kzalloc(sizeof(*port_priv), GFP_KERNEL);
		if (!port_priv)
			return -ENOMEM;

		port_priv->bInterfaceNumber =
		    serial->interface->cur_altsetting->desc.bInterfaceNumber;

		usb_set_serial_port_data(serial->port[i], port_priv);
	}

L
Linus Torvalds 已提交
867 868 869
	return 0;
}

870 871 872 873 874 875 876 877 878 879 880 881
static void cp210x_release(struct usb_serial *serial)
{
	struct cp210x_port_private *port_priv;
	int i;

	for (i = 0; i < serial->num_ports; i++) {
		port_priv = usb_get_serial_port_data(serial->port[i]);
		kfree(port_priv);
		usb_set_serial_port_data(serial->port[i], NULL);
	}
}

882
module_usb_serial_driver(serial_drivers, id_table);
L
Linus Torvalds 已提交
883 884 885 886 887 888 889

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

module_param(debug, bool, S_IRUGO | S_IWUSR);
MODULE_PARM_DESC(debug, "Enable verbose debugging messages");