1 /* $NetBSD: intr.h,v 1.29 2023/07/11 10:42:07 riastradh Exp $ */ 2 3 /* 4 * Copyright (c) 2001, 2003 Wasabi Systems, Inc. 5 * All rights reserved. 6 * 7 * Written by Jason R. Thorpe for Wasabi Systems, Inc. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 3. All advertising materials mentioning features or use of this software 18 * must display the following acknowledgement: 19 * This product includes software developed for the NetBSD Project by 20 * Wasabi Systems, Inc. 21 * 4. The name of Wasabi Systems, Inc. may not be used to endorse 22 * or promote products derived from this software without specific prior 23 * written permission. 24 * 25 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND 26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC 29 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35 * POSSIBILITY OF SUCH DAMAGE. 36 */ 37 38 #ifndef _EVBARM_INTR_H_ 39 #define _EVBARM_INTR_H_ 40 41 #ifdef _KERNEL 42 43 /* Interrupt priority "levels". */ 44 #define IPL_NONE 0 /* nothing */ 45 #define IPL_SOFTCLOCK 1 /* clock */ 46 #define IPL_SOFTBIO 2 /* block I/O */ 47 #define IPL_SOFTNET 3 /* software network interrupt */ 48 #define IPL_SOFTSERIAL 4 /* software serial interrupt */ 49 #define IPL_VM 5 /* memory allocation */ 50 #define IPL_SCHED 6 /* clock interrupt */ 51 #define IPL_HIGH 7 /* everything */ 52 53 #define NIPL 8 54 55 /* Interrupt sharing types. */ 56 #define IST_NONE 0 /* none */ 57 #define IST_PULSE 1 /* pulsed */ 58 #define IST_EDGE 2 /* edge-triggered */ 59 #define IST_LEVEL 3 /* level-triggered */ 60 61 #define IST_LEVEL_LOW IST_LEVEL 62 #define IST_LEVEL_HIGH 4 63 #define IST_EDGE_FALLING IST_EDGE 64 #define IST_EDGE_RISING 5 65 #define IST_EDGE_BOTH 6 66 #define IST_SOFT 7 67 68 #define IST_MPSAFE 0x100 /* interrupt is MPSAFE */ 69 70 #ifndef _LOCORE 71 72 #include <sys/queue.h> 73 74 typedef uint8_t ipl_t; 75 typedef struct { 76 ipl_t _ipl; 77 } ipl_cookie_t; 78 79 #if defined(_MODULE) 80 81 int _splraise(int); 82 int _spllower(int); 83 void splx(int); 84 85 #else /* _MODULE */ 86 87 #include "opt_arm_intr_impl.h" 88 89 #if defined(ARM_INTR_IMPL) 90 91 /* 92 * Each board needs to define the following functions: 93 * 94 * int _splraise(int); 95 * int _spllower(int); 96 * void splx(int); 97 * 98 * These may be defined as functions, static inline functions, or macros, 99 * but there must be a _spllower() and splx() defined as functions callable 100 * from assembly language (for cpu_switch()). However, since it's quite 101 * useful to be able to inline splx(), you could do something like the 102 * following: 103 * 104 * in <boardtype>_intr.h: 105 * static inline int 106 * boardtype_splx(int spl) 107 * {...} 108 * 109 * #define splx(nspl) boardtype_splx(nspl) 110 * ... 111 * and in boardtype's machdep code: 112 * 113 * ... 114 * #undef splx 115 * int 116 * splx(int spl) 117 * { 118 * return boardtype_splx(spl); 119 * } 120 */ 121 122 #include ARM_INTR_IMPL 123 124 #else /* ARM_INTR_IMPL */ 125 126 #error ARM_INTR_IMPL not defined. 127 128 #endif /* ARM_INTR_IMPL */ 129 130 #endif /* _MODULE */ 131 132 static inline ipl_cookie_t 133 makeiplcookie(ipl_t ipl) 134 { 135 136 return (ipl_cookie_t){._ipl = ipl}; 137 } 138 139 static inline int 140 splraiseipl(ipl_cookie_t icookie) 141 { 142 143 return _splraise(icookie._ipl); 144 } 145 146 #define spl0() _spllower(IPL_NONE) 147 148 #include <sys/spl.h> 149 150 #endif /* ! _LOCORE */ 151 152 #endif /* _KERNEL */ 153 154 #endif /* _EVBARM_INTR_H_ */ 155