From a5ce84c26effa4b68a5080728e59715b9fc2c5cb Mon Sep 17 00:00:00 2001 From: fslongjin Date: Tue, 12 Jul 2022 17:57:11 +0800 Subject: [PATCH] =?UTF-8?q?:doc:=20multiboot2=E6=94=AF=E6=8C=81=E6=A8=A1?= =?UTF-8?q?=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/community/contact/index.rst | 2 ++ docs/index.rst | 2 +- docs/kernel/boot/bootloader.md | 19 +++++++++++++ docs/kernel/boot/index.rst | 11 ++++++++ docs/kernel/boot/multiboot2.md | 46 ++++++++++++++++++++++++++++++++ docs/kernel/bootloader/index.rst | 8 ------ docs/kernel/bootloader/intro.md | 1 - run.sh | 2 +- 8 files changed, 80 insertions(+), 11 deletions(-) create mode 100644 docs/kernel/boot/bootloader.md create mode 100644 docs/kernel/boot/index.rst create mode 100644 docs/kernel/boot/multiboot2.md delete mode 100644 docs/kernel/bootloader/index.rst delete mode 100644 docs/kernel/bootloader/intro.md diff --git a/docs/community/contact/index.rst b/docs/community/contact/index.rst index 7703a3c8..819bbe99 100644 --- a/docs/community/contact/index.rst +++ b/docs/community/contact/index.rst @@ -2,5 +2,7 @@ ==================================== 开发者: fslongjin + 工作邮箱: longjin@RinGoTek.cn + [内容待完善] diff --git a/docs/index.rst b/docs/index.rst index 6c2d850d..85ea3f47 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -17,7 +17,7 @@ :maxdepth: 1 :caption: 内核层 - kernel/bootloader/index + kernel/boot/index kernel/process_management/index kernel/filesystem/index diff --git a/docs/kernel/boot/bootloader.md b/docs/kernel/boot/bootloader.md new file mode 100644 index 00000000..27bd0a88 --- /dev/null +++ b/docs/kernel/boot/bootloader.md @@ -0,0 +1,19 @@ +# 引导加载程序 + +## 原理 + +  目前，DragonOS仅支持Legacy BIOS进行启动引导。 + +  在`head.S`的头部包含了Multiboot2引导头，里面标志了一些Multiboot2相关的特定信息，以及一些配置命令。 + +  在DragonOS的启动初期，会存储由GRUB2传来的magic number以及multiboot2_boot_info_addr。当系统进入`Start_Kernel`函数之后，将会把这两个信息保存到multiboot2驱动程序之中。信息的具体含义请参照Multiboot2 Specification进行理解，该部分难度不大，相信读者经过思考能理解其中的原理。 + +## 未来发展方向 + +- 增加对UEFI启动的支持 + +## 参考资料 + +- [Multiboot2 Specification](http://git.savannah.gnu.org/cgit/grub.git/tree/doc/multiboot.texi?h=multiboot2) + +- [GNU GRUB Manual 2.06](https://www.gnu.org/software/grub/manual/grub/grub.html) \ No newline at end of file diff --git a/docs/kernel/boot/index.rst b/docs/kernel/boot/index.rst new file mode 100644 index 00000000..3285e1cf --- /dev/null +++ b/docs/kernel/boot/index.rst @@ -0,0 +1,11 @@ +引导加载 +==================================== + + DragonOS采用GRUB2作为其引导加载程序，支持Multiboot2协议引导。目前仅支持GRUB2.06版本。 + +.. toctree:: + :maxdepth: 1 + :caption: 目录 + + bootloader + multiboot2 diff --git a/docs/kernel/boot/multiboot2.md b/docs/kernel/boot/multiboot2.md new file mode 100644 index 00000000..2de82468 --- /dev/null +++ b/docs/kernel/boot/multiboot2.md @@ -0,0 +1,46 @@ +# Multiboot2支持模块 + +  Multiboot2支持模块提供对Multiboot2协议的支持。位于`kernel/driver/multiboot2`文件夹中。 + +  根据Multiboot2协议，操作系统能够从BootLoader处获得一些信息，比如基本的硬件信息以及ACPI表的起始地址等。 + +--- + +## 数据结构 + +  `kernel/driver/multiboot2/multiboot2.h`中按照Multiboot2协议的规定，定义了大部分的数据结构，具体细节可查看该文件: [DragonOS/multiboot2.h at master · fslongjin/DragonOS · GitHub](https://github.com/fslongjin/DragonOS/blob/master/kernel/driver/multiboot2/multiboot2.h) + +--- + +## 迭代器 + +  由于Multiboot2的信息存储在自`multiboot2_boot_info_addr`开始的一段连续的内存空间之中，且不同类型的header的长度不同，因此设计了一迭代器`multiboot2_iter`。 + +### 函数原型 + +```c +void multiboot2_iter(bool (*_fun)(const struct iter_data_t *, void *, unsigned int *), + void *data, unsigned int *count) +``` + +**_fun** + +  指定的handler。当某个header的tag与该handler所处理的tag相同时，handler将处理该header，并返回true。 + +  其第一个参数为tag类型，第二个参数为返回的数据的指针，第三个值为计数（某些没有用到该值的地方，该值可以为空） + +**data** + +  传递给`_fun`的第二个参数，`_fun`函数将填充该指针所指向的内存区域，从而返回数据。 + +**count** + +  当返回的**data**为一个列表时，通过该值来指示列表中有多少项。 + +--- + +## 迭代工作函数 + +  在模块中，按照我们需要获取不同类型的tag的需要，定义了一些迭代器工作函数。 + + diff --git a/docs/kernel/bootloader/index.rst b/docs/kernel/bootloader/index.rst deleted file mode 100644 index b924a70c..00000000 --- a/docs/kernel/bootloader/index.rst +++ /dev/null @@ -1,8 +0,0 @@ -引导加载程序 -==================================== - -.. toctree:: - :maxdepth: 2 - :caption: 目录 - - intro diff --git a/docs/kernel/bootloader/intro.md b/docs/kernel/bootloader/intro.md deleted file mode 100644 index 941a1f85..00000000 --- a/docs/kernel/bootloader/intro.md +++ /dev/null @@ -1 +0,0 @@ -# 简介 \ No newline at end of file diff --git a/run.sh b/run.sh index 36265580..65c2e3dd 100644 --- a/run.sh +++ b/run.sh @@ -29,7 +29,7 @@ OS=`uname -s` if [ "${OS}" == "Linux" ]; then GRUB_PATH="$(dirname $(which grub-file))" elif [ "${OS}" == "Darwin" ]; then - GRUB_PATH="$(pwd)/tools/grub-2.04/build/grub/bin" + GRUB_PATH="$(pwd)/tools/grub-2.06/build/grub/bin" fi export PATH="${GRUB_PATH}:$PATH"