Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / alpha / isa / isapnp_machdep.c
blob8661e6190f927a299077003f863e7bb9ea76623e
1 /* $NetBSD: isapnp_machdep.c,v 1.6 2008/04/28 20:23:11 martin Exp $ */
3 /*-
4 * Copyright (c) 1996, 1997, 1998 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 * Machine-dependent portions of ISA PnP bus autoconfiguration.
36 * N.B. This file exists mostly to get around some lameness surrounding
37 * the PnP spec. ISA PnP registers live where some `normal' ISA
38 * devices do, but are e.g. write-only registers where the normal
39 * device has a read-only register. This breaks in the presence of
40 * i/o port accounting. This file takes care of mapping ISA PnP
41 * registers without actually allocating them in extent maps.
43 * Since this is a machine-dependent file, we make all sorts of
44 * assumptions about bus.h's guts. Beware!
47 #include <sys/cdefs.h>
48 __KERNEL_RCSID(0, "$NetBSD: isapnp_machdep.c,v 1.6 2008/04/28 20:23:11 martin Exp $");
50 #include <sys/param.h>
51 #include <sys/systm.h>
52 #include <sys/device.h>
53 #include <sys/malloc.h>
55 #include <machine/bus.h>
57 #include <dev/isa/isavar.h>
59 #include <dev/isapnp/isapnpreg.h>
60 #include <dev/isapnp/isapnpvar.h>
62 /* isapnp_map():
63 * Map I/O regions used by PnP
65 int
66 isapnp_map(struct isapnp_softc *sc)
68 int error;
70 error = alpha_bus_space_map_noacct(sc->sc_iot, ISAPNP_ADDR, 1, 0,
71 &sc->sc_addr_ioh);
72 if (error)
73 return (error);
75 error = alpha_bus_space_map_noacct(sc->sc_iot, ISAPNP_WRDATA, 1, 0,
76 &sc->sc_wrdata_ioh);
77 if (error) {
78 alpha_bus_space_unmap_noacct(sc->sc_iot, sc->sc_addr_ioh, 1);
79 return (error);
82 return (0);
85 /* isapnp_unmap():
86 * Unmap I/O regions used by PnP
88 void
89 isapnp_unmap(struct isapnp_softc *sc)
92 alpha_bus_space_unmap_noacct(sc->sc_iot, sc->sc_addr_ioh, 1);
93 alpha_bus_space_unmap_noacct(sc->sc_iot, sc->sc_wrdata_ioh, 1);
96 /* isapnp_map_readport():
97 * Called to map the PnP `read port', which is mapped independently
98 * of the `write' and `addr' ports.
100 * NOTE: assumes the caller has filled in sc->sc_read_port!
103 isapnp_map_readport(struct isapnp_softc *sc)
105 #ifdef _KERNEL
106 int error;
107 #endif
109 #ifdef _KERNEL
110 /* Check if some other device has already claimed this port. */
111 if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
112 &sc->sc_read_ioh)) != 0)
113 return error;
116 * XXX: We unmap the port because it can and will be used by other
117 * devices such as a joystick. We need a better port accounting
118 * scheme with read and write ports.
120 bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);
121 #endif
122 return 0;
125 /* isapnp_unmap_readport():
126 * Pretend to unmap a previously mapped `read port'.
128 void
129 isapnp_unmap_readport(struct isapnp_softc *sc)
132 /* Do nothing */