Interrupt Class Reference

AArch64 中断控制器实现 More...

#include <interrupt.h>

Inheritance diagram for Interrupt:

Collaboration diagram for Interrupt:

Public Member Functions
auto	Do (uint64_t cause, cpu_io::TrapContext *context) -> void override
	执行中断处理
auto	RegisterInterruptFunc (uint64_t cause, InterruptDelegate func) -> void override
	注册中断处理函数
auto	SendIpi (uint64_t target_cpu_mask) -> Expected< void > override
	发送 IPI 到指定 CPU
auto	BroadcastIpi () -> Expected< void > override
	广播 IPI 到所有 CPU
auto	RegisterExternalInterrupt (uint32_t irq, uint32_t cpu_id, uint32_t priority, InterruptDelegate handler) -> Expected< void > override
	注册外部中断
__always_inline auto	SetUp () const -> void
	设置 GIC
__always_inline auto	Spi (uint32_t intid, uint32_t cpuid) const -> void
	设置 SPI 中断
__always_inline auto	Ppi (uint32_t intid, uint32_t cpuid) const -> void
	设置 PPI 中断
__always_inline auto	Sgi (uint32_t intid, uint32_t cpuid) const -> void
	设置 SGI 中断
auto	Do (uint64_t cause, cpu_io::TrapContext *context) -> void override
	执行中断处理
auto	RegisterInterruptFunc (uint64_t cause, InterruptDelegate func) -> void override
	注册中断处理函数
auto	SendIpi (uint64_t target_cpu_mask) -> Expected< void > override
	发送 IPI 到指定核心
auto	BroadcastIpi () -> Expected< void > override
	广播 IPI 到所有其他核心
auto	RegisterExternalInterrupt (uint32_t irq, uint32_t cpu_id, uint32_t priority, InterruptDelegate handler) -> Expected< void > override
	注册外部中断处理函数
auto	Do (uint64_t cause, cpu_io::TrapContext *context) -> void override
	执行中断处理
auto	RegisterInterruptFunc (uint64_t cause, InterruptDelegate func) -> void override
	注册中断处理函数
auto	SendIpi (uint64_t target_cpu_mask) -> Expected< void > override
	发送 IPI 到指定核心
auto	BroadcastIpi () -> Expected< void > override
	广播 IPI 到所有其他核心
auto	RegisterExternalInterrupt (uint32_t irq, uint32_t cpu_id, uint32_t priority, InterruptDelegate handler) -> Expected< void > override
	注册外部中断处理函数
auto	InitApic (size_t cpu_count) -> void
	初始化 APIC
auto	SetUpIdtr () -> void
	初始化 idtr
构造/析构函数
	Interrupt ()
	Interrupt (const Interrupt &)=delete
	Interrupt (Interrupt &&)=delete
auto	operator= (const Interrupt &) -> Interrupt &=delete
auto	operator= (Interrupt &&) -> Interrupt &=delete
	~Interrupt ()=default
	Interrupt ()
	Interrupt (const Interrupt &)=delete
	Interrupt (Interrupt &&)=delete
auto	operator= (const Interrupt &) -> Interrupt &=delete
auto	operator= (Interrupt &&) -> Interrupt &=delete
	~Interrupt ()=default
	Interrupt ()
	Interrupt (const Interrupt &)=delete
	Interrupt (Interrupt &&)=delete
auto	operator= (const Interrupt &) -> Interrupt &=delete
auto	operator= (Interrupt &&) -> Interrupt &=delete
	~Interrupt () override=default
PLIC 访问接口
__always_inline auto	plic () -> Plic &
	获取 PLIC 引用
__always_inline auto	plic () const -> const Plic &
	获取 PLIC 的只读引用
auto	InitPlic (uint64_t dev_addr, size_t ndev, size_t context_count) -> void
	初始化 PLIC
