xref: /kernel/linux/linux-6.6/drivers/tty/serial/zs.h (revision 62306a36)
1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * zs.h: Definitions for the DECstation Z85C30 serial driver.
4 *
5 * Adapted from drivers/sbus/char/sunserial.h by Paul Mackerras.
6 * Adapted from drivers/macintosh/macserial.h by Harald Koerfgen.
7 *
8 * Copyright (C) 1996 Paul Mackerras (Paul.Mackerras@cs.anu.edu.au)
9 * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu)
10 * Copyright (C) 2004, 2005, 2007  Maciej W. Rozycki
11 */
12#ifndef _SERIAL_ZS_H
13#define _SERIAL_ZS_H
14
15#ifdef __KERNEL__
16
17#define ZS_NUM_REGS 16
18
19/*
20 * This is our internal structure for each serial port's state.
21 */
22struct zs_port {
23	struct zs_scc	*scc;			/* Containing SCC.  */
24	struct uart_port port;			/* Underlying UART.  */
25
26	int		clk_mode;		/* May be 1, 16, 32, or 64.  */
27
28	unsigned int	tty_break;		/* Set on BREAK condition.  */
29	int		tx_stopped;		/* Output is suspended.  */
30
31	unsigned int	mctrl;			/* State of modem lines.  */
32	u8		brk;			/* BREAK state from RR0.  */
33
34	u8		regs[ZS_NUM_REGS];	/* Channel write registers.  */
35};
36
37/*
38 * Per-SCC state for locking and the interrupt handler.
39 */
40struct zs_scc {
41	struct zs_port	zport[2];
42	spinlock_t	zlock;
43	atomic_t	irq_guard;
44	int		initialised;
45};
46
47#endif /* __KERNEL__ */
48
49/*
50 * Conversion routines to/from brg time constants from/to bits per second.
51 */
52#define ZS_BRG_TO_BPS(brg, freq) ((freq) / 2 / ((brg) + 2))
53#define ZS_BPS_TO_BRG(bps, freq) ((((freq) + (bps)) / (2 * (bps))) - 2)
54
55/*
56 * The Zilog register set.
57 */
58
59/* Write Register 0 (Command) */
60#define R0		0	/* Register selects */
61#define R1		1
62#define R2		2
63#define R3		3
64#define R4		4
65#define R5		5
66#define R6		6
67#define R7		7
68#define R8		8
69#define R9		9
70#define R10		10
71#define R11		11
72#define R12		12
73#define R13		13
74#define R14		14
75#define R15		15
76
77#define NULLCODE	0	/* Null Code */
78#define POINT_HIGH	0x8	/* Select upper half of registers */
79#define RES_EXT_INT	0x10	/* Reset Ext. Status Interrupts */
80#define SEND_ABORT	0x18	/* HDLC Abort */
81#define RES_RxINT_FC	0x20	/* Reset RxINT on First Character */
82#define RES_Tx_P	0x28	/* Reset TxINT Pending */
83#define ERR_RES		0x30	/* Error Reset */
84#define RES_H_IUS	0x38	/* Reset highest IUS */
85
86#define RES_Rx_CRC	0x40	/* Reset Rx CRC Checker */
87#define RES_Tx_CRC	0x80	/* Reset Tx CRC Checker */
88#define RES_EOM_L	0xC0	/* Reset EOM latch */
89
90/* Write Register 1 (Tx/Rx/Ext Int Enable and WAIT/DMA Commands) */
91#define EXT_INT_ENAB	0x1	/* Ext Int Enable */
92#define TxINT_ENAB	0x2	/* Tx Int Enable */
93#define PAR_SPEC	0x4	/* Parity is special condition */
94
95#define RxINT_DISAB	0	/* Rx Int Disable */
96#define RxINT_FCERR	0x8	/* Rx Int on First Character Only or Error */
97#define RxINT_ALL	0x10	/* Int on all Rx Characters or error */
98#define RxINT_ERR	0x18	/* Int on error only */
99#define RxINT_MASK	0x18
100
101#define WT_RDY_RT	0x20	/* Wait/Ready on R/T */
102#define WT_FN_RDYFN	0x40	/* Wait/FN/Ready FN */
103#define WT_RDY_ENAB	0x80	/* Wait/Ready Enable */
104
105/* Write Register 2 (Interrupt Vector) */
106
107/* Write Register 3 (Receive Parameters and Control) */
108#define RxENABLE	0x1	/* Rx Enable */
109#define SYNC_L_INH	0x2	/* Sync Character Load Inhibit */
110#define ADD_SM		0x4	/* Address Search Mode (SDLC) */
111#define RxCRC_ENAB	0x8	/* Rx CRC Enable */
112#define ENT_HM		0x10	/* Enter Hunt Mode */
113#define AUTO_ENAB	0x20	/* Auto Enables */
114#define Rx5		0x0	/* Rx 5 Bits/Character */
115#define Rx7		0x40	/* Rx 7 Bits/Character */
116#define Rx6		0x80	/* Rx 6 Bits/Character */
117#define Rx8		0xc0	/* Rx 8 Bits/Character */
118#define RxNBITS_MASK	0xc0
119
120/* Write Register 4 (Transmit/Receive Miscellaneous Parameters and Modes) */
121#define PAR_ENA		0x1	/* Parity Enable */
122#define PAR_EVEN	0x2	/* Parity Even/Odd* */
123
124#define SYNC_ENAB	0	/* Sync Modes Enable */
125#define SB1		0x4	/* 1 stop bit/char */
126#define SB15		0x8	/* 1.5 stop bits/char */
127#define SB2		0xc	/* 2 stop bits/char */
128#define SB_MASK		0xc
129
130#define MONSYNC		0	/* 8 Bit Sync character */
131#define BISYNC		0x10	/* 16 bit sync character */
132#define SDLC		0x20	/* SDLC Mode (01111110 Sync Flag) */
133#define EXTSYNC		0x30	/* External Sync Mode */
134
135#define X1CLK		0x0	/* x1 clock mode */
136#define X16CLK		0x40	/* x16 clock mode */
137#define X32CLK		0x80	/* x32 clock mode */
138#define X64CLK		0xc0	/* x64 clock mode */
139#define XCLK_MASK	0xc0
140
141/* Write Register 5 (Transmit Parameters and Controls) */
142#define TxCRC_ENAB	0x1	/* Tx CRC Enable */
143#define RTS		0x2	/* RTS */
144#define SDLC_CRC	0x4	/* SDLC/CRC-16 */
145#define TxENAB		0x8	/* Tx Enable */
146#define SND_BRK		0x10	/* Send Break */
147#define Tx5		0x0	/* Tx 5 bits (or less)/character */
148#define Tx7		0x20	/* Tx 7 bits/character */
149#define Tx6		0x40	/* Tx 6 bits/character */
150#define Tx8		0x60	/* Tx 8 bits/character */
151#define TxNBITS_MASK	0x60
152#define DTR		0x80	/* DTR */
153
154/* Write Register 6 (Sync bits 0-7/SDLC Address Field) */
155
156/* Write Register 7 (Sync bits 8-15/SDLC 01111110) */
157
158/* Write Register 8 (Transmit Buffer) */
159
160/* Write Register 9 (Master Interrupt Control) */
161#define VIS		1	/* Vector Includes Status */
162#define NV		2	/* No Vector */
163#define DLC		4	/* Disable Lower Chain */
164#define MIE		8	/* Master Interrupt Enable */
165#define STATHI		0x10	/* Status high */
166#define SOFTACK		0x20	/* Software Interrupt Acknowledge */
167#define NORESET		0	/* No reset on write to R9 */
168#define CHRB		0x40	/* Reset channel B */
169#define CHRA		0x80	/* Reset channel A */
170#define FHWRES		0xc0	/* Force hardware reset */
171
172/* Write Register 10 (Miscellaneous Transmitter/Receiver Control Bits) */
173#define BIT6		1	/* 6 bit/8bit sync */
174#define LOOPMODE	2	/* SDLC Loop mode */
175#define ABUNDER		4	/* Abort/flag on SDLC xmit underrun */
176#define MARKIDLE	8	/* Mark/flag on idle */
177#define GAOP		0x10	/* Go active on poll */
178#define NRZ		0	/* NRZ mode */
179#define NRZI		0x20	/* NRZI mode */
180#define FM1		0x40	/* FM1 (transition = 1) */
181#define FM0		0x60	/* FM0 (transition = 0) */
182#define CRCPS		0x80	/* CRC Preset I/O */
183
184/* Write Register 11 (Clock Mode Control) */
185#define TRxCXT		0	/* TRxC = Xtal output */
186#define TRxCTC		1	/* TRxC = Transmit clock */
187#define TRxCBR		2	/* TRxC = BR Generator Output */
188#define TRxCDP		3	/* TRxC = DPLL output */
189#define TRxCOI		4	/* TRxC O/I */
190#define TCRTxCP		0	/* Transmit clock = RTxC pin */
191#define TCTRxCP		8	/* Transmit clock = TRxC pin */
192#define TCBR		0x10	/* Transmit clock = BR Generator output */
193#define TCDPLL		0x18	/* Transmit clock = DPLL output */
194#define RCRTxCP		0	/* Receive clock = RTxC pin */
195#define RCTRxCP		0x20	/* Receive clock = TRxC pin */
196#define RCBR		0x40	/* Receive clock = BR Generator output */
197#define RCDPLL		0x60	/* Receive clock = DPLL output */
198#define RTxCX		0x80	/* RTxC Xtal/No Xtal */
199
200/* Write Register 12 (Lower Byte of Baud Rate Generator Time Constant) */
201
202/* Write Register 13 (Upper Byte of Baud Rate Generator Time Constant) */
203
204/* Write Register 14 (Miscellaneous Control Bits) */
205#define BRENABL		1	/* Baud rate generator enable */
206#define BRSRC		2	/* Baud rate generator source */
207#define DTRREQ		4	/* DTR/Request function */
208#define AUTOECHO	8	/* Auto Echo */
209#define LOOPBAK		0x10	/* Local loopback */
210#define SEARCH		0x20	/* Enter search mode */
211#define RMC		0x40	/* Reset missing clock */
212#define DISDPLL		0x60	/* Disable DPLL */
213#define SSBR		0x80	/* Set DPLL source = BR generator */
214#define SSRTxC		0xa0	/* Set DPLL source = RTxC */
215#define SFMM		0xc0	/* Set FM mode */
216#define SNRZI		0xe0	/* Set NRZI mode */
217
218/* Write Register 15 (External/Status Interrupt Control) */
219#define WR7P_EN		1	/* WR7 Prime SDLC Feature Enable */
220#define ZCIE		2	/* Zero count IE */
221#define DCDIE		8	/* DCD IE */
222#define SYNCIE		0x10	/* Sync/hunt IE */
223#define CTSIE		0x20	/* CTS IE */
224#define TxUIE		0x40	/* Tx Underrun/EOM IE */
225#define BRKIE		0x80	/* Break/Abort IE */
226
227
228/* Read Register 0 (Transmit/Receive Buffer Status and External Status) */
229#define Rx_CH_AV	0x1	/* Rx Character Available */
230#define ZCOUNT		0x2	/* Zero count */
231#define Tx_BUF_EMP	0x4	/* Tx Buffer empty */
232#define DCD		0x8	/* DCD */
233#define SYNC_HUNT	0x10	/* Sync/hunt */
234#define CTS		0x20	/* CTS */
235#define TxEOM		0x40	/* Tx underrun */
236#define BRK_ABRT	0x80	/* Break/Abort */
237
238/* Read Register 1 (Special Receive Condition Status) */
239#define ALL_SNT		0x1	/* All sent */
240/* Residue Data for 8 Rx bits/char programmed */
241#define RES3		0x8	/* 0/3 */
242#define RES4		0x4	/* 0/4 */
243#define RES5		0xc	/* 0/5 */
244#define RES6		0x2	/* 0/6 */
245#define RES7		0xa	/* 0/7 */
246#define RES8		0x6	/* 0/8 */
247#define RES18		0xe	/* 1/8 */
248#define RES28		0x0	/* 2/8 */
249/* Special Rx Condition Interrupts */
250#define PAR_ERR		0x10	/* Parity Error */
251#define Rx_OVR		0x20	/* Rx Overrun Error */
252#define FRM_ERR		0x40	/* CRC/Framing Error */
253#define END_FR		0x80	/* End of Frame (SDLC) */
254
255/* Read Register 2 (Interrupt Vector (WR2) -- channel A).  */
256
257/* Read Register 2 (Modified Interrupt Vector -- channel B).  */
258
259/* Read Register 3 (Interrupt Pending Bits -- channel A only).  */
260#define CHBEXT		0x1	/* Channel B Ext/Stat IP */
261#define CHBTxIP		0x2	/* Channel B Tx IP */
262#define CHBRxIP		0x4	/* Channel B Rx IP */
263#define CHAEXT		0x8	/* Channel A Ext/Stat IP */
264#define CHATxIP		0x10	/* Channel A Tx IP */
265#define CHARxIP		0x20	/* Channel A Rx IP */
266
267/* Read Register 6 (SDLC FIFO Status and Byte Count LSB) */
268
269/* Read Register 7 (SDLC FIFO Status and Byte Count MSB) */
270
271/* Read Register 8 (Receive Data) */
272
273/* Read Register 10 (Miscellaneous Status Bits) */
274#define ONLOOP		2	/* On loop */
275#define LOOPSEND	0x10	/* Loop sending */
276#define CLK2MIS		0x40	/* Two clocks missing */
277#define CLK1MIS		0x80	/* One clock missing */
278
279/* Read Register 12 (Lower Byte of Baud Rate Generator Constant (WR12)) */
280
281/* Read Register 13 (Upper Byte of Baud Rate Generator Constant (WR13) */
282
283/* Read Register 15 (External/Status Interrupt Control (WR15)) */
284
285#endif /* _SERIAL_ZS_H */
286