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