feat(kernel): add Port::{pend, clear}_interrupt_line, InterruptLine::{pend, clear}

Author: yvt

src/constance/src/kernel.rs

@@ -305,6 +305,16 @@ pub unsafe trait Port: KernelCfg1 {
     unsafe fn disable_interrupt_line(_line: InterruptNum) -> Result<(), EnableInterruptLineError> {
         Err(EnableInterruptLineError::NotSupported)
     }
+
+    /// Set the pending flag of the specified interrupt line.
+    unsafe fn pend_interrupt_line(_line: InterruptNum) -> Result<(), PendInterruptLineError> {
+        Err(PendInterruptLineError::NotSupported)
+    }
+
+    /// Clear the pending flag of the specified interrupt line.
+    unsafe fn clear_interrupt_line(_line: InterruptNum) -> Result<(), ClearInterruptLineError> {
+        Err(ClearInterruptLineError::NotSupported)
+    }
 }
 
 /// Methods intended to be called by a port.

src/constance/src/kernel/error.rs

@@ -351,3 +351,41 @@ define_error! {
         BadParam,
     }
 }
+
+define_error! {
+    /// Error type for [`InterruptLine::pend`].
+    ///
+    /// [`InterruptLine::pend`]: super::InterruptLine::pend
+    pub enum PendInterruptLineError: BadParamError {
+        /// Setting a pending flag is not supported by the port.
+        NotSupported,
+        /// Setting the pending flag of the specified interrupt line is not
+        /// supported.
+        BadParam,
+        /// The interrupt line is not configured to allow this operation. For
+        /// example, this operation is invalid for an level-triggered interrupt
+        /// line.
+        ///
+        /// A port is not required to detect this condition.
+        BadObjectState,
+    }
+}
+
+define_error! {
+    /// Error type for [`InterruptLine::clear`].
+    ///
+    /// [`InterruptLine::clear`]: super::InterruptLine::clear
+    pub enum ClearInterruptLineError: BadParamError {
+        /// Clearing a pending flag is not supported by the port.
+        NotSupported,
+        /// Clearing the pending flag of the specified interrupt line is not
+        /// supported.
+        BadParam,
+        /// The interrupt line is not configured to allow this operation. For
+        /// example, this operation is invalid for an level-triggered interrupt
+        /// line.
+        ///
+        /// A port is not required to detect this condition.
+        BadObjectState,
+    }
+}

src/constance/src/kernel/interrupt.rs

@@ -1,6 +1,9 @@
 use core::{fmt, hash, marker::PhantomData};
 
-use super::{utils, EnableInterruptLineError, Kernel, Port, SetInterruptLinePriorityError};
+use super::{
+    utils, ClearInterruptLineError, EnableInterruptLineError, Kernel, PendInterruptLineError, Port,
+    SetInterruptLinePriorityError,
+};
 use crate::utils::Init;
 
 /// Numeric value used to identify interrupt lines.
@@ -113,6 +116,18 @@ impl<System: Kernel> InterruptLine<System> {
         unsafe { System::disable_interrupt_line(self.0) }
     }
 
+    /// Set the pending flag of the interrupt line.
+    pub fn pend(self) -> Result<(), PendInterruptLineError> {
+        // Safety: We are the kernel, so it's okay to call `Port`'s methods
+        unsafe { System::pend_interrupt_line(self.0) }
+    }
+
+    /// Clear the pending flag of the interrupt line.
+    pub fn clear(self) -> Result<(), ClearInterruptLineError> {
+        // Safety: We are the kernel, so it's okay to call `Port`'s methods
+        unsafe { System::clear_interrupt_line(self.0) }
+    }
+
     // TODO: port-specific attributes
 }