BirdNet-goMikrofon/Arduino-audio-tools-main/arduino-audio-tools-main/examples/examples-custom-boards/esp32-s3-240x320-lcd-display/lcd-test/lcd-test.ino

/**
 * @file lcd-test.ino
 * @brief SpriteDisplay-based hardware color diagnostic for the Hosyond 2.8"
 * ESP32-S3 Display (240x320 ILI9341 SPI panel + FT6336G capacitive touch),
 * ported from TinyGPU's color-test example
 * (https://github.com/pschatzmann/TinyGPU/blob/main/examples/color-test/color-test.ino)
 * with this board's actual pins.
 *
 * Two tests, tap the screen to switch between them:
 *  - RGB test: red/green/blue bands - reveals a panel that doesn't honor
 *    the RGB/BGR field wiring correctly (e.g. the "green" band showing up
 *    blue).
 *  - Greyscale test: 20-band ramp from black to white - reveals a visible
 *    color tint in near-black tones even when RGB field wiring is correct.
 * Serial also prints a description of each band, in case a tint or swap
 * makes a band ambiguous by eye alone.
 *
 * Dependencies:
 * - https://github.com/pschatzmann/TinyGPU
 * @see https://www.lcdwiki.com/2.8inch_ESP32-S3_Display
 * @author Phil Schatzmann
 * @copyright GPLv3
 */
#include <TinyGPU.h>
#include <TinyGPU/DisplayDriverSPI.h>
#include <TinyGPU/SpriteDisplay.h>

using PixelT = RGB565;

// --- display geometry ------------------------------------------------------
constexpr int kDisplayWidth = 240;
constexpr int kDisplayHeight = 320;

// --- SPI / display pins (ILI9341) ------------------------------------------
constexpr int8_t kPinMosi = 11;
constexpr int8_t kPinMiso = 13;
constexpr int8_t kPinSclk = 12;
constexpr int8_t kPinCs = 10;
constexpr int8_t kPinDc = 46;
constexpr int8_t kPinRst = -1;  // shared with the board's EN/reset line
constexpr int8_t kPinBacklight = 45;

// --- Touch I2C pins (FT6336G, shares the codec's I2C bus) ------------------
constexpr int8_t kPinTouchSda = 16;
constexpr int8_t kPinTouchScl = 15;
constexpr int8_t kPinTouchRst = 18;
constexpr int8_t kPinTouchIrq = 17;

ILI9341Driver<PixelT> tftDriver(SPI, kPinCs, kPinDc, kPinRst);
SpriteDisplay<PixelT> display(kDisplayWidth, kDisplayHeight, tftDriver,
                              PixelT::fromRGB(0, 0, 0));
// IRQ left disabled (-1): TouchDriverFT6236::isTouched() would otherwise
// skip the I2C read whenever the IRQ pin reads HIGH, and this board's INT
// line's actual idle polarity/mode hasn't been confirmed - polling the
// status register directly is simpler and costs nothing.
//
// NOTE: on real hardware (2026-08-18), the FT6336G ACKs on I2C (0x38) and
// begin() succeeds, but TD_STATUS stays 0x00 even while holding a tap - a
// raw register dump bypassing this driver entirely showed the same thing,
// so it isn't a driver/register-map bug. Points at the touch panel's FPC
// connector not being seated - re-test once that's been checked.
TouchDriverFT6236 touchDriver(Wire, kPinTouchRst, -1);
BitmapFont<PixelT> font;

// Draws a solid band with a text label burned into it. Safe against the
// dangling-pointer trap of SpriteDisplay::addSprite(x, y, surface&) - the
// surface is heap-allocated and ownership is handed to SpriteDisplay via
// isSurfaceAutoDelete, the same pattern SpriteDisplay's own
// addSprite(x, y, maxX, maxY, color) overload uses internally.
void addLabeledBand(size_t x, size_t y, size_t w, size_t h, PixelT bgColor,
                    PixelT textColor, const char* label) {
  auto sprite = std::make_unique<Sprite<PixelT>>(w, h, font);
  sprite->begin();
  sprite->clear(bgColor);
  sprite->drawText(4, static_cast<int16_t>(h / 2 - 4), label, textColor, bgColor,
                   true);
  auto& info = display.addSprite(x, y, *sprite);
  info.isSurfaceAutoDelete = true;
  sprite.release();
}

