xref: /freebsd/sys/dev/uart/uart_dev_z8530.c (revision 7d99ab9fd0cc2c1ce2ecef0ed6d0672c2a50b0cb)
1 /*-
2  * Copyright (c) 2003 Marcel Moolenaar
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26 
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
29 
30 #include <sys/param.h>
31 #include <sys/systm.h>
32 #include <sys/bus.h>
33 #include <sys/conf.h>
34 #include <machine/bus.h>
35 
36 #include <dev/uart/uart.h>
37 #include <dev/uart/uart_cpu.h>
38 #include <dev/uart/uart_bus.h>
39 
40 #include <dev/ic/z8530.h>
41 
42 #include "uart_if.h"
43 
44 #define	DEFAULT_RCLK	307200
45 
46 /* Hack! */
47 #ifdef __powerpc__
48 #define	UART_PCLK	0
49 #else
50 #define	UART_PCLK	MCB2_PCLK
51 #endif
52 
53 /* Multiplexed I/O. */
54 static __inline void
55 uart_setmreg(struct uart_bas *bas, int reg, int val)
56 {
57 
58 	uart_setreg(bas, REG_CTRL, reg);
59 	uart_barrier(bas);
60 	uart_setreg(bas, REG_CTRL, val);
61 }
62 
63 static __inline uint8_t
64 uart_getmreg(struct uart_bas *bas, int reg)
65 {
66 
67 	uart_setreg(bas, REG_CTRL, reg);
68 	uart_barrier(bas);
69 	return (uart_getreg(bas, REG_CTRL));
70 }
71 
72 static int
73 z8530_divisor(int rclk, int baudrate)
74 {
75 	int act_baud, divisor, error;
76 
77 	if (baudrate == 0)
78 		return (-1);
79 
80 	divisor = (rclk + baudrate) / (baudrate << 1) - 2;
81 	if (divisor < 0 || divisor >= 65536)
82 		return (-1);
83 	act_baud = rclk / 2 / (divisor + 2);
84 
85 	/* 10 times error in percent: */
86 	error = ((act_baud - baudrate) * 2000 / baudrate + 1) >> 1;
87 
88 	/* 3.0% maximum error tolerance: */
89 	if (error < -30 || error > 30)
90 		return (-1);
91 
92 	return (divisor);
93 }
94 
95 static int
96 z8530_param(struct uart_bas *bas, int baudrate, int databits, int stopbits,
97     int parity, uint8_t *tpcp)
98 {
99 	int divisor;
100 	uint8_t mpm, rpc, tpc;
101 
102 	rpc = RPC_RXE;
103 	mpm = MPM_CM16;
104 	tpc = TPC_TXE | (*tpcp & (TPC_DTR | TPC_RTS));
105 
106 	if (databits >= 8) {
107 		rpc |= RPC_RB8;
108 		tpc |= TPC_TB8;
109 	} else if (databits == 7) {
110 		rpc |= RPC_RB7;
111 		tpc |= TPC_TB7;
112 	} else if (databits == 6) {
113 		rpc |= RPC_RB6;
114 		tpc |= TPC_TB6;
115 	} else {
116 		rpc |= RPC_RB5;
117 		tpc |= TPC_TB5;
118 	}
119 	mpm |= (stopbits > 1) ? MPM_SB2 : MPM_SB1;
120 	switch (parity) {
121 	case UART_PARITY_EVEN:	mpm |= MPM_PE | MPM_EVEN; break;
122 	case UART_PARITY_NONE:	break;
123 	case UART_PARITY_ODD:	mpm |= MPM_PE; break;
124 	default:		return (EINVAL);
125 	}
126 
127 	if (baudrate > 0) {
128 		divisor = z8530_divisor(bas->rclk, baudrate);
129 		if (divisor == -1)
130 			return (EINVAL);
131 	} else
132 		divisor = -1;
133 
134 	uart_setmreg(bas, WR_MCB2, UART_PCLK);
135 	uart_barrier(bas);
136 
137 	if (divisor >= 0) {
138 		uart_setmreg(bas, WR_TCL, divisor & 0xff);
139 		uart_barrier(bas);
140 		uart_setmreg(bas, WR_TCH, (divisor >> 8) & 0xff);
141 		uart_barrier(bas);
142 	}
143 
144 	uart_setmreg(bas, WR_RPC, rpc);
145 	uart_barrier(bas);
146 	uart_setmreg(bas, WR_MPM, mpm);
147 	uart_barrier(bas);
148 	uart_setmreg(bas, WR_TPC, tpc);
149 	uart_barrier(bas);
150 	uart_setmreg(bas, WR_MCB2, UART_PCLK | MCB2_BRGE);
151 	uart_barrier(bas);
152 	*tpcp = tpc;
153 	return (0);
154 }
155 
156 static int
157 z8530_setup(struct uart_bas *bas, int baudrate, int databits, int stopbits,
158     int parity)
159 {
160 	uint8_t tpc;
161 
162 	if (bas->rclk == 0)
163 		bas->rclk = DEFAULT_RCLK;
164 
165 	/* Assume we don't need to perform a full hardware reset. */
166 	switch (bas->chan) {
167 	case 1:
168 		uart_setmreg(bas, WR_MIC, MIC_NV | MIC_CRA);
169 		break;
170 	case 2:
171 		uart_setmreg(bas, WR_MIC, MIC_NV | MIC_CRB);
172 		break;
173 	}
174 	uart_barrier(bas);
175 	/* Set clock sources. */
176 	uart_setmreg(bas, WR_CMC, CMC_RC_BRG | CMC_TC_BRG);
177 	uart_setmreg(bas, WR_MCB2, UART_PCLK);
178 	uart_barrier(bas);
179 	/* Set data encoding. */
180 	uart_setmreg(bas, WR_MCB1, MCB1_NRZ);
181 	uart_barrier(bas);
182 
183 	tpc = TPC_DTR | TPC_RTS;
184 	z8530_param(bas, baudrate, databits, stopbits, parity, &tpc);
185 	return (int)tpc;
186 }
187 
188 /*
189  * Low-level UART interface.
190  */
191 static int z8530_probe(struct uart_bas *bas);
192 static void z8530_init(struct uart_bas *bas, int, int, int, int);
193 static void z8530_term(struct uart_bas *bas);
194 static void z8530_putc(struct uart_bas *bas, int);
195 static int z8530_rxready(struct uart_bas *bas);
196 static int z8530_getc(struct uart_bas *bas, struct mtx *);
197 
198 static struct uart_ops uart_z8530_ops = {
199 	.probe = z8530_probe,
200 	.init = z8530_init,
201 	.term = z8530_term,
202 	.putc = z8530_putc,
203 	.rxready = z8530_rxready,
204 	.getc = z8530_getc,
205 };
206 
207 static int
208 z8530_probe(struct uart_bas *bas)
209 {
210 
211 	return (0);
212 }
213 
214 static void
215 z8530_init(struct uart_bas *bas, int baudrate, int databits, int stopbits,
216     int parity)
217 {
218 
219 	z8530_setup(bas, baudrate, databits, stopbits, parity);
220 }
221 
222 static void
223 z8530_term(struct uart_bas *bas)
224 {
225 }
226 
227 static void
228 z8530_putc(struct uart_bas *bas, int c)
229 {
230 
231 	while (!(uart_getreg(bas, REG_CTRL) & BES_TXE))
232 		;
233 	uart_setreg(bas, REG_DATA, c);
234 	uart_barrier(bas);
235 }
236 
237 static int
238 z8530_rxready(struct uart_bas *bas)
239 {
240 
241 	return ((uart_getreg(bas, REG_CTRL) & BES_RXA) != 0 ? 1 : 0);
242 }
243 
244 static int
245 z8530_getc(struct uart_bas *bas, struct mtx *hwmtx)
246 {
247 	int c;
248 
249 	uart_lock(hwmtx);
250 
251 	while (!(uart_getreg(bas, REG_CTRL) & BES_RXA)) {
252 		uart_unlock(hwmtx);
253 		DELAY(10);
254 		uart_lock(hwmtx);
255 	}
256 
257 	c = uart_getreg(bas, REG_DATA);
258 
259 	uart_unlock(hwmtx);
260 
261 	return (c);
262 }
263 
264 /*
265  * High-level UART interface.
266  */
267 struct z8530_softc {
268 	struct uart_softc base;
269 	uint8_t	tpc;
270 	uint8_t	txidle;
271 };
272 
273 static int z8530_bus_attach(struct uart_softc *);
274 static int z8530_bus_detach(struct uart_softc *);
275 static int z8530_bus_flush(struct uart_softc *, int);
276 static int z8530_bus_getsig(struct uart_softc *);
277 static int z8530_bus_ioctl(struct uart_softc *, int, intptr_t);
278 static int z8530_bus_ipend(struct uart_softc *);
279 static int z8530_bus_param(struct uart_softc *, int, int, int, int);
280 static int z8530_bus_probe(struct uart_softc *);
281 static int z8530_bus_receive(struct uart_softc *);
282 static int z8530_bus_setsig(struct uart_softc *, int);
283 static int z8530_bus_transmit(struct uart_softc *);
284 
285 static kobj_method_t z8530_methods[] = {
286 	KOBJMETHOD(uart_attach,		z8530_bus_attach),
287 	KOBJMETHOD(uart_detach,		z8530_bus_detach),
288 	KOBJMETHOD(uart_flush,		z8530_bus_flush),
289 	KOBJMETHOD(uart_getsig,		z8530_bus_getsig),
290 	KOBJMETHOD(uart_ioctl,		z8530_bus_ioctl),
291 	KOBJMETHOD(uart_ipend,		z8530_bus_ipend),
292 	KOBJMETHOD(uart_param,		z8530_bus_param),
293 	KOBJMETHOD(uart_probe,		z8530_bus_probe),
294 	KOBJMETHOD(uart_receive,	z8530_bus_receive),
295 	KOBJMETHOD(uart_setsig,		z8530_bus_setsig),
296 	KOBJMETHOD(uart_transmit,	z8530_bus_transmit),
297 	{ 0, 0 }
298 };
299 
300 struct uart_class uart_z8530_class = {
301 	"z8530",
302 	z8530_methods,
303 	sizeof(struct z8530_softc),
304 	.uc_ops = &uart_z8530_ops,
305 	.uc_range = 2,
306 	.uc_rclk = DEFAULT_RCLK
307 };
308 
309 #define	SIGCHG(c, i, s, d)				\
310 	if (c) {					\
311 		i |= (i & s) ? s : s | d;		\
312 	} else {					\
313 		i = (i & s) ? (i & ~s) | d : i;		\
314 	}
315 
316 static int
317 z8530_bus_attach(struct uart_softc *sc)
318 {
319 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
320 	struct uart_bas *bas;
321 	struct uart_devinfo *di;
322 
323 	bas = &sc->sc_bas;
324 	if (sc->sc_sysdev != NULL) {
325 		di = sc->sc_sysdev;
326 		z8530->tpc = TPC_DTR|TPC_RTS;
327 		z8530_param(bas, di->baudrate, di->databits, di->stopbits,
328 		    di->parity, &z8530->tpc);
329 	} else {
330 		z8530->tpc = z8530_setup(bas, 9600, 8, 1, UART_PARITY_NONE);
331 		z8530->tpc &= ~(TPC_DTR|TPC_RTS);
332 	}
333 	z8530->txidle = 1;	/* Report SER_INT_TXIDLE. */
334 
335 	(void)z8530_bus_getsig(sc);
336 
337 	uart_setmreg(bas, WR_IC, IC_BRK | IC_CTS | IC_DCD);
338 	uart_barrier(bas);
339 	uart_setmreg(bas, WR_IDT, IDT_XIE | IDT_TIE | IDT_RIA);
340 	uart_barrier(bas);
341 	uart_setmreg(bas, WR_IV, 0);
342 	uart_barrier(bas);
343 	uart_setmreg(bas, WR_TPC, z8530->tpc);
344 	uart_barrier(bas);
345 	uart_setmreg(bas, WR_MIC, MIC_NV | MIC_MIE);
346 	uart_barrier(bas);
347 	return (0);
348 }
349 
350 static int
351 z8530_bus_detach(struct uart_softc *sc)
352 {
353 
354 	return (0);
355 }
356 
357 static int
358 z8530_bus_flush(struct uart_softc *sc, int what)
359 {
360 
361 	return (0);
362 }
363 
364 static int
365 z8530_bus_getsig(struct uart_softc *sc)
366 {
367 	uint32_t new, old, sig;
368 	uint8_t bes;
369 
370 	do {
371 		old = sc->sc_hwsig;
372 		sig = old;
373 		uart_lock(sc->sc_hwmtx);
374 		bes = uart_getmreg(&sc->sc_bas, RR_BES);
375 		uart_unlock(sc->sc_hwmtx);
376 		SIGCHG(bes & BES_CTS, sig, SER_CTS, SER_DCTS);
377 		SIGCHG(bes & BES_DCD, sig, SER_DCD, SER_DDCD);
378 		SIGCHG(bes & BES_SYNC, sig, SER_DSR, SER_DDSR);
379 		new = sig & ~SER_MASK_DELTA;
380 	} while (!atomic_cmpset_32(&sc->sc_hwsig, old, new));
381 	return (sig);
382 }
383 
384 static int
385 z8530_bus_ioctl(struct uart_softc *sc, int request, intptr_t data)
386 {
387 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
388 	struct uart_bas *bas;
389 	int baudrate, divisor, error;
390 
391 	bas = &sc->sc_bas;
392 	error = 0;
393 	uart_lock(sc->sc_hwmtx);
394 	switch (request) {
395 	case UART_IOCTL_BREAK:
396 		if (data)
397 			z8530->tpc |= TPC_BRK;
398 		else
399 			z8530->tpc &= ~TPC_BRK;
400 		uart_setmreg(bas, WR_TPC, z8530->tpc);
401 		uart_barrier(bas);
402 		break;
403 	case UART_IOCTL_BAUD:
404 		divisor = uart_getmreg(bas, RR_TCH);
405 		divisor = (divisor << 8) | uart_getmreg(bas, RR_TCL);
406 		baudrate = bas->rclk / 2 / (divisor + 2);
407 		*(int*)data = baudrate;
408 		break;
409 	default:
410 		error = EINVAL;
411 		break;
412 	}
413 	uart_unlock(sc->sc_hwmtx);
414 	return (error);
415 }
416 
417 static int
418 z8530_bus_ipend(struct uart_softc *sc)
419 {
420 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
421 	struct uart_bas *bas;
422 	int ipend;
423 	uint32_t sig;
424 	uint8_t bes, ip, iv, src;
425 
426 	bas = &sc->sc_bas;
427 	ipend = 0;
428 
429 	uart_lock(sc->sc_hwmtx);
430 	switch (bas->chan) {
431 	case 1:
432 		ip = uart_getmreg(bas, RR_IP);
433 		break;
434 	case 2:	/* XXX hack!!! */
435 		iv = uart_getmreg(bas, RR_IV) & 0x0E;
436 		switch (iv) {
437 		case IV_TEB:	ip = IP_TIA; break;
438 		case IV_XSB:	ip = IP_SIA; break;
439 		case IV_RAB:	ip = IP_RIA; break;
440 		default:	ip = 0; break;
441 		}
442 		break;
443 	default:
444 		ip = 0;
445 		break;
446 	}
447 
448 	if (ip & IP_RIA)
449 		ipend |= SER_INT_RXREADY;
450 
451 	if (ip & IP_TIA) {
452 		uart_setreg(bas, REG_CTRL, CR_RSTTXI);
453 		uart_barrier(bas);
454 		if (z8530->txidle) {
455 			ipend |= SER_INT_TXIDLE;
456 			z8530->txidle = 0;	/* Mask SER_INT_TXIDLE. */
457 		}
458 	}
459 
460 	if (ip & IP_SIA) {
461 		uart_setreg(bas, REG_CTRL, CR_RSTXSI);
462 		uart_barrier(bas);
463 		bes = uart_getmreg(bas, RR_BES);
464 		if (bes & BES_BRK)
465 			ipend |= SER_INT_BREAK;
466 		sig = sc->sc_hwsig;
467 		SIGCHG(bes & BES_CTS, sig, SER_CTS, SER_DCTS);
468 		SIGCHG(bes & BES_DCD, sig, SER_DCD, SER_DDCD);
469 		SIGCHG(bes & BES_SYNC, sig, SER_DSR, SER_DDSR);
470 		if (sig & SER_MASK_DELTA)
471 			ipend |= SER_INT_SIGCHG;
472 		src = uart_getmreg(bas, RR_SRC);
473 		if (src & SRC_OVR) {
474 			uart_setreg(bas, REG_CTRL, CR_RSTERR);
475 			uart_barrier(bas);
476 			ipend |= SER_INT_OVERRUN;
477 		}
478 	}
479 
480 	if (ipend) {
481 		uart_setreg(bas, REG_CTRL, CR_RSTIUS);
482 		uart_barrier(bas);
483 	}
484 
485 	uart_unlock(sc->sc_hwmtx);
486 
487 	return (ipend);
488 }
489 
490 static int
491 z8530_bus_param(struct uart_softc *sc, int baudrate, int databits,
492     int stopbits, int parity)
493 {
494 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
495 	int error;
496 
497 	uart_lock(sc->sc_hwmtx);
498 	error = z8530_param(&sc->sc_bas, baudrate, databits, stopbits, parity,
499 	    &z8530->tpc);
500 	uart_unlock(sc->sc_hwmtx);
501 	return (error);
502 }
503 
504 static int
505 z8530_bus_probe(struct uart_softc *sc)
506 {
507 	char buf[80];
508 	int error;
509 	char ch;
510 
511 	error = z8530_probe(&sc->sc_bas);
512 	if (error)
513 		return (error);
514 
515 	sc->sc_rxfifosz = 3;
516 	sc->sc_txfifosz = 1;
517 
518 	ch = sc->sc_bas.chan - 1 + 'A';
519 
520 	snprintf(buf, sizeof(buf), "z8530, channel %c", ch);
521 	device_set_desc_copy(sc->sc_dev, buf);
522 	return (0);
523 }
524 
525 static int
526 z8530_bus_receive(struct uart_softc *sc)
527 {
528 	struct uart_bas *bas;
529 	int xc;
530 	uint8_t bes, src;
531 
532 	bas = &sc->sc_bas;
533 	uart_lock(sc->sc_hwmtx);
534 	bes = uart_getmreg(bas, RR_BES);
535 	while (bes & BES_RXA) {
536 		if (uart_rx_full(sc)) {
537 			sc->sc_rxbuf[sc->sc_rxput] = UART_STAT_OVERRUN;
538 			break;
539 		}
540 		xc = uart_getreg(bas, REG_DATA);
541 		uart_barrier(bas);
542 		src = uart_getmreg(bas, RR_SRC);
543 		if (src & SRC_FE)
544 			xc |= UART_STAT_FRAMERR;
545 		if (src & SRC_PE)
546 			xc |= UART_STAT_PARERR;
547 		if (src & SRC_OVR)
548 			xc |= UART_STAT_OVERRUN;
549 		uart_rx_put(sc, xc);
550 		if (src & (SRC_FE | SRC_PE | SRC_OVR)) {
551 			uart_setreg(bas, REG_CTRL, CR_RSTERR);
552 			uart_barrier(bas);
553 		}
554 		bes = uart_getmreg(bas, RR_BES);
555 	}
556 	/* Discard everything left in the Rx FIFO. */
557 	while (bes & BES_RXA) {
558 		(void)uart_getreg(bas, REG_DATA);
559 		uart_barrier(bas);
560 		src = uart_getmreg(bas, RR_SRC);
561 		if (src & (SRC_FE | SRC_PE | SRC_OVR)) {
562 			uart_setreg(bas, REG_CTRL, CR_RSTERR);
563 			uart_barrier(bas);
564 		}
565 		bes = uart_getmreg(bas, RR_BES);
566 	}
567 	uart_unlock(sc->sc_hwmtx);
568 	return (0);
569 }
570 
571 static int
572 z8530_bus_setsig(struct uart_softc *sc, int sig)
573 {
574 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
575 	struct uart_bas *bas;
576 	uint32_t new, old;
577 
578 	bas = &sc->sc_bas;
579 	do {
580 		old = sc->sc_hwsig;
581 		new = old;
582 		if (sig & SER_DDTR) {
583 			SIGCHG(sig & SER_DTR, new, SER_DTR,
584 			    SER_DDTR);
585 		}
586 		if (sig & SER_DRTS) {
587 			SIGCHG(sig & SER_RTS, new, SER_RTS,
588 			    SER_DRTS);
589 		}
590 	} while (!atomic_cmpset_32(&sc->sc_hwsig, old, new));
591 
592 	uart_lock(sc->sc_hwmtx);
593 	if (new & SER_DTR)
594 		z8530->tpc |= TPC_DTR;
595 	else
596 		z8530->tpc &= ~TPC_DTR;
597 	if (new & SER_RTS)
598 		z8530->tpc |= TPC_RTS;
599 	else
600 		z8530->tpc &= ~TPC_RTS;
601 	uart_setmreg(bas, WR_TPC, z8530->tpc);
602 	uart_barrier(bas);
603 	uart_unlock(sc->sc_hwmtx);
604 	return (0);
605 }
606 
607 static int
608 z8530_bus_transmit(struct uart_softc *sc)
609 {
610 	struct z8530_softc *z8530 = (struct z8530_softc*)sc;
611 	struct uart_bas *bas;
612 
613 	bas = &sc->sc_bas;
614 	uart_lock(sc->sc_hwmtx);
615 	while (!(uart_getmreg(bas, RR_BES) & BES_TXE))
616 		;
617 	uart_setreg(bas, REG_DATA, sc->sc_txbuf[0]);
618 	uart_barrier(bas);
619 	sc->sc_txbusy = 1;
620 	z8530->txidle = 1;	/* Report SER_INT_TXIDLE again. */
621 	uart_unlock(sc->sc_hwmtx);
622 	return (0);
623 }
624