Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / powerpc / isa / isapnp_machdep.c
blob9e1fd67a69e61e60c242baa27499d7918c5905bc
1 /* $NetBSD: isapnp_machdep.c,v 1.3 2008/04/28 20:23:32 martin 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. This works because we
71 * don't do space accounting (we'd need a back-door to bypass it
72 * if we did!).
75 #include <sys/cdefs.h>
76 __KERNEL_RCSID(0, "$NetBSD: isapnp_machdep.c,v 1.3 2008/04/28 20:23:32 martin Exp $");
78 #include <sys/param.h>
79 #include <sys/systm.h>
80 #include <sys/device.h>
81 #include <sys/malloc.h>
83 #include <machine/bus.h>
85 #include <dev/isa/isavar.h>
87 #include <dev/isapnp/isapnpreg.h>
88 #include <dev/isapnp/isapnpvar.h>
90 /* isapnp_map():
91 * Map I/O regions used by PnP
93 int
94 isapnp_map(struct isapnp_softc *sc)
96 #ifdef _KERNEL
97 int error;
98 #endif
100 #ifdef _KERNEL
101 if ((error = bus_space_map(sc->sc_iot, ISAPNP_ADDR, 1, 0,
102 &sc->sc_addr_ioh)) != 0)
103 return error;
104 if ((error = bus_space_map(sc->sc_iot, ISAPNP_WRDATA, 1, 0,
105 &sc->sc_wrdata_ioh)) != 0)
106 return error;
107 #endif
108 return (0);
111 /* isapnp_unmap():
112 * Unmap I/O regions used by PnP
114 void
115 isapnp_unmap(struct isapnp_softc *sc)
118 bus_space_unmap(sc->sc_iot, sc->sc_addr_ioh, 1);
119 bus_space_unmap(sc->sc_iot, sc->sc_wrdata_ioh, 1);
122 /* isapnp_map_readport():
123 * Called to map the PnP `read port', which is mapped independently
124 * of the `write' and `addr' ports.
126 * NOTE: assumes the caller has filled in sc->sc_read_port!
129 isapnp_map_readport(struct isapnp_softc *sc)
131 #ifdef _KERNEL
132 int error;
133 #endif
135 #ifdef _KERNEL
136 /* Check if some other device has already claimed this port. */
137 if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
138 &sc->sc_read_ioh)) != 0)
139 return error;
140 #endif
141 return 0;
144 /* isapnp_unmap_readport():
145 * Pretend to unmap a previously mapped `read port'.
147 void
148 isapnp_unmap_readport(struct isapnp_softc *sc)
151 bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);