1/*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 1998 Doug Rabson 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29#ifndef _ISA_ISAVAR_H_ 30#define _ISA_ISAVAR_H_ 31 32struct isa_config; 33struct isa_pnp_id; 34typedef void isa_config_cb(void *arg, struct isa_config *config, int enable); 35 36#include "isa_if.h" 37#include <isa/pnpvar.h> 38 39#ifdef _KERNEL 40 41/* 42 * ISA devices are partially ordered. This is to ensure that hardwired 43 * devices the BIOS tells us are there appear first, then speculative 44 * devices that are sensitive to the probe order, then devices that 45 * are hinted to be there, then the most flexible devices which support 46 * the ISA bus PNP standard. 47 */ 48#define ISA_ORDER_PNPBIOS 10 /* plug-and-play BIOS inflexible hardware */ 49#define ISA_ORDER_SENSITIVE 20 /* legacy sensitive hardware */ 50#define ISA_ORDER_SPECULATIVE 30 /* legacy non-sensitive hardware */ 51#define ISA_ORDER_PNP 40 /* plug-and-play flexible hardware */ 52 53/* 54 * Limits on resources that we can manage 55 */ 56#define ISA_NPORT 50 57#define ISA_NMEM 50 58#define ISA_NIRQ 50 59#define ISA_NDRQ 50 60 61/* 62 * Limits on resources the hardware can actually handle 63 */ 64#define ISA_PNP_NPORT 8 65#define ISA_PNP_NMEM 4 66#define ISA_PNP_NIRQ 2 67#define ISA_PNP_NDRQ 2 68 69#define ISADMA_READ 0x00100000 70#define ISADMA_WRITE 0 71#define ISADMA_RAW 0x00080000 72/* 73 * Plug and play cards can support a range of resource 74 * configurations. This structure is used by the isapnp parser to 75 * inform the isa bus about the resource possibilities of the 76 * device. Each different alternative should be supplied by calling 77 * ISA_ADD_CONFIG(). 78 */ 79struct isa_range { 80 uint32_t ir_start; 81 uint32_t ir_end; 82 uint32_t ir_size; 83 uint32_t ir_align; 84}; 85 86struct isa_config { 87 struct isa_range ic_mem[ISA_NMEM]; 88 struct isa_range ic_port[ISA_NPORT]; 89 uint32_t ic_irqmask[ISA_NIRQ]; 90 uint32_t ic_drqmask[ISA_NDRQ]; 91 int ic_nmem; 92 int ic_nport; 93 int ic_nirq; 94 int ic_ndrq; 95}; 96 97/* 98 * Used to build lists of IDs and description strings for PnP drivers. 99 */ 100struct isa_pnp_id { 101 uint32_t ip_id; 102 const char *ip_desc; 103}; 104 105enum isa_device_ivars { 106 ISA_IVAR_PORT, 107 ISA_IVAR_PORT_0 = ISA_IVAR_PORT, 108 ISA_IVAR_PORT_1, 109 ISA_IVAR_PORTSIZE, 110 ISA_IVAR_PORTSIZE_0 = ISA_IVAR_PORTSIZE, 111 ISA_IVAR_PORTSIZE_1, 112 ISA_IVAR_MADDR, 113 ISA_IVAR_MADDR_0 = ISA_IVAR_MADDR, 114 ISA_IVAR_MADDR_1, 115 ISA_IVAR_MEMSIZE, 116 ISA_IVAR_MEMSIZE_0 = ISA_IVAR_MEMSIZE, 117 ISA_IVAR_MEMSIZE_1, 118 ISA_IVAR_IRQ, 119 ISA_IVAR_IRQ_0 = ISA_IVAR_IRQ, 120 ISA_IVAR_IRQ_1, 121 ISA_IVAR_DRQ, 122 ISA_IVAR_DRQ_0 = ISA_IVAR_DRQ, 123 ISA_IVAR_DRQ_1, 124 ISA_IVAR_VENDORID, 125 ISA_IVAR_SERIAL, 126 ISA_IVAR_LOGICALID, 127 ISA_IVAR_COMPATID, 128 ISA_IVAR_CONFIGATTR, 129 ISA_IVAR_PNP_CSN, 130 ISA_IVAR_PNP_LDN, 131 ISA_IVAR_PNPBIOS_HANDLE 132}; 133 134/* 135 * ISA_IVAR_CONFIGATTR bits 136 */ 137#define ISACFGATTR_CANDISABLE (1 << 0) /* can be disabled */ 138#define ISACFGATTR_DYNAMIC (1 << 1) /* dynamic configuration */ 139#define ISACFGATTR_HINTS (1 << 3) /* source of config is hints */ 140 141#define ISA_PNP_DESCR "E:pnpid;D:#" 142#define ISA_PNP_INFO(t) \ 143 MODULE_PNP_INFO(ISA_PNP_DESCR, isa, t, t, nitems(t) - 1); \ 144 145/* 146 * Simplified accessors for isa devices 147 */ 148#define ISA_ACCESSOR(var, ivar, type) \ 149 __BUS_ACCESSOR(isa, var, ISA, ivar, type) 150 151ISA_ACCESSOR(port, PORT, int) 152ISA_ACCESSOR(portsize, PORTSIZE, int) 153ISA_ACCESSOR(irq, IRQ, int) 154ISA_ACCESSOR(drq, DRQ, int) 155ISA_ACCESSOR(maddr, MADDR, int) 156ISA_ACCESSOR(msize, MEMSIZE, int) 157ISA_ACCESSOR(vendorid, VENDORID, int) 158ISA_ACCESSOR(serial, SERIAL, int) 159ISA_ACCESSOR(logicalid, LOGICALID, int) 160ISA_ACCESSOR(compatid, COMPATID, int) 161ISA_ACCESSOR(configattr, CONFIGATTR, int) 162ISA_ACCESSOR(pnp_csn, PNP_CSN, int) 163ISA_ACCESSOR(pnp_ldn, PNP_LDN, int) 164ISA_ACCESSOR(pnpbios_handle, PNPBIOS_HANDLE, int) 165 166extern void isa_probe_children(device_t dev); 167 168void isa_dmacascade(int chan); 169void isa_dmadone(int flags, caddr_t addr, int nbytes, int chan); 170int isa_dma_init(int chan, u_int bouncebufsize, int flag); 171void isa_dmastart(int flags, caddr_t addr, u_int nbytes, int chan); 172int isa_dma_acquire(int chan); 173void isa_dma_release(int chan); 174int isa_dmastatus(int chan); 175int isa_dmastop(int chan); 176int isa_dmatc(int chan); 177 178#define isa_dmainit(chan, size) do { \ 179 if (isa_dma_init(chan, size, M_NOWAIT)) \ 180 printf("WARNING: isa_dma_init(%d, %ju) failed\n", \ 181 (int)(chan), (uintmax_t)(size)); \ 182 } while (0) 183 184void isa_hinted_child(device_t parent, const char *name, int unit); 185void isa_hint_device_unit(device_t bus, device_t child, const char *name, 186 int *unitp); 187int isab_attach(device_t dev); 188 189#endif /* _KERNEL */ 190 191#endif /* !_ISA_ISAVAR_H_ */ 192