APIC 访问接口
__always_inline auto	apic () -> Apic &
__always_inline auto	apic () const -> const Apic &
Public Member Functions inherited from InterruptBase
	InterruptBase ()=default
	InterruptBase (const InterruptBase &)=delete
	InterruptBase (InterruptBase &&)=delete
auto	operator= (const InterruptBase &) -> InterruptBase &=delete
auto	operator= (InterruptBase &&) -> InterruptBase &=delete
virtual	~InterruptBase ()=default

Static Public Attributes
static constexpr size_t	kMaxInterrupt = 128
	最大中断号
static constexpr uint8_t	kExternalVectorBase = 0x20
	外部中断向量基址（IO APIC IRQ 到 IDT 向量的映射）

Private Member Functions
template<uint8_t no = 0>
auto	SetUpIdtr () -> void
	初始化 idtr

Private Attributes
std::array< InterruptDelegate, kMaxInterrupt >	interrupt_handlers_ {}
	中断处理函数数组
Gic	gic_ {}
	GIC 中断控制器实例
std::array< InterruptDelegate, cpu_io::ScauseInfo::kInterruptMaxCount >	interrupt_handlers_ {}
	中断处理函数数组
std::array< InterruptDelegate, cpu_io::ScauseInfo::kExceptionMaxCount >	exception_handlers_ {}
	异常处理函数数组
Plic	plic_ {}
std::array< InterruptDelegate, cpu_io::IdtrInfo::kInterruptMaxCount >	interrupt_handlers_ {}
	中断处理函数数组
std::array< cpu_io::IdtrInfo::Idt, cpu_io::IdtrInfo::kInterruptMaxCount >	idts_ {}
Apic	apic_ {}
	APIC 中断控制器实例

Additional Inherited Members
Public Types inherited from InterruptBase
using	InterruptDelegate = etl::delegate< uint64_t(uint64_t, cpu_io::TrapContext *)>
	类型安全的中断处理委托

Detailed Description

AArch64 中断控制器实现

Copyright

Copyright The SimpleKernel Contributors

Definition at line 19 of file interrupt.h.

Constructor & Destructor Documentation

Interrupt() [1/9]

Interrupt::Interrupt

(

)

Definition at line 27 of file interrupt.cpp.

                     {
  auto [dist_base_addr, dist_size, redist_base_addr, redist_size] =
      KernelFdtSingleton::instance().GetGIC().value();
  VirtualMemorySingleton::instance()
      .MapMMIO(dist_base_addr, dist_size)
      .or_else([](Error err) -> Expected<void*> {
        klog::Err("Failed to map GIC distributor MMIO: {}", err.message());
        while (true) {
          cpu_io::Pause();
        }
        return std::unexpected(err);
      });
  VirtualMemorySingleton::instance()
      .MapMMIO(redist_base_addr, redist_size)
      .or_else([](Error err) -> Expected<void*> {
        klog::Err("Failed to map GIC redistributor MMIO: {}", err.message());
        while (true) {
          cpu_io::Pause();
        }
        return std::unexpected(err);
      });
 
  gic_ = std::move(Gic(dist_base_addr, redist_base_addr));
 
  // 注册默认中断处理函数
  for (auto& i : interrupt_handlers_) {
    i = InterruptDelegate::create<DefaultInterruptHandler>();
  }
 
  // 设置 SGI 0 用于 IPI
  auto cpuid = cpu_io::GetCurrentCoreId();
  gic_.Sgi(0, cpuid);
 
  klog::Info("Interrupt init.");
}

Here is the call graph for this function:

Interrupt() [2/9]

Interrupt::Interrupt ( const Interrupt &  )

delete

Interrupt() [3/9]

Interrupt::Interrupt ( Interrupt &&  )

delete

~Interrupt() [1/3]

Interrupt::~Interrupt ( )

default

Interrupt() [4/9]

Interrupt::Interrupt

(

)

Interrupt() [5/9]

