diff --git a/drivers/st7789/CMakeLists.txt b/drivers/st7789/CMakeLists.txt index ef26fdc5..d2c835a8 100644 --- a/drivers/st7789/CMakeLists.txt +++ b/drivers/st7789/CMakeLists.txt @@ -1,4 +1 @@ -add_library(st7789 st7789.cpp) - -# Pull in pico libraries that we need -target_link_libraries(st7789 pico_stdlib hardware_spi hardware_pwm hardware_dma) +include(${CMAKE_CURRENT_LIST_DIR}/st7789.cmake) \ No newline at end of file diff --git a/drivers/st7789/st7789.cmake b/drivers/st7789/st7789.cmake index 00c3ef7b..c8d13aea 100644 --- a/drivers/st7789/st7789.cmake +++ b/drivers/st7789/st7789.cmake @@ -1,5 +1,7 @@ add_library(st7789 ${CMAKE_CURRENT_LIST_DIR}/st7789.cpp) +target_include_directories(st7789 INTERFACE ${CMAKE_CURRENT_LIST_DIR}) + # Pull in pico libraries that we need target_link_libraries(st7789 pico_stdlib hardware_spi hardware_pwm hardware_dma) diff --git a/drivers/st7789/st7789.cpp b/drivers/st7789/st7789.cpp index 0c1c567a..705641ff 100644 --- a/drivers/st7789/st7789.cpp +++ b/drivers/st7789/st7789.cpp @@ -1,166 +1,174 @@ -#include "st7789.hpp" - -#include -#include - -#include "hardware/dma.h" -#include "hardware/pwm.h" - -namespace pimoroni { - char madctl[2]; - - void ST7789::init(bool auto_init_sequence) { - // configure spi interface and pins - spi_init(spi, spi_baud); - - gpio_set_function(dc, GPIO_FUNC_SIO); - gpio_set_dir(dc, GPIO_OUT); - - gpio_set_function(cs, GPIO_FUNC_SIO); - gpio_set_dir(cs, GPIO_OUT); - - gpio_set_function(sck, GPIO_FUNC_SPI); - gpio_set_function(mosi, GPIO_FUNC_SPI); - - if(miso != -1) { - gpio_set_function(miso, GPIO_FUNC_SPI); - } - - // if supported by the display then the vsync pin is - // toggled high during vertical blanking period - if(vsync != -1) { - gpio_set_function(vsync, GPIO_FUNC_SIO); - gpio_set_dir(vsync, GPIO_IN); - gpio_set_pulls(vsync, false, true); - } - - // if a backlight pin is provided then set it up for - // pwm control - if(bl != -1) { - pwm_config cfg = pwm_get_default_config(); - pwm_set_wrap(pwm_gpio_to_slice_num(bl), 65535); - pwm_init(pwm_gpio_to_slice_num(bl), &cfg, true); - gpio_set_function(bl, GPIO_FUNC_PWM); - } - - // if auto_init_sequence then send initialisation sequence - // for our standard displays based on the width and height - if(auto_init_sequence) { - command(reg::SWRESET); - - sleep_ms(150); - - if(width == 240 && height == 240) { - madctl[0] = 0x04; - } - - if(width == 240 && height == 135) { - madctl[0] = 0x70; - } - - if(width == 135 && height == 240) { - madctl[0] = 0x00; - } - - command(reg::MADCTL, 1, madctl); // row/column addressing order - rgb pixel order - command(reg::TEON, 1, "\x00"); // enable frame sync signal if used - command(reg::COLMOD, 1, "\x05"); // 16 bits per pixel - - command(reg::INVON); // set inversion mode - command(reg::SLPOUT); // leave sleep mode - command(reg::DISPON); // turn display on - - sleep_ms(100); - - // setup correct addressing window - if(width == 240 && height == 240) { - command(reg::CASET, 4, "\x00\x00\x00\xef"); // 0 .. 239 columns - command(reg::RASET, 4, "\x00\x00\x00\xef"); // 0 .. 239 rows - } - - if(width == 240 && height == 135) { - command(reg::RASET, 4, "\x00\x35\x00\xbb"); // 53 .. 187 (135 rows) - command(reg::CASET, 4, "\x00\x28\x01\x17"); // 40 .. 279 (240 columns) - } - - if(width == 135 && height == 240) { - command(reg::CASET, 4, "\x00\x34\x00\xba"); // 52 .. 186 (135 rows) - command(reg::RASET, 4, "\x00\x28\x01\x17"); // 40 .. 279 (240 columns) - } - } - - // the dma transfer works but without vsync it's not that useful as you could - // be updating the framebuffer during transfer... - // - // this could be avoided by creating another buffer to draw into and flip - // buffers (but costs another ~100kb of ram) - // - // it's probably not worth it for this particular usecase but will consider it - // some more... - - // setup spi for 16-bit transfers - // spi_set_format(spi, 16, SPI_CPOL_0, SPI_CPHA_0, SPI_MSB_FIRST); - - // initialise dma channel for transmitting pixel data to screen - // dma_channel = dma_claim_unused_channel(true); - // dma_channel_config config = dma_channel_get_default_config(dma_channel); - // channel_config_set_transfer_data_size(&config, DMA_SIZE_16); - // channel_config_set_dreq(&config, spi_get_index(spi) ? DREQ_SPI1_TX : DREQ_SPI0_TX); - // dma_channel_configure( - // dma_channel, &config, &spi_get_hw(spi)->dr, frame_buffer, width * height, false); - } - - void ST7789::command(uint8_t command, size_t len, const char *data) { - //dma_channel_wait_for_finish_blocking(dma_channel); - - gpio_put(cs, 0); - - gpio_put(dc, 0); // command mode - spi_write_blocking(spi, &command, 1); - - if(data) { - gpio_put(dc, 1); // data mode - spi_write_blocking(spi, (const uint8_t*)data, len); - } - - gpio_put(cs, 1); - } - - void ST7789::update(bool dont_block) { - ST7789::command(reg::RAMWR, width * height * sizeof(uint16_t), (const char*)frame_buffer); - - /*if(dma_channel_is_busy(dma_channel) && dont_block) { - return; - } - - dma_channel_wait_for_finish_blocking(dma_channel); - - uint8_t r = reg::RAMWR; - - gpio_put(cs, 0); - - gpio_put(dc, 0); // command mode - spi_write_blocking(spi, &r, 1); - - gpio_put(dc, 1); // data mode - - dma_channel_set_read_addr(dma_channel, frame_buffer, true);*/ - } - - void ST7789::set_backlight(uint8_t brightness) { - // gamma correct the provided 0-255 brightness value onto a - // 0-65535 range for the pwm counter - float gamma = 2.8; - uint16_t value = (uint16_t)(pow((float)(brightness) / 255.0f, gamma) * 65535.0f + 0.5f); - pwm_set_gpio_level(bl, value); - } - - void ST7789::vsync_callback(gpio_irq_callback_t callback) { - gpio_set_irq_enabled_with_callback(vsync, GPIO_IRQ_EDGE_RISE, true, callback); - } - - void ST7789::flip(){ - madctl[0] ^= 0xC0; - command(reg::MADCTL, 1, madctl); - } -} +#include "st7789.hpp" + +#include +#include + +#include "hardware/dma.h" +#include "hardware/pwm.h" + +namespace pimoroni { + uint8_t madctl; + uint16_t caset[2] = {0, 0}; + uint16_t raset[2] = {0, 0}; + + void ST7789::init(bool auto_init_sequence, bool round) { + // configure spi interface and pins + spi_init(spi, spi_baud); + + gpio_set_function(dc, GPIO_FUNC_SIO); + gpio_set_dir(dc, GPIO_OUT); + + gpio_set_function(cs, GPIO_FUNC_SIO); + gpio_set_dir(cs, GPIO_OUT); + + gpio_set_function(sck, GPIO_FUNC_SPI); + gpio_set_function(mosi, GPIO_FUNC_SPI); + + if(miso != -1) { + gpio_set_function(miso, GPIO_FUNC_SPI); + } + + // if supported by the display then the vsync pin is + // toggled high during vertical blanking period + if(vsync != -1) { + gpio_set_function(vsync, GPIO_FUNC_SIO); + gpio_set_dir(vsync, GPIO_IN); + gpio_set_pulls(vsync, false, true); + } + + // if a backlight pin is provided then set it up for + // pwm control + if(bl != -1) { + pwm_config cfg = pwm_get_default_config(); + pwm_set_wrap(pwm_gpio_to_slice_num(bl), 65535); + pwm_init(pwm_gpio_to_slice_num(bl), &cfg, true); + gpio_set_function(bl, GPIO_FUNC_PWM); + } + + // if auto_init_sequence then send initialisation sequence + // for our standard displays based on the width and height + if(auto_init_sequence) { + command(reg::SWRESET); + + sleep_ms(150); + + command(reg::TEON, 1, "\x00"); // enable frame sync signal if used + command(reg::COLMOD, 1, "\x05"); // 16 bits per pixel + + command(reg::INVON); // set inversion mode + command(reg::SLPOUT); // leave sleep mode + command(reg::DISPON); // turn display on + + sleep_ms(100); + + // setup correct addressing window + if(width == 240 && height == 240) { + caset[0] = 0; + caset[1] = 239; + raset[0] = round ? 40 : 0; + raset[1] = round ? 279 : 239; + madctl = MADCTL::HORIZ_ORDER; + } + + if(width == 240 && height == 135) { + caset[0] = 40; // 240 cols + caset[1] = 279; + raset[0] = 53; // 135 rows + raset[1] = 187; + madctl = MADCTL::COL_ORDER | MADCTL::SWAP_XY | MADCTL::SCAN_ORDER; + } + + if(width == 135 && height == 240) { + caset[0] = 52; // 135 cols + caset[1] = 186; + raset[0] = 40; // 240 rows + raset[1] = 279; + madctl = 0; + } + + // Byte swap the 16bit rows/cols values + caset[0] = __builtin_bswap16(caset[0]); + caset[1] = __builtin_bswap16(caset[1]); + raset[0] = __builtin_bswap16(raset[0]); + raset[1] = __builtin_bswap16(raset[1]); + + command(reg::CASET, 4, (char *)caset); + command(reg::RASET, 4, (char *)raset); + command(reg::MADCTL, 1, (char *)&madctl); + } + + // the dma transfer works but without vsync it's not that useful as you could + // be updating the framebuffer during transfer... + // + // this could be avoided by creating another buffer to draw into and flip + // buffers (but costs another ~100kb of ram) + // + // it's probably not worth it for this particular usecase but will consider it + // some more... + + // setup spi for 16-bit transfers + // spi_set_format(spi, 16, SPI_CPOL_0, SPI_CPHA_0, SPI_MSB_FIRST); + + // initialise dma channel for transmitting pixel data to screen + // dma_channel = dma_claim_unused_channel(true); + // dma_channel_config config = dma_channel_get_default_config(dma_channel); + // channel_config_set_transfer_data_size(&config, DMA_SIZE_16); + // channel_config_set_dreq(&config, spi_get_index(spi) ? DREQ_SPI1_TX : DREQ_SPI0_TX); + // dma_channel_configure( + // dma_channel, &config, &spi_get_hw(spi)->dr, frame_buffer, width * height, false); + } + + void ST7789::command(uint8_t command, size_t len, const char *data) { + //dma_channel_wait_for_finish_blocking(dma_channel); + + gpio_put(cs, 0); + + gpio_put(dc, 0); // command mode + spi_write_blocking(spi, &command, 1); + + if(data) { + gpio_put(dc, 1); // data mode + spi_write_blocking(spi, (const uint8_t*)data, len); + } + + gpio_put(cs, 1); + } + + void ST7789::update(bool dont_block) { + ST7789::command(reg::RAMWR, width * height * sizeof(uint16_t), (const char*)frame_buffer); + + /*if(dma_channel_is_busy(dma_channel) && dont_block) { + return; + } + + dma_channel_wait_for_finish_blocking(dma_channel); + + uint8_t r = reg::RAMWR; + + gpio_put(cs, 0); + + gpio_put(dc, 0); // command mode + spi_write_blocking(spi, &r, 1); + + gpio_put(dc, 1); // data mode + + dma_channel_set_read_addr(dma_channel, frame_buffer, true);*/ + } + + void ST7789::set_backlight(uint8_t brightness) { + // gamma correct the provided 0-255 brightness value onto a + // 0-65535 range for the pwm counter + float gamma = 2.8; + uint16_t value = (uint16_t)(pow((float)(brightness) / 255.0f, gamma) * 65535.0f + 0.5f); + pwm_set_gpio_level(bl, value); + } + + void ST7789::vsync_callback(gpio_irq_callback_t callback) { + gpio_set_irq_enabled_with_callback(vsync, GPIO_IRQ_EDGE_RISE, true, callback); + } + + void ST7789::flip(){ + madctl ^= MADCTL::ROW_ORDER | MADCTL::COL_ORDER; + command(reg::MADCTL, 1, (char *)&madctl); + } +} diff --git a/drivers/st7789/st7789.hpp b/drivers/st7789/st7789.hpp index 76bef36a..4b352ada 100644 --- a/drivers/st7789/st7789.hpp +++ b/drivers/st7789/st7789.hpp @@ -1,81 +1,95 @@ -#pragma once - -#include "hardware/spi.h" -#include "hardware/gpio.h" - -namespace pimoroni { - - class ST7789 { - spi_inst_t *spi = spi0; - - uint32_t dma_channel; - - // screen properties - uint16_t width; - uint16_t height; - uint16_t row_stride; - - // interface pins with our standard defaults where appropriate - int8_t cs = 17; - int8_t dc = 16; - int8_t sck = 18; - int8_t mosi = 19; - int8_t miso = -1; // we generally don't use this pin - int8_t bl = 20; - int8_t vsync = -1; // only available on some products - - uint32_t spi_baud = 64 * 1024 * 1024; - - public: - // frame buffer where pixel data is stored - uint16_t *frame_buffer; - - public: - ST7789(uint16_t width, uint16_t height, uint16_t *frame_buffer) : - width(width), height(height), frame_buffer(frame_buffer) {} - - ST7789(uint16_t width, uint16_t height, uint16_t *frame_buffer, - spi_inst_t *spi, - uint8_t cs, uint8_t dc, uint8_t sck, uint8_t mosi, uint8_t miso = -1) : - spi(spi), - width(width), height(height), - cs(cs), dc(dc), sck(sck), mosi(mosi), miso(miso), frame_buffer(frame_buffer) {} - - void init(bool auto_init_sequence = true); - - void command(uint8_t command, size_t len = 0, const char *data = NULL); - void vsync_callback(gpio_irq_callback_t callback); - void update(bool dont_block = false); - void set_backlight(uint8_t brightness); - void flip(); - - enum reg { - SWRESET = 0x01, - TEON = 0x35, - MADCTL = 0x36, - COLMOD = 0x3A, - GCTRL = 0xB7, - VCOMS = 0xBB, - LCMCTRL = 0xC0, - VDVVRHEN = 0xC2, - VRHS = 0xC3, - VDVS = 0xC4, - FRCTRL2 = 0xC6, - PWRCTRL1 = 0xD0, - FRMCTR1 = 0xB1, - FRMCTR2 = 0xB2, - GMCTRP1 = 0xE0, - GMCTRN1 = 0xE1, - INVOFF = 0x20, - SLPOUT = 0x11, - DISPON = 0x29, - GAMSET = 0x26, - DISPOFF = 0x28, - RAMWR = 0x2C, - INVON = 0x21, - CASET = 0x2A, - RASET = 0x2B - }; - }; - -} +#pragma once + +#include "hardware/spi.h" +#include "hardware/gpio.h" + +namespace pimoroni { + + class ST7789 { + spi_inst_t *spi = spi0; + + uint32_t dma_channel; + + // screen properties + uint16_t width; + uint16_t height; + uint16_t row_stride; + + // interface pins with our standard defaults where appropriate + int8_t cs = 17; + int8_t dc = 16; + int8_t sck = 18; + int8_t mosi = 19; + int8_t miso = -1; // we generally don't use this pin + int8_t bl = 21; + int8_t vsync = -1; // only available on some products + + uint32_t spi_baud = 64 * 1024 * 1024; + + public: + // frame buffer where pixel data is stored + uint16_t *frame_buffer; + + public: + ST7789(uint16_t width, uint16_t height, uint16_t *frame_buffer) : + width(width), height(height), frame_buffer(frame_buffer) {} + + ST7789(uint16_t width, uint16_t height, uint16_t *frame_buffer, + spi_inst_t *spi, + uint8_t cs, uint8_t dc, uint8_t sck, uint8_t mosi, uint8_t miso = -1) : + spi(spi), + width(width), height(height), + cs(cs), dc(dc), sck(sck), mosi(mosi), miso(miso), frame_buffer(frame_buffer) {} + + void init(bool auto_init_sequence = true, bool round = false); + + void command(uint8_t command, size_t len = 0, const char *data = NULL); + void vsync_callback(gpio_irq_callback_t callback); + void update(bool dont_block = false); + void set_backlight(uint8_t brightness); + void flip(); + + enum MADCTL : uint8_t { + ROW_ORDER = 0b10000000, + COL_ORDER = 0b01000000, + SWAP_XY = 0b00100000, // AKA "MV" + SCAN_ORDER = 0b00010000, + RGB = 0b00001000, + HORIZ_ORDER = 0b00000100 + }; + + #define ROT_240_240_0 0 + #define ROT_240_240_90 MADCTL::SWAP_XY | MADCTL::HORIZ_ORDER | MADCTL::COL_ORDER + #define ROT_240_240_180 MADCTL::SCAN_ORDER | MADCTL::HORIZ_ORDER | MADCTL::COL_ORDER | MADCTL::ROW_ORDER + #define ROT_240_240_270 MADCTL::SWAP_XY | MADCTL::HORIZ_ORDER | MADCTL::ROW_ORDER + + enum reg { + SWRESET = 0x01, + TEON = 0x35, + MADCTL = 0x36, + COLMOD = 0x3A, + GCTRL = 0xB7, + VCOMS = 0xBB, + LCMCTRL = 0xC0, + VDVVRHEN = 0xC2, + VRHS = 0xC3, + VDVS = 0xC4, + FRCTRL2 = 0xC6, + PWRCTRL1 = 0xD0, + FRMCTR1 = 0xB1, + FRMCTR2 = 0xB2, + GMCTRP1 = 0xE0, + GMCTRN1 = 0xE1, + INVOFF = 0x20, + SLPOUT = 0x11, + DISPON = 0x29, + GAMSET = 0x26, + DISPOFF = 0x28, + RAMWR = 0x2C, + INVON = 0x21, + CASET = 0x2A, + RASET = 0x2B + }; + }; + +}