feat: Added sleep/wake methods to display

mipidsi/CHANGELOG.md

@@ -10,6 +10,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Added
 
 - added `GC9A01` model support
+- added `Display::wake` method
+- added `Display::sleep` method
 
 ## [v0.7.1] - 2023-05-24
 

mipidsi/src/builder.rs

@@ -117,6 +117,7 @@ where
     ///
     /// Consumes the builder to create a new [Display] with an optional reset [OutputPin].
     /// Blocks using the provided [DelayUs] `delay_source` to perform the display initialization.
+    /// The display will be awake ready to use, no need to call [Display::wake] after init.
     ///
     /// ### WARNING
     /// The reset pin needs to be in *high* state in order for the display to operate.

mipidsi/src/lib.rs

@@ -80,6 +80,7 @@ use dcs::Dcs;
 use display_interface::WriteOnlyDataCommand;
 
 pub mod error;
+use embedded_hal::blocking::delay::DelayUs;
 use embedded_hal::digital::v2::OutputPin;
 pub use error::Error;
 
@@ -253,4 +254,25 @@ where
         self.dcs
             .write_command(dcs::SetTearingEffect(tearing_effect))
     }
+
+    ///
+    /// Puts the display to sleep, reducing power consumption.
+    /// Need to call [Self::wake] before issuing other commands
+    ///
+    pub fn sleep<D: DelayUs<u32>>(&mut self, delay: &mut D) -> Result<(), Error> {
+        self.dcs.write_command(dcs::EnterSleepMode)?;
+        // All supported models requires a 120ms delay before issuing other commands
+        delay.delay_us(120_000);
+        Ok(())
+    }
+
+    ///
+    /// Wakes the display after it's been set to sleep via [Self::sleep]
+    ///
+    pub fn wake<D: DelayUs<u32>>(&mut self, delay: &mut D) -> Result<(), Error> {
+        self.dcs.write_command(dcs::ExitSleepMode)?;
+        // ST7789 and st7735s have the highest minimal delay of 120ms
+        delay.delay_us(120_000);
+        Ok(())
+    }
 }