IgrOS-Kernel 0.1.34.545
Simple C++20 Kernel for i386/x86_64
Loading...
Searching...
No Matches
irq.hpp
Go to the documentation of this file.
1
11
12
13#pragma once
14
15
16// IgrOS-Kernel arch
17#include <arch/types.hpp>
18// IgrOS-Kernel arch x86
19#include <arch/x86/io.hpp>
20#include <arch/x86/isr.hpp>
21
22
23#ifdef __cplusplus
24
25extern "C" {
26
27#endif // __cplusplus
28
29
31 extern const std::add_pointer_t<void() noexcept> irqHandlerTable[16];
32
35 [[nodiscard]]
36 auto irqSave() noexcept -> igros::igros_usize_t;
39 void irqRestore(const igros::igros_usize_t flags) noexcept;
40
41
42#ifdef __cplusplus
43
44} // extern "C"
45
46#endif // __cplusplus
47
48
49// x86 namespace
50namespace igros::x86 {
51
52
53 // Master PIC ports
54 constexpr auto PIC_MASTER_CONTROL {static_cast<port_t>(0x0020_u16)};
55 constexpr auto PIC_MASTER_DATA {static_cast<port_t>(PIC_MASTER_CONTROL + 1_u16)};
56 // Slave PIC ports
57 constexpr auto PIC_SLAVE_CONTROL {static_cast<port_t>(0x00A0_u16)};
58 constexpr auto PIC_SLAVE_DATA {static_cast<port_t>(PIC_SLAVE_CONTROL + 1_u16)};
59
60
62 enum class irq_t : igros_dword_t {
63 PIT = 0_u32,
64 KEYBOARD = 1_u32,
65 CASCADE = 2_u32,
66 UART2 = 3_u32,
67 UART1 = 4_u32,
68 LPT2 = 5_u32,
69 FLOPPY = 6_u32,
70 LPT1 = 7_u32,
71 RTC = 8_u32,
72 ACPI = 9_u32,
73 FREE_10 = 10_u32,
74 FREE_11 = 11_u32,
75 MOUSE = 12_u32,
76 FPU = 13_u32,
77 ATA_PRIMARY = 14_u32,
78 ATA_SECONDARY = 15_u32,
79 };
80
82 constexpr auto IRQ_LINES {16_usize};
83
84
88 [[nodiscard]]
89 constexpr auto irqVector(const irq_t line) noexcept -> igros_usize_t {
90 return IRQ_OFFSET + static_cast<igros_usize_t>(line);
91 }
92
96 [[nodiscard]]
97 constexpr auto isIrqVector(const igros_usize_t vector) noexcept -> bool {
98 return (vector >= IRQ_OFFSET) && (vector < (IRQ_OFFSET + IRQ_LINES));
99 }
100
104 [[nodiscard]]
105 constexpr auto irqFromVector(const igros_usize_t vector) noexcept -> irq_t {
106 return static_cast<irq_t>(vector - IRQ_OFFSET);
107 }
108
109
111 class irq final {
112
113 public:
114
116 irq() noexcept = default;
118 ~irq() noexcept = default;
119
121 irq(const irq &other) = delete;
123 auto operator=(const irq &other) -> irq & = delete;
125 irq(irq &&other) = delete;
127 auto operator=(irq &&other) -> irq & = delete;
128
130 static void init() noexcept;
131
133 static void enable() noexcept;
135 static void disable() noexcept;
136
139 static void mask(const irq_t number) noexcept;
142 static void unmask(const irq_t number) noexcept;
143
146 static void setMask(const igros_word_t mask = 0xFFFF_u16) noexcept;
149 [[nodiscard]]
150 static auto getMask() noexcept -> igros_word_t;
151
153 template<irq_t N, isr_t HANDLE>
154 static void install() noexcept;
156 template<irq_t N>
157 static void uninstall() noexcept;
158
161 static void eoi(const irq_t number) noexcept;
162
166 [[nodiscard]]
167 static auto isSpurious(const irq_t number) noexcept -> bool;
168
170 class guard;
171 };
172
173
175 class [[nodiscard("Unnamed guard re-enables IRQs immediately")]] irq::guard final {
176
179
180
181 public:
182
184 guard() noexcept = default;
186 ~guard() noexcept {
188 }
189
191 guard(const guard &other) = delete;
193 auto operator=(const guard &other) -> guard & = delete;
194 };
195
196
198 template<irq_t N, isr_t HANDLE>
199 inline void irq::install() noexcept {
200 // Install ISR
201 isrHandlerInstall(irqVector(N), HANDLE);
202 }
203
205 template<irq_t N>
206 inline void irq::uninstall() noexcept {
207 // Uninstall ISR
209 }
210
211
212} // namespace igros::x86
213
guard() noexcept=default
Save flags and disable interrupts.
irq() noexcept=default
Default c-tor.
Disable interrupts in scope (restores previous state on exit).
Definition irq.hpp:175
guard(const guard &other)=delete
Copy c-tor.
auto operator=(const guard &other) -> guard &=delete
Copy assignment.
guard() noexcept=default
Save flags and disable interrupts.
igros_usize_t mFlags
Saved flags (interrupts are disabled while saving).
Definition irq.hpp:178
static void uninstall() noexcept
Uninstall IRQ handler.
Definition irq.hpp:206
static void disable() noexcept
Disable interrupts.
Definition irq.cpp:70
static auto getMask() noexcept -> igros_word_t
Get interrupts mask.
Definition irq.cpp:106
static void mask(const irq_t number) noexcept
Mask interrupt.
Definition irq.cpp:76
static void setMask(const igros_word_t mask=0xFFFF_u16) noexcept
Set interrupts mask.
Definition irq.cpp:95
static void enable() noexcept
Enable interrupts.
Definition irq.cpp:65
static void init() noexcept
Init IRQ.
Definition irq.cpp:46
static void install() noexcept
Install IRQ handler.
Definition irq.hpp:199
static void unmask(const irq_t number) noexcept
Unmask interrupt.
Definition irq.cpp:85
static void eoi(const irq_t number) noexcept
Send EOI (IRQ done).
Definition irq.cpp:117
static auto isSpurious(const irq_t number) noexcept -> bool
Check if IRQ is spurious (only lines 7 and 15 can be).
Definition irq.cpp:130
irq() noexcept=default
Default c-tor.
std::uint16_t igros_word_t
16-bit unsigned integer
Definition types.hpp:42
std::size_t igros_usize_t
Unsigned size.
Definition types.hpp:51
std::uint32_t igros_dword_t
32-bit unsigned integer
Definition types.hpp:43
Interrupts low-level operations.
Code shared by i386 and x86_64: ports, interrupts, exceptions, paging.
constexpr auto PIC_MASTER_DATA
Master PIC data (mask) port.
Definition irq.hpp:55
void isrHandlerInstall(const igros_usize_t number, const isr_t handle) noexcept
Install interrupt service routine handler.
Definition isr.cpp:31
void isrHandlerUninstall(const igros_usize_t number) noexcept
Uninstall interrupt service routine handler.
Definition isr.cpp:37
constexpr auto IRQ_LINES
Number of PIC interrupt lines.
Definition irq.hpp:82
constexpr auto PIC_SLAVE_DATA
Slave PIC data (mask) port.
Definition irq.hpp:58
igros_word_t port_t
Define port data type which is 16bit word.
Definition io.hpp:25
constexpr auto irqFromVector(const igros_usize_t vector) noexcept -> irq_t
IRQ line of interrupt vector (vector must be IRQ vector).
Definition irq.hpp:105
constexpr auto PIC_MASTER_CONTROL
Master PIC command port.
Definition irq.hpp:54
constexpr auto isIrqVector(const igros_usize_t vector) noexcept -> bool
Check if interrupt vector belongs to IRQ line.
Definition irq.hpp:97
std::add_pointer_t< void(const register_t *const)> isr_t
Interrupt service routine handler type.
Definition isr.hpp:35
constexpr auto PIC_SLAVE_CONTROL
Slave PIC command port.
Definition irq.hpp:57
irq_t
Interrupts number enumeration (PIC lines).
Definition irq.hpp:62
@ LPT1
Master PIC spurious.
Definition irq.hpp:70
@ ATA_SECONDARY
Slave PIC spurious.
Definition irq.hpp:78
@ CASCADE
Slave PIC.
Definition irq.hpp:65
constexpr auto irqVector(const irq_t line) noexcept -> igros_usize_t
Interrupt vector of IRQ line.
Definition irq.hpp:89
constexpr auto IRQ_OFFSET
IRQ offset in ISR list.
Definition isr.hpp:30
IgrOS kernel: common types and literals.
Common C++ types redefinition.
IO low-level port operations.
auto irqSave() noexcept -> igros::igros_usize_t
Save flags and disable interrupts.
const std::add_pointer_t< void() noexcept > irqHandlerTable[16]
IRQ handlers addresses, indexed by IRQ line (irq.s).
void irqRestore(const igros::igros_usize_t flags) noexcept
Restore flags (interrupts state).