282 lines
9.0 KiB
C
282 lines
9.0 KiB
C
/* $NetBSD: isavar.h,v 1.49 2007/10/19 12:00:19 ad Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 1997, 2001 The NetBSD Foundation, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
* by Jason R. Thorpe of Wasabi Systems, Inc.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by the NetBSD
|
|
* Foundation, Inc. and its contributors.
|
|
* 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 1995 Chris G. Demetriou
|
|
* Copyright (c) 1992 Berkeley Software Design, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by Berkeley Software
|
|
* Design, Inc.
|
|
* 4. The name of Berkeley Software Design must not be used to endorse
|
|
* or promote products derived from this software without specific
|
|
* prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN, INC. ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL BERKELEY SOFTWARE DESIGN, INC. BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* BSDI Id: isavar.h,v 1.5 1992/12/01 18:06:00 karels Exp
|
|
*/
|
|
|
|
#ifndef _DEV_ISA_ISAVAR_H_
|
|
#define _DEV_ISA_ISAVAR_H_
|
|
|
|
/*
|
|
* Definitions for ISA autoconfiguration.
|
|
*/
|
|
|
|
#include <sys/queue.h>
|
|
#include <sys/bus.h>
|
|
|
|
/*
|
|
* Structures and definitions needed by the machine-dependent header.
|
|
*/
|
|
struct isabus_attach_args;
|
|
|
|
#include <machine/isa_machdep.h>
|
|
|
|
/*
|
|
* ISA bus attach arguments
|
|
*/
|
|
struct isabus_attach_args {
|
|
const char *_iba_busname; /* XXX placeholder */
|
|
bus_space_tag_t iba_iot; /* isa i/o space tag */
|
|
bus_space_tag_t iba_memt; /* isa mem space tag */
|
|
bus_dma_tag_t iba_dmat; /* isa DMA tag */
|
|
isa_chipset_tag_t iba_ic;
|
|
};
|
|
|
|
/*
|
|
* ISA bus resources.
|
|
*/
|
|
|
|
struct isa_io {
|
|
int ir_addr;
|
|
int ir_size;
|
|
};
|
|
|
|
struct isa_iomem {
|
|
int ir_addr;
|
|
int ir_size;
|
|
};
|
|
|
|
struct isa_irq {
|
|
int ir_irq;
|
|
};
|
|
|
|
struct isa_drq {
|
|
int ir_drq;
|
|
};
|
|
|
|
struct isa_pnpname {
|
|
struct isa_pnpname *ipn_next;
|
|
char *ipn_name;
|
|
};
|
|
|
|
/*
|
|
* Machine-dependent code provides a list of these to describe
|
|
* devices on the ISA bus which should be attached via direct
|
|
* configuration.
|
|
*
|
|
* All of this information is dynamically allocated, so that
|
|
* the ISA bus driver may free all of this information if the
|
|
* bus does not support dynamic attach/detach of devices (e.g.
|
|
* on a docking station).
|
|
*
|
|
* Some info on the "ik_key" field: This is a unique number for
|
|
* each knowndev node. If, when we need to re-enumerate the
|
|
* knowndevs, we discover that a node with key N is in the old
|
|
* list but not in the new, the device has disappeared. Similarly,
|
|
* if a node with key M is in the new list but not in the old,
|
|
* the device is new. Note that the knowndevs list must be
|
|
* sorted in ascending "key" order.
|
|
*/
|
|
struct isa_knowndev {
|
|
TAILQ_ENTRY(isa_knowndev) ik_list;
|
|
uintptr_t ik_key;
|
|
struct device *ik_claimed;
|
|
|
|
/*
|
|
* The rest of these fields correspond to isa_attach_args
|
|
* fields.
|
|
*/
|
|
char *ik_pnpname;
|
|
struct isa_pnpname *ik_pnpcompatnames;
|
|
|
|
struct isa_io *ik_io;
|
|
int ik_nio;
|
|
|
|
struct isa_iomem *ik_iomem;
|
|
int ik_niomem;
|
|
|
|
struct isa_irq *ik_irq;
|
|
int ik_nirq;
|
|
|
|
struct isa_drq *ik_drq;
|
|
int ik_ndrq;
|
|
};
|
|
|
|
/*
|
|
* ISA driver attach arguments
|
|
*/
|
|
struct isa_attach_args {
|
|
bus_space_tag_t ia_iot; /* isa i/o space tag */
|
|
bus_space_tag_t ia_memt; /* isa mem space tag */
|
|
bus_dma_tag_t ia_dmat; /* DMA tag */
|
|
|
|
isa_chipset_tag_t ia_ic;
|
|
|
|
/*
|
|
* PNP (or other) names to with which we can match a device
|
|
* driver to a device that machine-dependent code tells us
|
|
* is there (i.e. support for direct-configuration of ISA
|
|
* devices).
|
|
*/
|
|
char *ia_pnpname;
|
|
struct isa_pnpname *ia_pnpcompatnames;
|
|
|
|
struct isa_io *ia_io; /* I/O resources */
|
|
int ia_nio;
|
|
|
|
struct isa_iomem *ia_iomem; /* memory resources */
|
|
int ia_niomem;
|
|
|
|
struct isa_irq *ia_irq; /* IRQ resources */
|
|
int ia_nirq;
|
|
|
|
struct isa_drq *ia_drq; /* DRQ resources */
|
|
int ia_ndrq;
|
|
|
|
void *ia_aux; /* driver specific */
|
|
};
|
|
|
|
/*
|
|
* Test to determine if a given call to an ISA device probe routine
|
|
* is actually an attempt to do direct configuration.
|
|
*/
|
|
#define ISA_DIRECT_CONFIG(ia) \
|
|
((ia)->ia_pnpname != NULL || (ia)->ia_pnpcompatnames != NULL)
|
|
|
|
/*
|
|
* ISA master bus
|
|
*/
|
|
struct isa_softc {
|
|
struct device sc_dev; /* base device */
|
|
|
|
bus_space_tag_t sc_iot; /* isa io space tag */
|
|
bus_space_tag_t sc_memt; /* isa mem space tag */
|
|
bus_dma_tag_t sc_dmat; /* isa DMA tag */
|
|
|
|
isa_chipset_tag_t sc_ic;
|
|
|
|
TAILQ_HEAD(, isa_knowndev) sc_knowndevs;
|
|
int sc_dynamicdevs;
|
|
};
|
|
|
|
/*
|
|
* These must be in sync with the ISACF_XXX_DEFAULT definitions
|
|
* in "locators.h" (generated from files.isa).
|
|
* (not including "locators.h" here to avoid dependency)
|
|
*/
|
|
#define ISA_UNKNOWN_PORT (-1)
|
|
#define ISA_UNKNOWN_IOMEM (-1)
|
|
#define ISA_UNKNOWN_IOSIZ (0)
|
|
#define ISA_UNKNOWN_IRQ (-1)
|
|
#define ISA_UNKNOWN_DRQ (-1)
|
|
#define ISA_UNKNOWN_DRQ2 (-1)
|
|
|
|
int isabusprint(void *, const char *);
|
|
|
|
/*
|
|
* ISA interrupt handler manipulation.
|
|
*
|
|
* To establish an ISA interrupt handler, a driver calls isa_intr_establish()
|
|
* with the interrupt number, type, level, function, and function argument of
|
|
* the interrupt it wants to handle. Isa_intr_establish() returns an opaque
|
|
* handle to an event descriptor if it succeeds, and returns NULL on failure.
|
|
* (XXX: some drivers can't handle this, since the former behaviour was to
|
|
* invoke panic() on failure). When the system does not accept any of the
|
|
* interrupt types supported by the driver, the driver should fail the attach.
|
|
* Interrupt handlers should return 0 for "interrupt not for me", 1 for
|
|
* "I took care of it", or -1 for "I guess it was mine, but I wasn't
|
|
* expecting it."
|
|
*
|
|
* To remove an interrupt handler, the driver calls isa_intr_disestablish()
|
|
* with the handle returned by isa_intr_establish() for that handler.
|
|
*
|
|
* The event counter (struct evcnt) associated with an interrupt line
|
|
* (to be used as 'parent' for an ISA device's interrupt handler's evcnt)
|
|
* can be obtained with isa_intr_evcnt().
|
|
*/
|
|
|
|
/* ISA interrupt sharing types */
|
|
const char *isa_intr_typename(int);
|
|
|
|
/*
|
|
* Some ISA devices (e.g. on a VLB) can perform 32-bit DMA. This
|
|
* flag is passed to bus_dmamap_create() to indicate that fact.
|
|
*/
|
|
#define ISABUS_DMA_32BIT BUS_DMA_BUS1
|
|
|
|
/*
|
|
* This flag indicates that the DMA channel should not yet be reserved,
|
|
* even if BUS_DMA_ALLOCNOW is specified.
|
|
*/
|
|
#define ISABUS_DMA_DEFERCHAN BUS_DMA_BUS2
|
|
|
|
#endif /* _DEV_ISA_ISAVAR_H_ */
|