440 lines
11 KiB
C
440 lines
11 KiB
C
/**
|
||
* @file multiboot2.h
|
||
* @brief multiboot2 解析
|
||
*/
|
||
|
||
#pragma once
|
||
|
||
#include "stdint.h"
|
||
#include "common.h"
|
||
|
||
/// @see Multiboot2 Specification version 2.0.pdf
|
||
// 启动后，在 32 位内核进入点，机器状态如下：
|
||
// 1. CS 指向基地址为 0x00000000，限长为4G – 1的代码段描述符。
|
||
// 2. DS，SS，ES，FS 和 GS 指向基地址为0x00000000，限长为4G –
|
||
// 1的数据段描述符。
|
||
// 3. A20 地址线已经打开。
|
||
// 4. 页机制被禁止。
|
||
// 5. 中断被禁止。
|
||
// 6. EAX = 0x2BADB002
|
||
// 7. 系统信息和启动信息块的线性地址保存在 EBX中（相当于一个指针）。
|
||
// 以下即为这个信息块的结构
|
||
|
||
/**
|
||
* @brief MULTIBOOT2 接口抽象
|
||
*/
|
||
|
||
extern uint32_t multiboot2_magic;
|
||
extern uintptr_t multiboot2_boot_info_addr;
|
||
|
||
/* How many bytes from the start of the file we search for the header. */
|
||
static const uint32_t MULTIBOOT_SEARCH = 32768;
|
||
static const uint32_t MULTIBOOT_HEADER_ALIGN = 8;
|
||
|
||
/* The magic field should contain this. */
|
||
static const uint32_t MULTIBOOT2_HEADER_MAGIC = 0xe85250d6;
|
||
|
||
/* This should be in %eax. */
|
||
static const uint32_t MULTIBOOT2_BOOTLOADER_MAGIC = 0x36d76289;
|
||
|
||
/* Alignment of multiboot modules. */
|
||
static const uint32_t MULTIBOOT_MOD_ALIGN = 0x00001000;
|
||
|
||
/* Alignment of the multiboot info structure. */
|
||
static const uint32_t MULTIBOOT_INFO_ALIGN = 0x00000008;
|
||
|
||
/* Flags set in the 'flags' member of the multiboot header. */
|
||
|
||
static const uint32_t MULTIBOOT_TAG_ALIGN = 8;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_END = 0;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_CMDLINE = 1;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_BOOT_LOADER_NAME = 2;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_MODULE = 3;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_BASIC_MEMINFO = 4;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_BOOTDEV = 5;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_MMAP = 6;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_VBE = 7;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_FRAMEBUFFER = 8;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_ELF_SECTIONS = 9;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_APM = 10;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI32 = 11;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI64 = 12;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_SMBIOS = 13;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_ACPI_OLD = 14;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_ACPI_NEW = 15;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_NETWORK = 16;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI_MMAP = 17;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI_BS = 18;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI32_IH = 19;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_EFI64_IH = 20;
|
||
static const uint32_t MULTIBOOT_TAG_TYPE_LOAD_BASE_ADDR = 21;
|
||
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_END = 0;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_INFORMATION_REQUEST =
|
||
1;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_ADDRESS = 2;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_ENTRY_ADDRESS = 3;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_CONSOLE_FLAGS = 4;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_FRAMEBUFFER = 5;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_MODULE_ALIGN = 6;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_EFI_BS = 7;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_ENTRY_ADDRESS_EFI32 =
|
||
8;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_ENTRY_ADDRESS_EFI64 =
|
||
9;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_RELOCATABLE = 10;
|
||
|
||
static const uint32_t MULTIBOOT_ARCHITECTURE_I386 = 0;
|
||
static const uint32_t MULTIBOOT_ARCHITECTURE_MIPS32 = 4;
|
||
static const uint32_t MULTIBOOT_HEADER_TAG_OPTIONAL = 1;
|
||
|
||
static const uint32_t MULTIBOOT_LOAD_PREFERENCE_NONE = 0;
|
||
static const uint32_t MULTIBOOT_LOAD_PREFERENCE_LOW = 1;
|
||
static const uint32_t MULTIBOOT_LOAD_PREFERENCE_HIGH = 2;
|
||
|
||
static const uint32_t MULTIBOOT_CONSOLE_FLAGS_CONSOLE_REQUIRED =
|
||
1;
|
||
static const uint32_t MULTIBOOT_CONSOLE_FLAGS_EGA_TEXT_SUPPORTED =
|
||
2;
|
||
|
||
static const uint32_t MULTIBOOT_MEMORY_AVAILABLE = 1;
|
||
static const uint32_t MULTIBOOT_MEMORY_RESERVED = 2;
|
||
static const uint32_t MULTIBOOT_MEMORY_ACPI_RECLAIMABLE = 3;
|
||
static const uint32_t MULTIBOOT_MEMORY_NVS = 4;
|
||
static const uint32_t MULTIBOOT_MEMORY_BADRAM = 5;
|
||
|
||
struct multiboot_header_t
|
||
{
|
||
// Must be MULTIBOOT_MAGIC - see above.
|
||
uint32_t magic;
|
||
// ISA
|
||
uint32_t architecture;
|
||
// Total header length.
|
||
uint32_t header_length;
|
||
// The above fields plus this one must equal 0 mod 2^32.
|
||
uint32_t checksum;
|
||
};
|
||
|
||
struct multiboot_header_tag_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
};
|
||
struct multiboot_header_tag_information_request_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t requests[0];
|
||
};
|
||
struct multiboot_header_tag_address_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t header_addr;
|
||
uint32_t load_addr;
|
||
uint32_t load_end_addr;
|
||
uint32_t bss_end_addr;
|
||
};
|
||
|
||
struct multiboot_header_tag_entry_address_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t entry_addr;
|
||
};
|
||
|
||
struct multiboot_header_tag_console_flags_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t console_flags;
|
||
};
|
||
|
||
struct multiboot_header_tag_framebuffer_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t width;
|
||
uint32_t height;
|
||
uint32_t depth;
|
||
};
|
||
|
||
struct multiboot_header_tag_module_align_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
};
|
||
|
||
struct multiboot_header_tag_relocatable_t
|
||
{
|
||
uint16_t type;
|
||
uint16_t flags;
|
||
uint32_t size;
|
||
|
||
uint32_t min_addr;
|
||
uint32_t max_addr;
|
||
uint32_t align;
|
||
uint32_t preference;
|
||
};
|
||
|
||
struct multiboot_color_t
|
||
{
|
||
uint8_t red;
|
||
uint8_t green;
|
||
uint8_t blue;
|
||
};
|
||
|
||
// multiboot2协议的内存区域信息
|
||
struct multiboot_mmap_entry_t
|
||
{
|
||
uint64_t addr;
|
||
uint64_t len;
|
||
uint32_t type;
|
||
uint32_t reserved;
|
||
};
|
||
|
||
struct multiboot_tag_t
|
||
{
|
||
uint32_t type;
|
||
uint32_t size;
|
||
};
|
||
|
||
struct multiboot_tag_string_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
char string[0];
|
||
};
|
||
|
||
struct multiboot_tag_module_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t mod_start;
|
||
uint32_t mod_end;
|
||
char cmdline[0];
|
||
};
|
||
|
||
struct multiboot_tag_basic_meminfo_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t mem_lower;
|
||
uint32_t mem_upper;
|
||
};
|
||
|
||
struct multiboot_tag_bootdev_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t biosdev;
|
||
uint32_t slice;
|
||
uint32_t part;
|
||
};
|
||
|
||
struct multiboot_tag_mmap_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t entry_size;
|
||
uint32_t entry_version;
|
||
struct multiboot_mmap_entry_t entries[0];
|
||
};
|
||
|
||
struct multiboot_vbe_info_block_t
|
||
{
|
||
uint8_t external_specification[512];
|
||
};
|
||
|
||
struct multiboot_vbe_mode_info_block_t
|
||
{
|
||
uint8_t external_specification[256];
|
||
};
|
||
|
||
// bootloader传递的VBE信息的结构体
|
||
struct multiboot_tag_vbe_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint16_t vbe_mode;
|
||
uint16_t vbe_interface_seg;
|
||
uint16_t vbe_interface_off;
|
||
uint16_t vbe_interface_len;
|
||
|
||
// The fields ‘vbe_control_info’ and ‘vbe_mode_info’ contain VBE control information returned by the VBE Function 00h and VBE mode information
|
||
// returned by the VBE Function 01h, respectively.
|
||
struct multiboot_vbe_info_block_t vbe_control_info;
|
||
struct multiboot_vbe_mode_info_block_t vbe_mode_info;
|
||
};
|
||
|
||
struct multiboot_tag_framebuffer_info_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint64_t framebuffer_addr;
|
||
uint32_t framebuffer_pitch; // 帧缓存上界
|
||
// width and height expressed in pixels except type=2
|
||
// when type=2, they are expressed in characters
|
||
uint32_t framebuffer_width;
|
||
uint32_t framebuffer_height;
|
||
// number of bits per pixel.
|
||
uint8_t framebuffer_bpp;
|
||
// 帧缓存的类型
|
||
uint8_t framebuffer_type;
|
||
uint8_t reserved;
|
||
};
|
||
|
||
// indexed color
|
||
struct multiboot_tag_framebuffer_info_type0_t
|
||
{
|
||
struct multiboot_tag_framebuffer_info_t header;
|
||
uint32_t framebuffer_palette_num_colors;
|
||
struct multiboot_color_t color_desc;
|
||
};
|
||
|
||
// direct RGB color
|
||
struct multiboot_tag_framebuffer_info_type1_t
|
||
{
|
||
struct multiboot_tag_framebuffer_info_t header;
|
||
|
||
uint8_t framebuffer_red_field_position;
|
||
uint8_t framebuffer_red_mask_size;
|
||
uint8_t framebuffer_green_field_position;
|
||
uint8_t framebuffer_green_mask_size;
|
||
uint8_t framebuffer_blue_field_position;
|
||
uint8_t framebuffer_blue_mask_size;
|
||
};
|
||
|
||
struct multiboot_tag_elf_sections_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t num;
|
||
uint32_t entsize;
|
||
// 段字符串表索引
|
||
uint32_t shndx;
|
||
char sections[0];
|
||
};
|
||
|
||
struct multiboot_tag_apm_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint16_t version;
|
||
uint16_t cseg;
|
||
uint32_t offset;
|
||
uint16_t cseg_16;
|
||
uint16_t dseg;
|
||
uint16_t flags;
|
||
uint16_t cseg_len;
|
||
uint16_t cseg_16_len;
|
||
uint16_t dseg_len;
|
||
};
|
||
|
||
struct multiboot_tag_efi32_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t pointer;
|
||
};
|
||
|
||
struct multiboot_tag_efi64_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint64_t pointer;
|
||
};
|
||
|
||
struct multiboot_tag_smbios_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint8_t major;
|
||
uint8_t minor;
|
||
uint8_t reserved[6];
|
||
uint8_t tables[0];
|
||
};
|
||
|
||
struct multiboot_tag_network_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint8_t dhcpack[0];
|
||
};
|
||
|
||
struct multiboot_tag_efi_mmap_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t descr_size;
|
||
uint32_t descr_vers;
|
||
uint8_t efi_mmap[0];
|
||
};
|
||
|
||
struct multiboot_tag_efi32_ih_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t pointer;
|
||
};
|
||
|
||
struct multiboot_tag_efi64_ih_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint64_t pointer;
|
||
};
|
||
|
||
struct multiboot_tag_load_base_addr_t
|
||
{
|
||
struct multiboot_tag_t tag_t;
|
||
uint32_t load_base_addr;
|
||
};
|
||
|
||
// 迭代变量
|
||
// 与 multiboot_tag_t 相同
|
||
struct iter_data_t
|
||
{
|
||
uint32_t type;
|
||
uint32_t size;
|
||
};
|
||
|
||
/**
|
||
* @brief 初始化
|
||
* @return true 成功
|
||
* @return false 失败
|
||
*/
|
||
bool multiboot2_init(uint32_t info_addr);
|
||
|
||
/**
|
||
* @brief 迭代器
|
||
* @param _fun 迭代操作
|
||
* @param _data 数据
|
||
*/
|
||
void multiboot2_iter(bool (*_fun)(const struct iter_data_t *, void *, uint32_t *),
|
||
void *_data, uint32_t *count);
|
||
|
||
/**
|
||
* @brief 获取multiboot2协议提供的内存区域信息
|
||
*
|
||
* @param _iter_data 要被迭代的信息的结构体
|
||
* @param _data 返回信息的结构体指针
|
||
* @param count 返回数组的长度
|
||
* @return true
|
||
* @return false
|
||
*/
|
||
bool multiboot2_get_memory(const struct iter_data_t *_iter_data, void *_data, uint32_t *count);
|
||
|
||
/**
|
||
* @brief 获取VBE信息
|
||
*
|
||
* @param _iter_data 要被迭代的信息的结构体
|
||
* @param _data 返回信息的结构体指针
|
||
*/
|
||
bool multiboot2_get_VBE_info(const struct iter_data_t *_iter_data, void *_data, uint32_t *reserved);
|
||
|
||
/**
|
||
* @brief 获取帧缓冲区信息
|
||
*
|
||
* @param _iter_data 要被迭代的信息的结构体
|
||
* @param _data 返回信息的结构体指针
|
||
*/
|
||
bool multiboot2_get_Framebuffer_info(const struct iter_data_t *_iter_data, void *_data, uint32_t *reserved);
|
||
|