drivers_st7789.h

Go to the documentation of this file.

#pragma once
#include <runtime-hw/hw.h>
#include <stdbool.h>
#include <stdint.h>

// TYPES

typedef enum {
  DRIVER_ST7789_ROTATION_0 = 0,   
  DRIVER_ST7789_ROTATION_90 = 1,  
  DRIVER_ST7789_ROTATION_180 = 2, 
  DRIVER_ST7789_ROTATION_270 = 3  
} driver_st7789_rotation_t;

typedef enum {
  DRIVER_ST7789_INTERFACE_SPI = 0,     
  DRIVER_ST7789_INTERFACE_PARALLEL = 1 
} driver_st7789_interface_t;

typedef struct {
  uint16_t x;      
  uint16_t y;      
  uint16_t width;  
  uint16_t height; 
} driver_st7789_rect_t;

typedef struct driver_st7789_t {
  hw_spi_t *spi;       
  hw_gpio_t dc;        
  hw_gpio_t reset;     
  hw_gpio_t backlight; 
  uint16_t width;      
  uint16_t height;     
  driver_st7789_rotation_t rotation;   
  driver_st7789_interface_t interface; 
  bool round;                          
  uint8_t backlight_brightness;        
} driver_st7789_t;

// LIFECYCLE

driver_st7789_t driver_st7789_init(hw_spi_t *spi, uint8_t dc_pin,
                                   uint8_t reset_pin, uint8_t backlight_pin,
                                   uint16_t width, uint16_t height, bool round);

void driver_st7789_finalize(driver_st7789_t *st7789);

bool driver_st7789_valid(const driver_st7789_t *st7789);

// CONFIGURATION

bool driver_st7789_set_rotation(driver_st7789_t *st7789,
                                driver_st7789_rotation_t rotation);

bool driver_st7789_set_backlight(driver_st7789_t *st7789, uint8_t brightness);

// DISPLAY OPERATIONS

void driver_st7789_reset(driver_st7789_t *st7789);

bool driver_st7789_set_window(driver_st7789_t *st7789,
                              driver_st7789_rect_t rect);

bool driver_st7789_write_pixels(driver_st7789_t *st7789, const uint8_t *data,
                                size_t size);

bool driver_st7789_fill(driver_st7789_t *st7789, uint16_t color);

bool driver_st7789_update_rect(driver_st7789_t *st7789,
                               driver_st7789_rect_t rect, const uint8_t *data,
                               size_t size);