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_ST7789_320x240)
    #define TFT_WIDTH  320
    #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() bool turboSetup = true
    #define TURBO_SET_PIXEL(opxc, opy, colorVal)                               \
        do                                                                     \
        {                                                                      \
            if (!turboSetup)                                                   \
            {                                                                  \
                fprintf(stderr, "SETUP_FOR_TURBO() not called\n");             \
                exit(1);                                                       \
            }                                                                  \
            if (opxc < 0 || opxc >= TFT_WIDTH || opy < 0 || opy >= TFT_HEIGHT) \
            {                                                                  \
                fprintf(stderr, "PXL OOB (%d, %d)\n", opxc, opy);              \
                exit(1);                                                       \
            }                                                                  \
            setPxTft(opxc, opy, colorVal);                                     \
        } while (0)

    #define TURBO_SET_PIXEL_BOUNDS(opxc, opy, colorVal)            \
        do                                                         \
        {                                                          \
            if (!turboSetup)                                       \
            {                                                      \
                fprintf(stderr, "SETUP_FOR_TURBO() not called\n"); \
                exit(1);                                           \
            }                                                      \
            setPxTft(opxc, opy, colorVal);                         \
        } while (0)
#endif
 
#endif