Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / atari / isa / isapnp_machdep.c
blobeb6185f2bb2bd548143ae17c01e724380220169d
1 /* $NetBSD: isapnp_machdep.c,v 1.8 2009/03/14 15:36:03 dsl Exp $ */
3 /*-
4 * Copyright (c) 1996, 1997 The NetBSD Foundation, Inc.
5 * All rights reserved.
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9 * NASA Ames Research Center and by Christos Zoulas.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
34 * Copyright (c) 1997 Thomas Gerner. All rights reserved.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
45 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
46 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
47 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
48 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
49 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
50 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
51 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
52 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
53 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
54 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
58 * Machine-dependent portions of ISA PnP bus autoconfiguration.
60 * N.B. This file exists mostly to get around some lameness surrounding
61 * the PnP spec. ISA PnP registers live where some `normal' ISA
62 * devices do, but are e.g. write-only registers where the normal
63 * device has a read-only register. This breaks in the presence of
64 * i/o port accounting. This file takes care of mapping ISA PnP
65 * registers without actually allocating them in extent maps.
67 * Since this is a machine-dependent file, we make all sorts of
68 * assumptions about bus.h's guts. Beware!
70 * Note: We just use bus_space{,un}map() here, because we need to
71 * actually map the space into KVA space. This works because we
72 * don't do space accounting (we'd need a back-door to bypass it
73 * if we did!).
76 #include <sys/cdefs.h>
77 __KERNEL_RCSID(0, "$NetBSD: isapnp_machdep.c,v 1.8 2009/03/14 15:36:03 dsl Exp $");
79 #include <sys/param.h>
80 #include <sys/systm.h>
81 #include <sys/device.h>
82 #include <sys/malloc.h>
84 #include <machine/bus.h>
86 #include <dev/isa/isavar.h>
88 #include <dev/isapnp/isapnpreg.h>
89 #include <dev/isapnp/isapnpvar.h>
91 #ifdef DIAGNOSTIC
92 #include <machine/iomap.h>
93 #endif
96 /* isapnp_map():
97 * Map I/O regions used by PnP
99 int
100 isapnp_map(struct isapnp_softc *sc)
102 #ifdef _KERNEL
103 int error;
104 #endif
106 #ifdef DIAGNOSTIC
107 if (sc->sc_iot->base != ISA_IOSTART)
108 panic("isapnp_map: bogus bus space tag");
109 #endif
111 #ifdef _KERNEL
112 if ((error = bus_space_map(sc->sc_iot, ISAPNP_ADDR, 1, 0,
113 &sc->sc_addr_ioh)) != 0)
114 return error;
115 if ((error = bus_space_map(sc->sc_iot, ISAPNP_WRDATA, 1, 0,
116 &sc->sc_wrdata_ioh)) != 0)
117 return error;
118 #endif
119 return (0);
122 /* isapnp_unmap():
123 * Unmap I/O regions used by PnP
125 void
126 isapnp_unmap(struct isapnp_softc *sc)
129 #ifdef DIAGNOSTIC
130 if (sc->sc_iot->base != ISA_IOSTART)
131 panic("isapnp_map: bogus bus space tag");
132 #endif
134 bus_space_unmap(sc->sc_iot, sc->sc_addr_ioh, 1);
135 bus_space_unmap(sc->sc_iot, sc->sc_wrdata_ioh, 1);
138 /* isapnp_map_readport():
139 * Called to map the PnP `read port', which is mapped independently
140 * of the `write' and `addr' ports.
142 * NOTE: assumes the caller has filled in sc->sc_read_port!
145 isapnp_map_readport(struct isapnp_softc *sc)
147 #ifdef _KERNEL
148 int error;
149 #endif
151 #ifdef DIAGNOSTIC
152 if (sc->sc_iot->base != ISA_IOSTART)
153 panic("isapnp_map_readport: bogus bus space tag");
154 #endif
156 #ifdef _KERNEL
157 /* Check if some other device has already claimed this port. */
158 if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
159 &sc->sc_read_ioh)) != 0)
160 return error;
161 #endif
162 return 0;
165 /* isapnp_unmap_readport():
166 * Pretend to unmap a previously mapped `read port'.
168 void
169 isapnp_unmap_readport(struct isapnp_softc *sc)
172 #ifdef DIAGNOSTIC
173 if (sc->sc_iot->base != ISA_IOSTART)
174 panic("isapnp_map_readport: bogus bus space tag");
175 #endif
177 bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);