xref: /freebsd/sys/dev/uart/uart_dev_quicc.c (revision 46a968ec)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2006 Juniper Networks
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #include <sys/param.h>
30 #include <sys/systm.h>
31 #include <sys/bus.h>
32 #include <sys/conf.h>
33 #include <sys/endian.h>
34 #include <machine/bus.h>
35 
36 #include <dev/ic/quicc.h>
37 
38 #include <dev/uart/uart.h>
39 #include <dev/uart/uart_cpu.h>
40 #include <dev/uart/uart_bus.h>
41 
42 #include "uart_if.h"
43 
44 #define	DEFAULT_RCLK	((266000000 * 2) / 16)
45 
46 #define	quicc_read2(bas, reg)		\
47 	bus_space_read_2((bas)->bst, (bas)->bsh, reg)
48 #define	quicc_read4(bas, reg)		\
49 	bus_space_read_4((bas)->bst, (bas)->bsh, reg)
50 
51 #define	quicc_write2(bas, reg, val)	\
52 	bus_space_write_2((bas)->bst, (bas)->bsh, reg, val)
53 #define	quicc_write4(bas, reg, val)	\
54 	bus_space_write_4((bas)->bst, (bas)->bsh, reg, val)
55 
56 static int
quicc_divisor(int rclk,int baudrate)57 quicc_divisor(int rclk, int baudrate)
58 {
59 	int act_baud, divisor, error;
60 
61 	if (baudrate == 0)
62 		return (-1);
63 
64 	divisor = rclk / baudrate / 16;
65 	if (divisor > 4096)
66 		divisor = ((divisor >> 3) - 2) | 1;
67 	else if (divisor >= 0)
68 		divisor = (divisor - 1) << 1;
69 	if (divisor < 0 || divisor >= 8192)
70 		return (-1);
71 	act_baud = rclk / (((divisor >> 1) + 1) << ((divisor & 1) ? 8 : 4));
72 
73 	/* 10 times error in percent: */
74 	error = ((act_baud - baudrate) * 2000 / baudrate + 1) >> 1;
75 
76 	/* 3.0% maximum error tolerance: */
77 	if (error < -30 || error > 30)
78 		return (-1);
79 
80 	return (divisor);
81 }
82 
83 static int
quicc_param(struct uart_bas * bas,int baudrate,int databits,int stopbits,int parity)84 quicc_param(struct uart_bas *bas, int baudrate, int databits, int stopbits,
85     int parity)
86 {
87 	int divisor;
88 	uint16_t psmr;
89 
90 	if (baudrate > 0) {
91 		divisor = quicc_divisor(bas->rclk, baudrate);
92 		if (divisor == -1)
93 			return (EINVAL);
94 		quicc_write4(bas, QUICC_REG_BRG(bas->chan - 1),
95 		    divisor | 0x10000);
96 	}
97 
98 	psmr = 0;
99 	switch (databits) {
100 	case 5:		psmr |= 0x0000; break;
101 	case 6:		psmr |= 0x1000; break;
102 	case 7:		psmr |= 0x2000; break;
103 	case 8:		psmr |= 0x3000; break;
104 	default:	return (EINVAL);
105 	}
106 	switch (stopbits) {
107 	case 1:		psmr |= 0x0000; break;
108 	case 2:		psmr |= 0x4000; break;
109 	default:	return (EINVAL);
110 	}
111 	switch (parity) {
112 	case UART_PARITY_EVEN:	psmr |= 0x1a; break;
113 	case UART_PARITY_MARK:	psmr |= 0x1f; break;
114 	case UART_PARITY_NONE:	psmr |= 0x00; break;
115 	case UART_PARITY_ODD:	psmr |= 0x10; break;
116 	case UART_PARITY_SPACE:	psmr |= 0x15; break;
117 	default:		return (EINVAL);
118 	}
119 	quicc_write2(bas, QUICC_REG_SCC_PSMR(bas->chan - 1), psmr);
120 	return (0);
121 }
122 
123 static void
quicc_setup(struct uart_bas * bas,int baudrate,int databits,int stopbits,int parity)124 quicc_setup(struct uart_bas *bas, int baudrate, int databits, int stopbits,
125     int parity)
126 {
127 
128 	if (bas->rclk == 0)
129 		bas->rclk = DEFAULT_RCLK;
130 
131 	/*
132 	 * GSMR_L = 0x00028034
133 	 * GSMR_H = 0x00000020
134 	 */
135 	quicc_param(bas, baudrate, databits, stopbits, parity);
136 
137 	quicc_write2(bas, QUICC_REG_SCC_SCCE(bas->chan - 1), ~0);
138 	quicc_write2(bas, QUICC_REG_SCC_SCCM(bas->chan - 1), 0x0027);
139 }
140 
141 /*
142  * Low-level UART interface.
143  */
144 static int quicc_probe(struct uart_bas *bas);
145 static void quicc_init(struct uart_bas *bas, int, int, int, int);
146 static void quicc_term(struct uart_bas *bas);
147 static void quicc_putc(struct uart_bas *bas, int);
148 static int quicc_rxready(struct uart_bas *bas);
149 static int quicc_getc(struct uart_bas *bas, struct mtx *);
150 
151 static struct uart_ops uart_quicc_ops = {
152 	.probe = quicc_probe,
153 	.init = quicc_init,
154 	.term = quicc_term,
155 	.putc = quicc_putc,
156 	.rxready = quicc_rxready,
157 	.getc = quicc_getc,
158 };
159 
160 static int
quicc_probe(struct uart_bas * bas)161 quicc_probe(struct uart_bas *bas)
162 {
163 
164 	return (0);
165 }
166 
167 static void
quicc_init(struct uart_bas * bas,int baudrate,int databits,int stopbits,int parity)168 quicc_init(struct uart_bas *bas, int baudrate, int databits, int stopbits,
169     int parity)
170 {
171 
172 	quicc_setup(bas, baudrate, databits, stopbits, parity);
173 }
174 
175 static void
quicc_term(struct uart_bas * bas)176 quicc_term(struct uart_bas *bas)
177 {
178 }
179 
180 static void
quicc_putc(struct uart_bas * bas,int c)181 quicc_putc(struct uart_bas *bas, int c)
182 {
183 	int unit;
184 	uint16_t toseq;
185 
186 	unit = bas->chan - 1;
187 	while (quicc_read2(bas, QUICC_PRAM_SCC_UART_TOSEQ(unit)) & 0x2000)
188 		DELAY(10);
189 
190 	toseq = 0x2000 | (c & 0xff);
191 	quicc_write2(bas, QUICC_PRAM_SCC_UART_TOSEQ(unit), toseq);
192 }
193 
194 static int
quicc_rxready(struct uart_bas * bas)195 quicc_rxready(struct uart_bas *bas)
196 {
197 	uint16_t rb;
198 
199 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
200 	return ((quicc_read2(bas, rb) & 0x8000) ? 0 : 1);
201 }
202 
203 static int
quicc_getc(struct uart_bas * bas,struct mtx * hwmtx)204 quicc_getc(struct uart_bas *bas, struct mtx *hwmtx)
205 {
206 	volatile char *buf;
207 	int c;
208 	uint16_t rb, sc;
209 
210 	uart_lock(hwmtx);
211 
212 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
213 
214 	while ((sc = quicc_read2(bas, rb)) & 0x8000) {
215 		uart_unlock(hwmtx);
216 		DELAY(4);
217 		uart_lock(hwmtx);
218 	}
219 
220 	buf = (void *)(uintptr_t)quicc_read4(bas, rb + 4);
221 	c = *buf;
222 	quicc_write2(bas, rb, sc | 0x8000);
223 
224 	uart_unlock(hwmtx);
225 
226 	return (c);
227 }
228 
229 /*
230  * High-level UART interface.
231  */
232 struct quicc_softc {
233 	struct uart_softc base;
234 };
235 
236 static int quicc_bus_attach(struct uart_softc *);
237 static int quicc_bus_detach(struct uart_softc *);
238 static int quicc_bus_flush(struct uart_softc *, int);
239 static int quicc_bus_getsig(struct uart_softc *);
240 static int quicc_bus_ioctl(struct uart_softc *, int, intptr_t);
241 static int quicc_bus_ipend(struct uart_softc *);
242 static int quicc_bus_param(struct uart_softc *, int, int, int, int);
243 static int quicc_bus_probe(struct uart_softc *);
244 static int quicc_bus_receive(struct uart_softc *);
245 static int quicc_bus_setsig(struct uart_softc *, int);
246 static int quicc_bus_transmit(struct uart_softc *);
247 static void quicc_bus_grab(struct uart_softc *);
248 static void quicc_bus_ungrab(struct uart_softc *);
249 
250 static kobj_method_t quicc_methods[] = {
251 	KOBJMETHOD(uart_attach,		quicc_bus_attach),
252 	KOBJMETHOD(uart_detach,		quicc_bus_detach),
253 	KOBJMETHOD(uart_flush,		quicc_bus_flush),
254 	KOBJMETHOD(uart_getsig,		quicc_bus_getsig),
255 	KOBJMETHOD(uart_ioctl,		quicc_bus_ioctl),
256 	KOBJMETHOD(uart_ipend,		quicc_bus_ipend),
257 	KOBJMETHOD(uart_param,		quicc_bus_param),
258 	KOBJMETHOD(uart_probe,		quicc_bus_probe),
259 	KOBJMETHOD(uart_receive,	quicc_bus_receive),
260 	KOBJMETHOD(uart_setsig,		quicc_bus_setsig),
261 	KOBJMETHOD(uart_transmit,	quicc_bus_transmit),
262 	KOBJMETHOD(uart_grab,		quicc_bus_grab),
263 	KOBJMETHOD(uart_ungrab,		quicc_bus_ungrab),
264 	{ 0, 0 }
265 };
266 
267 struct uart_class uart_quicc_class = {
268 	"quicc",
269 	quicc_methods,
270 	sizeof(struct quicc_softc),
271 	.uc_ops = &uart_quicc_ops,
272 	.uc_range = 2,
273 	.uc_rclk = DEFAULT_RCLK,
274 	.uc_rshift = 0
275 };
276 UART_CLASS(uart_quicc_class);
277 
278 #define	SIGCHG(c, i, s, d)				\
279 	if (c) {					\
280 		i |= (i & s) ? s : s | d;		\
281 	} else {					\
282 		i = (i & s) ? (i & ~s) | d : i;		\
283 	}
284 
285 static int
quicc_bus_attach(struct uart_softc * sc)286 quicc_bus_attach(struct uart_softc *sc)
287 {
288 	struct uart_bas *bas;
289 	struct uart_devinfo *di;
290 	uint16_t st, rb;
291 
292 	bas = &sc->sc_bas;
293 	if (sc->sc_sysdev != NULL) {
294 		di = sc->sc_sysdev;
295 		quicc_param(bas, di->baudrate, di->databits, di->stopbits,
296 		    di->parity);
297 	} else {
298 		quicc_setup(bas, 9600, 8, 1, UART_PARITY_NONE);
299 	}
300 
301 	/* Enable interrupts on the receive buffer. */
302 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
303 	st = quicc_read2(bas, rb);
304 	quicc_write2(bas, rb, st | 0x9000);
305 
306 	(void)quicc_bus_getsig(sc);
307 
308 	return (0);
309 }
310 
311 static int
quicc_bus_detach(struct uart_softc * sc)312 quicc_bus_detach(struct uart_softc *sc)
313 {
314 
315 	return (0);
316 }
317 
318 static int
quicc_bus_flush(struct uart_softc * sc,int what)319 quicc_bus_flush(struct uart_softc *sc, int what)
320 {
321 
322 	return (0);
323 }
324 
325 static int
quicc_bus_getsig(struct uart_softc * sc)326 quicc_bus_getsig(struct uart_softc *sc)
327 {
328 	uint32_t new, old, sig;
329 	uint32_t dummy;
330 
331 	do {
332 		old = sc->sc_hwsig;
333 		sig = old;
334 		uart_lock(sc->sc_hwmtx);
335 		/* XXX SIGNALS */
336 		dummy = 0;
337 		uart_unlock(sc->sc_hwmtx);
338 		SIGCHG(dummy, sig, SER_CTS, SER_DCTS);
339 		SIGCHG(dummy, sig, SER_DCD, SER_DDCD);
340 		SIGCHG(dummy, sig, SER_DSR, SER_DDSR);
341 		new = sig & ~SER_MASK_DELTA;
342 	} while (!atomic_cmpset_32(&sc->sc_hwsig, old, new));
343 	return (sig);
344 }
345 
346 static int
quicc_bus_ioctl(struct uart_softc * sc,int request,intptr_t data)347 quicc_bus_ioctl(struct uart_softc *sc, int request, intptr_t data)
348 {
349 	struct uart_bas *bas;
350 	uint32_t brg;
351 	int baudrate, error;
352 
353 	bas = &sc->sc_bas;
354 	error = 0;
355 	uart_lock(sc->sc_hwmtx);
356 	switch (request) {
357 	case UART_IOCTL_BREAK:
358 		break;
359 	case UART_IOCTL_BAUD:
360 		brg = quicc_read4(bas, QUICC_REG_BRG(bas->chan - 1)) & 0x1fff;
361 		brg = (brg & 1) ? (brg + 1) << 3 : (brg + 2) >> 1;
362 		baudrate = bas->rclk / (brg * 16);
363 		*(int*)data = baudrate;
364 		break;
365 	default:
366 		error = EINVAL;
367 		break;
368 	}
369 	uart_unlock(sc->sc_hwmtx);
370 	return (error);
371 }
372 
373 static int
quicc_bus_ipend(struct uart_softc * sc)374 quicc_bus_ipend(struct uart_softc *sc)
375 {
376 	struct uart_bas *bas;
377 	int ipend;
378 	uint16_t scce;
379 
380 	bas = &sc->sc_bas;
381 	ipend = 0;
382 
383 	uart_lock(sc->sc_hwmtx);
384 	scce = quicc_read2(bas, QUICC_REG_SCC_SCCE(bas->chan - 1));
385 	quicc_write2(bas, QUICC_REG_SCC_SCCE(bas->chan - 1), ~0);
386 	uart_unlock(sc->sc_hwmtx);
387 	if (scce & 0x0001)
388 		ipend |= SER_INT_RXREADY;
389 	if (scce & 0x0002)
390 		ipend |= SER_INT_TXIDLE;
391 	if (scce & 0x0004)
392 		ipend |= SER_INT_OVERRUN;
393 	if (scce & 0x0020)
394 		ipend |= SER_INT_BREAK;
395 	/* XXX SIGNALS */
396 	return (ipend);
397 }
398 
399 static int
quicc_bus_param(struct uart_softc * sc,int baudrate,int databits,int stopbits,int parity)400 quicc_bus_param(struct uart_softc *sc, int baudrate, int databits,
401     int stopbits, int parity)
402 {
403 	int error;
404 
405 	uart_lock(sc->sc_hwmtx);
406 	error = quicc_param(&sc->sc_bas, baudrate, databits, stopbits,
407 	    parity);
408 	uart_unlock(sc->sc_hwmtx);
409 	return (error);
410 }
411 
412 static int
quicc_bus_probe(struct uart_softc * sc)413 quicc_bus_probe(struct uart_softc *sc)
414 {
415 	char buf[80];
416 	int error;
417 
418 	error = quicc_probe(&sc->sc_bas);
419 	if (error)
420 		return (error);
421 
422 	sc->sc_rxfifosz = 1;
423 	sc->sc_txfifosz = 1;
424 
425 	snprintf(buf, sizeof(buf), "quicc, channel %d", sc->sc_bas.chan);
426 	device_set_desc_copy(sc->sc_dev, buf);
427 	return (0);
428 }
429 
430 static int
quicc_bus_receive(struct uart_softc * sc)431 quicc_bus_receive(struct uart_softc *sc)
432 {
433 	struct uart_bas *bas;
434 	volatile char *buf;
435 	uint16_t st, rb;
436 
437 	bas = &sc->sc_bas;
438 	uart_lock(sc->sc_hwmtx);
439 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
440 	st = quicc_read2(bas, rb);
441 	buf = (void *)(uintptr_t)quicc_read4(bas, rb + 4);
442 	uart_rx_put(sc, *buf);
443 	quicc_write2(bas, rb, st | 0x9000);
444 	uart_unlock(sc->sc_hwmtx);
445 	return (0);
446 }
447 
448 static int
quicc_bus_setsig(struct uart_softc * sc,int sig)449 quicc_bus_setsig(struct uart_softc *sc, int sig)
450 {
451 	uint32_t new, old;
452 
453 	do {
454 		old = sc->sc_hwsig;
455 		new = old;
456 		if (sig & SER_DDTR) {
457 			SIGCHG(sig & SER_DTR, new, SER_DTR,
458 			    SER_DDTR);
459 		}
460 		if (sig & SER_DRTS) {
461 			SIGCHG(sig & SER_RTS, new, SER_RTS,
462 			    SER_DRTS);
463 		}
464 	} while (!atomic_cmpset_32(&sc->sc_hwsig, old, new));
465 
466 	uart_lock(sc->sc_hwmtx);
467 	/* XXX SIGNALS */
468 	uart_unlock(sc->sc_hwmtx);
469 	return (0);
470 }
471 
472 static int
quicc_bus_transmit(struct uart_softc * sc)473 quicc_bus_transmit(struct uart_softc *sc)
474 {
475 	volatile char *buf;
476 	struct uart_bas *bas;
477 	uint16_t st, tb;
478 
479 	bas = &sc->sc_bas;
480 	uart_lock(sc->sc_hwmtx);
481 	tb = quicc_read2(bas, QUICC_PRAM_SCC_TBASE(bas->chan - 1));
482 	st = quicc_read2(bas, tb);
483 	buf = (void *)(uintptr_t)quicc_read4(bas, tb + 4);
484 	*buf = sc->sc_txbuf[0];
485 	quicc_write2(bas, tb + 2, 1);
486 	quicc_write2(bas, tb, st | 0x9000);
487 	sc->sc_txbusy = 1;
488 	uart_unlock(sc->sc_hwmtx);
489 	return (0);
490 }
491 
492 static void
quicc_bus_grab(struct uart_softc * sc)493 quicc_bus_grab(struct uart_softc *sc)
494 {
495 	struct uart_bas *bas;
496 	uint16_t st, rb;
497 
498 	/* Disable interrupts on the receive buffer. */
499 	bas = &sc->sc_bas;
500 	uart_lock(sc->sc_hwmtx);
501 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
502 	st = quicc_read2(bas, rb);
503 	quicc_write2(bas, rb, st & ~0x9000);
504 	uart_unlock(sc->sc_hwmtx);
505 }
506 
507 static void
quicc_bus_ungrab(struct uart_softc * sc)508 quicc_bus_ungrab(struct uart_softc *sc)
509 {
510 	struct uart_bas *bas;
511 	uint16_t st, rb;
512 
513 	/* Enable interrupts on the receive buffer. */
514 	bas = &sc->sc_bas;
515 	uart_lock(sc->sc_hwmtx);
516 	rb = quicc_read2(bas, QUICC_PRAM_SCC_RBASE(bas->chan - 1));
517 	st = quicc_read2(bas, rb);
518 	quicc_write2(bas, rb, st | 0x9000);
519 	uart_unlock(sc->sc_hwmtx);
520 }
521