]> Repositories - hackapet/Adafruit_Blinka_Displayio.git/blobdiff - displayio/_i2cdisplay.py
Initial untested splitting
[hackapet/Adafruit_Blinka_Displayio.git] / displayio / _i2cdisplay.py
diff --git a/displayio/_i2cdisplay.py b/displayio/_i2cdisplay.py
deleted file mode 100644 (file)
index 9611fb0..0000000
+++ /dev/null
@@ -1,141 +0,0 @@
-# SPDX-FileCopyrightText: 2020 Melissa LeBlanc-Williams for Adafruit Industries
-# SPDX-FileCopyrightText: 2020 Erik Tollerud
-# SPDX-FileCopyrightText: 2021 Jim Morris
-# SPDX-FileCopyrightText: 2021 James Carr
-#
-# SPDX-License-Identifier: MIT
-
-"""
-`displayio.i2cdisplay`
-================================================================================
-
-displayio for Blinka
-
-**Software and Dependencies:**
-
-* Adafruit Blinka:
-  https://github.com/adafruit/Adafruit_Blinka/releases
-
-* Author(s): Melissa LeBlanc-Williams, Erik Tollerud, James Carr
-
-"""
-
-import time
-import busio
-import digitalio
-from circuitpython_typing import ReadableBuffer
-from ._constants import CHIP_SELECT_UNTOUCHED, DISPLAY_COMMAND
-
-__version__ = "0.0.0+auto.0"
-__repo__ = "https://github.com/adafruit/Adafruit_Blinka_displayio.git"
-
-
-class I2CDisplay:
-    """Manage updating a display over I2C in the background while Python code runs.
-    It doesn’t handle display initialization.
-    """
-
-    def __init__(self, i2c_bus: busio.I2C, *, device_address: int, reset=None):
-        """Create a I2CDisplay object associated with the given I2C bus and reset pin.
-
-        The I2C bus and pins are then in use by the display until displayio.release_displays() is
-        called even after a reload. (It does this so CircuitPython can use the display after your
-        code is done.) So, the first time you initialize a display bus in code.py you should call
-        :py:func`displayio.release_displays` first, otherwise it will error after the first
-        code.py run.
-        """
-
-        if reset is not None:
-            self._reset = digitalio.DigitalInOut(reset)
-            self._reset.switch_to_output(value=True)
-        else:
-            self._reset = None
-        self._i2c = i2c_bus
-        self._dev_addr = device_address
-
-    def __new__(cls, *args, **kwargs):
-        from . import (  # pylint: disable=import-outside-toplevel, cyclic-import
-            allocate_display_bus,
-        )
-
-        display_bus_instance = super().__new__(cls)
-        allocate_display_bus(display_bus_instance)
-        return display_bus_instance
-
-    def _release(self):
-        self.reset()
-        self._i2c.deinit()
-        if self._reset is not None:
-            self._reset.deinit()
-
-    def reset(self) -> None:
-        """
-        Performs a hardware reset via the reset pin if one is present.
-        """
-
-        if self._reset is None:
-            return
-
-        self._reset.value = False
-        time.sleep(0.0001)
-        self._reset.value = True
-
-    def send(self, command: int, data: ReadableBuffer) -> None:
-        """
-        Sends the given command value followed by the full set of data. Display state,
-        such as vertical scroll, set via ``send`` may or may not be reset once the code is
-        done.
-        """
-        self._begin_transaction()
-        self._send(DISPLAY_COMMAND, CHIP_SELECT_UNTOUCHED, bytes([command] + data))
-        self._end_transaction()
-
-    def _send(
-        self,
-        data_type: int,
-        _chip_select: int,  # Chip select behavior
-        data: ReadableBuffer,
-    ):
-        if data_type == DISPLAY_COMMAND:
-            n = len(data)
-            if n > 0:
-                command_bytes = bytearray(n * 2)
-                for i in range(n):
-                    command_bytes[2 * i] = 0x80
-                    command_bytes[2 * i + 1] = data[i]
-
-            try:
-                self._i2c.writeto(self._dev_addr, buffer=command_bytes)
-            except OSError as error:
-                if error.errno == 121:
-                    raise RuntimeError(
-                        f"I2C write error to 0x{self._dev_addr:02x}"
-                    ) from error
-                raise error
-        else:
-            data_bytes = bytearray(len(data) + 1)
-            data_bytes[0] = 0x40
-            data_bytes[1:] = data
-            try:
-                self._i2c.writeto(self._dev_addr, buffer=data_bytes)
-            except OSError as error:
-                if error.errno == 121:
-                    raise RuntimeError(
-                        f"I2C write error to 0x{self._dev_addr:02x}"
-                    ) from error
-                raise error
-
-    def _free(self) -> bool:
-        """Attempt to free the bus and return False if busy"""
-        if not self._i2c.try_lock():
-            return False
-        self._i2c.unlock()
-        return True
-
-    def _begin_transaction(self) -> bool:
-        """Lock the bus before sending data."""
-        return self._i2c.try_lock()
-
-    def _end_transaction(self) -> None:
-        """Release the bus after sending data."""
-        self._i2c.unlock()