xref: /linux/include/linux/amba/serial.h (revision 24b10e5f8e0d2bee1a10fc67011ea5d936c1a389)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  *  linux/include/asm-arm/hardware/serial_amba.h
4  *
5  *  Internal header file for AMBA serial ports
6  *
7  *  Copyright (C) ARM Limited
8  *  Copyright (C) 2000 Deep Blue Solutions Ltd.
9  */
10 #ifndef ASM_ARM_HARDWARE_SERIAL_AMBA_H
11 #define ASM_ARM_HARDWARE_SERIAL_AMBA_H
12 
13 #ifndef __ASSEMBLY__
14 #include <linux/bitfield.h>
15 #include <linux/bits.h>
16 #endif
17 
18 #include <linux/types.h>
19 
20 /* -------------------------------------------------------------------------------
21  *  From AMBA UART (PL010) Block Specification
22  * -------------------------------------------------------------------------------
23  *  UART Register Offsets.
24  */
25 #define UART01x_DR		0x00	/* Data read or written from the interface. */
26 #define UART01x_RSR		0x04	/* Receive status register (Read). */
27 #define UART01x_ECR		0x04	/* Error clear register (Write). */
28 #define UART010_LCRH		0x08	/* Line control register, high byte. */
29 #define ST_UART011_DMAWM	0x08    /* DMA watermark configure register. */
30 #define UART010_LCRM		0x0C	/* Line control register, middle byte. */
31 #define ST_UART011_TIMEOUT	0x0C    /* Timeout period register. */
32 #define UART010_LCRL		0x10	/* Line control register, low byte. */
33 #define UART010_CR		0x14	/* Control register. */
34 #define UART01x_FR		0x18	/* Flag register (Read only). */
35 #define UART010_IIR		0x1C	/* Interrupt identification register (Read). */
36 #define UART010_ICR		0x1C	/* Interrupt clear register (Write). */
37 #define ST_UART011_LCRH_RX	0x1C    /* Rx line control register. */
38 #define UART01x_ILPR		0x20	/* IrDA low power counter register. */
39 #define UART011_IBRD		0x24	/* Integer baud rate divisor register. */
40 #define UART011_FBRD		0x28	/* Fractional baud rate divisor register. */
41 #define UART011_LCRH		0x2c	/* Line control register. */
42 #define ST_UART011_LCRH_TX	0x2c    /* Tx Line control register. */
43 #define UART011_CR		0x30	/* Control register. */
44 #define UART011_IFLS		0x34	/* Interrupt fifo level select. */
45 #define UART011_IMSC		0x38	/* Interrupt mask. */
46 #define UART011_RIS		0x3c	/* Raw interrupt status. */
47 #define UART011_MIS		0x40	/* Masked interrupt status. */
48 #define UART011_ICR		0x44	/* Interrupt clear register. */
49 #define UART011_DMACR		0x48	/* DMA control register. */
50 #define ST_UART011_XFCR		0x50	/* XON/XOFF control register. */
51 #define ST_UART011_XON1		0x54	/* XON1 register. */
52 #define ST_UART011_XON2		0x58	/* XON2 register. */
53 #define ST_UART011_XOFF1	0x5C	/* XON1 register. */
54 #define ST_UART011_XOFF2	0x60	/* XON2 register. */
55 #define ST_UART011_ITCR		0x80	/* Integration test control register. */
56 #define ST_UART011_ITIP		0x84	/* Integration test input register. */
57 #define ST_UART011_ABCR		0x100	/* Autobaud control register. */
58 #define ST_UART011_ABIMSC	0x15C	/* Autobaud interrupt mask/clear register. */
59 
60 /*
61  * ZTE UART register offsets.  This UART has a radically different address
62  * allocation from the ARM and ST variants, so we list all registers here.
63  * We assume unlisted registers do not exist.
64  */
65 #define ZX_UART011_DR		0x04
66 #define ZX_UART011_FR		0x14
67 #define ZX_UART011_IBRD		0x24
68 #define ZX_UART011_FBRD		0x28
69 #define ZX_UART011_LCRH		0x30
70 #define ZX_UART011_CR		0x34
71 #define ZX_UART011_IFLS		0x38
72 #define ZX_UART011_IMSC		0x40
73 #define ZX_UART011_RIS		0x44
74 #define ZX_UART011_MIS		0x48
75 #define ZX_UART011_ICR		0x4c
76 #define ZX_UART011_DMACR	0x50
77 
78 #define UART011_DR_OE		BIT(11)
79 #define UART011_DR_BE		BIT(10)
80 #define UART011_DR_PE		BIT(9)
81 #define UART011_DR_FE		BIT(8)
82 
83 #define UART01x_RSR_OE		BIT(3)
84 #define UART01x_RSR_BE		BIT(2)
85 #define UART01x_RSR_PE		BIT(1)
86 #define UART01x_RSR_FE		BIT(0)
87 
88 #define UART011_FR_RI		BIT(8)
89 #define UART011_FR_TXFE		BIT(7)
90 #define UART011_FR_RXFF		BIT(6)
91 #define UART01x_FR_TXFF		(1 << 5)	/* used in ASM */
92 #define UART01x_FR_RXFE		BIT(4)
93 #define UART01x_FR_BUSY		(1 << 3)	/* used in ASM */
94 #define UART01x_FR_DCD		BIT(2)
95 #define UART01x_FR_DSR		BIT(1)
96 #define UART01x_FR_CTS		BIT(0)
97 #define UART01x_FR_TMSK		(UART01x_FR_TXFF + UART01x_FR_BUSY)
98 
99 /*
100  * Some bits of Flag Register on ZTE device have different position from
101  * standard ones.
102  */
103 #define ZX_UART01x_FR_BUSY	BIT(8)
104 #define ZX_UART01x_FR_DSR	BIT(3)
105 #define ZX_UART01x_FR_CTS	BIT(1)
106 #define ZX_UART011_FR_RI	BIT(0)
107 
108 #define UART011_CR_CTSEN	BIT(15)	/* CTS hardware flow control */
109 #define UART011_CR_RTSEN	BIT(14)	/* RTS hardware flow control */
110 #define UART011_CR_OUT2		BIT(13)	/* OUT2 */
111 #define UART011_CR_OUT1		BIT(12)	/* OUT1 */
112 #define UART011_CR_RTS		BIT(11)	/* RTS */
113 #define UART011_CR_DTR		BIT(10)	/* DTR */
114 #define UART011_CR_RXE		BIT(9)	/* receive enable */
115 #define UART011_CR_TXE		BIT(8)	/* transmit enable */
116 #define UART011_CR_LBE		BIT(7)	/* loopback enable */
117 #define UART010_CR_RTIE		BIT(6)
118 #define UART010_CR_TIE		BIT(5)
119 #define UART010_CR_RIE		BIT(4)
120 #define UART010_CR_MSIE		BIT(3)
121 #define ST_UART011_CR_OVSFACT	BIT(3)	/* Oversampling factor */
122 #define UART01x_CR_IIRLP	BIT(2)	/* SIR low power mode */
123 #define UART01x_CR_SIREN	BIT(1)	/* SIR enable */
124 #define UART01x_CR_UARTEN	BIT(0)	/* UART enable */
125 
126 #define UART011_LCRH_SPS	BIT(7)
127 #define UART01x_LCRH_WLEN_8	0x60
128 #define UART01x_LCRH_WLEN_7	0x40
129 #define UART01x_LCRH_WLEN_6	0x20
130 #define UART01x_LCRH_WLEN_5	0x00
131 #define UART01x_LCRH_FEN	BIT(4)
132 #define UART01x_LCRH_STP2	BIT(3)
133 #define UART01x_LCRH_EPS	BIT(2)
134 #define UART01x_LCRH_PEN	BIT(1)
135 #define UART01x_LCRH_BRK	BIT(0)
136 
137 #define ST_UART011_DMAWM_RX	GENMASK(5, 3)
138 #define ST_UART011_DMAWM_RX_1	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 0)
139 #define ST_UART011_DMAWM_RX_2	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 1)
140 #define ST_UART011_DMAWM_RX_4	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 2)
141 #define ST_UART011_DMAWM_RX_8	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 3)
142 #define ST_UART011_DMAWM_RX_16	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 4)
143 #define ST_UART011_DMAWM_RX_32	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 5)
144 #define ST_UART011_DMAWM_RX_48	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 6)
145 #define ST_UART011_DMAWM_TX	GENMASK(2, 0)
146 #define ST_UART011_DMAWM_TX_1	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 0)
147 #define ST_UART011_DMAWM_TX_2	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 1)
148 #define ST_UART011_DMAWM_TX_4	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 2)
149 #define ST_UART011_DMAWM_TX_8	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 3)
150 #define ST_UART011_DMAWM_TX_16	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 4)
151 #define ST_UART011_DMAWM_TX_32	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 5)
152 #define ST_UART011_DMAWM_TX_48	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 6)
153 
154 #define UART010_IIR_RTIS	BIT(3)
155 #define UART010_IIR_TIS		BIT(2)
156 #define UART010_IIR_RIS		BIT(1)
157 #define UART010_IIR_MIS		BIT(0)
158 
159 #define UART011_IFLS_RXIFLSEL	GENMASK(5, 3)
160 #define UART011_IFLS_RX1_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 0)
161 #define UART011_IFLS_RX2_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 1)
162 #define UART011_IFLS_RX4_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 2)
163 #define UART011_IFLS_RX6_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 3)
164 #define UART011_IFLS_RX7_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 4)
165 #define UART011_IFLS_TXIFLSEL	GENMASK(2, 0)
166 #define UART011_IFLS_TX1_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 0)
167 #define UART011_IFLS_TX2_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 1)
168 #define UART011_IFLS_TX4_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 2)
169 #define UART011_IFLS_TX6_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 3)
170 #define UART011_IFLS_TX7_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 4)
171 /* special values for ST vendor with deeper fifo */
172 #define UART011_IFLS_RX_HALF	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 5)
173 #define UART011_IFLS_TX_HALF	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 5)
174 
175 #define UART011_OEIM		BIT(10)	/* overrun error interrupt mask */
176 #define UART011_BEIM		BIT(9)	/* break error interrupt mask */
177 #define UART011_PEIM		BIT(8)	/* parity error interrupt mask */
178 #define UART011_FEIM		BIT(7)	/* framing error interrupt mask */
179 #define UART011_RTIM		BIT(6)	/* receive timeout interrupt mask */
180 #define UART011_TXIM		BIT(5)	/* transmit interrupt mask */
181 #define UART011_RXIM		BIT(4)	/* receive interrupt mask */
182 #define UART011_DSRMIM		BIT(3)	/* DSR interrupt mask */
183 #define UART011_DCDMIM		BIT(2)	/* DCD interrupt mask */
184 #define UART011_CTSMIM		BIT(1)	/* CTS interrupt mask */
185 #define UART011_RIMIM		BIT(0)	/* RI interrupt mask */
186 
187 #define UART011_OEIS		BIT(10)	/* overrun error interrupt status */
188 #define UART011_BEIS		BIT(9)	/* break error interrupt status */
189 #define UART011_PEIS		BIT(8)	/* parity error interrupt status */
190 #define UART011_FEIS		BIT(7)	/* framing error interrupt status */
191 #define UART011_RTIS		BIT(6)	/* receive timeout interrupt status */
192 #define UART011_TXIS		BIT(5)	/* transmit interrupt status */
193 #define UART011_RXIS		BIT(4)	/* receive interrupt status */
194 #define UART011_DSRMIS		BIT(3)	/* DSR interrupt status */
195 #define UART011_DCDMIS		BIT(2)	/* DCD interrupt status */
196 #define UART011_CTSMIS		BIT(1)	/* CTS interrupt status */
197 #define UART011_RIMIS		BIT(0)	/* RI interrupt status */
198 
199 #define UART011_OEIC		BIT(10)	/* overrun error interrupt clear */
200 #define UART011_BEIC		BIT(9)	/* break error interrupt clear */
201 #define UART011_PEIC		BIT(8)	/* parity error interrupt clear */
202 #define UART011_FEIC		BIT(7)	/* framing error interrupt clear */
203 #define UART011_RTIC		BIT(6)	/* receive timeout interrupt clear */
204 #define UART011_TXIC		BIT(5)	/* transmit interrupt clear */
205 #define UART011_RXIC		BIT(4)	/* receive interrupt clear */
206 #define UART011_DSRMIC		BIT(3)	/* DSR interrupt clear */
207 #define UART011_DCDMIC		BIT(2)	/* DCD interrupt clear */
208 #define UART011_CTSMIC		BIT(1)	/* CTS interrupt clear */
209 #define UART011_RIMIC		BIT(0)	/* RI interrupt clear */
210 
211 #define UART011_DMAONERR	BIT(2)	/* disable dma on error */
212 #define UART011_TXDMAE		BIT(1)	/* enable transmit dma */
213 #define UART011_RXDMAE		BIT(0)	/* enable receive dma */
214 
215 #define UART01x_RSR_ANY		(UART01x_RSR_OE | UART01x_RSR_BE | UART01x_RSR_PE | UART01x_RSR_FE)
216 #define UART01x_FR_MODEM_ANY	(UART01x_FR_DCD | UART01x_FR_DSR | UART01x_FR_CTS)
217 
218 #ifndef __ASSEMBLY__
219 struct amba_device; /* in uncompress this is included but amba/bus.h is not */
220 struct amba_pl010_data {
221 	void (*set_mctrl)(struct amba_device *dev, void __iomem *base, unsigned int mctrl);
222 };
223 
224 struct dma_chan;
225 struct amba_pl011_data {
226 	bool (*dma_filter)(struct dma_chan *chan, void *filter_param);
227 	void *dma_rx_param;
228 	void *dma_tx_param;
229 	bool dma_rx_poll_enable;
230 	unsigned int dma_rx_poll_rate;
231 	unsigned int dma_rx_poll_timeout;
232 	void (*init)(void);
233 	void (*exit)(void);
234 };
235 #endif
236 
237 #endif
238