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__
219struct amba_device; /* in uncompress this is included but amba/bus.h is not */
220struct amba_pl010_data {
221 void (*set_mctrl)(struct amba_device *dev, void __iomem *base, unsigned int mctrl);
222};
223
224struct dma_chan;
225struct 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

source code of linux/include/linux/amba/serial.h