103ee2515SGreg Kroah-Hartman /* 24cc27bd6SCraig Shelley * Silicon Laboratories CP210x USB to RS232 serial adaptor driver 303ee2515SGreg Kroah-Hartman * 403ee2515SGreg Kroah-Hartman * Copyright (C) 2005 Craig Shelley (craig@microtron.org.uk) 503ee2515SGreg Kroah-Hartman * 603ee2515SGreg Kroah-Hartman * This program is free software; you can redistribute it and/or 703ee2515SGreg Kroah-Hartman * modify it under the terms of the GNU General Public License version 803ee2515SGreg Kroah-Hartman * 2 as published by the Free Software Foundation. 903ee2515SGreg Kroah-Hartman * 1003ee2515SGreg Kroah-Hartman * Support to set flow control line levels using TIOCMGET and TIOCMSET 1103ee2515SGreg Kroah-Hartman * thanks to Karl Hiramoto karl@hiramoto.org. RTSCTS hardware flow 1203ee2515SGreg Kroah-Hartman * control thanks to Munir Nassar nassarmu@real-time.com 1303ee2515SGreg Kroah-Hartman * 1403ee2515SGreg Kroah-Hartman */ 1503ee2515SGreg Kroah-Hartman 1603ee2515SGreg Kroah-Hartman #include <linux/kernel.h> 1703ee2515SGreg Kroah-Hartman #include <linux/errno.h> 1803ee2515SGreg Kroah-Hartman #include <linux/slab.h> 1903ee2515SGreg Kroah-Hartman #include <linux/tty.h> 2003ee2515SGreg Kroah-Hartman #include <linux/tty_flip.h> 2103ee2515SGreg Kroah-Hartman #include <linux/module.h> 2203ee2515SGreg Kroah-Hartman #include <linux/moduleparam.h> 2303ee2515SGreg Kroah-Hartman #include <linux/usb.h> 2403ee2515SGreg Kroah-Hartman #include <linux/uaccess.h> 2503ee2515SGreg Kroah-Hartman #include <linux/usb/serial.h> 2603ee2515SGreg Kroah-Hartman 2703ee2515SGreg Kroah-Hartman /* 2803ee2515SGreg Kroah-Hartman * Version Information 2903ee2515SGreg Kroah-Hartman */ 3093ef1f1fSCraig Shelley #define DRIVER_VERSION "v0.09" 314cc27bd6SCraig Shelley #define DRIVER_DESC "Silicon Labs CP210x RS232 serial adaptor driver" 3203ee2515SGreg Kroah-Hartman 3303ee2515SGreg Kroah-Hartman /* 3403ee2515SGreg Kroah-Hartman * Function Prototypes 3503ee2515SGreg Kroah-Hartman */ 36a509a7e4SAlan Cox static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *); 374cc27bd6SCraig Shelley static void cp210x_close(struct usb_serial_port *); 384cc27bd6SCraig Shelley static void cp210x_get_termios(struct tty_struct *, 39d2ad67b3SVomLehn struct usb_serial_port *port); 404cc27bd6SCraig Shelley static void cp210x_get_termios_port(struct usb_serial_port *port, 41d2ad67b3SVomLehn unsigned int *cflagp, unsigned int *baudp); 42e5990874SJohan Hovold static void cp210x_change_speed(struct tty_struct *, struct usb_serial_port *, 43e5990874SJohan Hovold struct ktermios *); 444cc27bd6SCraig Shelley static void cp210x_set_termios(struct tty_struct *, struct usb_serial_port *, 4503ee2515SGreg Kroah-Hartman struct ktermios*); 4660b33c13SAlan Cox static int cp210x_tiocmget(struct tty_struct *); 4720b9d177SAlan Cox static int cp210x_tiocmset(struct tty_struct *, unsigned int, unsigned int); 4820b9d177SAlan Cox static int cp210x_tiocmset_port(struct usb_serial_port *port, 49d2ad67b3SVomLehn unsigned int, unsigned int); 504cc27bd6SCraig Shelley static void cp210x_break_ctl(struct tty_struct *, int); 514cc27bd6SCraig Shelley static int cp210x_startup(struct usb_serial *); 52a5360a53SPreston Fick static void cp210x_release(struct usb_serial *); 53d94c7bd4SAlan Cox static void cp210x_dtr_rts(struct usb_serial_port *p, int on); 5403ee2515SGreg Kroah-Hartman 5590ab5ee9SRusty Russell static bool debug; 5603ee2515SGreg Kroah-Hartman 577d40d7e8SNémeth Márton static const struct usb_device_id id_table[] = { 582f1136d1SDJ Delorie { USB_DEVICE(0x045B, 0x0053) }, /* Renesas RX610 RX-Stick */ 5903ee2515SGreg Kroah-Hartman { USB_DEVICE(0x0471, 0x066A) }, /* AKTAKOM ACE-1001 cable */ 6003ee2515SGreg Kroah-Hartman { USB_DEVICE(0x0489, 0xE000) }, /* Pirelli Broadband S.p.A, DP-L10 SIP/GSM Mobile */ 615b22a32eSA E Lawrence { USB_DEVICE(0x0489, 0xE003) }, /* Pirelli Broadband S.p.A, DP-L10 SIP/GSM Mobile */ 62b7c7cbc8SCraig Shelley { USB_DEVICE(0x0745, 0x1000) }, /* CipherLab USB CCD Barcode Scanner 1000 */ 6303ee2515SGreg Kroah-Hartman { USB_DEVICE(0x08e6, 0x5501) }, /* Gemalto Prox-PU/CU contactless smartcard reader */ 64b7c7cbc8SCraig Shelley { USB_DEVICE(0x08FD, 0x000A) }, /* Digianswer A/S , ZigBee/802.15.4 MAC Device */ 65eefd9029SCraig Shelley { USB_DEVICE(0x0BED, 0x1100) }, /* MEI (TM) Cashflow-SC Bill/Voucher Acceptor */ 66eefd9029SCraig Shelley { USB_DEVICE(0x0BED, 0x1101) }, /* MEI series 2000 Combo Acceptor */ 6703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x0FCF, 0x1003) }, /* Dynastream ANT development board */ 6803ee2515SGreg Kroah-Hartman { USB_DEVICE(0x0FCF, 0x1004) }, /* Dynastream ANT2USB */ 6903ee2515SGreg Kroah-Hartman { USB_DEVICE(0x0FCF, 0x1006) }, /* Dynastream ANT development board */ 7003ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10A6, 0xAA26) }, /* Knock-off DCU-11 cable */ 7103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10AB, 0x10C5) }, /* Siemens MC60 Cable */ 7203ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10B5, 0xAC70) }, /* Nokia CA-42 USB */ 73b7c7cbc8SCraig Shelley { USB_DEVICE(0x10C4, 0x0F91) }, /* Vstabi */ 740601e116SAmit Kucheria { USB_DEVICE(0x10C4, 0x1101) }, /* Arkham Technology DS101 Bus Monitor */ 750601e116SAmit Kucheria { USB_DEVICE(0x10C4, 0x1601) }, /* Arkham Technology DS101 Adapter */ 7603ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x800A) }, /* SPORTident BSM7-D-USB main station */ 7703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x803B) }, /* Pololu USB-serial converter */ 78eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0x8044) }, /* Cygnal Debug Adapter */ 79eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0x804E) }, /* Software Bisque Paramount ME build-in converter */ 8003ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8053) }, /* Enfora EDG1228 */ 8103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8054) }, /* Enfora GSM2228 */ 8203ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8066) }, /* Argussoft In-System Programmer */ 83eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0x806F) }, /* IMS USB to RS422 Converter Cable */ 8403ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x807A) }, /* Crumb128 board */ 8503ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x80CA) }, /* Degree Controls Inc */ 8603ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x80DD) }, /* Tracient RFID */ 8703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x80F6) }, /* Suunto sports instrument */ 8803ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8115) }, /* Arygon NFC/Mifare Reader */ 8903ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x813D) }, /* Burnside Telecom Deskmobile */ 908bf16ba7SCraig Shelley { USB_DEVICE(0x10C4, 0x813F) }, /* Tams Master Easy Control */ 9103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x814A) }, /* West Mountain Radio RIGblaster P&P */ 9203ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x814B) }, /* West Mountain Radio RIGtalk */ 930bf7a81cSJason Detring { USB_DEVICE(0x10C4, 0x8156) }, /* B&G H3000 link cable */ 9403ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x815E) }, /* Helicomm IP-Link 1220-DVM */ 95eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0x818B) }, /* AVIT Research USB to TTL */ 9603ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x819F) }, /* MJS USB Toslink Switcher */ 9703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x81A6) }, /* ThinkOptics WavIt */ 9808e87d0dSMalte Schröder { USB_DEVICE(0x10C4, 0x81A9) }, /* Multiplex RC Interface */ 9903ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x81AC) }, /* MSD Dash Hawk */ 100eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0x81AD) }, /* INSYS USB Modem */ 10103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x81C8) }, /* Lipowsky Industrie Elektronik GmbH, Baby-JTAG */ 10203ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x81E2) }, /* Lipowsky Industrie Elektronik GmbH, Baby-LIN */ 10303ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x81E7) }, /* Aerocomm Radio */ 104bd07c551SAlan Cox { USB_DEVICE(0x10C4, 0x81E8) }, /* Zephyr Bioharness */ 105b7c7cbc8SCraig Shelley { USB_DEVICE(0x10C4, 0x81F2) }, /* C1007 HF band RFID controller */ 10603ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8218) }, /* Lipowsky Industrie Elektronik GmbH, HARP-1 */ 10703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x822B) }, /* Modem EDGE(GSM) Comander 2 */ 10825985edcSLucas De Marchi { USB_DEVICE(0x10C4, 0x826B) }, /* Cygnal Integrated Products, Inc., Fasttrax GPS demonstration module */ 109c851e83fSFlorian Fainelli { USB_DEVICE(0x10C4, 0x8293) }, /* Telegesis ETRX2USB */ 110b7c7cbc8SCraig Shelley { USB_DEVICE(0x10C4, 0x82F9) }, /* Procyon AVS */ 11103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x8341) }, /* Siemens MC35PU GPRS Modem */ 1128bf16ba7SCraig Shelley { USB_DEVICE(0x10C4, 0x8382) }, /* Cygnal Integrated Products, Inc. */ 11303ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0x83A8) }, /* Amber Wireless AMB2560 */ 114faea63f7SCraig Shelley { USB_DEVICE(0x10C4, 0x83D8) }, /* DekTec DTA Plus VHF/UHF Booster/Attenuator */ 1158bf16ba7SCraig Shelley { USB_DEVICE(0x10C4, 0x8411) }, /* Kyocera GPS Module */ 116faea63f7SCraig Shelley { USB_DEVICE(0x10C4, 0x8418) }, /* IRZ Automation Teleport SG-10 GSM/GPRS Modem */ 117d23bac9fSAlex Stephens { USB_DEVICE(0x10C4, 0x846E) }, /* BEI USB Sensor Interface (VCP) */ 118541e05ecSCraig Shelley { USB_DEVICE(0x10C4, 0x8477) }, /* Balluff RFID */ 1194eff0b40SCraig Shelley { USB_DEVICE(0x10C4, 0x85EA) }, /* AC-Services IBUS-IF */ 1204eff0b40SCraig Shelley { USB_DEVICE(0x10C4, 0x85EB) }, /* AC-Services CIS-IBUS */ 1214eff0b40SCraig Shelley { USB_DEVICE(0x10C4, 0x8664) }, /* AC-Services CAN-IF */ 1224eff0b40SCraig Shelley { USB_DEVICE(0x10C4, 0x8665) }, /* AC-Services OBD-IF */ 12303ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xEA60) }, /* Silicon Labs factory default */ 12403ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xEA61) }, /* Silicon Labs factory default */ 125a5360a53SPreston Fick { USB_DEVICE(0x10C4, 0xEA70) }, /* Silicon Labs factory default */ 126a5360a53SPreston Fick { USB_DEVICE(0x10C4, 0xEA80) }, /* Silicon Labs factory default */ 127eefd9029SCraig Shelley { USB_DEVICE(0x10C4, 0xEA71) }, /* Infinity GPS-MIC-1 Radio Monophone */ 12803ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xF001) }, /* Elan Digital Systems USBscope50 */ 12903ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xF002) }, /* Elan Digital Systems USBwave12 */ 13003ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xF003) }, /* Elan Digital Systems USBpulse100 */ 13103ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C4, 0xF004) }, /* Elan Digital Systems USBcount50 */ 13203ee2515SGreg Kroah-Hartman { USB_DEVICE(0x10C5, 0xEA61) }, /* Silicon Labs MobiData GPRS USB Modem */ 133b7c7cbc8SCraig Shelley { USB_DEVICE(0x10CE, 0xEA6A) }, /* Silicon Labs MobiData GPRS USB Modem 100EU */ 13403ee2515SGreg Kroah-Hartman { USB_DEVICE(0x13AD, 0x9999) }, /* Baltech card reader */ 135b7c7cbc8SCraig Shelley { USB_DEVICE(0x1555, 0x0004) }, /* Owen AC4 USB-RS485 Converter */ 13603ee2515SGreg Kroah-Hartman { USB_DEVICE(0x166A, 0x0303) }, /* Clipsal 5500PCU C-Bus USB interface */ 13703ee2515SGreg Kroah-Hartman { USB_DEVICE(0x16D6, 0x0001) }, /* Jablotron serial interface */ 138356c5a48SAlessio Igor Bogani { USB_DEVICE(0x16DC, 0x0010) }, /* W-IE-NE-R Plein & Baus GmbH PL512 Power Supply */ 139356c5a48SAlessio Igor Bogani { USB_DEVICE(0x16DC, 0x0011) }, /* W-IE-NE-R Plein & Baus GmbH RCM Remote Control for MARATON Power Supply */ 140356c5a48SAlessio Igor Bogani { USB_DEVICE(0x16DC, 0x0012) }, /* W-IE-NE-R Plein & Baus GmbH MPOD Multi Channel Power Supply */ 141356c5a48SAlessio Igor Bogani { USB_DEVICE(0x16DC, 0x0015) }, /* W-IE-NE-R Plein & Baus GmbH CML Control, Monitoring and Data Logger */ 142c6c1e449SBruno Thomsen { USB_DEVICE(0x17A8, 0x0001) }, /* Kamstrup Optical Eye/3-wire */ 143c6c1e449SBruno Thomsen { USB_DEVICE(0x17A8, 0x0005) }, /* Kamstrup M-Bus Master MultiPort 250D */ 144541e05ecSCraig Shelley { USB_DEVICE(0x17F4, 0xAAAA) }, /* Wavesense Jazz blood glucose meter */ 145541e05ecSCraig Shelley { USB_DEVICE(0x1843, 0x0200) }, /* Vaisala USB Instrument Cable */ 146541e05ecSCraig Shelley { USB_DEVICE(0x18EF, 0xE00F) }, /* ELV USB-I2C-Interface */ 14793ad03d6SAnders Larsen { USB_DEVICE(0x1BE3, 0x07A6) }, /* WAGO 750-923 USB Service Cable */ 148791b7d7cSRenato Caldas { USB_DEVICE(0x3195, 0xF190) }, /* Link Instruments MSO-19 */ 149541e05ecSCraig Shelley { USB_DEVICE(0x413C, 0x9500) }, /* DW700 GPS USB interface */ 15003ee2515SGreg Kroah-Hartman { } /* Terminating Entry */ 15103ee2515SGreg Kroah-Hartman }; 15203ee2515SGreg Kroah-Hartman 15303ee2515SGreg Kroah-Hartman MODULE_DEVICE_TABLE(usb, id_table); 15403ee2515SGreg Kroah-Hartman 155a5360a53SPreston Fick struct cp210x_port_private { 156a5360a53SPreston Fick __u8 bInterfaceNumber; 157a5360a53SPreston Fick }; 158a5360a53SPreston Fick 1594cc27bd6SCraig Shelley static struct usb_driver cp210x_driver = { 1604cc27bd6SCraig Shelley .name = "cp210x", 16103ee2515SGreg Kroah-Hartman .probe = usb_serial_probe, 16203ee2515SGreg Kroah-Hartman .disconnect = usb_serial_disconnect, 16303ee2515SGreg Kroah-Hartman .id_table = id_table, 16403ee2515SGreg Kroah-Hartman }; 16503ee2515SGreg Kroah-Hartman 1664cc27bd6SCraig Shelley static struct usb_serial_driver cp210x_device = { 16703ee2515SGreg Kroah-Hartman .driver = { 16803ee2515SGreg Kroah-Hartman .owner = THIS_MODULE, 1694cc27bd6SCraig Shelley .name = "cp210x", 17003ee2515SGreg Kroah-Hartman }, 17103ee2515SGreg Kroah-Hartman .id_table = id_table, 17203ee2515SGreg Kroah-Hartman .num_ports = 1, 173aea006b9SJohan Hovold .bulk_in_size = 256, 174d4e598f6SJohan Hovold .bulk_out_size = 256, 1754cc27bd6SCraig Shelley .open = cp210x_open, 1764cc27bd6SCraig Shelley .close = cp210x_close, 1774cc27bd6SCraig Shelley .break_ctl = cp210x_break_ctl, 1784cc27bd6SCraig Shelley .set_termios = cp210x_set_termios, 1794cc27bd6SCraig Shelley .tiocmget = cp210x_tiocmget, 1804cc27bd6SCraig Shelley .tiocmset = cp210x_tiocmset, 1814cc27bd6SCraig Shelley .attach = cp210x_startup, 182a5360a53SPreston Fick .release = cp210x_release, 183d14fc1a7SLibor Pechacek .dtr_rts = cp210x_dtr_rts 18403ee2515SGreg Kroah-Hartman }; 18503ee2515SGreg Kroah-Hartman 18608a4f6bcSAlan Stern static struct usb_serial_driver * const serial_drivers[] = { 18708a4f6bcSAlan Stern &cp210x_device, NULL 18808a4f6bcSAlan Stern }; 18908a4f6bcSAlan Stern 19003ee2515SGreg Kroah-Hartman /* Config request types */ 191*32445605SPreston Fick #define REQTYPE_HOST_TO_INTERFACE 0x41 192*32445605SPreston Fick #define REQTYPE_INTERFACE_TO_HOST 0xc1 193*32445605SPreston Fick #define REQTYPE_HOST_TO_DEVICE 0x40 194*32445605SPreston Fick #define REQTYPE_DEVICE_TO_HOST 0xc0 19503ee2515SGreg Kroah-Hartman 19693ef1f1fSCraig Shelley /* Config request codes */ 19793ef1f1fSCraig Shelley #define CP210X_IFC_ENABLE 0x00 19893ef1f1fSCraig Shelley #define CP210X_SET_BAUDDIV 0x01 19993ef1f1fSCraig Shelley #define CP210X_GET_BAUDDIV 0x02 20093ef1f1fSCraig Shelley #define CP210X_SET_LINE_CTL 0x03 20193ef1f1fSCraig Shelley #define CP210X_GET_LINE_CTL 0x04 20293ef1f1fSCraig Shelley #define CP210X_SET_BREAK 0x05 20393ef1f1fSCraig Shelley #define CP210X_IMM_CHAR 0x06 20493ef1f1fSCraig Shelley #define CP210X_SET_MHS 0x07 20593ef1f1fSCraig Shelley #define CP210X_GET_MDMSTS 0x08 20693ef1f1fSCraig Shelley #define CP210X_SET_XON 0x09 20793ef1f1fSCraig Shelley #define CP210X_SET_XOFF 0x0A 20893ef1f1fSCraig Shelley #define CP210X_SET_EVENTMASK 0x0B 20993ef1f1fSCraig Shelley #define CP210X_GET_EVENTMASK 0x0C 21093ef1f1fSCraig Shelley #define CP210X_SET_CHAR 0x0D 21193ef1f1fSCraig Shelley #define CP210X_GET_CHARS 0x0E 21293ef1f1fSCraig Shelley #define CP210X_GET_PROPS 0x0F 21393ef1f1fSCraig Shelley #define CP210X_GET_COMM_STATUS 0x10 21493ef1f1fSCraig Shelley #define CP210X_RESET 0x11 21593ef1f1fSCraig Shelley #define CP210X_PURGE 0x12 21693ef1f1fSCraig Shelley #define CP210X_SET_FLOW 0x13 21793ef1f1fSCraig Shelley #define CP210X_GET_FLOW 0x14 21893ef1f1fSCraig Shelley #define CP210X_EMBED_EVENTS 0x15 21993ef1f1fSCraig Shelley #define CP210X_GET_EVENTSTATE 0x16 22093ef1f1fSCraig Shelley #define CP210X_SET_CHARS 0x19 2217f482fc8SPreston Fick #define CP210X_GET_BAUDRATE 0x1D 2227f482fc8SPreston Fick #define CP210X_SET_BAUDRATE 0x1E 22303ee2515SGreg Kroah-Hartman 22493ef1f1fSCraig Shelley /* CP210X_IFC_ENABLE */ 22503ee2515SGreg Kroah-Hartman #define UART_ENABLE 0x0001 22603ee2515SGreg Kroah-Hartman #define UART_DISABLE 0x0000 22703ee2515SGreg Kroah-Hartman 22893ef1f1fSCraig Shelley /* CP210X_(SET|GET)_BAUDDIV */ 22903ee2515SGreg Kroah-Hartman #define BAUD_RATE_GEN_FREQ 0x384000 23003ee2515SGreg Kroah-Hartman 23193ef1f1fSCraig Shelley /* CP210X_(SET|GET)_LINE_CTL */ 23203ee2515SGreg Kroah-Hartman #define BITS_DATA_MASK 0X0f00 23303ee2515SGreg Kroah-Hartman #define BITS_DATA_5 0X0500 23403ee2515SGreg Kroah-Hartman #define BITS_DATA_6 0X0600 23503ee2515SGreg Kroah-Hartman #define BITS_DATA_7 0X0700 23603ee2515SGreg Kroah-Hartman #define BITS_DATA_8 0X0800 23703ee2515SGreg Kroah-Hartman #define BITS_DATA_9 0X0900 23803ee2515SGreg Kroah-Hartman 23903ee2515SGreg Kroah-Hartman #define BITS_PARITY_MASK 0x00f0 24003ee2515SGreg Kroah-Hartman #define BITS_PARITY_NONE 0x0000 24103ee2515SGreg Kroah-Hartman #define BITS_PARITY_ODD 0x0010 24203ee2515SGreg Kroah-Hartman #define BITS_PARITY_EVEN 0x0020 24303ee2515SGreg Kroah-Hartman #define BITS_PARITY_MARK 0x0030 24403ee2515SGreg Kroah-Hartman #define BITS_PARITY_SPACE 0x0040 24503ee2515SGreg Kroah-Hartman 24603ee2515SGreg Kroah-Hartman #define BITS_STOP_MASK 0x000f 24703ee2515SGreg Kroah-Hartman #define BITS_STOP_1 0x0000 24803ee2515SGreg Kroah-Hartman #define BITS_STOP_1_5 0x0001 24903ee2515SGreg Kroah-Hartman #define BITS_STOP_2 0x0002 25003ee2515SGreg Kroah-Hartman 25193ef1f1fSCraig Shelley /* CP210X_SET_BREAK */ 25272916791SCraig Shelley #define BREAK_ON 0x0001 25372916791SCraig Shelley #define BREAK_OFF 0x0000 25403ee2515SGreg Kroah-Hartman 25593ef1f1fSCraig Shelley /* CP210X_(SET_MHS|GET_MDMSTS) */ 25603ee2515SGreg Kroah-Hartman #define CONTROL_DTR 0x0001 25703ee2515SGreg Kroah-Hartman #define CONTROL_RTS 0x0002 25803ee2515SGreg Kroah-Hartman #define CONTROL_CTS 0x0010 25903ee2515SGreg Kroah-Hartman #define CONTROL_DSR 0x0020 26003ee2515SGreg Kroah-Hartman #define CONTROL_RING 0x0040 26103ee2515SGreg Kroah-Hartman #define CONTROL_DCD 0x0080 26203ee2515SGreg Kroah-Hartman #define CONTROL_WRITE_DTR 0x0100 26303ee2515SGreg Kroah-Hartman #define CONTROL_WRITE_RTS 0x0200 26403ee2515SGreg Kroah-Hartman 26503ee2515SGreg Kroah-Hartman /* 2664cc27bd6SCraig Shelley * cp210x_get_config 2674cc27bd6SCraig Shelley * Reads from the CP210x configuration registers 26803ee2515SGreg Kroah-Hartman * 'size' is specified in bytes. 26903ee2515SGreg Kroah-Hartman * 'data' is a pointer to a pre-allocated array of integers large 27003ee2515SGreg Kroah-Hartman * enough to hold 'size' bytes (with 4 bytes to each integer) 27103ee2515SGreg Kroah-Hartman */ 2724cc27bd6SCraig Shelley static int cp210x_get_config(struct usb_serial_port *port, u8 request, 27303ee2515SGreg Kroah-Hartman unsigned int *data, int size) 27403ee2515SGreg Kroah-Hartman { 27503ee2515SGreg Kroah-Hartman struct usb_serial *serial = port->serial; 276a5360a53SPreston Fick struct cp210x_port_private *port_priv = usb_get_serial_port_data(port); 27703ee2515SGreg Kroah-Hartman __le32 *buf; 27803ee2515SGreg Kroah-Hartman int result, i, length; 27903ee2515SGreg Kroah-Hartman 28003ee2515SGreg Kroah-Hartman /* Number of integers required to contain the array */ 28103ee2515SGreg Kroah-Hartman length = (((size - 1) | 3) + 1)/4; 28203ee2515SGreg Kroah-Hartman 28303ee2515SGreg Kroah-Hartman buf = kcalloc(length, sizeof(__le32), GFP_KERNEL); 28403ee2515SGreg Kroah-Hartman if (!buf) { 28503ee2515SGreg Kroah-Hartman dev_err(&port->dev, "%s - out of memory.\n", __func__); 28603ee2515SGreg Kroah-Hartman return -ENOMEM; 28703ee2515SGreg Kroah-Hartman } 28803ee2515SGreg Kroah-Hartman 28903ee2515SGreg Kroah-Hartman /* Issue the request, attempting to read 'size' bytes */ 29003ee2515SGreg Kroah-Hartman result = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0), 291*32445605SPreston Fick request, REQTYPE_INTERFACE_TO_HOST, 0x0000, 2922d5733fcSYuri Matylitski port_priv->bInterfaceNumber, buf, size, 2932d5733fcSYuri Matylitski USB_CTRL_GET_TIMEOUT); 29403ee2515SGreg Kroah-Hartman 29503ee2515SGreg Kroah-Hartman /* Convert data into an array of integers */ 29603ee2515SGreg Kroah-Hartman for (i = 0; i < length; i++) 29703ee2515SGreg Kroah-Hartman data[i] = le32_to_cpu(buf[i]); 29803ee2515SGreg Kroah-Hartman 29903ee2515SGreg Kroah-Hartman kfree(buf); 30003ee2515SGreg Kroah-Hartman 30103ee2515SGreg Kroah-Hartman if (result != size) { 30203ee2515SGreg Kroah-Hartman dbg("%s - Unable to send config request, " 3030b238583SJohan Hovold "request=0x%x size=%d result=%d", 30403ee2515SGreg Kroah-Hartman __func__, request, size, result); 3052479e2a9SJohan Hovold if (result > 0) 3062479e2a9SJohan Hovold result = -EPROTO; 3072479e2a9SJohan Hovold 3082479e2a9SJohan Hovold return result; 30903ee2515SGreg Kroah-Hartman } 31003ee2515SGreg Kroah-Hartman 31103ee2515SGreg Kroah-Hartman return 0; 31203ee2515SGreg Kroah-Hartman } 31303ee2515SGreg Kroah-Hartman 31403ee2515SGreg Kroah-Hartman /* 3154cc27bd6SCraig Shelley * cp210x_set_config 3164cc27bd6SCraig Shelley * Writes to the CP210x configuration registers 31703ee2515SGreg Kroah-Hartman * Values less than 16 bits wide are sent directly 31803ee2515SGreg Kroah-Hartman * 'size' is specified in bytes. 31903ee2515SGreg Kroah-Hartman */ 3204cc27bd6SCraig Shelley static int cp210x_set_config(struct usb_serial_port *port, u8 request, 32103ee2515SGreg Kroah-Hartman unsigned int *data, int size) 32203ee2515SGreg Kroah-Hartman { 32303ee2515SGreg Kroah-Hartman struct usb_serial *serial = port->serial; 324a5360a53SPreston Fick struct cp210x_port_private *port_priv = usb_get_serial_port_data(port); 32503ee2515SGreg Kroah-Hartman __le32 *buf; 32603ee2515SGreg Kroah-Hartman int result, i, length; 32703ee2515SGreg Kroah-Hartman 32803ee2515SGreg Kroah-Hartman /* Number of integers required to contain the array */ 32903ee2515SGreg Kroah-Hartman length = (((size - 1) | 3) + 1)/4; 33003ee2515SGreg Kroah-Hartman 33103ee2515SGreg Kroah-Hartman buf = kmalloc(length * sizeof(__le32), GFP_KERNEL); 33203ee2515SGreg Kroah-Hartman if (!buf) { 33303ee2515SGreg Kroah-Hartman dev_err(&port->dev, "%s - out of memory.\n", 33403ee2515SGreg Kroah-Hartman __func__); 33503ee2515SGreg Kroah-Hartman return -ENOMEM; 33603ee2515SGreg Kroah-Hartman } 33703ee2515SGreg Kroah-Hartman 33803ee2515SGreg Kroah-Hartman /* Array of integers into bytes */ 33903ee2515SGreg Kroah-Hartman for (i = 0; i < length; i++) 34003ee2515SGreg Kroah-Hartman buf[i] = cpu_to_le32(data[i]); 34103ee2515SGreg Kroah-Hartman 34203ee2515SGreg Kroah-Hartman if (size > 2) { 34303ee2515SGreg Kroah-Hartman result = usb_control_msg(serial->dev, 34403ee2515SGreg Kroah-Hartman usb_sndctrlpipe(serial->dev, 0), 345*32445605SPreston Fick request, REQTYPE_HOST_TO_INTERFACE, 0x0000, 3462d5733fcSYuri Matylitski port_priv->bInterfaceNumber, buf, size, 3472d5733fcSYuri Matylitski USB_CTRL_SET_TIMEOUT); 34803ee2515SGreg Kroah-Hartman } else { 34903ee2515SGreg Kroah-Hartman result = usb_control_msg(serial->dev, 35003ee2515SGreg Kroah-Hartman usb_sndctrlpipe(serial->dev, 0), 351*32445605SPreston Fick request, REQTYPE_HOST_TO_INTERFACE, data[0], 3522d5733fcSYuri Matylitski port_priv->bInterfaceNumber, NULL, 0, 3532d5733fcSYuri Matylitski USB_CTRL_SET_TIMEOUT); 35403ee2515SGreg Kroah-Hartman } 35503ee2515SGreg Kroah-Hartman 35603ee2515SGreg Kroah-Hartman kfree(buf); 35703ee2515SGreg Kroah-Hartman 35803ee2515SGreg Kroah-Hartman if ((size > 2 && result != size) || result < 0) { 35903ee2515SGreg Kroah-Hartman dbg("%s - Unable to send request, " 3600b238583SJohan Hovold "request=0x%x size=%d result=%d", 36103ee2515SGreg Kroah-Hartman __func__, request, size, result); 3622479e2a9SJohan Hovold if (result > 0) 3632479e2a9SJohan Hovold result = -EPROTO; 3642479e2a9SJohan Hovold 3652479e2a9SJohan Hovold return result; 36603ee2515SGreg Kroah-Hartman } 36703ee2515SGreg Kroah-Hartman 36803ee2515SGreg Kroah-Hartman return 0; 36903ee2515SGreg Kroah-Hartman } 37003ee2515SGreg Kroah-Hartman 37103ee2515SGreg Kroah-Hartman /* 3724cc27bd6SCraig Shelley * cp210x_set_config_single 3734cc27bd6SCraig Shelley * Convenience function for calling cp210x_set_config on single data values 37403ee2515SGreg Kroah-Hartman * without requiring an integer pointer 37503ee2515SGreg Kroah-Hartman */ 3764cc27bd6SCraig Shelley static inline int cp210x_set_config_single(struct usb_serial_port *port, 37703ee2515SGreg Kroah-Hartman u8 request, unsigned int data) 37803ee2515SGreg Kroah-Hartman { 3794cc27bd6SCraig Shelley return cp210x_set_config(port, request, &data, 2); 38003ee2515SGreg Kroah-Hartman } 38103ee2515SGreg Kroah-Hartman 38203ee2515SGreg Kroah-Hartman /* 3834cc27bd6SCraig Shelley * cp210x_quantise_baudrate 38403ee2515SGreg Kroah-Hartman * Quantises the baud rate as per AN205 Table 1 38503ee2515SGreg Kroah-Hartman */ 3864cc27bd6SCraig Shelley static unsigned int cp210x_quantise_baudrate(unsigned int baud) { 387be125d9cSJohan Hovold if (baud <= 300) 388be125d9cSJohan Hovold baud = 300; 38903ee2515SGreg Kroah-Hartman else if (baud <= 600) baud = 600; 39003ee2515SGreg Kroah-Hartman else if (baud <= 1200) baud = 1200; 39103ee2515SGreg Kroah-Hartman else if (baud <= 1800) baud = 1800; 39203ee2515SGreg Kroah-Hartman else if (baud <= 2400) baud = 2400; 39303ee2515SGreg Kroah-Hartman else if (baud <= 4000) baud = 4000; 39403ee2515SGreg Kroah-Hartman else if (baud <= 4803) baud = 4800; 39503ee2515SGreg Kroah-Hartman else if (baud <= 7207) baud = 7200; 39603ee2515SGreg Kroah-Hartman else if (baud <= 9612) baud = 9600; 39703ee2515SGreg Kroah-Hartman else if (baud <= 14428) baud = 14400; 39803ee2515SGreg Kroah-Hartman else if (baud <= 16062) baud = 16000; 39903ee2515SGreg Kroah-Hartman else if (baud <= 19250) baud = 19200; 40003ee2515SGreg Kroah-Hartman else if (baud <= 28912) baud = 28800; 40103ee2515SGreg Kroah-Hartman else if (baud <= 38601) baud = 38400; 40203ee2515SGreg Kroah-Hartman else if (baud <= 51558) baud = 51200; 40303ee2515SGreg Kroah-Hartman else if (baud <= 56280) baud = 56000; 40403ee2515SGreg Kroah-Hartman else if (baud <= 58053) baud = 57600; 40503ee2515SGreg Kroah-Hartman else if (baud <= 64111) baud = 64000; 40603ee2515SGreg Kroah-Hartman else if (baud <= 77608) baud = 76800; 40703ee2515SGreg Kroah-Hartman else if (baud <= 117028) baud = 115200; 40803ee2515SGreg Kroah-Hartman else if (baud <= 129347) baud = 128000; 40903ee2515SGreg Kroah-Hartman else if (baud <= 156868) baud = 153600; 41003ee2515SGreg Kroah-Hartman else if (baud <= 237832) baud = 230400; 41103ee2515SGreg Kroah-Hartman else if (baud <= 254234) baud = 250000; 41203ee2515SGreg Kroah-Hartman else if (baud <= 273066) baud = 256000; 41303ee2515SGreg Kroah-Hartman else if (baud <= 491520) baud = 460800; 41403ee2515SGreg Kroah-Hartman else if (baud <= 567138) baud = 500000; 41503ee2515SGreg Kroah-Hartman else if (baud <= 670254) baud = 576000; 416d1620ca9SJohan Hovold else if (baud < 1000000) 417d1620ca9SJohan Hovold baud = 921600; 418d1620ca9SJohan Hovold else if (baud > 2000000) 419d1620ca9SJohan Hovold baud = 2000000; 42003ee2515SGreg Kroah-Hartman return baud; 42103ee2515SGreg Kroah-Hartman } 42203ee2515SGreg Kroah-Hartman 423a509a7e4SAlan Cox static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *port) 42403ee2515SGreg Kroah-Hartman { 42503ee2515SGreg Kroah-Hartman int result; 42603ee2515SGreg Kroah-Hartman 42703ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 42803ee2515SGreg Kroah-Hartman 4292479e2a9SJohan Hovold result = cp210x_set_config_single(port, CP210X_IFC_ENABLE, 4302479e2a9SJohan Hovold UART_ENABLE); 4312479e2a9SJohan Hovold if (result) { 4322479e2a9SJohan Hovold dev_err(&port->dev, "%s - Unable to enable UART\n", __func__); 4332479e2a9SJohan Hovold return result; 43403ee2515SGreg Kroah-Hartman } 43503ee2515SGreg Kroah-Hartman 43603ee2515SGreg Kroah-Hartman /* Configure the termios structure */ 4374cc27bd6SCraig Shelley cp210x_get_termios(tty, port); 43855b2afbbSJohan Hovold 439cdc32fd6SJohan Hovold /* The baud rate must be initialised on cp2104 */ 440cdc32fd6SJohan Hovold if (tty) 441cdc32fd6SJohan Hovold cp210x_change_speed(tty, port, NULL); 442cdc32fd6SJohan Hovold 44355b2afbbSJohan Hovold return usb_serial_generic_open(tty, port); 44403ee2515SGreg Kroah-Hartman } 44503ee2515SGreg Kroah-Hartman 4464cc27bd6SCraig Shelley static void cp210x_close(struct usb_serial_port *port) 44703ee2515SGreg Kroah-Hartman { 44803ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 44903ee2515SGreg Kroah-Hartman 450f26788daSJohan Hovold usb_serial_generic_close(port); 45103ee2515SGreg Kroah-Hartman 45203ee2515SGreg Kroah-Hartman mutex_lock(&port->serial->disc_mutex); 45303ee2515SGreg Kroah-Hartman if (!port->serial->disconnected) 4544cc27bd6SCraig Shelley cp210x_set_config_single(port, CP210X_IFC_ENABLE, UART_DISABLE); 45503ee2515SGreg Kroah-Hartman mutex_unlock(&port->serial->disc_mutex); 45603ee2515SGreg Kroah-Hartman } 45703ee2515SGreg Kroah-Hartman 45803ee2515SGreg Kroah-Hartman /* 4594cc27bd6SCraig Shelley * cp210x_get_termios 46003ee2515SGreg Kroah-Hartman * Reads the baud rate, data bits, parity, stop bits and flow control mode 46103ee2515SGreg Kroah-Hartman * from the device, corrects any unsupported values, and configures the 46203ee2515SGreg Kroah-Hartman * termios structure to reflect the state of the device 46303ee2515SGreg Kroah-Hartman */ 4644cc27bd6SCraig Shelley static void cp210x_get_termios(struct tty_struct *tty, 465d2ad67b3SVomLehn struct usb_serial_port *port) 46603ee2515SGreg Kroah-Hartman { 467d2ad67b3SVomLehn unsigned int baud; 468d2ad67b3SVomLehn 469d2ad67b3SVomLehn if (tty) { 4704cc27bd6SCraig Shelley cp210x_get_termios_port(tty->driver_data, 471d2ad67b3SVomLehn &tty->termios->c_cflag, &baud); 472d2ad67b3SVomLehn tty_encode_baud_rate(tty, baud, baud); 473d2ad67b3SVomLehn } 474d2ad67b3SVomLehn 475d2ad67b3SVomLehn else { 476d2ad67b3SVomLehn unsigned int cflag; 477d2ad67b3SVomLehn cflag = 0; 4784cc27bd6SCraig Shelley cp210x_get_termios_port(port, &cflag, &baud); 479d2ad67b3SVomLehn } 480d2ad67b3SVomLehn } 481d2ad67b3SVomLehn 482d2ad67b3SVomLehn /* 4834cc27bd6SCraig Shelley * cp210x_get_termios_port 4844cc27bd6SCraig Shelley * This is the heart of cp210x_get_termios which always uses a &usb_serial_port. 485d2ad67b3SVomLehn */ 4864cc27bd6SCraig Shelley static void cp210x_get_termios_port(struct usb_serial_port *port, 487d2ad67b3SVomLehn unsigned int *cflagp, unsigned int *baudp) 488d2ad67b3SVomLehn { 48903ee2515SGreg Kroah-Hartman unsigned int cflag, modem_ctl[4]; 49003ee2515SGreg Kroah-Hartman unsigned int baud; 49103ee2515SGreg Kroah-Hartman unsigned int bits; 49203ee2515SGreg Kroah-Hartman 49303ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 49403ee2515SGreg Kroah-Hartman 4957f482fc8SPreston Fick cp210x_get_config(port, CP210X_GET_BAUDRATE, &baud, 4); 49603ee2515SGreg Kroah-Hartman 49703ee2515SGreg Kroah-Hartman dbg("%s - baud rate = %d", __func__, baud); 498d2ad67b3SVomLehn *baudp = baud; 49903ee2515SGreg Kroah-Hartman 500d2ad67b3SVomLehn cflag = *cflagp; 50103ee2515SGreg Kroah-Hartman 5024cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2); 50303ee2515SGreg Kroah-Hartman cflag &= ~CSIZE; 50403ee2515SGreg Kroah-Hartman switch (bits & BITS_DATA_MASK) { 50503ee2515SGreg Kroah-Hartman case BITS_DATA_5: 50603ee2515SGreg Kroah-Hartman dbg("%s - data bits = 5", __func__); 50703ee2515SGreg Kroah-Hartman cflag |= CS5; 50803ee2515SGreg Kroah-Hartman break; 50903ee2515SGreg Kroah-Hartman case BITS_DATA_6: 51003ee2515SGreg Kroah-Hartman dbg("%s - data bits = 6", __func__); 51103ee2515SGreg Kroah-Hartman cflag |= CS6; 51203ee2515SGreg Kroah-Hartman break; 51303ee2515SGreg Kroah-Hartman case BITS_DATA_7: 51403ee2515SGreg Kroah-Hartman dbg("%s - data bits = 7", __func__); 51503ee2515SGreg Kroah-Hartman cflag |= CS7; 51603ee2515SGreg Kroah-Hartman break; 51703ee2515SGreg Kroah-Hartman case BITS_DATA_8: 51803ee2515SGreg Kroah-Hartman dbg("%s - data bits = 8", __func__); 51903ee2515SGreg Kroah-Hartman cflag |= CS8; 52003ee2515SGreg Kroah-Hartman break; 52103ee2515SGreg Kroah-Hartman case BITS_DATA_9: 52203ee2515SGreg Kroah-Hartman dbg("%s - data bits = 9 (not supported, using 8 data bits)", 52303ee2515SGreg Kroah-Hartman __func__); 52403ee2515SGreg Kroah-Hartman cflag |= CS8; 52503ee2515SGreg Kroah-Hartman bits &= ~BITS_DATA_MASK; 52603ee2515SGreg Kroah-Hartman bits |= BITS_DATA_8; 5274cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2); 52803ee2515SGreg Kroah-Hartman break; 52903ee2515SGreg Kroah-Hartman default: 53003ee2515SGreg Kroah-Hartman dbg("%s - Unknown number of data bits, using 8", __func__); 53103ee2515SGreg Kroah-Hartman cflag |= CS8; 53203ee2515SGreg Kroah-Hartman bits &= ~BITS_DATA_MASK; 53303ee2515SGreg Kroah-Hartman bits |= BITS_DATA_8; 5344cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2); 53503ee2515SGreg Kroah-Hartman break; 53603ee2515SGreg Kroah-Hartman } 53703ee2515SGreg Kroah-Hartman 53803ee2515SGreg Kroah-Hartman switch (bits & BITS_PARITY_MASK) { 53903ee2515SGreg Kroah-Hartman case BITS_PARITY_NONE: 54003ee2515SGreg Kroah-Hartman dbg("%s - parity = NONE", __func__); 54103ee2515SGreg Kroah-Hartman cflag &= ~PARENB; 54203ee2515SGreg Kroah-Hartman break; 54303ee2515SGreg Kroah-Hartman case BITS_PARITY_ODD: 54403ee2515SGreg Kroah-Hartman dbg("%s - parity = ODD", __func__); 54503ee2515SGreg Kroah-Hartman cflag |= (PARENB|PARODD); 54603ee2515SGreg Kroah-Hartman break; 54703ee2515SGreg Kroah-Hartman case BITS_PARITY_EVEN: 54803ee2515SGreg Kroah-Hartman dbg("%s - parity = EVEN", __func__); 54903ee2515SGreg Kroah-Hartman cflag &= ~PARODD; 55003ee2515SGreg Kroah-Hartman cflag |= PARENB; 55103ee2515SGreg Kroah-Hartman break; 55203ee2515SGreg Kroah-Hartman case BITS_PARITY_MARK: 5534b6181caSRoland Koebler dbg("%s - parity = MARK", __func__); 5544b6181caSRoland Koebler cflag |= (PARENB|PARODD|CMSPAR); 55503ee2515SGreg Kroah-Hartman break; 55603ee2515SGreg Kroah-Hartman case BITS_PARITY_SPACE: 5574b6181caSRoland Koebler dbg("%s - parity = SPACE", __func__); 5584b6181caSRoland Koebler cflag &= ~PARODD; 5594b6181caSRoland Koebler cflag |= (PARENB|CMSPAR); 56003ee2515SGreg Kroah-Hartman break; 56103ee2515SGreg Kroah-Hartman default: 56203ee2515SGreg Kroah-Hartman dbg("%s - Unknown parity mode, disabling parity", __func__); 56303ee2515SGreg Kroah-Hartman cflag &= ~PARENB; 56403ee2515SGreg Kroah-Hartman bits &= ~BITS_PARITY_MASK; 5654cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2); 56603ee2515SGreg Kroah-Hartman break; 56703ee2515SGreg Kroah-Hartman } 56803ee2515SGreg Kroah-Hartman 56903ee2515SGreg Kroah-Hartman cflag &= ~CSTOPB; 57003ee2515SGreg Kroah-Hartman switch (bits & BITS_STOP_MASK) { 57103ee2515SGreg Kroah-Hartman case BITS_STOP_1: 57203ee2515SGreg Kroah-Hartman dbg("%s - stop bits = 1", __func__); 57303ee2515SGreg Kroah-Hartman break; 57403ee2515SGreg Kroah-Hartman case BITS_STOP_1_5: 57503ee2515SGreg Kroah-Hartman dbg("%s - stop bits = 1.5 (not supported, using 1 stop bit)", 57603ee2515SGreg Kroah-Hartman __func__); 57703ee2515SGreg Kroah-Hartman bits &= ~BITS_STOP_MASK; 5784cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2); 57903ee2515SGreg Kroah-Hartman break; 58003ee2515SGreg Kroah-Hartman case BITS_STOP_2: 58103ee2515SGreg Kroah-Hartman dbg("%s - stop bits = 2", __func__); 58203ee2515SGreg Kroah-Hartman cflag |= CSTOPB; 58303ee2515SGreg Kroah-Hartman break; 58403ee2515SGreg Kroah-Hartman default: 58503ee2515SGreg Kroah-Hartman dbg("%s - Unknown number of stop bits, using 1 stop bit", 58603ee2515SGreg Kroah-Hartman __func__); 58703ee2515SGreg Kroah-Hartman bits &= ~BITS_STOP_MASK; 5884cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2); 58903ee2515SGreg Kroah-Hartman break; 59003ee2515SGreg Kroah-Hartman } 59103ee2515SGreg Kroah-Hartman 5924cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16); 59303ee2515SGreg Kroah-Hartman if (modem_ctl[0] & 0x0008) { 59403ee2515SGreg Kroah-Hartman dbg("%s - flow control = CRTSCTS", __func__); 59503ee2515SGreg Kroah-Hartman cflag |= CRTSCTS; 59603ee2515SGreg Kroah-Hartman } else { 59703ee2515SGreg Kroah-Hartman dbg("%s - flow control = NONE", __func__); 59803ee2515SGreg Kroah-Hartman cflag &= ~CRTSCTS; 59903ee2515SGreg Kroah-Hartman } 60003ee2515SGreg Kroah-Hartman 601d2ad67b3SVomLehn *cflagp = cflag; 60203ee2515SGreg Kroah-Hartman } 60303ee2515SGreg Kroah-Hartman 604e5990874SJohan Hovold /* 605e5990874SJohan Hovold * CP2101 supports the following baud rates: 606e5990874SJohan Hovold * 607e5990874SJohan Hovold * 300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 14400, 19200, 28800, 608e5990874SJohan Hovold * 38400, 56000, 57600, 115200, 128000, 230400, 460800, 921600 609e5990874SJohan Hovold * 610e5990874SJohan Hovold * CP2102 and CP2103 support the following additional rates: 611e5990874SJohan Hovold * 612e5990874SJohan Hovold * 4000, 16000, 51200, 64000, 76800, 153600, 250000, 256000, 500000, 613e5990874SJohan Hovold * 576000 614e5990874SJohan Hovold * 615e5990874SJohan Hovold * The device will map a requested rate to a supported one, but the result 616e5990874SJohan Hovold * of requests for rates greater than 1053257 is undefined (see AN205). 617e5990874SJohan Hovold * 618e5990874SJohan Hovold * CP2104, CP2105 and CP2110 support most rates up to 2M, 921k and 1M baud, 619e5990874SJohan Hovold * respectively, with an error less than 1%. The actual rates are determined 620e5990874SJohan Hovold * by 621e5990874SJohan Hovold * 622e5990874SJohan Hovold * div = round(freq / (2 x prescale x request)) 623e5990874SJohan Hovold * actual = freq / (2 x prescale x div) 624e5990874SJohan Hovold * 625e5990874SJohan Hovold * For CP2104 and CP2105 freq is 48Mhz and prescale is 4 for request <= 365bps 626e5990874SJohan Hovold * or 1 otherwise. 627e5990874SJohan Hovold * For CP2110 freq is 24Mhz and prescale is 4 for request <= 300bps or 1 628e5990874SJohan Hovold * otherwise. 629e5990874SJohan Hovold */ 630e5990874SJohan Hovold static void cp210x_change_speed(struct tty_struct *tty, 631e5990874SJohan Hovold struct usb_serial_port *port, struct ktermios *old_termios) 632e5990874SJohan Hovold { 633e5990874SJohan Hovold u32 baud; 634e5990874SJohan Hovold 635e5990874SJohan Hovold baud = tty->termios->c_ospeed; 636e5990874SJohan Hovold 637d1620ca9SJohan Hovold /* This maps the requested rate to a rate valid on cp2102 or cp2103, 638d1620ca9SJohan Hovold * or to an arbitrary rate in [1M,2M]. 639e5990874SJohan Hovold * 640e5990874SJohan Hovold * NOTE: B0 is not implemented. 641e5990874SJohan Hovold */ 642e5990874SJohan Hovold baud = cp210x_quantise_baudrate(baud); 643e5990874SJohan Hovold 644e5990874SJohan Hovold dbg("%s - setting baud rate to %u", __func__, baud); 645e5990874SJohan Hovold if (cp210x_set_config(port, CP210X_SET_BAUDRATE, &baud, 646e5990874SJohan Hovold sizeof(baud))) { 647e5990874SJohan Hovold dev_warn(&port->dev, "failed to set baud rate to %u\n", baud); 648e5990874SJohan Hovold if (old_termios) 649e5990874SJohan Hovold baud = old_termios->c_ospeed; 650e5990874SJohan Hovold else 651e5990874SJohan Hovold baud = 9600; 652e5990874SJohan Hovold } 653e5990874SJohan Hovold 654e5990874SJohan Hovold tty_encode_baud_rate(tty, baud, baud); 655e5990874SJohan Hovold } 656e5990874SJohan Hovold 6574cc27bd6SCraig Shelley static void cp210x_set_termios(struct tty_struct *tty, 65803ee2515SGreg Kroah-Hartman struct usb_serial_port *port, struct ktermios *old_termios) 65903ee2515SGreg Kroah-Hartman { 66003ee2515SGreg Kroah-Hartman unsigned int cflag, old_cflag; 66134b76fcaSJohan Hovold unsigned int bits; 66203ee2515SGreg Kroah-Hartman unsigned int modem_ctl[4]; 66303ee2515SGreg Kroah-Hartman 66403ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 66503ee2515SGreg Kroah-Hartman 66603ee2515SGreg Kroah-Hartman if (!tty) 66703ee2515SGreg Kroah-Hartman return; 66803ee2515SGreg Kroah-Hartman 66903ee2515SGreg Kroah-Hartman cflag = tty->termios->c_cflag; 67003ee2515SGreg Kroah-Hartman old_cflag = old_termios->c_cflag; 67103ee2515SGreg Kroah-Hartman 672e5990874SJohan Hovold if (tty->termios->c_ospeed != old_termios->c_ospeed) 673e5990874SJohan Hovold cp210x_change_speed(tty, port, old_termios); 67403ee2515SGreg Kroah-Hartman 67503ee2515SGreg Kroah-Hartman /* If the number of data bits is to be updated */ 67603ee2515SGreg Kroah-Hartman if ((cflag & CSIZE) != (old_cflag & CSIZE)) { 6774cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2); 67803ee2515SGreg Kroah-Hartman bits &= ~BITS_DATA_MASK; 67903ee2515SGreg Kroah-Hartman switch (cflag & CSIZE) { 68003ee2515SGreg Kroah-Hartman case CS5: 68103ee2515SGreg Kroah-Hartman bits |= BITS_DATA_5; 68203ee2515SGreg Kroah-Hartman dbg("%s - data bits = 5", __func__); 68303ee2515SGreg Kroah-Hartman break; 68403ee2515SGreg Kroah-Hartman case CS6: 68503ee2515SGreg Kroah-Hartman bits |= BITS_DATA_6; 68603ee2515SGreg Kroah-Hartman dbg("%s - data bits = 6", __func__); 68703ee2515SGreg Kroah-Hartman break; 68803ee2515SGreg Kroah-Hartman case CS7: 68903ee2515SGreg Kroah-Hartman bits |= BITS_DATA_7; 69003ee2515SGreg Kroah-Hartman dbg("%s - data bits = 7", __func__); 69103ee2515SGreg Kroah-Hartman break; 69203ee2515SGreg Kroah-Hartman case CS8: 69303ee2515SGreg Kroah-Hartman bits |= BITS_DATA_8; 69403ee2515SGreg Kroah-Hartman dbg("%s - data bits = 8", __func__); 69503ee2515SGreg Kroah-Hartman break; 69603ee2515SGreg Kroah-Hartman /*case CS9: 69703ee2515SGreg Kroah-Hartman bits |= BITS_DATA_9; 69803ee2515SGreg Kroah-Hartman dbg("%s - data bits = 9", __func__); 69903ee2515SGreg Kroah-Hartman break;*/ 70003ee2515SGreg Kroah-Hartman default: 7014cc27bd6SCraig Shelley dbg("cp210x driver does not " 70203ee2515SGreg Kroah-Hartman "support the number of bits requested," 7030b238583SJohan Hovold " using 8 bit mode"); 70403ee2515SGreg Kroah-Hartman bits |= BITS_DATA_8; 70503ee2515SGreg Kroah-Hartman break; 70603ee2515SGreg Kroah-Hartman } 7074cc27bd6SCraig Shelley if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2)) 70803ee2515SGreg Kroah-Hartman dbg("Number of data bits requested " 7090b238583SJohan Hovold "not supported by device"); 71003ee2515SGreg Kroah-Hartman } 71103ee2515SGreg Kroah-Hartman 7124b6181caSRoland Koebler if ((cflag & (PARENB|PARODD|CMSPAR)) != 7134b6181caSRoland Koebler (old_cflag & (PARENB|PARODD|CMSPAR))) { 7144cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2); 71503ee2515SGreg Kroah-Hartman bits &= ~BITS_PARITY_MASK; 71603ee2515SGreg Kroah-Hartman if (cflag & PARENB) { 7174b6181caSRoland Koebler if (cflag & CMSPAR) { 7184b6181caSRoland Koebler if (cflag & PARODD) { 7194b6181caSRoland Koebler bits |= BITS_PARITY_MARK; 7204b6181caSRoland Koebler dbg("%s - parity = MARK", __func__); 7214b6181caSRoland Koebler } else { 7224b6181caSRoland Koebler bits |= BITS_PARITY_SPACE; 7234b6181caSRoland Koebler dbg("%s - parity = SPACE", __func__); 7244b6181caSRoland Koebler } 7254b6181caSRoland Koebler } else { 72603ee2515SGreg Kroah-Hartman if (cflag & PARODD) { 72703ee2515SGreg Kroah-Hartman bits |= BITS_PARITY_ODD; 72803ee2515SGreg Kroah-Hartman dbg("%s - parity = ODD", __func__); 72903ee2515SGreg Kroah-Hartman } else { 73003ee2515SGreg Kroah-Hartman bits |= BITS_PARITY_EVEN; 73103ee2515SGreg Kroah-Hartman dbg("%s - parity = EVEN", __func__); 73203ee2515SGreg Kroah-Hartman } 73303ee2515SGreg Kroah-Hartman } 7344b6181caSRoland Koebler } 7354cc27bd6SCraig Shelley if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2)) 7360b238583SJohan Hovold dbg("Parity mode not supported by device"); 73703ee2515SGreg Kroah-Hartman } 73803ee2515SGreg Kroah-Hartman 73903ee2515SGreg Kroah-Hartman if ((cflag & CSTOPB) != (old_cflag & CSTOPB)) { 7404cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2); 74103ee2515SGreg Kroah-Hartman bits &= ~BITS_STOP_MASK; 74203ee2515SGreg Kroah-Hartman if (cflag & CSTOPB) { 74303ee2515SGreg Kroah-Hartman bits |= BITS_STOP_2; 74403ee2515SGreg Kroah-Hartman dbg("%s - stop bits = 2", __func__); 74503ee2515SGreg Kroah-Hartman } else { 74603ee2515SGreg Kroah-Hartman bits |= BITS_STOP_1; 74703ee2515SGreg Kroah-Hartman dbg("%s - stop bits = 1", __func__); 74803ee2515SGreg Kroah-Hartman } 7494cc27bd6SCraig Shelley if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2)) 75003ee2515SGreg Kroah-Hartman dbg("Number of stop bits requested " 7510b238583SJohan Hovold "not supported by device"); 75203ee2515SGreg Kroah-Hartman } 75303ee2515SGreg Kroah-Hartman 75403ee2515SGreg Kroah-Hartman if ((cflag & CRTSCTS) != (old_cflag & CRTSCTS)) { 7554cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16); 75603ee2515SGreg Kroah-Hartman dbg("%s - read modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x", 75703ee2515SGreg Kroah-Hartman __func__, modem_ctl[0], modem_ctl[1], 75803ee2515SGreg Kroah-Hartman modem_ctl[2], modem_ctl[3]); 75903ee2515SGreg Kroah-Hartman 76003ee2515SGreg Kroah-Hartman if (cflag & CRTSCTS) { 76103ee2515SGreg Kroah-Hartman modem_ctl[0] &= ~0x7B; 76203ee2515SGreg Kroah-Hartman modem_ctl[0] |= 0x09; 76303ee2515SGreg Kroah-Hartman modem_ctl[1] = 0x80; 76403ee2515SGreg Kroah-Hartman dbg("%s - flow control = CRTSCTS", __func__); 76503ee2515SGreg Kroah-Hartman } else { 76603ee2515SGreg Kroah-Hartman modem_ctl[0] &= ~0x7B; 76703ee2515SGreg Kroah-Hartman modem_ctl[0] |= 0x01; 76803ee2515SGreg Kroah-Hartman modem_ctl[1] |= 0x40; 76903ee2515SGreg Kroah-Hartman dbg("%s - flow control = NONE", __func__); 77003ee2515SGreg Kroah-Hartman } 77103ee2515SGreg Kroah-Hartman 77203ee2515SGreg Kroah-Hartman dbg("%s - write modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x", 77303ee2515SGreg Kroah-Hartman __func__, modem_ctl[0], modem_ctl[1], 77403ee2515SGreg Kroah-Hartman modem_ctl[2], modem_ctl[3]); 7754cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_FLOW, modem_ctl, 16); 77603ee2515SGreg Kroah-Hartman } 77703ee2515SGreg Kroah-Hartman 77803ee2515SGreg Kroah-Hartman } 77903ee2515SGreg Kroah-Hartman 78020b9d177SAlan Cox static int cp210x_tiocmset (struct tty_struct *tty, 78103ee2515SGreg Kroah-Hartman unsigned int set, unsigned int clear) 78203ee2515SGreg Kroah-Hartman { 78303ee2515SGreg Kroah-Hartman struct usb_serial_port *port = tty->driver_data; 78420b9d177SAlan Cox return cp210x_tiocmset_port(port, set, clear); 785d2ad67b3SVomLehn } 786d2ad67b3SVomLehn 78720b9d177SAlan Cox static int cp210x_tiocmset_port(struct usb_serial_port *port, 788d2ad67b3SVomLehn unsigned int set, unsigned int clear) 789d2ad67b3SVomLehn { 79003ee2515SGreg Kroah-Hartman unsigned int control = 0; 79103ee2515SGreg Kroah-Hartman 79203ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 79303ee2515SGreg Kroah-Hartman 79403ee2515SGreg Kroah-Hartman if (set & TIOCM_RTS) { 79503ee2515SGreg Kroah-Hartman control |= CONTROL_RTS; 79603ee2515SGreg Kroah-Hartman control |= CONTROL_WRITE_RTS; 79703ee2515SGreg Kroah-Hartman } 79803ee2515SGreg Kroah-Hartman if (set & TIOCM_DTR) { 79903ee2515SGreg Kroah-Hartman control |= CONTROL_DTR; 80003ee2515SGreg Kroah-Hartman control |= CONTROL_WRITE_DTR; 80103ee2515SGreg Kroah-Hartman } 80203ee2515SGreg Kroah-Hartman if (clear & TIOCM_RTS) { 80303ee2515SGreg Kroah-Hartman control &= ~CONTROL_RTS; 80403ee2515SGreg Kroah-Hartman control |= CONTROL_WRITE_RTS; 80503ee2515SGreg Kroah-Hartman } 80603ee2515SGreg Kroah-Hartman if (clear & TIOCM_DTR) { 80703ee2515SGreg Kroah-Hartman control &= ~CONTROL_DTR; 80803ee2515SGreg Kroah-Hartman control |= CONTROL_WRITE_DTR; 80903ee2515SGreg Kroah-Hartman } 81003ee2515SGreg Kroah-Hartman 81103ee2515SGreg Kroah-Hartman dbg("%s - control = 0x%.4x", __func__, control); 81203ee2515SGreg Kroah-Hartman 8134cc27bd6SCraig Shelley return cp210x_set_config(port, CP210X_SET_MHS, &control, 2); 81403ee2515SGreg Kroah-Hartman } 81503ee2515SGreg Kroah-Hartman 816d94c7bd4SAlan Cox static void cp210x_dtr_rts(struct usb_serial_port *p, int on) 817d94c7bd4SAlan Cox { 818d94c7bd4SAlan Cox if (on) 81920b9d177SAlan Cox cp210x_tiocmset_port(p, TIOCM_DTR|TIOCM_RTS, 0); 820d94c7bd4SAlan Cox else 82120b9d177SAlan Cox cp210x_tiocmset_port(p, 0, TIOCM_DTR|TIOCM_RTS); 822d94c7bd4SAlan Cox } 823d94c7bd4SAlan Cox 82460b33c13SAlan Cox static int cp210x_tiocmget (struct tty_struct *tty) 82503ee2515SGreg Kroah-Hartman { 82603ee2515SGreg Kroah-Hartman struct usb_serial_port *port = tty->driver_data; 82703ee2515SGreg Kroah-Hartman unsigned int control; 82803ee2515SGreg Kroah-Hartman int result; 82903ee2515SGreg Kroah-Hartman 83003ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 83103ee2515SGreg Kroah-Hartman 8324cc27bd6SCraig Shelley cp210x_get_config(port, CP210X_GET_MDMSTS, &control, 1); 83303ee2515SGreg Kroah-Hartman 83403ee2515SGreg Kroah-Hartman result = ((control & CONTROL_DTR) ? TIOCM_DTR : 0) 83503ee2515SGreg Kroah-Hartman |((control & CONTROL_RTS) ? TIOCM_RTS : 0) 83603ee2515SGreg Kroah-Hartman |((control & CONTROL_CTS) ? TIOCM_CTS : 0) 83703ee2515SGreg Kroah-Hartman |((control & CONTROL_DSR) ? TIOCM_DSR : 0) 83803ee2515SGreg Kroah-Hartman |((control & CONTROL_RING)? TIOCM_RI : 0) 83903ee2515SGreg Kroah-Hartman |((control & CONTROL_DCD) ? TIOCM_CD : 0); 84003ee2515SGreg Kroah-Hartman 84103ee2515SGreg Kroah-Hartman dbg("%s - control = 0x%.2x", __func__, control); 84203ee2515SGreg Kroah-Hartman 84303ee2515SGreg Kroah-Hartman return result; 84403ee2515SGreg Kroah-Hartman } 84503ee2515SGreg Kroah-Hartman 8464cc27bd6SCraig Shelley static void cp210x_break_ctl (struct tty_struct *tty, int break_state) 84703ee2515SGreg Kroah-Hartman { 84803ee2515SGreg Kroah-Hartman struct usb_serial_port *port = tty->driver_data; 84903ee2515SGreg Kroah-Hartman unsigned int state; 85003ee2515SGreg Kroah-Hartman 85103ee2515SGreg Kroah-Hartman dbg("%s - port %d", __func__, port->number); 85203ee2515SGreg Kroah-Hartman if (break_state == 0) 85303ee2515SGreg Kroah-Hartman state = BREAK_OFF; 85403ee2515SGreg Kroah-Hartman else 85503ee2515SGreg Kroah-Hartman state = BREAK_ON; 85603ee2515SGreg Kroah-Hartman dbg("%s - turning break %s", __func__, 85703ee2515SGreg Kroah-Hartman state == BREAK_OFF ? "off" : "on"); 8584cc27bd6SCraig Shelley cp210x_set_config(port, CP210X_SET_BREAK, &state, 2); 85903ee2515SGreg Kroah-Hartman } 86003ee2515SGreg Kroah-Hartman 8614cc27bd6SCraig Shelley static int cp210x_startup(struct usb_serial *serial) 86203ee2515SGreg Kroah-Hartman { 863a5360a53SPreston Fick struct cp210x_port_private *port_priv; 864a5360a53SPreston Fick int i; 865a5360a53SPreston Fick 8664cc27bd6SCraig Shelley /* cp210x buffers behave strangely unless device is reset */ 86703ee2515SGreg Kroah-Hartman usb_reset_device(serial->dev); 868a5360a53SPreston Fick 869a5360a53SPreston Fick for (i = 0; i < serial->num_ports; i++) { 870a5360a53SPreston Fick port_priv = kzalloc(sizeof(*port_priv), GFP_KERNEL); 871a5360a53SPreston Fick if (!port_priv) 872a5360a53SPreston Fick return -ENOMEM; 873a5360a53SPreston Fick 874a5360a53SPreston Fick memset(port_priv, 0x00, sizeof(*port_priv)); 875a5360a53SPreston Fick port_priv->bInterfaceNumber = 876a5360a53SPreston Fick serial->interface->cur_altsetting->desc.bInterfaceNumber; 877a5360a53SPreston Fick 878a5360a53SPreston Fick usb_set_serial_port_data(serial->port[i], port_priv); 879a5360a53SPreston Fick } 880a5360a53SPreston Fick 88103ee2515SGreg Kroah-Hartman return 0; 88203ee2515SGreg Kroah-Hartman } 88303ee2515SGreg Kroah-Hartman 884a5360a53SPreston Fick static void cp210x_release(struct usb_serial *serial) 885a5360a53SPreston Fick { 886a5360a53SPreston Fick struct cp210x_port_private *port_priv; 887a5360a53SPreston Fick int i; 888a5360a53SPreston Fick 889a5360a53SPreston Fick for (i = 0; i < serial->num_ports; i++) { 890a5360a53SPreston Fick port_priv = usb_get_serial_port_data(serial->port[i]); 891a5360a53SPreston Fick kfree(port_priv); 892a5360a53SPreston Fick usb_set_serial_port_data(serial->port[i], NULL); 893a5360a53SPreston Fick } 894a5360a53SPreston Fick } 895a5360a53SPreston Fick 896274f3b1eSGreg Kroah-Hartman module_usb_serial_driver(cp210x_driver, serial_drivers); 89703ee2515SGreg Kroah-Hartman 89803ee2515SGreg Kroah-Hartman MODULE_DESCRIPTION(DRIVER_DESC); 89903ee2515SGreg Kroah-Hartman MODULE_VERSION(DRIVER_VERSION); 90003ee2515SGreg Kroah-Hartman MODULE_LICENSE("GPL"); 90103ee2515SGreg Kroah-Hartman 90203ee2515SGreg Kroah-Hartman module_param(debug, bool, S_IRUGO | S_IWUSR); 90303ee2515SGreg Kroah-Hartman MODULE_PARM_DESC(debug, "Enable verbose debugging messages"); 904