serial_txx9.c 29 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159
  1. /*
  2. * drivers/serial/serial_txx9.c
  3. *
  4. * Derived from many drivers using generic_serial interface,
  5. * especially serial_tx3912.c by Steven J. Hill and r39xx_serial.c
  6. * (was in Linux/VR tree) by Jim Pick.
  7. *
  8. * Copyright (C) 1999 Harald Koerfgen
  9. * Copyright (C) 2000 Jim Pick <jim@jimpick.com>
  10. * Copyright (C) 2001 Steven J. Hill (sjhill@realitydiluted.com)
  11. * Copyright (C) 2000-2002 Toshiba Corporation
  12. *
  13. * This program is free software; you can redistribute it and/or modify
  14. * it under the terms of the GNU General Public License version 2 as
  15. * published by the Free Software Foundation.
  16. *
  17. * Serial driver for TX3927/TX4927/TX4925/TX4938 internal SIO controller
  18. *
  19. * Revision History:
  20. * 0.30 Initial revision. (Renamed from serial_txx927.c)
  21. * 0.31 Use save_flags instead of local_irq_save.
  22. * 0.32 Support SCLK.
  23. * 0.33 Switch TXX9_TTY_NAME by CONFIG_SERIAL_TXX9_STDSERIAL.
  24. * Support TIOCSERGETLSR.
  25. * 0.34 Support slow baudrate.
  26. * 0.40 Merge codes from mainstream kernel (2.4.22).
  27. * 0.41 Fix console checking in rs_shutdown_port().
  28. * Disable flow-control in serial_console_write().
  29. * 0.42 Fix minor compiler warning.
  30. * 1.00 Kernel 2.6. Converted to new serial core (based on 8250.c).
  31. * 1.01 Set fifosize to make tx_empry called properly.
  32. * Use standard uart_get_divisor.
  33. * 1.02 Cleanup. (import 8250.c changes)
  34. */
  35. #include <linux/config.h>
  36. #if defined(CONFIG_SERIAL_TXX9_CONSOLE) && defined(CONFIG_MAGIC_SYSRQ)
  37. #define SUPPORT_SYSRQ
  38. #endif
  39. #include <linux/module.h>
  40. #include <linux/ioport.h>
  41. #include <linux/init.h>
  42. #include <linux/console.h>
  43. #include <linux/sysrq.h>
  44. #include <linux/delay.h>
  45. #include <linux/device.h>
  46. #include <linux/pci.h>
  47. #include <linux/tty.h>
  48. #include <linux/tty_flip.h>
  49. #include <linux/serial_core.h>
  50. #include <linux/serial.h>
  51. #include <asm/io.h>
  52. #include <asm/irq.h>
  53. static char *serial_version = "1.02";
  54. static char *serial_name = "TX39/49 Serial driver";
  55. #define PASS_LIMIT 256
  56. #if !defined(CONFIG_SERIAL_TXX9_STDSERIAL)
  57. /* "ttyS" is used for standard serial driver */
  58. #define TXX9_TTY_NAME "ttyTX"
  59. #define TXX9_TTY_DEVFS_NAME "tttx/"
  60. #define TXX9_TTY_MINOR_START (64 + 64) /* ttyTX0(128), ttyTX1(129) */
  61. #else
  62. /* acts like standard serial driver */
  63. #define TXX9_TTY_NAME "ttyS"
  64. #define TXX9_TTY_DEVFS_NAME "tts/"
  65. #define TXX9_TTY_MINOR_START 64
  66. #endif
  67. #define TXX9_TTY_MAJOR TTY_MAJOR
  68. /* flag aliases */
  69. #define UPF_TXX9_HAVE_CTS_LINE UPF_BUGGY_UART
  70. #define UPF_TXX9_USE_SCLK UPF_MAGIC_MULTIPLIER
  71. #ifdef CONFIG_PCI
  72. /* support for Toshiba TC86C001 SIO */
  73. #define ENABLE_SERIAL_TXX9_PCI
  74. #endif
  75. /*
  76. * Number of serial ports
  77. */
  78. #ifdef ENABLE_SERIAL_TXX9_PCI
  79. #define NR_PCI_BOARDS 4
  80. #define UART_NR (2 + NR_PCI_BOARDS)
  81. #else
  82. #define UART_NR 2
  83. #endif
  84. struct uart_txx9_port {
  85. struct uart_port port;
  86. /*
  87. * We provide a per-port pm hook.
  88. */
  89. void (*pm)(struct uart_port *port,
  90. unsigned int state, unsigned int old);
  91. };
  92. #define TXX9_REGION_SIZE 0x24
  93. /* TXX9 Serial Registers */
  94. #define TXX9_SILCR 0x00
  95. #define TXX9_SIDICR 0x04
  96. #define TXX9_SIDISR 0x08
  97. #define TXX9_SICISR 0x0c
  98. #define TXX9_SIFCR 0x10
  99. #define TXX9_SIFLCR 0x14
  100. #define TXX9_SIBGR 0x18
  101. #define TXX9_SITFIFO 0x1c
  102. #define TXX9_SIRFIFO 0x20
  103. /* SILCR : Line Control */
  104. #define TXX9_SILCR_SCS_MASK 0x00000060
  105. #define TXX9_SILCR_SCS_IMCLK 0x00000000
  106. #define TXX9_SILCR_SCS_IMCLK_BG 0x00000020
  107. #define TXX9_SILCR_SCS_SCLK 0x00000040
  108. #define TXX9_SILCR_SCS_SCLK_BG 0x00000060
  109. #define TXX9_SILCR_UEPS 0x00000010
  110. #define TXX9_SILCR_UPEN 0x00000008
  111. #define TXX9_SILCR_USBL_MASK 0x00000004
  112. #define TXX9_SILCR_USBL_1BIT 0x00000000
  113. #define TXX9_SILCR_USBL_2BIT 0x00000004
  114. #define TXX9_SILCR_UMODE_MASK 0x00000003
  115. #define TXX9_SILCR_UMODE_8BIT 0x00000000
  116. #define TXX9_SILCR_UMODE_7BIT 0x00000001
  117. /* SIDICR : DMA/Int. Control */
  118. #define TXX9_SIDICR_TDE 0x00008000
  119. #define TXX9_SIDICR_RDE 0x00004000
  120. #define TXX9_SIDICR_TIE 0x00002000
  121. #define TXX9_SIDICR_RIE 0x00001000
  122. #define TXX9_SIDICR_SPIE 0x00000800
  123. #define TXX9_SIDICR_CTSAC 0x00000600
  124. #define TXX9_SIDICR_STIE_MASK 0x0000003f
  125. #define TXX9_SIDICR_STIE_OERS 0x00000020
  126. #define TXX9_SIDICR_STIE_CTSS 0x00000010
  127. #define TXX9_SIDICR_STIE_RBRKD 0x00000008
  128. #define TXX9_SIDICR_STIE_TRDY 0x00000004
  129. #define TXX9_SIDICR_STIE_TXALS 0x00000002
  130. #define TXX9_SIDICR_STIE_UBRKD 0x00000001
  131. /* SIDISR : DMA/Int. Status */
  132. #define TXX9_SIDISR_UBRK 0x00008000
  133. #define TXX9_SIDISR_UVALID 0x00004000
  134. #define TXX9_SIDISR_UFER 0x00002000
  135. #define TXX9_SIDISR_UPER 0x00001000
  136. #define TXX9_SIDISR_UOER 0x00000800
  137. #define TXX9_SIDISR_ERI 0x00000400
  138. #define TXX9_SIDISR_TOUT 0x00000200
  139. #define TXX9_SIDISR_TDIS 0x00000100
  140. #define TXX9_SIDISR_RDIS 0x00000080
  141. #define TXX9_SIDISR_STIS 0x00000040
  142. #define TXX9_SIDISR_RFDN_MASK 0x0000001f
  143. /* SICISR : Change Int. Status */
  144. #define TXX9_SICISR_OERS 0x00000020
  145. #define TXX9_SICISR_CTSS 0x00000010
  146. #define TXX9_SICISR_RBRKD 0x00000008
  147. #define TXX9_SICISR_TRDY 0x00000004
  148. #define TXX9_SICISR_TXALS 0x00000002
  149. #define TXX9_SICISR_UBRKD 0x00000001
  150. /* SIFCR : FIFO Control */
  151. #define TXX9_SIFCR_SWRST 0x00008000
  152. #define TXX9_SIFCR_RDIL_MASK 0x00000180
  153. #define TXX9_SIFCR_RDIL_1 0x00000000
  154. #define TXX9_SIFCR_RDIL_4 0x00000080
  155. #define TXX9_SIFCR_RDIL_8 0x00000100
  156. #define TXX9_SIFCR_RDIL_12 0x00000180
  157. #define TXX9_SIFCR_RDIL_MAX 0x00000180
  158. #define TXX9_SIFCR_TDIL_MASK 0x00000018
  159. #define TXX9_SIFCR_TDIL_MASK 0x00000018
  160. #define TXX9_SIFCR_TDIL_1 0x00000000
  161. #define TXX9_SIFCR_TDIL_4 0x00000001
  162. #define TXX9_SIFCR_TDIL_8 0x00000010
  163. #define TXX9_SIFCR_TDIL_MAX 0x00000010
  164. #define TXX9_SIFCR_TFRST 0x00000004
  165. #define TXX9_SIFCR_RFRST 0x00000002
  166. #define TXX9_SIFCR_FRSTE 0x00000001
  167. #define TXX9_SIO_TX_FIFO 8
  168. #define TXX9_SIO_RX_FIFO 16
  169. /* SIFLCR : Flow Control */
  170. #define TXX9_SIFLCR_RCS 0x00001000
  171. #define TXX9_SIFLCR_TES 0x00000800
  172. #define TXX9_SIFLCR_RTSSC 0x00000200
  173. #define TXX9_SIFLCR_RSDE 0x00000100
  174. #define TXX9_SIFLCR_TSDE 0x00000080
  175. #define TXX9_SIFLCR_RTSTL_MASK 0x0000001e
  176. #define TXX9_SIFLCR_RTSTL_MAX 0x0000001e
  177. #define TXX9_SIFLCR_TBRK 0x00000001
  178. /* SIBGR : Baudrate Control */
  179. #define TXX9_SIBGR_BCLK_MASK 0x00000300
  180. #define TXX9_SIBGR_BCLK_T0 0x00000000
  181. #define TXX9_SIBGR_BCLK_T2 0x00000100
  182. #define TXX9_SIBGR_BCLK_T4 0x00000200
  183. #define TXX9_SIBGR_BCLK_T6 0x00000300
  184. #define TXX9_SIBGR_BRD_MASK 0x000000ff
  185. static inline unsigned int sio_in(struct uart_txx9_port *up, int offset)
  186. {
  187. switch (up->port.iotype) {
  188. default:
  189. return *(volatile u32 *)(up->port.membase + offset);
  190. case UPIO_PORT:
  191. return inl(up->port.iobase + offset);
  192. }
  193. }
  194. static inline void
  195. sio_out(struct uart_txx9_port *up, int offset, int value)
  196. {
  197. switch (up->port.iotype) {
  198. default:
  199. *(volatile u32 *)(up->port.membase + offset) = value;
  200. break;
  201. case UPIO_PORT:
  202. outl(value, up->port.iobase + offset);
  203. break;
  204. }
  205. }
  206. static inline void
  207. sio_mask(struct uart_txx9_port *up, int offset, unsigned int value)
  208. {
  209. sio_out(up, offset, sio_in(up, offset) & ~value);
  210. }
  211. static inline void
  212. sio_set(struct uart_txx9_port *up, int offset, unsigned int value)
  213. {
  214. sio_out(up, offset, sio_in(up, offset) | value);
  215. }
  216. static inline void
  217. sio_quot_set(struct uart_txx9_port *up, int quot)
  218. {
  219. quot >>= 1;
  220. if (quot < 256)
  221. sio_out(up, TXX9_SIBGR, quot | TXX9_SIBGR_BCLK_T0);
  222. else if (quot < (256 << 2))
  223. sio_out(up, TXX9_SIBGR, (quot >> 2) | TXX9_SIBGR_BCLK_T2);
  224. else if (quot < (256 << 4))
  225. sio_out(up, TXX9_SIBGR, (quot >> 4) | TXX9_SIBGR_BCLK_T4);
  226. else if (quot < (256 << 6))
  227. sio_out(up, TXX9_SIBGR, (quot >> 6) | TXX9_SIBGR_BCLK_T6);
  228. else
  229. sio_out(up, TXX9_SIBGR, 0xff | TXX9_SIBGR_BCLK_T6);
  230. }
  231. static void serial_txx9_stop_tx(struct uart_port *port, unsigned int tty_stop)
  232. {
  233. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  234. unsigned long flags;
  235. spin_lock_irqsave(&up->port.lock, flags);
  236. sio_mask(up, TXX9_SIDICR, TXX9_SIDICR_TIE);
  237. spin_unlock_irqrestore(&up->port.lock, flags);
  238. }
  239. static void serial_txx9_start_tx(struct uart_port *port, unsigned int tty_start)
  240. {
  241. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  242. unsigned long flags;
  243. spin_lock_irqsave(&up->port.lock, flags);
  244. sio_set(up, TXX9_SIDICR, TXX9_SIDICR_TIE);
  245. spin_unlock_irqrestore(&up->port.lock, flags);
  246. }
  247. static void serial_txx9_stop_rx(struct uart_port *port)
  248. {
  249. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  250. unsigned long flags;
  251. spin_lock_irqsave(&up->port.lock, flags);
  252. up->port.read_status_mask &= ~TXX9_SIDISR_RDIS;
  253. #if 0
  254. sio_mask(up, TXX9_SIDICR, TXX9_SIDICR_RIE);
  255. #endif
  256. spin_unlock_irqrestore(&up->port.lock, flags);
  257. }
  258. static void serial_txx9_enable_ms(struct uart_port *port)
  259. {
  260. /* TXX9-SIO can not control DTR... */
  261. }
  262. static inline void
  263. receive_chars(struct uart_txx9_port *up, unsigned int *status, struct pt_regs *regs)
  264. {
  265. struct tty_struct *tty = up->port.info->tty;
  266. unsigned char ch;
  267. unsigned int disr = *status;
  268. int max_count = 256;
  269. char flag;
  270. do {
  271. /* The following is not allowed by the tty layer and
  272. unsafe. It should be fixed ASAP */
  273. if (unlikely(tty->flip.count >= TTY_FLIPBUF_SIZE)) {
  274. if(tty->low_latency)
  275. tty_flip_buffer_push(tty);
  276. /* If this failed then we will throw away the
  277. bytes but must do so to clear interrupts */
  278. }
  279. ch = sio_in(up, TXX9_SIRFIFO);
  280. flag = TTY_NORMAL;
  281. up->port.icount.rx++;
  282. if (unlikely(disr & (TXX9_SIDISR_UBRK | TXX9_SIDISR_UPER |
  283. TXX9_SIDISR_UFER | TXX9_SIDISR_UOER))) {
  284. /*
  285. * For statistics only
  286. */
  287. if (disr & TXX9_SIDISR_UBRK) {
  288. disr &= ~(TXX9_SIDISR_UFER | TXX9_SIDISR_UPER);
  289. up->port.icount.brk++;
  290. /*
  291. * We do the SysRQ and SAK checking
  292. * here because otherwise the break
  293. * may get masked by ignore_status_mask
  294. * or read_status_mask.
  295. */
  296. if (uart_handle_break(&up->port))
  297. goto ignore_char;
  298. } else if (disr & TXX9_SIDISR_UPER)
  299. up->port.icount.parity++;
  300. else if (disr & TXX9_SIDISR_UFER)
  301. up->port.icount.frame++;
  302. if (disr & TXX9_SIDISR_UOER)
  303. up->port.icount.overrun++;
  304. /*
  305. * Mask off conditions which should be ingored.
  306. */
  307. disr &= up->port.read_status_mask;
  308. if (disr & TXX9_SIDISR_UBRK) {
  309. flag = TTY_BREAK;
  310. } else if (disr & TXX9_SIDISR_UPER)
  311. flag = TTY_PARITY;
  312. else if (disr & TXX9_SIDISR_UFER)
  313. flag = TTY_FRAME;
  314. }
  315. if (uart_handle_sysrq_char(&up->port, ch, regs))
  316. goto ignore_char;
  317. uart_insert_char(&up->port, disr, TXX9_SIDISR_UOER, ch, flag);
  318. ignore_char:
  319. disr = sio_in(up, TXX9_SIDISR);
  320. } while (!(disr & TXX9_SIDISR_UVALID) && (max_count-- > 0));
  321. tty_flip_buffer_push(tty);
  322. *status = disr;
  323. }
  324. static inline void transmit_chars(struct uart_txx9_port *up)
  325. {
  326. struct circ_buf *xmit = &up->port.info->xmit;
  327. int count;
  328. if (up->port.x_char) {
  329. sio_out(up, TXX9_SITFIFO, up->port.x_char);
  330. up->port.icount.tx++;
  331. up->port.x_char = 0;
  332. return;
  333. }
  334. if (uart_circ_empty(xmit) || uart_tx_stopped(&up->port)) {
  335. serial_txx9_stop_tx(&up->port, 0);
  336. return;
  337. }
  338. count = TXX9_SIO_TX_FIFO;
  339. do {
  340. sio_out(up, TXX9_SITFIFO, xmit->buf[xmit->tail]);
  341. xmit->tail = (xmit->tail + 1) & (UART_XMIT_SIZE - 1);
  342. up->port.icount.tx++;
  343. if (uart_circ_empty(xmit))
  344. break;
  345. } while (--count > 0);
  346. if (uart_circ_chars_pending(xmit) < WAKEUP_CHARS)
  347. uart_write_wakeup(&up->port);
  348. if (uart_circ_empty(xmit))
  349. serial_txx9_stop_tx(&up->port, 0);
  350. }
  351. static irqreturn_t serial_txx9_interrupt(int irq, void *dev_id, struct pt_regs *regs)
  352. {
  353. int pass_counter = 0;
  354. struct uart_txx9_port *up = dev_id;
  355. unsigned int status;
  356. while (1) {
  357. spin_lock(&up->port.lock);
  358. status = sio_in(up, TXX9_SIDISR);
  359. if (!(sio_in(up, TXX9_SIDICR) & TXX9_SIDICR_TIE))
  360. status &= ~TXX9_SIDISR_TDIS;
  361. if (!(status & (TXX9_SIDISR_TDIS | TXX9_SIDISR_RDIS |
  362. TXX9_SIDISR_TOUT))) {
  363. spin_unlock(&up->port.lock);
  364. break;
  365. }
  366. if (status & TXX9_SIDISR_RDIS)
  367. receive_chars(up, &status, regs);
  368. if (status & TXX9_SIDISR_TDIS)
  369. transmit_chars(up);
  370. /* Clear TX/RX Int. Status */
  371. sio_mask(up, TXX9_SIDISR,
  372. TXX9_SIDISR_TDIS | TXX9_SIDISR_RDIS |
  373. TXX9_SIDISR_TOUT);
  374. spin_unlock(&up->port.lock);
  375. if (pass_counter++ > PASS_LIMIT)
  376. break;
  377. }
  378. return pass_counter ? IRQ_HANDLED : IRQ_NONE;
  379. }
  380. static unsigned int serial_txx9_tx_empty(struct uart_port *port)
  381. {
  382. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  383. unsigned long flags;
  384. unsigned int ret;
  385. spin_lock_irqsave(&up->port.lock, flags);
  386. ret = (sio_in(up, TXX9_SICISR) & TXX9_SICISR_TXALS) ? TIOCSER_TEMT : 0;
  387. spin_unlock_irqrestore(&up->port.lock, flags);
  388. return ret;
  389. }
  390. static unsigned int serial_txx9_get_mctrl(struct uart_port *port)
  391. {
  392. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  393. unsigned int ret;
  394. ret = ((sio_in(up, TXX9_SIFLCR) & TXX9_SIFLCR_RTSSC) ? 0 : TIOCM_RTS)
  395. | ((sio_in(up, TXX9_SICISR) & TXX9_SICISR_CTSS) ? 0 : TIOCM_CTS);
  396. return ret;
  397. }
  398. static void serial_txx9_set_mctrl(struct uart_port *port, unsigned int mctrl)
  399. {
  400. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  401. unsigned long flags;
  402. spin_lock_irqsave(&up->port.lock, flags);
  403. if (mctrl & TIOCM_RTS)
  404. sio_mask(up, TXX9_SIFLCR, TXX9_SIFLCR_RTSSC);
  405. else
  406. sio_set(up, TXX9_SIFLCR, TXX9_SIFLCR_RTSSC);
  407. spin_unlock_irqrestore(&up->port.lock, flags);
  408. }
  409. static void serial_txx9_break_ctl(struct uart_port *port, int break_state)
  410. {
  411. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  412. unsigned long flags;
  413. spin_lock_irqsave(&up->port.lock, flags);
  414. if (break_state == -1)
  415. sio_set(up, TXX9_SIFLCR, TXX9_SIFLCR_TBRK);
  416. else
  417. sio_mask(up, TXX9_SIFLCR, TXX9_SIFLCR_TBRK);
  418. spin_unlock_irqrestore(&up->port.lock, flags);
  419. }
  420. static int serial_txx9_startup(struct uart_port *port)
  421. {
  422. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  423. unsigned long flags;
  424. int retval;
  425. /*
  426. * Clear the FIFO buffers and disable them.
  427. * (they will be reeanbled in set_termios())
  428. */
  429. sio_set(up, TXX9_SIFCR,
  430. TXX9_SIFCR_TFRST | TXX9_SIFCR_RFRST | TXX9_SIFCR_FRSTE);
  431. /* clear reset */
  432. sio_mask(up, TXX9_SIFCR,
  433. TXX9_SIFCR_TFRST | TXX9_SIFCR_RFRST | TXX9_SIFCR_FRSTE);
  434. sio_out(up, TXX9_SIDICR, 0);
  435. /*
  436. * Clear the interrupt registers.
  437. */
  438. sio_out(up, TXX9_SIDISR, 0);
  439. retval = request_irq(up->port.irq, serial_txx9_interrupt,
  440. SA_SHIRQ, "serial_txx9", up);
  441. if (retval)
  442. return retval;
  443. /*
  444. * Now, initialize the UART
  445. */
  446. spin_lock_irqsave(&up->port.lock, flags);
  447. serial_txx9_set_mctrl(&up->port, up->port.mctrl);
  448. spin_unlock_irqrestore(&up->port.lock, flags);
  449. /* Enable RX/TX */
  450. sio_mask(up, TXX9_SIFLCR, TXX9_SIFLCR_RSDE | TXX9_SIFLCR_TSDE);
  451. /*
  452. * Finally, enable interrupts.
  453. */
  454. sio_set(up, TXX9_SIDICR, TXX9_SIDICR_RIE);
  455. return 0;
  456. }
  457. static void serial_txx9_shutdown(struct uart_port *port)
  458. {
  459. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  460. unsigned long flags;
  461. /*
  462. * Disable interrupts from this port
  463. */
  464. sio_out(up, TXX9_SIDICR, 0); /* disable all intrs */
  465. spin_lock_irqsave(&up->port.lock, flags);
  466. serial_txx9_set_mctrl(&up->port, up->port.mctrl);
  467. spin_unlock_irqrestore(&up->port.lock, flags);
  468. /*
  469. * Disable break condition
  470. */
  471. sio_mask(up, TXX9_SIFLCR, TXX9_SIFLCR_TBRK);
  472. #ifdef CONFIG_SERIAL_TXX9_CONSOLE
  473. if (up->port.cons && up->port.line == up->port.cons->index) {
  474. free_irq(up->port.irq, up);
  475. return;
  476. }
  477. #endif
  478. /* reset FIFOs */
  479. sio_set(up, TXX9_SIFCR,
  480. TXX9_SIFCR_TFRST | TXX9_SIFCR_RFRST | TXX9_SIFCR_FRSTE);
  481. /* clear reset */
  482. sio_mask(up, TXX9_SIFCR,
  483. TXX9_SIFCR_TFRST | TXX9_SIFCR_RFRST | TXX9_SIFCR_FRSTE);
  484. /* Disable RX/TX */
  485. sio_set(up, TXX9_SIFLCR, TXX9_SIFLCR_RSDE | TXX9_SIFLCR_TSDE);
  486. free_irq(up->port.irq, up);
  487. }
  488. static void
  489. serial_txx9_set_termios(struct uart_port *port, struct termios *termios,
  490. struct termios *old)
  491. {
  492. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  493. unsigned int cval, fcr = 0;
  494. unsigned long flags;
  495. unsigned int baud, quot;
  496. cval = sio_in(up, TXX9_SILCR);
  497. /* byte size and parity */
  498. cval &= ~TXX9_SILCR_UMODE_MASK;
  499. switch (termios->c_cflag & CSIZE) {
  500. case CS7:
  501. cval |= TXX9_SILCR_UMODE_7BIT;
  502. break;
  503. default:
  504. case CS5: /* not supported */
  505. case CS6: /* not supported */
  506. case CS8:
  507. cval |= TXX9_SILCR_UMODE_8BIT;
  508. break;
  509. }
  510. cval &= ~TXX9_SILCR_USBL_MASK;
  511. if (termios->c_cflag & CSTOPB)
  512. cval |= TXX9_SILCR_USBL_2BIT;
  513. else
  514. cval |= TXX9_SILCR_USBL_1BIT;
  515. cval &= ~(TXX9_SILCR_UPEN | TXX9_SILCR_UEPS);
  516. if (termios->c_cflag & PARENB)
  517. cval |= TXX9_SILCR_UPEN;
  518. if (!(termios->c_cflag & PARODD))
  519. cval |= TXX9_SILCR_UEPS;
  520. /*
  521. * Ask the core to calculate the divisor for us.
  522. */
  523. baud = uart_get_baud_rate(port, termios, old, 0, port->uartclk/16/2);
  524. quot = uart_get_divisor(port, baud);
  525. /* Set up FIFOs */
  526. /* TX Int by FIFO Empty, RX Int by Receiving 1 char. */
  527. fcr = TXX9_SIFCR_TDIL_MAX | TXX9_SIFCR_RDIL_1;
  528. /*
  529. * Ok, we're now changing the port state. Do it with
  530. * interrupts disabled.
  531. */
  532. spin_lock_irqsave(&up->port.lock, flags);
  533. /*
  534. * Update the per-port timeout.
  535. */
  536. uart_update_timeout(port, termios->c_cflag, baud);
  537. up->port.read_status_mask = TXX9_SIDISR_UOER |
  538. TXX9_SIDISR_TDIS | TXX9_SIDISR_RDIS;
  539. if (termios->c_iflag & INPCK)
  540. up->port.read_status_mask |= TXX9_SIDISR_UFER | TXX9_SIDISR_UPER;
  541. if (termios->c_iflag & (BRKINT | PARMRK))
  542. up->port.read_status_mask |= TXX9_SIDISR_UBRK;
  543. /*
  544. * Characteres to ignore
  545. */
  546. up->port.ignore_status_mask = 0;
  547. if (termios->c_iflag & IGNPAR)
  548. up->port.ignore_status_mask |= TXX9_SIDISR_UPER | TXX9_SIDISR_UFER;
  549. if (termios->c_iflag & IGNBRK) {
  550. up->port.ignore_status_mask |= TXX9_SIDISR_UBRK;
  551. /*
  552. * If we're ignoring parity and break indicators,
  553. * ignore overruns too (for real raw support).
  554. */
  555. if (termios->c_iflag & IGNPAR)
  556. up->port.ignore_status_mask |= TXX9_SIDISR_UOER;
  557. }
  558. /*
  559. * ignore all characters if CREAD is not set
  560. */
  561. if ((termios->c_cflag & CREAD) == 0)
  562. up->port.ignore_status_mask |= TXX9_SIDISR_RDIS;
  563. /* CTS flow control flag */
  564. if ((termios->c_cflag & CRTSCTS) &&
  565. (up->port.flags & UPF_TXX9_HAVE_CTS_LINE)) {
  566. sio_set(up, TXX9_SIFLCR,
  567. TXX9_SIFLCR_RCS | TXX9_SIFLCR_TES);
  568. } else {
  569. sio_mask(up, TXX9_SIFLCR,
  570. TXX9_SIFLCR_RCS | TXX9_SIFLCR_TES);
  571. }
  572. sio_out(up, TXX9_SILCR, cval);
  573. sio_quot_set(up, quot);
  574. sio_out(up, TXX9_SIFCR, fcr);
  575. serial_txx9_set_mctrl(&up->port, up->port.mctrl);
  576. spin_unlock_irqrestore(&up->port.lock, flags);
  577. }
  578. static void
  579. serial_txx9_pm(struct uart_port *port, unsigned int state,
  580. unsigned int oldstate)
  581. {
  582. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  583. if (state) {
  584. /* sleep */
  585. if (up->pm)
  586. up->pm(port, state, oldstate);
  587. } else {
  588. /* wake */
  589. if (up->pm)
  590. up->pm(port, state, oldstate);
  591. }
  592. }
  593. static int serial_txx9_request_resource(struct uart_txx9_port *up)
  594. {
  595. unsigned int size = TXX9_REGION_SIZE;
  596. int ret = 0;
  597. switch (up->port.iotype) {
  598. default:
  599. if (!up->port.mapbase)
  600. break;
  601. if (!request_mem_region(up->port.mapbase, size, "serial_txx9")) {
  602. ret = -EBUSY;
  603. break;
  604. }
  605. if (up->port.flags & UPF_IOREMAP) {
  606. up->port.membase = ioremap(up->port.mapbase, size);
  607. if (!up->port.membase) {
  608. release_mem_region(up->port.mapbase, size);
  609. ret = -ENOMEM;
  610. }
  611. }
  612. break;
  613. case UPIO_PORT:
  614. if (!request_region(up->port.iobase, size, "serial_txx9"))
  615. ret = -EBUSY;
  616. break;
  617. }
  618. return ret;
  619. }
  620. static void serial_txx9_release_resource(struct uart_txx9_port *up)
  621. {
  622. unsigned int size = TXX9_REGION_SIZE;
  623. switch (up->port.iotype) {
  624. default:
  625. if (!up->port.mapbase)
  626. break;
  627. if (up->port.flags & UPF_IOREMAP) {
  628. iounmap(up->port.membase);
  629. up->port.membase = NULL;
  630. }
  631. release_mem_region(up->port.mapbase, size);
  632. break;
  633. case UPIO_PORT:
  634. release_region(up->port.iobase, size);
  635. break;
  636. }
  637. }
  638. static void serial_txx9_release_port(struct uart_port *port)
  639. {
  640. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  641. serial_txx9_release_resource(up);
  642. }
  643. static int serial_txx9_request_port(struct uart_port *port)
  644. {
  645. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  646. return serial_txx9_request_resource(up);
  647. }
  648. static void serial_txx9_config_port(struct uart_port *port, int uflags)
  649. {
  650. struct uart_txx9_port *up = (struct uart_txx9_port *)port;
  651. unsigned long flags;
  652. int ret;
  653. /*
  654. * Find the region that we can probe for. This in turn
  655. * tells us whether we can probe for the type of port.
  656. */
  657. ret = serial_txx9_request_resource(up);
  658. if (ret < 0)
  659. return;
  660. port->type = PORT_TXX9;
  661. up->port.fifosize = TXX9_SIO_TX_FIFO;
  662. #ifdef CONFIG_SERIAL_TXX9_CONSOLE
  663. if (up->port.line == up->port.cons->index)
  664. return;
  665. #endif
  666. spin_lock_irqsave(&up->port.lock, flags);
  667. /*
  668. * Reset the UART.
  669. */
  670. sio_out(up, TXX9_SIFCR, TXX9_SIFCR_SWRST);
  671. #ifdef CONFIG_CPU_TX49XX
  672. /* TX4925 BUG WORKAROUND. Accessing SIOC register
  673. * immediately after soft reset causes bus error. */
  674. iob();
  675. udelay(1);
  676. #endif
  677. while (sio_in(up, TXX9_SIFCR) & TXX9_SIFCR_SWRST)
  678. ;
  679. /* TX Int by FIFO Empty, RX Int by Receiving 1 char. */
  680. sio_set(up, TXX9_SIFCR,
  681. TXX9_SIFCR_TDIL_MAX | TXX9_SIFCR_RDIL_1);
  682. /* initial settings */
  683. sio_out(up, TXX9_SILCR,
  684. TXX9_SILCR_UMODE_8BIT | TXX9_SILCR_USBL_1BIT |
  685. ((up->port.flags & UPF_TXX9_USE_SCLK) ?
  686. TXX9_SILCR_SCS_SCLK_BG : TXX9_SILCR_SCS_IMCLK_BG));
  687. sio_quot_set(up, uart_get_divisor(port, 9600));
  688. sio_out(up, TXX9_SIFLCR, TXX9_SIFLCR_RTSTL_MAX /* 15 */);
  689. spin_unlock_irqrestore(&up->port.lock, flags);
  690. }
  691. static int
  692. serial_txx9_verify_port(struct uart_port *port, struct serial_struct *ser)
  693. {
  694. if (ser->irq < 0 ||
  695. ser->baud_base < 9600 || ser->type != PORT_TXX9)
  696. return -EINVAL;
  697. return 0;
  698. }
  699. static const char *
  700. serial_txx9_type(struct uart_port *port)
  701. {
  702. return "txx9";
  703. }
  704. static struct uart_ops serial_txx9_pops = {
  705. .tx_empty = serial_txx9_tx_empty,
  706. .set_mctrl = serial_txx9_set_mctrl,
  707. .get_mctrl = serial_txx9_get_mctrl,
  708. .stop_tx = serial_txx9_stop_tx,
  709. .start_tx = serial_txx9_start_tx,
  710. .stop_rx = serial_txx9_stop_rx,
  711. .enable_ms = serial_txx9_enable_ms,
  712. .break_ctl = serial_txx9_break_ctl,
  713. .startup = serial_txx9_startup,
  714. .shutdown = serial_txx9_shutdown,
  715. .set_termios = serial_txx9_set_termios,
  716. .pm = serial_txx9_pm,
  717. .type = serial_txx9_type,
  718. .release_port = serial_txx9_release_port,
  719. .request_port = serial_txx9_request_port,
  720. .config_port = serial_txx9_config_port,
  721. .verify_port = serial_txx9_verify_port,
  722. };
  723. static struct uart_txx9_port serial_txx9_ports[UART_NR];
  724. static void __init serial_txx9_register_ports(struct uart_driver *drv)
  725. {
  726. int i;
  727. for (i = 0; i < UART_NR; i++) {
  728. struct uart_txx9_port *up = &serial_txx9_ports[i];
  729. up->port.line = i;
  730. up->port.ops = &serial_txx9_pops;
  731. uart_add_one_port(drv, &up->port);
  732. }
  733. }
  734. #ifdef CONFIG_SERIAL_TXX9_CONSOLE
  735. /*
  736. * Wait for transmitter & holding register to empty
  737. */
  738. static inline void wait_for_xmitr(struct uart_txx9_port *up)
  739. {
  740. unsigned int tmout = 10000;
  741. /* Wait up to 10ms for the character(s) to be sent. */
  742. while (--tmout &&
  743. !(sio_in(up, TXX9_SICISR) & TXX9_SICISR_TXALS))
  744. udelay(1);
  745. /* Wait up to 1s for flow control if necessary */
  746. if (up->port.flags & UPF_CONS_FLOW) {
  747. tmout = 1000000;
  748. while (--tmout &&
  749. (sio_in(up, TXX9_SICISR) & TXX9_SICISR_CTSS))
  750. udelay(1);
  751. }
  752. }
  753. /*
  754. * Print a string to the serial port trying not to disturb
  755. * any possible real use of the port...
  756. *
  757. * The console_lock must be held when we get here.
  758. */
  759. static void
  760. serial_txx9_console_write(struct console *co, const char *s, unsigned int count)
  761. {
  762. struct uart_txx9_port *up = &serial_txx9_ports[co->index];
  763. unsigned int ier, flcr;
  764. int i;
  765. /*
  766. * First save the UER then disable the interrupts
  767. */
  768. ier = sio_in(up, TXX9_SIDICR);
  769. sio_out(up, TXX9_SIDICR, 0);
  770. /*
  771. * Disable flow-control if enabled (and unnecessary)
  772. */
  773. flcr = sio_in(up, TXX9_SIFLCR);
  774. if (!(up->port.flags & UPF_CONS_FLOW) && (flcr & TXX9_SIFLCR_TES))
  775. sio_out(up, TXX9_SIFLCR, flcr & ~TXX9_SIFLCR_TES);
  776. /*
  777. * Now, do each character
  778. */
  779. for (i = 0; i < count; i++, s++) {
  780. wait_for_xmitr(up);
  781. /*
  782. * Send the character out.
  783. * If a LF, also do CR...
  784. */
  785. sio_out(up, TXX9_SITFIFO, *s);
  786. if (*s == 10) {
  787. wait_for_xmitr(up);
  788. sio_out(up, TXX9_SITFIFO, 13);
  789. }
  790. }
  791. /*
  792. * Finally, wait for transmitter to become empty
  793. * and restore the IER
  794. */
  795. wait_for_xmitr(up);
  796. sio_out(up, TXX9_SIFLCR, flcr);
  797. sio_out(up, TXX9_SIDICR, ier);
  798. }
  799. static int serial_txx9_console_setup(struct console *co, char *options)
  800. {
  801. struct uart_port *port;
  802. struct uart_txx9_port *up;
  803. int baud = 9600;
  804. int bits = 8;
  805. int parity = 'n';
  806. int flow = 'n';
  807. /*
  808. * Check whether an invalid uart number has been specified, and
  809. * if so, search for the first available port that does have
  810. * console support.
  811. */
  812. if (co->index >= UART_NR)
  813. co->index = 0;
  814. up = &serial_txx9_ports[co->index];
  815. port = &up->port;
  816. if (!port->ops)
  817. return -ENODEV;
  818. /*
  819. * Temporary fix.
  820. */
  821. spin_lock_init(&port->lock);
  822. /*
  823. * Disable UART interrupts, set DTR and RTS high
  824. * and set speed.
  825. */
  826. sio_out(up, TXX9_SIDICR, 0);
  827. /* initial settings */
  828. sio_out(up, TXX9_SILCR,
  829. TXX9_SILCR_UMODE_8BIT | TXX9_SILCR_USBL_1BIT |
  830. ((port->flags & UPF_TXX9_USE_SCLK) ?
  831. TXX9_SILCR_SCS_SCLK_BG : TXX9_SILCR_SCS_IMCLK_BG));
  832. sio_out(up, TXX9_SIFLCR, TXX9_SIFLCR_RTSTL_MAX /* 15 */);
  833. if (options)
  834. uart_parse_options(options, &baud, &parity, &bits, &flow);
  835. return uart_set_options(port, co, baud, parity, bits, flow);
  836. }
  837. static struct uart_driver serial_txx9_reg;
  838. static struct console serial_txx9_console = {
  839. .name = TXX9_TTY_NAME,
  840. .write = serial_txx9_console_write,
  841. .device = uart_console_device,
  842. .setup = serial_txx9_console_setup,
  843. .flags = CON_PRINTBUFFER,
  844. .index = -1,
  845. .data = &serial_txx9_reg,
  846. };
  847. static int __init serial_txx9_console_init(void)
  848. {
  849. register_console(&serial_txx9_console);
  850. return 0;
  851. }
  852. console_initcall(serial_txx9_console_init);
  853. static int __init serial_txx9_late_console_init(void)
  854. {
  855. if (!(serial_txx9_console.flags & CON_ENABLED))
  856. register_console(&serial_txx9_console);
  857. return 0;
  858. }
  859. late_initcall(serial_txx9_late_console_init);
  860. #define SERIAL_TXX9_CONSOLE &serial_txx9_console
  861. #else
  862. #define SERIAL_TXX9_CONSOLE NULL
  863. #endif
  864. static struct uart_driver serial_txx9_reg = {
  865. .owner = THIS_MODULE,
  866. .driver_name = "serial_txx9",
  867. .devfs_name = TXX9_TTY_DEVFS_NAME,
  868. .dev_name = TXX9_TTY_NAME,
  869. .major = TXX9_TTY_MAJOR,
  870. .minor = TXX9_TTY_MINOR_START,
  871. .nr = UART_NR,
  872. .cons = SERIAL_TXX9_CONSOLE,
  873. };
  874. int __init early_serial_txx9_setup(struct uart_port *port)
  875. {
  876. if (port->line >= ARRAY_SIZE(serial_txx9_ports))
  877. return -ENODEV;
  878. serial_txx9_ports[port->line].port = *port;
  879. serial_txx9_ports[port->line].port.ops = &serial_txx9_pops;
  880. serial_txx9_ports[port->line].port.flags |= UPF_BOOT_AUTOCONF;
  881. return 0;
  882. }
  883. #ifdef ENABLE_SERIAL_TXX9_PCI
  884. /**
  885. * serial_txx9_suspend_port - suspend one serial port
  886. * @line: serial line number
  887. * @level: the level of port suspension, as per uart_suspend_port
  888. *
  889. * Suspend one serial port.
  890. */
  891. static void serial_txx9_suspend_port(int line)
  892. {
  893. uart_suspend_port(&serial_txx9_reg, &serial_txx9_ports[line].port);
  894. }
  895. /**
  896. * serial_txx9_resume_port - resume one serial port
  897. * @line: serial line number
  898. * @level: the level of port resumption, as per uart_resume_port
  899. *
  900. * Resume one serial port.
  901. */
  902. static void serial_txx9_resume_port(int line)
  903. {
  904. uart_resume_port(&serial_txx9_reg, &serial_txx9_ports[line].port);
  905. }
  906. /*
  907. * Probe one serial board. Unfortunately, there is no rhyme nor reason
  908. * to the arrangement of serial ports on a PCI card.
  909. */
  910. static int __devinit
  911. pciserial_txx9_init_one(struct pci_dev *dev, const struct pci_device_id *ent)
  912. {
  913. struct uart_port port;
  914. int line;
  915. int rc;
  916. rc = pci_enable_device(dev);
  917. if (rc)
  918. return rc;
  919. memset(&port, 0, sizeof(port));
  920. port.ops = &serial_txx9_pops;
  921. port.flags |= UPF_BOOT_AUTOCONF; /* uart_ops.config_port will be called */
  922. port.flags |= UPF_TXX9_HAVE_CTS_LINE;
  923. port.uartclk = 66670000;
  924. port.irq = dev->irq;
  925. port.iotype = UPIO_PORT;
  926. port.iobase = pci_resource_start(dev, 1);
  927. line = uart_register_port(&serial_txx9_reg, &port);
  928. if (line < 0) {
  929. printk(KERN_WARNING "Couldn't register serial port %s: %d\n", pci_name(dev), line);
  930. }
  931. pci_set_drvdata(dev, (void *)(long)line);
  932. return 0;
  933. }
  934. static void __devexit pciserial_txx9_remove_one(struct pci_dev *dev)
  935. {
  936. int line = (int)(long)pci_get_drvdata(dev);
  937. pci_set_drvdata(dev, NULL);
  938. if (line) {
  939. uart_unregister_port(&serial_txx9_reg, line);
  940. pci_disable_device(dev);
  941. }
  942. }
  943. static int pciserial_txx9_suspend_one(struct pci_dev *dev, pm_message_t state)
  944. {
  945. int line = (int)(long)pci_get_drvdata(dev);
  946. if (line)
  947. serial_txx9_suspend_port(line);
  948. return 0;
  949. }
  950. static int pciserial_txx9_resume_one(struct pci_dev *dev)
  951. {
  952. int line = (int)(long)pci_get_drvdata(dev);
  953. if (line)
  954. serial_txx9_resume_port(line);
  955. return 0;
  956. }
  957. static struct pci_device_id serial_txx9_pci_tbl[] = {
  958. { PCI_VENDOR_ID_TOSHIBA_2, PCI_DEVICE_ID_TOSHIBA_TC86C001_MISC,
  959. PCI_ANY_ID, PCI_ANY_ID,
  960. 0, 0, 0 },
  961. { 0, }
  962. };
  963. static struct pci_driver serial_txx9_pci_driver = {
  964. .name = "serial_txx9",
  965. .probe = pciserial_txx9_init_one,
  966. .remove = __devexit_p(pciserial_txx9_remove_one),
  967. .suspend = pciserial_txx9_suspend_one,
  968. .resume = pciserial_txx9_resume_one,
  969. .id_table = serial_txx9_pci_tbl,
  970. };
  971. MODULE_DEVICE_TABLE(pci, serial_txx9_pci_tbl);
  972. #endif /* ENABLE_SERIAL_TXX9_PCI */
  973. static int __init serial_txx9_init(void)
  974. {
  975. int ret;
  976. printk(KERN_INFO "%s version %s\n", serial_name, serial_version);
  977. ret = uart_register_driver(&serial_txx9_reg);
  978. if (ret >= 0) {
  979. serial_txx9_register_ports(&serial_txx9_reg);
  980. #ifdef ENABLE_SERIAL_TXX9_PCI
  981. ret = pci_module_init(&serial_txx9_pci_driver);
  982. #endif
  983. }
  984. return ret;
  985. }
  986. static void __exit serial_txx9_exit(void)
  987. {
  988. int i;
  989. #ifdef ENABLE_SERIAL_TXX9_PCI
  990. pci_unregister_driver(&serial_txx9_pci_driver);
  991. #endif
  992. for (i = 0; i < UART_NR; i++)
  993. uart_remove_one_port(&serial_txx9_reg, &serial_txx9_ports[i].port);
  994. uart_unregister_driver(&serial_txx9_reg);
  995. }
  996. module_init(serial_txx9_init);
  997. module_exit(serial_txx9_exit);
  998. MODULE_LICENSE("GPL");
  999. MODULE_DESCRIPTION("TX39/49 serial driver");
  1000. MODULE_ALIAS_CHARDEV_MAJOR(TXX9_TTY_MAJOR);