Interrupt::Interrupt ( const Interrupt &  )

delete

Interrupt() [6/9]

Interrupt::Interrupt ( Interrupt &&  )

delete

~Interrupt() [2/3]

Interrupt::~Interrupt ( )

default

Interrupt() [7/9]

Interrupt::Interrupt

(

)

Interrupt() [8/9]

Interrupt::Interrupt ( const Interrupt &  )

delete

Interrupt() [9/9]

Interrupt::Interrupt ( Interrupt &&  )

delete

~Interrupt() [3/3]

Interrupt::~Interrupt ( )

overridedefault

Member Function Documentation

apic() [1/2]

__always_inline auto Interrupt::apic ( ) -> Apic&

inline

Definition at line 39 of file interrupt.h.

{ return apic_; }

apic() [2/2]

__always_inline auto Interrupt::apic ( ) const -> const Apic&

inline

Definition at line 40 of file interrupt.h.

                                                                 {
    return apic_;
  }

BroadcastIpi() [1/3]

auto Interrupt::BroadcastIpi ( ) -> Expected<void>

overridevirtual

广播 IPI 到所有 CPU

Returns

Expected<void> 成功或失败

Todo:

默认使用 SGI 0 作为 IPI 中断

Implements InterruptBase.

Definition at line 93 of file interrupt.cpp.

                                               {
  static constexpr uint64_t kIPISGI = 0;
 
  // 构造 ICC_SGI1R_EL1 寄存器的值
  uint64_t sgi_value = 0;
 
  // 设置 INTID 为 0 (SGI 0)
  sgi_value |= (kIPISGI & 0xF) << 24;
 
  // 设置 IRM (Interrupt Routing Mode) 为 1，表示广播到所有 PE
  sgi_value |= (1ULL << 40);
 
  // 写入 ICC_SGI1R_EL1 寄存器发送 SGI
  cpu_io::ICC_SGI1R_EL1::Write(sgi_value);
 
  return {};
}

BroadcastIpi() [2/3]

auto Interrupt::BroadcastIpi ( ) -> Expected< void >

overridevirtual

广播 IPI 到所有其他核心

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

BroadcastIpi() [3/3]

auto Interrupt::BroadcastIpi ( ) -> Expected< void >

overridevirtual

广播 IPI 到所有其他核心

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

Do() [1/3]

auto Interrupt::Do ( uint64_t  cause, cpu_io::TrapContext *  context  ) -> void

overridevirtual

执行中断处理

Parameters

cause	中断号
context	中断上下文

Implements InterruptBase.

Definition at line 63 of file interrupt.cpp.

                                                                     {
  interrupt_handlers_[cause](cause, context);
  cpu_io::ICC_EOIR1_EL1::Write(cause);
}

Do() [2/3]

auto Interrupt::Do ( uint64_t  cause, cpu_io::TrapContext *  context  ) -> void

overridevirtual

执行中断处理

Parameters

cause	中断原因值（scause 寄存器内容）
context	中断上下文

Implements InterruptBase.

Do() [3/3]

auto Interrupt::Do ( uint64_t  , cpu_io::TrapContext *    ) -> void

overridevirtual

执行中断处理

Parameters

不同平台有不同含义

Implements InterruptBase.

InitApic()

auto Interrupt::InitApic

(

size_t

cpu_count

)

-> void

初始化 APIC

Parameters

cpu_count

CPU 核心数

Definition at line 128 of file interrupt.cpp.

{ apic_ = Apic(cpu_count); }

InitPlic()

auto Interrupt::InitPlic	(	uint64_t	dev_addr,
		size_t	ndev,
		size_t	context_count
	)		-> void

初始化 PLIC

Parameters

dev_addr	PLIC 设备地址
ndev	支持的中断源数量
context_count	上下文数量

Definition at line 135 of file interrupt.cpp.

            {
  plic_ = Plic(dev_addr, ndev, context_count);
}

