Home | History | Annotate | Line # | Download | only in isa
isavar.h revision 1.21 
      1 /*	$NetBSD: isavar.h,v 1.21 1996/04/11 22:20:50 cgd Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1995 Chris G. Demetriou
      5  * Copyright (c) 1992 Berkeley Software Design, Inc.
      6  * All rights reserved.
      7  *
      8  * Redistribution and use in source and binary forms, with or without
      9  * modification, are permitted provided that the following conditions
     10  * are met:
     11  * 1. Redistributions of source code must retain the above copyright
     12  *    notice, this list of conditions and the following disclaimer.
     13  * 2. Redistributions in binary form must reproduce the above copyright
     14  *    notice, this list of conditions and the following disclaimer in the
     15  *    documentation and/or other materials provided with the distribution.
     16  * 3. All advertising materials mentioning features or use of this software
     17  *    must display the following acknowledgement:
     18  *	This product includes software developed by Berkeley Software
     19  *	Design, Inc.
     20  * 4. The name of Berkeley Software Design must not be used to endorse
     21  *    or promote products derived from this software without specific
     22  *    prior written permission.
     23  *
     24  * THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN, INC. ``AS IS'' AND
     25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     27  * ARE DISCLAIMED.  IN NO EVENT SHALL BERKELEY SOFTWARE DESIGN, INC. BE LIABLE
     28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     34  * SUCH DAMAGE.
     35  *
     36  *	BSDI Id: isavar.h,v 1.5 1992/12/01 18:06:00 karels Exp
     37  */
     38 
     39 #ifndef _DEV_ISA_ISAVAR_H_
     40 #define	_DEV_ISA_ISAVAR_H_
     41 
     42 /*
     43  * Definitions for ISA autoconfiguration.
     44  */
     45 
     46 #include <sys/queue.h>
     47 #include <machine/bus.h>
     48 
     49 /*
     50  * Structures and definitions needed by the machine-dependent header.
     51  */
     52 struct isabus_attach_args;
     53 
     54 #if (alpha + i386 != 1)
     55 ERROR: COMPILING FOR UNSUPPORTED MACHINE, OR MORE THAN ONE.
     56 #endif
     57 #if alpha
     58 #include <alpha/isa/isa_machdep.h>
     59 #endif
     60 #if i386
     61 #include <i386/isa/isa_machdep.h>
     62 #endif
     63 
     64 /*
     65  * ISA bus attach arguments
     66  */
     67 struct isabus_attach_args {
     68 	char	*iba_busname;			/* XXX should be common */
     69 	bus_chipset_tag_t iba_bc;		/* XXX should be common */
     70 	isa_chipset_tag_t iba_ic;
     71 };
     72 
     73 /*
     74  * ISA driver attach arguments
     75  */
     76 struct isa_attach_args {
     77 	bus_chipset_tag_t ia_bc;
     78 	isa_chipset_tag_t ia_ic;
     79 
     80 	int	ia_iobase;		/* base i/o address */
     81 	int	ia_iosize;		/* span of ports used */
     82 	int	ia_irq;			/* interrupt request */
     83 	int	ia_drq;			/* DMA request */
     84 	int	ia_maddr;		/* physical i/o mem addr */
     85 	u_int	ia_msize;		/* size of i/o memory */
     86 	void	*ia_aux;		/* driver specific */
     87 };
     88 
     89 #define	IOBASEUNK	-1		/* i/o address is unknown */
     90 #define	IRQUNK		-1		/* interrupt request line is unknown */
     91 #define	DRQUNK		-1		/* DMA request line is unknown */
     92 #define	MADDRUNK	-1		/* shared memory address is unknown */
     93 
     94 /*
     95  * Per-device ISA variables
     96  */
     97 struct isadev {
     98 	struct  device *id_dev;		/* back pointer to generic */
     99 	TAILQ_ENTRY(isadev)
    100 		id_bchain;		/* bus chain */
    101 };
    102 
    103 /*
    104  * ISA master bus
    105  */
    106 struct isa_softc {
    107 	struct	device sc_dev;		/* base device */
    108 	TAILQ_HEAD(, isadev)
    109 		sc_subdevs;		/* list of all children */
    110 
    111 	bus_chipset_tag_t sc_bc;
    112 	isa_chipset_tag_t sc_ic;
    113 };
    114 
    115 #define		cf_iobase		cf_loc[0]
    116 #define		cf_iosize		cf_loc[1]
    117 #define		cf_maddr		cf_loc[2]
    118 #define		cf_msize		cf_loc[3]
    119 #define		cf_irq			cf_loc[4]
    120 #define		cf_drq			cf_loc[5]
    121 
    122 /*
    123  * ISA interrupt handler manipulation.
    124  *
    125  * To establish an ISA interrupt handler, a driver calls isa_intr_establish()
    126  * with the interrupt number, type, level, function, and function argument of
    127  * the interrupt it wants to handle.  Isa_intr_establish() returns an opaque
    128  * handle to an event descriptor if it succeeds, and invokes panic() if it
    129  * fails.  (XXX It should return NULL, then drivers should handle that, but
    130  * what should they do?)  Interrupt handlers should return 0 for "interrupt
    131  * not for me", 1  for "I took care of it", or -1 for "I guess it was mine,
    132  * but I wasn't expecting it."
    133  *
    134  * To remove an interrupt handler, the driver calls isa_intr_disestablish()
    135  * with the handle returned by isa_intr_establish() for that handler.
    136  */
    137 
    138 /* ISA interrupt sharing types */
    139 void	isascan __P((struct device *parent, void *match));
    140 char	*isa_intr_typename __P((int type));
    141 
    142 #ifdef NEWCONFIG
    143 /*
    144  * Establish a device as being on the ISA bus (XXX NOT IMPLEMENTED).
    145  */
    146 void isa_establish __P((struct isadev *, struct device *));
    147 #endif
    148 
    149 #endif /* _DEV_ISA_ISAVAR_H_ */
    150