1 /* $OpenBSD: intrdefs.h,v 1.19 2024/11/08 00:13:39 jsg Exp $ */ 2 /* $NetBSD: intrdefs.h,v 1.2 2003/05/04 22:01:56 fvdl Exp $ */ 3 4 #ifndef _I386_INTRDEFS_H 5 #define _I386_INTRDEFS_H 6 7 /* 8 * Intel APICs (advanced programmable interrupt controllers) have 9 * bytesized priority registers where the upper nibble is the actual 10 * interrupt priority level (a.k.a. IPL). Interrupt vectors are 11 * closely tied to these levels as interrupts whose vectors' upper 12 * nibble is lower than or equal to the current level are blocked. 13 * Not all 256 possible vectors are available for interrupts in 14 * APIC systems, only 15 * 16 * For systems where instead the older ICU (interrupt controlling 17 * unit, a.k.a. PIC or 82C59) is used, the IPL is not directly useful, 18 * since the interrupt blocking is handled via interrupt masks instead 19 * of levels. However the IPL is easily used as an offset into arrays 20 * of masks. 21 */ 22 #define IPLSHIFT 4 /* The upper nibble of vectors is the IPL. */ 23 #define NIPL 16 /* Four bits of information gives as much. */ 24 #define IPL(level) ((level) >> IPLSHIFT) /* Extract the IPL. */ 25 /* XXX Maybe this IDTVECOFF definition should be elsewhere? */ 26 #define IDTVECOFF 0x20 /* The lower 32 IDT vectors are reserved. */ 27 28 /* 29 * This macro is only defined for 0 <= x < 14, i.e. there are fourteen 30 * distinct priority levels available for interrupts. 31 */ 32 #define MAKEIPL(priority) (IDTVECOFF + ((priority) << IPLSHIFT)) 33 34 /* 35 * Interrupt priority levels. 36 * 37 * XXX We are somewhat sloppy about what we mean by IPLs, sometimes 38 * XXX we refer to the eight-bit value suitable for storing into APICs' 39 * XXX priority registers, other times about the four-bit entity found 40 * XXX in the former values' upper nibble, which can be used as offsets 41 * XXX in various arrays of our implementation. We are hoping that 42 * XXX the context will provide enough information to not make this 43 * XXX sloppy naming a real problem. 44 * 45 * There are tty, network and disk drivers that use free() at interrupt 46 * time, so imp > (tty | net | bio). 47 * 48 * Since run queues may be manipulated by both the statclock and tty, 49 * network, and disk drivers, clock > imp. 50 * 51 * IPL_HIGH must block everything that can manipulate a run queue. 52 * 53 * XXX Ultimately we may need serial drivers to run at the absolute highest 54 * XXX priority to avoid overruns, then we must make serial > high. 55 * 56 * The level numbers are picked to fit into APIC vector priorities. 57 */ 58 #define IPL_NONE 0 /* nothing */ 59 #define IPL_SOFTCLOCK MAKEIPL(1) /* timeouts */ 60 #define IPL_SOFTNET MAKEIPL(2) /* protocol stacks */ 61 #define IPL_BIO MAKEIPL(3) /* block I/O */ 62 #define IPL_NET MAKEIPL(4) /* network */ 63 #define IPL_SOFTTTY MAKEIPL(5) /* delayed terminal handling */ 64 #define IPL_TTY MAKEIPL(6) /* terminal */ 65 #define IPL_VM MAKEIPL(7) /* memory allocation */ 66 #define IPL_AUDIO MAKEIPL(8) /* audio */ 67 #define IPL_CLOCK MAKEIPL(9) /* clock */ 68 #define IPL_STATCLOCK IPL_CLOCK /* statclock */ 69 #define IPL_SCHED IPL_CLOCK 70 #define IPL_HIGH MAKEIPL(10) /* everything */ 71 #define IPL_IPI MAKEIPL(11) /* interprocessor interrupt */ 72 73 #define IPL_MPFLOOR IPL_TTY 74 #define IPL_MPSAFE 0x100 75 76 /* Interrupt sharing types. */ 77 #define IST_NONE 0 /* none */ 78 #define IST_PULSE 1 /* pulsed */ 79 #define IST_EDGE 2 /* edge-triggered */ 80 #define IST_LEVEL 3 /* level-triggered */ 81 82 /* 83 * Local APIC masks. Must not conflict with SIR_* below, and must 84 * be >= NUM_LEGACY_IRQs. Note that LIR_IPI must be first. 85 */ 86 #define LIR_IPI 31 87 #define LIR_TIMER 30 88 89 /* Soft interrupt masks. */ 90 #define SIR_CLOCK 29 91 #define SIR_NET 28 92 #define SIR_TTY 27 93 94 95 /* 96 * Maximum # of interrupt sources per CPU. 32 to fit in one word. 97 * ioapics can theoretically produce more, but it's not likely to 98 * happen. For multiple ioapics, things can be routed to different 99 * CPUs. 100 */ 101 #define MAX_INTR_SOURCES 32 102 #define NUM_LEGACY_IRQS 16 103 104 /* 105 * Low and high boundaries between which interrupt gates will 106 * be allocated in the IDT. 107 */ 108 #define IDT_INTR_LOW (0x20 + NUM_LEGACY_IRQS) 109 #define IDT_INTR_HIGH 0xef 110 111 #define I386_IPI_HALT 0x00000001 112 #define I386_IPI_NOP 0x00000002 113 #define I386_IPI_FLUSH_FPU 0x00000004 114 #define I386_IPI_SYNCH_FPU 0x00000008 115 #define I386_IPI_MTRR 0x00000010 116 #define I386_IPI_GDT 0x00000020 117 #define I386_IPI_DDB 0x00000040 /* synchronize while in ddb */ 118 #define I386_IPI_SETPERF 0x00000080 119 #define I386_IPI_WBINVD 0x00000100 120 121 #define I386_NIPI 9 122 123 #define IREENT_MAGIC 0x18041969 124 125 #endif /* _I386_INTRDEFS_H */ 126