add a current_standby() method when the pin implements StatefulOututPin

CHANGELOG.md

@@ -6,6 +6,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- next-header -->
 ## [Unreleased] - ReleaseDate
+### Added
+* Add a `current_standby()` method to check if the driver is currently in standby mode.
+
 ### Changed
 
 * `Motor::new()` and `Driver::new()` methods now set the outputs upon their

src/lib.rs

@@ -22,7 +22,7 @@
 
 #[cfg(feature = "defmt")]
 use defmt::Format;
-use embedded_hal::digital::OutputPin;
+use embedded_hal::digital::{OutputPin, StatefulOutputPin};
 use embedded_hal::pwm::SetDutyCycle;
 
 /// Defines errors which can happen when calling [`Motor::drive()`].
@@ -197,6 +197,16 @@ where
     pub fn disable_standby(&mut self) -> Result<(), STBY::Error> {
         self.standby.set_high()
     }
+
+    /// Returns whether the standby mode is enabled.
+    ///
+    /// *NOTE* this does *not* read the electrical state of the pin, see [`StatefulOutputPin`]
+    pub fn current_standby(&mut self) -> Result<bool, STBY::Error>
+    where
+        STBY: StatefulOutputPin,
+    {
+        self.standby.is_set_high()
+    }
 }
 
 /// Represents a single motor (either motor A or motor B) hooked up to a TB6612FNG controller.