operator=() [1/6]

auto Interrupt::operator= ( const Interrupt &  ) -> Interrupt &=delete

delete

operator=() [2/6]

auto Interrupt::operator= ( const Interrupt &  ) -> Interrupt &=delete

delete

operator=() [3/6]

auto Interrupt::operator= ( const Interrupt &  ) -> Interrupt &=delete

delete

operator=() [4/6]

auto Interrupt::operator= ( Interrupt &&  ) -> Interrupt &=delete

delete

operator=() [5/6]

auto Interrupt::operator= ( Interrupt &&  ) -> Interrupt &=delete

delete

operator=() [6/6]

auto Interrupt::operator= ( Interrupt &&  ) -> Interrupt &=delete

delete

plic() [1/2]

__always_inline auto Interrupt::plic ( ) -> Plic&

inline

获取 PLIC 引用

Returns

Plic& PLIC 实例引用

Definition at line 63 of file interrupt.h.

{ return plic_; }

plic() [2/2]

__always_inline auto Interrupt::plic ( ) const -> const Plic&

inline

获取 PLIC 的只读引用

Returns

const Plic& PLIC 实例常量引用

Definition at line 68 of file interrupt.h.

                                                                 {
    return plic_;
  }

Ppi()

__always_inline auto Interrupt::Ppi ( uint32_t  intid, uint32_t  cpuid  ) const -> void

inline

设置 PPI 中断

Parameters

intid	中断号
cpuid	CPU 编号

Definition at line 85 of file interrupt.h.

                                                                         {
    gic_.Ppi(intid, cpuid);
  }

Here is the call graph for this function:

RegisterExternalInterrupt() [1/3]

auto Interrupt::RegisterExternalInterrupt ( uint32_t  irq, uint32_t  cpu_id, uint32_t  priority, InterruptDelegate  handler  ) -> Expected<void>

overridevirtual

注册外部中断

Parameters

irq	GIC INTID（已含 kSpiBase 偏移）
cpu_id	CPU 编号
priority	中断优先级
handler	中断处理委托

Returns

Expected<void> 成功或失败

Implements InterruptBase.

Definition at line 112 of file interrupt.cpp.

                      {
  // irq 为 GIC INTID（已含 kSpiBase 偏移）
  if (irq >= kMaxInterrupt) {
    return std::unexpected(Error(ErrorCode::kIrqChipInvalidIrq));
  }
 
  // 先注册处理函数
  RegisterInterruptFunc(irq, handler);
 
  // 再在 GIC 上为指定核心配置并启用 SPI
  gic_.Spi(irq, cpu_id);
 
  klog::Info("RegisterExternalInterrupt: INTID {}, cpu {}, priority {}", irq,
             cpu_id, priority);
  return {};
}

Here is the call graph for this function:

RegisterExternalInterrupt() [2/3]

auto Interrupt::RegisterExternalInterrupt ( uint32_t  irq, uint32_t  cpu_id, uint32_t  priority, InterruptDelegate  handler  ) -> Expected< void >

overridevirtual

注册外部中断处理函数

Parameters

irq	外部中断号（PLIC source_id）
cpu_id	目标 CPU 核心 ID
priority	中断优先级
handler	中断处理委托

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

RegisterExternalInterrupt() [3/3]

auto Interrupt::RegisterExternalInterrupt ( uint32_t  irq, uint32_t  cpu_id, uint32_t  priority, InterruptDelegate  handler  ) -> Expected< void >

overridevirtual

注册外部中断处理函数

Parameters

irq	外部中断号（平台相关: PLIC source_id / GIC INTID / APIC IRQ）
cpu_id	目标 CPU 核心 ID，中断将路由到该核心
priority	中断优先级
handler	中断处理函数

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

RegisterInterruptFunc() [1/3]

auto Interrupt::RegisterInterruptFunc ( uint64_t  cause, InterruptDelegate  func  ) -> void

