arch.h File Reference

#include <cpu_io.h>
#include <sys/cdefs.h>
#include <cstddef>
#include <cstdint>

Include dependency graph for arch.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
auto	switch_to (cpu_io::CalleeSavedContext *prev, cpu_io::CalleeSavedContext *next) -> void
auto	kernel_thread_entry () -> void
auto	trap_return (void *) -> void
auto	trap_entry () -> void
auto	ArchInit (int argc, const char **argv) -> void
	体系结构相关初始化
auto	ArchInitSMP (int argc, const char **argv) -> void
	从核的体系结构相关初始化
auto	WakeUpOtherCores () -> void
	唤醒其余 core
auto	InterruptInit (int argc, const char **argv) -> void
	体系结构相关中断初始化
auto	InterruptInitSMP (int argc, const char **argv) -> void
	从核的体系结构相关中断初始化
auto	TimerInit () -> void
	初始化定时器
auto	TimerInitSMP () -> void
	从核的定时器初始化
auto	InitTaskContext (cpu_io::CalleeSavedContext *task_context, void(*entry)(void *), void *arg, uint64_t stack_top) -> void
	初始化内核线程的任务上下文（重载1）
auto	InitTaskContext (cpu_io::CalleeSavedContext *task_context, cpu_io::TrapContext *trap_context_ptr, uint64_t stack_top) -> void
	初始化用户线程的任务上下文（重载2）
__always_inline auto	backtrace (void **buffer, int size) -> int
	获取调用栈
auto	DumpStack () -> void
	打印调用栈

Variables
static constexpr size_t	kMaxFrameCount = 128
	最多回溯 128 层调用栈

Function Documentation

ArchInit()

auto ArchInit	(	int	argc,
		const char **	argv
	)		-> void

体系结构相关初始化

Parameters

argc	在不同体系结构有不同含义，同 _start
argv	在不同体系结构有不同含义，同 _start

Precondition

引导程序已完成基本硬件初始化

Postcondition

架构相关硬件（串口、内存、设备树等）已初始化

Definition at line 48 of file arch_main.cpp.

                                                   {
  KernelFdtSingleton::create(strtoull(argv[2], nullptr, 16));
 
  BasicInfoSingleton::create(argc, argv);
 
  // 解析内核 elf 信息
  KernelElfSingleton::create(BasicInfoSingleton::instance().elf_addr);
 
  KernelFdtSingleton::instance().CheckPSCI().or_else(
      [](Error err) -> Expected<void> {
        klog::Err("CheckPSCI failed: {}", err.message());
        return {};
      });
 
  klog::Info("Hello aarch64 ArchInit");
}

Here is the call graph for this function:

Here is the caller graph for this function:

ArchInitSMP()

auto ArchInitSMP	(	int	argc,
		const char **	argv
	)		-> void

从核的体系结构相关初始化

Parameters

argc	在不同体系结构有不同含义，同 _start
argv	在不同体系结构有不同含义，同 _start

Precondition

主核已完成 ArchInit

Postcondition

从核的架构相关硬件已初始化

Definition at line 65 of file arch_main.cpp.

            {}

Here is the call graph for this function:

backtrace()

__always_inline auto backtrace	(	void **	buffer,
		int	size
	)		-> int

获取调用栈

Parameters

buffer	指向一个数组，该数组用于存储调用栈中的返回地址
size	数组的大小，即调用栈中最多存储多少个返回地址

Returns

成功时返回实际写入数组中的地址数量，失败时返回 -1

Precondition

buffer 不为 nullptr，size > 0

Postcondition

buffer 中包含从当前帧开始的返回地址序列

DumpStack()

auto DumpStack

(

)

-> void

打印调用栈

Note

调用 backtrace 获取调用栈并解析符号后输出到日志

