xref: /netbsd/sys/dev/ic/z8530sc.h (revision bf9ec67e)
1 /*	$NetBSD: z8530sc.h,v 1.15 2001/05/11 01:40:48 thorpej Exp $	*/
2 
3 /*
4  * Copyright (c) 1994 Gordon W. Ross
5  * Copyright (c) 1992, 1993
6  *	The Regents of the University of California.  All rights reserved.
7  *
8  * This software was developed by the Computer Systems Engineering group
9  * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
10  * contributed to Berkeley.
11  *
12  * All advertising materials mentioning features or use of this software
13  * must display the following acknowledgement:
14  *	This product includes software developed by the University of
15  *	California, Lawrence Berkeley Laboratory.
16  *
17  * Redistribution and use in source and binary forms, with or without
18  * modification, are permitted provided that the following conditions
19  * are met:
20  * 1. Redistributions of source code must retain the above copyright
21  *    notice, this list of conditions and the following disclaimer.
22  * 2. Redistributions in binary form must reproduce the above copyright
23  *    notice, this list of conditions and the following disclaimer in the
24  *    documentation and/or other materials provided with the distribution.
25  * 3. All advertising materials mentioning features or use of this software
26  *    must display the following acknowledgement:
27  *	This product includes software developed by the University of
28  *	California, Berkeley and its contributors.
29  * 4. Neither the name of the University nor the names of its contributors
30  *    may be used to endorse or promote products derived from this software
31  *    without specific prior written permission.
32  *
33  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
34  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
35  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
36  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
37  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
39  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
41  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
42  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43  * SUCH DAMAGE.
44  *
45  *	@(#)zsvar.h	8.1 (Berkeley) 6/11/93
46  */
47 
48 
49 /*
50  * Function vector - per channel
51  */
52 struct zs_chanstate;
53 struct zsops {
54 	void	(*zsop_rxint) __P((struct zs_chanstate *));
55 					/* receive char available */
56 	void	(*zsop_stint) __P((struct zs_chanstate *, int));
57 					/* external/status */
58 	void	(*zsop_txint) __P((struct zs_chanstate *));
59 					/* xmit buffer empty */
60 	void	(*zsop_softint) __P((struct zs_chanstate *));
61 					/* process software interrupt */
62 };
63 
64 extern struct zsops zsops_null;
65 
66 
67 /*
68  * Software state, per zs channel.
69  */
70 struct zs_chanstate {
71 
72 	/* Pointers to the device registers. */
73 	volatile u_char	*cs_reg_csr; 	/* ctrl, status, and reg. number. */
74 	volatile u_char	*cs_reg_data;	/* data or numbered register */
75 
76 	int	cs_channel;		/* sub-unit number */
77 	void   *cs_private;		/* sub-driver data pointer */
78 	struct zsops *cs_ops;
79 
80 	int	cs_brg_clk;		/* BAUD Rate Generator clock
81 					 * (usually PCLK / 16) */
82 	int	cs_defspeed;		/* default baud rate */
83 	int	cs_defcflag;		/* default cflag */
84 
85 	/*
86 	 * We must keep a copy of the write registers as they are
87 	 * mostly write-only and we sometimes need to set and clear
88 	 * individual bits (e.g., in WR3).  Not all of these are
89 	 * needed but 16 bytes is cheap and this makes the addressing
90 	 * simpler.  Unfortunately, we can only write to some registers
91 	 * when the chip is not actually transmitting, so whenever
92 	 * we are expecting a `transmit done' interrupt the preg array
93 	 * is allowed to `get ahead' of the current values.  In a
94 	 * few places we must change the current value of a register,
95 	 * rather than (or in addition to) the pending value; for these
96 	 * cs_creg[] contains the current value.
97 	 */
98 	u_char	cs_creg[16];		/* current values */
99 	u_char	cs_preg[16];		/* pending values */
100 	int 	cs_heldchange;		/* change pending (creg != preg) */
101 
102 	u_char	cs_rr0;			/* last rr0 processed */
103 	u_char	cs_rr0_delta;		/* rr0 changes at status intr. */
104 	u_char	cs_rr0_mask;		/* rr0 bits that stop output */
105 	u_char	cs_rr0_dcd;		/* which bit to read as DCD */
106 	u_char	cs_rr0_cts;		/* which bit to read as CTS */
107 	u_char	cs_rr0_pps;		/* which bit to use for PPS */
108 	/* the above is set only while CRTSCTS is enabled. */
109 
110 	u_char	cs_wr5_dtr;		/* which bit to write as DTR */
111 	u_char	cs_wr5_rts;		/* which bit to write as RTS */
112 	/* the above is set only while CRTSCTS is enabled. */
113 
114 	char	cs_softreq;		/* need soft interrupt call */
115 	char	cs_spare1;  	/* (for skippy :) */
116 
117 	/* power management hooks */
118 	int	(*enable) __P((struct zs_chanstate *));
119 	void	(*disable) __P((struct zs_chanstate *));
120 	int	enabled;
121 
122 	/* MD code might define a larger variant of this. */
123 };
124 
125 struct consdev;
126 struct zsc_attach_args {
127 	int channel;		/* two serial channels per zsc */
128 	int hwflags;		/* see definitions below */
129 	/* `consdev' is only valid if ZS_HWFLAG_USE_CONSDEV is set */
130 	struct consdev *consdev;
131 };
132 /* In case of split console devices, use these: */
133 #define ZS_HWFLAG_CONSOLE_INPUT		1
134 #define ZS_HWFLAG_CONSOLE_OUTPUT	2
135 #define ZS_HWFLAG_CONSOLE		\
136 	(ZS_HWFLAG_CONSOLE_INPUT | ZS_HWFLAG_CONSOLE_OUTPUT)
137 #define ZS_HWFLAG_NO_DCD	4	/* Ignore the DCD bit */
138 #define ZS_HWFLAG_NO_CTS	8	/* Ignore the CTS bit */
139 #define ZS_HWFLAG_RAW   	16	/* advise raw mode */
140 #define ZS_HWFLAG_USE_CONSDEV  	32	/* Use console ops from `consdev' */
141 #define	ZS_HWFLAG_NORESET	64	/* Don't reset at attach time */
142 
143 int 	zsc_intr_soft __P((void *));
144 int 	zsc_intr_hard __P((void *));
145 
146 void	zs_abort __P((struct zs_chanstate *));
147 void	zs_break __P((struct zs_chanstate *, int));
148 void	zs_iflush __P((struct zs_chanstate *));
149 void	zs_loadchannelregs __P((struct zs_chanstate *));
150 int 	zs_set_speed __P((struct zs_chanstate *, int));
151 int 	zs_set_modes __P((struct zs_chanstate *, int));
152 
153 extern int zs_major;
154 
155 int zs_check_kgdb __P((struct zs_chanstate *, int));
156 
157