Home | History | Annotate | Line # | Download | only in isa
      1 /*	$NetBSD: isa.c,v 1.141 2025/10/03 14:14:36 thorpej Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1998, 2001, 2008 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Charles M. Hannum; by Jason R. Thorpe of Wasabi Systems, Inc.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 #include <sys/cdefs.h>
     33 __KERNEL_RCSID(0, "$NetBSD: isa.c,v 1.141 2025/10/03 14:14:36 thorpej Exp $");
     34 
     35 #include <sys/param.h>
     36 #include <sys/systm.h>
     37 #include <sys/kernel.h>
     38 #include <sys/malloc.h>
     39 #include <sys/device.h>
     40 
     41 #include <sys/intr.h>
     42 
     43 #include <dev/isa/isareg.h>
     44 #include <dev/isa/isavar.h>
     45 #include <dev/isa/isadmareg.h>
     46 
     47 #include "isadma.h"
     48 
     49 #include "isapnp.h"
     50 #if NISAPNP > 0
     51 #include <dev/isapnp/isapnpreg.h>
     52 #include <dev/isapnp/isapnpvar.h>
     53 #endif
     54 
     55 #include "locators.h"
     56 
     57 int	isamatch(device_t, cfdata_t, void *);
     58 void	isaattach(device_t, device_t, void *);
     59 int	isadetach(device_t, int);
     60 int	isarescan(device_t, const char *, const int *);
     61 void	isachilddetached(device_t, device_t);
     62 int	isaprint(void *, const char *);
     63 
     64 CFATTACH_DECL2_NEW(isa, sizeof(struct isa_softc),
     65     isamatch, isaattach, isadetach, NULL, isarescan, isachilddetached);
     66 
     67 void	isa_attach_knowndevs(struct isa_softc *);
     68 void	isa_free_knowndevs(struct isa_softc *);
     69 
     70 int	isasubmatch(device_t, cfdata_t, const int *, void *);
     71 int	isasearch(device_t, cfdata_t, const int *, void *);
     72 
     73 static int	isa_slotcount = -1;	/* -1 == don't know how many */
     74 
     75 int
     76 isamatch(device_t parent, cfdata_t cf, void *aux)
     77 {
     78 	/* XXX check other indicators */
     79 
     80 	return (1);
     81 }
     82 
     83 void
     84 isaattach(device_t parent, device_t self, void *aux)
     85 {
     86 	struct isa_softc *sc = device_private(self);
     87 	struct isabus_attach_args *iba = aux;
     88 	static const int wildcard[ISACF_NLOCS] = {
     89 		[ISACF_PORT]  = ISACF_PORT_DEFAULT,
     90 		[ISACF_SIZE]  = ISACF_SIZE_DEFAULT,
     91 		[ISACF_IOMEM] = ISACF_IOMEM_DEFAULT,
     92 		[ISACF_IOSIZ] = ISACF_IOSIZ_DEFAULT,
     93 		[ISACF_IRQ]   = ISACF_IRQ_DEFAULT,
     94 		[ISACF_DRQ]   = ISACF_DRQ_DEFAULT,
     95 		[ISACF_DRQ2]  = ISACF_DRQ2_DEFAULT,
     96 	};
     97 
     98 	TAILQ_INIT(&sc->sc_knowndevs);
     99 	sc->sc_dynamicdevs = 0;
    100 
    101 	sc->sc_dev = self;
    102 
    103 	isa_attach_hook(parent, self, iba);
    104 	aprint_naive("\n");
    105 	aprint_normal("\n");
    106 
    107 	/* XXX Add code to fetch known-devices. */
    108 
    109 	sc->sc_iot = iba->iba_iot;
    110 	sc->sc_memt = iba->iba_memt;
    111 	sc->sc_dmat = iba->iba_dmat;
    112 	sc->sc_ic = iba->iba_ic;
    113 
    114 #if NISAPNP > 0
    115 	/*
    116 	 * Reset isapnp cards that the bios configured for us
    117 	 */
    118 	isapnp_isa_attach_hook(sc);
    119 #endif
    120 
    121 #if NISADMA > 0
    122 	/*
    123 	 * Initialize our DMA state.
    124 	 */
    125 	isa_dmainit(sc->sc_ic, sc->sc_iot, sc->sc_dmat, self);
    126 #endif
    127 
    128 	/* Attach all direct-config children. */
    129 	isa_attach_knowndevs(sc);
    130 
    131 	/*
    132 	 * If we don't support dynamic hello/goodbye of devices,
    133 	 * then free the knowndevs info now.
    134 	 */
    135 	if (sc->sc_dynamicdevs == 0)
    136 		isa_free_knowndevs(sc);
    137 
    138 	/* Attach all indirect-config children. */
    139 	isarescan(self, NULL, wildcard);
    140 
    141 	if (!pmf_device_register(self, NULL, NULL))
    142 		aprint_error_dev(self, "couldn't establish power handler\n");
    143 }
    144 
    145 int
    146 isadetach(device_t self, int flags)
    147 {
    148 	struct isa_softc *sc = device_private(self);
    149 	int rc;
    150 
    151 	if ((rc = config_detach_children(self, flags)) != 0)
    152 		return rc;
    153 
    154 	pmf_device_deregister(self);
    155 
    156 	isa_free_knowndevs(sc);
    157 
    158 #if NISADMA > 0
    159 	isa_dmadestroy(sc->sc_ic);
    160 #endif
    161 	isa_detach_hook(sc->sc_ic, self);
    162 
    163 	return 0;
    164 }
    165 
    166 int
    167 isarescan(device_t self, const char *ifattr, const int *locators)
    168 {
    169 	int locs[ISACF_NLOCS];
    170 
    171 	if (device_getprop_bool(self, "no-legacy-devices")) {
    172 		aprint_debug_dev(self, "platform reports no legacy devices\n");
    173 		return 0;
    174 	}
    175 
    176 	memcpy(locs, locators, sizeof(locs));
    177 
    178 	/*
    179 	 * XXX Bus independent code calling this function does not
    180 	 * know the locator default values. It assumes "-1" for now.
    181 	 * (should be made available by "config" one day)
    182 	 * So fixup where the "-1" is not correct.
    183 	 */
    184 	if (locs[ISACF_SIZE] == -1)
    185 		locs[ISACF_SIZE] = ISACF_SIZE_DEFAULT;
    186 	if (locs[ISACF_IOSIZ] == -1)
    187 		locs[ISACF_IOSIZ] = ISACF_IOSIZ_DEFAULT;
    188 
    189 	config_search(self, NULL,
    190 	    CFARGS(.search = isasearch,
    191 		   .locators = locs));
    192 	return (0);
    193 }
    194 
    195 void
    196 isachilddetached(device_t self, device_t child)
    197 {
    198 	struct isa_knowndev *ik;
    199 	struct isa_softc *sc = device_private(self);
    200 
    201 	TAILQ_FOREACH(ik, &sc->sc_knowndevs, ik_list) {
    202 		if (ik->ik_claimed == child)
    203 			ik->ik_claimed = NULL;
    204 	}
    205 }
    206 
    207 void
    208 isa_attach_knowndevs(struct isa_softc *sc)
    209 {
    210 	struct isa_attach_args ia;
    211 	struct isa_knowndev *ik;
    212 
    213 	if (TAILQ_EMPTY(&sc->sc_knowndevs))
    214 		return;
    215 
    216 	TAILQ_FOREACH(ik, &sc->sc_knowndevs, ik_list) {
    217 		if (ik->ik_claimed != NULL)
    218 			continue;
    219 
    220 		ia.ia_iot = sc->sc_iot;
    221 		ia.ia_memt = sc->sc_memt;
    222 		ia.ia_dmat = sc->sc_dmat;
    223 		ia.ia_ic = sc->sc_ic;
    224 
    225 		ia.ia_pnpname = ik->ik_pnpname;
    226 		ia.ia_pnpcompatnames = ik->ik_pnpcompatnames;
    227 
    228 		ia.ia_io = ik->ik_io;
    229 		ia.ia_nio = ik->ik_nio;
    230 
    231 		ia.ia_iomem = ik->ik_iomem;
    232 		ia.ia_niomem = ik->ik_niomem;
    233 
    234 		ia.ia_irq = ik->ik_irq;
    235 		ia.ia_nirq = ik->ik_nirq;
    236 
    237 		ia.ia_drq = ik->ik_drq;
    238 		ia.ia_ndrq = ik->ik_ndrq;
    239 
    240 		ia.ia_aux = NULL;
    241 
    242 		/* XXX should setup locator array */
    243 
    244 		ik->ik_claimed = config_found(sc->sc_dev, &ia, isaprint,
    245 		    CFARGS(.submatch = isasubmatch));
    246 	}
    247 }
    248 
    249 void
    250 isa_free_knowndevs(struct isa_softc *sc)
    251 {
    252 	struct isa_knowndev *ik;
    253 	struct isa_pnpname *ipn;
    254 
    255 #define	FREEIT(x)	if (x != NULL) free(x, M_DEVBUF)
    256 
    257 	while ((ik = TAILQ_FIRST(&sc->sc_knowndevs)) != NULL) {
    258 		TAILQ_REMOVE(&sc->sc_knowndevs, ik, ik_list);
    259 		FREEIT(ik->ik_pnpname);
    260 		while ((ipn = ik->ik_pnpcompatnames) != NULL) {
    261 			ik->ik_pnpcompatnames = ipn->ipn_next;
    262 			free(ipn->ipn_name, M_DEVBUF);
    263 			free(ipn, M_DEVBUF);
    264 		}
    265 		FREEIT(ik->ik_io);
    266 		FREEIT(ik->ik_iomem);
    267 		FREEIT(ik->ik_irq);
    268 		FREEIT(ik->ik_drq);
    269 		free(ik, M_DEVBUF);
    270 	}
    271 
    272 #undef FREEIT
    273 }
    274 
    275 static int
    276 checkattachargs(struct isa_attach_args *ia, const int *loc)
    277 {
    278 	int i;
    279 
    280 	if (ia->ia_nio == 0) {
    281 		if (loc[ISACF_PORT] != ISACF_PORT_DEFAULT)
    282 			return (0);
    283 	} else {
    284 		if (loc[ISACF_PORT] != ISACF_PORT_DEFAULT &&
    285 		    loc[ISACF_PORT] != ia->ia_io[0].ir_addr)
    286 			return (0);
    287 	}
    288 
    289 	if (ia->ia_niomem == 0) {
    290 		if (loc[ISACF_IOMEM] != ISACF_IOMEM_DEFAULT)
    291 			return (0);
    292 	} else {
    293 		if (loc[ISACF_IOMEM] != ISACF_IOMEM_DEFAULT &&
    294 		    loc[ISACF_IOMEM] != ia->ia_iomem[0].ir_addr)
    295 			return (0);
    296 	}
    297 
    298 	if (ia->ia_nirq == 0) {
    299 		if (loc[ISACF_IRQ] != ISACF_IRQ_DEFAULT)
    300 			return (0);
    301 	} else {
    302 		if (loc[ISACF_IRQ] != ISACF_IRQ_DEFAULT &&
    303 		    loc[ISACF_IRQ] != ia->ia_irq[0].ir_irq)
    304 			return (0);
    305 	}
    306 
    307 	if (ia->ia_ndrq == 0) {
    308 		if (loc[ISACF_DRQ] != ISACF_DRQ_DEFAULT)
    309 			return (0);
    310 		if (loc[ISACF_DRQ2] != ISACF_DRQ2_DEFAULT)
    311 			return (0);
    312 	} else {
    313 		for (i = 0; i < 2; i++) {
    314 			if (i == ia->ia_ndrq)
    315 				break;
    316 			if (loc[ISACF_DRQ + i] != ISACF_DRQ_DEFAULT &&
    317 			    loc[ISACF_DRQ + i] != ia->ia_drq[i].ir_drq)
    318 				return (0);
    319 		}
    320 		for (; i < 2; i++) {
    321 			if (loc[ISACF_DRQ + i] != ISACF_DRQ_DEFAULT)
    322 				return (0);
    323 		}
    324 	}
    325 
    326 	return (1);
    327 }
    328 
    329 int
    330 isasubmatch(device_t parent, cfdata_t cf, const int *ldesc, void *aux)
    331 {
    332 	struct isa_attach_args *ia = aux;
    333 
    334 	if (!checkattachargs(ia, cf->cf_loc))
    335 		return (0);
    336 
    337 	return (config_match(parent, cf, aux));
    338 }
    339 
    340 int
    341 isaprint(void *aux, const char *isa)
    342 {
    343 	struct isa_attach_args *ia = aux;
    344 	const char *sep;
    345 	int i;
    346 
    347 	/*
    348 	 * This block of code only fires if we have a direct-config'd
    349 	 * device for which there is no driver match.
    350 	 */
    351 	if (isa != NULL) {
    352 		struct isa_pnpname *ipn;
    353 
    354 		if (ia->ia_pnpname != NULL)
    355 			aprint_normal("%s", ia->ia_pnpname);
    356 		if ((ipn = ia->ia_pnpcompatnames) != NULL) {
    357 			aprint_normal(" (");	/* ) */
    358 			for (sep = ""; ipn != NULL;
    359 			     ipn = ipn->ipn_next, sep = " ") {
    360 				aprint_normal("%s%s", sep, ipn->ipn_name);
    361 			}
    362 	/* ( */		aprint_normal(")");
    363 		}
    364 		aprint_normal(" at %s", isa);
    365 	}
    366 
    367 	if (ia->ia_nio) {
    368 		sep = "";
    369 		aprint_normal(" port ");
    370 		for (i = 0; i < ia->ia_nio; i++) {
    371 			if (ia->ia_io[i].ir_size == 0)
    372 				continue;
    373 			aprint_normal("%s0x%x", sep, ia->ia_io[i].ir_addr);
    374 			if (ia->ia_io[i].ir_size > 1)
    375 				aprint_normal("-0x%x", ia->ia_io[i].ir_addr +
    376 				    ia->ia_io[i].ir_size - 1);
    377 			sep = ",";
    378 		}
    379 	}
    380 
    381 	if (ia->ia_niomem) {
    382 		sep = "";
    383 		aprint_normal(" iomem ");
    384 		for (i = 0; i < ia->ia_niomem; i++) {
    385 			if (ia->ia_iomem[i].ir_size == 0)
    386 				continue;
    387 			aprint_normal("%s0x%x", sep, ia->ia_iomem[i].ir_addr);
    388 			if (ia->ia_iomem[i].ir_size > 1)
    389 				aprint_normal("-0x%x", ia->ia_iomem[i].ir_addr +
    390 				    ia->ia_iomem[i].ir_size - 1);
    391 			sep = ",";
    392 		}
    393 	}
    394 
    395 	if (ia->ia_nirq) {
    396 		sep = "";
    397 		aprint_normal(" irq ");
    398 		for (i = 0; i < ia->ia_nirq; i++) {
    399 			if (ia->ia_irq[i].ir_irq == ISACF_IRQ_DEFAULT)
    400 				continue;
    401 			aprint_normal("%s%d", sep, ia->ia_irq[i].ir_irq);
    402 			sep = ",";
    403 		}
    404 	}
    405 
    406 	if (ia->ia_ndrq) {
    407 		sep = "";
    408 		aprint_normal(" drq ");
    409 		for (i = 0; i < ia->ia_ndrq; i++) {
    410 			if (ia->ia_drq[i].ir_drq == ISACF_DRQ_DEFAULT)
    411 				continue;
    412 			aprint_normal("%s%d", sep, ia->ia_drq[i].ir_drq);
    413 			sep = ",";
    414 		}
    415 	}
    416 
    417 	return (UNCONF);
    418 }
    419 
    420 int
    421 isasearch(device_t parent, cfdata_t cf, const int *slocs, void *aux)
    422 {
    423 	struct isa_io res_io[1];
    424 	struct isa_iomem res_mem[1];
    425 	struct isa_irq res_irq[1];
    426 	struct isa_drq res_drq[2];
    427 	struct isa_softc *sc = device_private(parent);
    428 	struct isa_attach_args ia;
    429 	int flocs[ISACF_NLOCS];
    430 	int tryagain;
    431 
    432 	do {
    433 		ia.ia_pnpname = NULL;
    434 		ia.ia_pnpcompatnames = NULL;
    435 
    436 		res_io[0].ir_addr = cf->cf_loc[ISACF_PORT];
    437 		res_io[0].ir_size = 0;
    438 
    439 		res_mem[0].ir_addr = cf->cf_loc[ISACF_IOMEM];
    440 		res_mem[0].ir_size = cf->cf_loc[ISACF_IOSIZ];
    441 
    442 		res_irq[0].ir_irq =
    443 		    cf->cf_loc[ISACF_IRQ] == 2 ? 9 : cf->cf_loc[ISACF_IRQ];
    444 
    445 		res_drq[0].ir_drq = cf->cf_loc[ISACF_DRQ];
    446 		res_drq[1].ir_drq = cf->cf_loc[ISACF_DRQ2];
    447 
    448 		ia.ia_iot = sc->sc_iot;
    449 		ia.ia_memt = sc->sc_memt;
    450 		ia.ia_dmat = sc->sc_dmat;
    451 		ia.ia_ic = sc->sc_ic;
    452 
    453 		ia.ia_io = res_io;
    454 		ia.ia_nio = 1;
    455 
    456 		ia.ia_iomem = res_mem;
    457 		ia.ia_niomem = 1;
    458 
    459 		ia.ia_irq = res_irq;
    460 		ia.ia_nirq = 1;
    461 
    462 		ia.ia_drq = res_drq;
    463 		ia.ia_ndrq = 2;
    464 
    465 		if (!checkattachargs(&ia, slocs))
    466 			return (0);
    467 
    468 		tryagain = 0;
    469 		if (config_probe(parent, cf, &ia)) {
    470 			/*
    471 			 * This is not necessary for detach, but might
    472 			 * still be useful to collect device information.
    473 			 */
    474 			flocs[ISACF_PORT] = ia.ia_io[0].ir_addr;
    475 			flocs[ISACF_SIZE] = ia.ia_io[0].ir_size;
    476 			flocs[ISACF_IOMEM] = ia.ia_iomem[0].ir_addr;
    477 			flocs[ISACF_IOSIZ] = ia.ia_iomem[0].ir_size;
    478 			flocs[ISACF_IRQ] = ia.ia_irq[0].ir_irq;
    479 			flocs[ISACF_DRQ] = ia.ia_drq[0].ir_drq;
    480 			flocs[ISACF_DRQ2] = ia.ia_drq[1].ir_drq;
    481 			config_attach(parent, cf, &ia, isaprint,
    482 			    CFARGS(.locators = flocs));
    483 			tryagain = (cf->cf_fstate == FSTATE_STAR);
    484 		}
    485 	} while (tryagain);
    486 
    487 	return (0);
    488 }
    489 
    490 const char *
    491 isa_intr_typename(int type)
    492 {
    493 
    494 	switch (type) {
    495 	case IST_NONE:
    496 		return ("none");
    497 	case IST_PULSE:
    498 		return ("pulsed");
    499 	case IST_EDGE:
    500 		return ("edge-triggered");
    501 	case IST_LEVEL:
    502 		return ("level-triggered");
    503 	default:
    504 		panic("isa_intr_typename: invalid type %d", type);
    505 	}
    506 }
    507 
    508 int
    509 isa_get_slotcount(void)
    510 {
    511 
    512 	return isa_slotcount;
    513 }
    514 
    515 void
    516 isa_set_slotcount(int arg)
    517 {
    518 
    519 	isa_slotcount = arg;
    520 }
    521