Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / arc / isa / isapnp_machdep.c
blobb5eeeb67fd6ea91f949b69765b69a25c18f791a5
1 /* $NetBSD: isapnp_machdep.c,v 1.7 2005/12/11 12:16:39 christos Exp $ */
2 /* $OpenBSD: isapnp_machdep.c,v 1.1 1997/12/27 12:13:11 niklas Exp $ */
3 /* NetBSD: isapnp_machdep.c,v 1.5 1997/10/04 17:32:30 thorpej Exp */
5 /*-
6 * Copyright (c) 1996, 1997 The NetBSD Foundation, Inc.
7 * All rights reserved.
9 * This code is derived from software contributed to The NetBSD Foundation
10 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
11 * NASA Ames Research Center and by Christos Zoulas.
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
15 * are met:
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
22 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32 * POSSIBILITY OF SUCH DAMAGE.
36 * Machine-dependent portions of ISA PnP bus autoconfiguration.
38 * N.B. This file exists mostly to get around some lameness surrounding
39 * the PnP spec. ISA PnP registers live where some `normal' ISA
40 * devices do, but are e.g. write-only registers where the normal
41 * device has a read-only register. This breaks in the presence of
42 * i/o port accounting. This file takes care of mapping ISA PnP
43 * registers without actually allocating them in extent maps.
45 * Since this is a machine-dependent file, we make all sorts of
46 * assumptions about bus.h's guts. Beware!
49 #include <sys/cdefs.h>
50 __KERNEL_RCSID(0, "$NetBSD: isapnp_machdep.c,v 1.7 2005/12/11 12:16:39 christos Exp $");
52 #include <sys/param.h>
53 #include <sys/systm.h>
54 #include <sys/device.h>
55 #include <sys/malloc.h>
57 #include <machine/bus.h>
59 #include <dev/isa/isavar.h>
61 #include <dev/isapnp/isapnpreg.h>
62 #include <dev/isapnp/isapnpvar.h>
64 /* isapnp_map():
65 * Map I/O regions used by PnP
67 int
68 isapnp_map(struct isapnp_softc *sc)
70 bus_space_tag_t bst;
72 bst = sc->sc_iot;
73 sc->sc_addr_ioh = bst->bs_vbase + ISAPNP_ADDR - bst->bs_start;
74 sc->sc_wrdata_ioh = bst->bs_vbase + ISAPNP_WRDATA - bst->bs_start;
75 return 0;
78 /* isapnp_unmap():
79 * Unmap I/O regions used by PnP
81 void
82 isapnp_unmap(struct isapnp_softc *sc)
85 /* Do nothing. */
88 /* isapnp_map_readport():
89 * Called to map the PnP `read port', which is mapped independently
90 * of the `write' and `addr' ports.
92 * NOTE: assumes the caller has filled in sc->sc_read_port!
94 int
95 isapnp_map_readport(struct isapnp_softc *sc)
97 #ifdef _KERNEL
98 int error;
99 #endif
101 #ifdef _KERNEL
102 /* Check if some other device has already claimed this port. */
103 if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
104 &sc->sc_read_ioh)) != 0)
105 return error;
108 * XXX: We unmap the port because it can and will be used by other
109 * devices such as a joystick. We need a better port accounting
110 * scheme with read and write ports.
112 bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);
113 #endif
114 return 0;
117 /* isapnp_unmap_readport():
118 * Pretend to unmap a previously mapped `read port'.
120 void
121 isapnp_unmap_readport(struct isapnp_softc *sc)
124 /* Do nothing. */