void showRgbTest() {
  display.clear();
  const size_t bandHeight = kDisplayHeight / 3;
  const size_t lastBandHeight = kDisplayHeight - 2 * bandHeight;

  addLabeledBand(0, 0 * bandHeight, kDisplayWidth, bandHeight,
                PixelT::fromRGB(255, 0, 0), PixelT::fromRGB(255, 255, 255),
                "RED (255,0,0)");
  addLabeledBand(0, 1 * bandHeight, kDisplayWidth, bandHeight,
                PixelT::fromRGB(0, 255, 0), PixelT::fromRGB(0, 0, 0),
                "GREEN (0,255,0)");
  addLabeledBand(0, 2 * bandHeight, kDisplayWidth, lastBandHeight,
                PixelT::fromRGB(0, 0, 255), PixelT::fromRGB(255, 255, 255),
                "BLUE (0,0,255)");

  Serial.println(
      "RGB test: top=RED(255,0,0) mid=GREEN(0,255,0) bottom=BLUE(0,0,255)");
}

void showGreyscaleTest() {
  display.clear();
  constexpr int kBandCount = 20;
  const size_t bandHeight = kDisplayHeight / kBandCount;

  Serial.println("Greyscale test: 20 bands, top=0 (black) to bottom=255 (white)");
  for (int i = 0; i < kBandCount; ++i) {
    const uint8_t value = static_cast<uint8_t>((255 * i) / (kBandCount - 1));
    const PixelT color = PixelT::fromRGB(value, value, value);
    const PixelT textColor =
        (value > 127) ? PixelT::fromRGB(0, 0, 0) : PixelT::fromRGB(255, 255, 255);
    char label[16];
    snprintf(label, sizeof(label), "%2d: %3d", i, value);
    addLabeledBand(0, i * bandHeight, kDisplayWidth, bandHeight, color,
                  textColor, label);
    Serial.printf("  band %2d: grey %3d  packed 0x%04X\n", i, value,
                  color.getValue());
  }
}

bool showingGreyscale = false;

void toggleTest() {
  showingGreyscale = !showingGreyscale;
  if (showingGreyscale) {
    showGreyscaleTest();
  } else {
    showRgbTest();
  }
}

void setup() {
  Serial.begin(115200);

  pinMode(kPinBacklight, OUTPUT);
  digitalWrite(kPinBacklight, HIGH);

  SPI.begin(kPinSclk, kPinMiso, kPinMosi, kPinCs);
  display.begin();
  // This panel's color filter needs the ILI9341 inversion bit set, or every
  // color comes out as its photographic negative (RED<->CYAN, GREEN<->
  // MAGENTA, BLUE<->YELLOW) - confirmed on real hardware.
  tftDriver.setInvertColor(true);

  Wire.begin(kPinTouchSda, kPinTouchScl);
  delay(50);
  Serial.println("I2C scan (touch bus, SDA=16/SCL=15):");
  for (uint8_t addr = 1; addr < 127; addr++) {
    Wire.beginTransmission(addr);
    if (Wire.endTransmission() == 0) {
      Serial.printf("  found device at 0x%02X\n", addr);
    }
  }
  bool touchOk = touchDriver.begin();
  Serial.printf("touch begin(): %s\n", touchOk ? "OK" : "FAILED (no I2C ack from FT6336G at 0x38)");
  display.setTouchDriver(touchDriver);

  showRgbTest();
}

void loop() {
  static bool wasTouched = false;
  static uint32_t lastHeartbeat = 0;
  const bool touched = touchDriver.isTouched();

  if (millis() - lastHeartbeat > 1000) {
    Serial.printf("heartbeat: isTouched()=%d\n", touched);
    lastHeartbeat = millis();
  }

  if (touched) {
    Point p;
    if (touchDriver.getPoint(p)) {
      Serial.printf("touch: x=%d y=%d pressure=%u\n", p.x, p.y, p.pressure);
    } else {
      Serial.println("touch: isTouched() true but getPoint() failed");
    }
  }
  if (touched && !wasTouched) {
    toggleTest();
  }
  wasTouched = touched;
  delay(30);
}