diff options
author | Linus Torvalds <torvalds@ppc970.osdl.org> | 2005-04-16 18:20:36 -0400 |
---|---|---|
committer | Linus Torvalds <torvalds@ppc970.osdl.org> | 2005-04-16 18:20:36 -0400 |
commit | 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch) | |
tree | 0bba044c4ce775e45a88a51686b5d9f90697ea9d /include/asm-v850/v850e_uarta.h |
Linux-2.6.12-rc2v2.6.12-rc2
Initial git repository build. I'm not bothering with the full history,
even though we have it. We can create a separate "historical" git
archive of that later if we want to, and in the meantime it's about
3.2GB when imported into git - space that would just make the early
git days unnecessarily complicated, when we don't have a lot of good
infrastructure for it.
Let it rip!
Diffstat (limited to 'include/asm-v850/v850e_uarta.h')
-rw-r--r-- | include/asm-v850/v850e_uarta.h | 278 |
1 files changed, 278 insertions, 0 deletions
diff --git a/include/asm-v850/v850e_uarta.h b/include/asm-v850/v850e_uarta.h new file mode 100644 index 000000000000..e483e0950725 --- /dev/null +++ b/include/asm-v850/v850e_uarta.h | |||
@@ -0,0 +1,278 @@ | |||
1 | /* | ||
2 | * include/asm-v850/v850e_uarta.h -- original V850E on-chip UART | ||
3 | * | ||
4 | * Copyright (C) 2001,02,03 NEC Electronics Corporation | ||
5 | * Copyright (C) 2001,02,03 Miles Bader <miles@gnu.org> | ||
6 | * | ||
7 | * This file is subject to the terms and conditions of the GNU General | ||
8 | * Public License. See the file COPYING in the main directory of this | ||
9 | * archive for more details. | ||
10 | * | ||
11 | * Written by Miles Bader <miles@gnu.org> | ||
12 | */ | ||
13 | |||
14 | /* This is the original V850E UART implementation is called just `UART' in | ||
15 | the docs, but we name this header file <asm/v850e_uarta.h> because the | ||
16 | name <asm/v850e_uart.h> is used for the common driver that handles both | ||
17 | `UART' and `UARTB' implementations. */ | ||
18 | |||
19 | #ifndef __V850_V850E_UARTA_H__ | ||
20 | #define __V850_V850E_UARTA_H__ | ||
21 | |||
22 | |||
23 | /* Raw hardware interface. */ | ||
24 | |||
25 | /* The base address of the UART control registers for channel N. | ||
26 | The default is the address used on the V850E/MA1. */ | ||
27 | #ifndef V850E_UART_BASE_ADDR | ||
28 | #define V850E_UART_BASE_ADDR(n) (0xFFFFFA00 + 0x10 * (n)) | ||
29 | #endif | ||
30 | |||
31 | /* Addresses of specific UART control registers for channel N. | ||
32 | The defaults are the addresses used on the V850E/MA1; if a platform | ||
33 | wants to redefine any of these, it must redefine them all. */ | ||
34 | #ifndef V850E_UART_ASIM_ADDR | ||
35 | #define V850E_UART_ASIM_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x0) | ||
36 | #define V850E_UART_RXB_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x2) | ||
37 | #define V850E_UART_ASIS_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x3) | ||
38 | #define V850E_UART_TXB_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x4) | ||
39 | #define V850E_UART_ASIF_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x5) | ||
40 | #define V850E_UART_CKSR_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x6) | ||
41 | #define V850E_UART_BRGC_ADDR(n) (V850E_UART_BASE_ADDR(n) + 0x7) | ||
42 | #endif | ||
43 | |||
44 | /* UART config registers. */ | ||
45 | #define V850E_UART_ASIM(n) (*(volatile u8 *)V850E_UART_ASIM_ADDR(n)) | ||
46 | /* Control bits for config registers. */ | ||
47 | #define V850E_UART_ASIM_CAE 0x80 /* clock enable */ | ||
48 | #define V850E_UART_ASIM_TXE 0x40 /* transmit enable */ | ||
49 | #define V850E_UART_ASIM_RXE 0x20 /* receive enable */ | ||
50 | #define V850E_UART_ASIM_PS_MASK 0x18 /* mask covering parity-select bits */ | ||
51 | #define V850E_UART_ASIM_PS_NONE 0x00 /* no parity */ | ||
52 | #define V850E_UART_ASIM_PS_ZERO 0x08 /* zero parity */ | ||
53 | #define V850E_UART_ASIM_PS_ODD 0x10 /* odd parity */ | ||
54 | #define V850E_UART_ASIM_PS_EVEN 0x18 /* even parity */ | ||
55 | #define V850E_UART_ASIM_CL_8 0x04 /* char len is 8 bits (otherwise, 7) */ | ||
56 | #define V850E_UART_ASIM_SL_2 0x02 /* 2 stop bits (otherwise, 1) */ | ||
57 | #define V850E_UART_ASIM_ISRM 0x01 /* generate INTSR interrupt on errors | ||
58 | (otherwise, generate INTSER) */ | ||
59 | |||
60 | /* UART serial interface status registers. */ | ||
61 | #define V850E_UART_ASIS(n) (*(volatile u8 *)V850E_UART_ASIS_ADDR(n)) | ||
62 | /* Control bits for status registers. */ | ||
63 | #define V850E_UART_ASIS_PE 0x04 /* parity error */ | ||
64 | #define V850E_UART_ASIS_FE 0x02 /* framing error */ | ||
65 | #define V850E_UART_ASIS_OVE 0x01 /* overrun error */ | ||
66 | |||
67 | /* UART serial interface transmission status registers. */ | ||
68 | #define V850E_UART_ASIF(n) (*(volatile u8 *)V850E_UART_ASIF_ADDR(n)) | ||
69 | #define V850E_UART_ASIF_TXBF 0x02 /* transmit buffer flag (data in TXB) */ | ||
70 | #define V850E_UART_ASIF_TXSF 0x01 /* transmit shift flag (sending data) */ | ||
71 | |||
72 | /* UART receive buffer register. */ | ||
73 | #define V850E_UART_RXB(n) (*(volatile u8 *)V850E_UART_RXB_ADDR(n)) | ||
74 | |||
75 | /* UART transmit buffer register. */ | ||
76 | #define V850E_UART_TXB(n) (*(volatile u8 *)V850E_UART_TXB_ADDR(n)) | ||
77 | |||
78 | /* UART baud-rate generator control registers. */ | ||
79 | #define V850E_UART_CKSR(n) (*(volatile u8 *)V850E_UART_CKSR_ADDR(n)) | ||
80 | #define V850E_UART_CKSR_MAX 11 | ||
81 | #define V850E_UART_BRGC(n) (*(volatile u8 *)V850E_UART_BRGC_ADDR(n)) | ||
82 | #define V850E_UART_BRGC_MIN 8 | ||
83 | |||
84 | |||
85 | #ifndef V850E_UART_CKSR_MAX_FREQ | ||
86 | #define V850E_UART_CKSR_MAX_FREQ (25*1000*1000) | ||
87 | #endif | ||
88 | |||
89 | /* Calculate the minimum value for CKSR on this processor. */ | ||
90 | static inline unsigned v850e_uart_cksr_min (void) | ||
91 | { | ||
92 | int min = 0; | ||
93 | unsigned freq = V850E_UART_BASE_FREQ; | ||
94 | while (freq > V850E_UART_CKSR_MAX_FREQ) { | ||
95 | freq >>= 1; | ||
96 | min++; | ||
97 | } | ||
98 | return min; | ||
99 | } | ||
100 | |||
101 | |||
102 | /* Slightly abstract interface used by driver. */ | ||
103 | |||
104 | |||
105 | /* Interrupts used by the UART. */ | ||
106 | |||
107 | /* Received when the most recently transmitted character has been sent. */ | ||
108 | #define V850E_UART_TX_IRQ(chan) IRQ_INTST (chan) | ||
109 | /* Received when a new character has been received. */ | ||
110 | #define V850E_UART_RX_IRQ(chan) IRQ_INTSR (chan) | ||
111 | |||
112 | |||
113 | /* UART clock generator interface. */ | ||
114 | |||
115 | /* This type encapsulates a particular uart frequency. */ | ||
116 | typedef struct { | ||
117 | unsigned clk_divlog2; | ||
118 | unsigned brgen_count; | ||
119 | } v850e_uart_speed_t; | ||
120 | |||
121 | /* Calculate a uart speed from BAUD for this uart. */ | ||
122 | static inline v850e_uart_speed_t v850e_uart_calc_speed (unsigned baud) | ||
123 | { | ||
124 | v850e_uart_speed_t speed; | ||
125 | |||
126 | /* Calculate the log2 clock divider and baud-rate counter values | ||
127 | (note that the UART divides the resulting clock by 2, so | ||
128 | multiply BAUD by 2 here to compensate). */ | ||
129 | calc_counter_params (V850E_UART_BASE_FREQ, baud * 2, | ||
130 | v850e_uart_cksr_min(), | ||
131 | V850E_UART_CKSR_MAX, 8/*bits*/, | ||
132 | &speed.clk_divlog2, &speed.brgen_count); | ||
133 | |||
134 | return speed; | ||
135 | } | ||
136 | |||
137 | /* Return the current speed of uart channel CHAN. */ | ||
138 | static inline v850e_uart_speed_t v850e_uart_speed (unsigned chan) | ||
139 | { | ||
140 | v850e_uart_speed_t speed; | ||
141 | speed.clk_divlog2 = V850E_UART_CKSR (chan); | ||
142 | speed.brgen_count = V850E_UART_BRGC (chan); | ||
143 | return speed; | ||
144 | } | ||
145 | |||
146 | /* Set the current speed of uart channel CHAN. */ | ||
147 | static inline void v850e_uart_set_speed(unsigned chan,v850e_uart_speed_t speed) | ||
148 | { | ||
149 | V850E_UART_CKSR (chan) = speed.clk_divlog2; | ||
150 | V850E_UART_BRGC (chan) = speed.brgen_count; | ||
151 | } | ||
152 | |||
153 | static inline int | ||
154 | v850e_uart_speed_eq (v850e_uart_speed_t speed1, v850e_uart_speed_t speed2) | ||
155 | { | ||
156 | return speed1.clk_divlog2 == speed2.clk_divlog2 | ||
157 | && speed1.brgen_count == speed2.brgen_count; | ||
158 | } | ||
159 | |||
160 | /* Minimum baud rate possible. */ | ||
161 | #define v850e_uart_min_baud() \ | ||
162 | ((V850E_UART_BASE_FREQ >> V850E_UART_CKSR_MAX) / (2 * 255) + 1) | ||
163 | |||
164 | /* Maximum baud rate possible. The error is quite high at max, though. */ | ||
165 | #define v850e_uart_max_baud() \ | ||
166 | ((V850E_UART_BASE_FREQ >> v850e_uart_cksr_min()) / (2 *V850E_UART_BRGC_MIN)) | ||
167 | |||
168 | /* The `maximum' clock rate the uart can used, which is wanted (though not | ||
169 | really used in any useful way) by the serial framework. */ | ||
170 | #define v850e_uart_max_clock() \ | ||
171 | ((V850E_UART_BASE_FREQ >> v850e_uart_cksr_min()) / 2) | ||
172 | |||
173 | |||
174 | /* UART configuration interface. */ | ||
175 | |||
176 | /* Type of the uart config register; must be a scalar. */ | ||
177 | typedef u16 v850e_uart_config_t; | ||
178 | |||
179 | /* The uart hardware config register for channel CHAN. */ | ||
180 | #define V850E_UART_CONFIG(chan) V850E_UART_ASIM (chan) | ||
181 | |||
182 | /* This config bit set if the uart is enabled. */ | ||
183 | #define V850E_UART_CONFIG_ENABLED V850E_UART_ASIM_CAE | ||
184 | /* If the uart _isn't_ enabled, store this value to it to do so. */ | ||
185 | #define V850E_UART_CONFIG_INIT V850E_UART_ASIM_CAE | ||
186 | /* Store this config value to disable the uart channel completely. */ | ||
187 | #define V850E_UART_CONFIG_FINI 0 | ||
188 | |||
189 | /* Setting/clearing these bits enable/disable TX/RX, respectively (but | ||
190 | otherwise generally leave things running). */ | ||
191 | #define V850E_UART_CONFIG_RX_ENABLE V850E_UART_ASIM_RXE | ||
192 | #define V850E_UART_CONFIG_TX_ENABLE V850E_UART_ASIM_TXE | ||
193 | |||
194 | /* These masks define which config bits affect TX/RX modes, respectively. */ | ||
195 | #define V850E_UART_CONFIG_RX_BITS \ | ||
196 | (V850E_UART_ASIM_PS_MASK | V850E_UART_ASIM_CL_8 | V850E_UART_ASIM_ISRM) | ||
197 | #define V850E_UART_CONFIG_TX_BITS \ | ||
198 | (V850E_UART_ASIM_PS_MASK | V850E_UART_ASIM_CL_8 | V850E_UART_ASIM_SL_2) | ||
199 | |||
200 | static inline v850e_uart_config_t v850e_uart_calc_config (unsigned cflags) | ||
201 | { | ||
202 | v850e_uart_config_t config = 0; | ||
203 | |||
204 | /* Figure out new configuration of control register. */ | ||
205 | if (cflags & CSTOPB) | ||
206 | /* Number of stop bits, 1 or 2. */ | ||
207 | config |= V850E_UART_ASIM_SL_2; | ||
208 | if ((cflags & CSIZE) == CS8) | ||
209 | /* Number of data bits, 7 or 8. */ | ||
210 | config |= V850E_UART_ASIM_CL_8; | ||
211 | if (! (cflags & PARENB)) | ||
212 | /* No parity check/generation. */ | ||
213 | config |= V850E_UART_ASIM_PS_NONE; | ||
214 | else if (cflags & PARODD) | ||
215 | /* Odd parity check/generation. */ | ||
216 | config |= V850E_UART_ASIM_PS_ODD; | ||
217 | else | ||
218 | /* Even parity check/generation. */ | ||
219 | config |= V850E_UART_ASIM_PS_EVEN; | ||
220 | if (cflags & CREAD) | ||
221 | /* Reading enabled. */ | ||
222 | config |= V850E_UART_ASIM_RXE; | ||
223 | |||
224 | config |= V850E_UART_ASIM_CAE; | ||
225 | config |= V850E_UART_ASIM_TXE; /* Writing is always enabled. */ | ||
226 | config |= V850E_UART_ASIM_ISRM; /* Errors generate a read-irq. */ | ||
227 | |||
228 | return config; | ||
229 | } | ||
230 | |||
231 | /* This should delay as long as necessary for a recently written config | ||
232 | setting to settle, before we turn the uart back on. */ | ||
233 | static inline void | ||
234 | v850e_uart_config_delay (v850e_uart_config_t config, v850e_uart_speed_t speed) | ||
235 | { | ||
236 | /* The UART may not be reset properly unless we wait at least 2 | ||
237 | `basic-clocks' until turning on the TXE/RXE bits again. | ||
238 | A `basic clock' is the clock used by the baud-rate generator, | ||
239 | i.e., the cpu clock divided by the 2^new_clk_divlog2. | ||
240 | The loop takes 2 insns, so loop CYCLES / 2 times. */ | ||
241 | register unsigned count = 1 << speed.clk_divlog2; | ||
242 | while (--count != 0) | ||
243 | /* nothing */; | ||
244 | } | ||
245 | |||
246 | |||
247 | /* RX/TX interface. */ | ||
248 | |||
249 | /* Return true if all characters awaiting transmission on uart channel N | ||
250 | have been transmitted. */ | ||
251 | #define v850e_uart_xmit_done(n) \ | ||
252 | (! (V850E_UART_ASIF(n) & V850E_UART_ASIF_TXBF)) | ||
253 | /* Wait for this to be true. */ | ||
254 | #define v850e_uart_wait_for_xmit_done(n) \ | ||
255 | do { } while (! v850e_uart_xmit_done (n)) | ||
256 | |||
257 | /* Return true if uart channel N is ready to transmit a character. */ | ||
258 | #define v850e_uart_xmit_ok(n) \ | ||
259 | (v850e_uart_xmit_done(n) && v850e_uart_cts(n)) | ||
260 | /* Wait for this to be true. */ | ||
261 | #define v850e_uart_wait_for_xmit_ok(n) \ | ||
262 | do { } while (! v850e_uart_xmit_ok (n)) | ||
263 | |||
264 | /* Write character CH to uart channel CHAN. */ | ||
265 | #define v850e_uart_putc(chan, ch) (V850E_UART_TXB(chan) = (ch)) | ||
266 | |||
267 | /* Return latest character read on channel CHAN. */ | ||
268 | #define v850e_uart_getc(chan) V850E_UART_RXB (chan) | ||
269 | |||
270 | /* Return bit-mask of uart error status. */ | ||
271 | #define v850e_uart_err(chan) V850E_UART_ASIS (chan) | ||
272 | /* Various error bits set in the error result. */ | ||
273 | #define V850E_UART_ERR_OVERRUN V850E_UART_ASIS_OVE | ||
274 | #define V850E_UART_ERR_FRAME V850E_UART_ASIS_FE | ||
275 | #define V850E_UART_ERR_PARITY V850E_UART_ASIS_PE | ||
276 | |||
277 | |||
278 | #endif /* __V850_V850E_UARTA_H__ */ | ||