uefi: Add Timestamp protocol

Author: nicholasbishop

uefi/CHANGELOG.md

@@ -1,5 +1,8 @@
 # uefi - [Unreleased]
 
+## Added
+- Added `Timestamp` protocol.
+
 # uefi - 0.27.0 (2024-03-17)
 
 ## Added

uefi/src/proto/misc.rs

@@ -0,0 +1,25 @@
+//! Miscellaneous protocols.
+
+use crate::proto::unsafe_protocol;
+use crate::{Result, StatusExt};
+use uefi_raw::protocol::misc::{TimestampProperties, TimestampProtocol};
+
+/// Protocol for retrieving a high-resolution timestamp counter.
+#[derive(Debug)]
+#[repr(transparent)]
+#[unsafe_protocol(TimestampProtocol::GUID)]
+pub struct Timestamp(TimestampProtocol);
+
+impl Timestamp {
+    /// Get the current value of the timestamp counter.
+    #[must_use]
+    pub fn get_timestamp(&self) -> u64 {
+        unsafe { (self.0.get_timestamp)() }
+    }
+
+    /// Get the properties of the timestamp counter.
+    pub fn get_properties(&self) -> Result<TimestampProperties> {
+        let mut properties = TimestampProperties::default();
+        unsafe { (self.0.get_properties)(&mut properties) }.to_result_with_val(|| properties)
+    }
+}

uefi/src/proto/mod.rs

@@ -72,6 +72,7 @@ pub mod device_path;
 pub mod driver;
 pub mod loaded_image;
 pub mod media;
+pub mod misc;
 pub mod network;
 pub mod pi;
 pub mod rng;