1 /*        $NetBSD: isapnp_machdep.c,v 1.11 2023/12/20 00:40:43 thorpej Exp $    */
2 
3 /*-
4  * Copyright (c) 1996, 1997 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
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.
10  *
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.
19  *
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.
31  */
32 
33 /*
34  * Copyright (c) 1997 Thomas Gerner.  All rights reserved.
35  *
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.
44  *
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.
55  */
56 
57 /*
58  * Machine-dependent portions of ISA PnP bus autoconfiguration.
59  *
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.
66  *
67  * Since this is a machine-dependent file, we make all sorts of
68  * assumptions about bus.h's guts.  Beware!
69  *
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!).
74  */
75 
76 #include <sys/cdefs.h>
77 __KERNEL_RCSID(0, "$NetBSD: isapnp_machdep.c,v 1.11 2023/12/20 00:40:43 thorpej Exp $");
78 
79 #include <sys/param.h>
80 #include <sys/systm.h>
81 #include <sys/device.h>
82 
83 #include <sys/bus.h>
84 
85 #include <dev/isa/isavar.h>
86 
87 #include <dev/isapnp/isapnpreg.h>
88 #include <dev/isapnp/isapnpvar.h>
89 
90 #ifdef DIAGNOSTIC
91 #include <machine/iomap.h>
92 #endif
93 
94 
95 /* isapnp_map():
96  *        Map I/O regions used by PnP
97  */
98 int
isapnp_map(struct isapnp_softc * sc)99 isapnp_map(struct isapnp_softc *sc)
100 {
101 #ifdef _KERNEL
102           int error;
103 #endif
104 
105 #ifdef DIAGNOSTIC
106           if (sc->sc_iot->base != ISA_IOSTART)
107                     panic("isapnp_map: bogus bus space tag");
108 #endif
109 
110 #ifdef _KERNEL
111           if ((error = bus_space_map(sc->sc_iot, ISAPNP_ADDR, 1, 0,
112                &sc->sc_addr_ioh)) != 0)
113                     return error;
114           if ((error = bus_space_map(sc->sc_iot, ISAPNP_WRDATA, 1, 0,
115                &sc->sc_wrdata_ioh)) != 0)
116                     return error;
117 #endif
118           return (0);
119 }
120 
121 /* isapnp_unmap():
122  *        Unmap I/O regions used by PnP
123  */
124 void
isapnp_unmap(struct isapnp_softc * sc)125 isapnp_unmap(struct isapnp_softc *sc)
126 {
127 
128 #ifdef DIAGNOSTIC
129           if (sc->sc_iot->base != ISA_IOSTART)
130                     panic("isapnp_map: bogus bus space tag");
131 #endif
132 
133           bus_space_unmap(sc->sc_iot, sc->sc_addr_ioh, 1);
134           bus_space_unmap(sc->sc_iot, sc->sc_wrdata_ioh, 1);
135 }
136 
137 /* isapnp_map_readport():
138  *        Called to map the PnP `read port', which is mapped independently
139  *        of the `write' and `addr' ports.
140  *
141  *        NOTE: assumes the caller has filled in sc->sc_read_port!
142  */
143 int
isapnp_map_readport(struct isapnp_softc * sc)144 isapnp_map_readport(struct isapnp_softc *sc)
145 {
146 #ifdef _KERNEL
147           int error;
148 #endif
149 
150 #ifdef DIAGNOSTIC
151           if (sc->sc_iot->base != ISA_IOSTART)
152                     panic("isapnp_map_readport: bogus bus space tag");
153 #endif
154 
155 #ifdef _KERNEL
156           /* Check if some other device has already claimed this port. */
157           if ((error = bus_space_map(sc->sc_iot, sc->sc_read_port, 1, 0,
158               &sc->sc_read_ioh)) != 0)
159                     return error;
160 #endif
161           return 0;
162 }
163 
164 /* isapnp_unmap_readport():
165  *        Pretend to unmap a previously mapped `read port'.
166  */
167 void
isapnp_unmap_readport(struct isapnp_softc * sc)168 isapnp_unmap_readport(struct isapnp_softc *sc)
169 {
170 
171 #ifdef DIAGNOSTIC
172           if (sc->sc_iot->base != ISA_IOSTART)
173                     panic("isapnp_map_readport: bogus bus space tag");
174 #endif
175 
176           bus_space_unmap(sc->sc_iot, sc->sc_read_ioh, 1);
177 }
178