Add support for Simple Pointer

This protocol allows UEFI applications to access pointing devices
like mice.

Author: GabrielMajeri

src/proto/console/mod.rs

@@ -4,3 +4,4 @@
 //! used by the user to interact with the early boot platform.
 
 pub mod text;
+pub mod pointer;

src/proto/console/pointer/mod.rs

@@ -0,0 +1,73 @@
+//! Pointer device access.
+
+use {Status, Result};
+use core::mem;
+
+/// Provides information about a pointer device.
+pub struct Pointer {
+    reset: extern "C" fn(this: &mut Pointer, ext_verif: bool) -> Status,
+    get_state: extern "C" fn(this: &Pointer, state: &mut PointerState) -> Status,
+    wait_for_input: usize,
+    mode: &'static PointerMode,
+}
+
+impl Pointer {
+    /// Resets the pointer device hardware.
+    ///
+    /// The `extended_verification` parameter is used to request that UEFI
+    /// performs an extended check and reset of the input device.
+    ///
+    /// # Errors
+    ///
+    /// - `DeviceError` if the device is malfunctioning and cannot be reset.
+    pub fn reset(&mut self, extended_verification: bool) -> Result<()> {
+        (self.reset)(self, extended_verification).into()
+    }
+
+    /// Retrieves the pointer device's current state.
+    ///
+    /// # Errors
+    /// - `NotReady` is returned if the state hasn't changed since the last call.
+    /// - `DeviceError` if there was an issue with the pointer device.
+    pub fn state(&self) -> Result<PointerState> {
+        let mut pointer_state = unsafe { mem::uninitialized() };
+
+        (self.get_state)(self, &mut pointer_state).into_with(|| pointer_state)
+    }
+
+    /// Returns a reference to the pointer device information.
+    pub fn mode(&self) -> &PointerMode {
+        self.mode
+    }
+}
+
+impl_proto! {
+    protocol Pointer {
+        GUID = 0x31878c87, 0xb75, 0x11d5, [0x9a, 0x4f, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d];
+    }
+}
+
+/// Information about this pointer device.
+#[derive(Debug, Copy, Clone)]
+#[repr(C)]
+pub struct PointerMode {
+    // The pointer device's resolution on the X/Y/Z axis in counts/mm.
+    // If a value is 0, then the device does _not_ support that axis.
+    resolution: (u64, u64, u64),
+    /// Whether the devices has a left button / right button.
+    has_button: (bool, bool),
+}
+
+/// The relative change in the pointer's state.
+#[derive(Debug, Copy, Clone)]
+#[repr(C)]
+pub struct PointerState {
+    /// The relative movement on the X/Y/Z axis.
+    ///
+    /// If `PointerMode` indicates an axis is not supported, it must be ignored.
+    pub relative_movement: (i32, i32, i32),
+    /// Whether the left / right mouse button is currently pressed.
+    ///
+    /// If `PointerMode` indicates a button is not supported, it must be ignored.
+    pub button: (bool, bool),
+}