linux/include/linux/amba/serial.h

/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 *  linux/include/asm-arm/hardware/serial_amba.h
 *
 *  Internal header file for AMBA serial ports
 *
 *  Copyright (C) ARM Limited
 *  Copyright (C) 2000 Deep Blue Solutions Ltd.
 */
#ifndef ASM_ARM_HARDWARE_SERIAL_AMBA_H
#define ASM_ARM_HARDWARE_SERIAL_AMBA_H

#ifndef __ASSEMBLY__
#include <linux/bitfield.h>
#include <linux/bits.h>
#endif

#include <linux/types.h>

/* -------------------------------------------------------------------------------
 *  From AMBA UART (PL010) Block Specification
 * -------------------------------------------------------------------------------
 *  UART Register Offsets.
 */
#define UART01x_DR		0x00	/* Data read or written from the interface. */
#define UART01x_RSR		0x04	/* Receive status register (Read). */
#define UART01x_ECR		0x04	/* Error clear register (Write). */
#define UART010_LCRH		0x08	/* Line control register, high byte. */
#define ST_UART011_DMAWM	0x08    /* DMA watermark configure register. */
#define UART010_LCRM		0x0C	/* Line control register, middle byte. */
#define ST_UART011_TIMEOUT	0x0C    /* Timeout period register. */
#define UART010_LCRL		0x10	/* Line control register, low byte. */
#define UART010_CR		0x14	/* Control register. */
#define UART01x_FR		0x18	/* Flag register (Read only). */
#define UART010_IIR		0x1C	/* Interrupt identification register (Read). */
#define UART010_ICR		0x1C	/* Interrupt clear register (Write). */
#define ST_UART011_LCRH_RX	0x1C    /* Rx line control register. */
#define UART01x_ILPR		0x20	/* IrDA low power counter register. */
#define UART011_IBRD		0x24	/* Integer baud rate divisor register. */
#define UART011_FBRD		0x28	/* Fractional baud rate divisor register. */
#define UART011_LCRH		0x2c	/* Line control register. */
#define ST_UART011_LCRH_TX	0x2c    /* Tx Line control register. */
#define UART011_CR		0x30	/* Control register. */
#define UART011_IFLS		0x34	/* Interrupt fifo level select. */
#define UART011_IMSC		0x38	/* Interrupt mask. */
#define UART011_RIS		0x3c	/* Raw interrupt status. */
#define UART011_MIS		0x40	/* Masked interrupt status. */
#define UART011_ICR		0x44	/* Interrupt clear register. */
#define UART011_DMACR		0x48	/* DMA control register. */
#define ST_UART011_XFCR		0x50	/* XON/XOFF control register. */
#define ST_UART011_XON1		0x54	/* XON1 register. */
#define ST_UART011_XON2		0x58	/* XON2 register. */
#define ST_UART011_XOFF1	0x5C	/* XON1 register. */
#define ST_UART011_XOFF2	0x60	/* XON2 register. */
#define ST_UART011_ITCR		0x80	/* Integration test control register. */
#define ST_UART011_ITIP		0x84	/* Integration test input register. */
#define ST_UART011_ABCR		0x100	/* Autobaud control register. */
#define ST_UART011_ABIMSC	0x15C	/* Autobaud interrupt mask/clear register. */

/*
 * ZTE UART register offsets.  This UART has a radically different address
 * allocation from the ARM and ST variants, so we list all registers here.
 * We assume unlisted registers do not exist.
 */
#define ZX_UART011_DR		0x04
#define ZX_UART011_FR		0x14
#define ZX_UART011_IBRD		0x24
#define ZX_UART011_FBRD		0x28
#define ZX_UART011_LCRH		0x30
#define ZX_UART011_CR		0x34
#define ZX_UART011_IFLS		0x38
#define ZX_UART011_IMSC		0x40
#define ZX_UART011_RIS		0x44
#define ZX_UART011_MIS		0x48
#define ZX_UART011_ICR		0x4c
#define ZX_UART011_DMACR	0x50

#define UART011_DR_OE		BIT(11)
#define UART011_DR_BE		BIT(10)
#define UART011_DR_PE		BIT(9)
#define UART011_DR_FE		BIT(8)

#define UART01x_RSR_OE		BIT(3)
#define UART01x_RSR_BE		BIT(2)
#define UART01x_RSR_PE		BIT(1)
#define UART01x_RSR_FE		BIT(0)

