feat(ssd1327): Add SSD1327Display wrapper for grayscale conversion

Migration from tutorial repo

Author: Charly-sketch

lib/ssd1327/ssd1327/__init__.py

@@ -4,6 +4,7 @@
     SSD1327_I2C,
     WS_OLED_128X128_I2C,
     WS_OLED_128X128_SPI,
+    SSD1327Display,
 )
 
 __all__ = [
@@ -13,4 +14,5 @@
     "SSD1327_I2C",
     "WS_OLED_128X128_I2C",
     "WS_OLED_128X128_SPI",
+    "SSD1327Display",
 ]

lib/ssd1327/ssd1327/device.py

@@ -1,6 +1,7 @@
 from time import sleep_us
 
 import framebuf
+from steami_screen import rgb_to_gray4
 
 from ssd1327.const import (
     REG_CMD,
@@ -226,3 +227,45 @@ def __init__(self, spi, dc, res, cs):
 class WS_OLED_128X128_I2C(SSD1327_I2C):
     def __init__(self, i2c, address=0x3C):
         super().__init__(128, 128, i2c, address)
+
+"""
+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)
+"""
+
+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()