2 * linux/drivers/char/serial_core.h
4 * Copyright (C) 2000 Deep Blue Solutions Ltd.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #ifndef LINUX_SERIAL_CORE_H
21 #define LINUX_SERIAL_CORE_H
24 * The type definitions. These are from Ted Ts'o's serial.h
26 #define PORT_UNKNOWN 0
33 #define PORT_16650V2 7
35 #define PORT_STARTECH 9
36 #define PORT_16C950 10
40 #define PORT_NS16550A 14
41 #define PORT_XSCALE 15
42 #define PORT_MAX_8250 15 /* max port ID */
45 * ARM specific type numbers. These are not currently guaranteed
46 * to be implemented, and will change in the future. These are
47 * separate so any additions to the old serial.c that occur before
48 * we are merged can be easily merged here.
52 #define PORT_CLPS711X 33
53 #define PORT_SA1100 34
54 #define PORT_UART00 35
57 /* Sparc type numbers. */
58 #define PORT_SUNZILOG 38
59 #define PORT_SUNSAB 39
62 #define PORT_V850E_UART 40
67 /* Parisc type numbers. */
70 /* Macintosh Zilog type numbers */
71 #define PORT_MAC_ZILOG 50 /* m68k : not yet implemented */
72 #define PORT_PMAC_ZILOG 51
79 /* Samsung S3C2410 SoC and derivatives thereof */
80 #define PORT_S3C2410 55
82 /* SGI IP22 aka Indy / Challenge S / Indigo 2 */
83 #define PORT_IP22ZILOG 56
85 /* Sharp LH7a40x -- an ARM9 SoC series */
86 #define PORT_LH7A40X 57
88 /* PPC CPM type number */
91 /* MPC52xx type numbers */
92 #define PORT_MPC52xx 59
97 /* Samsung S3C2440 SoC */
98 #define PORT_S3C2440 61
100 /* Motorola i.MX SoC */
106 /* TXX9 type number */
109 /* NEC VR4100 series SIU/DSIU */
110 #define PORT_VR41XX_SIU 65
111 #define PORT_VR41XX_DSIU 66
113 /* Samsung S3C2400 SoC */
114 #define PORT_S3C2400 67
117 #define PORT_M32R_SIO 68
124 #include <linux/config.h>
125 #include <linux/compiler.h>
126 #include <linux/interrupt.h>
127 #include <linux/circ_buf.h>
128 #include <linux/spinlock.h>
129 #include <linux/sched.h>
130 #include <linux/tty.h>
134 struct serial_struct
;
138 * This structure describes all the operations that can be
139 * done on the physical hardware.
142 unsigned int (*tx_empty
)(struct uart_port
*);
143 void (*set_mctrl
)(struct uart_port
*, unsigned int mctrl
);
144 unsigned int (*get_mctrl
)(struct uart_port
*);
145 void (*stop_tx
)(struct uart_port
*);
146 void (*start_tx
)(struct uart_port
*);
147 void (*send_xchar
)(struct uart_port
*, char ch
);
148 void (*stop_rx
)(struct uart_port
*);
149 void (*enable_ms
)(struct uart_port
*);
150 void (*break_ctl
)(struct uart_port
*, int ctl
);
151 int (*startup
)(struct uart_port
*);
152 void (*shutdown
)(struct uart_port
*);
153 void (*set_termios
)(struct uart_port
*, struct termios
*new,
154 struct termios
*old
);
155 void (*pm
)(struct uart_port
*, unsigned int state
,
156 unsigned int oldstate
);
157 int (*set_wake
)(struct uart_port
*, unsigned int state
);
160 * Return a string describing the type of the port
162 const char *(*type
)(struct uart_port
*);
165 * Release IO and memory resources used by the port.
166 * This includes iounmap if necessary.
168 void (*release_port
)(struct uart_port
*);
171 * Request IO and memory resources used by the port.
172 * This includes iomapping the port if necessary.
174 int (*request_port
)(struct uart_port
*);
175 void (*config_port
)(struct uart_port
*, int);
176 int (*verify_port
)(struct uart_port
*, struct serial_struct
*);
177 int (*ioctl
)(struct uart_port
*, unsigned int, unsigned long);
180 #define UART_CONFIG_TYPE (1 << 0)
181 #define UART_CONFIG_IRQ (1 << 1)
198 spinlock_t lock
; /* port lock */
199 unsigned int iobase
; /* in/out[bwl] */
200 unsigned char __iomem
*membase
; /* read/write[bwl] */
201 unsigned int irq
; /* irq number */
202 unsigned int uartclk
; /* base uart clock */
203 unsigned char fifosize
; /* tx fifo size */
204 unsigned char x_char
; /* xon/xoff char */
205 unsigned char regshift
; /* reg offset shift */
206 unsigned char iotype
; /* io access style */
208 #define UPIO_PORT (0)
209 #define UPIO_HUB6 (1)
211 #define UPIO_MEM32 (3)
213 unsigned int read_status_mask
; /* driver specific */
214 unsigned int ignore_status_mask
; /* driver specific */
215 struct uart_info
*info
; /* pointer to parent info */
216 struct uart_icount icount
; /* statistics */
218 struct console
*cons
; /* struct console, if any */
219 #ifdef CONFIG_SERIAL_CORE_CONSOLE
220 unsigned long sysrq
; /* sysrq timeout */
225 #define UPF_FOURPORT (1 << 1)
226 #define UPF_SAK (1 << 2)
227 #define UPF_SPD_MASK (0x1030)
228 #define UPF_SPD_HI (0x0010)
229 #define UPF_SPD_VHI (0x0020)
230 #define UPF_SPD_CUST (0x0030)
231 #define UPF_SPD_SHI (0x1000)
232 #define UPF_SPD_WARP (0x1010)
233 #define UPF_SKIP_TEST (1 << 6)
234 #define UPF_AUTO_IRQ (1 << 7)
235 #define UPF_HARDPPS_CD (1 << 11)
236 #define UPF_LOW_LATENCY (1 << 13)
237 #define UPF_BUGGY_UART (1 << 14)
238 #define UPF_AUTOPROBE (1 << 15)
239 #define UPF_MAGIC_MULTIPLIER (1 << 16)
240 #define UPF_BOOT_ONLYMCA (1 << 22)
241 #define UPF_CONS_FLOW (1 << 23)
242 #define UPF_SHARE_IRQ (1 << 24)
243 #define UPF_BOOT_AUTOCONF (1 << 28)
244 #define UPF_IOREMAP (1 << 31)
246 #define UPF_CHANGE_MASK (0x17fff)
247 #define UPF_USR_MASK (UPF_SPD_MASK|UPF_LOW_LATENCY)
249 unsigned int mctrl
; /* current modem ctrl settings */
250 unsigned int timeout
; /* character-based timeout */
251 unsigned int type
; /* port type */
252 struct uart_ops
*ops
;
253 unsigned int custom_divisor
;
254 unsigned int line
; /* port index */
255 unsigned long mapbase
; /* for ioremap */
256 struct device
*dev
; /* parent device */
257 unsigned char hub6
; /* this should be in the 8250 driver */
258 unsigned char unused
[3];
262 * This is the state information which is persistent across opens.
263 * The low level driver must not to touch any elements contained
267 unsigned int close_delay
; /* msec */
268 unsigned int closing_wait
; /* msec */
270 #define USF_CLOSING_WAIT_INF (0)
271 #define USF_CLOSING_WAIT_NONE (~0U)
275 struct uart_info
*info
;
276 struct uart_port
*port
;
278 struct semaphore sem
;
281 #define UART_XMIT_SIZE PAGE_SIZE
283 * This is the state information which is only valid when the port
284 * is open; it may be freed by the core driver once the device has
285 * been closed. Either the low level driver or the core can modify
289 struct tty_struct
*tty
;
290 struct circ_buf xmit
;
294 * These are the flags that specific to info->flags, and reflect our
295 * internal state. They can not be accessed via port->flags. Low
296 * level drivers must not change these, but may query them instead.
298 #define UIF_CHECK_CD (1 << 25)
299 #define UIF_CTS_FLOW (1 << 26)
300 #define UIF_NORMAL_ACTIVE (1 << 29)
301 #define UIF_INITIALIZED (1 << 31)
305 struct tasklet_struct tlet
;
307 wait_queue_head_t open_wait
;
308 wait_queue_head_t delta_msr_wait
;
311 /* number of characters left in xmit buffer before we ask for more */
312 #define WAKEUP_CHARS 256
318 struct module
*owner
;
319 const char *driver_name
;
320 const char *dev_name
;
321 const char *devfs_name
;
325 struct console
*cons
;
328 * these are private; the low level driver should not
329 * touch these; they should be initialised to NULL
331 struct uart_state
*state
;
332 struct tty_driver
*tty_driver
;
335 void uart_write_wakeup(struct uart_port
*port
);
340 void uart_update_timeout(struct uart_port
*port
, unsigned int cflag
,
342 unsigned int uart_get_baud_rate(struct uart_port
*port
, struct termios
*termios
,
343 struct termios
*old
, unsigned int min
,
345 unsigned int uart_get_divisor(struct uart_port
*port
, unsigned int baud
);
350 struct uart_port
*uart_get_console(struct uart_port
*ports
, int nr
,
352 void uart_parse_options(char *options
, int *baud
, int *parity
, int *bits
,
354 int uart_set_options(struct uart_port
*port
, struct console
*co
, int baud
,
355 int parity
, int bits
, int flow
);
356 struct tty_driver
*uart_console_device(struct console
*co
, int *index
);
359 * Port/driver registration/removal
361 int uart_register_driver(struct uart_driver
*uart
);
362 void uart_unregister_driver(struct uart_driver
*uart
);
363 int uart_add_one_port(struct uart_driver
*reg
, struct uart_port
*port
);
364 int uart_remove_one_port(struct uart_driver
*reg
, struct uart_port
*port
);
365 int uart_match_port(struct uart_port
*port1
, struct uart_port
*port2
);
370 int uart_suspend_port(struct uart_driver
*reg
, struct uart_port
*port
);
371 int uart_resume_port(struct uart_driver
*reg
, struct uart_port
*port
);
373 #define uart_circ_empty(circ) ((circ)->head == (circ)->tail)
374 #define uart_circ_clear(circ) ((circ)->head = (circ)->tail = 0)
376 #define uart_circ_chars_pending(circ) \
377 (CIRC_CNT((circ)->head, (circ)->tail, UART_XMIT_SIZE))
379 #define uart_circ_chars_free(circ) \
380 (CIRC_SPACE((circ)->head, (circ)->tail, UART_XMIT_SIZE))
382 #define uart_tx_stopped(port) \
383 ((port)->info->tty->stopped || (port)->info->tty->hw_stopped)
386 * The following are helper functions for the low level drivers.
389 uart_handle_sysrq_char(struct uart_port
*port
, unsigned int ch
,
390 struct pt_regs
*regs
)
394 if (ch
&& time_before(jiffies
, port
->sysrq
)) {
395 handle_sysrq(ch
, regs
, NULL
);
406 * We do the SysRQ and SAK checking like this...
408 static inline int uart_handle_break(struct uart_port
*port
)
410 struct uart_info
*info
= port
->info
;
412 if (port
->cons
&& port
->cons
->index
== port
->line
) {
414 port
->sysrq
= jiffies
+ HZ
*5;
420 if (info
->flags
& UPF_SAK
)
426 * uart_handle_dcd_change - handle a change of carrier detect state
427 * @port: uart_port structure for the open port
428 * @status: new carrier detect status, nonzero if active
431 uart_handle_dcd_change(struct uart_port
*port
, unsigned int status
)
433 struct uart_info
*info
= port
->info
;
437 #ifdef CONFIG_HARD_PPS
438 if ((port
->flags
& UPF_HARDPPS_CD
) && status
)
442 if (info
->flags
& UIF_CHECK_CD
) {
444 wake_up_interruptible(&info
->open_wait
);
446 tty_hangup(info
->tty
);
451 * uart_handle_cts_change - handle a change of clear-to-send state
452 * @port: uart_port structure for the open port
453 * @status: new clear to send status, nonzero if active
456 uart_handle_cts_change(struct uart_port
*port
, unsigned int status
)
458 struct uart_info
*info
= port
->info
;
459 struct tty_struct
*tty
= info
->tty
;
463 if (info
->flags
& UIF_CTS_FLOW
) {
464 if (tty
->hw_stopped
) {
467 port
->ops
->start_tx(port
);
468 uart_write_wakeup(port
);
473 port
->ops
->stop_tx(port
);
479 #include <linux/tty_flip.h>
482 uart_insert_char(struct uart_port
*port
, unsigned int status
,
483 unsigned int overrun
, unsigned int ch
, unsigned int flag
)
485 struct tty_struct
*tty
= port
->info
->tty
;
487 if ((status
& port
->ignore_status_mask
& ~overrun
) == 0)
488 tty_insert_flip_char(tty
, ch
, flag
);
491 * Overrun is special. Since it's reported immediately,
492 * it doesn't affect the current character.
494 if (status
& ~port
->ignore_status_mask
& overrun
)
495 tty_insert_flip_char(tty
, 0, TTY_OVERRUN
);
499 * UART_ENABLE_MS - determine if port should enable modem status irqs
501 #define UART_ENABLE_MS(port,cflag) ((port)->flags & UPF_HARDPPS_CD || \
502 (cflag) & CRTSCTS || \
507 #endif /* LINUX_SERIAL_CORE_H */