protocols: Add ACPI Table protocol

Author: Jonathas-Conceicao

uefi-raw/src/protocol/acpi.rs

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: MIT OR Apache-2.0
+
+use crate::{Guid, Status, guid};
+use core::ffi::c_void;
+
+#[derive(Clone, Copy, Debug)]
+#[repr(C)]
+pub struct AcpiTableProtocol {
+    pub install_acpi_table: unsafe extern "efiapi" fn(
+        this: *const Self,
+        acpi_table_buffer: *const c_void,
+        acpi_table_size: usize,
+        table_key: *mut usize,
+    ) -> Status,
+    pub uninstall_acpi_table:
+        unsafe extern "efiapi" fn(this: *const Self, table_key: usize) -> Status,
+}
+
+impl AcpiTableProtocol {
+    pub const GUID: Guid = guid!("ffe06bdd-6107-46a6-7bb2-5a9c7ec5275c");
+}

uefi-raw/src/protocol/mod.rs

@@ -23,6 +23,7 @@
 //!
 //! [`GUID`]: crate::Guid
 
+pub mod acpi;
 pub mod ata;
 pub mod block;
 pub mod console;

uefi/CHANGELOG.md

@@ -7,6 +7,7 @@
 - Added `proto::hii::config::ConfigKeywordHandler`.
 - Added `proto::hii::config::HiiConfigAccess`.
 - Added `proto::hii::config_str::ConfigurationString`.
+- Added `proto::acpi::AcpiTable`.
 
 ## Changed
 - **Breaking:** `boot::stall` now take `core::time::Duration` instead of `usize`.

uefi/src/proto/acpi.rs

@@ -0,0 +1,80 @@
+// SPDX-License-Identifier: MIT OR Apache-2.0
+
+//! `AcpiTable` protocol.
+
+use crate::proto::unsafe_protocol;
+use crate::{Result, StatusExt};
+use core::ffi::c_void;
+use core::mem::MaybeUninit;
+use uefi_raw::protocol::acpi::AcpiTableProtocol;
+
+/// The AcpiTable protocol.
+#[derive(Debug)]
+#[repr(transparent)]
+#[unsafe_protocol(AcpiTableProtocol::GUID)]
+pub struct AcpiTable(AcpiTableProtocol);
+
+impl AcpiTable {
+    /// Installs an ACPI table into the RSDT/XSDT. Returns a index
+    /// that may be used by `uninstall_acpi_table` to remove the ACPI
+    /// table.
+    ///
+    /// # Safety
+    ///
+    /// When installing ACI table, the data pointed to by
+    /// `acpi_table_ptr` must be a pool allocation of type
+    /// [`ACPI_RECLAIM`] or other type suitable for data handed off to
+    /// the OS.
+    ///
+    /// [`ACPI_RECLAIM`]: crate::boot::MemoryType::ACPI_RECLAIM
+    ///
+    /// # Errors
+    ///
+    /// * [`Status::INVALID_PARAMETER`]: `acpi_table_ptr` is null; the
+    /// `acpi_table_size`, and the size field embedded in the ACPI
+    /// table are not in sync.
+    ///
+    /// * [`Status::OUT_OF_RESOURCES`]: Insufficient resources
+    /// exist to complete the request.
+    ///
+    /// * [`Status::ACCESS_DENIED`]: The table signature matches a
+    /// table already present in the system and platform policy does
+    /// not allow duplicate tables of this type.
+    ///
+    /// [`Status::INVALID_PARAMETER`]: crate::Status::INVALID_PARAMETER
+    /// [`Status::OUT_OF_RESOURCES`]: crate::Status::OUT_OF_RESOURCES
+    /// [`Status::ACCESS_DENIED`]: crate::Status::ACCESS_DENIED
+    pub unsafe fn install_acpi_table(
+        &self,
+        acpi_table_ptr: *const c_void,
+        acpi_table_size: usize,
+    ) -> Result<usize> {
+        let mut table_key = MaybeUninit::<usize>::uninit();
+        let status = unsafe {
+            (self.0.install_acpi_table)(
+                &self.0 as *const AcpiTableProtocol,
+                acpi_table_ptr,
+                acpi_table_size,
+                table_key.as_mut_ptr(),
+            )
+        };
+        status.to_result_with_val(|| unsafe { table_key.assume_init() })
+    }
+
+    /// Removes an ACPI table from the RSDT/XSDT.
+    ///
+    /// # Errors
+    ///
+    /// * [`Status::NOT_FOUND`]: `table_key` does not refer to a
+    /// valid key for a table entry.
+    ///
+    /// * [`Status::OUT_OF_RESOURCES`]: Insufficient resources exist
+    /// to complete the request.
+    ///
+    /// [`Status::NOT_FOUND`]: crate::Status::NOT_FOUND
+    /// [`Status::OUT_OF_RESOURCES`]: crate::Status::OUT_OF_RESOURCES
+    pub fn uninstall_acpi_table(&self, table_key: usize) -> Result {
+        unsafe { (self.0.uninstall_acpi_table)(&self.0 as *const AcpiTableProtocol, table_key) }
+            .to_result()
+    }
+}

uefi/src/proto/mod.rs

@@ -31,6 +31,7 @@
 //! [`boot`]: crate::boot#accessing-protocols
 //! [UEFI protocols]: uefi_raw::protocol
 
+pub mod acpi;
 #[cfg(feature = "alloc")]
 pub mod ata;
 pub mod console;