Home | History | Annotate | Line # | Download | only in include
intr.h revision 1.57
      1 /* $NetBSD: intr.h,v 1.57 2007/01/12 00:55:40 ad Exp $ */
      2 
      3 /*-
      4  * Copyright (c) 2000, 2001, 2002 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Jason R. Thorpe.
      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  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *	This product includes software developed by the NetBSD
     21  *	Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 /*
     40  * Copyright (c) 1997 Christopher G. Demetriou.  All rights reserved.
     41  * Copyright (c) 1996 Carnegie-Mellon University.
     42  * All rights reserved.
     43  *
     44  * Author: Chris G. Demetriou
     45  *
     46  * Permission to use, copy, modify and distribute this software and
     47  * its documentation is hereby granted, provided that both the copyright
     48  * notice and this permission notice appear in all copies of the
     49  * software, derivative works or modified versions, and any portions
     50  * thereof, and that both notices appear in supporting documentation.
     51  *
     52  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
     53  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
     54  * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
     55  *
     56  * Carnegie Mellon requests users of this software to return to
     57  *
     58  *  Software Distribution Coordinator  or  Software.Distribution (at) CS.CMU.EDU
     59  *  School of Computer Science
     60  *  Carnegie Mellon University
     61  *  Pittsburgh PA 15213-3890
     62  *
     63  * any improvements or extensions that they make and grant Carnegie the
     64  * rights to redistribute these changes.
     65  */
     66 
     67 #ifndef _ALPHA_INTR_H_
     68 #define _ALPHA_INTR_H_
     69 
     70 #include <sys/device.h>
     71 #include <sys/lock.h>
     72 #include <sys/queue.h>
     73 #include <machine/atomic.h>
     74 
     75 /*
     76  * The Alpha System Control Block.  This is 8k long, and you get
     77  * 16 bytes per vector (i.e. the vector numbers are spaced 16
     78  * apart).
     79  *
     80  * This is sort of a "shadow" SCB -- rather than the CPU jumping
     81  * to (SCBaddr + (16 * vector)), like it does on the VAX, we get
     82  * a vector number in a1.  We use the SCB to look up a routine/arg
     83  * and jump to it.
     84  *
     85  * Since we use the SCB only for I/O interrupts, we make it shorter
     86  * than normal, starting it at vector 0x800 (the start of the I/O
     87  * interrupt vectors).
     88  */
     89 #define	SCB_IOVECBASE	0x0800
     90 #define	SCB_VECSIZE	0x0010
     91 #define	SCB_SIZE	0x2000
     92 
     93 #define	SCB_VECTOIDX(x)	((x) >> 4)
     94 #define	SCB_IDXTOVEC(x)	((x) << 4)
     95 
     96 #define	SCB_NIOVECS	SCB_VECTOIDX(SCB_SIZE - SCB_IOVECBASE)
     97 
     98 struct scbvec {
     99 	void	(*scb_func)(void *, u_long);
    100 	void	*scb_arg;
    101 };
    102 
    103 /*
    104  * Alpha interrupts come in at one of 4 levels:
    105  *
    106  *	software interrupt level
    107  *	i/o level 1
    108  *	i/o level 2
    109  *	clock level
    110  *
    111  * However, since we do not have any way to know which hardware
    112  * level a particular i/o interrupt comes in on, we have to
    113  * whittle it down to 3.
    114  */
    115 
    116 #define	IPL_NONE	0	/* no interrupt level */
    117 #define	IPL_SOFT	1	/* generic software interrupts */
    118 #define	IPL_SOFTCLOCK	2	/* clock software interrupts */
    119 #define	IPL_SOFTNET	3	/* network software interrupts */
    120 #define	IPL_SOFTSERIAL	4	/* serial software interrupts */
    121 #define	IPL_BIO		5	/* block I/O interrupts */
    122 #define	IPL_NET		6	/* network interrupts */
    123 #define	IPL_TTY		7	/* terminal interrupts */
    124 #define	IPL_LPT		IPL_TTY
    125 #define	IPL_VM		8	/* interrupts that can alloc mem */
    126 #define	IPL_CLOCK	9	/* clock interrupts */
    127 #define	IPL_IPI		IPL_CLOCK /* AARM, 5-2, II-B */
    128 #define	IPL_STATCLOCK	IPL_CLOCK
    129 #define	IPL_HIGH	10	/* all interrupts */
    130 #define	IPL_SCHED	IPL_HIGH
    131 #define	IPL_LOCK	IPL_HIGH
    132 #define	IPL_SERIAL	11	/* serial interrupts */
    133 
    134 typedef int ipl_t;
    135 typedef struct {
    136 	uint8_t _psl;
    137 } ipl_cookie_t;
    138 
    139 ipl_cookie_t makeiplcookie(ipl_t);
    140 
    141 #define	SI_SOFTSERIAL	0
    142 #define	SI_SOFTNET	1
    143 #define	SI_SOFTCLOCK	2
    144 #define	SI_SOFT		3
    145 
    146 #define	SI_NQUEUES	4
    147 
    148 #define	SI_QUEUENAMES {							\
    149 	"serial",							\
    150 	"net",								\
    151 	"clock",							\
    152 	"misc",								\
    153 }
    154 
    155 #define	IST_UNUSABLE	-1	/* interrupt cannot be used */
    156 #define	IST_NONE	0	/* none (dummy) */
    157 #define	IST_PULSE	1	/* pulsed */
    158 #define	IST_EDGE	2	/* edge-triggered */
    159 #define	IST_LEVEL	3	/* level-triggered */
    160 
    161 #ifdef	_KERNEL
    162 
    163 /* Simulated software interrupt register. */
    164 extern volatile unsigned long ssir;
    165 
    166 /* IPL-lowering/restoring macros */
    167 void	spl0(void);
    168 
    169 static __inline void
    170 splx(int s)
    171 {
    172 	if (s == ALPHA_PSL_IPL_0 && ssir != 0)
    173 		spl0();
    174 	else
    175 		alpha_pal_swpipl(s);
    176 }
    177 #define	spllowersoftclock()	((void)alpha_pal_swpipl(ALPHA_PSL_IPL_SOFT))
    178 
    179 /* IPL-raising functions/macros */
    180 static __inline int
    181 _splraise(int s)
    182 {
    183 	int cur = alpha_pal_rdps() & ALPHA_PSL_IPL_MASK;
    184 	return (s > cur ? alpha_pal_swpipl(s) : cur);
    185 }
    186 
    187 #define	splraiseipl(icookie)	_splraise((icookie)._psl)
    188 
    189 #include <sys/spl.h>
    190 
    191 /*
    192  * Interprocessor interrupts.  In order how we want them processed.
    193  */
    194 #define	ALPHA_IPI_HALT			(1UL << 0)
    195 #define	ALPHA_IPI_MICROSET		(1UL << 1)
    196 #define	ALPHA_IPI_SHOOTDOWN		(1UL << 2)
    197 #define	ALPHA_IPI_IMB			(1UL << 3)
    198 #define	ALPHA_IPI_AST			(1UL << 4)
    199 #define	ALPHA_IPI_SYNCH_FPU		(1UL << 5)
    200 #define	ALPHA_IPI_DISCARD_FPU		(1UL << 6)
    201 #define	ALPHA_IPI_PAUSE			(1UL << 7)
    202 #define	ALPHA_IPI_PMAP_REACTIVATE	(1UL << 8)
    203 
    204 #define	ALPHA_NIPIS		9	/* must not exceed 64 */
    205 
    206 struct cpu_info;
    207 struct trapframe;
    208 
    209 void	alpha_ipi_init(struct cpu_info *);
    210 void	alpha_ipi_process(struct cpu_info *, struct trapframe *);
    211 void	alpha_send_ipi(unsigned long, unsigned long);
    212 void	alpha_broadcast_ipi(unsigned long);
    213 void	alpha_multicast_ipi(unsigned long, unsigned long);
    214 
    215 /*
    216  * Alpha shared-interrupt-line common code.
    217  */
    218 
    219 struct alpha_shared_intrhand {
    220 	TAILQ_ENTRY(alpha_shared_intrhand)
    221 		ih_q;
    222 	struct alpha_shared_intr *ih_intrhead;
    223 	int	(*ih_fn)(void *);
    224 	void	*ih_arg;
    225 	int	ih_level;
    226 	unsigned int ih_num;
    227 };
    228 
    229 struct alpha_shared_intr {
    230 	TAILQ_HEAD(,alpha_shared_intrhand)
    231 		intr_q;
    232 	struct evcnt intr_evcnt;
    233 	char	*intr_string;
    234 	void	*intr_private;
    235 	int	intr_sharetype;
    236 	int	intr_dfltsharetype;
    237 	int	intr_nstrays;
    238 	int	intr_maxstrays;
    239 };
    240 
    241 #define	ALPHA_SHARED_INTR_DISABLE(asi, num)				\
    242 	((asi)[num].intr_maxstrays != 0 &&				\
    243 	 (asi)[num].intr_nstrays == (asi)[num].intr_maxstrays)
    244 
    245 #define	setsoft(x)	atomic_setbits_ulong(&ssir, 1 << (x))
    246 
    247 struct alpha_soft_intrhand {
    248 	TAILQ_ENTRY(alpha_soft_intrhand)
    249 		sih_q;
    250 	struct alpha_soft_intr *sih_intrhead;
    251 	void	(*sih_fn)(void *);
    252 	void	*sih_arg;
    253 	int	sih_pending;
    254 };
    255 
    256 struct alpha_soft_intr {
    257 	TAILQ_HEAD(, alpha_soft_intrhand)
    258 		softintr_q;
    259 	struct evcnt softintr_evcnt;
    260 	struct simplelock softintr_slock;
    261 	unsigned long softintr_siq;
    262 };
    263 
    264 void	*softintr_establish(int, void (*)(void *), void *);
    265 void	softintr_disestablish(void *);
    266 void	softintr_init(void);
    267 void	softintr_dispatch(void);
    268 
    269 #define	softintr_schedule(arg)						\
    270 do {									\
    271 	struct alpha_soft_intrhand *__sih = (arg);			\
    272 	struct alpha_soft_intr *__si = __sih->sih_intrhead;		\
    273 	int __s;							\
    274 									\
    275 	__s = splhigh();						\
    276 	simple_lock(&__si->softintr_slock);				\
    277 	if (__sih->sih_pending == 0) {					\
    278 		TAILQ_INSERT_TAIL(&__si->softintr_q, __sih, sih_q);	\
    279 		__sih->sih_pending = 1;					\
    280 		setsoft(__si->softintr_siq);				\
    281 	}								\
    282 	simple_unlock(&__si->softintr_slock);				\
    283 	splx(__s);							\
    284 } while (0)
    285 
    286 /* XXX For legacy software interrupts. */
    287 extern struct alpha_soft_intrhand *softnet_intrhand;
    288 
    289 #define	setsoftnet()	softintr_schedule(softnet_intrhand)
    290 
    291 struct alpha_shared_intr *alpha_shared_intr_alloc(unsigned int, unsigned int);
    292 int	alpha_shared_intr_dispatch(struct alpha_shared_intr *,
    293 	    unsigned int);
    294 void	*alpha_shared_intr_establish(struct alpha_shared_intr *,
    295 	    unsigned int, int, int, int (*)(void *), void *, const char *);
    296 void	alpha_shared_intr_disestablish(struct alpha_shared_intr *,
    297 	    void *, const char *);
    298 int	alpha_shared_intr_get_sharetype(struct alpha_shared_intr *,
    299 	    unsigned int);
    300 int	alpha_shared_intr_isactive(struct alpha_shared_intr *,
    301 	    unsigned int);
    302 int	alpha_shared_intr_firstactive(struct alpha_shared_intr *,
    303 	    unsigned int);
    304 void	alpha_shared_intr_set_dfltsharetype(struct alpha_shared_intr *,
    305 	    unsigned int, int);
    306 void	alpha_shared_intr_set_maxstrays(struct alpha_shared_intr *,
    307 	    unsigned int, int);
    308 void	alpha_shared_intr_reset_strays(struct alpha_shared_intr *,
    309 	    unsigned int);
    310 void	alpha_shared_intr_stray(struct alpha_shared_intr *, unsigned int,
    311 	    const char *);
    312 void	alpha_shared_intr_set_private(struct alpha_shared_intr *,
    313 	    unsigned int, void *);
    314 void	*alpha_shared_intr_get_private(struct alpha_shared_intr *,
    315 	    unsigned int);
    316 char	*alpha_shared_intr_string(struct alpha_shared_intr *,
    317 	    unsigned int);
    318 struct evcnt *alpha_shared_intr_evcnt(struct alpha_shared_intr *,
    319 	    unsigned int);
    320 
    321 extern struct scbvec scb_iovectab[];
    322 
    323 void	scb_init(void);
    324 void	scb_set(u_long, void (*)(void *, u_long), void *);
    325 u_long	scb_alloc(void (*)(void *, u_long), void *);
    326 void	scb_free(u_long);
    327 
    328 #define	SCB_ALLOC_FAILED	((u_long) -1)
    329 
    330 #endif /* _KERNEL */
    331 #endif /* ! _ALPHA_INTR_H_ */
    332