Basalt
Milestone M0 · 已达成

从裸机开始,亲手点亮一块屏幕。

Basalt(玄武岩——地壳之下最坚实的那层石头)是一个自研 x86-64 内核的教学研究项目:不借助现成内核框架,用 C++17 子集、C 与汇编三种语言逐层搭建,Limine 负责固件初始化,内核自身代码从 64 位长模式入口开始,直至在 framebuffer 上画出第一个字符。

x86-64 C++17 / C11 / GNU as Limine v12.10.0 · base rev 3 WSL2 + QEMU ● make check 全绿

M0:启动,然后说出第一句话

Limine 完成 16 位 → 32 位 → 64 位长模式的全部固件初始化;Basalt 的第一行汇编从长模式入口开始:自建栈、收集 framebuffer,交给 C++ 的 kmain —— 随后屏幕被点亮。

QEMU · SeaBIOS → Limine → basalt.elf
M0 实拍:QEMU framebuffer 输出 hello world
headless 冒烟 · COM1 串口日志
$ make check …timeout 15 qemu-system-x86_64 … CHECK PASSED: hello world on COM1 # 串口日志原始字节 12Khello world # 1 = 进入 64 位入口桩 # 2 = 自建栈切换完成 # K = kmain(C++)已接管

左:1024×768 framebuffer 主显示(Terminus 8×16 字形)。右:CI 可断言的串口通道(ADR-003 双 sink 设计)。

为什么值得读、值得写

M0 严格限定"能启动 + hello world",但工程方法与扩展接口按真实内核的标准预留。

01

三语言严格分层

汇编只做入口桩,C 守住硬件边界,C++ 只出现在子系统层。跨语言一律 extern "C",单向依赖,层间边界即 ABI 边界——每一层都能单独讲清楚。

02

headless 可验证

make check 十五秒冒烟断言串口输出;QEMU 监视器 screendump / 寄存器 / 异常日志三板斧定位引导故障——全程无需人工盯屏。M0 的三个引导协议坑就是这么抓出来的。

03

决策全部留痕

引导协议为何从 Multiboot2 改为 Limine、字模为何选 Terminus、arm64 为何只占位——六条 ADR 逐条记录背景、备选与后果,文档即站点的治理方式。

一次加电,四步到 hello world

整条链路在模拟器中运行,不写任何真实磁盘或引导区。

STEP 1

固件与引导程序

SeaBIOS/UEFI 交给 Limine:装载 ELF、建页表、切长模式、设置 1024×768 图形模式。

STEP 2

64 位入口桩

entry64.S:串口探针 '1',切到自建的 16 KiB 内核栈,探针 '2'。

STEP 3

C++ 内核入口

kmain 校验 Limine 响应,取出 framebuffer 信息,探针 'K'。

STEP 4

点亮屏幕

console 双 sink:framebuffer 逐位绘制字形 + COM1 输出同一行字,随后 cli;hlt 静默停机。

从这里开始读

四份入口文档,覆盖"是什么 / 怎么跑 / 为什么 / 下一步"。

把这块石头搬回你的机器上。

三条命令:构建 → 跑起来 → 自动验证。一切发生在模拟器里,不动宿主机一根毫毛。