pl2303.c 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176
  1. /*
  2. * Prolific PL2303 USB to serial adaptor driver
  3. *
  4. * Copyright (C) 2001-2004 Greg Kroah-Hartman (greg@kroah.com)
  5. * Copyright (C) 2003 IBM Corp.
  6. *
  7. * Original driver for 2.2.x by anonymous
  8. *
  9. * This program is free software; you can redistribute it and/or modify
  10. * it under the terms of the GNU General Public License as published by
  11. * the Free Software Foundation; either version 2 of the License.
  12. *
  13. * See Documentation/usb/usb-serial.txt for more information on using this driver
  14. *
  15. */
  16. #include <linux/kernel.h>
  17. #include <linux/errno.h>
  18. #include <linux/init.h>
  19. #include <linux/slab.h>
  20. #include <linux/tty.h>
  21. #include <linux/tty_driver.h>
  22. #include <linux/tty_flip.h>
  23. #include <linux/serial.h>
  24. #include <linux/module.h>
  25. #include <linux/moduleparam.h>
  26. #include <linux/spinlock.h>
  27. #include <asm/uaccess.h>
  28. #include <linux/usb.h>
  29. #include <linux/usb/serial.h>
  30. #include "pl2303.h"
  31. /*
  32. * Version Information
  33. */
  34. #define DRIVER_DESC "Prolific PL2303 USB to serial adaptor driver"
  35. static int debug;
  36. #define PL2303_CLOSING_WAIT (30*HZ)
  37. #define PL2303_BUF_SIZE 1024
  38. #define PL2303_TMP_BUF_SIZE 1024
  39. struct pl2303_buf {
  40. unsigned int buf_size;
  41. char *buf_buf;
  42. char *buf_get;
  43. char *buf_put;
  44. };
  45. static struct usb_device_id id_table [] = {
  46. { USB_DEVICE(PL2303_VENDOR_ID, PL2303_PRODUCT_ID) },
  47. { USB_DEVICE(PL2303_VENDOR_ID, PL2303_PRODUCT_ID_RSAQ2) },
  48. { USB_DEVICE(PL2303_VENDOR_ID, PL2303_PRODUCT_ID_DCU11) },
  49. { USB_DEVICE(PL2303_VENDOR_ID, PL2303_PRODUCT_ID_RSAQ3) },
  50. { USB_DEVICE(PL2303_VENDOR_ID, PL2303_PRODUCT_ID_PHAROS) },
  51. { USB_DEVICE(IODATA_VENDOR_ID, IODATA_PRODUCT_ID) },
  52. { USB_DEVICE(ATEN_VENDOR_ID, ATEN_PRODUCT_ID) },
  53. { USB_DEVICE(ATEN_VENDOR_ID2, ATEN_PRODUCT_ID) },
  54. { USB_DEVICE(ELCOM_VENDOR_ID, ELCOM_PRODUCT_ID) },
  55. { USB_DEVICE(ELCOM_VENDOR_ID, ELCOM_PRODUCT_ID_UCSGT) },
  56. { USB_DEVICE(ITEGNO_VENDOR_ID, ITEGNO_PRODUCT_ID) },
  57. { USB_DEVICE(ITEGNO_VENDOR_ID, ITEGNO_PRODUCT_ID_2080) },
  58. { USB_DEVICE(MA620_VENDOR_ID, MA620_PRODUCT_ID) },
  59. { USB_DEVICE(RATOC_VENDOR_ID, RATOC_PRODUCT_ID) },
  60. { USB_DEVICE(TRIPP_VENDOR_ID, TRIPP_PRODUCT_ID) },
  61. { USB_DEVICE(RADIOSHACK_VENDOR_ID, RADIOSHACK_PRODUCT_ID) },
  62. { USB_DEVICE(DCU10_VENDOR_ID, DCU10_PRODUCT_ID) },
  63. { USB_DEVICE(SITECOM_VENDOR_ID, SITECOM_PRODUCT_ID) },
  64. { USB_DEVICE(ALCATEL_VENDOR_ID, ALCATEL_PRODUCT_ID) },
  65. { USB_DEVICE(SAMSUNG_VENDOR_ID, SAMSUNG_PRODUCT_ID) },
  66. { USB_DEVICE(SIEMENS_VENDOR_ID, SIEMENS_PRODUCT_ID_SX1) },
  67. { USB_DEVICE(SIEMENS_VENDOR_ID, SIEMENS_PRODUCT_ID_X65) },
  68. { USB_DEVICE(SIEMENS_VENDOR_ID, SIEMENS_PRODUCT_ID_X75) },
  69. { USB_DEVICE(SYNTECH_VENDOR_ID, SYNTECH_PRODUCT_ID) },
  70. { USB_DEVICE(NOKIA_CA42_VENDOR_ID, NOKIA_CA42_PRODUCT_ID) },
  71. { USB_DEVICE(CA_42_CA42_VENDOR_ID, CA_42_CA42_PRODUCT_ID) },
  72. { USB_DEVICE(SAGEM_VENDOR_ID, SAGEM_PRODUCT_ID) },
  73. { USB_DEVICE(LEADTEK_VENDOR_ID, LEADTEK_9531_PRODUCT_ID) },
  74. { USB_DEVICE(SPEEDDRAGON_VENDOR_ID, SPEEDDRAGON_PRODUCT_ID) },
  75. { USB_DEVICE(DATAPILOT_U2_VENDOR_ID, DATAPILOT_U2_PRODUCT_ID) },
  76. { USB_DEVICE(BELKIN_VENDOR_ID, BELKIN_PRODUCT_ID) },
  77. { USB_DEVICE(ALCOR_VENDOR_ID, ALCOR_PRODUCT_ID) },
  78. { USB_DEVICE(HUAWEI_VENDOR_ID, HUAWEI_PRODUCT_ID) },
  79. { USB_DEVICE(WS002IN_VENDOR_ID, WS002IN_PRODUCT_ID) },
  80. { } /* Terminating entry */
  81. };
  82. MODULE_DEVICE_TABLE(usb, id_table);
  83. static struct usb_driver pl2303_driver = {
  84. .name = "pl2303",
  85. .probe = usb_serial_probe,
  86. .disconnect = usb_serial_disconnect,
  87. .id_table = id_table,
  88. .no_dynamic_id = 1,
  89. };
  90. #define SET_LINE_REQUEST_TYPE 0x21
  91. #define SET_LINE_REQUEST 0x20
  92. #define SET_CONTROL_REQUEST_TYPE 0x21
  93. #define SET_CONTROL_REQUEST 0x22
  94. #define CONTROL_DTR 0x01
  95. #define CONTROL_RTS 0x02
  96. #define BREAK_REQUEST_TYPE 0x21
  97. #define BREAK_REQUEST 0x23
  98. #define BREAK_ON 0xffff
  99. #define BREAK_OFF 0x0000
  100. #define GET_LINE_REQUEST_TYPE 0xa1
  101. #define GET_LINE_REQUEST 0x21
  102. #define VENDOR_WRITE_REQUEST_TYPE 0x40
  103. #define VENDOR_WRITE_REQUEST 0x01
  104. #define VENDOR_READ_REQUEST_TYPE 0xc0
  105. #define VENDOR_READ_REQUEST 0x01
  106. #define UART_STATE 0x08
  107. #define UART_STATE_TRANSIENT_MASK 0x74
  108. #define UART_DCD 0x01
  109. #define UART_DSR 0x02
  110. #define UART_BREAK_ERROR 0x04
  111. #define UART_RING 0x08
  112. #define UART_FRAME_ERROR 0x10
  113. #define UART_PARITY_ERROR 0x20
  114. #define UART_OVERRUN_ERROR 0x40
  115. #define UART_CTS 0x80
  116. enum pl2303_type {
  117. type_0, /* don't know the difference between type 0 and */
  118. type_1, /* type 1, until someone from prolific tells us... */
  119. HX, /* HX version of the pl2303 chip */
  120. };
  121. struct pl2303_private {
  122. spinlock_t lock;
  123. struct pl2303_buf *buf;
  124. int write_urb_in_use;
  125. wait_queue_head_t delta_msr_wait;
  126. u8 line_control;
  127. u8 line_status;
  128. u8 termios_initialized;
  129. enum pl2303_type type;
  130. };
  131. /*
  132. * pl2303_buf_alloc
  133. *
  134. * Allocate a circular buffer and all associated memory.
  135. */
  136. static struct pl2303_buf *pl2303_buf_alloc(unsigned int size)
  137. {
  138. struct pl2303_buf *pb;
  139. if (size == 0)
  140. return NULL;
  141. pb = kmalloc(sizeof(struct pl2303_buf), GFP_KERNEL);
  142. if (pb == NULL)
  143. return NULL;
  144. pb->buf_buf = kmalloc(size, GFP_KERNEL);
  145. if (pb->buf_buf == NULL) {
  146. kfree(pb);
  147. return NULL;
  148. }
  149. pb->buf_size = size;
  150. pb->buf_get = pb->buf_put = pb->buf_buf;
  151. return pb;
  152. }
  153. /*
  154. * pl2303_buf_free
  155. *
  156. * Free the buffer and all associated memory.
  157. */
  158. static void pl2303_buf_free(struct pl2303_buf *pb)
  159. {
  160. if (pb) {
  161. kfree(pb->buf_buf);
  162. kfree(pb);
  163. }
  164. }
  165. /*
  166. * pl2303_buf_clear
  167. *
  168. * Clear out all data in the circular buffer.
  169. */
  170. static void pl2303_buf_clear(struct pl2303_buf *pb)
  171. {
  172. if (pb != NULL)
  173. pb->buf_get = pb->buf_put;
  174. /* equivalent to a get of all data available */
  175. }
  176. /*
  177. * pl2303_buf_data_avail
  178. *
  179. * Return the number of bytes of data available in the circular
  180. * buffer.
  181. */
  182. static unsigned int pl2303_buf_data_avail(struct pl2303_buf *pb)
  183. {
  184. if (pb == NULL)
  185. return 0;
  186. return ((pb->buf_size + pb->buf_put - pb->buf_get) % pb->buf_size);
  187. }
  188. /*
  189. * pl2303_buf_space_avail
  190. *
  191. * Return the number of bytes of space available in the circular
  192. * buffer.
  193. */
  194. static unsigned int pl2303_buf_space_avail(struct pl2303_buf *pb)
  195. {
  196. if (pb == NULL)
  197. return 0;
  198. return ((pb->buf_size + pb->buf_get - pb->buf_put - 1) % pb->buf_size);
  199. }
  200. /*
  201. * pl2303_buf_put
  202. *
  203. * Copy data data from a user buffer and put it into the circular buffer.
  204. * Restrict to the amount of space available.
  205. *
  206. * Return the number of bytes copied.
  207. */
  208. static unsigned int pl2303_buf_put(struct pl2303_buf *pb, const char *buf,
  209. unsigned int count)
  210. {
  211. unsigned int len;
  212. if (pb == NULL)
  213. return 0;
  214. len = pl2303_buf_space_avail(pb);
  215. if (count > len)
  216. count = len;
  217. if (count == 0)
  218. return 0;
  219. len = pb->buf_buf + pb->buf_size - pb->buf_put;
  220. if (count > len) {
  221. memcpy(pb->buf_put, buf, len);
  222. memcpy(pb->buf_buf, buf+len, count - len);
  223. pb->buf_put = pb->buf_buf + count - len;
  224. } else {
  225. memcpy(pb->buf_put, buf, count);
  226. if (count < len)
  227. pb->buf_put += count;
  228. else /* count == len */
  229. pb->buf_put = pb->buf_buf;
  230. }
  231. return count;
  232. }
  233. /*
  234. * pl2303_buf_get
  235. *
  236. * Get data from the circular buffer and copy to the given buffer.
  237. * Restrict to the amount of data available.
  238. *
  239. * Return the number of bytes copied.
  240. */
  241. static unsigned int pl2303_buf_get(struct pl2303_buf *pb, char *buf,
  242. unsigned int count)
  243. {
  244. unsigned int len;
  245. if (pb == NULL)
  246. return 0;
  247. len = pl2303_buf_data_avail(pb);
  248. if (count > len)
  249. count = len;
  250. if (count == 0)
  251. return 0;
  252. len = pb->buf_buf + pb->buf_size - pb->buf_get;
  253. if (count > len) {
  254. memcpy(buf, pb->buf_get, len);
  255. memcpy(buf+len, pb->buf_buf, count - len);
  256. pb->buf_get = pb->buf_buf + count - len;
  257. } else {
  258. memcpy(buf, pb->buf_get, count);
  259. if (count < len)
  260. pb->buf_get += count;
  261. else /* count == len */
  262. pb->buf_get = pb->buf_buf;
  263. }
  264. return count;
  265. }
  266. static int pl2303_startup(struct usb_serial *serial)
  267. {
  268. struct pl2303_private *priv;
  269. enum pl2303_type type = type_0;
  270. int i;
  271. if (serial->dev->descriptor.bDeviceClass == 0x02)
  272. type = type_0;
  273. else if (serial->dev->descriptor.bMaxPacketSize0 == 0x40)
  274. type = HX;
  275. else if (serial->dev->descriptor.bDeviceClass == 0x00)
  276. type = type_1;
  277. else if (serial->dev->descriptor.bDeviceClass == 0xFF)
  278. type = type_1;
  279. dbg("device type: %d", type);
  280. for (i = 0; i < serial->num_ports; ++i) {
  281. priv = kzalloc(sizeof(struct pl2303_private), GFP_KERNEL);
  282. if (!priv)
  283. goto cleanup;
  284. spin_lock_init(&priv->lock);
  285. priv->buf = pl2303_buf_alloc(PL2303_BUF_SIZE);
  286. if (priv->buf == NULL) {
  287. kfree(priv);
  288. goto cleanup;
  289. }
  290. init_waitqueue_head(&priv->delta_msr_wait);
  291. priv->type = type;
  292. usb_set_serial_port_data(serial->port[i], priv);
  293. }
  294. return 0;
  295. cleanup:
  296. for (--i; i>=0; --i) {
  297. priv = usb_get_serial_port_data(serial->port[i]);
  298. pl2303_buf_free(priv->buf);
  299. kfree(priv);
  300. usb_set_serial_port_data(serial->port[i], NULL);
  301. }
  302. return -ENOMEM;
  303. }
  304. static int set_control_lines(struct usb_device *dev, u8 value)
  305. {
  306. int retval;
  307. retval = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
  308. SET_CONTROL_REQUEST, SET_CONTROL_REQUEST_TYPE,
  309. value, 0, NULL, 0, 100);
  310. dbg("%s - value = %d, retval = %d", __FUNCTION__, value, retval);
  311. return retval;
  312. }
  313. static void pl2303_send(struct usb_serial_port *port)
  314. {
  315. int count, result;
  316. struct pl2303_private *priv = usb_get_serial_port_data(port);
  317. unsigned long flags;
  318. dbg("%s - port %d", __FUNCTION__, port->number);
  319. spin_lock_irqsave(&priv->lock, flags);
  320. if (priv->write_urb_in_use) {
  321. spin_unlock_irqrestore(&priv->lock, flags);
  322. return;
  323. }
  324. count = pl2303_buf_get(priv->buf, port->write_urb->transfer_buffer,
  325. port->bulk_out_size);
  326. if (count == 0) {
  327. spin_unlock_irqrestore(&priv->lock, flags);
  328. return;
  329. }
  330. priv->write_urb_in_use = 1;
  331. spin_unlock_irqrestore(&priv->lock, flags);
  332. usb_serial_debug_data(debug, &port->dev, __FUNCTION__, count,
  333. port->write_urb->transfer_buffer);
  334. port->write_urb->transfer_buffer_length = count;
  335. port->write_urb->dev = port->serial->dev;
  336. result = usb_submit_urb(port->write_urb, GFP_ATOMIC);
  337. if (result) {
  338. dev_err(&port->dev, "%s - failed submitting write urb,"
  339. " error %d\n", __FUNCTION__, result);
  340. priv->write_urb_in_use = 0;
  341. // TODO: reschedule pl2303_send
  342. }
  343. usb_serial_port_softint(port);
  344. }
  345. static int pl2303_write(struct usb_serial_port *port, const unsigned char *buf,
  346. int count)
  347. {
  348. struct pl2303_private *priv = usb_get_serial_port_data(port);
  349. unsigned long flags;
  350. dbg("%s - port %d, %d bytes", __FUNCTION__, port->number, count);
  351. if (!count)
  352. return count;
  353. spin_lock_irqsave(&priv->lock, flags);
  354. count = pl2303_buf_put(priv->buf, buf, count);
  355. spin_unlock_irqrestore(&priv->lock, flags);
  356. pl2303_send(port);
  357. return count;
  358. }
  359. static int pl2303_write_room(struct usb_serial_port *port)
  360. {
  361. struct pl2303_private *priv = usb_get_serial_port_data(port);
  362. int room = 0;
  363. unsigned long flags;
  364. dbg("%s - port %d", __FUNCTION__, port->number);
  365. spin_lock_irqsave(&priv->lock, flags);
  366. room = pl2303_buf_space_avail(priv->buf);
  367. spin_unlock_irqrestore(&priv->lock, flags);
  368. dbg("%s - returns %d", __FUNCTION__, room);
  369. return room;
  370. }
  371. static int pl2303_chars_in_buffer(struct usb_serial_port *port)
  372. {
  373. struct pl2303_private *priv = usb_get_serial_port_data(port);
  374. int chars = 0;
  375. unsigned long flags;
  376. dbg("%s - port %d", __FUNCTION__, port->number);
  377. spin_lock_irqsave(&priv->lock, flags);
  378. chars = pl2303_buf_data_avail(priv->buf);
  379. spin_unlock_irqrestore(&priv->lock, flags);
  380. dbg("%s - returns %d", __FUNCTION__, chars);
  381. return chars;
  382. }
  383. static void pl2303_set_termios(struct usb_serial_port *port,
  384. struct ktermios *old_termios)
  385. {
  386. struct usb_serial *serial = port->serial;
  387. struct pl2303_private *priv = usb_get_serial_port_data(port);
  388. unsigned long flags;
  389. unsigned int cflag;
  390. unsigned char *buf;
  391. int baud;
  392. int i;
  393. u8 control;
  394. dbg("%s - port %d", __FUNCTION__, port->number);
  395. if ((!port->tty) || (!port->tty->termios)) {
  396. dbg("%s - no tty structures", __FUNCTION__);
  397. return;
  398. }
  399. spin_lock_irqsave(&priv->lock, flags);
  400. if (!priv->termios_initialized) {
  401. *(port->tty->termios) = tty_std_termios;
  402. port->tty->termios->c_cflag = B9600 | CS8 | CREAD |
  403. HUPCL | CLOCAL;
  404. priv->termios_initialized = 1;
  405. }
  406. spin_unlock_irqrestore(&priv->lock, flags);
  407. cflag = port->tty->termios->c_cflag;
  408. /* check that they really want us to change something */
  409. if (old_termios) {
  410. if ((cflag == old_termios->c_cflag) &&
  411. (RELEVANT_IFLAG(port->tty->termios->c_iflag) ==
  412. RELEVANT_IFLAG(old_termios->c_iflag))) {
  413. dbg("%s - nothing to change...", __FUNCTION__);
  414. return;
  415. }
  416. }
  417. buf = kzalloc(7, GFP_KERNEL);
  418. if (!buf) {
  419. dev_err(&port->dev, "%s - out of memory.\n", __FUNCTION__);
  420. return;
  421. }
  422. i = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
  423. GET_LINE_REQUEST, GET_LINE_REQUEST_TYPE,
  424. 0, 0, buf, 7, 100);
  425. dbg("0xa1:0x21:0:0 %d - %x %x %x %x %x %x %x", i,
  426. buf[0], buf[1], buf[2], buf[3], buf[4], buf[5], buf[6]);
  427. if (cflag & CSIZE) {
  428. switch (cflag & CSIZE) {
  429. case CS5: buf[6] = 5; break;
  430. case CS6: buf[6] = 6; break;
  431. case CS7: buf[6] = 7; break;
  432. default:
  433. case CS8: buf[6] = 8; break;
  434. }
  435. dbg("%s - data bits = %d", __FUNCTION__, buf[6]);
  436. }
  437. baud = 0;
  438. switch (cflag & CBAUD) {
  439. case B0: baud = 0; break;
  440. case B75: baud = 75; break;
  441. case B150: baud = 150; break;
  442. case B300: baud = 300; break;
  443. case B600: baud = 600; break;
  444. case B1200: baud = 1200; break;
  445. case B1800: baud = 1800; break;
  446. case B2400: baud = 2400; break;
  447. case B4800: baud = 4800; break;
  448. case B9600: baud = 9600; break;
  449. case B19200: baud = 19200; break;
  450. case B38400: baud = 38400; break;
  451. case B57600: baud = 57600; break;
  452. case B115200: baud = 115200; break;
  453. case B230400: baud = 230400; break;
  454. case B460800: baud = 460800; break;
  455. default:
  456. dev_err(&port->dev, "pl2303 driver does not support"
  457. " the baudrate requested (fix it)\n");
  458. break;
  459. }
  460. dbg("%s - baud = %d", __FUNCTION__, baud);
  461. if (baud) {
  462. buf[0] = baud & 0xff;
  463. buf[1] = (baud >> 8) & 0xff;
  464. buf[2] = (baud >> 16) & 0xff;
  465. buf[3] = (baud >> 24) & 0xff;
  466. }
  467. /* For reference buf[4]=0 is 1 stop bits */
  468. /* For reference buf[4]=1 is 1.5 stop bits */
  469. /* For reference buf[4]=2 is 2 stop bits */
  470. if (cflag & CSTOPB) {
  471. buf[4] = 2;
  472. dbg("%s - stop bits = 2", __FUNCTION__);
  473. } else {
  474. buf[4] = 0;
  475. dbg("%s - stop bits = 1", __FUNCTION__);
  476. }
  477. if (cflag & PARENB) {
  478. /* For reference buf[5]=0 is none parity */
  479. /* For reference buf[5]=1 is odd parity */
  480. /* For reference buf[5]=2 is even parity */
  481. /* For reference buf[5]=3 is mark parity */
  482. /* For reference buf[5]=4 is space parity */
  483. if (cflag & PARODD) {
  484. buf[5] = 1;
  485. dbg("%s - parity = odd", __FUNCTION__);
  486. } else {
  487. buf[5] = 2;
  488. dbg("%s - parity = even", __FUNCTION__);
  489. }
  490. } else {
  491. buf[5] = 0;
  492. dbg("%s - parity = none", __FUNCTION__);
  493. }
  494. i = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
  495. SET_LINE_REQUEST, SET_LINE_REQUEST_TYPE,
  496. 0, 0, buf, 7, 100);
  497. dbg("0x21:0x20:0:0 %d", i);
  498. /* change control lines if we are switching to or from B0 */
  499. spin_lock_irqsave(&priv->lock, flags);
  500. control = priv->line_control;
  501. if ((cflag & CBAUD) == B0)
  502. priv->line_control &= ~(CONTROL_DTR | CONTROL_RTS);
  503. else
  504. priv->line_control |= (CONTROL_DTR | CONTROL_RTS);
  505. if (control != priv->line_control) {
  506. control = priv->line_control;
  507. spin_unlock_irqrestore(&priv->lock, flags);
  508. set_control_lines(serial->dev, control);
  509. } else {
  510. spin_unlock_irqrestore(&priv->lock, flags);
  511. }
  512. buf[0] = buf[1] = buf[2] = buf[3] = buf[4] = buf[5] = buf[6] = 0;
  513. i = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
  514. GET_LINE_REQUEST, GET_LINE_REQUEST_TYPE,
  515. 0, 0, buf, 7, 100);
  516. dbg("0xa1:0x21:0:0 %d - %x %x %x %x %x %x %x", i,
  517. buf[0], buf[1], buf[2], buf[3], buf[4], buf[5], buf[6]);
  518. if (cflag & CRTSCTS) {
  519. __u16 index;
  520. if (priv->type == HX)
  521. index = 0x61;
  522. else
  523. index = 0x41;
  524. i = usb_control_msg(serial->dev,
  525. usb_sndctrlpipe(serial->dev, 0),
  526. VENDOR_WRITE_REQUEST,
  527. VENDOR_WRITE_REQUEST_TYPE,
  528. 0x0, index, NULL, 0, 100);
  529. dbg("0x40:0x1:0x0:0x%x %d", index, i);
  530. }
  531. kfree(buf);
  532. }
  533. static void pl2303_close(struct usb_serial_port *port, struct file *filp)
  534. {
  535. struct pl2303_private *priv = usb_get_serial_port_data(port);
  536. unsigned long flags;
  537. unsigned int c_cflag;
  538. int bps;
  539. long timeout;
  540. wait_queue_t wait;
  541. dbg("%s - port %d", __FUNCTION__, port->number);
  542. /* wait for data to drain from the buffer */
  543. spin_lock_irqsave(&priv->lock, flags);
  544. timeout = PL2303_CLOSING_WAIT;
  545. init_waitqueue_entry(&wait, current);
  546. add_wait_queue(&port->tty->write_wait, &wait);
  547. for (;;) {
  548. set_current_state(TASK_INTERRUPTIBLE);
  549. if (pl2303_buf_data_avail(priv->buf) == 0 ||
  550. timeout == 0 || signal_pending(current) ||
  551. !usb_get_intfdata(port->serial->interface)) /* disconnect */
  552. break;
  553. spin_unlock_irqrestore(&priv->lock, flags);
  554. timeout = schedule_timeout(timeout);
  555. spin_lock_irqsave(&priv->lock, flags);
  556. }
  557. set_current_state(TASK_RUNNING);
  558. remove_wait_queue(&port->tty->write_wait, &wait);
  559. /* clear out any remaining data in the buffer */
  560. pl2303_buf_clear(priv->buf);
  561. spin_unlock_irqrestore(&priv->lock, flags);
  562. /* wait for characters to drain from the device */
  563. /* (this is long enough for the entire 256 byte */
  564. /* pl2303 hardware buffer to drain with no flow */
  565. /* control for data rates of 1200 bps or more, */
  566. /* for lower rates we should really know how much */
  567. /* data is in the buffer to compute a delay */
  568. /* that is not unnecessarily long) */
  569. bps = tty_get_baud_rate(port->tty);
  570. if (bps > 1200)
  571. timeout = max((HZ*2560)/bps,HZ/10);
  572. else
  573. timeout = 2*HZ;
  574. schedule_timeout_interruptible(timeout);
  575. /* shutdown our urbs */
  576. dbg("%s - shutting down urbs", __FUNCTION__);
  577. usb_kill_urb(port->write_urb);
  578. usb_kill_urb(port->read_urb);
  579. usb_kill_urb(port->interrupt_in_urb);
  580. if (port->tty) {
  581. c_cflag = port->tty->termios->c_cflag;
  582. if (c_cflag & HUPCL) {
  583. /* drop DTR and RTS */
  584. spin_lock_irqsave(&priv->lock, flags);
  585. priv->line_control = 0;
  586. spin_unlock_irqrestore(&priv->lock, flags);
  587. set_control_lines(port->serial->dev, 0);
  588. }
  589. }
  590. }
  591. static int pl2303_open(struct usb_serial_port *port, struct file *filp)
  592. {
  593. struct ktermios tmp_termios;
  594. struct usb_serial *serial = port->serial;
  595. struct pl2303_private *priv = usb_get_serial_port_data(port);
  596. unsigned char *buf;
  597. int result;
  598. dbg("%s - port %d", __FUNCTION__, port->number);
  599. if (priv->type != HX) {
  600. usb_clear_halt(serial->dev, port->write_urb->pipe);
  601. usb_clear_halt(serial->dev, port->read_urb->pipe);
  602. }
  603. buf = kmalloc(10, GFP_KERNEL);
  604. if (buf==NULL)
  605. return -ENOMEM;
  606. #define FISH(a,b,c,d) \
  607. result=usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev,0), \
  608. b, a, c, d, buf, 1, 100); \
  609. dbg("0x%x:0x%x:0x%x:0x%x %d - %x",a,b,c,d,result,buf[0]);
  610. #define SOUP(a,b,c,d) \
  611. result=usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev,0), \
  612. b, a, c, d, NULL, 0, 100); \
  613. dbg("0x%x:0x%x:0x%x:0x%x %d",a,b,c,d,result);
  614. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8484, 0);
  615. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 0x0404, 0);
  616. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8484, 0);
  617. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8383, 0);
  618. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8484, 0);
  619. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 0x0404, 1);
  620. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8484, 0);
  621. FISH (VENDOR_READ_REQUEST_TYPE, VENDOR_READ_REQUEST, 0x8383, 0);
  622. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 0, 1);
  623. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 1, 0);
  624. if (priv->type == HX) {
  625. /* HX chip */
  626. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 2, 0x44);
  627. /* reset upstream data pipes */
  628. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 8, 0);
  629. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 9, 0);
  630. } else {
  631. SOUP (VENDOR_WRITE_REQUEST_TYPE, VENDOR_WRITE_REQUEST, 2, 0x24);
  632. }
  633. kfree(buf);
  634. /* Setup termios */
  635. if (port->tty) {
  636. pl2303_set_termios(port, &tmp_termios);
  637. }
  638. //FIXME: need to assert RTS and DTR if CRTSCTS off
  639. dbg("%s - submitting read urb", __FUNCTION__);
  640. port->read_urb->dev = serial->dev;
  641. result = usb_submit_urb(port->read_urb, GFP_KERNEL);
  642. if (result) {
  643. dev_err(&port->dev, "%s - failed submitting read urb,"
  644. " error %d\n", __FUNCTION__, result);
  645. pl2303_close(port, NULL);
  646. return -EPROTO;
  647. }
  648. dbg("%s - submitting interrupt urb", __FUNCTION__);
  649. port->interrupt_in_urb->dev = serial->dev;
  650. result = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
  651. if (result) {
  652. dev_err(&port->dev, "%s - failed submitting interrupt urb,"
  653. " error %d\n", __FUNCTION__, result);
  654. pl2303_close(port, NULL);
  655. return -EPROTO;
  656. }
  657. return 0;
  658. }
  659. static int pl2303_tiocmset(struct usb_serial_port *port, struct file *file,
  660. unsigned int set, unsigned int clear)
  661. {
  662. struct pl2303_private *priv = usb_get_serial_port_data(port);
  663. unsigned long flags;
  664. u8 control;
  665. if (!usb_get_intfdata(port->serial->interface))
  666. return -ENODEV;
  667. spin_lock_irqsave(&priv->lock, flags);
  668. if (set & TIOCM_RTS)
  669. priv->line_control |= CONTROL_RTS;
  670. if (set & TIOCM_DTR)
  671. priv->line_control |= CONTROL_DTR;
  672. if (clear & TIOCM_RTS)
  673. priv->line_control &= ~CONTROL_RTS;
  674. if (clear & TIOCM_DTR)
  675. priv->line_control &= ~CONTROL_DTR;
  676. control = priv->line_control;
  677. spin_unlock_irqrestore(&priv->lock, flags);
  678. return set_control_lines(port->serial->dev, control);
  679. }
  680. static int pl2303_tiocmget(struct usb_serial_port *port, struct file *file)
  681. {
  682. struct pl2303_private *priv = usb_get_serial_port_data(port);
  683. unsigned long flags;
  684. unsigned int mcr;
  685. unsigned int status;
  686. unsigned int result;
  687. dbg("%s (%d)", __FUNCTION__, port->number);
  688. if (!usb_get_intfdata(port->serial->interface))
  689. return -ENODEV;
  690. spin_lock_irqsave(&priv->lock, flags);
  691. mcr = priv->line_control;
  692. status = priv->line_status;
  693. spin_unlock_irqrestore(&priv->lock, flags);
  694. result = ((mcr & CONTROL_DTR) ? TIOCM_DTR : 0)
  695. | ((mcr & CONTROL_RTS) ? TIOCM_RTS : 0)
  696. | ((status & UART_CTS) ? TIOCM_CTS : 0)
  697. | ((status & UART_DSR) ? TIOCM_DSR : 0)
  698. | ((status & UART_RING) ? TIOCM_RI : 0)
  699. | ((status & UART_DCD) ? TIOCM_CD : 0);
  700. dbg("%s - result = %x", __FUNCTION__, result);
  701. return result;
  702. }
  703. static int wait_modem_info(struct usb_serial_port *port, unsigned int arg)
  704. {
  705. struct pl2303_private *priv = usb_get_serial_port_data(port);
  706. unsigned long flags;
  707. unsigned int prevstatus;
  708. unsigned int status;
  709. unsigned int changed;
  710. spin_lock_irqsave(&priv->lock, flags);
  711. prevstatus = priv->line_status;
  712. spin_unlock_irqrestore(&priv->lock, flags);
  713. while (1) {
  714. interruptible_sleep_on(&priv->delta_msr_wait);
  715. /* see if a signal did it */
  716. if (signal_pending(current))
  717. return -ERESTARTSYS;
  718. spin_lock_irqsave(&priv->lock, flags);
  719. status = priv->line_status;
  720. spin_unlock_irqrestore(&priv->lock, flags);
  721. changed=prevstatus^status;
  722. if (((arg & TIOCM_RNG) && (changed & UART_RING)) ||
  723. ((arg & TIOCM_DSR) && (changed & UART_DSR)) ||
  724. ((arg & TIOCM_CD) && (changed & UART_DCD)) ||
  725. ((arg & TIOCM_CTS) && (changed & UART_CTS)) ) {
  726. return 0;
  727. }
  728. prevstatus = status;
  729. }
  730. /* NOTREACHED */
  731. return 0;
  732. }
  733. static int pl2303_ioctl(struct usb_serial_port *port, struct file *file,
  734. unsigned int cmd, unsigned long arg)
  735. {
  736. dbg("%s (%d) cmd = 0x%04x", __FUNCTION__, port->number, cmd);
  737. switch (cmd) {
  738. case TIOCMIWAIT:
  739. dbg("%s (%d) TIOCMIWAIT", __FUNCTION__, port->number);
  740. return wait_modem_info(port, arg);
  741. default:
  742. dbg("%s not supported = 0x%04x", __FUNCTION__, cmd);
  743. break;
  744. }
  745. return -ENOIOCTLCMD;
  746. }
  747. static void pl2303_break_ctl(struct usb_serial_port *port, int break_state)
  748. {
  749. struct usb_serial *serial = port->serial;
  750. u16 state;
  751. int result;
  752. dbg("%s - port %d", __FUNCTION__, port->number);
  753. if (break_state == 0)
  754. state = BREAK_OFF;
  755. else
  756. state = BREAK_ON;
  757. dbg("%s - turning break %s", __FUNCTION__, state==BREAK_OFF ? "off" : "on");
  758. result = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
  759. BREAK_REQUEST, BREAK_REQUEST_TYPE, state,
  760. 0, NULL, 0, 100);
  761. if (result)
  762. dbg("%s - error sending break = %d", __FUNCTION__, result);
  763. }
  764. static void pl2303_shutdown(struct usb_serial *serial)
  765. {
  766. int i;
  767. struct pl2303_private *priv;
  768. dbg("%s", __FUNCTION__);
  769. for (i = 0; i < serial->num_ports; ++i) {
  770. priv = usb_get_serial_port_data(serial->port[i]);
  771. if (priv) {
  772. pl2303_buf_free(priv->buf);
  773. kfree(priv);
  774. usb_set_serial_port_data(serial->port[i], NULL);
  775. }
  776. }
  777. }
  778. static void pl2303_update_line_status(struct usb_serial_port *port,
  779. unsigned char *data,
  780. unsigned int actual_length)
  781. {
  782. struct pl2303_private *priv = usb_get_serial_port_data(port);
  783. unsigned long flags;
  784. u8 status_idx = UART_STATE;
  785. u8 length = UART_STATE + 1;
  786. u16 idv, idp;
  787. idv = le16_to_cpu(port->serial->dev->descriptor.idVendor);
  788. idp = le16_to_cpu(port->serial->dev->descriptor.idProduct);
  789. if (idv == SIEMENS_VENDOR_ID) {
  790. if (idp == SIEMENS_PRODUCT_ID_X65 ||
  791. idp == SIEMENS_PRODUCT_ID_SX1 ||
  792. idp == SIEMENS_PRODUCT_ID_X75) {
  793. length = 1;
  794. status_idx = 0;
  795. }
  796. }
  797. if (actual_length < length)
  798. return;
  799. /* Save off the uart status for others to look at */
  800. spin_lock_irqsave(&priv->lock, flags);
  801. priv->line_status = data[status_idx];
  802. spin_unlock_irqrestore(&priv->lock, flags);
  803. wake_up_interruptible(&priv->delta_msr_wait);
  804. }
  805. static void pl2303_read_int_callback(struct urb *urb)
  806. {
  807. struct usb_serial_port *port = (struct usb_serial_port *) urb->context;
  808. unsigned char *data = urb->transfer_buffer;
  809. unsigned int actual_length = urb->actual_length;
  810. int status;
  811. dbg("%s (%d)", __FUNCTION__, port->number);
  812. switch (urb->status) {
  813. case 0:
  814. /* success */
  815. break;
  816. case -ECONNRESET:
  817. case -ENOENT:
  818. case -ESHUTDOWN:
  819. /* this urb is terminated, clean up */
  820. dbg("%s - urb shutting down with status: %d", __FUNCTION__,
  821. urb->status);
  822. return;
  823. default:
  824. dbg("%s - nonzero urb status received: %d", __FUNCTION__,
  825. urb->status);
  826. goto exit;
  827. }
  828. usb_serial_debug_data(debug, &port->dev, __FUNCTION__,
  829. urb->actual_length, urb->transfer_buffer);
  830. pl2303_update_line_status(port, data, actual_length);
  831. exit:
  832. status = usb_submit_urb(urb, GFP_ATOMIC);
  833. if (status)
  834. dev_err(&urb->dev->dev,
  835. "%s - usb_submit_urb failed with result %d\n",
  836. __FUNCTION__, status);
  837. }
  838. static void pl2303_read_bulk_callback(struct urb *urb)
  839. {
  840. struct usb_serial_port *port = (struct usb_serial_port *) urb->context;
  841. struct pl2303_private *priv = usb_get_serial_port_data(port);
  842. struct tty_struct *tty;
  843. unsigned char *data = urb->transfer_buffer;
  844. unsigned long flags;
  845. int i;
  846. int result;
  847. u8 status;
  848. char tty_flag;
  849. dbg("%s - port %d", __FUNCTION__, port->number);
  850. if (urb->status) {
  851. dbg("%s - urb->status = %d", __FUNCTION__, urb->status);
  852. if (!port->open_count) {
  853. dbg("%s - port is closed, exiting.", __FUNCTION__);
  854. return;
  855. }
  856. if (urb->status == -EPROTO) {
  857. /* PL2303 mysteriously fails with -EPROTO reschedule
  858. * the read */
  859. dbg("%s - caught -EPROTO, resubmitting the urb",
  860. __FUNCTION__);
  861. urb->status = 0;
  862. urb->dev = port->serial->dev;
  863. result = usb_submit_urb(urb, GFP_ATOMIC);
  864. if (result)
  865. dev_err(&urb->dev->dev, "%s - failed"
  866. " resubmitting read urb, error %d\n",
  867. __FUNCTION__, result);
  868. return;
  869. }
  870. dbg("%s - unable to handle the error, exiting.", __FUNCTION__);
  871. return;
  872. }
  873. usb_serial_debug_data(debug, &port->dev, __FUNCTION__,
  874. urb->actual_length, data);
  875. /* get tty_flag from status */
  876. tty_flag = TTY_NORMAL;
  877. spin_lock_irqsave(&priv->lock, flags);
  878. status = priv->line_status;
  879. priv->line_status &= ~UART_STATE_TRANSIENT_MASK;
  880. spin_unlock_irqrestore(&priv->lock, flags);
  881. wake_up_interruptible(&priv->delta_msr_wait);
  882. /* break takes precedence over parity, */
  883. /* which takes precedence over framing errors */
  884. if (status & UART_BREAK_ERROR )
  885. tty_flag = TTY_BREAK;
  886. else if (status & UART_PARITY_ERROR)
  887. tty_flag = TTY_PARITY;
  888. else if (status & UART_FRAME_ERROR)
  889. tty_flag = TTY_FRAME;
  890. dbg("%s - tty_flag = %d", __FUNCTION__, tty_flag);
  891. tty = port->tty;
  892. if (tty && urb->actual_length) {
  893. tty_buffer_request_room(tty, urb->actual_length + 1);
  894. /* overrun is special, not associated with a char */
  895. if (status & UART_OVERRUN_ERROR)
  896. tty_insert_flip_char(tty, 0, TTY_OVERRUN);
  897. for (i = 0; i < urb->actual_length; ++i)
  898. tty_insert_flip_char(tty, data[i], tty_flag);
  899. tty_flip_buffer_push(tty);
  900. }
  901. /* Schedule the next read _if_ we are still open */
  902. if (port->open_count) {
  903. urb->dev = port->serial->dev;
  904. result = usb_submit_urb(urb, GFP_ATOMIC);
  905. if (result)
  906. dev_err(&urb->dev->dev, "%s - failed resubmitting"
  907. " read urb, error %d\n", __FUNCTION__, result);
  908. }
  909. return;
  910. }
  911. static void pl2303_write_bulk_callback(struct urb *urb)
  912. {
  913. struct usb_serial_port *port = (struct usb_serial_port *) urb->context;
  914. struct pl2303_private *priv = usb_get_serial_port_data(port);
  915. int result;
  916. dbg("%s - port %d", __FUNCTION__, port->number);
  917. switch (urb->status) {
  918. case 0:
  919. /* success */
  920. break;
  921. case -ECONNRESET:
  922. case -ENOENT:
  923. case -ESHUTDOWN:
  924. /* this urb is terminated, clean up */
  925. dbg("%s - urb shutting down with status: %d", __FUNCTION__,
  926. urb->status);
  927. priv->write_urb_in_use = 0;
  928. return;
  929. default:
  930. /* error in the urb, so we have to resubmit it */
  931. dbg("%s - Overflow in write", __FUNCTION__);
  932. dbg("%s - nonzero write bulk status received: %d", __FUNCTION__,
  933. urb->status);
  934. port->write_urb->transfer_buffer_length = 1;
  935. port->write_urb->dev = port->serial->dev;
  936. result = usb_submit_urb(port->write_urb, GFP_ATOMIC);
  937. if (result)
  938. dev_err(&urb->dev->dev, "%s - failed resubmitting write"
  939. " urb, error %d\n", __FUNCTION__, result);
  940. else
  941. return;
  942. }
  943. priv->write_urb_in_use = 0;
  944. /* send any buffered data */
  945. pl2303_send(port);
  946. }
  947. /* All of the device info needed for the PL2303 SIO serial converter */
  948. static struct usb_serial_driver pl2303_device = {
  949. .driver = {
  950. .owner = THIS_MODULE,
  951. .name = "pl2303",
  952. },
  953. .id_table = id_table,
  954. .usb_driver = &pl2303_driver,
  955. .num_interrupt_in = NUM_DONT_CARE,
  956. .num_bulk_in = 1,
  957. .num_bulk_out = 1,
  958. .num_ports = 1,
  959. .open = pl2303_open,
  960. .close = pl2303_close,
  961. .write = pl2303_write,
  962. .ioctl = pl2303_ioctl,
  963. .break_ctl = pl2303_break_ctl,
  964. .set_termios = pl2303_set_termios,
  965. .tiocmget = pl2303_tiocmget,
  966. .tiocmset = pl2303_tiocmset,
  967. .read_bulk_callback = pl2303_read_bulk_callback,
  968. .read_int_callback = pl2303_read_int_callback,
  969. .write_bulk_callback = pl2303_write_bulk_callback,
  970. .write_room = pl2303_write_room,
  971. .chars_in_buffer = pl2303_chars_in_buffer,
  972. .attach = pl2303_startup,
  973. .shutdown = pl2303_shutdown,
  974. };
  975. static int __init pl2303_init(void)
  976. {
  977. int retval;
  978. retval = usb_serial_register(&pl2303_device);
  979. if (retval)
  980. goto failed_usb_serial_register;
  981. retval = usb_register(&pl2303_driver);
  982. if (retval)
  983. goto failed_usb_register;
  984. info(DRIVER_DESC);
  985. return 0;
  986. failed_usb_register:
  987. usb_serial_deregister(&pl2303_device);
  988. failed_usb_serial_register:
  989. return retval;
  990. }
  991. static void __exit pl2303_exit(void)
  992. {
  993. usb_deregister(&pl2303_driver);
  994. usb_serial_deregister(&pl2303_device);
  995. }
  996. module_init(pl2303_init);
  997. module_exit(pl2303_exit);
  998. MODULE_DESCRIPTION(DRIVER_DESC);
  999. MODULE_LICENSE("GPL");
  1000. module_param(debug, bool, S_IRUGO | S_IWUSR);
  1001. MODULE_PARM_DESC(debug, "Debug enabled or not");