ssd1327: Add test scenario for OLED display driver.

Author: nedseb

tests/fake_machine/framebuf_stub.py

@@ -0,0 +1,30 @@
+"""Stub for the MicroPython framebuf module."""
+
+GS4_HMSB = 2
+
+
+class FrameBuffer:
+    """Minimal FrameBuffer stub for testing display drivers on CPython."""
+
+    def __init__(self, buffer, width, height, fmt):
+        self.buffer = buffer
+        self.width = width
+        self.height = height
+        self.format = fmt
+
+    def fill(self, col):
+        val = (col & 0x0F) | ((col & 0x0F) << 4)
+        for i in range(len(self.buffer)):
+            self.buffer[i] = val
+
+    def pixel(self, x, y, col=None):
+        pass
+
+    def text(self, string, x, y, col=15):
+        pass
+
+    def line(self, x1, y1, x2, y2, col):
+        pass
+
+    def scroll(self, dx, dy):
+        pass

tests/fake_machine/i2c.py

@@ -40,6 +40,15 @@ def writeto_mem(self, addr, reg, buf, *, addrsize=8):
         self._registers[reg] = bytes(buf)
         self._write_log.append((reg, bytes(buf)))
 
+    def writeto(self, addr, buf, stop=True):
+        self._check_address(addr)
+        self._write_log.append((None, bytes(buf)))
+
+    def writevto(self, addr, bufs, stop=True):
+        self._check_address(addr)
+        data = b"".join(bytes(b) for b in bufs)
+        self._write_log.append((None, data))
+
     def scan(self):
         if self._address is not None:
             return [self._address]

tests/runner/executor.py

@@ -21,6 +21,7 @@ def load_driver_mock(driver_name, fake_i2c, module_name=None):
         module_name = driver_name
     from tests.fake_machine import FakeI2C, FakePin
     from tests.fake_machine import micropython_stub
+    from tests.fake_machine import framebuf_stub
 
     # Patch modules before importing driver
     import types
@@ -32,6 +33,7 @@ def load_driver_mock(driver_name, fake_i2c, module_name=None):
 
     sys.modules["machine"] = fake_machine
     sys.modules["micropython"] = micropython_stub
+    sys.modules["framebuf"] = framebuf_stub
 
     # Patch time module to add MicroPython-specific functions
     import time
@@ -107,8 +109,8 @@ def run_action(action, driver_instance):
 
     if action_type == "manual":
         prompt = action.get("prompt", "Manual check required")
-        response = input(f"\n  [MANUAL] {prompt} [y/n] ")
-        return response.strip().lower() == "y"
+        from tests.test_scenarios import _prompt_yes_no
+        return _prompt_yes_no(prompt)
 
     if action_type == "interactive":
         # Prompt first, then call method (used for hold-button-and-read tests)

tests/scenarios/ssd1327.yaml

@@ -0,0 +1,116 @@
+driver: ssd1327
+driver_class: WS_OLED_128X128_I2C
+i2c_address: 0x3C
+
+# I2C config for hardware tests (STeaMi board - STM32WB55)
+# The display uses SPI on hardware, but i2c config is required by the bridge.
+i2c:
+  id: 1
+
+# Custom hardware init (STeaMi display is on SPI, not I2C)
+hardware_init: |
+  from ssd1327.device import WS_OLED_128X128_SPI
+  from machine import SPI, Pin
+  spi = SPI(1)
+  dc = Pin("DATA_COMMAND_DISPLAY")
+  res = Pin("RST_DISPLAY")
+  cs = Pin("CS_DISPLAY")
+  dev = WS_OLED_128X128_SPI(spi, dc, res, cs)
+
+tests:
+  - name: "Fill black does not crash"
+    action: call
+    method: fill
+    args: [0]
+    mode: [mock]
+
+  - name: "Fill white does not crash"
+    action: call
+    method: fill
+    args: [15]
+    mode: [mock]
+
+  - name: "Text rendering does not crash"
+    action: call
+    method: text
+    args: ["Test", 0, 0, 15]
+    mode: [mock]
+
+  - name: "Show does not crash"
+    action: call
+    method: show
+    mode: [mock]
+
+  - name: "Display white screen"
+    action: hardware_script
+    script: |
+      dev.fill(15)
+      dev.show()
+      result = True
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Screen is white"
+    action: manual
+    prompt: "L'écran affiche-t-il un fond blanc uniforme ?"
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Display text"
+    action: hardware_script
+    script: |
+      dev.fill(0)
+      dev.text("STeaMi", 35, 56, 15)
+      dev.text("Test OK", 32, 68, 15)
+      dev.show()
+      result = True
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Text is visible"
+    action: manual
+    prompt: "L'écran affiche-t-il 'STeaMi' et 'Test OK' sur fond noir ?"
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Display grayscale gradient"
+    action: hardware_script
+    script: |
+      dev.fill(0)
+      w = 128 // 16
+      for level in range(16):
+        x = level * w
+        for row in range(128):
+          for col in range(x, x + w):
+            dev.pixel(col, row, level)
+      dev.show()
+      result = True
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Grayscale gradient is visible"
+    action: manual
+    prompt: "L'écran affiche-t-il 16 bandes verticales du noir au blanc ?"
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Scrolling animation"
+    action: hardware_script
+    script: |
+      from time import sleep_ms
+      dev.fill(0)
+      dev.text("STeaMi", 35, 60, 15)
+      dev.show()
+      for i in range(128):
+        dev.scroll(1, 0)
+        dev.show()
+        sleep_ms(20)
+      result = True
+    expect_true: true
+    mode: [hardware]
+
+  - name: "Animation was smooth"
+    action: manual
+    prompt: "Le texte 'STeaMi' a-t-il defile horizontalement de maniere fluide ?"
+    expect_true: true
+    mode: [hardware]