1 /*
2  * macserial.h: Definitions for the Macintosh Z8530 serial driver.
3  *
4  * Adapted from drivers/sbus/char/sunserial.h by Paul Mackerras.
5  *
6  * Copyright (C) 1996 Paul Mackerras (Paul.Mackerras@cs.anu.edu.au)
7  * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu)
8  */
9 #ifndef _MACSERIAL_H
10 #define _MACSERIAL_H
11 
12 #define NUM_ZSREGS    16
13 
14 struct serial_struct {
15 	int	type;
16 	int	line;
17 	int	port;
18 	int	irq;
19 	int	flags;
20 	int	xmit_fifo_size;
21 	int	custom_divisor;
22 	int	baud_base;
23 	unsigned short	close_delay;
24 	char	reserved_char[2];
25 	int	hub6;
26 	unsigned short	closing_wait; /* time to wait before closing */
27 	unsigned short	closing_wait2; /* no longer used... */
28 	int	reserved[4];
29 };
30 
31 /*
32  * For the close wait times, 0 means wait forever for serial port to
33  * flush its output.  65535 means don't wait at all.
34  */
35 #define ZILOG_CLOSING_WAIT_INF	0
36 #define ZILOG_CLOSING_WAIT_NONE	65535
37 
38 /*
39  * Definitions for ZILOG_struct (and serial_struct) flags field
40  */
41 #define ZILOG_HUP_NOTIFY	0x0001	/* Notify getty on hangups and closes
42 				   	 * on the callout port */
43 #define ZILOG_FOURPORT 		0x0002	/* Set OU1, OUT2 per AST Fourport settings */
44 #define ZILOG_SAK		0x0004	/* Secure Attention Key (Orange book) */
45 #define ZILOG_SPLIT_TERMIOS	0x0008	/* Separate termios for dialin/callout */
46 
47 #define ZILOG_SPD_MASK		0x0030
48 #define ZILOG_SPD_HI		0x0010	/* Use 56000 instead of 38400 bps */
49 
50 #define ZILOG_SPD_VHI		0x0020  /* Use 115200 instead of 38400 bps */
51 #define ZILOG_SPD_CUST		0x0030  /* Use user-specified divisor */
52 
53 #define ZILOG_SKIP_TEST		0x0040	/* Skip UART test during autoconfiguration */
54 #define ZILOG_AUTO_IRQ 		0x0080	/* Do automatic IRQ during autoconfiguration */
55 #define ZILOG_SESSION_LOCKOUT	0x0100	/* Lock out cua opens based on session */
56 #define ZILOG_PGRP_LOCKOUT	0x0200	/* Lock out cua opens based on pgrp */
57 #define ZILOG_CALLOUT_NOHUP	0x0400	/* Don't do hangups for cua device */
58 
59 #define ZILOG_FLAGS		0x0FFF	/* Possible legal ZILOG flags */
60 #define ZILOG_USR_MASK		0x0430	/* Legal flags that non-privileged
61 					 * users can set or reset */
62 
63 /* Internal flags used only by kernel/chr_drv/serial.c */
64 #define ZILOG_INITIALIZED	0x80000000 /* Serial port was initialized */
65 #define ZILOG_CALLOUT_ACTIVE	0x40000000 /* Call out device is active */
66 #define ZILOG_NORMAL_ACTIVE	0x20000000 /* Normal device is active */
67 #define ZILOG_BOOT_AUTOCONF	0x10000000 /* Autoconfigure port on bootup */
68 #define ZILOG_CLOSING		0x08000000 /* Serial port is closing */
69 #define ZILOG_CTS_FLOW		0x04000000 /* Do CTS flow control */
70 #define ZILOG_CHECK_CD		0x02000000 /* i.e., CLOCAL */
71 #define ZILOG_SLEEPING		0x01000000 /* have shut it down for sleep */
72 
73 /* Software state per channel */
74 
75 #ifdef __KERNEL__
76 /*
77  * This is our internal structure for each serial port's state.
78  *
79  * Many fields are paralleled by the structure used by the serial_struct
80  * structure.
81  *
82  * For definitions of the flags field, see tty.h
83  */
84 
85 struct mac_serial;
86 
87 struct mac_zschannel {
88 	volatile unsigned char*	control;
89 	volatile unsigned char*	data;
90 	spinlock_t		lock;
91 	/* Used for debugging */
92 	struct mac_serial*	parent;
93 };
94 
95 struct mac_dma {
96 	volatile struct dbdma_regs	dma;
97 	volatile unsigned short		res_count;
98 	volatile unsigned short		command;
99 	volatile unsigned int		buf_addr;
100 };
101 
102 struct mac_serial {
103 	struct mac_serial *zs_next;	/* For IRQ servicing chain */
104 	struct mac_zschannel *zs_channel; /* Channel registers */
105 	struct mac_zschannel *zs_chan_a;	/* A side registers */
106 	unsigned char read_reg_zero;
107 	struct device_node* dev_node;
108 
109 	char soft_carrier;  /* Use soft carrier on this channel */
110 	char break_abort;   /* Is serial console in, so process brk/abrt */
111 	char kgdb_channel;  /* Kgdb is running on this channel */
112 	char is_cons;       /* Is this our console. */
113 	char is_internal_modem; /* is connected to an internal modem */
114 	char is_irda;		/* is connected to an IrDA codec */
115 	int port_type;		/* Port type for pmac_feature */
116 	unsigned char tx_active; /* character is being xmitted */
117 	unsigned char tx_stopped; /* output is suspended */
118 	unsigned char power_wait; /* waiting for power-up delay to expire */
119 
120 	/* We need to know the current clock divisor
121 	 * to read the bps rate the chip has currently
122 	 * loaded.
123 	 */
124 	unsigned char clk_divisor;  /* May be 1, 16, 32, or 64 */
125 	int zs_baud;
126 
127 	/* Current write register values */
128 	unsigned char curregs[NUM_ZSREGS];
129 
130 	/* Values we need to set next opportunity */
131 	unsigned char pendregs[NUM_ZSREGS];
132 
133 	char change_needed;
134 
135 	int			magic;
136 	int			baud_base;
137 	int			port;
138 	int			irq;
139 	int			flags; 		/* defined in tty.h */
140 	int			type; 		/* UART type */
141 	struct tty_struct 	*tty;
142 	int			read_status_mask;
143 	int			ignore_status_mask;
144 	int			timeout;
145 	int			xmit_fifo_size;
146 	int			custom_divisor;
147 	int			x_char;	/* xon/xoff character */
148 	int			close_delay;
149 	unsigned short		closing_wait;
150 	unsigned short		closing_wait2;
151 	unsigned long		event;
152 	unsigned long		last_active;
153 	int			line;
154 	int			count;	    /* # of fd on device */
155 	int			blocked_open; /* # of blocked opens */
156 	long			session; /* Session of opening process */
157 	long			pgrp; /* pgrp of opening process */
158 	unsigned char 		*xmit_buf;
159 	int			xmit_head;
160 	int			xmit_tail;
161 	int			xmit_cnt;
162 	struct tq_struct	tqueue;
163 	struct tq_struct	tqueue_hangup;
164 	struct termios		normal_termios;
165 	struct termios		callout_termios;
166 	wait_queue_head_t	open_wait;
167 	wait_queue_head_t	close_wait;
168 
169 	volatile struct dbdma_regs *tx_dma;
170 	int			tx_dma_irq;
171 	volatile struct dbdma_cmd *tx_cmds;
172 	volatile struct mac_dma *rx;
173 	int 			rx_dma_irq;
174 	volatile struct dbdma_cmd **rx_cmds;
175 	unsigned char		**rx_char_buf;
176 	unsigned char		**rx_flag_buf;
177 #define	RX_BUF_SIZE	256
178 	int			rx_nbuf;
179 	int			rx_done_bytes;
180 	int			rx_ubuf;
181 	int			rx_fbuf;
182 #define	RX_NO_FBUF	(-1)
183 	int			rx_cbuf;
184 	spinlock_t		rx_dma_lock;
185 	int			has_dma;
186 	int			dma_initted;
187 	void			*dma_priv;
188 	struct timer_list	poll_dma_timer;
189 #define RX_DMA_TIMER	(jiffies + 10*HZ/1000)
190 
191 	struct timer_list	powerup_timer;
192 };
193 
194 
195 #define SERIAL_MAGIC 0x5301
196 
197 /*
198  * The size of the serial xmit buffer is 1 page, or 4096 bytes
199  */
200 #define SERIAL_XMIT_SIZE 4096
201 
202 /*
203  * Events are used to schedule things to happen at timer-interrupt
204  * time, instead of at rs interrupt time.
205  */
206 #define RS_EVENT_WRITE_WAKEUP	0
207 
208 #endif /* __KERNEL__ */
209 
210 /* Conversion routines to/from brg time constants from/to bits
211  * per second.
212  */
213 #define BRG_TO_BPS(brg, freq) ((freq) / 2 / ((brg) + 2))
214 #define BPS_TO_BRG(bps, freq) ((((freq) + (bps)) / (2 * (bps))) - 2)
215 
216 /* The Zilog register set */
217 
218 #define	FLAG	0x7e
219 
220 /* Write Register 0 */
221 #define	R0	0		/* Register selects */
222 #define	R1	1
223 #define	R2	2
224 #define	R3	3
225 #define	R4	4
226 #define	R5	5
227 #define	R6	6
228 #define	R7	7
229 #define	R8	8
230 #define	R9	9
231 #define	R10	10
232 #define	R11	11
233 #define	R12	12
234 #define	R13	13
235 #define	R14	14
236 #define	R15	15
237 
238 #define	NULLCODE	0	/* Null Code */
239 #define	POINT_HIGH	0x8	/* Select upper half of registers */
240 #define	RES_EXT_INT	0x10	/* Reset Ext. Status Interrupts */
241 #define	SEND_ABORT	0x18	/* HDLC Abort */
242 #define	RES_RxINT_FC	0x20	/* Reset RxINT on First Character */
243 #define	RES_Tx_P	0x28	/* Reset TxINT Pending */
244 #define	ERR_RES		0x30	/* Error Reset */
245 #define	RES_H_IUS	0x38	/* Reset highest IUS */
246 
247 #define	RES_Rx_CRC	0x40	/* Reset Rx CRC Checker */
248 #define	RES_Tx_CRC	0x80	/* Reset Tx CRC Checker */
249 #define	RES_EOM_L	0xC0	/* Reset EOM latch */
250 
251 /* Write Register 1 */
252 
253 #define	EXT_INT_ENAB	0x1	/* Ext Int Enable */
254 #define	TxINT_ENAB	0x2	/* Tx Int Enable */
255 #define	PAR_SPEC	0x4	/* Parity is special condition */
256 
257 #define	RxINT_DISAB	0	/* Rx Int Disable */
258 #define	RxINT_FCERR	0x8	/* Rx Int on First Character Only or Error */
259 #define	INT_ALL_Rx	0x10	/* Int on all Rx Characters or error */
260 #define	INT_ERR_Rx	0x18	/* Int on error only */
261 
262 #define	WT_RDY_RT	0x20	/* W/Req reflects recv if 1, xmit if 0 */
263 #define	WT_FN_RDYFN	0x40	/* W/Req pin is DMA request if 1, wait if 0 */
264 #define	WT_RDY_ENAB	0x80	/* Enable W/Req pin */
265 
266 /* Write Register #2 (Interrupt Vector) */
267 
268 /* Write Register 3 */
269 
270 #define	RxENABLE	0x1	/* Rx Enable */
271 #define	SYNC_L_INH	0x2	/* Sync Character Load Inhibit */
272 #define	ADD_SM		0x4	/* Address Search Mode (SDLC) */
273 #define	RxCRC_ENAB	0x8	/* Rx CRC Enable */
274 #define	ENT_HM		0x10	/* Enter Hunt Mode */
275 #define	AUTO_ENAB	0x20	/* Auto Enables */
276 #define	Rx5		0x0	/* Rx 5 Bits/Character */
277 #define	Rx7		0x40	/* Rx 7 Bits/Character */
278 #define	Rx6		0x80	/* Rx 6 Bits/Character */
279 #define	Rx8		0xc0	/* Rx 8 Bits/Character */
280 #define RxNBITS_MASK	0xc0
281 
282 /* Write Register 4 */
283 
284 #define	PAR_ENA		0x1	/* Parity Enable */
285 #define	PAR_EVEN	0x2	/* Parity Even/Odd* */
286 
287 #define	SYNC_ENAB	0	/* Sync Modes Enable */
288 #define	SB1		0x4	/* 1 stop bit/char */
289 #define	SB15		0x8	/* 1.5 stop bits/char */
290 #define	SB2		0xc	/* 2 stop bits/char */
291 #define SB_MASK		0xc
292 
293 #define	MONSYNC		0	/* 8 Bit Sync character */
294 #define	BISYNC		0x10	/* 16 bit sync character */
295 #define	SDLC		0x20	/* SDLC Mode (01111110 Sync Flag) */
296 #define	EXTSYNC		0x30	/* External Sync Mode */
297 
298 #define	X1CLK		0x0	/* x1 clock mode */
299 #define	X16CLK		0x40	/* x16 clock mode */
300 #define	X32CLK		0x80	/* x32 clock mode */
301 #define	X64CLK		0xC0	/* x64 clock mode */
302 #define XCLK_MASK	0xC0
303 
304 /* Write Register 5 */
305 
306 #define	TxCRC_ENAB	0x1	/* Tx CRC Enable */
307 #define	RTS		0x2	/* RTS */
308 #define	SDLC_CRC	0x4	/* SDLC/CRC-16 */
309 #define	TxENAB		0x8	/* Tx Enable */
310 #define	SND_BRK		0x10	/* Send Break */
311 #define	Tx5		0x0	/* Tx 5 bits (or less)/character */
312 #define	Tx7		0x20	/* Tx 7 bits/character */
313 #define	Tx6		0x40	/* Tx 6 bits/character */
314 #define	Tx8		0x60	/* Tx 8 bits/character */
315 #define TxNBITS_MASK	0x60
316 #define	DTR		0x80	/* DTR */
317 
318 /* Write Register 6 (Sync bits 0-7/SDLC Address Field) */
319 
320 /* Write Register 7 (Sync bits 8-15/SDLC 01111110) */
321 
322 /* Write Register 7' (Some enhanced feature control) */
323 #define	ENEXREAD	0x40	/* Enable read of some write registers */
324 
325 /* Write Register 8 (transmit buffer) */
326 
327 /* Write Register 9 (Master interrupt control) */
328 #define	VIS	1	/* Vector Includes Status */
329 #define	NV	2	/* No Vector */
330 #define	DLC	4	/* Disable Lower Chain */
331 #define	MIE	8	/* Master Interrupt Enable */
332 #define	STATHI	0x10	/* Status high */
333 #define	NORESET	0	/* No reset on write to R9 */
334 #define	CHRB	0x40	/* Reset channel B */
335 #define	CHRA	0x80	/* Reset channel A */
336 #define	FHWRES	0xc0	/* Force hardware reset */
337 
338 /* Write Register 10 (misc control bits) */
339 #define	BIT6	1	/* 6 bit/8bit sync */
340 #define	LOOPMODE 2	/* SDLC Loop mode */
341 #define	ABUNDER	4	/* Abort/flag on SDLC xmit underrun */
342 #define	MARKIDLE 8	/* Mark/flag on idle */
343 #define	GAOP	0x10	/* Go active on poll */
344 #define	NRZ	0	/* NRZ mode */
345 #define	NRZI	0x20	/* NRZI mode */
346 #define	FM1	0x40	/* FM1 (transition = 1) */
347 #define	FM0	0x60	/* FM0 (transition = 0) */
348 #define	CRCPS	0x80	/* CRC Preset I/O */
349 
350 /* Write Register 11 (Clock Mode control) */
351 #define	TRxCXT	0	/* TRxC = Xtal output */
352 #define	TRxCTC	1	/* TRxC = Transmit clock */
353 #define	TRxCBR	2	/* TRxC = BR Generator Output */
354 #define	TRxCDP	3	/* TRxC = DPLL output */
355 #define	TRxCOI	4	/* TRxC O/I */
356 #define	TCRTxCP	0	/* Transmit clock = RTxC pin */
357 #define	TCTRxCP	8	/* Transmit clock = TRxC pin */
358 #define	TCBR	0x10	/* Transmit clock = BR Generator output */
359 #define	TCDPLL	0x18	/* Transmit clock = DPLL output */
360 #define	RCRTxCP	0	/* Receive clock = RTxC pin */
361 #define	RCTRxCP	0x20	/* Receive clock = TRxC pin */
362 #define	RCBR	0x40	/* Receive clock = BR Generator output */
363 #define	RCDPLL	0x60	/* Receive clock = DPLL output */
364 #define	RTxCX	0x80	/* RTxC Xtal/No Xtal */
365 
366 /* Write Register 12 (lower byte of baud rate generator time constant) */
367 
368 /* Write Register 13 (upper byte of baud rate generator time constant) */
369 
370 /* Write Register 14 (Misc control bits) */
371 #define	BRENABL	1	/* Baud rate generator enable */
372 #define	BRSRC	2	/* Baud rate generator source */
373 #define	DTRREQ	4	/* DTR/Request function */
374 #define	AUTOECHO 8	/* Auto Echo */
375 #define	LOOPBAK	0x10	/* Local loopback */
376 #define	SEARCH	0x20	/* Enter search mode */
377 #define	RMC	0x40	/* Reset missing clock */
378 #define	DISDPLL	0x60	/* Disable DPLL */
379 #define	SSBR	0x80	/* Set DPLL source = BR generator */
380 #define	SSRTxC	0xa0	/* Set DPLL source = RTxC */
381 #define	SFMM	0xc0	/* Set FM mode */
382 #define	SNRZI	0xe0	/* Set NRZI mode */
383 
384 /* Write Register 15 (external/status interrupt control) */
385 #define	EN85C30	1	/* Enable some 85c30-enhanced registers */
386 #define	ZCIE	2	/* Zero count IE */
387 #define	ENSTFIFO 4	/* Enable status FIFO (SDLC) */
388 #define	DCDIE	8	/* DCD IE */
389 #define	SYNCIE	0x10	/* Sync/hunt IE */
390 #define	CTSIE	0x20	/* CTS IE */
391 #define	TxUIE	0x40	/* Tx Underrun/EOM IE */
392 #define	BRKIE	0x80	/* Break/Abort IE */
393 
394 
395 /* Read Register 0 */
396 #define	Rx_CH_AV	0x1	/* Rx Character Available */
397 #define	ZCOUNT		0x2	/* Zero count */
398 #define	Tx_BUF_EMP	0x4	/* Tx Buffer empty */
399 #define	DCD		0x8	/* DCD */
400 #define	SYNC_HUNT	0x10	/* Sync/hunt */
401 #define	CTS		0x20	/* CTS */
402 #define	TxEOM		0x40	/* Tx underrun */
403 #define	BRK_ABRT	0x80	/* Break/Abort */
404 
405 /* Read Register 1 */
406 #define	ALL_SNT		0x1	/* All sent */
407 /* Residue Data for 8 Rx bits/char programmed */
408 #define	RES3		0x8	/* 0/3 */
409 #define	RES4		0x4	/* 0/4 */
410 #define	RES5		0xc	/* 0/5 */
411 #define	RES6		0x2	/* 0/6 */
412 #define	RES7		0xa	/* 0/7 */
413 #define	RES8		0x6	/* 0/8 */
414 #define	RES18		0xe	/* 1/8 */
415 #define	RES28		0x0	/* 2/8 */
416 /* Special Rx Condition Interrupts */
417 #define	PAR_ERR		0x10	/* Parity error */
418 #define	Rx_OVR		0x20	/* Rx Overrun Error */
419 #define	FRM_ERR		0x40	/* CRC/Framing Error */
420 #define	END_FR		0x80	/* End of Frame (SDLC) */
421 
422 /* Read Register 2 (channel b only) - Interrupt vector */
423 #define	CHB_Tx_EMPTY	0x00
424 #define	CHB_EXT_STAT	0x02
425 #define	CHB_Rx_AVAIL	0x04
426 #define	CHB_SPECIAL	0x06
427 #define	CHA_Tx_EMPTY	0x08
428 #define	CHA_EXT_STAT	0x0a
429 #define	CHA_Rx_AVAIL	0x0c
430 #define	CHA_SPECIAL	0x0e
431 #define	STATUS_MASK	0x06
432 
433 /* Read Register 3 (interrupt pending register) ch a only */
434 #define	CHBEXT	0x1		/* Channel B Ext/Stat IP */
435 #define	CHBTxIP	0x2		/* Channel B Tx IP */
436 #define	CHBRxIP	0x4		/* Channel B Rx IP */
437 #define	CHAEXT	0x8		/* Channel A Ext/Stat IP */
438 #define	CHATxIP	0x10		/* Channel A Tx IP */
439 #define	CHARxIP	0x20		/* Channel A Rx IP */
440 
441 /* Read Register 8 (receive data register) */
442 
443 /* Read Register 10  (misc status bits) */
444 #define	ONLOOP	2		/* On loop */
445 #define	LOOPSEND 0x10		/* Loop sending */
446 #define	CLK2MIS	0x40		/* Two clocks missing */
447 #define	CLK1MIS	0x80		/* One clock missing */
448 
449 /* Read Register 12 (lower byte of baud rate generator constant) */
450 
451 /* Read Register 13 (upper byte of baud rate generator constant) */
452 
453 /* Read Register 15 (value of WR 15) */
454 
455 /* Misc macros */
456 #define ZS_CLEARERR(channel)    (write_zsreg(channel, 0, ERR_RES))
457 #define ZS_CLEARFIFO(channel)   do { volatile unsigned char garbage; \
458 				     garbage = read_zsdata(channel); \
459 				     garbage = read_zsdata(channel); \
460 				     garbage = read_zsdata(channel); \
461 				} while(0)
462 
463 #endif /* !(_MACSERIAL_H) */
464