AtaPassThru: Add read_pio method for AtaRequestBuilder

Author: seijikun

uefi/CHANGELOG.md

@@ -1,6 +1,7 @@
 # uefi - [Unreleased]
 
 ## Added
+- Added `proto::ata::AtaRequestBuilder::read_pio()`.
 
 ## Changed
 

uefi/src/proto/ata/mod.rs

@@ -87,6 +87,32 @@ impl<'a> AtaRequestBuilder<'a> {
         })
     }
 
+    // # PIO
+    // ########################################################################
+
+    /// Creates a builder for a PIO write operation.
+    ///
+    /// This is the protocol variant with the highest compatibility, so probing
+    /// (sending ATA IDENTIFY commands to device ports to find out whether there
+    /// is actually a device connected to it) should probably be done using this
+    /// method most of the time.
+    ///
+    /// # Arguments
+    /// - `io_align`: The I/O buffer alignment required for the ATA controller.
+    /// - `command`: The ATA command byte specifying the write operation.
+    ///
+    /// # Returns
+    /// `Result<Self, LayoutError>` indicating success or memory allocation failure.
+    ///
+    /// # Errors
+    /// This method can fail due to alignment or memory allocation issues.
+    pub fn read_pio(io_align: u32, command: u8) -> Result<Self, LayoutError> {
+        Self::new(io_align, command, AtaPassThruCommandProtocol::PIO_DATA_IN)
+    }
+
+    // # UDMA
+    // ########################################################################
+
     /// Creates a builder for a UDMA read operation.
     ///
     /// # Arguments