NetBSD/sys/dev/isa/isavar.h

140 lines
4.8 KiB
C

/* $NetBSD: isavar.h,v 1.16 1995/06/07 06:45:44 cgd Exp $ */
/*
* 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
*/
/*
* Definitions for ISA autoconfiguration.
*/
#include <sys/queue.h>
/*
* ISA driver attach arguments
*/
struct isa_attach_args {
int ia_iobase; /* base i/o address */
int ia_iosize; /* span of ports used */
int ia_irq; /* interrupt request */
int ia_drq; /* DMA request */
int ia_maddr; /* physical i/o mem addr */
u_int ia_msize; /* size of i/o memory */
void *ia_aux; /* driver specific */
};
#define IOBASEUNK -1 /* i/o address is unknown */
#define IRQUNK -1 /* interrupt request line is unknown */
#define DRQUNK -1 /* DMA request line is unknown */
#define MADDRUNK -1 /* shared memory address is unknown */
/*
* Per-device ISA variables
*/
struct isadev {
struct device *id_dev; /* back pointer to generic */
TAILQ_ENTRY(isadev)
id_bchain; /* bus chain */
};
/*
* ISA master bus
*/
struct isa_softc {
struct device sc_dev; /* base device */
TAILQ_HEAD(, isadev)
sc_subdevs; /* list of all children */
};
#define cf_iobase cf_loc[0]
#define cf_iosize cf_loc[1]
#define cf_maddr cf_loc[2]
#define cf_msize cf_loc[3]
#define cf_irq cf_loc[4]
#define cf_drq cf_loc[5]
/*
* 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 invokes panic() if it
* fails. (XXX It should return NULL, then drivers should handle that, but
* what should they do?) 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.
*/
/* ISA interrupt sharing types */
typedef enum {
ISA_IST_NONE = 0, /* not yet assigned */
ISA_IST_PULSE, /* pulsed */
ISA_IST_EDGE, /* edge-triggered */
ISA_IST_LEVEL /* level-triggered */
} isa_intrtype;
/* ISA interrupt levels; system interrupt levels for ISA bus use */
typedef enum {
ISA_IPL_NONE, /* block only the interrupt's IRQ*/
ISA_IPL_BIO, /* block I/O interrupts */
ISA_IPL_NET, /* network */
ISA_IPL_TTY, /* terminal */
ISA_IPL_CLOCK, /* clock */
} isa_intrlevel;
void isascan __P((struct device *parent, void *match));
void *isa_intr_establish __P((int intr, isa_intrtype type,
isa_intrlevel level, int (*ih_fun)(void *), void *ih_arg));
void isa_intr_disestablish __P((void *handler));
char *isa_intr_typename __P((isa_intrtype type));
#ifdef NEWCONFIG
/*
* Establish a device as being on the ISA bus (XXX NOT IMPLEMENTED).
*/
void isa_establish __P((struct isadev *, struct device *));
#endif
/*
* software conventions
*/
typedef enum { BUS_ISA, BUS_EISA } isa_type;
extern isa_type isa_bustype; /* type of bus; XXX should be in softc */