Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / i386 / isa / isapnp_machdep.c
blobb28b7fabe03535158d975c81d181ddb510dd58e8
1 /* $NetBSD: isapnp_machdep.c,v 1.12 2006/11/16 01:32:38 christos 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 * 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.12 2006/11/16 01:32:38 christos 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)
69 #ifdef DIAGNOSTIC
70 if (sc->sc_iot != X86_BUS_SPACE_IO)
71 panic("isapnp_map: bogus bus space tag");
72 #endif
74 sc->sc_addr_ioh = ISAPNP_ADDR;
75 sc->sc_wrdata_ioh = ISAPNP_WRDATA;
76 return (0);
79 /* isapnp_unmap():
80 * Unmap I/O regions used by PnP
82 void
83 isapnp_unmap(struct isapnp_softc *sc)
86 /* Do nothing. */
89 /* isapnp_map_readport():
90 * Called to map the PnP `read port', which is mapped independently
91 * of the `write' and `addr' ports.
93 * NOTE: assumes the caller has filled in sc->sc_read_port!
95 int
96 isapnp_map_readport(struct isapnp_softc *sc)
98 #ifdef _KERNEL
99 int error;
100 #endif
102 #ifdef DIAGNOSTIC
103 if (sc->sc_iot != X86_BUS_SPACE_IO)
104 panic("isapnp_map_readport: bogus bus space tag");
105 #endif
107 #ifdef _KERNEL
108 /* Check if some other device has already claimed this port. */
109 if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
110 &sc->sc_read_ioh)) != 0)
111 return error;
114 * XXX: We unmap the port because it can and will be used by other
115 * devices such as a joystick. We need a better port accounting
116 * scheme with read and write ports.
118 bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);
119 #endif
120 return 0;
123 /* isapnp_unmap_readport():
124 * Pretend to unmap a previously mapped `read port'.
126 void
127 isapnp_unmap_readport(struct isapnp_softc *sc)
130 /* Do nothing */