Replace depreciated .show() & changes to displayio

Author: RetiredWizard

README.rst

@@ -64,6 +64,14 @@ Usage Example
 
     import board
     import displayio
+    # Starting in CircuitPython 9.x fourwire will be a seperate internal library
+    # rather than a component of the displayio library
+    try:
+        import fourwire
+    # Use for I2C
+    #    import i2cdisplaybus
+    except ImportError:
+        pass
     import terminalio
     from adafruit_display_text import label
     import adafruit_displayio_ssd1305
@@ -74,12 +82,24 @@ Usage Example
     spi = board.SPI()
     oled_cs = board.D5
     oled_dc = board.D6
-    display_bus = displayio.FourWire(spi, command=oled_dc, chip_select=oled_cs,
-                                     baudrate=1000000, reset=board.D9)
+    # Check if the version of CircuitPython being used still utilizes FourWise as a
+    # component of the displayio library
+    if "FourWire" in dir(displayio):
+        display_bus = displayio.FourWire(
+            spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=board.D9
+        )
+    else:
+        display_bus = fourwire.FourWire(
+            spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=board.D9
+        )
 
     # Use for I2C
     # i2c = board.I2C()
+    #
+    # For CircuitPython before 9.x
     # display_bus = displayio.I2CDisplay(i2c, device_address=0x3c)
+    # For CircuitPython 9.x and later
+    # display_bus = I2CDisplayBus(i1c, device_address=0x3c)
 
     WIDTH = 128
     HEIGHT = 64     # Change to 32 if needed
@@ -90,7 +110,7 @@ Usage Example
 
     # Make the display context
     splash = displayio.Group()
-    display.show(splash)
+    display.root_group = splash
 
     color_bitmap = displayio.Bitmap(display.width, display.height, 1)
     color_palette = displayio.Palette(1)

adafruit_displayio_ssd1305.py

@@ -29,7 +29,18 @@
 
 # imports
 
-import displayio
+# Starting in CircuitPython 9.x fourwire will be a seperate internal library
+# rather than a component of the displayio library
+try:
+    # pylint: disable=useless-import-alias
+    from fourwire import FourWire as FourWire
+    from busdisplay import BusDisplay as BusDisplay
+    from i2cdisplaybus import I2CDisplayBus as I2CDisplayBus
+except ImportError:
+    # pylint: disable=useless-import-alias
+    from displayio import FourWire as FourWire
+    from displayio import Display as BusDisplay
+    from displayio import I2CDisplay as I2CDisplayBus
 
 try:
     from typing import Union
@@ -61,7 +72,7 @@
 
 
 # pylint: disable=too-few-public-methods
-class SSD1305(displayio.Display):
+class SSD1305(BusDisplay):
     """
     SSD1305 driver
 
@@ -71,9 +82,7 @@ class SSD1305(displayio.Display):
         One of (0, 90, 180, 270)
     """
 
-    def __init__(
-        self, bus: Union[displayio.Fourwire, displayio.I2CDisplay], **kwargs
-    ) -> None:
+    def __init__(self, bus: Union[FourWire, I2CDisplayBus], **kwargs) -> None:
         colstart = 0
         # Patch the init sequence for 32 pixel high displays.
         init_sequence = bytearray(_INIT_SEQUENCE)

examples/displayio_ssd1305_simpletest.py

@@ -8,6 +8,13 @@
 
 import board
 import displayio
+
+# Starting in CircuitPython 9.x fourwire will be a seperate internal library
+# rather than a component of the displayio library
+try:
+    import fourwire
+except ImportError:
+    pass
 import terminalio
 from adafruit_display_text import label
 import adafruit_displayio_ssd1305
@@ -21,9 +28,16 @@
 spi = board.SPI()
 oled_cs = board.D5
 oled_dc = board.D6
-display_bus = displayio.FourWire(
-    spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=oled_reset
-)
+# Check if the version of CircuitPython being used still utilizes FourWise as a
+# component of the displayio library
+if "FourWire" in dir(displayio):
+    display_bus = displayio.FourWire(
+        spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=oled_reset
+    )
+else:
+    display_bus = fourwire.FourWire(
+        spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=oled_reset
+    )
 
 # Use for I2C
 # i2c = board.I2C()  # uses board.SCL and board.SDA
@@ -39,7 +53,7 @@
 
 # Make the display context
 splash = displayio.Group()
-display.show(splash)
+display.root_group = splash
 
 color_bitmap = displayio.Bitmap(display.width, display.height, 1)
 color_palette = displayio.Palette(1)