overridevirtual

注册中断处理函数

Parameters

cause	中断号
func	中断处理委托

Implements InterruptBase.

Definition at line 68 of file interrupt.cpp.

            {
  if (func) {
    interrupt_handlers_[cause] = func;
  }
}

RegisterInterruptFunc() [2/3]

auto Interrupt::RegisterInterruptFunc ( uint64_t  cause, InterruptDelegate  func  ) -> void

overridevirtual

注册中断处理函数

Parameters

cause	中断原因值（scause 格式）
func	中断处理委托

Implements InterruptBase.

RegisterInterruptFunc() [3/3]

auto Interrupt::RegisterInterruptFunc ( uint64_t  cause, InterruptDelegate  func  ) -> void

overridevirtual

注册中断处理函数

Parameters

cause	中断号，不同平台有不同含义
func	处理函数

Implements InterruptBase.

SendIpi() [1/3]

auto Interrupt::SendIpi ( uint64_t  target_cpu_mask ) -> Expected<void>

overridevirtual

发送 IPI 到指定 CPU

Parameters

target_cpu_mask

目标 CPU 位掩码

Returns

Expected<void> 成功或失败

Todo:

默认使用 SGI 0 作为 IPI 中断

Implements InterruptBase.

Definition at line 75 of file interrupt.cpp.

                                                                  {
  static constexpr uint64_t kIPISGI = 0;
 
  uint64_t sgi_value = 0;
 
  // 设置 INTID 为 0 (SGI 0)
  sgi_value |= (kIPISGI & 0xF) << 24;
 
  // 设置 TargetList (Aff0 级别，低 16 位)
  sgi_value |= (target_cpu_mask & 0xFFFF);
 
  // 写入 ICC_SGI1R_EL1 寄存器发送 SGI
  cpu_io::ICC_SGI1R_EL1::Write(sgi_value);
 
  return {};
}

SendIpi() [2/3]

auto Interrupt::SendIpi ( uint64_t  target_cpu_mask ) -> Expected< void >

overridevirtual

发送 IPI 到指定核心

Parameters

target_cpu_mask

目标核心的位掩码

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

SendIpi() [3/3]

auto Interrupt::SendIpi ( uint64_t  target_cpu_mask ) -> Expected< void >

overridevirtual

发送 IPI 到指定核心

Parameters

target_cpu_mask

目标核心的位掩码

Returns

Expected<void> 成功时返回 void，失败时返回错误

Implements InterruptBase.

SetUp()

__always_inline auto Interrupt::SetUp ( ) const -> void

inline

设置 GIC

Definition at line 69 of file interrupt.h.

{ gic_.SetUp(); }

Here is the call graph for this function:

SetUpIdtr() [1/2]

auto Interrupt::SetUpIdtr

(

)

-> void

初始化 idtr

Definition at line 62 of file interrupt.cpp.

{ SetUpIdtr<0>(); }

SetUpIdtr() [2/2]

template<uint8_t no>

auto Interrupt::SetUpIdtr ( ) -> void

private

初始化 idtr

Note

注意模板展开时的栈溢出

Definition at line 65 of file interrupt.cpp.

                                  {
  if constexpr (no < cpu_io::IdtrInfo::kInterruptMaxCount - 1) {
    idts_[no] = cpu_io::IdtrInfo::Idt(
        reinterpret_cast<uint64_t>(TarpEntry<no>), 8, 0x0,
        cpu_io::IdtrInfo::Idt::Type::k64BitInterruptGate,
        cpu_io::IdtrInfo::Idt::DPL::kRing0, cpu_io::IdtrInfo::Idt::P::kPresent);
    SetUpIdtr<no + 1>();
  } else {
    // 写入 idtr
    static auto idtr = cpu_io::IdtrInfo::Idtr{
        .limit = sizeof(cpu_io::IdtrInfo::Idt) *
                     cpu_io::IdtrInfo::kInterruptMaxCount -
                 1,
        .base = idts_.data(),
    };
    cpu_io::Idtr::Write(idtr);
 
    // 输出 idtr 信息
    for (size_t i = 0;
         i < (cpu_io::Idtr::Read().limit + 1) / sizeof(cpu_io::IdtrInfo::Idtr);
         i++) {
      klog::Debug("idtr[{}] {:#x}", i,
                  reinterpret_cast<uintptr_t>(cpu_io::Idtr::Read().base + i));
    }
  }
}

