Saving work

project0/README.md

@@ -0,0 +1,3 @@
+# Project 0
+
+The is simply an example file used for testing the OS based lvgl micropython builds (unix, macOS). At present the MacOS build.

project0/sdl_demo.py

@@ -0,0 +1,47 @@
+from micropython import const  # NOQA
+
+_WIDTH = const(480)
+_HEIGHT = const(320)
+
+_BUFFER_SIZE = _WIDTH * _HEIGHT * 3
+
+import lcd_bus  # NOQA
+
+bus = lcd_bus.SDLBus(flags=0)
+
+buf1 = bus.allocate_framebuffer(_BUFFER_SIZE, 0)
+buf2 = bus.allocate_framebuffer(_BUFFER_SIZE, 0)
+
+import lvgl as lv  # NOQA
+import sdl_display  # NOQA
+
+lv.init()
+
+display = sdl_display.SDLDisplay(
+    data_bus=bus,
+    display_width=_WIDTH,
+    display_height=_HEIGHT,
+    frame_buffer1=buf1,
+    frame_buffer2=buf2,
+    color_space=lv.COLOR_FORMAT.RGB888,
+)
+
+display.init()
+
+import sdl_pointer
+
+mouse = sdl_pointer.SDLPointer()
+
+scrn = lv.screen_active()
+scrn.set_style_bg_color(lv.color_hex(0x000000), 0)
+
+slider = lv.slider(scrn)
+slider.set_size(300, 25)
+slider.center()
+
+
+import task_handler
+
+# the duration needs to be set to 5 to have a good response from the mouse.
+# There is a thread that runs that facilitates double buffering.
+th = task_handler.TaskHandler(duration=5)

project1/README.md

@@ -18,8 +18,94 @@ The IO_MUX is a hardware-level multiplexer that connects the chip's internal per
 
 The GPIO Matrix is a programmable routing system that sits between the IO_MUX and the chip's peripherals. It allows almost any internal signal to be routed to almost any GPIO pin. In short it allows us to map the Chip select functionality mentioned above to another pin.
 
-This project makes generous use of the flexible pin assignment capability provided by the GPIO Matrix. Be aware that technically the IO_MUX default pins will provide better performance. Also in Micropython the SPI numbers does not directly map 
+This project makes generous use of the flexible pin assignment capability provided by the GPIO Matrix. Be aware that technically the IO_MUX default pins will provide better performance. Also in Micropython the SPI numbers do not directly map to the ESP-IDF SPI host numbers. 
 