#define UART011_FR_RI		BIT(8)
#define UART011_FR_TXFE		BIT(7)
#define UART011_FR_RXFF		BIT(6)
#define UART01x_FR_TXFF		(1 << 5)	/* used in ASM */
#define UART01x_FR_RXFE		BIT(4)
#define UART01x_FR_BUSY		(1 << 3)	/* used in ASM */
#define UART01x_FR_DCD		BIT(2)
#define UART01x_FR_DSR		BIT(1)
#define UART01x_FR_CTS		BIT(0)
#define UART01x_FR_TMSK		(UART01x_FR_TXFF + UART01x_FR_BUSY)

/*
 * Some bits of Flag Register on ZTE device have different position from
 * standard ones.
 */
#define ZX_UART01x_FR_BUSY	BIT(8)
#define ZX_UART01x_FR_DSR	BIT(3)
#define ZX_UART01x_FR_CTS	BIT(1)
#define ZX_UART011_FR_RI	BIT(0)

#define UART011_CR_CTSEN	BIT(15)	/* CTS hardware flow control */
#define UART011_CR_RTSEN	BIT(14)	/* RTS hardware flow control */
#define UART011_CR_OUT2		BIT(13)	/* OUT2 */
#define UART011_CR_OUT1		BIT(12)	/* OUT1 */
#define UART011_CR_RTS		BIT(11)	/* RTS */
#define UART011_CR_DTR		BIT(10)	/* DTR */
#define UART011_CR_RXE		BIT(9)	/* receive enable */
#define UART011_CR_TXE		BIT(8)	/* transmit enable */
#define UART011_CR_LBE		BIT(7)	/* loopback enable */
#define UART010_CR_RTIE		BIT(6)
#define UART010_CR_TIE		BIT(5)
#define UART010_CR_RIE		BIT(4)
#define UART010_CR_MSIE		BIT(3)
#define ST_UART011_CR_OVSFACT	BIT(3)	/* Oversampling factor */
#define UART01x_CR_IIRLP	BIT(2)	/* SIR low power mode */
#define UART01x_CR_SIREN	BIT(1)	/* SIR enable */
#define UART01x_CR_UARTEN	BIT(0)	/* UART enable */

#define UART011_LCRH_SPS	BIT(7)
#define UART01x_LCRH_WLEN_8	0x60
#define UART01x_LCRH_WLEN_7	0x40
#define UART01x_LCRH_WLEN_6	0x20
#define UART01x_LCRH_WLEN_5	0x00
#define UART01x_LCRH_FEN	BIT(4)
#define UART01x_LCRH_STP2	BIT(3)
#define UART01x_LCRH_EPS	BIT(2)
#define UART01x_LCRH_PEN	BIT(1)
#define UART01x_LCRH_BRK	BIT(0)

#define ST_UART011_DMAWM_RX	GENMASK(5, 3)
#define ST_UART011_DMAWM_RX_1	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 0)
#define ST_UART011_DMAWM_RX_2	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 1)
#define ST_UART011_DMAWM_RX_4	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 2)
#define ST_UART011_DMAWM_RX_8	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 3)
#define ST_UART011_DMAWM_RX_16	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 4)
#define ST_UART011_DMAWM_RX_32	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 5)
#define ST_UART011_DMAWM_RX_48	FIELD_PREP_CONST(ST_UART011_DMAWM_RX, 6)
#define ST_UART011_DMAWM_TX	GENMASK(2, 0)
#define ST_UART011_DMAWM_TX_1	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 0)
#define ST_UART011_DMAWM_TX_2	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 1)
#define ST_UART011_DMAWM_TX_4	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 2)
#define ST_UART011_DMAWM_TX_8	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 3)
#define ST_UART011_DMAWM_TX_16	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 4)
#define ST_UART011_DMAWM_TX_32	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 5)
#define ST_UART011_DMAWM_TX_48	FIELD_PREP_CONST(ST_UART011_DMAWM_TX, 6)

#define UART010_IIR_RTIS	BIT(3)
#define UART010_IIR_TIS		BIT(2)
#define UART010_IIR_RIS		BIT(1)
#define UART010_IIR_MIS		BIT(0)

