Add I2C software_reset method.

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Added
 - Implement `PartialOrd`, `Ord`, `Hash` for `can::StandardId`, `can::ExtendedId` and `can::Id` according to CAN bus arbitration rules
+- `I2c::software_reset` for resetting all (supported) devices connected to the bus.
 
 ### Fixed
 - Fixed documentation for `wait_for_rising_edge`.

embedded-hal-async/CHANGELOG.md

@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [v0.1.0-alpha.1] - 2022-05-24
 
+### Added
+
+- `I2c::software_reset` for resetting all (supported) devices connected to the bus.
+
 ### Changed
 
 - spi: device helper methods (`read`, `write`, `transfer`...) are now default methods in `SpiDevice` instead of an `SpiDeviceExt` extension trait.

embedded-hal-async/src/i2c.rs

@@ -130,6 +130,16 @@ pub trait I2c<A: AddressMode = SevenBitAddress>: ErrorType {
         address: A,
         operations: &'a mut [Operation<'b>],
     ) -> Self::TransactionFuture<'a, 'b>;
+
+    /// Request a software reset for all devices connected to the I2C bus.
+    ///
+    /// # Note
+    ///
+    /// This I2C feature is optional. It depends on each individual device whether or not it responds to this command.
+    #[inline]
+    fn software_reset<'a>(&'a mut self) -> Self::WriteFuture<'a> {
+        self.write(A::GENERAL_CALL_ADDR, &[0x06])
+    }
 }
 
 impl<A: AddressMode, T: I2c<A>> I2c<A> for &mut T {

src/i2c.rs

@@ -140,8 +140,6 @@
 //! }
 //! ```
 
-use crate::private;
-
 /// I2C error
 pub trait Error: core::fmt::Debug {
     /// Convert error to a generic I2C error kind
@@ -241,24 +239,36 @@ impl<T: ErrorType> ErrorType for &mut T {
     type Error = T::Error;
 }
 
+mod private {
+    pub trait Sealed {}
+}
+
 /// Address mode (7-bit / 10-bit)
 ///
 /// Note: This trait is sealed and should not be implemented outside of this crate.
-pub trait AddressMode: private::Sealed + 'static {}
+pub trait AddressMode: private::Sealed + 'static {
+    #[doc(hidden)]
+    const GENERAL_CALL_ADDR: Self;
+}
 
 /// 7-bit address mode type
 pub type SevenBitAddress = u8;
 
 /// 10-bit address mode type
 pub type TenBitAddress = u16;
 
-impl AddressMode for SevenBitAddress {}
+impl private::Sealed for SevenBitAddress {}
+impl AddressMode for SevenBitAddress {
+    const GENERAL_CALL_ADDR: Self = 0;
+}
 
-impl AddressMode for TenBitAddress {}
+impl private::Sealed for TenBitAddress {}
+impl AddressMode for TenBitAddress {
+    const GENERAL_CALL_ADDR: Self = 0;
+}
 
 /// Blocking I2C traits
 pub mod blocking {
-
     use super::{AddressMode, ErrorType, SevenBitAddress};
 
     /// Transactional I2C operation.
@@ -400,6 +410,16 @@ pub mod blocking {
         fn transaction_iter<'a, O>(&mut self, address: A, operations: O) -> Result<(), Self::Error>
         where
             O: IntoIterator<Item = Operation<'a>>;
+
+        /// Request a software reset for all devices connected to the I2C bus.
+        ///
+        /// # Note
+        ///
+        /// This I2C feature is optional. It depends on each individual device whether or not it responds to this command.
+        #[inline]
+        fn software_reset(&mut self) -> Result<(), Self::Error> {
+            self.write(A::GENERAL_CALL_ADDR, &[0x06])
+        }
     }
 
     impl<A: AddressMode, T: I2c<A>> I2c<A> for &mut T {

src/lib.rs

@@ -361,11 +361,3 @@ pub mod digital;
 pub mod i2c;
 pub mod serial;
 pub mod spi;
-
-mod private {
-    use crate::i2c::{SevenBitAddress, TenBitAddress};
-    pub trait Sealed {}
-
-    impl Sealed for SevenBitAddress {}
-    impl Sealed for TenBitAddress {}
-}