msp4031.h

Go to the documentation of this file.

#pragma once
 
// http://www.lcdwiki.com/4.0inch_Capacitive_SPI_Module_ST7796
// Maker: ???
// SKU: MSP4031
//
// Note: if you want to use the built-in SD card reader, treat it as a
// completely separate SPI device, and use the appropriate libraries (e.g.,
// 'SD'). You can connect the SD reader to the same SPI bus as the display. You
// then just need to ensure that its 'CS' pin is never activated (set to LOW)
// when a display's DrawingContext exists.
//
// Note: this display has a backlit (LED) pin. You can connect it to VCC for
// full brigtness. You can also connect it to some digital output pin, and use
// the controller-specific utility (e.g. LedcBacklit on ESP32) to control the
// intensity.
//
// Sample script:
//
// #include <Arduino.h>
//
// #include "roo_display.h"
// #include "roo_display/backlit/esp32_ledc.h"
// #include "roo_display/shape/basic.h"
// #include "roo_display/products/noname/st7796s_black/msp4031.h"
//
// using namespace roo_display;
//
// // Override the constants to match your configuration.
// static const int kPinSpiSck = 18;
// static const int kPinSpiMiso = 19;
// static const int kPinSpiMosi = 23;
//
// static const int kPinLcdCs = 5;
// static const int kPinTouchCs = 2;
// static const int kPinLcdDc = 17;
// static const int kPinLcdReset = -1;
//
// static const int kPinLcdBl = 16;
//
// products::noname::st7796s_black::Msp4031<kPinLcdCs, kPinTouchCs, kPinLcdDc,
//                                              kPinLcdReset>
//     display_device;
// Display display(display_device);
//
// LedcBacklit backlit(kPinLcdBl);
//
// void setup() {
//   display_device.initTransport(kPinSpiSck, kPinSpiMiso, kPinSpiMosi, kPinSda,
//                                kPinScl);
//   display.init(color::White);
//   backlit.begin();
// }
//
// void loop() {
//   {
//     DrawingContext dc(display);
//     dc.fill(Color(rand(), rand(), rand()));
//   }
//   int16_t x, y;
//   if (display.getTouch(x, y)) {
//     DrawingContext dc(display);
//     dc.draw(Line(0, y, display.width() - 1, y, color::Red));
//     dc.draw(Line(x, 0, x, display.height() - 1, color::Red));
//   }
//   delay(200);
// }
 
#include "roo_display/core/device.h"
#include "roo_display/core/orientation.h"
#include "roo_display/driver/st7796s.h"
#include "roo_display/driver/touch_ft6x36.h"
#include "roo_display/hal/i2c.h"
#include "roo_display/hal/spi.h"
#include "roo_display/products/combo_device.h"
 
namespace roo_display::products::noname::st7796s_black {
 
template <int8_t pinLcdCs, int8_t pinLcdDc, int8_t pinLcdReset = -1>
/// Noname 4.0" ST7796S SPI module (MSP4031).
class Msp4031 : public ComboDevice {
 public:
  /// Create device with orientation, SPI, and I2C instances.
  Msp4031(
      Orientation orientation = Orientation().rotateLeft(),
      roo_display::DefaultSpi spi = roo_display::DefaultSpi(),
      roo_display::I2cMasterBusHandle i2c = roo_display::I2cMasterBusHandle())
      : spi_(spi), i2c_(i2c), display_(spi_), touch_(i2c_) {
    display_.setOrientation(orientation);
  }
 
#if defined(ARDUINO)
  /// Initialize transport using default SPI/I2C pins (Arduino).
  void initTransport() {
    spi_.init();
    i2c_.init();
  }
#endif
 
  /// Initialize transport using explicit SPI/I2C pins.
  void initTransport(uint8_t sck, uint8_t miso, uint8_t mosi, uint8_t sda,
                     uint8_t scl) {
    spi_.init(sck, miso, mosi);
    i2c_.init(sda, scl);
  }
 
  /// Return display device.
  DisplayDevice& display() override { return display_; }
 
  /// Return touch device.
  TouchDevice* touch() override { return &touch_; }
 
  /// Return touch calibration.
  TouchCalibration touch_calibration() override {
    return TouchCalibration(0, 0, 319, 479,
                            roo_display::Orientation::RightDown());
  }
 
 private:
  roo_display::DefaultSpi spi_;
  roo_display::I2cMasterBusHandle i2c_;
  roo_display::St7796sspi<pinLcdCs, pinLcdDc, pinLcdReset> display_;
  roo_display::TouchFt6x36 touch_;
};
 
}  // namespace roo_display::products::noname::st7796s_black