Rust UEFI开发库的使用：在Rust中实现统一可扩展固件接口的嵌入式系统开发

uefi

统一可扩展固件接口的Rust包装器。

这个crate使得开发Rust软件变得容易，该软件利用安全、方便和高性能的抽象来实现UEFI功能。

价值增加和使用案例

uefi支持为退出引导服务前后的时期编写代码，但其真正的优势在于创建与UEFI引导服务大量交互的UEFI映像时。尽管如此，您仍然有灵活性将选定的类型和抽象集成到您的项目中，例如解析UEFI内存映射。

请注意，为了生成UEFI映像，您还需要使用Rust的相应uefi编译器目标，例如x86_64-unknown-uefi。

API和用户文档

请参考docs.rs以获取最新稳定版本的全面文档。尚未发布的最新文档可以在src/lib.rs中找到，也可以通过运行$ cargo xtask doc --open在本地查看。

有关uefi-rs项目和此存储库的介绍，请参考我们的主要README。

完整示例demo

以下是一个完整的Rust UEFI应用程序示例，演示如何使用uefi库：

//! 一个简单的UEFI应用程序示例

#![no_std]
#![no_main]
#![feature(abi_efiapi)]

use uefi::prelude::*;
use uefi::proto::console::gop::GraphicsOutput;
use uefi::table::boot::{OpenProtocolAttributes, OpenProtocolParams};

// UEFI入口点
#[entry]
fn efi_main(image: Handle, st: SystemTable<Boot>) -> Status {
    // 初始化UEFI服务
    uefi_services::init(&st).expect("Failed to initialize UEFI services");
    
    // 获取系统表
    let boot_services = st.boot_services();
    
    // 打印欢迎消息
    st.stdout()
        .output_string("Hello from Rust UEFI Application!\r\n")
        .expect("Failed to output string");
    
    // 尝试获取图形输出协议
    if let Ok(gop) = boot_services.locate_protocol::<GraphicsOutput>() {
        let gop = unsafe { &mut *gop.get() };
        
        // 设置图形模式（如果支持）
        if let Ok(modes) = gop.modes().collect::<Result<Vec<_>, _>>() {
            if !modes.is_empty() {
                // 使用第一个可用模式
                let _ = gop.set_mode(&modes[0]);
            }
        }
        
        // 清屏为蓝色
        let blue_pixel = 0xFF0000FF; // ARGB格式
        gop.clear(blue_pixel);
    }
    
    // 等待用户按键
    st.stdout()
        .output_string("Press any key to exit...\r\n")
        .expect("Failed to output string");
    
    wait_for_keypress(&st);
    
    Status::SUCCESS
}

// 等待按键函数
fn wait_for_keypress(st: &SystemTable<Boot>) {
    use uefi::proto::console::text::Input;
    
    let boot_services = st.boot_services();
    
    // 获取输入协议
    if let Ok(input) = boot_services.locate_protocol::<Input>() {
        let input = unsafe { &mut *input.get() };
        
        // 等待按键
        let mut key = uefi::proto::console::text::Key::default();
        while input.read_key(&mut key).is_err() {
            // 在等待输入时让出CPU
            boot_services.stall(10_000); // 10ms延迟
        }
    }
}

// 恐慌处理程序
#[panic_handler]
fn panic(info: &core::panic::PanicInfo) -> ! {
    if let Some(st) = uefi_services::system_table() {
        let _ = st.stdout().output_string("UEFI application panicked!\r\n");
        if let Some(location) = info.location() {
            let _ = st.stdout().output_fmt(format_args!(
                "Panic at {}:{}:{}\r\n",
                location.file(),
                location.line(),
                location.column()
            ));
        }
        if let Some(message) = info.message() {
            let _ = st.stdout().output_fmt(format_args!("Message: {}\r\n", message));
        }
    }
    
    loop {
        // 在恐慌时无限循环
        if let Some(st) = uefi_services::system_table() {
            st.boot_services().stall(10_000);
        }
    }
}

对应的Cargo.toml配置：

[package]
name = "uefi-demo"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib"]

[dependencies]
uefi = "0.35.0"
uefi-services = "0.22"

[package.metadata.uefi]
volume-type = "fat32"  # 输出磁盘映像的文件系统类型
main = "efi_main"      # 入口点函数名

[build-dependencies]
uefi-build = "0.5.0"

构建脚本build.rs：

use uefi_build::build;

fn main() {
    // 构建UEFI目标
    build::build_uefi("x86_64-unknown-uefi", "uefi-demo");
}