xref: /linux/include/uapi/linux/serial.h (revision 70f5376dbdefa675adec0800e9f21f20a0dc0cbd)
1 /* SPDX-License-Identifier: GPL-1.0+ WITH Linux-syscall-note */
2 /*
3  * include/linux/serial.h
4  *
5  * Copyright (C) 1992 by Theodore Ts'o.
6  *
7  * Redistribution of this file is permitted under the terms of the GNU
8  * Public License (GPL)
9  */
10 
11 #ifndef _UAPI_LINUX_SERIAL_H
12 #define _UAPI_LINUX_SERIAL_H
13 
14 #include <linux/const.h>
15 #include <linux/types.h>
16 
17 #include <linux/tty_flags.h>
18 
19 
20 struct serial_struct {
21 	int	type;
22 	int	line;
23 	unsigned int	port;
24 	int	irq;
25 	int	flags;
26 	int	xmit_fifo_size;
27 	int	custom_divisor;
28 	int	baud_base;
29 	unsigned short	close_delay;
30 	char	io_type;
31 	char	reserved_char[1];
32 	int	hub6;
33 	unsigned short	closing_wait; /* time to wait before closing */
34 	unsigned short	closing_wait2; /* no longer used... */
35 	unsigned char	*iomem_base;
36 	unsigned short	iomem_reg_shift;
37 	unsigned int	port_high;
38 	unsigned long	iomap_base;	/* cookie passed into ioremap */
39 };
40 
41 /*
42  * For the close wait times, 0 means wait forever for serial port to
43  * flush its output.  65535 means don't wait at all.
44  */
45 #define ASYNC_CLOSING_WAIT_INF	0
46 #define ASYNC_CLOSING_WAIT_NONE	65535
47 
48 /*
49  * These are the supported serial types.
50  */
51 #define PORT_UNKNOWN	0
52 #define PORT_8250	1
53 #define PORT_16450	2
54 #define PORT_16550	3
55 #define PORT_16550A	4
56 #define PORT_CIRRUS     5
57 #define PORT_16650	6
58 #define PORT_16650V2	7
59 #define PORT_16750	8
60 #define PORT_STARTECH	9
61 #define PORT_16C950	10	/* Oxford Semiconductor */
62 #define PORT_16654	11
63 #define PORT_16850	12
64 #define PORT_RSA	13	/* RSA-DV II/S card */
65 #define PORT_MAX	13
66 
67 #define SERIAL_IO_PORT	0
68 #define SERIAL_IO_HUB6	1
69 #define SERIAL_IO_MEM	2
70 #define SERIAL_IO_MEM32	  3
71 #define SERIAL_IO_AU	  4
72 #define SERIAL_IO_TSI	  5
73 #define SERIAL_IO_MEM32BE 6
74 #define SERIAL_IO_MEM16	7
75 #define SERIAL_IO_BUS	8
76 
77 #define UART_CLEAR_FIFO		0x01
78 #define UART_USE_FIFO		0x02
79 #define UART_STARTECH		0x04
80 #define UART_NATSEMI		0x08
81 
82 
83 /*
84  * Multiport serial configuration structure --- external structure
85  */
86 struct serial_multiport_struct {
87 	int		irq;
88 	int		port1;
89 	unsigned char	mask1, match1;
90 	int		port2;
91 	unsigned char	mask2, match2;
92 	int		port3;
93 	unsigned char	mask3, match3;
94 	int		port4;
95 	unsigned char	mask4, match4;
96 	int		port_monitor;
97 	int	reserved[32];
98 };
99 
100 /*
101  * Serial input interrupt line counters -- external structure
102  * Four lines can interrupt: CTS, DSR, RI, DCD
103  */
104 struct serial_icounter_struct {
105 	int cts, dsr, rng, dcd;
106 	int rx, tx;
107 	int frame, overrun, parity, brk;
108 	int buf_overrun;
109 	int reserved[9];
110 };
111 
112 /**
113  * struct serial_rs485 - serial interface for controlling RS485 settings.
114  * @flags:			RS485 feature flags.
115  * @delay_rts_before_send:	Delay before send (milliseconds).
116  * @delay_rts_after_send:	Delay after send (milliseconds).
117  * @addr_recv:			Receive filter for RS485 addressing mode
118  *				(used only when %SER_RS485_ADDR_RECV is set).
119  * @addr_dest:			Destination address for RS485 addressing mode
120  *				(used only when %SER_RS485_ADDR_DEST is set).
121  * @padding0:			Padding (set to zero).
122  * @padding1:			Padding (set to zero).
123  * @padding:			Deprecated, use @padding0 and @padding1 instead.
124  *				Do not use with @addr_recv and @addr_dest (due to
125  *				overlap).
126  *
127  * Serial interface for controlling RS485 settings on chips with suitable
128  * support. Set with TIOCSRS485 and get with TIOCGRS485 if supported by your
129  * platform. The set function returns the new state, with any unsupported bits
130  * reverted appropriately.
131  *
132  * The flag bits are:
133  *
134  * * %SER_RS485_ENABLED		- RS485 enabled.
135  * * %SER_RS485_RTS_ON_SEND	- Logical level for RTS pin when sending.
136  * * %SER_RS485_RTS_AFTER_SEND	- Logical level for RTS pin after sent.
137  * * %SER_RS485_RX_DURING_TX	- Full-duplex RS485 line.
138  * * %SER_RS485_TERMINATE_BUS	- Enable bus termination (if supported).
139  * * %SER_RS485_ADDRB		- Enable RS485 addressing mode.
140  * * %SER_RS485_ADDR_RECV - Receive address filter (enables @addr_recv). Requires %SER_RS485_ADDRB.
141  * * %SER_RS485_ADDR_DEST - Destination address (enables @addr_dest). Requires %SER_RS485_ADDRB.
142  * * %SER_RS485_MODE_RS422	- Enable RS422. Requires %SER_RS485_ENABLED.
143  */
144 struct serial_rs485 {
145 	__u32	flags;
146 #define SER_RS485_ENABLED		_BITUL(0)
147 #define SER_RS485_RTS_ON_SEND		_BITUL(1)
148 #define SER_RS485_RTS_AFTER_SEND	_BITUL(2)
149 /* Placeholder for bit 3: SER_RS485_RTS_BEFORE_SEND, which isn't used anymore */
150 #define SER_RS485_RX_DURING_TX		_BITUL(4)
151 #define SER_RS485_TERMINATE_BUS		_BITUL(5)
152 #define SER_RS485_ADDRB			_BITUL(6)
153 #define SER_RS485_ADDR_RECV		_BITUL(7)
154 #define SER_RS485_ADDR_DEST		_BITUL(8)
155 #define SER_RS485_MODE_RS422		_BITUL(9)
156 
157 	__u32	delay_rts_before_send;
158 	__u32	delay_rts_after_send;
159 
160 	/* The fields below are defined by flags */
161 	union {
162 		__u32	padding[5];		/* Memory is cheap, new structs are a pain */
163 
164 		struct {
165 			__u8	addr_recv;
166 			__u8	addr_dest;
167 			__u8	padding0[2];
168 			__u32	padding1[4];
169 		};
170 	};
171 };
172 
173 /*
174  * Serial interface for controlling ISO7816 settings on chips with suitable
175  * support. Set with TIOCSISO7816 and get with TIOCGISO7816 if supported by
176  * your platform.
177  */
178 struct serial_iso7816 {
179 	__u32	flags;			/* ISO7816 feature flags */
180 #define SER_ISO7816_ENABLED		(1 << 0)
181 #define SER_ISO7816_T_PARAM		(0x0f << 4)
182 #define SER_ISO7816_T(t)		(((t) & 0x0f) << 4)
183 	__u32	tg;
184 	__u32	sc_fi;
185 	__u32	sc_di;
186 	__u32	clk;
187 	__u32	reserved[5];
188 };
189 
190 #endif /* _UAPI_LINUX_SERIAL_H */
191