ReactOS 0.4.16-dev-1078-g21d3e29
apicp.h
Go to the documentation of this file.
1/*
2 * PROJECT: ReactOS Kernel
3 * LICENSE: GPL-2.0-or-later (https://spdx.org/licenses/GPL-2.0-or-later)
4 * PURPOSE: Header file for APIC hal
5 * COPYRIGHT: Copyright 2011 Timo Kreuzer <timo.kreuzer@reactos.org>
6 * Copyright 2021 Justin Miller <justinmiller100@gmail.com>
7 */
8
9#pragma once
10
11#ifdef _M_AMD64
12 #define LOCAL_APIC_BASE 0xFFFFFFFFFFFE0000ULL
13 #define IOAPIC_BASE 0xFFFFFFFFFFFE1000ULL
14
15 /* Vectors */
16 #define APC_VECTOR 0x1F // IRQL 01 (APC_LEVEL) - KiApcInterrupt
17 #define DISPATCH_VECTOR 0x2F // IRQL 02 (DISPATCH_LEVEL) - KiDpcInterrupt
18 #define CMCI_VECTOR 0x35 // IRQL 05 (CMCI_LEVEL) - HalpInterruptCmciService
19 #define APIC_CLOCK_VECTOR 0xD1 // IRQL 13 (CLOCK_LEVEL), IRQ 8 - HalpTimerClockInterrupt
20 #define CLOCK_IPI_VECTOR 0xD2 // IRQL 13 (CLOCK_LEVEL) - HalpTimerClockIpiRoutine
21 #define REBOOT_VECTOR 0xD7 // IRQL 15 (PROFILE_LEVEL) - HalpInterruptRebootService
22 #define STUB_VECTOR 0xD8 // IRQL 15 (PROFILE_LEVEL) - HalpInterruptStubService
23 #define APIC_SPURIOUS_VECTOR 0xDF // IRQL 13 (CLOCK_LEVEL) - HalpInterruptSpuriousService
24 #define APIC_IPI_VECTOR 0xE1 // IRQL 14 (IPI_LEVEL) - KiIpiInterrupt
25 #define APIC_ERROR_VECTOR 0xE2 // IRQL 14 (IPI_LEVEL) - HalpInterruptLocalErrorService
26 #define POWERFAIL_VECTOR 0xE3 // IRQL 14 (POWER_LEVEL) : HalpInterruptDeferredRecoveryService
27 #define APIC_PROFILE_VECTOR 0xFD // IRQL 15 (PROFILE_LEVEL) - HalpTimerProfileInterrupt
28 #define APIC_PERF_VECTOR 0xFE // IRQL 15 (PROFILE_LEVEL) - HalpPerfInterrupt
29 #define APIC_NMI_VECTOR 0xFF
30
31 #define IrqlToTpr(Irql) (Irql << 4)
32 #define IrqlToSoftVector(Irql) ((Irql << 4)|0xf)
33 #define TprToIrql(Tpr) ((KIRQL)(Tpr >> 4))
34 #define CLOCK2_LEVEL CLOCK_LEVEL
35 #define APIC_PROFILE_LEVEL PROFILE_LEVEL
36#else
37 #define LOCAL_APIC_BASE 0xFFFE0000
38 #define IOAPIC_BASE 0xFFFE1000
39
40 /* Vectors */
41 #define APIC_SPURIOUS_VECTOR 0x1f
42 #define APC_VECTOR 0x3D // IRQL 01
43 #define DISPATCH_VECTOR 0x41 // IRQL 02
44 #define APIC_GENERIC_VECTOR 0xC1 // IRQL 27
45 #define APIC_CLOCK_VECTOR 0xD1 // IRQL 28
46 #define APIC_SYNCH_VECTOR 0xD1 // IRQL 28
47 #define CLOCK_IPI_VECTOR 0xD2 // IRQL 28
48 #define APIC_IPI_VECTOR 0xE1 // IRQL 29
49 #define APIC_ERROR_VECTOR 0xE3
50 #define POWERFAIL_VECTOR 0xEF // IRQL 30
51 #define APIC_PROFILE_VECTOR 0xFD // IRQL 31
52 #define APIC_PERF_VECTOR 0xFE
53 #define APIC_NMI_VECTOR 0xFF
54
55 #define IrqlToTpr(Irql) (HalpIRQLtoTPR[Irql])
56 #define IrqlToSoftVector(Irql) IrqlToTpr(Irql)
57 #define TprToIrql(Tpr) (HalVectorToIRQL[Tpr >> 4])
58 #define APIC_PROFILE_LEVEL HIGH_LEVEL
59#endif
60
61#define APIC_MAX_IRQ 24
62#define APIC_FREE_VECTOR 0xFF
63#define APIC_RESERVED_VECTOR 0xFE
64
65/* The IMCR is supported by two read/writable or write-only I/O ports,
66 22h and 23h, which receive address and data respectively.
67 To access the IMCR, write a value of 70h to I/O port 22h, which selects the IMCR.
68 Then write the data to I/O port 23h. The power-on default value is zero,
69 which connects the NMI and 8259 INTR lines directly to the BSP.
70 Writing a value of 01h forces the NMI and 8259 INTR signals to pass through the APIC.
71*/
72#define IMCR_ADDRESS_PORT (PUCHAR)0x0022
73#define IMCR_DATA_PORT (PUCHAR)0x0023
74#define IMCR_SELECT 0x70
75#define IMCR_PIC_DIRECT 0x00
76#define IMCR_PIC_VIA_APIC 0x01
77
78
79/* APIC Register Address Map */
80typedef enum _APIC_REGISTER
81{
82 APIC_ID = 0x0020, /* Local APIC ID Register (R/W) */
83 APIC_VER = 0x0030, /* Local APIC Version Register (R) */
84 APIC_TPR = 0x0080, /* Task Priority Register (R/W) */
85 APIC_APR = 0x0090, /* Arbitration Priority Register (R) */
86 APIC_PPR = 0x00A0, /* Processor Priority Register (R) */
87 APIC_EOI = 0x00B0, /* EOI Register (W) */
88 APIC_RRR = 0x00C0, /* Remote Read Register () */
89 APIC_LDR = 0x00D0, /* Logical Destination Register (R/W) */
90 APIC_DFR = 0x00E0, /* Destination Format Register (0-27 R, 28-31 R/W) */
91 APIC_SIVR = 0x00F0, /* Spurious Interrupt Vector Register (0-3 R, 4-9 R/W) */
92 APIC_ISR = 0x0100, /* Interrupt Service Register 0-255 (R) */
93 APIC_TMR = 0x0180, /* Trigger Mode Register 0-255 (R) */
94 APIC_IRR = 0x0200, /* Interrupt Request Register 0-255 (r) */
95 APIC_ESR = 0x0280, /* Error Status Register (R) */
96 APIC_ICR0 = 0x0300, /* Interrupt Command Register 0-31 (R/W) */
97 APIC_ICR1 = 0x0310, /* Interrupt Command Register 32-63 (R/W) */
98 APIC_TMRLVTR = 0x0320, /* Timer Local Vector Table (R/W) */
99 APIC_THRMLVTR = 0x0330, /* Thermal Local Vector Table */
100 APIC_PCLVTR = 0x0340, /* Performance Counter Local Vector Table (R/W) */
101 APIC_LINT0 = 0x0350, /* LINT0 Local Vector Table (R/W) */
102 APIC_LINT1 = 0x0360, /* LINT1 Local Vector Table (R/W) */
103 APIC_ERRLVTR = 0x0370, /* Error Local Vector Table (R/W) */
104 APIC_TICR = 0x0380, /* Initial Count Register for Timer (R/W) */
105 APIC_TCCR = 0x0390, /* Current Count Register for Timer (R) */
106 APIC_TDCR = 0x03E0, /* Timer Divide Configuration Register (R/W) */
107 APIC_EAFR = 0x0400, /* extended APIC Feature register (R/W) */
108 APIC_EACR = 0x0410, /* Extended APIC Control Register (R/W) */
109 APIC_SEOI = 0x0420, /* Specific End Of Interrupt Register (W) */
110 APIC_EXT0LVTR = 0x0500, /* Extended Interrupt 0 Local Vector Table */
111 APIC_EXT1LVTR = 0x0510, /* Extended Interrupt 1 Local Vector Table */
112 APIC_EXT2LVTR = 0x0520, /* Extended Interrupt 2 Local Vector Table */
113 APIC_EXT3LVTR = 0x0530 /* Extended Interrupt 3 Local Vector Table */
115
116#define MSR_APIC_BASE 0x0000001B
117#define IOAPIC_PHYS_BASE 0xFEC00000
118#define APIC_CLOCK_INDEX 8
119#define ApicLogicalId(Cpu) ((UCHAR)(1<< Cpu))
120
121/* The following definitions are based on AMD documentation.
122 They differ slightly in Intel documentation. */
123
124/* Message Type (Intel: "Delivery Mode") */
125typedef enum _APIC_MT
126{
136
137/* Trigger Mode */
138typedef enum _APIC_TGM
139{
143
144/* Destination Mode */
145typedef enum _APIC_DM
146{
150
151/* Destination Short Hand */
152typedef enum _APIC_DSH
153{
159
160/* Write Constants */
161typedef enum _APIC_DF
162{
163 APIC_DF_Flat = 0xFFFFFFFF,
164 APIC_DF_Cluster = 0x0FFFFFFF
166
167/* Remote Read Status */
168typedef enum _APIC_RRS
169{
172 APIC_RRS_Done = 2
174
175/* Timer Constants */
176typedef enum _TIMER_DV
177{
187
188#include <pshpack1.h>
190{
192 struct
193 {
200 };
202
204{
206 struct
207 {
212 };
214
216{
218 struct
219 {
225 };
227
229{
231 struct
232 {
237 };
239
241{
243 struct
244 {
247 };
248 struct
249 {
257 UINT64 RemoteReadStatus:2; /* Intel: Reserved */
261 };
263
264typedef union _LVT_REGISTER
265{
267 struct
268 {
279 };
281
282/* IOAPIC offsets */
283#define IOAPIC_IOREGSEL 0x00
284#define IOAPIC_IOWIN 0x10
285
286/* IOAPIC Constants */
287#define IOAPIC_ID 0x00
288#define IOAPIC_VER 0x01
289#define IOAPIC_ARB 0x02
290#define IOAPIC_REDTBL 0x10
291
293{
295 struct
296 {
299 };
300 struct
301 {
312 };
314#include <poppack.h>
315
317ULONG
319{
321}
322
324VOID
326{
328}
329
330VOID
331NTAPI
333
334VOID
335NTAPI
337
338VOID
339NTAPI
341
unsigned long long UINT64
unsigned int UINT32
#define __cdecl
Definition: accygwin.h:79
VOID NTAPI HalInitializeProfiling(VOID)
Definition: apictimer.c:76
_APIC_DF
Definition: apicp.h:162
@ APIC_DF_Flat
Definition: apicp.h:163
@ APIC_DF_Cluster
Definition: apicp.h:164
_APIC_DM
Definition: apicp.h:146
@ APIC_DM_Logical
Definition: apicp.h:148
@ APIC_DM_Physical
Definition: apicp.h:147
_APIC_DSH
Definition: apicp.h:153
@ APIC_DSH_AllIncludingSelf
Definition: apicp.h:156
@ APIC_DSH_Destination
Definition: apicp.h:154
@ APIC_DSH_Self
Definition: apicp.h:155
@ APIC_DSH_AllExcludingSelf
Definition: apicp.h:157
_APIC_RRS
Definition: apicp.h:169
@ APIC_RRS_Done
Definition: apicp.h:172
@ APIC_RRS_Invalid
Definition: apicp.h:170
@ APIC_RRS_Pending
Definition: apicp.h:171
enum _APIC_DF APIC_DF
_APIC_MT
Definition: apicp.h:126
@ APIC_MT_INIT
Definition: apicp.h:132
@ APIC_MT_LowestPriority
Definition: apicp.h:128
@ APIC_MT_Fixed
Definition: apicp.h:127
@ APIC_MT_NMI
Definition: apicp.h:131
@ APIC_MT_ExtInt
Definition: apicp.h:134
@ APIC_MT_SMI
Definition: apicp.h:129
@ APIC_MT_Startup
Definition: apicp.h:133
@ APIC_MT_RemoteRead
Definition: apicp.h:130
union _LVT_REGISTER LVT_REGISTER
union _APIC_EXTENDED_CONTROL_REGISTER APIC_EXTENDED_CONTROL_REGISTER
enum _APIC_MT APIC_MT
enum _APIC_REGISTER APIC_REGISTER
enum _APIC_RRS APIC_RRS
VOID NTAPI ApicInitializeTimer(ULONG Cpu)
Definition: apictimer.c:50
VOID __cdecl ApicSpuriousService(VOID)
union _APIC_INTERRUPT_COMMAND_REGISTER APIC_INTERRUPT_COMMAND_REGISTER
FORCEINLINE ULONG ApicRead(APIC_REGISTER Register)
Definition: apicp.h:318
enum _APIC_DM APIC_DM
union _APIC_BASE_ADDRESS_REGISTER APIC_BASE_ADDRESS_REGISTER
FORCEINLINE VOID ApicWrite(APIC_REGISTER Register, ULONG Value)
Definition: apicp.h:325
union _APIC_VERSION_REGISTER APIC_VERSION_REGISTER
_TIMER_DV
Definition: apicp.h:177
@ TIMER_DV_DivideBy128
Definition: apicp.h:184
@ TIMER_DV_DivideBy4
Definition: apicp.h:179
@ TIMER_DV_DivideBy8
Definition: apicp.h:180
@ TIMER_DV_DivideBy1
Definition: apicp.h:185
@ TIMER_DV_DivideBy2
Definition: apicp.h:178
@ TIMER_DV_DivideBy64
Definition: apicp.h:183
@ TIMER_DV_DivideBy16
Definition: apicp.h:181
@ TIMER_DV_DivideBy32
Definition: apicp.h:182
enum _APIC_TGM APIC_TGM
_APIC_REGISTER
Definition: apicp.h:81
@ APIC_LINT1
Definition: apicp.h:102
@ APIC_RRR
Definition: apicp.h:88
@ APIC_PPR
Definition: apicp.h:86
@ APIC_ICR0
Definition: apicp.h:96
@ APIC_EXT3LVTR
Definition: apicp.h:113
@ APIC_TICR
Definition: apicp.h:104
@ APIC_SEOI
Definition: apicp.h:109
@ APIC_TPR
Definition: apicp.h:84
@ APIC_EXT1LVTR
Definition: apicp.h:111
@ APIC_TCCR
Definition: apicp.h:105
@ APIC_VER
Definition: apicp.h:83
@ APIC_EACR
Definition: apicp.h:108
@ APIC_LDR
Definition: apicp.h:89
@ APIC_ESR
Definition: apicp.h:95
@ APIC_ERRLVTR
Definition: apicp.h:103
@ APIC_IRR
Definition: apicp.h:94
@ APIC_PCLVTR
Definition: apicp.h:100
@ APIC_ICR1
Definition: apicp.h:97
@ APIC_ISR
Definition: apicp.h:92
@ APIC_TDCR
Definition: apicp.h:106
@ APIC_EXT2LVTR
Definition: apicp.h:112
@ APIC_EAFR
Definition: apicp.h:107
@ APIC_THRMLVTR
Definition: apicp.h:99
@ APIC_TMRLVTR
Definition: apicp.h:98
@ APIC_EOI
Definition: apicp.h:87
@ APIC_ID
Definition: apicp.h:82
@ APIC_DFR
Definition: apicp.h:90
@ APIC_LINT0
Definition: apicp.h:101
@ APIC_TMR
Definition: apicp.h:93
@ APIC_SIVR
Definition: apicp.h:91
@ APIC_EXT0LVTR
Definition: apicp.h:110
@ APIC_APR
Definition: apicp.h:85
enum _TIMER_DV TIMER_DV
union _APIC_SPURIOUS_INERRUPT_REGISTER APIC_SPURIOUS_INERRUPT_REGISTER
VOID NTAPI HalpInitApicInfo(IN PLOADER_PARAMETER_BLOCK KeLoaderBlock)
enum _APIC_DSH APIC_DSH
_APIC_TGM
Definition: apicp.h:139
@ APIC_TGM_Level
Definition: apicp.h:141
@ APIC_TGM_Edge
Definition: apicp.h:140
union _IOAPIC_REDIRECTION_REGISTER IOAPIC_REDIRECTION_REGISTER
#define WRITE_REGISTER_ULONG(r, v)
Definition: arm.h:27
#define READ_REGISTER_ULONG(r)
Definition: arm.h:26
PLOADER_PARAMETER_BLOCK KeLoaderBlock
Definition: krnlinit.c:28
#define APIC_BASE
Definition: ketypes.h:345
uint32_t * PULONG
Definition: typedefs.h:59
#define NTAPI
Definition: typedefs.h:36
#define IN
Definition: typedefs.h:39
uint32_t ULONG
Definition: typedefs.h:59
UINT32 ExtRegSpacePresent
Definition: apicp.h:224
UINT32 RemoteIRR
Definition: apicp.h:274
UINT32 MessageType
Definition: apicp.h:270
UINT32 ReservedMBZ
Definition: apicp.h:271
UINT32 TimerMode
Definition: apicp.h:277
UINT32 Long
Definition: apicp.h:266
UINT32 Reserved1MBZ
Definition: apicp.h:273
UINT32 Vector
Definition: apicp.h:269
UINT32 Mask
Definition: apicp.h:276
UINT32 TriggerMode
Definition: apicp.h:275
UINT32 DeliveryStatus
Definition: apicp.h:272
UINT32 Reserved2MBZ
Definition: apicp.h:278
_Must_inspect_result_ _In_ WDFKEY _In_ PCUNICODE_STRING _Out_opt_ PUSHORT _Inout_opt_ PUNICODE_STRING Value
Definition: wdfregistry.h:413
#define FORCEINLINE
Definition: wdftypes.h:67