Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / sparc64 / include / z8530var.h
blob41c5a96ac510a59b7ef497bd4470df0dd1029a0c
1 /* $NetBSD: z8530var.h,v 1.11 2007/11/07 15:56:13 ad Exp $ */
3 /*
4 * Copyright (c) 1992, 1993
5 * The Regents of the University of California. All rights reserved.
7 * This software was developed by the Computer Systems Engineering group
8 * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
9 * contributed to Berkeley.
11 * All advertising materials mentioning features or use of this software
12 * must display the following acknowledgement:
13 * This product includes software developed by the University of
14 * California, Lawrence Berkeley Laboratory.
16 * Redistribution and use in source and binary forms, with or without
17 * modification, are permitted provided that the following conditions
18 * are met:
19 * 1. Redistributions of source code must retain the above copyright
20 * notice, this list of conditions and the following disclaimer.
21 * 2. Redistributions in binary form must reproduce the above copyright
22 * notice, this list of conditions and the following disclaimer in the
23 * documentation and/or other materials provided with the distribution.
24 * 3. Neither the name of the University nor the names of its contributors
25 * may be used to endorse or promote products derived from this software
26 * without specific prior written permission.
28 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
29 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 * SUCH DAMAGE.
40 * @(#)zsvar.h 8.1 (Berkeley) 6/11/93
43 #include <machine/bus.h>
44 #include <dev/ic/z8530sc.h>
46 #include "kbd.h" /* NKBD */
48 #if (NKBD > 0)
50 * Need to override cn_console_dev() for zstty and zskbd.
52 #ifdef cn_isconsole
53 #undef cn_isconsole
54 #endif
55 extern struct consdev *cn_hw;
56 extern struct consdev *cn_tab;
57 #define cn_isconsole(d) ((d) == cn_tab->cn_dev || (d) == cn_hw->cn_dev)
58 #endif
60 struct zsc_softc {
61 device_t zsc_dev; /* base device */
62 bus_space_tag_t zsc_bustag; /* bus space/DMA tags */
63 bus_dma_tag_t zsc_dmatag;
64 struct zs_chanstate *zsc_cs[2]; /* channel A and B soft state */
66 /* Machine-dependent part follows... */
67 void *zsc_softintr;
68 int zsc_promunit; /* PROM's view of zs devices */
69 int zsc_node; /* PROM node, if any */
70 struct evcnt zsc_intrcnt; /* count interrupts */
71 struct zs_chanstate zsc_cs_store[2];
75 * Functions to read and write individual registers in a channel.
76 * The ZS chip requires a 1.6 uSec. recovery time between accesses.
77 * On the SparcStation the recovery time is handled in hardware.
78 * On the older Sun4 machine it isn't, and software must do it.
80 * However, it *is* a problem on some Sun4m's (i.e. the SS20) (XXX: why?).
81 * Thus we leave in the delay (done in the functions below).
82 * XXX: (ABB) Think about this more.
84 * The functions below could be macros instead if we are concerned
85 * about the function call overhead where ZS_DELAY does nothing.
88 uint8_t zs_read_reg(struct zs_chanstate *cs, uint8_t reg);
89 uint8_t zs_read_csr(struct zs_chanstate *cs);
90 uint8_t zs_read_data(struct zs_chanstate *cs);
92 void zs_write_reg(struct zs_chanstate *cs, uint8_t reg, uint8_t val);
93 void zs_write_csr(struct zs_chanstate *cs, uint8_t val);
94 void zs_write_data(struct zs_chanstate *cs, uint8_t val);
96 /* The sparc has splzs() in psl.h */
98 /* We want to call it "zs" instead of "zsc" (sigh). */
99 #ifndef ZSCCF_CHANNEL
100 #define ZSCCF_CHANNEL 0
101 #define ZSCCF_CHANNEL_DEFAULT -1
102 #endif
104 #undef cn_trap
105 #define cn_trap() zs_abort(NULL)
107 #define IPL_ZS IPL_SERIAL