#define UART011_IFLS_RXIFLSEL	GENMASK(5, 3)
#define UART011_IFLS_RX1_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 0)
#define UART011_IFLS_RX2_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 1)
#define UART011_IFLS_RX4_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 2)
#define UART011_IFLS_RX6_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 3)
#define UART011_IFLS_RX7_8	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 4)
#define UART011_IFLS_TXIFLSEL	GENMASK(2, 0)
#define UART011_IFLS_TX1_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 0)
#define UART011_IFLS_TX2_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 1)
#define UART011_IFLS_TX4_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 2)
#define UART011_IFLS_TX6_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 3)
#define UART011_IFLS_TX7_8	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 4)
/* special values for ST vendor with deeper fifo */
#define UART011_IFLS_RX_HALF	FIELD_PREP_CONST(UART011_IFLS_RXIFLSEL, 5)
#define UART011_IFLS_TX_HALF	FIELD_PREP_CONST(UART011_IFLS_TXIFLSEL, 5)

#define UART011_OEIM		BIT(10)	/* overrun error interrupt mask */
#define UART011_BEIM		BIT(9)	/* break error interrupt mask */
#define UART011_PEIM		BIT(8)	/* parity error interrupt mask */
#define UART011_FEIM		BIT(7)	/* framing error interrupt mask */
#define UART011_RTIM		BIT(6)	/* receive timeout interrupt mask */
#define UART011_TXIM		BIT(5)	/* transmit interrupt mask */
#define UART011_RXIM		BIT(4)	/* receive interrupt mask */
#define UART011_DSRMIM		BIT(3)	/* DSR interrupt mask */
#define UART011_DCDMIM		BIT(2)	/* DCD interrupt mask */
#define UART011_CTSMIM		BIT(1)	/* CTS interrupt mask */
#define UART011_RIMIM		BIT(0)	/* RI interrupt mask */

#define UART011_OEIS		BIT(10)	/* overrun error interrupt status */
#define UART011_BEIS		BIT(9)	/* break error interrupt status */
#define UART011_PEIS		BIT(8)	/* parity error interrupt status */
#define UART011_FEIS		BIT(7)	/* framing error interrupt status */
#define UART011_RTIS		BIT(6)	/* receive timeout interrupt status */
#define UART011_TXIS		BIT(5)	/* transmit interrupt status */
#define UART011_RXIS		BIT(4)	/* receive interrupt status */
#define UART011_DSRMIS		BIT(3)	/* DSR interrupt status */
#define UART011_DCDMIS		BIT(2)	/* DCD interrupt status */
#define UART011_CTSMIS		BIT(1)	/* CTS interrupt status */
#define UART011_RIMIS		BIT(0)	/* RI interrupt status */

#define UART011_OEIC		BIT(10)	/* overrun error interrupt clear */
#define UART011_BEIC		BIT(9)	/* break error interrupt clear */
#define UART011_PEIC		BIT(8)	/* parity error interrupt clear */
#define UART011_FEIC		BIT(7)	/* framing error interrupt clear */
#define UART011_RTIC		BIT(6)	/* receive timeout interrupt clear */
#define UART011_TXIC		BIT(5)	/* transmit interrupt clear */
#define UART011_RXIC		BIT(4)	/* receive interrupt clear */
#define UART011_DSRMIC		BIT(3)	/* DSR interrupt clear */
#define UART011_DCDMIC		BIT(2)	/* DCD interrupt clear */
#define UART011_CTSMIC		BIT(1)	/* CTS interrupt clear */
#define UART011_RIMIC		BIT(0)	/* RI interrupt clear */

#define UART011_DMAONERR	BIT(2)	/* disable dma on error */
#define UART011_TXDMAE		BIT(1)	/* enable transmit dma */
#define UART011_RXDMAE		BIT(0)	/* enable receive dma */

#define UART01x_RSR_ANY		(UART01x_RSR_OE | UART01x_RSR_BE | UART01x_RSR_PE | UART01x_RSR_FE)
#define UART01x_FR_MODEM_ANY	(UART01x_FR_DCD | UART01x_FR_DSR | UART01x_FR_CTS)

#ifndef __ASSEMBLY__
struct amba_device; /* in uncompress this is included but amba/bus.h is not */
struct amba_pl010_data {
	void (*set_mctrl)(struct amba_device *dev, void __iomem *base, unsigned int mctrl);
};

struct dma_chan;
struct amba_pl011_data {
	bool (*dma_filter)(struct dma_chan *chan, void *filter_param);
	void *dma_rx_param;
	void *dma_tx_param;
	bool dma_rx_poll_enable;
	unsigned int dma_rx_poll_rate;
	unsigned int dma_rx_poll_timeout;
	void (*init)(void);
	void (*exit)(void);
};
#endif

#endif