feat(steami_screen): Add SSD1327 and GC9A01 display wrappers

with example for analog clock

Author: Charly-sketch

lib/steami_screen/examples/watch.py

@@ -0,0 +1,32 @@
+"""
+Tutorial 09 — Analog Watch
+Displays an analog clock face using the built-in RTC.
+"""
+
+import time
+
+import ssd1327
+from machine import RTC, SPI, Pin
+from steami_screen import Screen, SSD1327Display
+
+# --- Screen setup ---
+spi = SPI(1)
+dc = Pin("DATA_COMMAND_DISPLAY")
+res = Pin("RST_DISPLAY")
+cs = Pin("CS_DISPLAY")
+
+display = SSD1327Display(ssd1327.WS_OLED_128X128_SPI(spi, dc, res, cs))
+screen = Screen(display)
+
+# --- RTC setup ---
+rtc = RTC()
+
+# --- Main loop ---
+while True:
+    _, _, _, _, h, m, s, _ = rtc.datetime()
+
+    screen.clear()
+    screen.watch(h, m, s)
+    screen.show()
+
+    time.sleep(0.5)

lib/steami_screen/steami_screen/__init__.py

@@ -1,4 +1,5 @@
 from steami_screen.colors import rgb_to_gray4, rgb_to_rgb8, rgb_to_rgb565
+from steami_screen.gc9a01 import GC9A01Display
 from steami_screen.screen import (
     BLACK,
     BLUE,
@@ -11,6 +12,7 @@
     YELLOW,
     Screen,
 )
+from steami_screen.sssd1327 import SSD1327Display
 
 __all__ = [
     "BLACK",
@@ -22,6 +24,8 @@
     "RED",
     "WHITE",
     "YELLOW",
+    "GC9A01Display",
+    "SSD1327Display",
     "Screen",
     "rgb_to_gray4",
     "rgb_to_rgb8",

lib/steami_screen/steami_screen/gc9a01.py

@@ -0,0 +1,44 @@
+"""
+GC9A01 display wrapper — converts RGB colors to RGB565.
+
+Wraps the raw GC9A01 driver so that steami_screen can pass RGB tuples
+while the hardware receives 16-bit RGB565 values.
+
+Usage on the STeaMi board:
+    import gc9a01
+    from steami_gc9a01 import GC9A01Display
+    raw = gc9a01.GC9A01(spi, dc, cs, rst, ...)
+    display = GC9A01Display(raw)
+"""
+
+from steami_screen.colors import rgb_to_rgb565
+
+
+class GC9A01Display:
+    """Thin wrapper around a GC9A01 driver that accepts RGB colors."""
+
+    def __init__(self, raw, width=240, height=240):
+        self._raw = raw
+        self.width = width
+        self.height = height
+
+    def fill(self, color):
+        self._raw.fill(rgb_to_rgb565(color))
+
+    def pixel(self, x, y, color):
+        self._raw.pixel(x, y, rgb_to_rgb565(color))
+
+    def text(self, string, x, y, color):
+        self._raw.text(string, x, y, rgb_to_rgb565(color))
+
+    def line(self, x1, y1, x2, y2, color):
+        self._raw.line(x1, y1, x2, y2, rgb_to_rgb565(color))
+
+    def fill_rect(self, x, y, w, h, color):
+        self._raw.fill_rect(x, y, w, h, rgb_to_rgb565(color))
+
+    def rect(self, x, y, w, h, color):
+        self._raw.rect(x, y, w, h, rgb_to_rgb565(color))
+
+    def show(self):
+        self._raw.show()

lib/steami_screen/steami_screen/screen.py

@@ -15,7 +15,7 @@
 import math
 
 # --- Color constants (RGB tuples) ---
-from colors import rgb_to_gray4
+from steami_screen.colors import rgb_to_gray4
 
 # Grays map to exact SSD1327 levels: gray4 * 17 gives R=G=B
 BLACK = (0, 0, 0)

lib/steami_screen/steami_screen/sssd1327.py

@@ -0,0 +1,44 @@
+"""
+SSD1327 display wrapper — converts RGB colors to 4-bit grayscale.
+
+Wraps the raw SSD1327 driver so that steami_screen can pass RGB tuples
+while the hardware receives grayscale values (0-15).
+
+Usage on the STeaMi board:
+    import ssd1327
+    from steami_ssd1327 import SSD1327Display
+    raw = ssd1327.WS_OLED_128X128_SPI(spi, dc, res, cs)
+    display = SSD1327Display(raw)
+"""
+
+from steami_screen.colors import rgb_to_gray4
+
+
+class SSD1327Display:
+    """Thin wrapper around an SSD1327 driver that accepts RGB colors."""
+
+    def __init__(self, raw):
+        self._raw = raw
+        self.width = getattr(raw, 'width', 128)
+        self.height = getattr(raw, 'height', 128)
+
+    def fill(self, color):
+        self._raw.fill(rgb_to_gray4(color))
+
+    def pixel(self, x, y, color):
+        self._raw.pixel(x, y, rgb_to_gray4(color))
+
+    def text(self, string, x, y, color):
+        self._raw.text(string, x, y, rgb_to_gray4(color))
+
+    def line(self, x1, y1, x2, y2, color):
+        self._raw.line(x1, y1, x2, y2, rgb_to_gray4(color))
+
+    def fill_rect(self, x, y, w, h, color):
+        self._raw.fill_rect(x, y, w, h, rgb_to_gray4(color))
+
+    def rect(self, x, y, w, h, color):
+        self._raw.rect(x, y, w, h, rgb_to_gray4(color))
+
+    def show(self):
+        self._raw.show()