1 /*        $NetBSD: intr.h,v 1.12 2020/07/27 12:32:54 skrll 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   _IYONIX_INTR_H_
39 #define   _IYONIX_INTR_H_
40 
41 #ifdef _KERNEL
42 
43 /* Interrupt priority "levels". */
44 #define   IPL_NONE  0         /* nothing */
45 #define   IPL_SOFTCLOCK       1         /* software clock interrupt */
46 #define   IPL_SOFTBIO         2         /* generic software interrupts */
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         /* scheduler */
51 #define   IPL_HIGH  6         /* everything */
52 
53 #define   NIPL                7
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 
67 #ifndef _LOCORE
68 
69 #if defined(_MODULE)
70 
71 int       _splraise(int);
72 int       _spllower(int);
73 void      splx(int);
74 
75 #else     /* _MODULE */
76 
77 #include "opt_arm_intr_impl.h"
78 
79 #if defined(ARM_INTR_IMPL)
80 
81 /*
82  * Each board needs to define the following functions:
83  *
84  * int    _splraise(int);
85  * int    _spllower(int);
86  * void   splx(int);
87  * void   _setsoftintr(int);
88  *
89  * These may be defined as functions, static inline functions, or macros,
90  * but there must be a _spllower() and splx() defined as functions callable
91  * from assembly language (for cpu_switch()).  However, since it's quite
92  * useful to be able to inline splx(), you could do something like the
93  * following:
94  *
95  * in <boardtype>_intr.h:
96  *        static inline int
97  *        boardtype_splx(int spl)
98  *        {...}
99  *
100  *        #define splx(nspl)  boardtype_splx(nspl)
101  *        ...
102  * and in boardtype's machdep code:
103  *
104  *        ...
105  *        #undef splx
106  *        int
107  *        splx(int spl)
108  *        {
109  *                  return boardtype_splx(spl);
110  *        }
111  */
112 
113 #include ARM_INTR_IMPL
114 
115 #else /* ARM_INTR_IMPL */
116 
117 #error ARM_INTR_IMPL not defined.
118 
119 #endif    /* ARM_INTR_IMPL */
120 
121 #endif /* _MODULE */
122 
123 typedef uint8_t ipl_t;
124 typedef struct {
125           ipl_t _ipl;
126 } ipl_cookie_t;
127 
128 static inline ipl_cookie_t
makeiplcookie(ipl_t ipl)129 makeiplcookie(ipl_t ipl)
130 {
131 
132           return (ipl_cookie_t){._ipl = ipl};
133 }
134 
135 static inline int
splraiseipl(ipl_cookie_t icookie)136 splraiseipl(ipl_cookie_t icookie)
137 {
138 
139           return _splraise(icookie._ipl);
140 }
141 
142 #define   spl0()              _spllower(IPL_NONE)
143 
144 #include <sys/spl.h>
145 
146 #endif /* ! _LOCORE */
147 
148 #endif /* _KERNEL */
149 
150 #endif    /* _IYONIX_INTR_H_ */
151