L4Re Operating System Framework
Interface and Usage Documentation
Loading...
Searching...
No Matches
irq
Go to the documentation of this file.
1// vi:set ft=cpp: -*- Mode: C++ -*-
6/*
7 * (c) 2008-2009 Adam Lackorzynski <adam@os.inf.tu-dresden.de>,
8 * Alexander Warg <warg@os.inf.tu-dresden.de>
9 * economic rights: Technische Universität Dresden (Germany)
10 *
11 * License: see LICENSE.spdx (in this directory or the directories above)
12 */
13
14#pragma once
15
16#include <l4/sys/icu.h>
17#include <l4/sys/irq.h>
18#include <l4/sys/capability>
19#include <l4/sys/rcv_endpoint>
20#include <l4/sys/cxx/ipc_iface>
21#include <l4/sys/cxx/ipc_types>
22
23namespace L4 {
24
37class Irq_eoi : public Kobject_0t<Irq_eoi, L4::PROTO_EMPTY>
38{
39public:
64 l4_msgtag_t unmask(unsigned irqnum, l4_umword_t *label = 0,
66 l4_utcb_t *utcb = l4_utcb()) noexcept
67 {
68 return l4_icu_control_u(cap(), irqnum, L4_ICU_CTL_UNMASK, label, to, utcb);
69 }
70};
71
79struct Triggerable : Kobject_t<Triggerable, Irq_eoi, L4_PROTO_IRQ>
80{
92 { return l4_irq_trigger_u(cap(), utcb); }
93};
94
120class Irq : public Kobject_2t<Irq, Triggerable, Rcv_endpoint, L4_PROTO_IRQ_SENDER>
121{
122public:
124
159 l4_utcb_t *utcb = l4_utcb()) noexcept
160 { return l4_irq_bind_vcpu_u(cap(), thread.cap(), cfg, utcb); }
161
177 { return l4_irq_detach_u(cap(), utcb); }
178
179
192 l4_utcb_t *utcb = l4_utcb()) noexcept
193 { return l4_irq_receive_u(cap(), timeout, utcb); }
194
205 l4_utcb_t *utcb = l4_utcb()) noexcept
206 { return unmask(-1, label, timeout, utcb); }
207
222 { return unmask(-1, 0, L4_IPC_NEVER, utcb); }
223};
224
250class Icu :
251 public Kobject_t<Icu, Irq_eoi, L4_PROTO_IRQ,
252 Type_info::Demand_t<1> >
253{
254public:
255 enum Mode
256 {
257 F_none = L4_IRQ_F_NONE,
258 F_level_high = L4_IRQ_F_LEVEL_HIGH,
259 F_level_low = L4_IRQ_F_LEVEL_LOW,
260 F_pos_edge = L4_IRQ_F_POS_EDGE,
261 F_neg_edge = L4_IRQ_F_NEG_EDGE,
262 F_both_edge = L4_IRQ_F_BOTH_EDGE,
263 F_mask = L4_IRQ_F_MASK,
264
265 F_set_wakeup = L4_IRQ_F_SET_WAKEUP,
266 F_clear_wakeup = L4_IRQ_F_CLEAR_WAKEUP,
267 };
268
269 enum Flags
270 {
271 F_msi = L4_ICU_FLAG_MSI
272 };
273
277 class Info : public l4_icu_info_t
278 {
279 public:
281 bool supports_msi() const noexcept { return features & F_msi; }
282 };
283
311 l4_utcb_t *utcb = l4_utcb()) noexcept
312 { return l4_icu_bind_u(cap(), irqnum, irq.cap(), utcb); }
313
317 );
318
329 l4_utcb_t *utcb = l4_utcb()) noexcept
330 { return l4_icu_unbind_u(cap(), irqnum, irq.cap(), utcb); }
331
335 );
336
346 { return l4_icu_info_u(cap(), info, utcb); }
347
348 struct _Info { l4_umword_t features, nr_irqs, nr_msis; };
350
366
370 l4_msgtag_t control(unsigned irqnum, unsigned op, l4_umword_t *label,
371 l4_timeout_t to, l4_utcb_t *utcb = l4_utcb()) noexcept
372 { return l4_icu_control_u(cap(), irqnum, op, label, to, utcb); }
373
393 l4_msgtag_t mask(unsigned irqnum,
394 l4_umword_t *label = 0,
396 l4_utcb_t *utcb = l4_utcb()) noexcept
397 { return l4_icu_mask_u(cap(), irqnum, label, to, utcb); }
398
401 l4_msgtag_t, mask, (l4_umword_t irqnum),
403 );
404
405
408 l4_msgtag_t, unmask, (l4_umword_t irqnum),
410 );
411
421 l4_msgtag_t set_mode(unsigned irqnum, l4_umword_t mode,
422 l4_utcb_t *utcb = l4_utcb()) noexcept
423 { return l4_icu_set_mode_u(cap(), irqnum, mode, utcb); }
424
428 );
429
430 typedef L4::Typeid::Rpcs_sys<
431 bind_t, unbind_t, info_t, msi_info_t, unmask_t, mask_t, set_mode_t
432 > Rpcs;
433};
434
435}
L4::Cap related definitions.
l4_cap_idx_t cap() const noexcept
Return capability selector.
Definition capability.h:49
C++ interface for capabilities.
Definition capability.h:224
This class encapsulates information about an ICU.
Definition irq:278
bool supports_msi() const noexcept
True, if the ICU has support for MSIs.
Definition irq:281
C++ Icu interface, see Interrupt controller for the C interface.
Definition irq:253
l4_msgtag_t msi_info(l4_umword_t irqnum, l4_uint64_t source, l4_icu_msi_info_t *msi_info)
Get MSI info about IRQ.
l4_msgtag_t info(l4_icu_info_t *info, l4_utcb_t *utcb=l4_utcb()) noexcept
Get information about the ICU features.
Definition irq:345
l4_msgtag_t set_mode(unsigned irqnum, l4_umword_t mode, l4_utcb_t *utcb=l4_utcb()) noexcept
Set interrupt mode.
Definition irq:421
l4_msgtag_t unbind(unsigned irqnum, L4::Cap< Triggerable > irq, l4_utcb_t *utcb=l4_utcb()) noexcept
Remove binding of an interrupt line from the interrupt controller object.
Definition irq:328
l4_msgtag_t mask(unsigned irqnum, l4_umword_t *label=0, l4_timeout_t to=L4_IPC_NEVER, l4_utcb_t *utcb=l4_utcb()) noexcept
Mask an IRQ line.
Definition irq:393
l4_msgtag_t bind(unsigned irqnum, L4::Cap< Triggerable > irq, l4_utcb_t *utcb=l4_utcb()) noexcept
Bind an interrupt line of an interrupt controller to an interrupt object.
Definition irq:310
Capability type for RPC interfaces (see L4::Cap<T>).
Definition ipc_types:699
Interface for sending an unmask message to an object.
Definition irq:38
l4_msgtag_t unmask(unsigned irqnum, l4_umword_t *label=0, l4_timeout_t to=L4_IPC_NEVER, l4_utcb_t *utcb=l4_utcb()) noexcept
Unmask the given interrupt line.
Definition irq:64
C++ Irq interface, see IRQs for the C interface.
Definition irq:121
l4_msgtag_t detach(l4_utcb_t *utcb=l4_utcb()) noexcept
Detach from this interrupt.
Definition irq:176
l4_msgtag_t wait(l4_umword_t *label, l4_timeout_t timeout=L4_IPC_NEVER, l4_utcb_t *utcb=l4_utcb()) noexcept
Unmask IRQ and (open) wait for any message.
Definition irq:204
l4_msgtag_t unmask(l4_utcb_t *utcb=l4_utcb()) noexcept
Unmask this IRQ.
Definition irq:221
l4_msgtag_t receive(l4_timeout_t timeout=L4_IPC_NEVER, l4_utcb_t *utcb=l4_utcb()) noexcept
Unmask and wait for this IRQ.
Definition irq:191
l4_msgtag_t bind_vcpu(L4::Cap< Thread > const &thread, l4_umword_t cfg, l4_utcb_t *utcb=l4_utcb()) noexcept
Bind a thread to this Irq for vCPU interrupt forwarding.
Definition irq:158
Helper class to create an L4Re interface class that is derived from two base classes (see L4::Kobject...
Definition __typeinfo.h:828
Helper class to create an L4Re interface class that is derived from a single base class.
Definition __typeinfo.h:750
l4_cap_idx_t cap() const noexcept
Return capability selector.
Definition kobject:69
unsigned long l4_umword_t
Unsigned machine word.
Definition l4int.h:40
unsigned long long l4_uint64_t
Unsigned 64bit value.
Definition l4int.h:31
l4_msgtag_t l4_icu_bind_u(l4_cap_idx_t icu, unsigned irqnum, l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW
Bind an interrupt line of an interrupt controller to an interrupt object.
Definition icu.h:396
l4_msgtag_t l4_icu_info_u(l4_cap_idx_t icu, l4_icu_info_t *info, l4_utcb_t *utcb) L4_NOTHROW
Get information about the ICU features.
Definition icu.h:420
l4_msgtag_t l4_icu_set_mode_u(l4_cap_idx_t icu, unsigned irqnum, l4_umword_t mode, l4_utcb_t *utcb) L4_NOTHROW
Set interrupt mode.
Definition icu.h:457
l4_msgtag_t l4_icu_mask_u(l4_cap_idx_t icu, unsigned irqnum, l4_umword_t *label, l4_timeout_t to, l4_utcb_t *utcb) L4_NOTHROW
Mask an IRQ line.
Definition icu.h:483
l4_msgtag_t l4_icu_unbind_u(l4_cap_idx_t icu, unsigned irqnum, l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW
Remove binding of an interrupt line from the interrupt controller object.
Definition icu.h:408
@ L4_ICU_FLAG_MSI
Flag to denote that the IRQ is actually an MSI.
Definition icu.h:62
l4_msgtag_t l4_irq_trigger_u(l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW
Trigger the object.
Definition irq.h:263
l4_msgtag_t l4_irq_bind_vcpu_u(l4_cap_idx_t irq, l4_cap_idx_t thread, l4_umword_t cfg, l4_utcb_t *utcb) L4_NOTHROW
Bind a thread to this Irq for vCPU interrupt forwarding.
Definition irq.h:250
l4_msgtag_t l4_irq_receive_u(l4_cap_idx_t irq, l4_timeout_t timeout, l4_utcb_t *utcb) L4_NOTHROW
Unmask and wait for this IRQ.
Definition irq.h:270
l4_msgtag_t l4_irq_detach_u(l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW
Detach from this interrupt.
Definition irq.h:242
@ L4_IRQ_F_MASK
Mask.
Definition icu.h:85
@ L4_IRQ_F_NEG_EDGE
Negative edge trigger.
Definition icu.h:83
@ L4_IRQ_F_CLEAR_WAKEUP
Do not use irq as wakeup source.
Definition icu.h:89
@ L4_IRQ_F_SET_WAKEUP
Wakeup source?
Definition icu.h:88
@ L4_IRQ_F_LEVEL_HIGH
Level high trigger.
Definition icu.h:80
@ L4_IRQ_F_BOTH_EDGE
Both edges trigger.
Definition icu.h:84
@ L4_IRQ_F_POS_EDGE
Positive edge trigger.
Definition icu.h:82
@ L4_IRQ_F_NONE
Flow types.
Definition icu.h:73
@ L4_IRQ_F_LEVEL_LOW
Level low trigger.
Definition icu.h:81
@ L4_ICU_OP_MASK
Mask opcode.
Definition icu.h:139
@ L4_ICU_OP_SET_MODE
Set-mode opcode.
Definition icu.h:146
@ L4_ICU_OP_UNMASK
Unmask opcode.
Definition icu.h:132
@ L4_ICU_OP_INFO
Info opcode.
Definition icu.h:118
@ L4_ICU_OP_MSI_INFO
Msi-info opcode.
Definition icu.h:125
@ L4_ICU_OP_UNBIND
Unbind opcode.
Definition icu.h:111
@ L4_ICU_OP_BIND
Bind opcode.
Definition icu.h:104
#define L4_IPC_NEVER
never timeout
Definition __timeout.h:76
struct l4_utcb_t l4_utcb_t
Opaque type for the UTCB.
Definition utcb.h:56
l4_utcb_t * l4_utcb(void) L4_NOTHROW L4_PURE
Get the UTCB address.
Definition utcb.h:346
Interrupt controller.
Interface Definition Language.
#define L4_RPC_NF_OP(op, res, name, args...)
Define an RPC call type with specific opcode (the type only, no callable).
Definition ipc_iface:525
#define L4_INLINE_RPC_OP(op, res, name, args, attr...)
Define an inline RPC call with specific opcode (type and callable).
Definition ipc_iface:497
C Irq interface.
L4 low-level kernel interface.
The C++ Receive endpoint interface.
RPC attribute for a send-only RPC.
Definition ipc_iface:288
Interface that allows an object to be triggered by some source.
Definition irq:80
l4_msgtag_t trigger(l4_utcb_t *utcb=l4_utcb()) noexcept
Trigger the object.
Definition irq:91
List of RPCs typically used for kernel interfaces.
Definition __typeinfo.h:465
Info structure for an ICU.
Definition icu.h:164
unsigned features
Feature flags.
Definition icu.h:170
Info to use for a specific MSI.
Definition icu.h:185
Message tag data structure.
Definition types.h:154
Timeout pair.
Definition __timeout.h:53