st77xx.h

Go to the documentation of this file.

#pragma once
 
#include "roo_display/transport/spi.h"
#include "roo_threads.h"
#include "roo_threads/thread.h"
 
namespace roo_display {
namespace st77xx {
 
enum Command {
  NOP = 0x00,
  SWRESET = 0x01,
  SLPIN = 0x10,
  SLPOUT = 0x11,
  PTLON = 0x12,
  NORON = 0x13,
  INVOFF = 0x20,
  INVON = 0x21,
  DISPOFF = 0x28,
  DISPON = 0x29,
  CASET = 0x2A,
  RASET = 0x2B,
  RAMWR = 0x2C,
 
  MADCTL = 0x36,
  COLMOD = 0x3A,
 
  DIC = 0xB4,
  DFC = 0xB6,
 
  PWR1 = 0xC0,
  PWR2 = 0xC1,
  PWR3 = 0xC2,
 
  VCMPCTL = 0xC5,
 
  PGC = 0xE0,
  NGC = 0xE1,
  DOCA = 0xE8,
  CSCON = 0xF0,
};
 
enum MadCtl {
  MY = 0x80,
  MX = 0x40,
  MV = 0x20,
  ML = 0x10,
  BGR = 0x08,
  MH = 0x04,
  RGB = 0x00,
};
 
template <typename Transport, typename Initializer, int16_t display_width,
          int16_t display_height, int16_t lpad = 0, int16_t tpad = 0,
          int16_t rpad = lpad, int16_t bpad = tpad, bool inverted = false,
          bool bgr = false, bool hflipped = false>
class St77xxTarget {
 public:
  typedef Rgb565 ColorMode;
  static constexpr ByteOrder byte_order = roo_io::kBigEndian;
 
  St77xxTarget(Transport transport = Transport())
      : transport_(std::move(transport)),
        width_(display_width),
        height_(display_height),
        x_offset_(lpad),
        y_offset_(rpad),
        last_x0_(-1),
        last_x1_(-1),
        last_y0_(-1),
        last_y1_(-1) {}
 
  int16_t width() const { return width_; }
 
  int16_t height() const { return height_; }
 
  void begin() {
    transport_.beginWriteOnlyTransaction();
    transport_.begin();
  }
 
  void end() {
    transport_.end();
    transport_.endTransaction();
  }
 
  void init() {
    transport_.init();
    Initializer init;
    begin();
    init.init(*this, lpad, display_width + lpad + rpad - 1, tpad,
              display_height + tpad + bpad - 1, inverted);
    end();
  }
 
  void setOrientation(Orientation orientation) {
    bool is_xy_swapped = orientation.isXYswapped();
    bool is_top_to_bottom = orientation.isTopToBottom();
    bool is_left_to_right = orientation.isLeftToRight() ^ hflipped;
    uint8_t d = (bgr ? BGR : RGB) | (is_xy_swapped ? MV : 0) |
                (is_top_to_bottom ? 0 : MY) | (is_left_to_right ? 0 : MX);
    writeCommand(MADCTL);
    transport_.write(d);
    int16_t xoffset = is_left_to_right ? lpad : rpad;
    int16_t yoffset = is_top_to_bottom ? tpad : bpad;
    x_offset_ = is_xy_swapped ? yoffset : xoffset;
    y_offset_ = is_xy_swapped ? xoffset : yoffset;
  }
 
  void setAddrWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1)
      __attribute__((always_inline)) {
    if (last_x0_ != x0 || last_x1_ != x1) {
      writeCommand(CASET);
      transport_.write16x2((x0 + x_offset_), (x1 + x_offset_));
      last_x0_ = x0;
      last_x1_ = x1;
    }
    if (last_y0_ != y0 || last_y1_ != y1) {
      writeCommand(RASET);
      transport_.write16x2((y0 + y_offset_), (y1 + y_offset_));
      last_y0_ = y0;
      last_y1_ = y1;
    }
  }
 
  void startRamWrite() __attribute__((always_inline)) { writeCommand(RAMWR); }
 
  void flush() __attribute__((always_inline)) { transport_.flush(); }
 
  void ramWrite(const roo::byte* data, size_t pixel_count)
      __attribute__((always_inline)) {
    transport_.writeBytes(data, pixel_count * 2);
  }
 
  void ramFill(const roo::byte* data, size_t pixel_count)
      __attribute__((always_inline)) {
    transport_.fill16(data, pixel_count);
  }
 
  void ramWriteAsyncBlit(const roo::byte* data, size_t row_stride_bytes,
                         size_t row_bytes, size_t row_count)
      __attribute__((always_inline)) {
    transport_.async_blit(data, row_stride_bytes, row_bytes, row_count);
  }
 
  void writeCommand(uint8_t c) __attribute__((always_inline)) {
    transport_.cmdBegin();
    transport_.write(c);
    transport_.cmdEnd();
  }
 
  void writeCommand(uint8_t c, const std::initializer_list<uint8_t>& d,
                    uint32_t delay_ms = 0) {
    writeCommand(c);
    for (uint8_t i : d) transport_.write(i);
    if (delay_ms > 0) sleep_ms(delay_ms);
  }
 
 private:
  void sleep_ms(uint32_t ms) {
    roo::this_thread::sleep_for(roo_time::Millis(ms));
  }
 
  Transport transport_;
  int16_t width_;
  int16_t height_;
  int16_t x_offset_;
  int16_t y_offset_;
  uint16_t last_x0_, last_x1_, last_y0_, last_y1_;
};
 
}  // namespace st77xx
}  // namespace roo_display