1 /* $NetBSD: z8530sc.h,v 1.17 2002/09/24 13:23:31 ad 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 /* 118 * For strange systems that have oddly wired serial ports, we 119 * provide a pointer to the channel state of the port that has 120 * our status lines on it. 121 */ 122 struct zs_chanstate *cs_ctl_chan; 123 124 /* power management hooks */ 125 int (*enable) __P((struct zs_chanstate *)); 126 void (*disable) __P((struct zs_chanstate *)); 127 int enabled; 128 129 /* MD code might define a larger variant of this. */ 130 }; 131 132 struct consdev; 133 struct zsc_attach_args { 134 int channel; /* two serial channels per zsc */ 135 int hwflags; /* see definitions below */ 136 /* `consdev' is only valid if ZS_HWFLAG_USE_CONSDEV is set */ 137 struct consdev *consdev; 138 }; 139 /* In case of split console devices, use these: */ 140 #define ZS_HWFLAG_CONSOLE_INPUT 1 141 #define ZS_HWFLAG_CONSOLE_OUTPUT 2 142 #define ZS_HWFLAG_CONSOLE \ 143 (ZS_HWFLAG_CONSOLE_INPUT | ZS_HWFLAG_CONSOLE_OUTPUT) 144 #define ZS_HWFLAG_NO_DCD 4 /* Ignore the DCD bit */ 145 #define ZS_HWFLAG_NO_CTS 8 /* Ignore the CTS bit */ 146 #define ZS_HWFLAG_RAW 16 /* advise raw mode */ 147 #define ZS_HWFLAG_USE_CONSDEV 32 /* Use console ops from `consdev' */ 148 #define ZS_HWFLAG_NORESET 64 /* Don't reset at attach time */ 149 150 int zsc_intr_soft __P((void *)); 151 int zsc_intr_hard __P((void *)); 152 153 void zs_abort __P((struct zs_chanstate *)); 154 void zs_break __P((struct zs_chanstate *, int)); 155 void zs_iflush __P((struct zs_chanstate *)); 156 void zs_loadchannelregs __P((struct zs_chanstate *)); 157 int zs_set_speed __P((struct zs_chanstate *, int)); 158 int zs_set_modes __P((struct zs_chanstate *, int)); 159 160 int zs_check_kgdb __P((struct zs_chanstate *, int)); 161 162