Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

at b1404069f64457c94de241738fdca142c2e5698f 2141 lines 54 kB view raw
1/* 2 * linux/drivers/char/amiserial.c 3 * 4 * Serial driver for the amiga builtin port. 5 * 6 * This code was created by taking serial.c version 4.30 from kernel 7 * release 2.3.22, replacing all hardware related stuff with the 8 * corresponding amiga hardware actions, and removing all irrelevant 9 * code. As a consequence, it uses many of the constants and names 10 * associated with the registers and bits of 16550 compatible UARTS - 11 * but only to keep track of status, etc in the state variables. It 12 * was done this was to make it easier to keep the code in line with 13 * (non hardware specific) changes to serial.c. 14 * 15 * The port is registered with the tty driver as minor device 64, and 16 * therefore other ports should should only use 65 upwards. 17 * 18 * Richard Lucock 28/12/99 19 * 20 * Copyright (C) 1991, 1992 Linus Torvalds 21 * Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 22 * 1998, 1999 Theodore Ts'o 23 * 24 */ 25 26/* 27 * Serial driver configuration section. Here are the various options: 28 * 29 * SERIAL_PARANOIA_CHECK 30 * Check the magic number for the async_structure where 31 * ever possible. 32 */ 33 34#include <linux/delay.h> 35 36#undef SERIAL_PARANOIA_CHECK 37#define SERIAL_DO_RESTART 38 39/* Set of debugging defines */ 40 41#undef SERIAL_DEBUG_INTR 42#undef SERIAL_DEBUG_OPEN 43#undef SERIAL_DEBUG_FLOW 44#undef SERIAL_DEBUG_RS_WAIT_UNTIL_SENT 45 46/* Sanity checks */ 47 48#if defined(MODULE) && defined(SERIAL_DEBUG_MCOUNT) 49#define DBG_CNT(s) printk("(%s): [%x] refc=%d, serc=%d, ttyc=%d -> %s\n", \ 50 tty->name, (info->flags), serial_driver->refcount,info->count,tty->count,s) 51#else 52#define DBG_CNT(s) 53#endif 54 55/* 56 * End of serial driver configuration section. 57 */ 58 59#include <linux/module.h> 60 61#include <linux/types.h> 62#include <linux/serial.h> 63#include <linux/serialP.h> 64#include <linux/serial_reg.h> 65static char *serial_version = "4.30"; 66 67#include <linux/errno.h> 68#include <linux/signal.h> 69#include <linux/sched.h> 70#include <linux/kernel.h> 71#include <linux/timer.h> 72#include <linux/interrupt.h> 73#include <linux/tty.h> 74#include <linux/tty_flip.h> 75#include <linux/console.h> 76#include <linux/major.h> 77#include <linux/string.h> 78#include <linux/fcntl.h> 79#include <linux/ptrace.h> 80#include <linux/ioport.h> 81#include <linux/mm.h> 82#include <linux/slab.h> 83#include <linux/init.h> 84#include <linux/bitops.h> 85 86#include <asm/setup.h> 87 88#include <asm/system.h> 89 90#include <asm/irq.h> 91 92#include <asm/amigahw.h> 93#include <asm/amigaints.h> 94 95#define custom amiga_custom 96static char *serial_name = "Amiga-builtin serial driver"; 97 98static struct tty_driver *serial_driver; 99 100/* number of characters left in xmit buffer before we ask for more */ 101#define WAKEUP_CHARS 256 102 103static struct async_struct *IRQ_ports; 104 105static unsigned char current_ctl_bits; 106 107static void change_speed(struct async_struct *info, struct ktermios *old); 108static void rs_wait_until_sent(struct tty_struct *tty, int timeout); 109 110 111static struct serial_state rs_table[1]; 112 113#define NR_PORTS ARRAY_SIZE(rs_table) 114 115#include <asm/uaccess.h> 116 117#define serial_isroot() (capable(CAP_SYS_ADMIN)) 118 119 120static inline int serial_paranoia_check(struct async_struct *info, 121 char *name, const char *routine) 122{ 123#ifdef SERIAL_PARANOIA_CHECK 124 static const char *badmagic = 125 "Warning: bad magic number for serial struct (%s) in %s\n"; 126 static const char *badinfo = 127 "Warning: null async_struct for (%s) in %s\n"; 128 129 if (!info) { 130 printk(badinfo, name, routine); 131 return 1; 132 } 133 if (info->magic != SERIAL_MAGIC) { 134 printk(badmagic, name, routine); 135 return 1; 136 } 137#endif 138 return 0; 139} 140 141/* some serial hardware definitions */ 142#define SDR_OVRUN (1<<15) 143#define SDR_RBF (1<<14) 144#define SDR_TBE (1<<13) 145#define SDR_TSRE (1<<12) 146 147#define SERPER_PARENB (1<<15) 148 149#define AC_SETCLR (1<<15) 150#define AC_UARTBRK (1<<11) 151 152#define SER_DTR (1<<7) 153#define SER_RTS (1<<6) 154#define SER_DCD (1<<5) 155#define SER_CTS (1<<4) 156#define SER_DSR (1<<3) 157 158static __inline__ void rtsdtr_ctrl(int bits) 159{ 160 ciab.pra = ((bits & (SER_RTS | SER_DTR)) ^ (SER_RTS | SER_DTR)) | (ciab.pra & ~(SER_RTS | SER_DTR)); 161} 162 163/* 164 * ------------------------------------------------------------ 165 * rs_stop() and rs_start() 166 * 167 * This routines are called before setting or resetting tty->stopped. 168 * They enable or disable transmitter interrupts, as necessary. 169 * ------------------------------------------------------------ 170 */ 171static void rs_stop(struct tty_struct *tty) 172{ 173 struct async_struct *info = (struct async_struct *)tty->driver_data; 174 unsigned long flags; 175 176 if (serial_paranoia_check(info, tty->name, "rs_stop")) 177 return; 178 179 local_irq_save(flags); 180 if (info->IER & UART_IER_THRI) { 181 info->IER &= ~UART_IER_THRI; 182 /* disable Tx interrupt and remove any pending interrupts */ 183 custom.intena = IF_TBE; 184 mb(); 185 custom.intreq = IF_TBE; 186 mb(); 187 } 188 local_irq_restore(flags); 189} 190 191static void rs_start(struct tty_struct *tty) 192{ 193 struct async_struct *info = (struct async_struct *)tty->driver_data; 194 unsigned long flags; 195 196 if (serial_paranoia_check(info, tty->name, "rs_start")) 197 return; 198 199 local_irq_save(flags); 200 if (info->xmit.head != info->xmit.tail 201 && info->xmit.buf 202 && !(info->IER & UART_IER_THRI)) { 203 info->IER |= UART_IER_THRI; 204 custom.intena = IF_SETCLR | IF_TBE; 205 mb(); 206 /* set a pending Tx Interrupt, transmitter should restart now */ 207 custom.intreq = IF_SETCLR | IF_TBE; 208 mb(); 209 } 210 local_irq_restore(flags); 211} 212 213/* 214 * ---------------------------------------------------------------------- 215 * 216 * Here starts the interrupt handling routines. All of the following 217 * subroutines are declared as inline and are folded into 218 * rs_interrupt(). They were separated out for readability's sake. 219 * 220 * Note: rs_interrupt() is a "fast" interrupt, which means that it 221 * runs with interrupts turned off. People who may want to modify 222 * rs_interrupt() should try to keep the interrupt handler as fast as 223 * possible. After you are done making modifications, it is not a bad 224 * idea to do: 225 * 226 * gcc -S -DKERNEL -Wall -Wstrict-prototypes -O6 -fomit-frame-pointer serial.c 227 * 228 * and look at the resulting assemble code in serial.s. 229 * 230 * - Ted Ts'o (tytso@mit.edu), 7-Mar-93 231 * ----------------------------------------------------------------------- 232 */ 233 234/* 235 * This routine is used by the interrupt handler to schedule 236 * processing in the software interrupt portion of the driver. 237 */ 238static void rs_sched_event(struct async_struct *info, 239 int event) 240{ 241 info->event |= 1 << event; 242 tasklet_schedule(&info->tlet); 243} 244 245static void receive_chars(struct async_struct *info) 246{ 247 int status; 248 int serdatr; 249 struct tty_struct *tty = info->tty; 250 unsigned char ch, flag; 251 struct async_icount *icount; 252 int oe = 0; 253 254 icount = &info->state->icount; 255 256 status = UART_LSR_DR; /* We obviously have a character! */ 257 serdatr = custom.serdatr; 258 mb(); 259 custom.intreq = IF_RBF; 260 mb(); 261 262 if((serdatr & 0x1ff) == 0) 263 status |= UART_LSR_BI; 264 if(serdatr & SDR_OVRUN) 265 status |= UART_LSR_OE; 266 267 ch = serdatr & 0xff; 268 icount->rx++; 269 270#ifdef SERIAL_DEBUG_INTR 271 printk("DR%02x:%02x...", ch, status); 272#endif 273 flag = TTY_NORMAL; 274 275 /* 276 * We don't handle parity or frame errors - but I have left 277 * the code in, since I'm not sure that the errors can't be 278 * detected. 279 */ 280 281 if (status & (UART_LSR_BI | UART_LSR_PE | 282 UART_LSR_FE | UART_LSR_OE)) { 283 /* 284 * For statistics only 285 */ 286 if (status & UART_LSR_BI) { 287 status &= ~(UART_LSR_FE | UART_LSR_PE); 288 icount->brk++; 289 } else if (status & UART_LSR_PE) 290 icount->parity++; 291 else if (status & UART_LSR_FE) 292 icount->frame++; 293 if (status & UART_LSR_OE) 294 icount->overrun++; 295 296 /* 297 * Now check to see if character should be 298 * ignored, and mask off conditions which 299 * should be ignored. 300 */ 301 if (status & info->ignore_status_mask) 302 goto out; 303 304 status &= info->read_status_mask; 305 306 if (status & (UART_LSR_BI)) { 307#ifdef SERIAL_DEBUG_INTR 308 printk("handling break...."); 309#endif 310 flag = TTY_BREAK; 311 if (info->flags & ASYNC_SAK) 312 do_SAK(tty); 313 } else if (status & UART_LSR_PE) 314 flag = TTY_PARITY; 315 else if (status & UART_LSR_FE) 316 flag = TTY_FRAME; 317 if (status & UART_LSR_OE) { 318 /* 319 * Overrun is special, since it's 320 * reported immediately, and doesn't 321 * affect the current character 322 */ 323 oe = 1; 324 } 325 } 326 tty_insert_flip_char(tty, ch, flag); 327 if (oe == 1) 328 tty_insert_flip_char(tty, 0, TTY_OVERRUN); 329 tty_flip_buffer_push(tty); 330out: 331 return; 332} 333 334static void transmit_chars(struct async_struct *info) 335{ 336 custom.intreq = IF_TBE; 337 mb(); 338 if (info->x_char) { 339 custom.serdat = info->x_char | 0x100; 340 mb(); 341 info->state->icount.tx++; 342 info->x_char = 0; 343 return; 344 } 345 if (info->xmit.head == info->xmit.tail 346 || info->tty->stopped 347 || info->tty->hw_stopped) { 348 info->IER &= ~UART_IER_THRI; 349 custom.intena = IF_TBE; 350 mb(); 351 return; 352 } 353 354 custom.serdat = info->xmit.buf[info->xmit.tail++] | 0x100; 355 mb(); 356 info->xmit.tail = info->xmit.tail & (SERIAL_XMIT_SIZE-1); 357 info->state->icount.tx++; 358 359 if (CIRC_CNT(info->xmit.head, 360 info->xmit.tail, 361 SERIAL_XMIT_SIZE) < WAKEUP_CHARS) 362 rs_sched_event(info, RS_EVENT_WRITE_WAKEUP); 363 364#ifdef SERIAL_DEBUG_INTR 365 printk("THRE..."); 366#endif 367 if (info->xmit.head == info->xmit.tail) { 368 custom.intena = IF_TBE; 369 mb(); 370 info->IER &= ~UART_IER_THRI; 371 } 372} 373 374static void check_modem_status(struct async_struct *info) 375{ 376 unsigned char status = ciab.pra & (SER_DCD | SER_CTS | SER_DSR); 377 unsigned char dstatus; 378 struct async_icount *icount; 379 380 /* Determine bits that have changed */ 381 dstatus = status ^ current_ctl_bits; 382 current_ctl_bits = status; 383 384 if (dstatus) { 385 icount = &info->state->icount; 386 /* update input line counters */ 387 if (dstatus & SER_DSR) 388 icount->dsr++; 389 if (dstatus & SER_DCD) { 390 icount->dcd++; 391#ifdef CONFIG_HARD_PPS 392 if ((info->flags & ASYNC_HARDPPS_CD) && 393 !(status & SER_DCD)) 394 hardpps(); 395#endif 396 } 397 if (dstatus & SER_CTS) 398 icount->cts++; 399 wake_up_interruptible(&info->delta_msr_wait); 400 } 401 402 if ((info->flags & ASYNC_CHECK_CD) && (dstatus & SER_DCD)) { 403#if (defined(SERIAL_DEBUG_OPEN) || defined(SERIAL_DEBUG_INTR)) 404 printk("ttyS%d CD now %s...", info->line, 405 (!(status & SER_DCD)) ? "on" : "off"); 406#endif 407 if (!(status & SER_DCD)) 408 wake_up_interruptible(&info->open_wait); 409 else { 410#ifdef SERIAL_DEBUG_OPEN 411 printk("doing serial hangup..."); 412#endif 413 if (info->tty) 414 tty_hangup(info->tty); 415 } 416 } 417 if (info->flags & ASYNC_CTS_FLOW) { 418 if (info->tty->hw_stopped) { 419 if (!(status & SER_CTS)) { 420#if (defined(SERIAL_DEBUG_INTR) || defined(SERIAL_DEBUG_FLOW)) 421 printk("CTS tx start..."); 422#endif 423 info->tty->hw_stopped = 0; 424 info->IER |= UART_IER_THRI; 425 custom.intena = IF_SETCLR | IF_TBE; 426 mb(); 427 /* set a pending Tx Interrupt, transmitter should restart now */ 428 custom.intreq = IF_SETCLR | IF_TBE; 429 mb(); 430 rs_sched_event(info, RS_EVENT_WRITE_WAKEUP); 431 return; 432 } 433 } else { 434 if ((status & SER_CTS)) { 435#if (defined(SERIAL_DEBUG_INTR) || defined(SERIAL_DEBUG_FLOW)) 436 printk("CTS tx stop..."); 437#endif 438 info->tty->hw_stopped = 1; 439 info->IER &= ~UART_IER_THRI; 440 /* disable Tx interrupt and remove any pending interrupts */ 441 custom.intena = IF_TBE; 442 mb(); 443 custom.intreq = IF_TBE; 444 mb(); 445 } 446 } 447 } 448} 449 450static irqreturn_t ser_vbl_int( int irq, void *data) 451{ 452 /* vbl is just a periodic interrupt we tie into to update modem status */ 453 struct async_struct * info = IRQ_ports; 454 /* 455 * TBD - is it better to unregister from this interrupt or to 456 * ignore it if MSI is clear ? 457 */ 458 if(info->IER & UART_IER_MSI) 459 check_modem_status(info); 460 return IRQ_HANDLED; 461} 462 463static irqreturn_t ser_rx_int(int irq, void *dev_id) 464{ 465 struct async_struct * info; 466 467#ifdef SERIAL_DEBUG_INTR 468 printk("ser_rx_int..."); 469#endif 470 471 info = IRQ_ports; 472 if (!info || !info->tty) 473 return IRQ_NONE; 474 475 receive_chars(info); 476 info->last_active = jiffies; 477#ifdef SERIAL_DEBUG_INTR 478 printk("end.\n"); 479#endif 480 return IRQ_HANDLED; 481} 482 483static irqreturn_t ser_tx_int(int irq, void *dev_id) 484{ 485 struct async_struct * info; 486 487 if (custom.serdatr & SDR_TBE) { 488#ifdef SERIAL_DEBUG_INTR 489 printk("ser_tx_int..."); 490#endif 491 492 info = IRQ_ports; 493 if (!info || !info->tty) 494 return IRQ_NONE; 495 496 transmit_chars(info); 497 info->last_active = jiffies; 498#ifdef SERIAL_DEBUG_INTR 499 printk("end.\n"); 500#endif 501 } 502 return IRQ_HANDLED; 503} 504 505/* 506 * ------------------------------------------------------------------- 507 * Here ends the serial interrupt routines. 508 * ------------------------------------------------------------------- 509 */ 510 511/* 512 * This routine is used to handle the "bottom half" processing for the 513 * serial driver, known also the "software interrupt" processing. 514 * This processing is done at the kernel interrupt level, after the 515 * rs_interrupt() has returned, BUT WITH INTERRUPTS TURNED ON. This 516 * is where time-consuming activities which can not be done in the 517 * interrupt driver proper are done; the interrupt driver schedules 518 * them using rs_sched_event(), and they get done here. 519 */ 520 521static void do_softint(unsigned long private_) 522{ 523 struct async_struct *info = (struct async_struct *) private_; 524 struct tty_struct *tty; 525 526 tty = info->tty; 527 if (!tty) 528 return; 529 530 if (test_and_clear_bit(RS_EVENT_WRITE_WAKEUP, &info->event)) 531 tty_wakeup(tty); 532} 533 534/* 535 * --------------------------------------------------------------- 536 * Low level utility subroutines for the serial driver: routines to 537 * figure out the appropriate timeout for an interrupt chain, routines 538 * to initialize and startup a serial port, and routines to shutdown a 539 * serial port. Useful stuff like that. 540 * --------------------------------------------------------------- 541 */ 542 543static int startup(struct async_struct * info) 544{ 545 unsigned long flags; 546 int retval=0; 547 unsigned long page; 548 549 page = get_zeroed_page(GFP_KERNEL); 550 if (!page) 551 return -ENOMEM; 552 553 local_irq_save(flags); 554 555 if (info->flags & ASYNC_INITIALIZED) { 556 free_page(page); 557 goto errout; 558 } 559 560 if (info->xmit.buf) 561 free_page(page); 562 else 563 info->xmit.buf = (unsigned char *) page; 564 565#ifdef SERIAL_DEBUG_OPEN 566 printk("starting up ttys%d ...", info->line); 567#endif 568 569 /* Clear anything in the input buffer */ 570 571 custom.intreq = IF_RBF; 572 mb(); 573 574 retval = request_irq(IRQ_AMIGA_VERTB, ser_vbl_int, 0, "serial status", info); 575 if (retval) { 576 if (serial_isroot()) { 577 if (info->tty) 578 set_bit(TTY_IO_ERROR, 579 &info->tty->flags); 580 retval = 0; 581 } 582 goto errout; 583 } 584 585 /* enable both Rx and Tx interrupts */ 586 custom.intena = IF_SETCLR | IF_RBF | IF_TBE; 587 mb(); 588 info->IER = UART_IER_MSI; 589 590 /* remember current state of the DCD and CTS bits */ 591 current_ctl_bits = ciab.pra & (SER_DCD | SER_CTS | SER_DSR); 592 593 IRQ_ports = info; 594 595 info->MCR = 0; 596 if (info->tty->termios->c_cflag & CBAUD) 597 info->MCR = SER_DTR | SER_RTS; 598 rtsdtr_ctrl(info->MCR); 599 600 if (info->tty) 601 clear_bit(TTY_IO_ERROR, &info->tty->flags); 602 info->xmit.head = info->xmit.tail = 0; 603 604 /* 605 * Set up the tty->alt_speed kludge 606 */ 607 if (info->tty) { 608 if ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_HI) 609 info->tty->alt_speed = 57600; 610 if ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_VHI) 611 info->tty->alt_speed = 115200; 612 if ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_SHI) 613 info->tty->alt_speed = 230400; 614 if ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_WARP) 615 info->tty->alt_speed = 460800; 616 } 617 618 /* 619 * and set the speed of the serial port 620 */ 621 change_speed(info, NULL); 622 623 info->flags |= ASYNC_INITIALIZED; 624 local_irq_restore(flags); 625 return 0; 626 627errout: 628 local_irq_restore(flags); 629 return retval; 630} 631 632/* 633 * This routine will shutdown a serial port; interrupts are disabled, and 634 * DTR is dropped if the hangup on close termio flag is on. 635 */ 636static void shutdown(struct async_struct * info) 637{ 638 unsigned long flags; 639 struct serial_state *state; 640 641 if (!(info->flags & ASYNC_INITIALIZED)) 642 return; 643 644 state = info->state; 645 646#ifdef SERIAL_DEBUG_OPEN 647 printk("Shutting down serial port %d ....\n", info->line); 648#endif 649 650 local_irq_save(flags); /* Disable interrupts */ 651 652 /* 653 * clear delta_msr_wait queue to avoid mem leaks: we may free the irq 654 * here so the queue might never be waken up 655 */ 656 wake_up_interruptible(&info->delta_msr_wait); 657 658 IRQ_ports = NULL; 659 660 /* 661 * Free the IRQ, if necessary 662 */ 663 free_irq(IRQ_AMIGA_VERTB, info); 664 665 if (info->xmit.buf) { 666 free_page((unsigned long) info->xmit.buf); 667 info->xmit.buf = NULL; 668 } 669 670 info->IER = 0; 671 custom.intena = IF_RBF | IF_TBE; 672 mb(); 673 674 /* disable break condition */ 675 custom.adkcon = AC_UARTBRK; 676 mb(); 677 678 if (!info->tty || (info->tty->termios->c_cflag & HUPCL)) 679 info->MCR &= ~(SER_DTR|SER_RTS); 680 rtsdtr_ctrl(info->MCR); 681 682 if (info->tty) 683 set_bit(TTY_IO_ERROR, &info->tty->flags); 684 685 info->flags &= ~ASYNC_INITIALIZED; 686 local_irq_restore(flags); 687} 688 689 690/* 691 * This routine is called to set the UART divisor registers to match 692 * the specified baud rate for a serial port. 693 */ 694static void change_speed(struct async_struct *info, 695 struct ktermios *old_termios) 696{ 697 int quot = 0, baud_base, baud; 698 unsigned cflag, cval = 0; 699 int bits; 700 unsigned long flags; 701 702 if (!info->tty || !info->tty->termios) 703 return; 704 cflag = info->tty->termios->c_cflag; 705 706 /* Byte size is always 8 bits plus parity bit if requested */ 707 708 cval = 3; bits = 10; 709 if (cflag & CSTOPB) { 710 cval |= 0x04; 711 bits++; 712 } 713 if (cflag & PARENB) { 714 cval |= UART_LCR_PARITY; 715 bits++; 716 } 717 if (!(cflag & PARODD)) 718 cval |= UART_LCR_EPAR; 719#ifdef CMSPAR 720 if (cflag & CMSPAR) 721 cval |= UART_LCR_SPAR; 722#endif 723 724 /* Determine divisor based on baud rate */ 725 baud = tty_get_baud_rate(info->tty); 726 if (!baud) 727 baud = 9600; /* B0 transition handled in rs_set_termios */ 728 baud_base = info->state->baud_base; 729 if (baud == 38400 && 730 ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_CUST)) 731 quot = info->state->custom_divisor; 732 else { 733 if (baud == 134) 734 /* Special case since 134 is really 134.5 */ 735 quot = (2*baud_base / 269); 736 else if (baud) 737 quot = baud_base / baud; 738 } 739 /* If the quotient is zero refuse the change */ 740 if (!quot && old_termios) { 741 /* FIXME: Will need updating for new tty in the end */ 742 info->tty->termios->c_cflag &= ~CBAUD; 743 info->tty->termios->c_cflag |= (old_termios->c_cflag & CBAUD); 744 baud = tty_get_baud_rate(info->tty); 745 if (!baud) 746 baud = 9600; 747 if (baud == 38400 && 748 ((info->flags & ASYNC_SPD_MASK) == ASYNC_SPD_CUST)) 749 quot = info->state->custom_divisor; 750 else { 751 if (baud == 134) 752 /* Special case since 134 is really 134.5 */ 753 quot = (2*baud_base / 269); 754 else if (baud) 755 quot = baud_base / baud; 756 } 757 } 758 /* As a last resort, if the quotient is zero, default to 9600 bps */ 759 if (!quot) 760 quot = baud_base / 9600; 761 info->quot = quot; 762 info->timeout = ((info->xmit_fifo_size*HZ*bits*quot) / baud_base); 763 info->timeout += HZ/50; /* Add .02 seconds of slop */ 764 765 /* CTS flow control flag and modem status interrupts */ 766 info->IER &= ~UART_IER_MSI; 767 if (info->flags & ASYNC_HARDPPS_CD) 768 info->IER |= UART_IER_MSI; 769 if (cflag & CRTSCTS) { 770 info->flags |= ASYNC_CTS_FLOW; 771 info->IER |= UART_IER_MSI; 772 } else 773 info->flags &= ~ASYNC_CTS_FLOW; 774 if (cflag & CLOCAL) 775 info->flags &= ~ASYNC_CHECK_CD; 776 else { 777 info->flags |= ASYNC_CHECK_CD; 778 info->IER |= UART_IER_MSI; 779 } 780 /* TBD: 781 * Does clearing IER_MSI imply that we should disbale the VBL interrupt ? 782 */ 783 784 /* 785 * Set up parity check flag 786 */ 787 788 info->read_status_mask = UART_LSR_OE | UART_LSR_DR; 789 if (I_INPCK(info->tty)) 790 info->read_status_mask |= UART_LSR_FE | UART_LSR_PE; 791 if (I_BRKINT(info->tty) || I_PARMRK(info->tty)) 792 info->read_status_mask |= UART_LSR_BI; 793 794 /* 795 * Characters to ignore 796 */ 797 info->ignore_status_mask = 0; 798 if (I_IGNPAR(info->tty)) 799 info->ignore_status_mask |= UART_LSR_PE | UART_LSR_FE; 800 if (I_IGNBRK(info->tty)) { 801 info->ignore_status_mask |= UART_LSR_BI; 802 /* 803 * If we're ignore parity and break indicators, ignore 804 * overruns too. (For real raw support). 805 */ 806 if (I_IGNPAR(info->tty)) 807 info->ignore_status_mask |= UART_LSR_OE; 808 } 809 /* 810 * !!! ignore all characters if CREAD is not set 811 */ 812 if ((cflag & CREAD) == 0) 813 info->ignore_status_mask |= UART_LSR_DR; 814 local_irq_save(flags); 815 816 { 817 short serper; 818 819 /* Set up the baud rate */ 820 serper = quot - 1; 821 822 /* Enable or disable parity bit */ 823 824 if(cval & UART_LCR_PARITY) 825 serper |= (SERPER_PARENB); 826 827 custom.serper = serper; 828 mb(); 829 } 830 831 info->LCR = cval; /* Save LCR */ 832 local_irq_restore(flags); 833} 834 835static int rs_put_char(struct tty_struct *tty, unsigned char ch) 836{ 837 struct async_struct *info; 838 unsigned long flags; 839 840 if (!tty) 841 return 0; 842 843 info = tty->driver_data; 844 845 if (serial_paranoia_check(info, tty->name, "rs_put_char")) 846 return 0; 847 848 if (!info->xmit.buf) 849 return 0; 850 851 local_irq_save(flags); 852 if (CIRC_SPACE(info->xmit.head, 853 info->xmit.tail, 854 SERIAL_XMIT_SIZE) == 0) { 855 local_irq_restore(flags); 856 return 0; 857 } 858 859 info->xmit.buf[info->xmit.head++] = ch; 860 info->xmit.head &= SERIAL_XMIT_SIZE-1; 861 local_irq_restore(flags); 862 return 1; 863} 864 865static void rs_flush_chars(struct tty_struct *tty) 866{ 867 struct async_struct *info = (struct async_struct *)tty->driver_data; 868 unsigned long flags; 869 870 if (serial_paranoia_check(info, tty->name, "rs_flush_chars")) 871 return; 872 873 if (info->xmit.head == info->xmit.tail 874 || tty->stopped 875 || tty->hw_stopped 876 || !info->xmit.buf) 877 return; 878 879 local_irq_save(flags); 880 info->IER |= UART_IER_THRI; 881 custom.intena = IF_SETCLR | IF_TBE; 882 mb(); 883 /* set a pending Tx Interrupt, transmitter should restart now */ 884 custom.intreq = IF_SETCLR | IF_TBE; 885 mb(); 886 local_irq_restore(flags); 887} 888 889static int rs_write(struct tty_struct * tty, const unsigned char *buf, int count) 890{ 891 int c, ret = 0; 892 struct async_struct *info; 893 unsigned long flags; 894 895 if (!tty) 896 return 0; 897 898 info = tty->driver_data; 899 900 if (serial_paranoia_check(info, tty->name, "rs_write")) 901 return 0; 902 903 if (!info->xmit.buf) 904 return 0; 905 906 local_irq_save(flags); 907 while (1) { 908 c = CIRC_SPACE_TO_END(info->xmit.head, 909 info->xmit.tail, 910 SERIAL_XMIT_SIZE); 911 if (count < c) 912 c = count; 913 if (c <= 0) { 914 break; 915 } 916 memcpy(info->xmit.buf + info->xmit.head, buf, c); 917 info->xmit.head = ((info->xmit.head + c) & 918 (SERIAL_XMIT_SIZE-1)); 919 buf += c; 920 count -= c; 921 ret += c; 922 } 923 local_irq_restore(flags); 924 925 if (info->xmit.head != info->xmit.tail 926 && !tty->stopped 927 && !tty->hw_stopped 928 && !(info->IER & UART_IER_THRI)) { 929 info->IER |= UART_IER_THRI; 930 local_irq_disable(); 931 custom.intena = IF_SETCLR | IF_TBE; 932 mb(); 933 /* set a pending Tx Interrupt, transmitter should restart now */ 934 custom.intreq = IF_SETCLR | IF_TBE; 935 mb(); 936 local_irq_restore(flags); 937 } 938 return ret; 939} 940 941static int rs_write_room(struct tty_struct *tty) 942{ 943 struct async_struct *info = (struct async_struct *)tty->driver_data; 944 945 if (serial_paranoia_check(info, tty->name, "rs_write_room")) 946 return 0; 947 return CIRC_SPACE(info->xmit.head, info->xmit.tail, SERIAL_XMIT_SIZE); 948} 949 950static int rs_chars_in_buffer(struct tty_struct *tty) 951{ 952 struct async_struct *info = (struct async_struct *)tty->driver_data; 953 954 if (serial_paranoia_check(info, tty->name, "rs_chars_in_buffer")) 955 return 0; 956 return CIRC_CNT(info->xmit.head, info->xmit.tail, SERIAL_XMIT_SIZE); 957} 958 959static void rs_flush_buffer(struct tty_struct *tty) 960{ 961 struct async_struct *info = (struct async_struct *)tty->driver_data; 962 unsigned long flags; 963 964 if (serial_paranoia_check(info, tty->name, "rs_flush_buffer")) 965 return; 966 local_irq_save(flags); 967 info->xmit.head = info->xmit.tail = 0; 968 local_irq_restore(flags); 969 tty_wakeup(tty); 970} 971 972/* 973 * This function is used to send a high-priority XON/XOFF character to 974 * the device 975 */ 976static void rs_send_xchar(struct tty_struct *tty, char ch) 977{ 978 struct async_struct *info = (struct async_struct *)tty->driver_data; 979 unsigned long flags; 980 981 if (serial_paranoia_check(info, tty->name, "rs_send_char")) 982 return; 983 984 info->x_char = ch; 985 if (ch) { 986 /* Make sure transmit interrupts are on */ 987 988 /* Check this ! */ 989 local_irq_save(flags); 990 if(!(custom.intenar & IF_TBE)) { 991 custom.intena = IF_SETCLR | IF_TBE; 992 mb(); 993 /* set a pending Tx Interrupt, transmitter should restart now */ 994 custom.intreq = IF_SETCLR | IF_TBE; 995 mb(); 996 } 997 local_irq_restore(flags); 998 999 info->IER |= UART_IER_THRI; 1000 } 1001} 1002 1003/* 1004 * ------------------------------------------------------------ 1005 * rs_throttle() 1006 * 1007 * This routine is called by the upper-layer tty layer to signal that 1008 * incoming characters should be throttled. 1009 * ------------------------------------------------------------ 1010 */ 1011static void rs_throttle(struct tty_struct * tty) 1012{ 1013 struct async_struct *info = (struct async_struct *)tty->driver_data; 1014 unsigned long flags; 1015#ifdef SERIAL_DEBUG_THROTTLE 1016 char buf[64]; 1017 1018 printk("throttle %s: %d....\n", tty_name(tty, buf), 1019 tty->ldisc.chars_in_buffer(tty)); 1020#endif 1021 1022 if (serial_paranoia_check(info, tty->name, "rs_throttle")) 1023 return; 1024 1025 if (I_IXOFF(tty)) 1026 rs_send_xchar(tty, STOP_CHAR(tty)); 1027 1028 if (tty->termios->c_cflag & CRTSCTS) 1029 info->MCR &= ~SER_RTS; 1030 1031 local_irq_save(flags); 1032 rtsdtr_ctrl(info->MCR); 1033 local_irq_restore(flags); 1034} 1035 1036static void rs_unthrottle(struct tty_struct * tty) 1037{ 1038 struct async_struct *info = (struct async_struct *)tty->driver_data; 1039 unsigned long flags; 1040#ifdef SERIAL_DEBUG_THROTTLE 1041 char buf[64]; 1042 1043 printk("unthrottle %s: %d....\n", tty_name(tty, buf), 1044 tty->ldisc.chars_in_buffer(tty)); 1045#endif 1046 1047 if (serial_paranoia_check(info, tty->name, "rs_unthrottle")) 1048 return; 1049 1050 if (I_IXOFF(tty)) { 1051 if (info->x_char) 1052 info->x_char = 0; 1053 else 1054 rs_send_xchar(tty, START_CHAR(tty)); 1055 } 1056 if (tty->termios->c_cflag & CRTSCTS) 1057 info->MCR |= SER_RTS; 1058 local_irq_save(flags); 1059 rtsdtr_ctrl(info->MCR); 1060 local_irq_restore(flags); 1061} 1062 1063/* 1064 * ------------------------------------------------------------ 1065 * rs_ioctl() and friends 1066 * ------------------------------------------------------------ 1067 */ 1068 1069static int get_serial_info(struct async_struct * info, 1070 struct serial_struct __user * retinfo) 1071{ 1072 struct serial_struct tmp; 1073 struct serial_state *state = info->state; 1074 1075 if (!retinfo) 1076 return -EFAULT; 1077 memset(&tmp, 0, sizeof(tmp)); 1078 lock_kernel(); 1079 tmp.type = state->type; 1080 tmp.line = state->line; 1081 tmp.port = state->port; 1082 tmp.irq = state->irq; 1083 tmp.flags = state->flags; 1084 tmp.xmit_fifo_size = state->xmit_fifo_size; 1085 tmp.baud_base = state->baud_base; 1086 tmp.close_delay = state->close_delay; 1087 tmp.closing_wait = state->closing_wait; 1088 tmp.custom_divisor = state->custom_divisor; 1089 unlock_kernel(); 1090 if (copy_to_user(retinfo,&tmp,sizeof(*retinfo))) 1091 return -EFAULT; 1092 return 0; 1093} 1094 1095static int set_serial_info(struct async_struct * info, 1096 struct serial_struct __user * new_info) 1097{ 1098 struct serial_struct new_serial; 1099 struct serial_state old_state, *state; 1100 unsigned int change_irq,change_port; 1101 int retval = 0; 1102 1103 if (copy_from_user(&new_serial,new_info,sizeof(new_serial))) 1104 return -EFAULT; 1105 1106 lock_kernel(); 1107 state = info->state; 1108 old_state = *state; 1109 1110 change_irq = new_serial.irq != state->irq; 1111 change_port = (new_serial.port != state->port); 1112 if(change_irq || change_port || (new_serial.xmit_fifo_size != state->xmit_fifo_size)) { 1113 unlock_kernel(); 1114 return -EINVAL; 1115 } 1116 1117 if (!serial_isroot()) { 1118 if ((new_serial.baud_base != state->baud_base) || 1119 (new_serial.close_delay != state->close_delay) || 1120 (new_serial.xmit_fifo_size != state->xmit_fifo_size) || 1121 ((new_serial.flags & ~ASYNC_USR_MASK) != 1122 (state->flags & ~ASYNC_USR_MASK))) 1123 return -EPERM; 1124 state->flags = ((state->flags & ~ASYNC_USR_MASK) | 1125 (new_serial.flags & ASYNC_USR_MASK)); 1126 info->flags = ((info->flags & ~ASYNC_USR_MASK) | 1127 (new_serial.flags & ASYNC_USR_MASK)); 1128 state->custom_divisor = new_serial.custom_divisor; 1129 goto check_and_exit; 1130 } 1131 1132 if (new_serial.baud_base < 9600) { 1133 unlock_kernel(); 1134 return -EINVAL; 1135 } 1136 1137 /* 1138 * OK, past this point, all the error checking has been done. 1139 * At this point, we start making changes..... 1140 */ 1141 1142 state->baud_base = new_serial.baud_base; 1143 state->flags = ((state->flags & ~ASYNC_FLAGS) | 1144 (new_serial.flags & ASYNC_FLAGS)); 1145 info->flags = ((state->flags & ~ASYNC_INTERNAL_FLAGS) | 1146 (info->flags & ASYNC_INTERNAL_FLAGS)); 1147 state->custom_divisor = new_serial.custom_divisor; 1148 state->close_delay = new_serial.close_delay * HZ/100; 1149 state->closing_wait = new_serial.closing_wait * HZ/100; 1150 info->tty->low_latency = (info->flags & ASYNC_LOW_LATENCY) ? 1 : 0; 1151 1152check_and_exit: 1153 if (info->flags & ASYNC_INITIALIZED) { 1154 if (((old_state.flags & ASYNC_SPD_MASK) != 1155 (state->flags & ASYNC_SPD_MASK)) || 1156 (old_state.custom_divisor != state->custom_divisor)) { 1157 if ((state->flags & ASYNC_SPD_MASK) == ASYNC_SPD_HI) 1158 info->tty->alt_speed = 57600; 1159 if ((state->flags & ASYNC_SPD_MASK) == ASYNC_SPD_VHI) 1160 info->tty->alt_speed = 115200; 1161 if ((state->flags & ASYNC_SPD_MASK) == ASYNC_SPD_SHI) 1162 info->tty->alt_speed = 230400; 1163 if ((state->flags & ASYNC_SPD_MASK) == ASYNC_SPD_WARP) 1164 info->tty->alt_speed = 460800; 1165 change_speed(info, NULL); 1166 } 1167 } else 1168 retval = startup(info); 1169 unlock_kernel(); 1170 return retval; 1171} 1172 1173 1174/* 1175 * get_lsr_info - get line status register info 1176 * 1177 * Purpose: Let user call ioctl() to get info when the UART physically 1178 * is emptied. On bus types like RS485, the transmitter must 1179 * release the bus after transmitting. This must be done when 1180 * the transmit shift register is empty, not be done when the 1181 * transmit holding register is empty. This functionality 1182 * allows an RS485 driver to be written in user space. 1183 */ 1184static int get_lsr_info(struct async_struct * info, unsigned int __user *value) 1185{ 1186 unsigned char status; 1187 unsigned int result; 1188 unsigned long flags; 1189 1190 local_irq_save(flags); 1191 status = custom.serdatr; 1192 mb(); 1193 local_irq_restore(flags); 1194 result = ((status & SDR_TSRE) ? TIOCSER_TEMT : 0); 1195 if (copy_to_user(value, &result, sizeof(int))) 1196 return -EFAULT; 1197 return 0; 1198} 1199 1200 1201static int rs_tiocmget(struct tty_struct *tty, struct file *file) 1202{ 1203 struct async_struct * info = (struct async_struct *)tty->driver_data; 1204 unsigned char control, status; 1205 unsigned long flags; 1206 1207 if (serial_paranoia_check(info, tty->name, "rs_ioctl")) 1208 return -ENODEV; 1209 if (tty->flags & (1 << TTY_IO_ERROR)) 1210 return -EIO; 1211 1212 control = info->MCR; 1213 local_irq_save(flags); 1214 status = ciab.pra; 1215 local_irq_restore(flags); 1216 return ((control & SER_RTS) ? TIOCM_RTS : 0) 1217 | ((control & SER_DTR) ? TIOCM_DTR : 0) 1218 | (!(status & SER_DCD) ? TIOCM_CAR : 0) 1219 | (!(status & SER_DSR) ? TIOCM_DSR : 0) 1220 | (!(status & SER_CTS) ? TIOCM_CTS : 0); 1221} 1222 1223static int rs_tiocmset(struct tty_struct *tty, struct file *file, 1224 unsigned int set, unsigned int clear) 1225{ 1226 struct async_struct * info = (struct async_struct *)tty->driver_data; 1227 unsigned long flags; 1228 1229 if (serial_paranoia_check(info, tty->name, "rs_ioctl")) 1230 return -ENODEV; 1231 if (tty->flags & (1 << TTY_IO_ERROR)) 1232 return -EIO; 1233 1234 local_irq_save(flags); 1235 if (set & TIOCM_RTS) 1236 info->MCR |= SER_RTS; 1237 if (set & TIOCM_DTR) 1238 info->MCR |= SER_DTR; 1239 if (clear & TIOCM_RTS) 1240 info->MCR &= ~SER_RTS; 1241 if (clear & TIOCM_DTR) 1242 info->MCR &= ~SER_DTR; 1243 rtsdtr_ctrl(info->MCR); 1244 local_irq_restore(flags); 1245 return 0; 1246} 1247 1248/* 1249 * rs_break() --- routine which turns the break handling on or off 1250 */ 1251static int rs_break(struct tty_struct *tty, int break_state) 1252{ 1253 struct async_struct * info = (struct async_struct *)tty->driver_data; 1254 unsigned long flags; 1255 1256 if (serial_paranoia_check(info, tty->name, "rs_break")) 1257 return -EINVAL; 1258 1259 local_irq_save(flags); 1260 if (break_state == -1) 1261 custom.adkcon = AC_SETCLR | AC_UARTBRK; 1262 else 1263 custom.adkcon = AC_UARTBRK; 1264 mb(); 1265 local_irq_restore(flags); 1266 return 0; 1267} 1268 1269 1270static int rs_ioctl(struct tty_struct *tty, struct file * file, 1271 unsigned int cmd, unsigned long arg) 1272{ 1273 struct async_struct * info = (struct async_struct *)tty->driver_data; 1274 struct async_icount cprev, cnow; /* kernel counter temps */ 1275 struct serial_icounter_struct icount; 1276 void __user *argp = (void __user *)arg; 1277 unsigned long flags; 1278 1279 if (serial_paranoia_check(info, tty->name, "rs_ioctl")) 1280 return -ENODEV; 1281 1282 if ((cmd != TIOCGSERIAL) && (cmd != TIOCSSERIAL) && 1283 (cmd != TIOCSERCONFIG) && (cmd != TIOCSERGSTRUCT) && 1284 (cmd != TIOCMIWAIT) && (cmd != TIOCGICOUNT)) { 1285 if (tty->flags & (1 << TTY_IO_ERROR)) 1286 return -EIO; 1287 } 1288 1289 switch (cmd) { 1290 case TIOCGSERIAL: 1291 return get_serial_info(info, argp); 1292 case TIOCSSERIAL: 1293 return set_serial_info(info, argp); 1294 case TIOCSERCONFIG: 1295 return 0; 1296 1297 case TIOCSERGETLSR: /* Get line status register */ 1298 return get_lsr_info(info, argp); 1299 1300 case TIOCSERGSTRUCT: 1301 if (copy_to_user(argp, 1302 info, sizeof(struct async_struct))) 1303 return -EFAULT; 1304 return 0; 1305 1306 /* 1307 * Wait for any of the 4 modem inputs (DCD,RI,DSR,CTS) to change 1308 * - mask passed in arg for lines of interest 1309 * (use |'ed TIOCM_RNG/DSR/CD/CTS for masking) 1310 * Caller should use TIOCGICOUNT to see which one it was 1311 */ 1312 case TIOCMIWAIT: 1313 local_irq_save(flags); 1314 /* note the counters on entry */ 1315 cprev = info->state->icount; 1316 local_irq_restore(flags); 1317 while (1) { 1318 interruptible_sleep_on(&info->delta_msr_wait); 1319 /* see if a signal did it */ 1320 if (signal_pending(current)) 1321 return -ERESTARTSYS; 1322 local_irq_save(flags); 1323 cnow = info->state->icount; /* atomic copy */ 1324 local_irq_restore(flags); 1325 if (cnow.rng == cprev.rng && cnow.dsr == cprev.dsr && 1326 cnow.dcd == cprev.dcd && cnow.cts == cprev.cts) 1327 return -EIO; /* no change => error */ 1328 if ( ((arg & TIOCM_RNG) && (cnow.rng != cprev.rng)) || 1329 ((arg & TIOCM_DSR) && (cnow.dsr != cprev.dsr)) || 1330 ((arg & TIOCM_CD) && (cnow.dcd != cprev.dcd)) || 1331 ((arg & TIOCM_CTS) && (cnow.cts != cprev.cts)) ) { 1332 return 0; 1333 } 1334 cprev = cnow; 1335 } 1336 /* NOTREACHED */ 1337 1338 /* 1339 * Get counter of input serial line interrupts (DCD,RI,DSR,CTS) 1340 * Return: write counters to the user passed counter struct 1341 * NB: both 1->0 and 0->1 transitions are counted except for 1342 * RI where only 0->1 is counted. 1343 */ 1344 case TIOCGICOUNT: 1345 local_irq_save(flags); 1346 cnow = info->state->icount; 1347 local_irq_restore(flags); 1348 icount.cts = cnow.cts; 1349 icount.dsr = cnow.dsr; 1350 icount.rng = cnow.rng; 1351 icount.dcd = cnow.dcd; 1352 icount.rx = cnow.rx; 1353 icount.tx = cnow.tx; 1354 icount.frame = cnow.frame; 1355 icount.overrun = cnow.overrun; 1356 icount.parity = cnow.parity; 1357 icount.brk = cnow.brk; 1358 icount.buf_overrun = cnow.buf_overrun; 1359 1360 if (copy_to_user(argp, &icount, sizeof(icount))) 1361 return -EFAULT; 1362 return 0; 1363 case TIOCSERGWILD: 1364 case TIOCSERSWILD: 1365 /* "setserial -W" is called in Debian boot */ 1366 printk ("TIOCSER?WILD ioctl obsolete, ignored.\n"); 1367 return 0; 1368 1369 default: 1370 return -ENOIOCTLCMD; 1371 } 1372 return 0; 1373} 1374 1375static void rs_set_termios(struct tty_struct *tty, struct ktermios *old_termios) 1376{ 1377 struct async_struct *info = (struct async_struct *)tty->driver_data; 1378 unsigned long flags; 1379 unsigned int cflag = tty->termios->c_cflag; 1380 1381 change_speed(info, old_termios); 1382 1383 /* Handle transition to B0 status */ 1384 if ((old_termios->c_cflag & CBAUD) && 1385 !(cflag & CBAUD)) { 1386 info->MCR &= ~(SER_DTR|SER_RTS); 1387 local_irq_save(flags); 1388 rtsdtr_ctrl(info->MCR); 1389 local_irq_restore(flags); 1390 } 1391 1392 /* Handle transition away from B0 status */ 1393 if (!(old_termios->c_cflag & CBAUD) && 1394 (cflag & CBAUD)) { 1395 info->MCR |= SER_DTR; 1396 if (!(tty->termios->c_cflag & CRTSCTS) || 1397 !test_bit(TTY_THROTTLED, &tty->flags)) { 1398 info->MCR |= SER_RTS; 1399 } 1400 local_irq_save(flags); 1401 rtsdtr_ctrl(info->MCR); 1402 local_irq_restore(flags); 1403 } 1404 1405 /* Handle turning off CRTSCTS */ 1406 if ((old_termios->c_cflag & CRTSCTS) && 1407 !(tty->termios->c_cflag & CRTSCTS)) { 1408 tty->hw_stopped = 0; 1409 rs_start(tty); 1410 } 1411 1412#if 0 1413 /* 1414 * No need to wake up processes in open wait, since they 1415 * sample the CLOCAL flag once, and don't recheck it. 1416 * XXX It's not clear whether the current behavior is correct 1417 * or not. Hence, this may change..... 1418 */ 1419 if (!(old_termios->c_cflag & CLOCAL) && 1420 (tty->termios->c_cflag & CLOCAL)) 1421 wake_up_interruptible(&info->open_wait); 1422#endif 1423} 1424 1425/* 1426 * ------------------------------------------------------------ 1427 * rs_close() 1428 * 1429 * This routine is called when the serial port gets closed. First, we 1430 * wait for the last remaining data to be sent. Then, we unlink its 1431 * async structure from the interrupt chain if necessary, and we free 1432 * that IRQ if nothing is left in the chain. 1433 * ------------------------------------------------------------ 1434 */ 1435static void rs_close(struct tty_struct *tty, struct file * filp) 1436{ 1437 struct async_struct * info = (struct async_struct *)tty->driver_data; 1438 struct serial_state *state; 1439 unsigned long flags; 1440 1441 if (!info || serial_paranoia_check(info, tty->name, "rs_close")) 1442 return; 1443 1444 state = info->state; 1445 1446 local_irq_save(flags); 1447 1448 if (tty_hung_up_p(filp)) { 1449 DBG_CNT("before DEC-hung"); 1450 local_irq_restore(flags); 1451 return; 1452 } 1453 1454#ifdef SERIAL_DEBUG_OPEN 1455 printk("rs_close ttys%d, count = %d\n", info->line, state->count); 1456#endif 1457 if ((tty->count == 1) && (state->count != 1)) { 1458 /* 1459 * Uh, oh. tty->count is 1, which means that the tty 1460 * structure will be freed. state->count should always 1461 * be one in these conditions. If it's greater than 1462 * one, we've got real problems, since it means the 1463 * serial port won't be shutdown. 1464 */ 1465 printk("rs_close: bad serial port count; tty->count is 1, " 1466 "state->count is %d\n", state->count); 1467 state->count = 1; 1468 } 1469 if (--state->count < 0) { 1470 printk("rs_close: bad serial port count for ttys%d: %d\n", 1471 info->line, state->count); 1472 state->count = 0; 1473 } 1474 if (state->count) { 1475 DBG_CNT("before DEC-2"); 1476 local_irq_restore(flags); 1477 return; 1478 } 1479 info->flags |= ASYNC_CLOSING; 1480 /* 1481 * Now we wait for the transmit buffer to clear; and we notify 1482 * the line discipline to only process XON/XOFF characters. 1483 */ 1484 tty->closing = 1; 1485 if (info->closing_wait != ASYNC_CLOSING_WAIT_NONE) 1486 tty_wait_until_sent(tty, info->closing_wait); 1487 /* 1488 * At this point we stop accepting input. To do this, we 1489 * disable the receive line status interrupts, and tell the 1490 * interrupt driver to stop checking the data ready bit in the 1491 * line status register. 1492 */ 1493 info->read_status_mask &= ~UART_LSR_DR; 1494 if (info->flags & ASYNC_INITIALIZED) { 1495 /* disable receive interrupts */ 1496 custom.intena = IF_RBF; 1497 mb(); 1498 /* clear any pending receive interrupt */ 1499 custom.intreq = IF_RBF; 1500 mb(); 1501 1502 /* 1503 * Before we drop DTR, make sure the UART transmitter 1504 * has completely drained; this is especially 1505 * important if there is a transmit FIFO! 1506 */ 1507 rs_wait_until_sent(tty, info->timeout); 1508 } 1509 shutdown(info); 1510 rs_flush_buffer(tty); 1511 1512 tty_ldisc_flush(tty); 1513 tty->closing = 0; 1514 info->event = 0; 1515 info->tty = NULL; 1516 if (info->blocked_open) { 1517 if (info->close_delay) { 1518 msleep_interruptible(jiffies_to_msecs(info->close_delay)); 1519 } 1520 wake_up_interruptible(&info->open_wait); 1521 } 1522 info->flags &= ~(ASYNC_NORMAL_ACTIVE|ASYNC_CLOSING); 1523 wake_up_interruptible(&info->close_wait); 1524 local_irq_restore(flags); 1525} 1526 1527/* 1528 * rs_wait_until_sent() --- wait until the transmitter is empty 1529 */ 1530static void rs_wait_until_sent(struct tty_struct *tty, int timeout) 1531{ 1532 struct async_struct * info = (struct async_struct *)tty->driver_data; 1533 unsigned long orig_jiffies, char_time; 1534 int lsr; 1535 1536 if (serial_paranoia_check(info, tty->name, "rs_wait_until_sent")) 1537 return; 1538 1539 if (info->xmit_fifo_size == 0) 1540 return; /* Just in case.... */ 1541 1542 orig_jiffies = jiffies; 1543 1544 lock_kernel(); 1545 /* 1546 * Set the check interval to be 1/5 of the estimated time to 1547 * send a single character, and make it at least 1. The check 1548 * interval should also be less than the timeout. 1549 * 1550 * Note: we have to use pretty tight timings here to satisfy 1551 * the NIST-PCTS. 1552 */ 1553 char_time = (info->timeout - HZ/50) / info->xmit_fifo_size; 1554 char_time = char_time / 5; 1555 if (char_time == 0) 1556 char_time = 1; 1557 if (timeout) 1558 char_time = min_t(unsigned long, char_time, timeout); 1559 /* 1560 * If the transmitter hasn't cleared in twice the approximate 1561 * amount of time to send the entire FIFO, it probably won't 1562 * ever clear. This assumes the UART isn't doing flow 1563 * control, which is currently the case. Hence, if it ever 1564 * takes longer than info->timeout, this is probably due to a 1565 * UART bug of some kind. So, we clamp the timeout parameter at 1566 * 2*info->timeout. 1567 */ 1568 if (!timeout || timeout > 2*info->timeout) 1569 timeout = 2*info->timeout; 1570#ifdef SERIAL_DEBUG_RS_WAIT_UNTIL_SENT 1571 printk("In rs_wait_until_sent(%d) check=%lu...", timeout, char_time); 1572 printk("jiff=%lu...", jiffies); 1573#endif 1574 while(!((lsr = custom.serdatr) & SDR_TSRE)) { 1575#ifdef SERIAL_DEBUG_RS_WAIT_UNTIL_SENT 1576 printk("serdatr = %d (jiff=%lu)...", lsr, jiffies); 1577#endif 1578 msleep_interruptible(jiffies_to_msecs(char_time)); 1579 if (signal_pending(current)) 1580 break; 1581 if (timeout && time_after(jiffies, orig_jiffies + timeout)) 1582 break; 1583 } 1584 __set_current_state(TASK_RUNNING); 1585 unlock_kernel(); 1586#ifdef SERIAL_DEBUG_RS_WAIT_UNTIL_SENT 1587 printk("lsr = %d (jiff=%lu)...done\n", lsr, jiffies); 1588#endif 1589} 1590 1591/* 1592 * rs_hangup() --- called by tty_hangup() when a hangup is signaled. 1593 */ 1594static void rs_hangup(struct tty_struct *tty) 1595{ 1596 struct async_struct * info = (struct async_struct *)tty->driver_data; 1597 struct serial_state *state = info->state; 1598 1599 if (serial_paranoia_check(info, tty->name, "rs_hangup")) 1600 return; 1601 1602 state = info->state; 1603 1604 rs_flush_buffer(tty); 1605 shutdown(info); 1606 info->event = 0; 1607 state->count = 0; 1608 info->flags &= ~ASYNC_NORMAL_ACTIVE; 1609 info->tty = NULL; 1610 wake_up_interruptible(&info->open_wait); 1611} 1612 1613/* 1614 * ------------------------------------------------------------ 1615 * rs_open() and friends 1616 * ------------------------------------------------------------ 1617 */ 1618static int block_til_ready(struct tty_struct *tty, struct file * filp, 1619 struct async_struct *info) 1620{ 1621#ifdef DECLARE_WAITQUEUE 1622 DECLARE_WAITQUEUE(wait, current); 1623#else 1624 struct wait_queue wait = { current, NULL }; 1625#endif 1626 struct serial_state *state = info->state; 1627 int retval; 1628 int do_clocal = 0, extra_count = 0; 1629 unsigned long flags; 1630 1631 /* 1632 * If the device is in the middle of being closed, then block 1633 * until it's done, and then try again. 1634 */ 1635 if (tty_hung_up_p(filp) || 1636 (info->flags & ASYNC_CLOSING)) { 1637 if (info->flags & ASYNC_CLOSING) 1638 interruptible_sleep_on(&info->close_wait); 1639#ifdef SERIAL_DO_RESTART 1640 return ((info->flags & ASYNC_HUP_NOTIFY) ? 1641 -EAGAIN : -ERESTARTSYS); 1642#else 1643 return -EAGAIN; 1644#endif 1645 } 1646 1647 /* 1648 * If non-blocking mode is set, or the port is not enabled, 1649 * then make the check up front and then exit. 1650 */ 1651 if ((filp->f_flags & O_NONBLOCK) || 1652 (tty->flags & (1 << TTY_IO_ERROR))) { 1653 info->flags |= ASYNC_NORMAL_ACTIVE; 1654 return 0; 1655 } 1656 1657 if (tty->termios->c_cflag & CLOCAL) 1658 do_clocal = 1; 1659 1660 /* 1661 * Block waiting for the carrier detect and the line to become 1662 * free (i.e., not in use by the callout). While we are in 1663 * this loop, state->count is dropped by one, so that 1664 * rs_close() knows when to free things. We restore it upon 1665 * exit, either normal or abnormal. 1666 */ 1667 retval = 0; 1668 add_wait_queue(&info->open_wait, &wait); 1669#ifdef SERIAL_DEBUG_OPEN 1670 printk("block_til_ready before block: ttys%d, count = %d\n", 1671 state->line, state->count); 1672#endif 1673 local_irq_save(flags); 1674 if (!tty_hung_up_p(filp)) { 1675 extra_count = 1; 1676 state->count--; 1677 } 1678 local_irq_restore(flags); 1679 info->blocked_open++; 1680 while (1) { 1681 local_irq_save(flags); 1682 if (tty->termios->c_cflag & CBAUD) 1683 rtsdtr_ctrl(SER_DTR|SER_RTS); 1684 local_irq_restore(flags); 1685 set_current_state(TASK_INTERRUPTIBLE); 1686 if (tty_hung_up_p(filp) || 1687 !(info->flags & ASYNC_INITIALIZED)) { 1688#ifdef SERIAL_DO_RESTART 1689 if (info->flags & ASYNC_HUP_NOTIFY) 1690 retval = -EAGAIN; 1691 else 1692 retval = -ERESTARTSYS; 1693#else 1694 retval = -EAGAIN; 1695#endif 1696 break; 1697 } 1698 if (!(info->flags & ASYNC_CLOSING) && 1699 (do_clocal || (!(ciab.pra & SER_DCD)) )) 1700 break; 1701 if (signal_pending(current)) { 1702 retval = -ERESTARTSYS; 1703 break; 1704 } 1705#ifdef SERIAL_DEBUG_OPEN 1706 printk("block_til_ready blocking: ttys%d, count = %d\n", 1707 info->line, state->count); 1708#endif 1709 schedule(); 1710 } 1711 __set_current_state(TASK_RUNNING); 1712 remove_wait_queue(&info->open_wait, &wait); 1713 if (extra_count) 1714 state->count++; 1715 info->blocked_open--; 1716#ifdef SERIAL_DEBUG_OPEN 1717 printk("block_til_ready after blocking: ttys%d, count = %d\n", 1718 info->line, state->count); 1719#endif 1720 if (retval) 1721 return retval; 1722 info->flags |= ASYNC_NORMAL_ACTIVE; 1723 return 0; 1724} 1725 1726static int get_async_struct(int line, struct async_struct **ret_info) 1727{ 1728 struct async_struct *info; 1729 struct serial_state *sstate; 1730 1731 sstate = rs_table + line; 1732 sstate->count++; 1733 if (sstate->info) { 1734 *ret_info = sstate->info; 1735 return 0; 1736 } 1737 info = kzalloc(sizeof(struct async_struct), GFP_KERNEL); 1738 if (!info) { 1739 sstate->count--; 1740 return -ENOMEM; 1741 } 1742#ifdef DECLARE_WAITQUEUE 1743 init_waitqueue_head(&info->open_wait); 1744 init_waitqueue_head(&info->close_wait); 1745 init_waitqueue_head(&info->delta_msr_wait); 1746#endif 1747 info->magic = SERIAL_MAGIC; 1748 info->port = sstate->port; 1749 info->flags = sstate->flags; 1750 info->xmit_fifo_size = sstate->xmit_fifo_size; 1751 info->line = line; 1752 tasklet_init(&info->tlet, do_softint, (unsigned long)info); 1753 info->state = sstate; 1754 if (sstate->info) { 1755 kfree(info); 1756 *ret_info = sstate->info; 1757 return 0; 1758 } 1759 *ret_info = sstate->info = info; 1760 return 0; 1761} 1762 1763/* 1764 * This routine is called whenever a serial port is opened. It 1765 * enables interrupts for a serial port, linking in its async structure into 1766 * the IRQ chain. It also performs the serial-specific 1767 * initialization for the tty structure. 1768 */ 1769static int rs_open(struct tty_struct *tty, struct file * filp) 1770{ 1771 struct async_struct *info; 1772 int retval, line; 1773 1774 line = tty->index; 1775 if ((line < 0) || (line >= NR_PORTS)) { 1776 return -ENODEV; 1777 } 1778 retval = get_async_struct(line, &info); 1779 if (retval) { 1780 return retval; 1781 } 1782 tty->driver_data = info; 1783 info->tty = tty; 1784 if (serial_paranoia_check(info, tty->name, "rs_open")) 1785 return -ENODEV; 1786 1787#ifdef SERIAL_DEBUG_OPEN 1788 printk("rs_open %s, count = %d\n", tty->name, info->state->count); 1789#endif 1790 info->tty->low_latency = (info->flags & ASYNC_LOW_LATENCY) ? 1 : 0; 1791 1792 /* 1793 * If the port is the middle of closing, bail out now 1794 */ 1795 if (tty_hung_up_p(filp) || 1796 (info->flags & ASYNC_CLOSING)) { 1797 if (info->flags & ASYNC_CLOSING) 1798 interruptible_sleep_on(&info->close_wait); 1799#ifdef SERIAL_DO_RESTART 1800 return ((info->flags & ASYNC_HUP_NOTIFY) ? 1801 -EAGAIN : -ERESTARTSYS); 1802#else 1803 return -EAGAIN; 1804#endif 1805 } 1806 1807 /* 1808 * Start up serial port 1809 */ 1810 retval = startup(info); 1811 if (retval) { 1812 return retval; 1813 } 1814 1815 retval = block_til_ready(tty, filp, info); 1816 if (retval) { 1817#ifdef SERIAL_DEBUG_OPEN 1818 printk("rs_open returning after block_til_ready with %d\n", 1819 retval); 1820#endif 1821 return retval; 1822 } 1823 1824#ifdef SERIAL_DEBUG_OPEN 1825 printk("rs_open %s successful...", tty->name); 1826#endif 1827 return 0; 1828} 1829 1830/* 1831 * /proc fs routines.... 1832 */ 1833 1834static inline int line_info(char *buf, struct serial_state *state) 1835{ 1836 struct async_struct *info = state->info, scr_info; 1837 char stat_buf[30], control, status; 1838 int ret; 1839 unsigned long flags; 1840 1841 ret = sprintf(buf, "%d: uart:amiga_builtin",state->line); 1842 1843 /* 1844 * Figure out the current RS-232 lines 1845 */ 1846 if (!info) { 1847 info = &scr_info; /* This is just for serial_{in,out} */ 1848 1849 info->magic = SERIAL_MAGIC; 1850 info->flags = state->flags; 1851 info->quot = 0; 1852 info->tty = NULL; 1853 } 1854 local_irq_save(flags); 1855 status = ciab.pra; 1856 control = info ? info->MCR : status; 1857 local_irq_restore(flags); 1858 1859 stat_buf[0] = 0; 1860 stat_buf[1] = 0; 1861 if(!(control & SER_RTS)) 1862 strcat(stat_buf, "|RTS"); 1863 if(!(status & SER_CTS)) 1864 strcat(stat_buf, "|CTS"); 1865 if(!(control & SER_DTR)) 1866 strcat(stat_buf, "|DTR"); 1867 if(!(status & SER_DSR)) 1868 strcat(stat_buf, "|DSR"); 1869 if(!(status & SER_DCD)) 1870 strcat(stat_buf, "|CD"); 1871 1872 if (info->quot) { 1873 ret += sprintf(buf+ret, " baud:%d", 1874 state->baud_base / info->quot); 1875 } 1876 1877 ret += sprintf(buf+ret, " tx:%d rx:%d", 1878 state->icount.tx, state->icount.rx); 1879 1880 if (state->icount.frame) 1881 ret += sprintf(buf+ret, " fe:%d", state->icount.frame); 1882 1883 if (state->icount.parity) 1884 ret += sprintf(buf+ret, " pe:%d", state->icount.parity); 1885 1886 if (state->icount.brk) 1887 ret += sprintf(buf+ret, " brk:%d", state->icount.brk); 1888 1889 if (state->icount.overrun) 1890 ret += sprintf(buf+ret, " oe:%d", state->icount.overrun); 1891 1892 /* 1893 * Last thing is the RS-232 status lines 1894 */ 1895 ret += sprintf(buf+ret, " %s\n", stat_buf+1); 1896 return ret; 1897} 1898 1899static int rs_read_proc(char *page, char **start, off_t off, int count, 1900 int *eof, void *data) 1901{ 1902 int len = 0, l; 1903 off_t begin = 0; 1904 1905 len += sprintf(page, "serinfo:1.0 driver:%s\n", serial_version); 1906 l = line_info(page + len, &rs_table[0]); 1907 len += l; 1908 if (len+begin > off+count) 1909 goto done; 1910 if (len+begin < off) { 1911 begin += len; 1912 len = 0; 1913 } 1914 *eof = 1; 1915done: 1916 if (off >= len+begin) 1917 return 0; 1918 *start = page + (off-begin); 1919 return ((count < begin+len-off) ? count : begin+len-off); 1920} 1921 1922/* 1923 * --------------------------------------------------------------------- 1924 * rs_init() and friends 1925 * 1926 * rs_init() is called at boot-time to initialize the serial driver. 1927 * --------------------------------------------------------------------- 1928 */ 1929 1930/* 1931 * This routine prints out the appropriate serial driver version 1932 * number, and identifies which options were configured into this 1933 * driver. 1934 */ 1935static void show_serial_version(void) 1936{ 1937 printk(KERN_INFO "%s version %s\n", serial_name, serial_version); 1938} 1939 1940 1941static const struct tty_operations serial_ops = { 1942 .open = rs_open, 1943 .close = rs_close, 1944 .write = rs_write, 1945 .put_char = rs_put_char, 1946 .flush_chars = rs_flush_chars, 1947 .write_room = rs_write_room, 1948 .chars_in_buffer = rs_chars_in_buffer, 1949 .flush_buffer = rs_flush_buffer, 1950 .ioctl = rs_ioctl, 1951 .throttle = rs_throttle, 1952 .unthrottle = rs_unthrottle, 1953 .set_termios = rs_set_termios, 1954 .stop = rs_stop, 1955 .start = rs_start, 1956 .hangup = rs_hangup, 1957 .break_ctl = rs_break, 1958 .send_xchar = rs_send_xchar, 1959 .wait_until_sent = rs_wait_until_sent, 1960 .read_proc = rs_read_proc, 1961 .tiocmget = rs_tiocmget, 1962 .tiocmset = rs_tiocmset, 1963}; 1964 1965/* 1966 * The serial driver boot-time initialization code! 1967 */ 1968static int __init rs_init(void) 1969{ 1970 unsigned long flags; 1971 struct serial_state * state; 1972 1973 if (!MACH_IS_AMIGA || !AMIGAHW_PRESENT(AMI_SERIAL)) 1974 return -ENODEV; 1975 1976 serial_driver = alloc_tty_driver(1); 1977 if (!serial_driver) 1978 return -ENOMEM; 1979 1980 /* 1981 * We request SERDAT and SERPER only, because the serial registers are 1982 * too spreaded over the custom register space 1983 */ 1984 if (!request_mem_region(CUSTOM_PHYSADDR+0x30, 4, "amiserial [Paula]")) 1985 return -EBUSY; 1986 1987 IRQ_ports = NULL; 1988 1989 show_serial_version(); 1990 1991 /* Initialize the tty_driver structure */ 1992 1993 serial_driver->owner = THIS_MODULE; 1994 serial_driver->driver_name = "amiserial"; 1995 serial_driver->name = "ttyS"; 1996 serial_driver->major = TTY_MAJOR; 1997 serial_driver->minor_start = 64; 1998 serial_driver->type = TTY_DRIVER_TYPE_SERIAL; 1999 serial_driver->subtype = SERIAL_TYPE_NORMAL; 2000 serial_driver->init_termios = tty_std_termios; 2001 serial_driver->init_termios.c_cflag = 2002 B9600 | CS8 | CREAD | HUPCL | CLOCAL; 2003 serial_driver->flags = TTY_DRIVER_REAL_RAW; 2004 tty_set_operations(serial_driver, &serial_ops); 2005 2006 if (tty_register_driver(serial_driver)) 2007 panic("Couldn't register serial driver\n"); 2008 2009 state = rs_table; 2010 state->magic = SSTATE_MAGIC; 2011 state->port = (int)&custom.serdatr; /* Just to give it a value */ 2012 state->line = 0; 2013 state->custom_divisor = 0; 2014 state->close_delay = 5*HZ/10; 2015 state->closing_wait = 30*HZ; 2016 state->icount.cts = state->icount.dsr = 2017 state->icount.rng = state->icount.dcd = 0; 2018 state->icount.rx = state->icount.tx = 0; 2019 state->icount.frame = state->icount.parity = 0; 2020 state->icount.overrun = state->icount.brk = 0; 2021 2022 printk(KERN_INFO "ttyS%d is the amiga builtin serial port\n", 2023 state->line); 2024 2025 /* Hardware set up */ 2026 2027 state->baud_base = amiga_colorclock; 2028 state->xmit_fifo_size = 1; 2029 2030 local_irq_save(flags); 2031 2032 /* set ISRs, and then disable the rx interrupts */ 2033 request_irq(IRQ_AMIGA_TBE, ser_tx_int, 0, "serial TX", state); 2034 request_irq(IRQ_AMIGA_RBF, ser_rx_int, IRQF_DISABLED, "serial RX", state); 2035 2036 /* turn off Rx and Tx interrupts */ 2037 custom.intena = IF_RBF | IF_TBE; 2038 mb(); 2039 2040 /* clear any pending interrupt */ 2041 custom.intreq = IF_RBF | IF_TBE; 2042 mb(); 2043 2044 local_irq_restore(flags); 2045 2046 /* 2047 * set the appropriate directions for the modem control flags, 2048 * and clear RTS and DTR 2049 */ 2050 ciab.ddra |= (SER_DTR | SER_RTS); /* outputs */ 2051 ciab.ddra &= ~(SER_DCD | SER_CTS | SER_DSR); /* inputs */ 2052 2053 return 0; 2054} 2055 2056static __exit void rs_exit(void) 2057{ 2058 int error; 2059 struct async_struct *info = rs_table[0].info; 2060 2061 /* printk("Unloading %s: version %s\n", serial_name, serial_version); */ 2062 tasklet_kill(&info->tlet); 2063 if ((error = tty_unregister_driver(serial_driver))) 2064 printk("SERIAL: failed to unregister serial driver (%d)\n", 2065 error); 2066 put_tty_driver(serial_driver); 2067 2068 if (info) { 2069 rs_table[0].info = NULL; 2070 kfree(info); 2071 } 2072 2073 release_mem_region(CUSTOM_PHYSADDR+0x30, 4); 2074} 2075 2076module_init(rs_init) 2077module_exit(rs_exit) 2078 2079 2080/* 2081 * ------------------------------------------------------------ 2082 * Serial console driver 2083 * ------------------------------------------------------------ 2084 */ 2085#ifdef CONFIG_SERIAL_CONSOLE 2086 2087static void amiga_serial_putc(char c) 2088{ 2089 custom.serdat = (unsigned char)c | 0x100; 2090 while (!(custom.serdatr & 0x2000)) 2091 barrier(); 2092} 2093 2094/* 2095 * Print a string to the serial port trying not to disturb 2096 * any possible real use of the port... 2097 * 2098 * The console must be locked when we get here. 2099 */ 2100static void serial_console_write(struct console *co, const char *s, 2101 unsigned count) 2102{ 2103 unsigned short intena = custom.intenar; 2104 2105 custom.intena = IF_TBE; 2106 2107 while (count--) { 2108 if (*s == '\n') 2109 amiga_serial_putc('\r'); 2110 amiga_serial_putc(*s++); 2111 } 2112 2113 custom.intena = IF_SETCLR | (intena & IF_TBE); 2114} 2115 2116static struct tty_driver *serial_console_device(struct console *c, int *index) 2117{ 2118 *index = 0; 2119 return serial_driver; 2120} 2121 2122static struct console sercons = { 2123 .name = "ttyS", 2124 .write = serial_console_write, 2125 .device = serial_console_device, 2126 .flags = CON_PRINTBUFFER, 2127 .index = -1, 2128}; 2129 2130/* 2131 * Register console. 2132 */ 2133static int __init amiserial_console_init(void) 2134{ 2135 register_console(&sercons); 2136 return 0; 2137} 2138console_initcall(amiserial_console_init); 2139#endif 2140 2141MODULE_LICENSE("GPL");