coreboot
coreboot is an Open Source project aimed at replacing the proprietary BIOS found in most computers.
ipq_uart.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause */
2 
3 #ifndef __UART_DM_H__
4 #define __UART_DM_H__
5 
6 #define PERIPH_BLK_BLSP 0
7 
8 #define MSM_BOOT_UART_DM_EXTR_BITS(value, start_pos, end_pos) \
9  ((value << (32 - end_pos))\
10  >> (32 - (end_pos - start_pos)))
11 
12 extern void __udelay(unsigned long usec);
13 
19 };
20 
21 /* UART Stop Bit Length */
27 };
28 
29 /* UART Bits per Char */
35 };
36 
37 /* 8-N-1 Configuration */
38 #define MSM_BOOT_UART_DM_8_N_1_MODE (MSM_BOOT_UART_DM_NO_PARITY | \
39  (MSM_BOOT_UART_DM_SBL_1 << 2) | \
40  (MSM_BOOT_UART_DM_8_BPS << 4))
41 
42 /* UART_DM Registers */
43 
44 /* UART Operational Mode Register */
45 #define MSM_BOOT_UART_DM_MR1(base) ((base) + 0x00)
46 #define MSM_BOOT_UART_DM_MR2(base) ((base) + 0x04)
47 #define MSM_BOOT_UART_DM_RXBRK_ZERO_CHAR_OFF (1 << 8)
48 #define MSM_BOOT_UART_DM_LOOPBACK (1 << 7)
49 
50 /* UART Clock Selection Register */
51 #if PERIPH_BLK_BLSP
52 #define MSM_BOOT_UART_DM_CSR(base) ((base) + 0xA0)
53 #else
54 #define MSM_BOOT_UART_DM_CSR(base) ((base) + 0x08)
55 #endif
56 
57 /* UART DM TX FIFO Registers - 4 */
58 #if PERIPH_BLK_BLSP
59 #define MSM_BOOT_UART_DM_TF(base, x) ((base) + 0x100+(4*(x)))
60 #else
61 #define MSM_BOOT_UART_DM_TF(base, x) ((base) + 0x70+(4*(x)))
62 #endif
63 
64 /* UART Command Register */
65 #if PERIPH_BLK_BLSP
66 #define MSM_BOOT_UART_DM_CR(base) ((base) + 0xA8)
67 #else
68 #define MSM_BOOT_UART_DM_CR(base) ((base) + 0x10)
69 #endif
70 #define MSM_BOOT_UART_DM_CR_RX_ENABLE (1 << 0)
71 #define MSM_BOOT_UART_DM_CR_RX_DISABLE (1 << 1)
72 #define MSM_BOOT_UART_DM_CR_TX_ENABLE (1 << 2)
73 #define MSM_BOOT_UART_DM_CR_TX_DISABLE (1 << 3)
74 
75 /* UART Channel Command */
76 #define MSM_BOOT_UART_DM_CR_CH_CMD_LSB(x) ((x & 0x0f) << 4)
77 #define MSM_BOOT_UART_DM_CR_CH_CMD_MSB(x) ((x >> 4 ) << 11 )
78 #define MSM_BOOT_UART_DM_CR_CH_CMD(x) (MSM_BOOT_UART_DM_CR_CH_CMD_LSB(x)\
79  | MSM_BOOT_UART_DM_CR_CH_CMD_MSB(x))
80 #define MSM_BOOT_UART_DM_CMD_NULL MSM_BOOT_UART_DM_CR_CH_CMD(0)
81 #define MSM_BOOT_UART_DM_CMD_RESET_RX MSM_BOOT_UART_DM_CR_CH_CMD(1)
82 #define MSM_BOOT_UART_DM_CMD_RESET_TX MSM_BOOT_UART_DM_CR_CH_CMD(2)
83 #define MSM_BOOT_UART_DM_CMD_RESET_ERR_STAT MSM_BOOT_UART_DM_CR_CH_CMD(3)
84 #define MSM_BOOT_UART_DM_CMD_RES_BRK_CHG_INT MSM_BOOT_UART_DM_CR_CH_CMD(4)
85 #define MSM_BOOT_UART_DM_CMD_START_BRK MSM_BOOT_UART_DM_CR_CH_CMD(5)
86 #define MSM_BOOT_UART_DM_CMD_STOP_BRK MSM_BOOT_UART_DM_CR_CH_CMD(6)
87 #define MSM_BOOT_UART_DM_CMD_RES_CTS_N MSM_BOOT_UART_DM_CR_CH_CMD(7)
88 #define MSM_BOOT_UART_DM_CMD_RES_STALE_INT MSM_BOOT_UART_DM_CR_CH_CMD(8)
89 #define MSM_BOOT_UART_DM_CMD_PACKET_MODE MSM_BOOT_UART_DM_CR_CH_CMD(9)
90 #define MSM_BOOT_UART_DM_CMD_MODE_RESET MSM_BOOT_UART_DM_CR_CH_CMD(C)
91 #define MSM_BOOT_UART_DM_CMD_SET_RFR_N MSM_BOOT_UART_DM_CR_CH_CMD(D)
92 #define MSM_BOOT_UART_DM_CMD_RES_RFR_N MSM_BOOT_UART_DM_CR_CH_CMD(E)
93 #define MSM_BOOT_UART_DM_CMD_RES_TX_ERR MSM_BOOT_UART_DM_CR_CH_CMD(10)
94 #define MSM_BOOT_UART_DM_CMD_CLR_TX_DONE MSM_BOOT_UART_DM_CR_CH_CMD(11)
95 #define MSM_BOOT_UART_DM_CMD_RES_BRKSTRT_INT MSM_BOOT_UART_DM_CR_CH_CMD(12)
96 #define MSM_BOOT_UART_DM_CMD_RES_BRKEND_INT MSM_BOOT_UART_DM_CR_CH_CMD(13)
97 #define MSM_BOOT_UART_DM_CMD_RES_PER_FRM_INT MSM_BOOT_UART_DM_CR_CH_CMD(14)
98 
99 /*UART General Command */
100 #define MSM_BOOT_UART_DM_CR_GENERAL_CMD(x) ((x) << 8)
101 
102 #define MSM_BOOT_UART_DM_GCMD_NULL MSM_BOOT_UART_DM_CR_GENERAL_CMD(0)
103 #define MSM_BOOT_UART_DM_GCMD_CR_PROT_EN MSM_BOOT_UART_DM_CR_GENERAL_CMD(1)
104 #define MSM_BOOT_UART_DM_GCMD_CR_PROT_DIS MSM_BOOT_UART_DM_CR_GENERAL_CMD(2)
105 #define MSM_BOOT_UART_DM_GCMD_RES_TX_RDY_INT MSM_BOOT_UART_DM_CR_GENERAL_CMD(3)
106 #define MSM_BOOT_UART_DM_GCMD_SW_FORCE_STALE MSM_BOOT_UART_DM_CR_GENERAL_CMD(4)
107 #define MSM_BOOT_UART_DM_GCMD_ENA_STALE_EVT MSM_BOOT_UART_DM_CR_GENERAL_CMD(5)
108 #define MSM_BOOT_UART_DM_GCMD_DIS_STALE_EVT MSM_BOOT_UART_DM_CR_GENERAL_CMD(6)
109 
110 /* UART Interrupt Mask Register */
111 #if PERIPH_BLK_BLSP
112 #define MSM_BOOT_UART_DM_IMR(base) ((base) + 0xB0)
113 #else
114 #define MSM_BOOT_UART_DM_IMR(base) ((base) + 0x14)
115 #endif
116 
117 #define MSM_BOOT_UART_DM_TXLEV (1 << 0)
118 #define MSM_BOOT_UART_DM_RXHUNT (1 << 1)
119 #define MSM_BOOT_UART_DM_RXBRK_CHNG (1 << 2)
120 #define MSM_BOOT_UART_DM_RXSTALE (1 << 3)
121 #define MSM_BOOT_UART_DM_RXLEV (1 << 4)
122 #define MSM_BOOT_UART_DM_DELTA_CTS (1 << 5)
123 #define MSM_BOOT_UART_DM_CURRENT_CTS (1 << 6)
124 #define MSM_BOOT_UART_DM_TX_READY (1 << 7)
125 #define MSM_BOOT_UART_DM_TX_ERROR (1 << 8)
126 #define MSM_BOOT_UART_DM_TX_DONE (1 << 9)
127 #define MSM_BOOT_UART_DM_RXBREAK_START (1 << 10)
128 #define MSM_BOOT_UART_DM_RXBREAK_END (1 << 11)
129 #define MSM_BOOT_UART_DM_PAR_FRAME_ERR_IRQ (1 << 12)
130 
131 #define MSM_BOOT_UART_DM_IMR_ENABLED (MSM_BOOT_UART_DM_TX_READY | \
132  MSM_BOOT_UART_DM_TXLEV | \
133  MSM_BOOT_UART_DM_RXSTALE)
134 
135 /* UART Interrupt Programming Register */
136 #define MSM_BOOT_UART_DM_IPR(base) ((base) + 0x18)
137 #define MSM_BOOT_UART_DM_STALE_TIMEOUT_LSB 0x0f
138 #define MSM_BOOT_UART_DM_STALE_TIMEOUT_MSB 0 /* Not used currently */
139 
140 /* UART Transmit/Receive FIFO Watermark Register */
141 #define MSM_BOOT_UART_DM_TFWR(base) ((base) + 0x1C)
142 /* Interrupt is generated when FIFO level is less than or equal to this value */
143 #define MSM_BOOT_UART_DM_TFW_VALUE 0
144 
145 #define MSM_BOOT_UART_DM_RFWR(base) ((base) + 0x20)
146 /*Interrupt generated when no of words in RX FIFO is greater than this value */
147 #define MSM_BOOT_UART_DM_RFW_VALUE 0
148 
149 /* UART Hunt Character Register */
150 #define MSM_BOOT_UART_DM_HCR(base) ((base) + 0x24)
151 
152 /* Used for RX transfer initialization */
153 #define MSM_BOOT_UART_DM_DMRX(base) ((base) + 0x34)
154 
155 /* Default DMRX value - any value bigger than FIFO size would be fine */
156 #define MSM_BOOT_UART_DM_DMRX_DEF_VALUE 0x220
157 
158 /* Register to enable IRDA function */
159 #if PERIPH_BLK_BLSP
160 #define MSM_BOOT_UART_DM_IRDA(base) ((base) + 0xB8)
161 #else
162 #define MSM_BOOT_UART_DM_IRDA(base) ((base) + 0x38)
163 #endif
164 
165 /* UART Data Mover Enable Register */
166 #define MSM_BOOT_UART_DM_DMEN(base) ((base) + 0x3C)
167 
168 /* Number of characters for Transmission */
169 #define MSM_BOOT_UART_DM_NO_CHARS_FOR_TX(base) ((base) + 0x040)
170 
171 /* UART RX FIFO Base Address */
172 #define MSM_BOOT_UART_DM_BADR(base) ((base) + 0x44)
173 
174 /* UART Status Register */
175 #if PERIPH_BLK_BLSP
176 #define MSM_BOOT_UART_DM_SR(base) ((base) + 0x0A4)
177 #else
178 #define MSM_BOOT_UART_DM_SR(base) ((base) + 0x008)
179 #endif
180 #define MSM_BOOT_UART_DM_SR_RXRDY (1 << 0)
181 #define MSM_BOOT_UART_DM_SR_RXFULL (1 << 1)
182 #define MSM_BOOT_UART_DM_SR_TXRDY (1 << 2)
183 #define MSM_BOOT_UART_DM_SR_TXEMT (1 << 3)
184 #define MSM_BOOT_UART_DM_SR_UART_OVERRUN (1 << 4)
185 #define MSM_BOOT_UART_DM_SR_PAR_FRAME_ERR (1 << 5)
186 #define MSM_BOOT_UART_DM_RX_BREAK (1 << 6)
187 #define MSM_BOOT_UART_DM_HUNT_CHAR (1 << 7)
188 #define MSM_BOOT_UART_DM_RX_BRK_START_LAST (1 << 8)
189 
190 /* UART Receive FIFO Registers - 4 in numbers */
191 #if PERIPH_BLK_BLSP
192 #define MSM_BOOT_UART_DM_RF(base, x) ((base) + 0x140 + (4*(x)))
193 #else
194 #define MSM_BOOT_UART_DM_RF(base, x) ((base) + 0x70 + (4*(x)))
195 #endif
196 
197 /* UART Masked Interrupt Status Register */
198 #if PERIPH_BLK_BLSP
199 #define MSM_BOOT_UART_DM_MISR(base) ((base) + 0xAC)
200 #else
201 #define MSM_BOOT_UART_DM_MISR(base) ((base) + 0x10)
202 #endif
203 
204 /* UART Interrupt Status Register */
205 #if PERIPH_BLK_BLSP
206 #define MSM_BOOT_UART_DM_ISR(base) ((base) + 0xB4)
207 #else
208 #define MSM_BOOT_UART_DM_ISR(base) ((base) + 0x14)
209 #endif
210 
211 /* Number of characters received since the end of last RX transfer */
212 #if PERIPH_BLK_BLSP
213 #define MSM_BOOT_UART_DM_RX_TOTAL_SNAP(base) ((base) + 0xBC)
214 #else
215 #define MSM_BOOT_UART_DM_RX_TOTAL_SNAP(base) ((base) + 0x38)
216 #endif
217 
218 /* UART TX FIFO Status Register */
219 #define MSM_BOOT_UART_DM_TXFS(base) ((base) + 0x4C)
220 #define MSM_BOOT_UART_DM_TXFS_STATE_LSB(x) MSM_BOOT_UART_DM_EXTR_BITS(x,0,6)
221 #define MSM_BOOT_UART_DM_TXFS_STATE_MSB(x) MSM_BOOT_UART_DM_EXTR_BITS(x,14,31)
222 #define MSM_BOOT_UART_DM_TXFS_BUF_STATE(x) MSM_BOOT_UART_DM_EXTR_BITS(x,7,9)
223 #define MSM_BOOT_UART_DM_TXFS_ASYNC_STATE(x) MSM_BOOT_UART_DM_EXTR_BITS(x,10,13)
224 
225 /* UART RX FIFO Status Register */
226 #define MSM_BOOT_UART_DM_RXFS(base) ((base) + 0x50)
227 #define MSM_BOOT_UART_DM_RXFS_STATE_LSB(x) MSM_BOOT_UART_DM_EXTR_BITS(x,0,6)
228 #define MSM_BOOT_UART_DM_RXFS_STATE_MSB(x) MSM_BOOT_UART_DM_EXTR_BITS(x,14,31)
229 #define MSM_BOOT_UART_DM_RXFS_BUF_STATE(x) MSM_BOOT_UART_DM_EXTR_BITS(x,7,9)
230 #define MSM_BOOT_UART_DM_RXFS_ASYNC_STATE(x) MSM_BOOT_UART_DM_EXTR_BITS(x,10,13)
231 
232 /* Macros for Common Errors */
233 #define MSM_BOOT_UART_DM_E_SUCCESS 0
234 #define MSM_BOOT_UART_DM_E_FAILURE 1
235 #define MSM_BOOT_UART_DM_E_TIMEOUT 2
236 #define MSM_BOOT_UART_DM_E_INVAL 3
237 #define MSM_BOOT_UART_DM_E_MALLOC_FAIL 4
238 #define MSM_BOOT_UART_DM_E_RX_NOT_READY 5
239 
240 void ipq806x_uart_init(void);
241 
242 #endif /* __UART_DM_H__ */
void __udelay(unsigned long usec)
MSM_BOOT_UART_DM_BITS_PER_CHAR
Definition: ipq_uart.h:29
@ MSM_BOOT_UART_DM_7_BPS
Definition: ipq_uart.h:32
@ MSM_BOOT_UART_DM_8_BPS
Definition: ipq_uart.h:33
@ MSM_BOOT_UART_DM_5_BPS
Definition: ipq_uart.h:30
@ MSM_BOOT_UART_DM_6_BPS
Definition: ipq_uart.h:31
MSM_BOOT_UART_DM_PARITY_MODE
Definition: ipq_uart.h:13
@ MSM_BOOT_UART_DM_NO_PARITY
Definition: ipq_uart.h:14
@ MSM_BOOT_UART_DM_EVEN_PARITY
Definition: ipq_uart.h:16
@ MSM_BOOT_UART_DM_SPACE_PARITY
Definition: ipq_uart.h:17
@ MSM_BOOT_UART_DM_ODD_PARITY
Definition: ipq_uart.h:15
MSM_BOOT_UART_DM_STOP_BIT_LEN
Definition: ipq_uart.h:21
@ MSM_BOOT_UART_DM_SBL_1_9_16
Definition: ipq_uart.h:24
@ MSM_BOOT_UART_DM_SBL_2
Definition: ipq_uart.h:25
@ MSM_BOOT_UART_DM_SBL_1
Definition: ipq_uart.h:23
@ MSM_BOOT_UART_DM_SBL_9_16
Definition: ipq_uart.h:22
void ipq806x_uart_init(void)
Definition: uart.c:303