Definition at line 34 of file backtrace.cpp.

                         {
  std::array<uint64_t, kMaxFrameCount> buffer{};
 
  // 获取调用栈中的地址
  auto num_frames = backtrace(buffer);
 
  // 打印函数名
  for (auto current_frame_idx = 0; current_frame_idx < num_frames;
       current_frame_idx++) {
    for (auto symtab : KernelElfSingleton::instance().symtab) {
      if ((ELF64_ST_TYPE(symtab.st_info) == STT_FUNC) &&
          (buffer[current_frame_idx] >= symtab.st_value) &&
          (buffer[current_frame_idx] <= symtab.st_value + symtab.st_size)) {
        klog::Err("[{}] {:#x}",
                  reinterpret_cast<const char*>(
                      KernelElfSingleton::instance().strtab + symtab.st_name),
                  buffer[current_frame_idx]);
      }
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

InitTaskContext() [1/2]

auto InitTaskContext	(	cpu_io::CalleeSavedContext *	task_context,
		cpu_io::TrapContext *	trap_context_ptr,
		uint64_t	stack_top
	)		-> void

初始化用户线程的任务上下文（重载2）

Parameters

task_context	指向任务上下文的指针
trap_context_ptr	指向 Trap 上下文的指针
stack_top	内核栈顶地址

Precondition

task_context 不为 nullptr，trap_context_ptr 已填充用户态寄存器

Postcondition

task_context 已设置为经由 trap_return 返回用户态的状态

Todo:

x86_64 实现待补充

Definition at line 90 of file arch_main.cpp.

            {
  // 清零上下文
  std::memset(task_context, 0, sizeof(cpu_io::CalleeSavedContext));
 
  task_context->ReturnAddress() =
      reinterpret_cast<uint64_t>(kernel_thread_entry);
  task_context->EntryFunction() = reinterpret_cast<uint64_t>(trap_return);
  task_context->EntryArgument() = reinterpret_cast<uint64_t>(trap_context_ptr);
  task_context->StackPointer() = stack_top;
}

Here is the call graph for this function:

InitTaskContext() [2/2]

auto InitTaskContext	(	cpu_io::CalleeSavedContext *	task_context,
		void(*)(void *)	entry,
		void *	arg,
		uint64_t	stack_top
	)		-> void

初始化内核线程的任务上下文（重载1）

Parameters

task_context	指向任务上下文的指针
entry	线程入口函数
arg	传递给线程的参数
stack_top	内核栈顶地址

Precondition

task_context 不为 nullptr，stack_top 已按架构要求对齐

Postcondition

task_context 已设置为可被 switch_to 恢复的状态

Todo:

x86_64 实现待补充

Definition at line 77 of file arch_main.cpp.

            {
  // 清零上下文
  std::memset(task_context, 0, sizeof(cpu_io::CalleeSavedContext));
 
  task_context->ReturnAddress() =
      reinterpret_cast<uint64_t>(kernel_thread_entry);
  task_context->EntryFunction() = reinterpret_cast<uint64_t>(entry);
  task_context->EntryArgument() = reinterpret_cast<uint64_t>(arg);
  task_context->StackPointer() = stack_top;
}

Here is the call graph for this function:

Here is the caller graph for this function:

InterruptInit()

auto InterruptInit	(	int	argc,
		const char **	argv
	)		-> void

体系结构相关中断初始化

Parameters

argc	在不同体系结构有不同含义，同 _start
argv	在不同体系结构有不同含义，同 _start

Precondition

ArchInit 已完成

Postcondition

中断控制器已初始化，中断向量表已设置

Definition at line 175 of file interrupt_main.cpp.

                                              {
  InterruptSingleton::create();
 
  cpu_io::VBAR_EL1::Write(reinterpret_cast<uint64_t>(vector_table));
 
  auto uart_intid =
      KernelFdtSingleton::instance().GetAarch64Intid("arm,pl011").value() +
      Gic::kSpiBase;
 
  klog::Info("uart_intid: {}", uart_intid);
 
  // 通过统一接口注册 UART 外部中断（先注册 handler，再启用 GIC SPI）
  InterruptSingleton::instance()
      .RegisterExternalInterrupt(uart_intid, cpu_io::GetCurrentCoreId(), 0,
                                 InterruptDelegate::create<uart_handler>())
      .or_else([](Error err) -> Expected<void> {
        klog::Err("Failed to register UART IRQ: {}", err.message());
        return std::unexpected(err);
      });
 
  cpu_io::EnableInterrupt();
 
  klog::Info("Hello InterruptInit");
}

Here is the call graph for this function:

Here is the caller graph for this function:

InterruptInitSMP()

auto InterruptInitSMP	(	int	argc,
		const char **	argv
	)		-> void

从核的体系结构相关中断初始化

Parameters

argc	在不同体系结构有不同含义，同 _start
argv	在不同体系结构有不同含义，同 _start

Precondition

主核已完成 InterruptInit

Postcondition

从核的中断控制器已初始化

Definition at line 200 of file interrupt_main.cpp.

                                                 {
  cpu_io::VBAR_EL1::Write(reinterpret_cast<uint64_t>(vector_table));
 
  InterruptSingleton::instance().SetUp();
 
  cpu_io::EnableInterrupt();
 
  klog::Info("Hello InterruptInitSMP");
}

Here is the call graph for this function:

kernel_thread_entry()

auto kernel_thread_entry

(

)

-> void

Definition at line 44 of file arch.cpp.

{}

Here is the caller graph for this function:

switch_to()

auto switch_to	(	cpu_io::CalleeSavedContext *	prev_ctx,
		cpu_io::CalleeSavedContext *	next_ctx
	)

Copyright

Copyright The SimpleKernel Contributors

Definition at line 15 of file arch.cpp.

                                                   {
  auto* env_state =
      test_env::TestEnvironmentState::GetCurrentThreadEnvironment();
  assert(env_state &&
         "TestEnvironmentState not set for current thread. "
         "Did you forget to call SetCurrentThreadEnvironment()?");
 
  auto& core_env = env_state->GetCurrentCoreEnv();
 
  // 从上下文指针查找对应的任务
  auto* prev_task = env_state->FindTaskByContext(prev_ctx);
  auto* next_task = env_state->FindTaskByContext(next_ctx);
 
  // 获取 PerCpu 数据
  auto& per_cpu = per_cpu::GetCurrentCore();
 
  // 记录切换事件到环境层
  test_env::CoreEnvironment::SwitchEvent event;
  event.timestamp = (per_cpu.sched_data ? per_cpu.sched_data->local_tick : 0);
  event.from = prev_task;
  event.to = next_task;
  event.core_id = core_env.core_id;
  core_env.switch_history.push_back(event);
 
  // 更新 PerCpu 的当前线程
  per_cpu.running_task = next_task;
}

Here is the call graph for this function:

Here is the caller graph for this function:

TimerInit()

auto TimerInit

(

)

-> void

初始化定时器

Precondition

InterruptInit 已完成

Postcondition

定时器中断已启用，系统 tick 开始计数

Definition at line 47 of file timer.cpp.

                         {
  // 计算 interval
  interval = BasicInfoSingleton::instance().interval / SIMPLEKERNEL_TICK;
 
  // 获取定时器中断号
  timer_intid = KernelFdtSingleton::instance()
                    .GetAarch64Intid("arm,armv8-timer")
                    .value() +
                Gic::kPpiBase;
 
  InterruptSingleton::instance().RegisterInterruptFunc(
      timer_intid, InterruptDelegate::create<TimerHandler>());
 
  InterruptSingleton::instance().Ppi(timer_intid, cpu_io::GetCurrentCoreId());
 
  cpu_io::CNTV_CTL_EL0::ENABLE::Clear();
  cpu_io::CNTV_CTL_EL0::IMASK::Set();
 
  cpu_io::CNTV_TVAL_EL0::Write(interval);
 
  cpu_io::CNTV_CTL_EL0::ENABLE::Set();
  cpu_io::CNTV_CTL_EL0::IMASK::Clear();
}

Here is the call graph for this function:

Here is the caller graph for this function:

TimerInitSMP()

auto TimerInitSMP

(

)

-> void

从核的定时器初始化

Precondition

主核已完成 TimerInit，从核已完成 InterruptInitSMP

Postcondition

从核的定时器中断已启用

Copyright

Copyright The SimpleKernel Contributors

Definition at line 35 of file timer.cpp.

                            {
  InterruptSingleton::instance().Ppi(timer_intid, cpu_io::GetCurrentCoreId());
 
  cpu_io::CNTV_CTL_EL0::ENABLE::Clear();
  cpu_io::CNTV_CTL_EL0::IMASK::Set();
 
  cpu_io::CNTV_TVAL_EL0::Write(interval);
 
  cpu_io::CNTV_CTL_EL0::ENABLE::Set();
  cpu_io::CNTV_CTL_EL0::IMASK::Clear();
}

Here is the call graph for this function:

trap_entry()

auto trap_entry

(

)

-> void

Definition at line 46 of file arch.cpp.

{}

Here is the caller graph for this function:

trap_return()

auto trap_return

(

void *

)

-> void

Definition at line 45 of file arch.cpp.

{}

Here is the caller graph for this function:

WakeUpOtherCores()

auto WakeUpOtherCores

(

)

-> void

唤醒其余 core

Precondition

主核已完成初始化

Postcondition

所有从核开始执行 ArchInitSMP

Definition at line 68 of file arch_main.cpp.

                                {
  for (size_t i = 0; i < BasicInfoSingleton::instance().core_count; i++) {
    auto ret = cpu_io::psci::CpuOn(i, reinterpret_cast<uint64_t>(_boot), 0);
    if ((ret != cpu_io::psci::SUCCESS) && (ret != cpu_io::psci::ALREADY_ON)) {
      klog::Warn("hart {} start failed: {}", i, ret);
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

kMaxFrameCount

constexpr size_t kMaxFrameCount = 128

staticconstexpr

最多回溯 128 层调用栈

Definition at line 105 of file arch.h.