pimoroni-pico/drivers/st7789
Phil Howard 652de85f4d Tufty 2040: RGB565 DMA display update.
Use DMA to transfer a native RGB565 display buffer to PIO rather than pushing into the TX FIFO in a loop.

Co-authored by @zx64 - https://github.com/pimoroni/pimoroni-pico/issues/776
2023-05-12 13:38:19 +01:00
..
CMakeLists.txt
README.md
st7789.cmake
st7789.cpp Tufty 2040: RGB565 DMA display update. 2023-05-12 13:38:19 +01:00
st7789.hpp
st7789_parallel.pio

README.md

ST7789 Display Driver for Pimoroni LCDs

The ST7789 driver supports both Parallel and Serial (SPI) ST7789 displays and is intended for use with:

  • Pico Display
  • Pico Display 2.0
  • Tufty 2040
  • Pico Explorer
  • 240x240 Round & Square SPI LCD Breakouts

Setup

Construct an instance of the ST7789 driver with either Parallel or SPI pins.

Parallel:

ST7789 st7789(WIDTH, HEIGHT, ROTATE_0, {
    Tufty2040::LCD_CS,   // Chip-Select
    Tufty2040::LCD_DC,   // Data-Command
    Tufty2040::LCD_WR,   // Write
    Tufty2040::LCD_RD,   // Read
    Tufty2040::LCD_D0,   // Data 0 (start of a bank of 8 pins)
    Tufty2040::BACKLIGHT // Backlight
});

SPI:

ST7789 st7789(WIDTH, HEIGHT, ROTATE_0, false, {
    PIMORONI_SPI_DEFAULT_INSTANCE, // SPI instance
    SPI_BG_FRONT_CS,               // Chip-select
    SPI_DEFAULT_SCK,               // SPI Clock
    SPI_DEFAULT_MOSI,              // SPI Out
    PIN_UNUSED,                    // SPI In
    SPI_DEFAULT_DC,                // SPI Data/Command
    PIN_UNUSED                     // Backlight
});

Reference

Update

ST7789's update accepts an instance of PicoGraphics in any colour mode:

st7789.update(&graphics);

Set Backlight

If a backlight pin has been configured, you can set the backlight from 0 to 255:

st7789.set_backlight(128)