repo: init uefi-std-example

This is a minimal template to build Rust apps with Rust's std support
for UEFI and our additional `uefi` functionality. It isn't build in CI
yet, but might serve as a base for now.

Author: phip1611

Cargo.lock

@@ -5,6 +5,7 @@ members = [
     "uefi",
     "uefi-macros",
     "uefi-raw",
+    "uefi-std-example",
     "uefi-test-runner",
     "xtask",
 ]

Cargo.toml

@@ -0,0 +1,2 @@
+[build]
+target = "x86_64-unknown-uefi"

uefi-std-example/.cargo/config.toml

@@ -0,0 +1,14 @@
+[package]
+name = "uefi-std-example"
+description = """
+
+"""
+version = "0.1.0"
+authors = ["The Rust OSDev team"]
+publish = false
+edition = "2021"
+
+[dependencies]
+uefi = { path = "../uefi", features = [], default-features = false }
+
+log.workspace = true

uefi-std-example/Cargo.toml

@@ -0,0 +1,5 @@
+# Minimal Rust App using `std` and `uefi`
+
+## Build
+
+Build using `cargo +nightly build` to build an `x86_64-unknown-uefi` app.

uefi-std-example/README.md

@@ -0,0 +1,26 @@
+#![feature(uefi_std)]
+
+use std::os::uefi as uefi_std;
+use uefi::runtime::ResetType;
+use uefi::{Handle, Status};
+
+/// Performs the necessary setup code for the `uefi` crate.
+fn setup_uefi_crate() {
+    let st = uefi_std::env::system_table();
+    let ih = uefi_std::env::image_handle();
+
+    // Mandatory setup code for `uefi` crate.
+    unsafe {
+        uefi::table::set_system_table(st.as_ptr().cast());
+
+        let ih = Handle::from_ptr(ih.as_ptr().cast()).unwrap();
+        uefi::boot::set_image_handle(ih);
+    }
+}
+
+fn main() {
+    println!("Hello World from uefi_std");
+    setup_uefi_crate();
+    println!("UEFI-Version is {}", uefi::system::uefi_revision());
+    uefi::runtime::reset(ResetType::SHUTDOWN, Status::SUCCESS, None);
+}