hdw-tft.h

Go to the documentation of this file.

 
#ifndef _HDW_TFT_H_
#define _HDW_TFT_H_
 
#include <stdint.h>
#include <stdbool.h>
 
#include <soc/gpio_num.h>
#include <hal/spi_types.h>
#include <driver/ledc.h>
#include <esp_err.h>
 
#include "palette.h"
 
#define MAX_TFT_BRIGHTNESS 7
 
#if defined(CONFIG_ST7735_160x80)
    #define TFT_WIDTH  160
    #define TFT_HEIGHT 80
#elif defined(CONFIG_ST7735_128x160)
    #define TFT_WIDTH  160
    #define TFT_HEIGHT 128
#elif defined(CONFIG_ST7789_240x135)
    #define TFT_WIDTH  240
    #define TFT_HEIGHT 135
#elif defined(CONFIG_ST7789_240x240)
    #define TFT_WIDTH  240
    #define TFT_HEIGHT 240
#elif defined(CONFIG_GC9307_240x280)
    #define TFT_WIDTH  280
    #define TFT_HEIGHT 240
#else
    #error "Please pick a screen size"
#endif
 
typedef void (*fnBackgroundDrawCallback_t)(int16_t x, int16_t y, int16_t w, int16_t h, int16_t up, int16_t upNum);
 
void initTFT(spi_host_device_t spiHost, gpio_num_t sclk, gpio_num_t mosi, gpio_num_t dc, gpio_num_t cs, gpio_num_t rst,
             gpio_num_t backlight, bool isPwmBacklight, ledc_channel_t ledcChannel, ledc_timer_t ledcTimer,
             uint8_t brightness);
void deinitTFT(void);
void powerDownTft(void);
void powerUpTft(void);
esp_err_t setTFTBacklightBrightness(uint8_t intensity);
void disableTFTBacklight(void);
void enableTFTBacklight(void);
 
void setPxTft(int16_t x, int16_t y, paletteColor_t px);
paletteColor_t getPxTft(int16_t x, int16_t y);
paletteColor_t* getPxTftFramebuffer(void);
void clearPxTft(void);
void drawDisplayTft(fnBackgroundDrawCallback_t cb);
 
#if defined(__XTENSA__)
    #define SETUP_FOR_TURBO() register uint32_t dispPx = (uint32_t)getPxTftFramebuffer();
 
    #define TURBO_SET_PIXEL(opxc, opy, colorVal)                                                                    \
        asm volatile("mul16u a4, %[width], %[y]\nadd a4, a4, %[px]\nadd a4, a4, %[opx]\ns8i %[val],a4, 0"           \
                     :                                                                                              \
                     : [opx] "a"(opxc), [y] "a"(opy), [px] "a"(dispPx), [val] "a"(colorVal), [width] "a"(TFT_WIDTH) \
                     : "a4");
 
    #define TURBO_SET_PIXEL_BOUNDS(opxc, opy, colorVal)                                                        \
        asm volatile(                                                                                          \
            "bgeu %[opx], %[width], failthrough%=\nbgeu %[y], %[height], failthrough%=\nmul16u a4, %[width], " \
            "%[y]\nadd a4, a4, %[px]\nadd a4, a4, %[opx]\ns8i %[val],a4, 0\nfailthrough%=:\n"                  \
            :                                                                                                  \
            : [opx] "a"(opxc), [y] "a"(opy), [px] "a"(dispPx), [val] "a"(colorVal), [width] "a"(TFT_WIDTH),    \
              [height] "a"(TFT_HEIGHT)                                                                         \
            : "a4");
#else
    #define SETUP_FOR_TURBO()
    #define TURBO_SET_PIXEL(opxc, opy, colorVal)        setPxTft(opxc, opy, colorVal)
    #define TURBO_SET_PIXEL_BOUNDS(opxc, opy, colorVal) setPxTft(opxc, opy, colorVal)
#endif
 
#endif