feat: Added property for OLED display sleep

Author: kalehmann

adafruit_macropad.py

@@ -291,6 +291,7 @@ def _keys_and_pixels(
         if not isinstance(board.DISPLAY, type(None)):
             self.display = board.DISPLAY
             self.display.rotation = rotation
+        self._display_sleep = False
 
         # Define audio:
         self._speaker_enable = digitalio.DigitalInOut(board.SPEAKER_ENABLE)
@@ -324,6 +325,25 @@ def _keys_and_pixels(
             # No MIDI ports available.
             self._midi = None
 
+    @property
+    def display_sleep(self) -> bool:
+        """Whether the display is currently asleep."""
+        return self._display_sleep
+
+    @display_sleep.setter
+    def display_sleep(self, sleep : bool) -> None:
+        """Change the sleep status of the display.
+
+        If the display is put to sleep, it stops the OLED drive and greatly
+        reduces its power usage. The current content of the display is kept
+        in the memory and can still be updated.
+        """
+        if self._display_sleep == sleep:
+            return
+        command = 0xAE if sleep else 0xAF
+        self.display.bus.send(command, b"")
+        self._display_sleep = sleep
+
     @property
     def pixels(self) -> Optional[_PixelMapLite]:
         """Sequence-like object representing the twelve NeoPixel LEDs in a 3 x 4 grid on the