drivers/usb/serial/cp210x.c

   1 /*
   2  * Silicon Laboratories CP210x USB to RS232 serial adaptor driver
   3  *
   4  * Copyright (C) 2005 Craig Shelley (craig@microtron.org.uk)
   5  *
   6  *      This program is free software; you can redistribute it and/or
   7  *      modify it under the terms of the GNU General Public License version
   8  *      2 as published by the Free Software Foundation.
   9  *
  10  * Support to set flow control line levels using TIOCMGET and TIOCMSET
  11  * thanks to Karl Hiramoto karl@hiramoto.org. RTSCTS hardware flow
  12  * control thanks to Munir Nassar nassarmu@real-time.com
  13  *
  14  */
  15
  16 #include <linux/kernel.h>
  17 #include <linux/errno.h>
  18 #include <linux/slab.h>
  19 #include <linux/tty.h>
  20 #include <linux/tty_flip.h>
  21 #include <linux/module.h>
  22 #include <linux/moduleparam.h>
  23 #include <linux/usb.h>
  24 #include <linux/uaccess.h>
  25 #include <linux/usb/serial.h>
  26
  27 #define DRIVER_DESC "Silicon Labs CP210x RS232 serial adaptor driver"
  28
  29 /*
  30  * Function Prototypes
  31  */
  32 static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *);
  33 static void cp210x_close(struct usb_serial_port *);
  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 static void cp210x_change_speed(struct tty_struct *, struct usb_serial_port *,
  38                                                         struct ktermios *);
  39 static void cp210x_set_termios(struct tty_struct *, struct usb_serial_port *,
  40                                                         struct ktermios*);
  41 static int cp210x_tiocmget(struct tty_struct *);
  42 static int cp210x_tiocmset(struct tty_struct *, unsigned int, unsigned int);
  43 static int cp210x_tiocmset_port(struct usb_serial_port *port,
  44                 unsigned int, unsigned int);
  45 static void cp210x_break_ctl(struct tty_struct *, int);
  46 static int cp210x_startup(struct usb_serial *);
  47 static void cp210x_release(struct usb_serial *);
  48 static void cp210x_dtr_rts(struct usb_serial_port *p, int on);
  49
  50 static const struct usb_device_id id_table[] = {
  51         { USB_DEVICE(0x045B, 0x0053) }, /* Renesas RX610 RX-Stick */
  52         { USB_DEVICE(0x0471, 0x066A) }, /* AKTAKOM ACE-1001 cable */
  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 */
  55         { USB_DEVICE(0x0745, 0x1000) }, /* CipherLab USB CCD Barcode Scanner 1000 */
  56         { USB_DEVICE(0x0846, 0x1100) }, /* NetGear Managed Switch M4100 series, M5300 series, M7100 series */
  57         { USB_DEVICE(0x08e6, 0x5501) }, /* Gemalto Prox-PU/CU contactless smartcard reader */
  58         { USB_DEVICE(0x08FD, 0x000A) }, /* Digianswer A/S , ZigBee/802.15.4 MAC Device */
  59         { USB_DEVICE(0x0908, 0x01FF) }, /* Siemens RUGGEDCOM USB Serial Console */
  60         { USB_DEVICE(0x0BED, 0x1100) }, /* MEI (TM) Cashflow-SC Bill/Voucher Acceptor */
  61         { USB_DEVICE(0x0BED, 0x1101) }, /* MEI series 2000 Combo Acceptor */
  62         { USB_DEVICE(0x0FCF, 0x1003) }, /* Dynastream ANT development board */
  63         { USB_DEVICE(0x0FCF, 0x1004) }, /* Dynastream ANT2USB */
  64         { USB_DEVICE(0x0FCF, 0x1006) }, /* Dynastream ANT development board */
  65         { USB_DEVICE(0x0FDE, 0xCA05) }, /* OWL Wireless Electricity Monitor CM-160 */
  66         { USB_DEVICE(0x10A6, 0xAA26) }, /* Knock-off DCU-11 cable */
  67         { USB_DEVICE(0x10AB, 0x10C5) }, /* Siemens MC60 Cable */
  68         { USB_DEVICE(0x10B5, 0xAC70) }, /* Nokia CA-42 USB */
  69         { USB_DEVICE(0x10C4, 0x0F91) }, /* Vstabi */
  70         { USB_DEVICE(0x10C4, 0x1101) }, /* Arkham Technology DS101 Bus Monitor */
  71         { USB_DEVICE(0x10C4, 0x1601) }, /* Arkham Technology DS101 Adapter */
  72         { USB_DEVICE(0x10C4, 0x800A) }, /* SPORTident BSM7-D-USB main station */
  73         { USB_DEVICE(0x10C4, 0x803B) }, /* Pololu USB-serial converter */
  74         { USB_DEVICE(0x10C4, 0x8044) }, /* Cygnal Debug Adapter */
  75         { USB_DEVICE(0x10C4, 0x804E) }, /* Software Bisque Paramount ME build-in converter */
  76         { USB_DEVICE(0x10C4, 0x8053) }, /* Enfora EDG1228 */
  77         { USB_DEVICE(0x10C4, 0x8054) }, /* Enfora GSM2228 */
  78         { USB_DEVICE(0x10C4, 0x8066) }, /* Argussoft In-System Programmer */
  79         { USB_DEVICE(0x10C4, 0x806F) }, /* IMS USB to RS422 Converter Cable */
  80         { USB_DEVICE(0x10C4, 0x807A) }, /* Crumb128 board */
  81         { USB_DEVICE(0x10C4, 0x80C4) }, /* Cygnal Integrated Products, Inc., Optris infrared thermometer */
  82         { USB_DEVICE(0x10C4, 0x80CA) }, /* Degree Controls Inc */
  83         { USB_DEVICE(0x10C4, 0x80DD) }, /* Tracient RFID */
  84         { USB_DEVICE(0x10C4, 0x80F6) }, /* Suunto sports instrument */
  85         { USB_DEVICE(0x10C4, 0x8115) }, /* Arygon NFC/Mifare Reader */
  86         { USB_DEVICE(0x10C4, 0x813D) }, /* Burnside Telecom Deskmobile */
  87         { USB_DEVICE(0x10C4, 0x813F) }, /* Tams Master Easy Control */
  88         { USB_DEVICE(0x10C4, 0x814A) }, /* West Mountain Radio RIGblaster P&P */
  89         { USB_DEVICE(0x10C4, 0x814B) }, /* West Mountain Radio RIGtalk */
  90         { USB_DEVICE(0x2405, 0x0003) }, /* West Mountain Radio RIGblaster Advantage */
  91         { USB_DEVICE(0x10C4, 0x8156) }, /* B&G H3000 link cable */
  92         { USB_DEVICE(0x10C4, 0x815E) }, /* Helicomm IP-Link 1220-DVM */
  93         { USB_DEVICE(0x10C4, 0x815F) }, /* Timewave HamLinkUSB */
  94         { USB_DEVICE(0x10C4, 0x818B) }, /* AVIT Research USB to TTL */
  95         { USB_DEVICE(0x10C4, 0x819F) }, /* MJS USB Toslink Switcher */
  96         { USB_DEVICE(0x10C4, 0x81A6) }, /* ThinkOptics WavIt */
  97         { USB_DEVICE(0x10C4, 0x81A9) }, /* Multiplex RC Interface */
  98         { USB_DEVICE(0x10C4, 0x81AC) }, /* MSD Dash Hawk */
  99         { USB_DEVICE(0x10C4, 0x81AD) }, /* INSYS USB Modem */
 100         { USB_DEVICE(0x10C4, 0x81C8) }, /* Lipowsky Industrie Elektronik GmbH, Baby-JTAG */
 101         { USB_DEVICE(0x10C4, 0x81D7) }, /* IAI Corp. RCB-CV-USB USB to RS485 Adaptor */
 102         { USB_DEVICE(0x10C4, 0x81E2) }, /* Lipowsky Industrie Elektronik GmbH, Baby-LIN */
 103         { USB_DEVICE(0x10C4, 0x81E7) }, /* Aerocomm Radio */
 104         { USB_DEVICE(0x10C4, 0x81E8) }, /* Zephyr Bioharness */
 105         { USB_DEVICE(0x10C4, 0x81F2) }, /* C1007 HF band RFID controller */
 106         { USB_DEVICE(0x10C4, 0x8218) }, /* Lipowsky Industrie Elektronik GmbH, HARP-1 */
 107         { USB_DEVICE(0x10C4, 0x822B) }, /* Modem EDGE(GSM) Comander 2 */
 108         { USB_DEVICE(0x10C4, 0x826B) }, /* Cygnal Integrated Products, Inc., Fasttrax GPS demonstration module */
 109         { USB_DEVICE(0x10C4, 0x8281) }, /* Nanotec Plug & Drive */
 110         { USB_DEVICE(0x10C4, 0x8293) }, /* Telegesis ETRX2USB */
 111         { USB_DEVICE(0x10C4, 0x82F9) }, /* Procyon AVS */
 112         { USB_DEVICE(0x10C4, 0x8341) }, /* Siemens MC35PU GPRS Modem */
 113         { USB_DEVICE(0x10C4, 0x8382) }, /* Cygnal Integrated Products, Inc. */
 114         { USB_DEVICE(0x10C4, 0x83A8) }, /* Amber Wireless AMB2560 */
 115         { USB_DEVICE(0x10C4, 0x83D8) }, /* DekTec DTA Plus VHF/UHF Booster/Attenuator */
 116         { USB_DEVICE(0x10C4, 0x8411) }, /* Kyocera GPS Module */
 117         { USB_DEVICE(0x10C4, 0x8418) }, /* IRZ Automation Teleport SG-10 GSM/GPRS Modem */
 118         { USB_DEVICE(0x10C4, 0x846E) }, /* BEI USB Sensor Interface (VCP) */
 119         { USB_DEVICE(0x10C4, 0x8477) }, /* Balluff RFID */
 120         { USB_DEVICE(0x10C4, 0x85EA) }, /* AC-Services IBUS-IF */
 121         { USB_DEVICE(0x10C4, 0x85EB) }, /* AC-Services CIS-IBUS */
 122         { USB_DEVICE(0x10C4, 0x85F8) }, /* Virtenio Preon32 */
 123         { USB_DEVICE(0x10C4, 0x8664) }, /* AC-Services CAN-IF */
 124         { USB_DEVICE(0x10C4, 0x8665) }, /* AC-Services OBD-IF */
 125         { USB_DEVICE(0x10C4, 0x8856) }, /* CEL EM357 ZigBee USB Stick - LR */
 126         { USB_DEVICE(0x10C4, 0x8857) }, /* CEL EM357 ZigBee USB Stick */
 127         { USB_DEVICE(0x10C4, 0x88A4) }, /* MMB Networks ZigBee USB Device */
 128         { USB_DEVICE(0x10C4, 0x88A5) }, /* Planet Innovation Ingeni ZigBee USB Device */
 129         { USB_DEVICE(0x10C4, 0x8946) }, /* Ketra N1 Wireless Interface */
 130         { USB_DEVICE(0x10C4, 0x8977) }, /* CEL MeshWorks DevKit Device */
 131         { USB_DEVICE(0x10C4, 0x8998) }, /* KCF Technologies PRN */
 132         { USB_DEVICE(0x10C4, 0x8A2A) }, /* HubZ dual ZigBee and Z-Wave dongle */
 133         { USB_DEVICE(0x10C4, 0xEA60) }, /* Silicon Labs factory default */
 134         { USB_DEVICE(0x10C4, 0xEA61) }, /* Silicon Labs factory default */
 135         { USB_DEVICE(0x10C4, 0xEA70) }, /* Silicon Labs factory default */
 136         { USB_DEVICE(0x10C4, 0xEA71) }, /* Infinity GPS-MIC-1 Radio Monophone */
 137         { USB_DEVICE(0x10C4, 0xF001) }, /* Elan Digital Systems USBscope50 */
 138         { USB_DEVICE(0x10C4, 0xF002) }, /* Elan Digital Systems USBwave12 */
 139         { USB_DEVICE(0x10C4, 0xF003) }, /* Elan Digital Systems USBpulse100 */
 140         { USB_DEVICE(0x10C4, 0xF004) }, /* Elan Digital Systems USBcount50 */
 141         { USB_DEVICE(0x10C5, 0xEA61) }, /* Silicon Labs MobiData GPRS USB Modem */
 142         { USB_DEVICE(0x10CE, 0xEA6A) }, /* Silicon Labs MobiData GPRS USB Modem 100EU */
 143         { USB_DEVICE(0x13AD, 0x9999) }, /* Baltech card reader */
 144         { USB_DEVICE(0x1555, 0x0004) }, /* Owen AC4 USB-RS485 Converter */
 145         { USB_DEVICE(0x166A, 0x0201) }, /* Clipsal 5500PACA C-Bus Pascal Automation Controller */
 146         { USB_DEVICE(0x166A, 0x0301) }, /* Clipsal 5800PC C-Bus Wireless PC Interface */
 147         { USB_DEVICE(0x166A, 0x0303) }, /* Clipsal 5500PCU C-Bus USB interface */
 148         { USB_DEVICE(0x166A, 0x0304) }, /* Clipsal 5000CT2 C-Bus Black and White Touchscreen */
 149         { USB_DEVICE(0x166A, 0x0305) }, /* Clipsal C-5000CT2 C-Bus Spectrum Colour Touchscreen */
 150         { USB_DEVICE(0x166A, 0x0401) }, /* Clipsal L51xx C-Bus Architectural Dimmer */
 151         { USB_DEVICE(0x166A, 0x0101) }, /* Clipsal 5560884 C-Bus Multi-room Audio Matrix Switcher */
 152         { USB_DEVICE(0x16C0, 0x09B0) }, /* Lunatico Seletek */
 153         { USB_DEVICE(0x16C0, 0x09B1) }, /* Lunatico Seletek */
 154         { USB_DEVICE(0x16D6, 0x0001) }, /* Jablotron serial interface */
 155         { USB_DEVICE(0x16DC, 0x0010) }, /* W-IE-NE-R Plein & Baus GmbH PL512 Power Supply */
 156         { USB_DEVICE(0x16DC, 0x0011) }, /* W-IE-NE-R Plein & Baus GmbH RCM Remote Control for MARATON Power Supply */
 157         { USB_DEVICE(0x16DC, 0x0012) }, /* W-IE-NE-R Plein & Baus GmbH MPOD Multi Channel Power Supply */
 158         { USB_DEVICE(0x16DC, 0x0015) }, /* W-IE-NE-R Plein & Baus GmbH CML Control, Monitoring and Data Logger */
 159         { USB_DEVICE(0x17A8, 0x0001) }, /* Kamstrup Optical Eye/3-wire */
 160         { USB_DEVICE(0x17A8, 0x0005) }, /* Kamstrup M-Bus Master MultiPort 250D */
 161         { USB_DEVICE(0x17F4, 0xAAAA) }, /* Wavesense Jazz blood glucose meter */
 162         { USB_DEVICE(0x1843, 0x0200) }, /* Vaisala USB Instrument Cable */
 163         { USB_DEVICE(0x18EF, 0xE00F) }, /* ELV USB-I2C-Interface */
 164         { USB_DEVICE(0x18EF, 0xE025) }, /* ELV Marble Sound Board 1 */
 165         { USB_DEVICE(0x1ADB, 0x0001) }, /* Schweitzer Engineering C662 Cable */
 166         { USB_DEVICE(0x1B1C, 0x1C00) }, /* Corsair USB Dongle */
 167         { USB_DEVICE(0x1BA4, 0x0002) }, /* Silicon Labs 358x factory default */
 168         { USB_DEVICE(0x1BE3, 0x07A6) }, /* WAGO 750-923 USB Service Cable */
 169         { USB_DEVICE(0x1D6F, 0x0010) }, /* Seluxit ApS RF Dongle */
 170         { USB_DEVICE(0x1E29, 0x0102) }, /* Festo CPX-USB */
 171         { USB_DEVICE(0x1E29, 0x0501) }, /* Festo CMSP */
 172         { USB_DEVICE(0x1FB9, 0x0100) }, /* Lake Shore Model 121 Current Source */
 173         { USB_DEVICE(0x1FB9, 0x0200) }, /* Lake Shore Model 218A Temperature Monitor */
 174         { USB_DEVICE(0x1FB9, 0x0201) }, /* Lake Shore Model 219 Temperature Monitor */
 175         { USB_DEVICE(0x1FB9, 0x0202) }, /* Lake Shore Model 233 Temperature Transmitter */
 176         { USB_DEVICE(0x1FB9, 0x0203) }, /* Lake Shore Model 235 Temperature Transmitter */
 177         { USB_DEVICE(0x1FB9, 0x0300) }, /* Lake Shore Model 335 Temperature Controller */
 178         { USB_DEVICE(0x1FB9, 0x0301) }, /* Lake Shore Model 336 Temperature Controller */
 179         { USB_DEVICE(0x1FB9, 0x0302) }, /* Lake Shore Model 350 Temperature Controller */
 180         { USB_DEVICE(0x1FB9, 0x0303) }, /* Lake Shore Model 371 AC Bridge */
 181         { USB_DEVICE(0x1FB9, 0x0400) }, /* Lake Shore Model 411 Handheld Gaussmeter */
 182         { USB_DEVICE(0x1FB9, 0x0401) }, /* Lake Shore Model 425 Gaussmeter */
 183         { USB_DEVICE(0x1FB9, 0x0402) }, /* Lake Shore Model 455A Gaussmeter */
 184         { USB_DEVICE(0x1FB9, 0x0403) }, /* Lake Shore Model 475A Gaussmeter */
 185         { USB_DEVICE(0x1FB9, 0x0404) }, /* Lake Shore Model 465 Three Axis Gaussmeter */
 186         { USB_DEVICE(0x1FB9, 0x0600) }, /* Lake Shore Model 625A Superconducting MPS */
 187         { USB_DEVICE(0x1FB9, 0x0601) }, /* Lake Shore Model 642A Magnet Power Supply */
 188         { USB_DEVICE(0x1FB9, 0x0602) }, /* Lake Shore Model 648 Magnet Power Supply */
 189         { USB_DEVICE(0x1FB9, 0x0700) }, /* Lake Shore Model 737 VSM Controller */
 190         { USB_DEVICE(0x1FB9, 0x0701) }, /* Lake Shore Model 776 Hall Matrix */
 191         { USB_DEVICE(0x2626, 0xEA60) }, /* Aruba Networks 7xxx USB Serial Console */
 192         { USB_DEVICE(0x3195, 0xF190) }, /* Link Instruments MSO-19 */
 193         { USB_DEVICE(0x3195, 0xF280) }, /* Link Instruments MSO-28 */
 194         { USB_DEVICE(0x3195, 0xF281) }, /* Link Instruments MSO-28 */
 195         { USB_DEVICE(0x413C, 0x9500) }, /* DW700 GPS USB interface */
 196         { } /* Terminating Entry */
 197 };
 198
 199 MODULE_DEVICE_TABLE(usb, id_table);
 200
 201 struct cp210x_serial_private {
 202         __u8                    bInterfaceNumber;
 203 };
 204
 205 static struct usb_serial_driver cp210x_device = {
 206         .driver = {
 207                 .owner =        THIS_MODULE,
 208                 .name =         "cp210x",
 209         },
 210         .id_table               = id_table,
 211         .num_ports              = 1,
 212         .bulk_in_size           = 256,
 213         .bulk_out_size          = 256,
 214         .open                   = cp210x_open,
 215         .close                  = cp210x_close,
 216         .break_ctl              = cp210x_break_ctl,
 217         .set_termios            = cp210x_set_termios,
 218         .tiocmget               = cp210x_tiocmget,
 219         .tiocmset               = cp210x_tiocmset,
 220         .attach                 = cp210x_startup,
 221         .release                = cp210x_release,
 222         .dtr_rts                = cp210x_dtr_rts
 223 };
 224
 225 static struct usb_serial_driver * const serial_drivers[] = {
 226         &cp210x_device, NULL
 227 };
 228
 229 /* Config request types */
 230 #define REQTYPE_HOST_TO_INTERFACE       0x41
 231 #define REQTYPE_INTERFACE_TO_HOST       0xc1
 232 #define REQTYPE_HOST_TO_DEVICE  0x40
 233 #define REQTYPE_DEVICE_TO_HOST  0xc0
 234
 235 /* Config request codes */
 236 #define CP210X_IFC_ENABLE       0x00
 237 #define CP210X_SET_BAUDDIV      0x01
 238 #define CP210X_GET_BAUDDIV      0x02
 239 #define CP210X_SET_LINE_CTL     0x03
 240 #define CP210X_GET_LINE_CTL     0x04
 241 #define CP210X_SET_BREAK        0x05
 242 #define CP210X_IMM_CHAR         0x06
 243 #define CP210X_SET_MHS          0x07
 244 #define CP210X_GET_MDMSTS       0x08
 245 #define CP210X_SET_XON          0x09
 246 #define CP210X_SET_XOFF         0x0A
 247 #define CP210X_SET_EVENTMASK    0x0B
 248 #define CP210X_GET_EVENTMASK    0x0C
 249 #define CP210X_SET_CHAR         0x0D
 250 #define CP210X_GET_CHARS        0x0E
 251 #define CP210X_GET_PROPS        0x0F
 252 #define CP210X_GET_COMM_STATUS  0x10
 253 #define CP210X_RESET            0x11
 254 #define CP210X_PURGE            0x12
 255 #define CP210X_SET_FLOW         0x13
 256 #define CP210X_GET_FLOW         0x14
 257 #define CP210X_EMBED_EVENTS     0x15
 258 #define CP210X_GET_EVENTSTATE   0x16
 259 #define CP210X_SET_CHARS        0x19
 260 #define CP210X_GET_BAUDRATE     0x1D
 261 #define CP210X_SET_BAUDRATE     0x1E
 262
 263 /* CP210X_IFC_ENABLE */
 264 #define UART_ENABLE             0x0001
 265 #define UART_DISABLE            0x0000
 266
 267 /* CP210X_(SET|GET)_BAUDDIV */
 268 #define BAUD_RATE_GEN_FREQ      0x384000
 269
 270 /* CP210X_(SET|GET)_LINE_CTL */
 271 #define BITS_DATA_MASK          0X0f00
 272 #define BITS_DATA_5             0X0500
 273 #define BITS_DATA_6             0X0600
 274 #define BITS_DATA_7             0X0700
 275 #define BITS_DATA_8             0X0800
 276 #define BITS_DATA_9             0X0900
 277
 278 #define BITS_PARITY_MASK        0x00f0
 279 #define BITS_PARITY_NONE        0x0000
 280 #define BITS_PARITY_ODD         0x0010
 281 #define BITS_PARITY_EVEN        0x0020
 282 #define BITS_PARITY_MARK        0x0030
 283 #define BITS_PARITY_SPACE       0x0040
 284
 285 #define BITS_STOP_MASK          0x000f
 286 #define BITS_STOP_1             0x0000
 287 #define BITS_STOP_1_5           0x0001
 288 #define BITS_STOP_2             0x0002
 289
 290 /* CP210X_SET_BREAK */
 291 #define BREAK_ON                0x0001
 292 #define BREAK_OFF               0x0000
 293
 294 /* CP210X_(SET_MHS|GET_MDMSTS) */
 295 #define CONTROL_DTR             0x0001
 296 #define CONTROL_RTS             0x0002
 297 #define CONTROL_CTS             0x0010
 298 #define CONTROL_DSR             0x0020
 299 #define CONTROL_RING            0x0040
 300 #define CONTROL_DCD             0x0080
 301 #define CONTROL_WRITE_DTR       0x0100
 302 #define CONTROL_WRITE_RTS       0x0200
 303
 304 /*
 305  * cp210x_get_config
 306  * Reads from the CP210x configuration registers
 307  * 'size' is specified in bytes.
 308  * 'data' is a pointer to a pre-allocated array of integers large
 309  * enough to hold 'size' bytes (with 4 bytes to each integer)
 310  */
 311 static int cp210x_get_config(struct usb_serial_port *port, u8 request,
 312                 unsigned int *data, int size)
 313 {
 314         struct usb_serial *serial = port->serial;
 315         struct cp210x_serial_private *spriv = usb_get_serial_data(serial);
 316         __le32 *buf;
 317         int result, i, length;
 318
 319         /* Number of integers required to contain the array */
 320         length = (((size - 1) | 3) + 1) / 4;
 321
 322         buf = kcalloc(length, sizeof(__le32), GFP_KERNEL);
 323         if (!buf) {
 324                 dev_err(&port->dev, "%s - out of memory.\n", __func__);
 325                 return -ENOMEM;
 326         }
 327
 328         /* Issue the request, attempting to read 'size' bytes */
 329         result = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
 330                                 request, REQTYPE_INTERFACE_TO_HOST, 0x0000,
 331                                 spriv->bInterfaceNumber, buf, size,
 332                                 USB_CTRL_GET_TIMEOUT);
 333
 334         /* Convert data into an array of integers */
 335         for (i = 0; i < length; i++)
 336                 data[i] = le32_to_cpu(buf[i]);
 337
 338         kfree(buf);
 339
 340         if (result != size) {
 341                 dev_dbg(&port->dev, "%s - Unable to send config request, request=0x%x size=%d result=%d\n",
 342                         __func__, request, size, result);
 343                 if (result > 0)
 344                         result = -EPROTO;
 345
 346                 return result;
 347         }
 348
 349         return 0;
 350 }
 351
 352 /*
 353  * cp210x_set_config
 354  * Writes to the CP210x configuration registers
 355  * Values less than 16 bits wide are sent directly
 356  * 'size' is specified in bytes.
 357  */
 358 static int cp210x_set_config(struct usb_serial_port *port, u8 request,
 359                 unsigned int *data, int size)
 360 {
 361         struct usb_serial *serial = port->serial;
 362         struct cp210x_serial_private *spriv = usb_get_serial_data(serial);
 363         __le32 *buf;
 364         int result, i, length;
 365
 366         /* Number of integers required to contain the array */
 367         length = (((size - 1) | 3) + 1) / 4;
 368
 369         buf = kmalloc(length * sizeof(__le32), GFP_KERNEL);
 370         if (!buf) {
 371                 dev_err(&port->dev, "%s - out of memory.\n", __func__);
 372                 return -ENOMEM;
 373         }
 374
 375         /* Array of integers into bytes */
 376         for (i = 0; i < length; i++)
 377                 buf[i] = cpu_to_le32(data[i]);
 378
 379         if (size > 2) {
 380                 result = usb_control_msg(serial->dev,
 381                                 usb_sndctrlpipe(serial->dev, 0),
 382                                 request, REQTYPE_HOST_TO_INTERFACE, 0x0000,
 383                                 spriv->bInterfaceNumber, buf, size,
 384                                 USB_CTRL_SET_TIMEOUT);
 385         } else {
 386                 result = usb_control_msg(serial->dev,
 387                                 usb_sndctrlpipe(serial->dev, 0),
 388                                 request, REQTYPE_HOST_TO_INTERFACE, data[0],
 389                                 spriv->bInterfaceNumber, NULL, 0,
 390                                 USB_CTRL_SET_TIMEOUT);
 391         }
 392
 393         kfree(buf);
 394
 395         if ((size > 2 && result != size) || result < 0) {
 396                 dev_dbg(&port->dev, "%s - Unable to send request, request=0x%x size=%d result=%d\n",
 397                         __func__, request, size, result);
 398                 if (result > 0)
 399                         result = -EPROTO;
 400
 401                 return result;
 402         }
 403
 404         return 0;
 405 }
 406
 407 /*
 408  * cp210x_set_config_single
 409  * Convenience function for calling cp210x_set_config on single data values
 410  * without requiring an integer pointer
 411  */
 412 static inline int cp210x_set_config_single(struct usb_serial_port *port,
 413                 u8 request, unsigned int data)
 414 {
 415         return cp210x_set_config(port, request, &data, 2);
 416 }
 417
 418 /*
 419  * cp210x_quantise_baudrate
 420  * Quantises the baud rate as per AN205 Table 1
 421  */
 422 static unsigned int cp210x_quantise_baudrate(unsigned int baud)
 423 {
 424         if (baud <= 300)
 425                 baud = 300;
 426         else if (baud <= 600)      baud = 600;
 427         else if (baud <= 1200)     baud = 1200;
 428         else if (baud <= 1800)     baud = 1800;
 429         else if (baud <= 2400)     baud = 2400;
 430         else if (baud <= 4000)     baud = 4000;
 431         else if (baud <= 4803)     baud = 4800;
 432         else if (baud <= 7207)     baud = 7200;
 433         else if (baud <= 9612)     baud = 9600;
 434         else if (baud <= 14428)    baud = 14400;
 435         else if (baud <= 16062)    baud = 16000;
 436         else if (baud <= 19250)    baud = 19200;
 437         else if (baud <= 28912)    baud = 28800;
 438         else if (baud <= 38601)    baud = 38400;
 439         else if (baud <= 51558)    baud = 51200;
 440         else if (baud <= 56280)    baud = 56000;
 441         else if (baud <= 58053)    baud = 57600;
 442         else if (baud <= 64111)    baud = 64000;
 443         else if (baud <= 77608)    baud = 76800;
 444         else if (baud <= 117028)   baud = 115200;
 445         else if (baud <= 129347)   baud = 128000;
 446         else if (baud <= 156868)   baud = 153600;
 447         else if (baud <= 237832)   baud = 230400;
 448         else if (baud <= 254234)   baud = 250000;
 449         else if (baud <= 273066)   baud = 256000;
 450         else if (baud <= 491520)   baud = 460800;
 451         else if (baud <= 567138)   baud = 500000;
 452         else if (baud <= 670254)   baud = 576000;
 453         else if (baud < 1000000)
 454                 baud = 921600;
 455         else if (baud > 2000000)
 456                 baud = 2000000;
 457         return baud;
 458 }
 459
 460 static int cp210x_open(struct tty_struct *tty, struct usb_serial_port *port)
 461 {
 462         int result;
 463
 464         result = cp210x_set_config_single(port, CP210X_IFC_ENABLE,
 465                                                                 UART_ENABLE);
 466         if (result) {
 467                 dev_err(&port->dev, "%s - Unable to enable UART\n", __func__);
 468                 return result;
 469         }
 470
 471         /* Configure the termios structure */
 472         cp210x_get_termios(tty, port);
 473
 474         /* The baud rate must be initialised on cp2104 */
 475         if (tty)
 476                 cp210x_change_speed(tty, port, NULL);
 477
 478         return usb_serial_generic_open(tty, port);
 479 }
 480
 481 static void cp210x_close(struct usb_serial_port *port)
 482 {
 483         usb_serial_generic_close(port);
 484         cp210x_set_config_single(port, CP210X_IFC_ENABLE, UART_DISABLE);
 485 }
 486
 487 /*
 488  * cp210x_get_termios
 489  * Reads the baud rate, data bits, parity, stop bits and flow control mode
 490  * from the device, corrects any unsupported values, and configures the
 491  * termios structure to reflect the state of the device
 492  */
 493 static void cp210x_get_termios(struct tty_struct *tty,
 494         struct usb_serial_port *port)
 495 {
 496         unsigned int baud;
 497
 498         if (tty) {
 499                 cp210x_get_termios_port(tty->driver_data,
 500                         &tty->termios.c_cflag, &baud);
 501                 tty_encode_baud_rate(tty, baud, baud);
 502         } else {
 503                 unsigned int cflag;
 504                 cflag = 0;
 505                 cp210x_get_termios_port(port, &cflag, &baud);
 506         }
 507 }
 508
 509 /*
 510  * cp210x_get_termios_port
 511  * This is the heart of cp210x_get_termios which always uses a &usb_serial_port.
 512  */
 513 static void cp210x_get_termios_port(struct usb_serial_port *port,
 514         unsigned int *cflagp, unsigned int *baudp)
 515 {
 516         struct device *dev = &port->dev;
 517         unsigned int cflag, modem_ctl[4];
 518         unsigned int baud;
 519         unsigned int bits;
 520
 521         cp210x_get_config(port, CP210X_GET_BAUDRATE, &baud, 4);
 522
 523         dev_dbg(dev, "%s - baud rate = %d\n", __func__, baud);
 524         *baudp = baud;
 525
 526         cflag = *cflagp;
 527
 528         cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
 529         cflag &= ~CSIZE;
 530         switch (bits & BITS_DATA_MASK) {
 531         case BITS_DATA_5:
 532                 dev_dbg(dev, "%s - data bits = 5\n", __func__);
 533                 cflag |= CS5;
 534                 break;
 535         case BITS_DATA_6:
 536                 dev_dbg(dev, "%s - data bits = 6\n", __func__);
 537                 cflag |= CS6;
 538                 break;
 539         case BITS_DATA_7:
 540                 dev_dbg(dev, "%s - data bits = 7\n", __func__);
 541                 cflag |= CS7;
 542                 break;
 543         case BITS_DATA_8:
 544                 dev_dbg(dev, "%s - data bits = 8\n", __func__);
 545                 cflag |= CS8;
 546                 break;
 547         case BITS_DATA_9:
 548                 dev_dbg(dev, "%s - data bits = 9 (not supported, using 8 data bits)\n", __func__);
 549                 cflag |= CS8;
 550                 bits &= ~BITS_DATA_MASK;
 551                 bits |= BITS_DATA_8;
 552                 cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
 553                 break;
 554         default:
 555                 dev_dbg(dev, "%s - Unknown number of data bits, using 8\n", __func__);
 556                 cflag |= CS8;
 557                 bits &= ~BITS_DATA_MASK;
 558                 bits |= BITS_DATA_8;
 559                 cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
 560                 break;
 561         }
 562
 563         switch (bits & BITS_PARITY_MASK) {
 564         case BITS_PARITY_NONE:
 565                 dev_dbg(dev, "%s - parity = NONE\n", __func__);
 566                 cflag &= ~PARENB;
 567                 break;
 568         case BITS_PARITY_ODD:
 569                 dev_dbg(dev, "%s - parity = ODD\n", __func__);
 570                 cflag |= (PARENB|PARODD);
 571                 break;
 572         case BITS_PARITY_EVEN:
 573                 dev_dbg(dev, "%s - parity = EVEN\n", __func__);
 574                 cflag &= ~PARODD;
 575                 cflag |= PARENB;
 576                 break;
 577         case BITS_PARITY_MARK:
 578                 dev_dbg(dev, "%s - parity = MARK\n", __func__);
 579                 cflag |= (PARENB|PARODD|CMSPAR);
 580                 break;
 581         case BITS_PARITY_SPACE:
 582                 dev_dbg(dev, "%s - parity = SPACE\n", __func__);
 583                 cflag &= ~PARODD;
 584                 cflag |= (PARENB|CMSPAR);
 585                 break;
 586         default:
 587                 dev_dbg(dev, "%s - Unknown parity mode, disabling parity\n", __func__);
 588                 cflag &= ~PARENB;
 589                 bits &= ~BITS_PARITY_MASK;
 590                 cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
 591                 break;
 592         }
 593
 594         cflag &= ~CSTOPB;
 595         switch (bits & BITS_STOP_MASK) {
 596         case BITS_STOP_1:
 597                 dev_dbg(dev, "%s - stop bits = 1\n", __func__);
 598                 break;
 599         case BITS_STOP_1_5:
 600                 dev_dbg(dev, "%s - stop bits = 1.5 (not supported, using 1 stop bit)\n", __func__);
 601                 bits &= ~BITS_STOP_MASK;
 602                 cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
 603                 break;
 604         case BITS_STOP_2:
 605                 dev_dbg(dev, "%s - stop bits = 2\n", __func__);
 606                 cflag |= CSTOPB;
 607                 break;
 608         default:
 609                 dev_dbg(dev, "%s - Unknown number of stop bits, using 1 stop bit\n", __func__);
 610                 bits &= ~BITS_STOP_MASK;
 611                 cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2);
 612                 break;
 613         }
 614
 615         cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
 616         if (modem_ctl[0] & 0x0008) {
 617                 dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
 618                 cflag |= CRTSCTS;
 619         } else {
 620                 dev_dbg(dev, "%s - flow control = NONE\n", __func__);
 621                 cflag &= ~CRTSCTS;
 622         }
 623
 624         *cflagp = cflag;
 625 }
 626
 627 /*
 628  * CP2101 supports the following baud rates:
 629  *
 630  *      300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 14400, 19200, 28800,
 631  *      38400, 56000, 57600, 115200, 128000, 230400, 460800, 921600
 632  *
 633  * CP2102 and CP2103 support the following additional rates:
 634  *
 635  *      4000, 16000, 51200, 64000, 76800, 153600, 250000, 256000, 500000,
 636  *      576000
 637  *
 638  * The device will map a requested rate to a supported one, but the result
 639  * of requests for rates greater than 1053257 is undefined (see AN205).
 640  *
 641  * CP2104, CP2105 and CP2110 support most rates up to 2M, 921k and 1M baud,
 642  * respectively, with an error less than 1%. The actual rates are determined
 643  * by
 644  *
 645  *      div = round(freq / (2 x prescale x request))
 646  *      actual = freq / (2 x prescale x div)
 647  *
 648  * For CP2104 and CP2105 freq is 48Mhz and prescale is 4 for request <= 365bps
 649  * or 1 otherwise.
 650  * For CP2110 freq is 24Mhz and prescale is 4 for request <= 300bps or 1
 651  * otherwise.
 652  */
 653 static void cp210x_change_speed(struct tty_struct *tty,
 654                 struct usb_serial_port *port, struct ktermios *old_termios)
 655 {
 656         u32 baud;
 657
 658         baud = tty->termios.c_ospeed;
 659
 660         /* This maps the requested rate to a rate valid on cp2102 or cp2103,
 661          * or to an arbitrary rate in [1M,2M].
 662          *
 663          * NOTE: B0 is not implemented.
 664          */
 665         baud = cp210x_quantise_baudrate(baud);
 666
 667         dev_dbg(&port->dev, "%s - setting baud rate to %u\n", __func__, baud);
 668         if (cp210x_set_config(port, CP210X_SET_BAUDRATE, &baud,
 669                                                         sizeof(baud))) {
 670                 dev_warn(&port->dev, "failed to set baud rate to %u\n", baud);
 671                 if (old_termios)
 672                         baud = old_termios->c_ospeed;
 673                 else
 674                         baud = 9600;
 675         }
 676
 677         tty_encode_baud_rate(tty, baud, baud);
 678 }
 679
 680 static void cp210x_set_termios(struct tty_struct *tty,
 681                 struct usb_serial_port *port, struct ktermios *old_termios)
 682 {
 683         struct device *dev = &port->dev;
 684         unsigned int cflag, old_cflag;
 685         unsigned int bits;
 686         unsigned int modem_ctl[4];
 687
 688         dev_dbg(dev, "%s - port %d\n", __func__, port->number);
 689
 690         if (!tty)
 691                 return;
 692
 693         cflag = tty->termios.c_cflag;
 694         old_cflag = old_termios->c_cflag;
 695
 696         if (tty->termios.c_ospeed != old_termios->c_ospeed)
 697                 cp210x_change_speed(tty, port, old_termios);
 698
 699         /* If the number of data bits is to be updated */
 700         if ((cflag & CSIZE) != (old_cflag & CSIZE)) {
 701                 cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
 702                 bits &= ~BITS_DATA_MASK;
 703                 switch (cflag & CSIZE) {
 704                 case CS5:
 705                         bits |= BITS_DATA_5;
 706                         dev_dbg(dev, "%s - data bits = 5\n", __func__);
 707                         break;
 708                 case CS6:
 709                         bits |= BITS_DATA_6;
 710                         dev_dbg(dev, "%s - data bits = 6\n", __func__);
 711                         break;
 712                 case CS7:
 713                         bits |= BITS_DATA_7;
 714                         dev_dbg(dev, "%s - data bits = 7\n", __func__);
 715                         break;
 716                 case CS8:
 717                         bits |= BITS_DATA_8;
 718                         dev_dbg(dev, "%s - data bits = 8\n", __func__);
 719                         break;
 720                 /*case CS9:
 721                         bits |= BITS_DATA_9;
 722                         dev_dbg(dev, "%s - data bits = 9\n", __func__);
 723                         break;*/
 724                 default:
 725                         dev_dbg(dev, "cp210x driver does not support the number of bits requested, using 8 bit mode\n");
 726                         bits |= BITS_DATA_8;
 727                         break;
 728                 }
 729                 if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
 730                         dev_dbg(dev, "Number of data bits requested not supported by device\n");
 731         }
 732
 733         if ((cflag     & (PARENB|PARODD|CMSPAR)) !=
 734             (old_cflag & (PARENB|PARODD|CMSPAR))) {
 735                 cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
 736                 bits &= ~BITS_PARITY_MASK;
 737                 if (cflag & PARENB) {
 738                         if (cflag & CMSPAR) {
 739                                 if (cflag & PARODD) {
 740                                         bits |= BITS_PARITY_MARK;
 741                                         dev_dbg(dev, "%s - parity = MARK\n", __func__);
 742                                 } else {
 743                                         bits |= BITS_PARITY_SPACE;
 744                                         dev_dbg(dev, "%s - parity = SPACE\n", __func__);
 745                                 }
 746                         } else {
 747                                 if (cflag & PARODD) {
 748                                         bits |= BITS_PARITY_ODD;
 749                                         dev_dbg(dev, "%s - parity = ODD\n", __func__);
 750                                 } else {
 751                                         bits |= BITS_PARITY_EVEN;
 752                                         dev_dbg(dev, "%s - parity = EVEN\n", __func__);
 753                                 }
 754                         }
 755                 }
 756                 if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
 757                         dev_dbg(dev, "Parity mode not supported by device\n");
 758         }
 759
 760         if ((cflag & CSTOPB) != (old_cflag & CSTOPB)) {
 761                 cp210x_get_config(port, CP210X_GET_LINE_CTL, &bits, 2);
 762                 bits &= ~BITS_STOP_MASK;
 763                 if (cflag & CSTOPB) {
 764                         bits |= BITS_STOP_2;
 765                         dev_dbg(dev, "%s - stop bits = 2\n", __func__);
 766                 } else {
 767                         bits |= BITS_STOP_1;
 768                         dev_dbg(dev, "%s - stop bits = 1\n", __func__);
 769                 }
 770                 if (cp210x_set_config(port, CP210X_SET_LINE_CTL, &bits, 2))
 771                         dev_dbg(dev, "Number of stop bits requested not supported by device\n");
 772         }
 773
 774         if ((cflag & CRTSCTS) != (old_cflag & CRTSCTS)) {
 775                 cp210x_get_config(port, CP210X_GET_FLOW, modem_ctl, 16);
 776                 dev_dbg(dev, "%s - read modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x\n",
 777                         __func__, modem_ctl[0], modem_ctl[1],
 778                         modem_ctl[2], modem_ctl[3]);
 779
 780                 if (cflag & CRTSCTS) {
 781                         modem_ctl[0] &= ~0x7B;
 782                         modem_ctl[0] |= 0x09;
 783                         modem_ctl[1] = 0x80;
 784                         dev_dbg(dev, "%s - flow control = CRTSCTS\n", __func__);
 785                 } else {
 786                         modem_ctl[0] &= ~0x7B;
 787                         modem_ctl[0] |= 0x01;
 788                         modem_ctl[1] |= 0x40;
 789                         dev_dbg(dev, "%s - flow control = NONE\n", __func__);
 790                 }
 791
 792                 dev_dbg(dev, "%s - write modem controls = 0x%.4x 0x%.4x 0x%.4x 0x%.4x\n",
 793                         __func__, modem_ctl[0], modem_ctl[1],
 794                         modem_ctl[2], modem_ctl[3]);
 795                 cp210x_set_config(port, CP210X_SET_FLOW, modem_ctl, 16);
 796         }
 797
 798 }
 799
 800 static int cp210x_tiocmset(struct tty_struct *tty,
 801                 unsigned int set, unsigned int clear)
 802 {
 803         struct usb_serial_port *port = tty->driver_data;
 804         return cp210x_tiocmset_port(port, set, clear);
 805 }
 806
 807 static int cp210x_tiocmset_port(struct usb_serial_port *port,
 808                 unsigned int set, unsigned int clear)
 809 {
 810         unsigned int control = 0;
 811
 812         if (set & TIOCM_RTS) {
 813                 control |= CONTROL_RTS;
 814                 control |= CONTROL_WRITE_RTS;
 815         }
 816         if (set & TIOCM_DTR) {
 817                 control |= CONTROL_DTR;
 818                 control |= CONTROL_WRITE_DTR;
 819         }
 820         if (clear & TIOCM_RTS) {
 821                 control &= ~CONTROL_RTS;
 822                 control |= CONTROL_WRITE_RTS;
 823         }
 824         if (clear & TIOCM_DTR) {
 825                 control &= ~CONTROL_DTR;
 826                 control |= CONTROL_WRITE_DTR;
 827         }
 828
 829         dev_dbg(&port->dev, "%s - control = 0x%.4x\n", __func__, control);
 830
 831         return cp210x_set_config(port, CP210X_SET_MHS, &control, 2);
 832 }
 833
 834 static void cp210x_dtr_rts(struct usb_serial_port *p, int on)
 835 {
 836         if (on)
 837                 cp210x_tiocmset_port(p, TIOCM_DTR|TIOCM_RTS, 0);
 838         else
 839                 cp210x_tiocmset_port(p, 0, TIOCM_DTR|TIOCM_RTS);
 840 }
 841
 842 static int cp210x_tiocmget(struct tty_struct *tty)
 843 {
 844         struct usb_serial_port *port = tty->driver_data;
 845         unsigned int control;
 846         int result;
 847
 848         cp210x_get_config(port, CP210X_GET_MDMSTS, &control, 1);
 849
 850         result = ((control & CONTROL_DTR) ? TIOCM_DTR : 0)
 851                 |((control & CONTROL_RTS) ? TIOCM_RTS : 0)
 852                 |((control & CONTROL_CTS) ? TIOCM_CTS : 0)
 853                 |((control & CONTROL_DSR) ? TIOCM_DSR : 0)
 854                 |((control & CONTROL_RING)? TIOCM_RI  : 0)
 855                 |((control & CONTROL_DCD) ? TIOCM_CD  : 0);
 856
 857         dev_dbg(&port->dev, "%s - control = 0x%.2x\n", __func__, control);
 858
 859         return result;
 860 }
 861
 862 static void cp210x_break_ctl(struct tty_struct *tty, int break_state)
 863 {
 864         struct usb_serial_port *port = tty->driver_data;
 865         unsigned int state;
 866
 867         if (break_state == 0)
 868                 state = BREAK_OFF;
 869         else
 870                 state = BREAK_ON;
 871         dev_dbg(&port->dev, "%s - turning break %s\n", __func__,
 872                 state == BREAK_OFF ? "off" : "on");
 873         cp210x_set_config(port, CP210X_SET_BREAK, &state, 2);
 874 }
 875
 876 static int cp210x_startup(struct usb_serial *serial)
 877 {
 878         struct usb_host_interface *cur_altsetting;
 879         struct cp210x_serial_private *spriv;
 880
 881         /* cp210x buffers behave strangely unless device is reset */
 882         usb_reset_device(serial->dev);
 883
 884         spriv = kzalloc(sizeof(*spriv), GFP_KERNEL);
 885         if (!spriv)
 886                 return -ENOMEM;
 887
 888         cur_altsetting = serial->interface->cur_altsetting;
 889         spriv->bInterfaceNumber = cur_altsetting->desc.bInterfaceNumber;
 890
 891         usb_set_serial_data(serial, spriv);
 892
 893         return 0;
 894 }
 895
 896 static void cp210x_release(struct usb_serial *serial)
 897 {
 898         struct cp210x_serial_private *spriv;
 899
 900         spriv = usb_get_serial_data(serial);
 901         kfree(spriv);
 902 }
 903
 904 module_usb_serial_driver(serial_drivers, id_table);
 905
 906 MODULE_DESCRIPTION(DRIVER_DESC);
 907 MODULE_LICENSE("GPL");