Add FeatherS3 example.

README.md

@@ -77,8 +77,8 @@ SPIRAM.
 February 2022: Supports use with only three buttons devised by Bart Cerneels.
 Simplified widget import. Existing users should replace the entire `gui` tree.
 
-Code has been tested on ESP32, ESP32-S2, Pi Pico and Pyboard. This is under
-development so check for updates.
+Code has been tested on ESP32, ESP32-S2, ESP32-S3, Pi Pico and Pyboard. This is
+under development so check for updates.
 
 # 0. Contents
 
@@ -932,7 +932,7 @@ base screen are cancelled.
 For finer control, applications can ignore this method and handle cancellation
 explicitly in code.
 
-## 4.5 Bound variable
+## 4.5 Class variable
 
  * `do_gc = True` By default a coroutine is launched to periodically perform
  garbage collection (GC). On most platforms this reduces latency by doing GC

setup_examples/ili9341_FeatherS3.py

@@ -0,0 +1,33 @@
+# ili9341_FeatherS3.py Customise for your hardware config
+
+# Released under the MIT License (MIT). See LICENSE.
+# Copyright (c) 2023 Peter Hinch
+
+# As written, supports:
+# ili9341 240x320 displays on ESP32-S3 FeatherS3 board.
+
+
+from machine import Pin, SPI
+import gc
+
+from drivers.ili93xx.ili9341 import ILI9341 as SSD
+# Create and export an SSD instance
+pdc = Pin(17, Pin.OUT, value=0)  # Arbitrary pins borrowed from st7735r_esp32.py
+prst = Pin(18, Pin.OUT, value=1)
+pcs = Pin(14, Pin.OUT, value=1)
+gc.collect()  # Precaution before instantiating framebuf
+spi = SPI(1, 30_000_000, sck=Pin(36), mosi=Pin(35), miso=Pin(37))  # No need to wire MISO.
+gc.collect()  # Precaution before instantiating framebuf
+ssd = SSD(spi, cs=pcs, dc=pdc, rst=prst)
+from gui.core.ugui import Display, Screen  # Must perform this import after instantiating SSD (see other examples)
+gc.collect()  # Precaution before instantiating framebuf
+
+# Create and export a Display instance
+# Define control buttons
+nxt = Pin(8, Pin.IN, Pin.PULL_UP)  # Move to next control
+sel = Pin(33, Pin.IN, Pin.PULL_UP)  # Operate current control
+prev = Pin(9, Pin.IN, Pin.PULL_UP)  # Move to previous control
+increase = Pin(38, Pin.IN, Pin.PULL_UP)  # Increase control's value
+decrease = Pin(1, Pin.IN, Pin.PULL_UP)  # Decrease control's value
+display = Display(ssd, nxt, sel, prev, increase, decrease)
+Screen.do_gc = False