Here is the call graph for this function:

Sgi()

__always_inline auto Interrupt::Sgi ( uint32_t  intid, uint32_t  cpuid  ) const -> void

inline

设置 SGI 中断

Parameters

intid	中断号
cpuid	CPU 编号

Definition at line 94 of file interrupt.h.

                                                                         {
    gic_.Sgi(intid, cpuid);
  }

Here is the call graph for this function:

Spi()

__always_inline auto Interrupt::Spi ( uint32_t  intid, uint32_t  cpuid  ) const -> void

inline

设置 SPI 中断

Parameters

intid	中断号
cpuid	CPU 编号

Definition at line 76 of file interrupt.h.

                                                                         {
    gic_.Spi(intid, cpuid);
  }

Here is the call graph for this function:

Member Data Documentation

apic_

Apic Interrupt::apic_ {}

private

APIC 中断控制器实例

Definition at line 76 of file interrupt.h.

{};

exception_handlers_

std::array<InterruptDelegate, cpu_io::ScauseInfo::kExceptionMaxCount> Interrupt::exception_handlers_ {}

private

异常处理函数数组

Definition at line 97 of file interrupt.h.

{};

gic_

Gic Interrupt::gic_ {}

private

GIC 中断控制器实例

Definition at line 113 of file interrupt.h.

{};

idts_

std::array<cpu_io::IdtrInfo::Idt, cpu_io::IdtrInfo::kInterruptMaxCount> Interrupt::idts_ {}

private

Definition at line 73 of file interrupt.h.

{};

interrupt_handlers_ [1/3]

std::array<InterruptDelegate, kMaxInterrupt> Interrupt::interrupt_handlers_ {}

private

中断处理函数数组

Definition at line 110 of file interrupt.h.

{};

interrupt_handlers_ [2/3]

std::array<InterruptDelegate, cpu_io::ScauseInfo::kInterruptMaxCount> Interrupt::interrupt_handlers_ {}

private

中断处理函数数组

Definition at line 94 of file interrupt.h.

{};

interrupt_handlers_ [3/3]

std::array<InterruptDelegate, cpu_io::IdtrInfo::kInterruptMaxCount> Interrupt::interrupt_handlers_ {}

private

中断处理函数数组

Definition at line 70 of file interrupt.h.

{};

kExternalVectorBase

constexpr uint8_t Interrupt::kExternalVectorBase = 0x20

staticconstexpr

外部中断向量基址（IO APIC IRQ 到 IDT 向量的映射）

Definition at line 20 of file interrupt.h.

kMaxInterrupt

constexpr size_t Interrupt::kMaxInterrupt = 128

staticconstexpr

最大中断号

Definition at line 22 of file interrupt.h.

plic_

Plic Interrupt::plic_ {}

private

Definition at line 98 of file interrupt.h.

{};

---

The documentation for this class was generated from the following files:

• /workspaces/SimpleKernel/src/arch/aarch64/include/interrupt.h
• /workspaces/SimpleKernel/src/arch/riscv64/include/interrupt.h
• /workspaces/SimpleKernel/src/arch/x86_64/include/interrupt.h
• /workspaces/SimpleKernel/src/arch/aarch64/interrupt.cpp
• /workspaces/SimpleKernel/src/arch/riscv64/interrupt.cpp
• /workspaces/SimpleKernel/src/arch/x86_64/interrupt.cpp