xref: /openbmc/u-boot/include/ns16550.h (revision 1e52fea3)
1 /*
2  * NS16550 Serial Port
3  * originally from linux source (arch/powerpc/boot/ns16550.h)
4  *
5  * Cleanup and unification
6  * (C) 2009 by Detlev Zundel, DENX Software Engineering GmbH
7  *
8  * modified slightly to
9  * have addresses as offsets from CONFIG_SYS_ISA_BASE
10  * added a few more definitions
11  * added prototypes for ns16550.c
12  * reduced no of com ports to 2
13  * modifications (c) Rob Taylor, Flying Pig Systems. 2000.
14  *
15  * added support for port on 64-bit bus
16  * by Richard Danter (richard.danter@windriver.com), (C) 2005 Wind River Systems
17  */
18 
19 /*
20  * Note that the following macro magic uses the fact that the compiler
21  * will not allocate storage for arrays of size 0
22  */
23 
24 #include <linux/types.h>
25 
26 #if !defined(CONFIG_SYS_NS16550_REG_SIZE) || (CONFIG_SYS_NS16550_REG_SIZE == 0)
27 #error "Please define NS16550 registers size."
28 #elif defined(CONFIG_SYS_NS16550_MEM32)
29 #define UART_REG(x) u32 x
30 #elif (CONFIG_SYS_NS16550_REG_SIZE > 0)
31 #define UART_REG(x)						   \
32 	unsigned char prepad_##x[CONFIG_SYS_NS16550_REG_SIZE - 1]; \
33 	unsigned char x;
34 #elif (CONFIG_SYS_NS16550_REG_SIZE < 0)
35 #define UART_REG(x)							\
36 	unsigned char x;						\
37 	unsigned char postpad_##x[-CONFIG_SYS_NS16550_REG_SIZE - 1];
38 #endif
39 
40 struct NS16550 {
41 	UART_REG(rbr);		/* 0 */
42 	UART_REG(ier);		/* 1 */
43 	UART_REG(fcr);		/* 2 */
44 	UART_REG(lcr);		/* 3 */
45 	UART_REG(mcr);		/* 4 */
46 	UART_REG(lsr);		/* 5 */
47 	UART_REG(msr);		/* 6 */
48 	UART_REG(spr);		/* 7 */
49 	UART_REG(mdr1);		/* 8 */
50 	UART_REG(reg9);		/* 9 */
51 	UART_REG(regA);		/* A */
52 	UART_REG(regB);		/* B */
53 	UART_REG(regC);		/* C */
54 	UART_REG(regD);		/* D */
55 	UART_REG(regE);		/* E */
56 	UART_REG(uasr);		/* F */
57 	UART_REG(scr);		/* 10*/
58 	UART_REG(ssr);		/* 11*/
59 	UART_REG(reg12);	/* 12*/
60 	UART_REG(osc_12m_sel);	/* 13*/
61 };
62 
63 #define thr rbr
64 #define iir fcr
65 #define dll rbr
66 #define dlm ier
67 
68 typedef struct NS16550 *NS16550_t;
69 
70 /*
71  * These are the definitions for the FIFO Control Register
72  */
73 #define UART_FCR_FIFO_EN	0x01 /* Fifo enable */
74 #define UART_FCR_CLEAR_RCVR	0x02 /* Clear the RCVR FIFO */
75 #define UART_FCR_CLEAR_XMIT	0x04 /* Clear the XMIT FIFO */
76 #define UART_FCR_DMA_SELECT	0x08 /* For DMA applications */
77 #define UART_FCR_TRIGGER_MASK	0xC0 /* Mask for the FIFO trigger range */
78 #define UART_FCR_TRIGGER_1	0x00 /* Mask for trigger set at 1 */
79 #define UART_FCR_TRIGGER_4	0x40 /* Mask for trigger set at 4 */
80 #define UART_FCR_TRIGGER_8	0x80 /* Mask for trigger set at 8 */
81 #define UART_FCR_TRIGGER_14	0xC0 /* Mask for trigger set at 14 */
82 
83 #define UART_FCR_RXSR		0x02 /* Receiver soft reset */
84 #define UART_FCR_TXSR		0x04 /* Transmitter soft reset */
85 
86 /*
87  * These are the definitions for the Modem Control Register
88  */
89 #define UART_MCR_DTR	0x01		/* DTR   */
90 #define UART_MCR_RTS	0x02		/* RTS   */
91 #define UART_MCR_OUT1	0x04		/* Out 1 */
92 #define UART_MCR_OUT2	0x08		/* Out 2 */
93 #define UART_MCR_LOOP	0x10		/* Enable loopback test mode */
94 
95 #define UART_MCR_DMA_EN	0x04
96 #define UART_MCR_TX_DFR	0x08
97 
98 /*
99  * These are the definitions for the Line Control Register
100  *
101  * Note: if the word length is 5 bits (UART_LCR_WLEN5), then setting
102  * UART_LCR_STOP will select 1.5 stop bits, not 2 stop bits.
103  */
104 #define UART_LCR_WLS_MSK 0x03		/* character length select mask */
105 #define UART_LCR_WLS_5	0x00		/* 5 bit character length */
106 #define UART_LCR_WLS_6	0x01		/* 6 bit character length */
107 #define UART_LCR_WLS_7	0x02		/* 7 bit character length */
108 #define UART_LCR_WLS_8	0x03		/* 8 bit character length */
109 #define UART_LCR_STB	0x04		/* # stop Bits, off=1, on=1.5 or 2) */
110 #define UART_LCR_PEN	0x08		/* Parity eneble */
111 #define UART_LCR_EPS	0x10		/* Even Parity Select */
112 #define UART_LCR_STKP	0x20		/* Stick Parity */
113 #define UART_LCR_SBRK	0x40		/* Set Break */
114 #define UART_LCR_BKSE	0x80		/* Bank select enable */
115 #define UART_LCR_DLAB	0x80		/* Divisor latch access bit */
116 
117 /*
118  * These are the definitions for the Line Status Register
119  */
120 #define UART_LSR_DR	0x01		/* Data ready */
121 #define UART_LSR_OE	0x02		/* Overrun */
122 #define UART_LSR_PE	0x04		/* Parity error */
123 #define UART_LSR_FE	0x08		/* Framing error */
124 #define UART_LSR_BI	0x10		/* Break */
125 #define UART_LSR_THRE	0x20		/* Xmit holding register empty */
126 #define UART_LSR_TEMT	0x40		/* Xmitter empty */
127 #define UART_LSR_ERR	0x80		/* Error */
128 
129 #define UART_MSR_DCD	0x80		/* Data Carrier Detect */
130 #define UART_MSR_RI	0x40		/* Ring Indicator */
131 #define UART_MSR_DSR	0x20		/* Data Set Ready */
132 #define UART_MSR_CTS	0x10		/* Clear to Send */
133 #define UART_MSR_DDCD	0x08		/* Delta DCD */
134 #define UART_MSR_TERI	0x04		/* Trailing edge ring indicator */
135 #define UART_MSR_DDSR	0x02		/* Delta DSR */
136 #define UART_MSR_DCTS	0x01		/* Delta CTS */
137 
138 /*
139  * These are the definitions for the Interrupt Identification Register
140  */
141 #define UART_IIR_NO_INT	0x01	/* No interrupts pending */
142 #define UART_IIR_ID	0x06	/* Mask for the interrupt ID */
143 
144 #define UART_IIR_MSI	0x00	/* Modem status interrupt */
145 #define UART_IIR_THRI	0x02	/* Transmitter holding register empty */
146 #define UART_IIR_RDI	0x04	/* Receiver data interrupt */
147 #define UART_IIR_RLSI	0x06	/* Receiver line status interrupt */
148 
149 /*
150  * These are the definitions for the Interrupt Enable Register
151  */
152 #define UART_IER_MSI	0x08	/* Enable Modem status interrupt */
153 #define UART_IER_RLSI	0x04	/* Enable receiver line status interrupt */
154 #define UART_IER_THRI	0x02	/* Enable Transmitter holding register int. */
155 #define UART_IER_RDI	0x01	/* Enable receiver data interrupt */
156 
157 
158 #ifdef CONFIG_OMAP1510
159 #define OSC_12M_SEL	0x01	/* selects 6.5 * current clk div */
160 #endif
161 
162 /* useful defaults for LCR */
163 #define UART_LCR_8N1	0x03
164 
165 void NS16550_init(NS16550_t com_port, int baud_divisor);
166 void NS16550_putc(NS16550_t com_port, char c);
167 char NS16550_getc(NS16550_t com_port);
168 int NS16550_tstc(NS16550_t com_port);
169 void NS16550_reinit(NS16550_t com_port, int baud_divisor);
170