Adafruit_TFTDMA.h

Go to the documentation of this file.

#ifndef _ADAFRUIT_TFTDMA_H_
#define _ADAFRUIT_TFTDMA_H_

#define TFT_INTERFACE_8 0   
#define TFT_INTERFACE_16 1  
#define TFT_INTERFACE_SPI 2 

// Display interface must be defined at compile-time, it's baked-in deep.
#define TFT_INTERFACE TFT_INTERFACE_8 
#define TFTWIDTH 320                  
#define TFTHEIGHT 240                 

#include <Adafruit_ZeroDMA.h>

//--------------------------------------------------------------------------
class Adafruit_TFTDMA {
public:
  Adafruit_TFTDMA(int8_t tc, int8_t reset, int8_t cs, int8_t cd, int8_t rd,
                  int8_t wr, int8_t d0, _EPioType periph);
  bool begin(void);

protected:
#if TFT_INTERFACE == TFT_INTERFACE_8
  volatile uint8_t *writePort; 
  volatile uint8_t *readPort;  
  volatile uint8_t *dirSet;    
  volatile uint8_t *dirClr;    
#elif TFT_INTERFACE == TFT_INTERFACE_16
  volatile uint16_t *writePort; 
  volatile uint16_t *readPort;  
  volatile uint16_t *dirSet;    
  volatile uint16_t *dirClr;    
#endif
  volatile uint32_t *csPortSet;    
  volatile uint32_t *csPortClr;    
  volatile uint32_t *cdPortSet;    
  volatile uint32_t *cdPortClr;    
  volatile uint32_t *rdPortSet;    
  volatile uint32_t *rdPortClr;    
  volatile uint32_t *wrPortActive; 
  volatile uint32_t *wrPortIdle;   
  uint32_t csPinMask;              
  uint32_t cdPinMask;              
  uint32_t rdPinMask;              
  uint32_t wrPinMask;              
  int8_t csPin;                    
  int8_t cdPin;                    
  int8_t rdPin;                    
  int8_t wrPin;                    
  int8_t resetPin;                 
  int8_t d0Pin;                    
  int8_t tcNum;                    
  _EPioType wrPeripheral;          
  Adafruit_ZeroDMA dma;            

  void writeReg8(uint8_t reg, uint8_t value);
  void writeReg16(uint8_t reg, uint16_t value);
  void writeReg32(uint8_t reg, uint32_t value);
  void setAddrWindow(int16_t x1, int16_t y1, int16_t x2, int16_t y2);
#if 0 // Not used:

    uint32_t           readID(void);
#endif
};

//--------------------------------------------------------------------------
class TFT_framebuffer : public Adafruit_TFTDMA {
public:
  TFT_framebuffer(int8_t tc, int8_t reset, int8_t cs, int8_t cd, int8_t rd,
                  int8_t wr, int8_t d0, _EPioType periph);
  bool begin(void);
  void update(void);
  void waitForUpdate(void);
  void sully(int16_t x, int16_t y);
  uint16_t *getBuffer(void);
  bool getDirtyRect(int16_t *x1, int16_t *y1, int16_t *x2, int16_t *y2);
  inline void rawPixel(int16_t x, int16_t y, uint16_t color);
  void drawPixel(int16_t x, int16_t y, uint16_t color);
  void fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color);
  void fillScreen(uint16_t color = 0);

private:
  DmacDescriptor *dptr; // Initial allocated DMA descriptor
  DmacDescriptor descriptor[TFTHEIGHT] __attribute__((aligned(16)));
  uint16_t framebuf[TFTWIDTH * TFTHEIGHT];
  int16_t minx, miny, maxx, maxy; // Dirty rect
};

//--------------------------------------------------------------------------
class TFT_segmented : public Adafruit_TFTDMA {
public:
  TFT_segmented(int8_t tc, int8_t reset, int8_t cs, int8_t cd, int8_t rd,
                int8_t wr, int8_t d0, _EPioType periph);
  bool begin(void);
  void update(int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t *buf,
              uint16_t maxSegmentSize,
              int16_t (*userCallback)(uint16_t *dest, uint16_t len,
                                      void *udPtr),
              void *userData);
  void waitForUpdate(void);
  inline void rawPixel(int16_t x, int16_t y, uint16_t color);
  void drawPixel(int16_t x, int16_t y, uint16_t color);
  void fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color);
  void fillScreen(uint16_t color = 0);

private:
  DmacDescriptor *descriptor;
  uint16_t *framebuf;
  int16_t xoffset, yoffset, width, height;
};

//--------------------------------------------------------------------------
class TFT_scanline : public Adafruit_TFTDMA {
public:
  TFT_scanline(int8_t tc, int8_t reset, int8_t cs, int8_t cd, int8_t rd,
               int8_t wr, int8_t d0, _EPioType periph);
  bool begin(void);
  void update(int16_t x1, int16_t y1, int16_t x2, int16_t y2,
              void (*userCallback)(uint16_t *dest, void *udPtr),
              void *userData);
  void addSpan(uint16_t *addr, int16_t w, bool inc = 1);

private:
  uint8_t lineIdx;
  uint16_t spanIdx;
  DmacDescriptor *dptr; // Initial allocated DMA descriptor
  struct scanline {
    DmacDescriptor descriptor[TFTWIDTH] __attribute__((aligned(16)));
    uint16_t linebuf[TFTWIDTH];
  } scanline[2];
};

#endif // _ADAFRUIT_TFTDMA_H_