-## Access the REPL
+See: `micropython/ports/esp32/machine_hw_spi.c`
+```
+// SPI mappings by device, naming used by IDF old/new
+// upython   | ESP32     | ESP32S2   | ESP32S3 | ESP32C3
+// ----------+-----------+-----------+---------+---------
+// SPI(id=1) | HSPI/SPI2 | FSPI/SPI2 | SPI2    | SPI2
+// SPI(id=2) | VSPI/SPI3 | HSPI/SPI3 | SPI3    | err
+```
+
+For our ESP32-S3 the micropython hardware SPI buses (1 and 2) are mapped to the ESP-IDF SPI2 and SPI3 of our chip.
+
+### Pin Mapping
+
+In my breadboard I have mapped the following ESP32-S3 GPIO pins to my `ili9341/xpt2046`. The pins chosen were simply for convenience sake, you can adjust the pin mapping as you see fit. Do note though mapping a pin to GPIO43 or GPIO44 can result in the loss of repl access. This is because UART0 TX/RX are IO_MUX'd to these pins. 
+
+On the ili9341/xpt2046 I am numbering the J2 header pins from left to right.
+
+| ESP32-S3 / Function | ili9341/xpt2046 J2 |
+|---------------------|--------------------|
+| 3.3V                | 1. VCC             | 
+| GND                 | 2. GND             | 
+| GPIO 6 / CS         | 3. CS              | 
+| GPIO 5 / Reset      | 4. RESET           | 
+| GPIO 4 / DC         | 5. DC              | 
+| GPIO 14 / MOSI      | 6. SDI(MOSI)       | 
+| GPIO 13 / SCK       | 7. SCK             | 
+| 3.3V                | 8. LED             | 
+| GPIO 41 / Unused    | 9. SDO(MISO)       | 
+| GPIO 42             | 10.T_CLK           | 
+| GPIO 35             | 11.T_CS            |
+| GPIO 1              | 12.T_DIN           |
+| GPIO 2              | 13.T_DO            |
+| GPIO 42             | 14.T_IRQ           |
+
+## Running the Code
+
+Assuming no other Micropython serial devices are connected to your PC. Plug your board in and type the command `mpremote`. This should automatically connect to the first device found and you will be presented with  the repl input `>>>`.
+
+Let's import all of the library code we will need:
+
+```python
+import lvgl as lv
+import lcd_bus
+import ili9341
+from machine import SPI
+```
+
+Now we will create our SPI bus for the ili9341 display
+
+```python
+spi_bus = SPI.Bus(host=1, mosi=14, miso=41, sck=13)
+```
+
+Now we will instantiate our display object and set the data transfer rate of the bus to 40MHz.
+
+```python
+display_bus = lcd_bus.SPIBus(
+    spi_bus=spi_bus,
+    dc=4,
+    cs=6,
+    freq=40000000,
+)
+
+display = ili9341.ILI9341(
+    data_bus=display_bus,
+    display_width=240,
+    display_height=320,
+    reset_pin=5,
+    reset_state=ili9341.STATE_LOW,
+    backlight_pin=40,
+    color_space=lv.COLOR_FORMAT.RGB565,
+    color_byte_order=ili9341.BYTE_ORDER_BGR,
+    rgb565_byte_swap=True,
+)
+```
+
+
+```
+display.set_power(True)
+display.init()
+display.set_rotation(lv.DISPLAY_ROTATION._90)
+
+# setting this to anything but 100 or 0 when you don't have the
+# backlight state set to PWM isn't going to do anything
+display.set_backlight(100)
+
+display.invert_colors()
+```
 
-Assuming no other Micropython serial devices are connected to your PC. Plug your board in and type the command `mpremote`. This should automatically connect to the first device. 

project2/helloworld.py

@@ -0,0 +1,57 @@
+import lvgl as lv
+import lcd_bus
+
+import ili9341
+from machine import SPI
+
+spi_bus = SPI.Bus(host=1, mosi=14, miso=41, sck=13)
+
+display_bus = lcd_bus.SPIBus(
+    spi_bus=spi_bus,
+    dc=4,
+    cs=6,
+    freq=40000000,
+)
+
+display = ili9341.ILI9341(
+    data_bus=display_bus,
+    display_width=240,
+    display_height=320,
+    reset_pin=5,
+    # comment the next line if you still don't get something on the display
+    reset_state=ili9341.STATE_LOW,
+    backlight_pin=40,  # NOT USED...YET
+    color_space=lv.COLOR_FORMAT.RGB565,
+    color_byte_order=ili9341.BYTE_ORDER_BGR,
+    rgb565_byte_swap=True,
+)
+
+
+def main():
+    display.set_power(True)
+    display.init()
+    display.set_rotation(lv.DISPLAY_ROTATION._90)
+
+    # setting this to anything but 100 or 0 when you don't have the
+    # backlight state set to PWM isn't going to do anything
+    display.set_backlight(100)
+
+    display.invert_colors()
+
+    scrn = lv.screen_active()
+    scrn.set_style_bg_color(lv.color_hex(0xFFB6C1), 0)
+
+    slider = lv.slider(scrn)
+    slider.set_size(300, 50)
+    slider.center()
+
+    label = lv.label(scrn)
+    label.set_text("HELLO WORLD!")
+    label.align(lv.ALIGN.CENTER, 0, -50)
+
+    import task_handler
+
+    th = task_handler.TaskHandler()
+
+
+main()