neomatrix_config.h

#ifndef neomatrix_config_h
#define neomatrix_config_h

/* 
Yes, this file is a bit complicated looking, that's because it supports lots
of different hardware backends (listed below). A single define will let you
switch from one backend to another one without changing your code.
If you'd like to see this file (likely out of date somewhat) with a bunch of
defines removed, so it looks more flat, see neomatrix_config_tftonly.h
But this big file is the one I'll maintain instead of maintaining 5 or more
separate files, one per backend, when most of the code/init can be shared
between them.

All backends end up using the same Framebuffer::GFX as the base class
but SmartMatrix is sufficiently different to need its own exceptions and handling
(for one, with SmartMatrix, the buffer is actually handled by SmartMatrix whereas
the other libraries define their own FastLED CRGB buffer (RGB888) ).

Backends you should choose from (define 1):
- FRAMEBUFFER (dumb framebuffer that doens't display anywhere)
- SMARTMATRIX (if you are using the old SMARTMATRIX3, also define SMARTMATRIXV3)
- ILI9341
- ST7735_128b160
- ST7735_128b128
- SSD1331 (96x64 TFT)
- Everything below is NeoMatrix in different patterns:
  M24BY24 M32BY8X3 M16BY16T4 M64BY64 are 4 examples of NEOMATRIX defines
  (3 tiled 32x8, 4 tiled 16x16, and a single zigzag 64x64 array)
- ARDUINOONPC is auto defined by https://github.com/marcmerlin/ArduinoOnPc-FastLED-GFX-LEDMatrix
  - On ARM, we assume rPi and define RPIRGBPANEL
  - Elsewhere, we assume rendering on linux/X11
    - LINUX_RENDERER_X11 is the default with ArduinoOnPc-FastLED-GFX-LEDMatrix
    - LINUX_RENDERER_SDL can be defined in ArduinoOnPc-FastLED-GFX-LEDMatrix's Makefile

// For TFTs, there is original support from adafruit, but https://github.com/moononournation/Arduino_GFX/
// has better and faster support for many TFTs (ILI9341, ST7735*, SSD1331, etc...)
// define ADAFRUIT_TFT if you'd rather have the Adafruit drivers. I don't recommend them anymore.

LEDMATRIX is a separate define you'd set before including this file and
adds the LEDMatrix API if you need it.
The TL;DR is you shouldn't bother with it if you already have the GFX
and FastLED APIs, unless you can use fancy wavy scrolling colored fonts or the
sprite support in LEDMatrix.

You should not need to modify this file at all unless you are adding new matrix
definitions and/or changing pin mappings for TFT screens. To choose which backend
to use, set the define before you include the file.
*/

// vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
// README README README README README README README README README README  README README README README
// If you have never used FastLED::NeoMatrix before, please try these 2 examples first
// https://github.com/marcmerlin/FastLED_NeoMatrix/tree/master/examples/matrixtest
// https://github.com/marcmerlin/FastLED_NeoMatrix/tree/master/examples/MatrixGFXDemo
// For FastLED just uncomment this line below (define M24BY24) and fix the matrix definition
// or use one of the other ones if they are closer ot your setup (M32BY8X3 M16BY16T4 M64BY64.
// For SmartMatrix, just use "#define SMARTMATRIX"
//
// Are all those defines confusing? Then look at neomatrix_config_tftonly.h with all the defines
// taken out and a single backend hardcoded.
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
//#define M24BY24

// If you did not define something above, right here ^^^ the code below will look at the
// chip and do a hardcoded define that works for me, but is unlikely to be what you are also
// using, so really you want to define your driver above, or one will be picked for you and
// it'll probably be the wrong one :)
#if !defined(M24BY24) && !defined(M32BY8X3) && !defined(M16BY16T4) && !defined(M64BY64) && !defined(SMARTMATRIX) && !defined(SSD1331) && !defined(ST7735_128b128) && !defined(ST7735_128b160) && !defined(ILI9341) && !defined(ARDUINOONPC) && !defined(FRAMEBUFFER)
    #ifdef ESP8266
    //#define SSD1331
    //#define SSD1331_ROTATE 1
    // ESP8266 shirt with neopixel strips
    #define M32BY8X3
    //#define M16BY16T4
    #endif

    #ifdef ESP32
    //#define ILI9341
    //#define ST7735_128b160
    //#define ST7735_128b128
    //#define SSD1331
    //#define SSD1331_ROTATE 1
    #define SMARTMATRIX
    //#define M64BY64
    #endif

    // Teensy 3.6
    #ifdef __MK66FX1M0__
    #define ILI9341
    // If instead you are using the old SmartMatrix V3, define those 2
    //#define SMARTMATRIX3
    // And with SmartMatrix (v4), only this define is needed.
    //#define SMARTMATRIX
    #endif

    // Teensy v.4
    #ifdef __IMXRT1062__
    //#define SMARTMATRIX3
    #define SMARTMATRIX
    #endif
#endif

#if defined(ARDUINOONPC)
    // Those defines (including RPIRGBPANEL) come from makeNativeArduino.mk
    #if defined(RPI4)
	#pragma message "Detected ARDUINOONPC on rPi4, RPIRGBPANEL defined and will use FastLED_RPIRGBPanel_GFX"
    #elif defined(RPI3)
	#pragma message "Detected ARDUINOONPC on rPi3, RPIRGBPANEL defined and will use FastLED_RPIRGBPanel_GFX"
    #elif defined(RPILT3)
	#pragma message "Detected ARDUINOONPC on pre-rPi3, RPIRGBPANEL defined and will use FastLED_RPIRGBPanel_GFX"
    #else
	#ifndef LINUX_RENDERER_SDL
	    #pragma message "Detected ARDUINOONPC. Using LINUX_RENDERER_X11 FastLED_TFTWrapper_GFX Rendering"
	    #define LINUX_RENDERER_X11
	#else
	    #pragma message "Detected ARDUINOONPC. Using LINUX_RENDERER_SDL FastLED_NeoMatrix Rendering."
	    #pragma message "Comment out LINUX_RENDERER_SDL for X11 rendering instead of SDL. Use + for brighter."
	#endif
    #endif
#endif



#include <Adafruit_GFX.h>
bool init_done = 0;
uint32_t tft_spi_speed;
#define ARRAY_SIZE(A) (sizeof(A) / sizeof((A)[0]))

// min/max are complicated. Arduino and ESP32 layers try to be helpful by using
// templates that take specific kinds of arguments, but those do not always work
// with mixed types:
// error: no matching function for call to 'max(byte&, int16_t&)'
// These defines get around this problem.
#define mmin(a,b) ((a<b)?(a):(b))
#define mmax(a,b) ((a>b)?(a):(b))

// The ESP32 FastLED defines below must be defined before FastLED.h is loaded
// They are not relevant if you don't actually use FastLED pixel output but cause
// no harm if we only include FastLED for its CRGB struct.
#ifdef ESP32
    // Allow infrared for old FastLED versions
    #define FASTLED_ALLOW_INTERRUPTS 1
    // Newer Samguyver ESP32 FastLED has a new I2S implementation that can be
    // better (or worse) than then default RMT which only supports 8 channels.
    // I'm getting brightness issues on LED strips with I2S when outputting to a matrix too
    //#define FASTLED_ESP32_I2S

    // https://github.com/FastLED/FastLED/blob/master/src/platforms/esp/32/clockless_rmt_esp32.h
    // Trying random options to see if they help with my dual output setup on ESP32
    #define FASTLED_RMT_MAX_CHANNELS 4
    #define FASTLED_ESP32_FLASH_LOCK 1
    #pragma message "Please use https://github.com/samguyer/FastLED.git if stock FastLED is unstable with ESP32"
#endif
#include <FastLED.h>

#ifdef LEDMATRIX
// Please use https://github.com/marcmerlin/LEDMatrix/ at least as recent as
// https://github.com/marcmerlin/LEDMatrix/commit/597ce703e924d45b2e676d6558c4c74a8ebc6991
// or https://github.com/Jorgen-VikingGod/LEDMatrix/commit/a11e74c8cd5b933021b6e15eb067280a52691449
// zero copy/no malloc code to work.
#include <LEDMatrix.h>
#endif


//============================================================================
// Ok, if you're doing matrices of displays, there is also a reasonable chance
// you'll be using SPIFFS or FATFS on flash, or an sdcard, so let's define it
// here (NeoMatrix-FastLED-IR actually also uses this to read a config file)
//============================================================================

// Note, you can use an sdcard on ESP32 or ESP8266 if you really want,
// but if your data fits in built in flash, why not use it?
// Use built in flash via SPIFFS/FATFS
// esp8266com/esp8266/libraries/SD/src/File.cpp
// ESP8266: http://esp8266.github.io/Arduino/versions/2.3.0/doc/filesystem.html#uploading-files-to-file-system
// ESP32: https://github.com/me-no-dev/arduino-esp32fs-plugin
// https://github.com/marcmerlin/esp32_fatfsimage/blob/master/README.md
#if defined(ESP8266)
    #define FS_PREFIX ""
    #include <FS.h>
    #define FSO SPIFFS
    #define FSOSPIFFS
    #if gif_size == 64
        #define GIF_DIRECTORY FS_PREFIX "/gifs64/"
    #else
        #define GIF_DIRECTORY FS_PREFIX "/gifs/"
    #endif
    extern "C" {
        #include "user_interface.h"
    }
#elif defined(ESP32)
    #define FS_PREFIX ""
    //#define ESP32LITTLEFS
    #define ESP32FATFS
    #ifdef ESP32FATFS
        #include "FFat.h"
        #define FSO FFat
        #define FSOFAT
    #elif defined(ESP32LITTLEFS) // Out of tree LITTLEFS for older ESP32 core
        #include "FS.h"
        #include <LittleFS.h>
        #define FSO LittleFS
        #define FSOLITTLEFS
    #else // default LittleFS in newer ESP32 core
        // LittleFS is more memory efficient than FatFS
        #include "FS.h"
        #include <LittleFS.h>
        #define FSO LittleFS
        #define FSOLittleFS
    #endif
    #if gif_size == 64
        #define GIF_DIRECTORY FS_PREFIX "/gifs64"
    #elif gif_size == 32
        #define GIF_DIRECTORY FS_PREFIX "/gifs"
    #else
        #define GIF_DIRECTORY FS_PREFIX "/"
    #endif
#elif defined(ARDUINOONPC)
    #define UNIXFS
    #define FS_PREFIX "/root/NM/"
    #define GIF_DIRECTORY FS_PREFIX "gifs/"
#else
    #define FS_PREFIX ""
    #define FSO SD
    #define FSOSD
    #if defined (ARDUINO)
    #include <SD.h>
    #endif
    // Chip select for SD card on the SmartMatrix Shield or Photon
    // Teensy 3.5/3.6
    #if defined(__MK64FX512__) || defined(__MK66FX1M0__)
        #define SD_CS BUILTIN_SDCARD
    #elif defined(ESP32)
        #define SD_CS 5
    #elif defined (ARDUINO)
        #define SD_CS 15
        //#define SD_CS BUILTIN_SDCARD
    #elif defined (SPARK)
        #define SD_CS SS
    #endif

    // Teensy SD Library requires a trailing slash in the directory name
    #if gif_size == 64
        #define GIF_DIRECTORY FS_PREFIX "/gifs64/"
    #else
        #define GIF_DIRECTORY FS_PREFIX "/gifs/"
    #endif
#endif

//============================================================================
// Matrix defines (SMARTMATRIX vs NEOMATRIX and size)
// You should #define one and only one of them and if you need to edit it,
// edit both the block below and the 2nd block in setup() at the bottom of this file
//============================================================================
//
#if defined(M24BY24)
    #include <FastLED_NeoMatrix.h>
    #define FASTLED_NEOMATRIX

    const uint8_t MATRIXPIN = 13;

    uint8_t matrix_brightness = 64;
    // Used by LEDMatrix
    const uint16_t MATRIX_TILE_WIDTH = 24; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 24; // height of each matrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    CRGB *matrixleds;
    #ifdef LEDMATRIX
    // cLEDMatrix defines
    // Unfortunately LEDMatrix has its own matrix definition that isn't as well documented
    // and easy to use. Look for examples if you need to setup a matrix of matrices.
    cLEDMatrix<MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif

    // MATRIX DECLARATION:
    // Parameter 1 = width of EACH NEOPIXEL MATRIX (not total display)
    // Parameter 2 = height of each matrix
    // Parameter 3 = number of matrices arranged horizontally
    // Parameter 4 = number of matrices arranged vertically
    // Parameter 5 = pin number (most are valid)
    // Parameter 6 = matrix layout flags, add together as needed:
    //   NEO_MATRIX_TOP, NEO_MATRIX_BOTTOM, NEO_MATRIX_LEFT, NEO_MATRIX_RIGHT:
    //     Position of the FIRST LED in the FIRST MATRIX; pick two, e.g.
    //     NEO_MATRIX_TOP + NEO_MATRIX_LEFT for the top-left corner.
    //   NEO_MATRIX_ROWS, NEO_MATRIX_COLUMNS: LEDs WITHIN EACH MATRIX are
    //     arranged in horizontal rows or in vertical columns, respectively;
    //     pick one or the other.
    //   NEO_MATRIX_PROGRESSIVE, NEO_MATRIX_ZIGZAG: all rows/columns WITHIN
    //     EACH MATRIX proceed in the same order, or alternate lines reverse
    //     direction; pick one.
    //   NEO_TILE_TOP, NEO_TILE_BOTTOM, NEO_TILE_LEFT, NEO_TILE_RIGHT:
    //     Position of the FIRST MATRIX (tile) in the OVERALL DISPLAY; pick
    //     two, e.g. NEO_TILE_TOP + NEO_TILE_LEFT for the top-left corner.
    //   NEO_TILE_ROWS, NEO_TILE_COLUMNS: the matrices in the OVERALL DISPLAY
    //     are arranged in horizontal rows or in vertical columns, respectively;
    //     pick one or the other.
    //   NEO_TILE_PROGRESSIVE, NEO_TILE_ZIGZAG: the ROWS/COLUMS OF MATRICES
    //     (tiles) in the OVERALL DISPLAY proceed in the same order for every
    //     line, or alternate lines reverse direction; pick one.  When using
    //     zig-zag order, the orientation of the matrices in alternate rows
    //     will be rotated 180 degrees (this is normal -- simplifies wiring).
    //   See example below for these values in action.
    FastLED_NeoMatrix *matrix = new FastLED_NeoMatrix(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT,
        NEO_MATRIX_BOTTOM + NEO_MATRIX_LEFT +
        NEO_MATRIX_COLUMNS + NEO_MATRIX_ZIGZAG );

//----------------------------------------------------------------------------
#elif defined(M32BY8X3)
    #include <FastLED_NeoMatrix.h>
    #define FASTLED_NEOMATRIX

    #define NUM_LEDS_PER_STRIP 256

    uint8_t matrix_brightness = 64;
    // Used by LEDMatrix
    const uint16_t MATRIX_TILE_WIDTH = 8; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 32; // height of each matrix
    const uint8_t MATRIX_TILE_H     = 3;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<-MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_ZIGZAG_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    // MATRIX DECLARATION:
    // Parameter 1 = width of EACH NEOPIXEL MATRIX (not total display)
    // Parameter 2 = height of each matrix
    // Parameter 3 = number of matrices arranged horizontally
    // Parameter 4 = number of matrices arranged vertically
    // Parameter 5 = pin number (most are valid)
    // Parameter 6 = matrix layout flags, add together as needed:
    //   NEO_MATRIX_TOP, NEO_MATRIX_BOTTOM, NEO_MATRIX_LEFT, NEO_MATRIX_RIGHT:
    //     Position of the FIRST LED in the FIRST MATRIX; pick two, e.g.
    //     NEO_MATRIX_TOP + NEO_MATRIX_LEFT for the top-left corner.
    //   NEO_MATRIX_ROWS, NEO_MATRIX_COLUMNS: LEDs WITHIN EACH MATRIX are
    //     arranged in horizontal rows or in vertical columns, respectively;
    //     pick one or the other.
    //   NEO_MATRIX_PROGRESSIVE, NEO_MATRIX_ZIGZAG: all rows/columns WITHIN
    //     EACH MATRIX proceed in the same order, or alternate lines reverse
    //     direction; pick one.
    //   NEO_TILE_TOP, NEO_TILE_BOTTOM, NEO_TILE_LEFT, NEO_TILE_RIGHT:
    //     Position of the FIRST MATRIX (tile) in the OVERALL DISPLAY; pick
    //     two, e.g. NEO_TILE_TOP + NEO_TILE_LEFT for the top-left corner.
    //   NEO_TILE_ROWS, NEO_TILE_COLUMNS: the matrices in the OVERALL DISPLAY
    //     are arranged in horizontal rows or in vertical columns, respectively;
    //     pick one or the other.
    //   NEO_TILE_PROGRESSIVE, NEO_TILE_ZIGZAG: the ROWS/COLUMS OF MATRICES
    //     (tiles) in the OVERALL DISPLAY proceed in the same order for every
    //     line, or alternate lines reverse direction; pick one.  When using
    //     zig-zag order, the orientation of the matrices in alternate rows
    //     will be rotated 180 degrees (this is normal -- simplifies wiring).
    //   See example below for these values in action.
    FastLED_NeoMatrix *matrix = new FastLED_NeoMatrix(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, MATRIX_TILE_H, MATRIX_TILE_V,
      NEO_MATRIX_TOP     + NEO_MATRIX_RIGHT +
        NEO_MATRIX_ROWS + NEO_MATRIX_ZIGZAG +
        NEO_TILE_TOP + NEO_TILE_LEFT +  NEO_TILE_PROGRESSIVE);

//----------------------------------------------------------------------------
#elif defined(M16BY16T4)
    #include <FastLED_NeoMatrix.h>
    #define FASTLED_NEOMATRIX

    uint8_t matrix_brightness = 64;

    const uint16_t MATRIX_TILE_WIDTH = 16; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 16; // height of each matrix
    const uint8_t MATRIX_TILE_H     = 2; // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 2; // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<-MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_ZIGZAG_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, VERTICAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    FastLED_NeoMatrix *matrix = new FastLED_NeoMatrix(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, MATRIX_TILE_H, MATRIX_TILE_V,
      NEO_MATRIX_BOTTOM     + NEO_MATRIX_RIGHT +
        NEO_MATRIX_COLUMNS + NEO_MATRIX_ZIGZAG +
        NEO_TILE_TOP + NEO_TILE_RIGHT +  NEO_TILE_PROGRESSIVE);

    const uint8_t MATRIXPIN = 13;

//----------------------------------------------------------------------------
#elif defined(M64BY64) // 64x64 straight connection (no matrices)
    #include <FastLED_NeoMatrix.h>
    #define FASTLED_NEOMATRIX

    // http://marc.merlins.org/perso/arduino/post_2018-07-30_Building-a-64x64-Neopixel-Neomatrix-_4096-pixels_-running-NeoMatrix-FastLED-IR.html
    uint8_t matrix_brightness = 128;
    //
    // Used by LEDMatrix
    const uint16_t MATRIX_TILE_WIDTH = 64; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 64; // height of each matrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #define NUM_STRIPS 16
    #define NUM_LEDS_PER_STRIP 256

    CRGB *matrixleds;
    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, VERTICAL_ZIGZAG_MATRIX> ledmatrix(false);
    #endif
    FastLED_NeoMatrix *matrix = new FastLED_NeoMatrix(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT,
        NEO_MATRIX_BOTTOM + NEO_MATRIX_LEFT +
        NEO_MATRIX_COLUMNS + NEO_MATRIX_ZIGZAG );

//----------------------------------------------------------------------------
#elif defined(FRAMEBUFFER)
    #include <Framebuffer_GFX.h>
    uint8_t matrix_brightness = 255;

    #pragma message "Dumb Framebuffer for ESP32 with 64x96 resolution"
    const uint16_t MATRIX_TILE_WIDTH = 64; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 96; // height of each matrix

    // Used by LEDMatrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, -MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    void show_callback() {};
    Framebuffer_GFX *matrix = new Framebuffer_GFX(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, show_callback);


//----------------------------------------------------------------------------
//----------------------------------------------------------------------------
#elif defined(SMARTMATRIX)
    // CHANGEME for ESP32, see MatrixHardware_ESP32_V0.h in SmartMatrix/src
    #define GPIOPINOUT 8
    // This is defined by you before including this file if you are using the old SmartMatrixv3
    #ifdef SMARTMATRIXV3
        #include <SmartLEDShieldV4.h>
        #include <SmartMatrix3.h>
    #else // As of 2020/11, SmartMatrix v4 has a new interface
        // https://community.pixelmatix.com/t/smartmatrix-library-4-0-changes-to-matrixhardware-includes/709/9
        #ifdef ESP32
            // This saves RAM but could make your code unstable if you do Flash + Wifi + PSRAM
            //#define SMARTMATRIX_USE_PSRAM
            #include <MatrixHardware_ESP32_V0.h> // ESP32
        #elif defined( __IMXRT1062__) // Teensy 4.0/4.1
            #include <MatrixHardware_Teensy4_ShieldV4Adapter.h> // Teensy 4 Adapter attached to SmartLED Shield for Teensy 3 (V4)
            //#include <MatrixHardware_Teensy4_ShieldV5.h>        // SmartLED Shield for Teensy 4 (V5)
        #else
            #include <MatrixHardware_Teensy3_ShieldV4.h>        // SmartLED Shield for Teensy 3 (V4)
            //#include <MatrixHardware_Teensy3_ShieldV1toV3.h>    // SmartMatrix Shield for Teensy 3 V1-V3
        #endif
        #include <SmartMatrix.h>
    #endif
    #include <SmartMatrix_GFX.h>
    uint8_t matrix_brightness = 255;

    #ifdef ESP32
    #pragma message "SmartMatrix for ESP32 with 64x32 16 scan panel and 64x96 resolution"
    const uint8_t kPanelType = SMARTMATRIX_HUB75_32ROW_MOD16SCAN;   // use SMARTMATRIX_HUB75_16ROW_MOD8SCAN for common 16x32 panels
    const uint16_t MATRIX_TILE_WIDTH = 64; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 96; // height of each matrix
    #elif defined(__MK66FX1M0__) // my teensy 3.6 is connected to a 64x64 panel
    #pragma message "SmartMatrix for Teensy with 64x64 32 scan panel"
    //const uint8_t kPanelType = SMARTMATRIX_HUB75_32ROW_MOD16SCAN;   // use SMARTMATRIX_HUB75_16ROW_MOD8SCAN for common 16x32 panels
    const uint8_t kPanelType = SMARTMATRIX_HUB75_64ROW_MOD32SCAN;
    const uint16_t MATRIX_TILE_WIDTH = 64; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 64; // height of each matrix
    #elif defined(__IMXRT1062__) // teensy v.4
    const uint8_t kPanelType = SMARTMATRIX_HUB75_64ROW_MOD32SCAN;
    const uint16_t MATRIX_TILE_WIDTH = 64; // width of EACH NEOPIXEL MATRIX (not total display)
    const uint16_t MATRIX_TILE_HEIGHT= 64; // height of each matrix
    #else
    #error Unknown architecture (not ESP32 or teensy 3.5/6 or teensy 4.0, please write a panel config)
    #endif

    // Used by LEDMatrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    /// SmartMatrix Defines
    #define COLOR_DEPTH 24         // known working: 24, 48 - If the sketch uses type `rgb24` directly, COLOR_DEPTH must be 24
    const uint8_t kMatrixWidth =  MATRIX_TILE_WIDTH *  MATRIX_TILE_H;
    const uint8_t kMatrixHeight = MATRIX_TILE_HEIGHT * MATRIX_TILE_V;
    const uint8_t kRefreshDepth = 24;       // known working: 24, 36, 48
    const uint8_t kDmaBufferRows = 2;       // known working: 2-4, use 2 to save memory, more to keep from dropping frames and automatically lowering refresh rate
    const uint8_t kMatrixOptions = (SMARTMATRIX_OPTIONS_FM6126A_RESET_AT_START);      // see http://docs.pixelmatix.com/SmartMatrix for options
    //const uint8_t kMatrixOptions = 0;
    const uint8_t kBackgroundLayerOptions = (SM_BACKGROUND_OPTIONS_NONE);

    SMARTMATRIX_ALLOCATE_BUFFERS(matrixLayer, kMatrixWidth, kMatrixHeight, kRefreshDepth, kDmaBufferRows, kPanelType, kMatrixOptions);
    SMARTMATRIX_ALLOCATE_BACKGROUND_LAYER(backgroundLayer, kMatrixWidth, kMatrixHeight, COLOR_DEPTH, kBackgroundLayerOptions);

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, -MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    void show_callback();
    SmartMatrix_GFX *matrix = new SmartMatrix_GFX(matrixleds, kMatrixWidth, kMatrixHeight, show_callback);

    // Sadly this callback function must be copied around with this init code
    void show_callback() {
    //    memcpy(backgroundLayer.backBuffer(), matrixleds, kMatrixHeight*kMatrixWidth*3);
    //    backgroundLayer.swapBuffers(false);
        backgroundLayer.swapBuffers(true);
        //matrixleds = (CRGB *)backgroundLayer.getRealBackBuffer());
        matrixleds = (CRGB *)backgroundLayer.backBuffer();
        matrix->newLedsPtr(matrixleds);
    #ifdef LEDMATRIX
        ledmatrix.SetLEDArray(matrixleds);
    #endif
        matrix->showfps();
    }

//----------------------------------------------------------------------------
#elif defined(M5STACK)
    #define HAS_TFT

    #include <M5Stack.h>
    #include <FastLED_SPITFT_GFX.h>

    uint8_t matrix_brightness = 255;
    const uint16_t MATRIX_TILE_WIDTH = 320;
    const uint16_t MATRIX_TILE_HEIGHT= 240;
    //
    // Used by LEDMatrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    // M5 gets defined in M5Stack
    FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, mw, mh, &M5.lcd, 100);

//----------------------------------------------------------------------------
#elif defined(ILI9341)
    #define HAS_TFT

    #ifdef ADAFRUIT_TFT
        #include "Adafruit_ILI9341.h"
        #include <FastLED_SPITFT_GFX.h>
    #else
        #define NO_TFT_SPI_PIN_DEFAULTS
        #include <FastLED_ArduinoGFX_TFT.h>
    #endif

    /*  https://pinout.xyz/pinout/spi
    SD1331 Pin	    Arduino	ESP8266		ESP32	ESP32	rPi     rPi
    1 GND                                       VSPI    HSPI	SPI0    SPI1
    2 VCC
    3 SCL/SCK/CLK/D0	13	GPIO14/D5	18	14	BC11/22	BC21/40
    4 SDA/SDI/MOSI/D1	11	GPIO13/D7	23	13	BC10/19	BC20/38
    ---- 2 pins above and MISO are HWSPI, pins below are anything
    ---- RST is not part of SPI, it's an out of band signal to reset a TFT
    ---- This could be wired to the ESP32 EN(reset) pin
    5 RES/RST		9	GPIO15/D8	26	26	BC24
    ---- Data/Command pin is not part of SPI but used to tell the TFT if incoming SPI
    ---- data is actually a command, or pixel data.
    6 DC/A0/RS (data)	8	GPIO05/D1	25	25	BC23
    ---- Cable select chooses which SPI device we're talking to, if there is only
    ---- one, it can be tied to ground. Any pin is fine
    7 CS/SS => GND	10	GPIO04/D2	0	2	BC08

    CS2: 2 => if you have 2 different screens, need 2 CS pins

    ---- MISO is not used to talk to TFTs, but is one of the 3 SPI hardware pins
      MISO		12	GPIO12/D6	19	12	BM11/23	BC19/35
    */

    // this is the TFT reset pin. Some boards may have an auto-reset
    // circuitry on the breakout so this pin might not required but it can
    // be helpful sometimes to reset the TFT if your setup is not always
    // resetting cleanly. Connect to ground to reset the TFT
    #define TFT_RST 26 // Grey
    //#define TFT_RST -1 // Grey, can be wired to ESP32 EN to save a pin
    #define TFT_DC  25 // Purple
    //#define TFT_CS -1 // for display without CS pin
    #define TFT_CS  0 // White can be wired to ground if you only have one device
    #define TFT_CS2 2 // Orange if you have 2 different screens
    
    #define TFT_MOSI 23 // Blue
    #define TFT_CLK  18 // Green
    #define TFT_MISO 19 // Yellow
    #define TFT_BL 15
    #define TFT_SCK TFT_CLK

    #ifdef ADAFRUIT_TFT
        //Adafruit_ILI9341 *tft = new Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_MOSI, TFT_CLK, TFT_RST, TFT_MISO);
        Adafruit_ILI9341 *tft = new Adafruit_ILI9341((int8_t) TFT_CS2, TFT_DC, TFT_RST);
    #else
        // There used to be support for DMA and ESP32 DMA, but it was removed
        // https://github.com/moononournation/Arduino_GFX/commit/3461afcc4288892cea54da1a82ffdfafd68eeac9
        Arduino_DataBus *bus2 = new Arduino_HWSPI(TFT_DC, TFT_CS2);  // 42fps ILI9341 at 80Mhz
        Arduino_ILI9341 *tft = new Arduino_ILI9341(bus2, TFT_RST, 3 /* rotation */);
    #endif
    // It would be great if we could do this, but many programs use size related variables to
    // define static arrays, which required constants
    //uint16_t tftw = tft->width();
    //uint16_t tfth = tft->height();
    const uint16_t tftw = 320;
    const uint16_t tfth = 240;
    const uint16_t mw =   tftw;


    // if you are using ILI9341 on ESP32, the framebuffer does not fit in memory (224KB)
    // If PSRAM is available, it will get used. If not, you need to make the framebuffer
    // smaller than the TFT. One simple way is to have the framebuffer be half the screen
    // size, render what you need in one half, display it, render the other half and then
    // render that.
    // Before you ask "why would I do this, in that case I can just render to the TFT directly"
    // the answer is "yes, you can as long as you are using GFX directly, you can indeed skip
    // the framebuffer, but if you use FastLED/LEDMatrix code that requires a CRGB 24bpp buffer
    // and does transformations like reading the framebuffer and flipping parts of it, you do
    // need the framebuffer and therefore it could make sense to split the screen in two and
    // render each half separately.
    // In my case, I can use LEDText for fancy font rendering not supported by Adafruit's GFX
    // and then display the 24bpp framebuffer on the 16bpp TFT

    #ifdef ESP32
        #ifdef BOARD_HAS_PSRAM
            #pragma message "Compiling for ILI9341 on ESP32 with PSRAM"
            const uint16_t mh = tfth;
        #else
            #pragma message "Compiling for ILI9341 on ESP32 without PSRAM, framebuffer will only be half height"
            const uint16_t mh = tfth/2;
        #endif
    #else
        #pragma message "Compiling for ILI9341. Most chips except teensy 3.6 and better, won't have enough RAM"
        const uint16_t mh = tfth;
    #endif

    // Used by LEDMatrix
    // templates prevents being able to get the screen size at runtime. This is why templates must die
    const uint16_t MATRIX_TILE_WIDTH =  mw;
    const uint16_t MATRIX_TILE_HEIGHT = mh;
    const uint8_t MATRIX_TILE_H     = 1; // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1; // number of matrices arranged vertically
    #ifdef LEDMATRIX
    cLEDMatrix<-MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,  MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif

    // matrixleds is malloced at runtime as there is more memory available once setup runs
    CRGB *matrixleds;
    uint8_t matrix_brightness = 255;

    // create the matrix object, and reset the matrixleds pointer in matrix_setup
    #ifdef ADAFRUIT_TFT
        FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, mw, mh, tft, 0);
    #else
        FastLED_ArduinoGFX_TFT *matrix = new FastLED_ArduinoGFX_TFT(matrixleds, mw, mh, tft);;
    #endif

//----------------------------------------------------------------------------
#elif defined(ST7735_128b128) || defined(ST7735_128b160)
    #define HAS_TFT

    #ifdef ADAFRUIT_TFT
        #include <Adafruit_ST7735.h>
        #include <FastLED_SPITFT_GFX.h>
    #else
        #define NO_TFT_SPI_PIN_DEFAULTS
        #include <FastLED_ArduinoGFX_TFT.h>
    #endif

    /*  https://pinout.xyz/pinout/spi
    SD1331 Pin	    Arduino	ESP8266		ESP32	ESP32	rPi     rPi
    1 GND                                       VSPI    HSPI	SPI0    SPI1
    2 VCC
    3 SCL/SCK/CLK/D0	13	GPIO14/D5	18	14	BC11/22	BC21/40
    4 SDA/SDI/MOSI/D1	11	GPIO13/D7	23	13	BC10/19	BC20/38
    ---- 2 pins above and MISO are HWSPI, pins below are anything
    ---- RST is not part of SPI, it's an out of band signal to reset a TFT
    ---- This could be wired to the ESP32 EN(reset) pin
    5 RES/RST		9	GPIO15/D8	26	26	BC24
    ---- Data/Command pin is not part of SPI but used to tell the TFT if incoming SPI
    ---- data is actually a command, or pixel data.
    6 DC/A0/RS (data)	8	GPIO05/D1	25	25	BC23
    ---- Cable select chooses which SPI device we're talking to, if there is only
    ---- one, it can be tied to ground. Any pin is fine
    7 CS/SS => GND	10	GPIO04/D2	0	2	BC08

    CS2: 2 => if you have 2 different screens, need 2 CS pins

    ---- MISO is not used to talk to TFTs, but is one of the 3 SPI hardware pins
      MISO		12	GPIO12/D6	19	12	BM11/23	BC19/35
    */

    #ifdef ESP32
        #define TFT_RST       26 // Grey
        #define TFT_DC        25 // Purple
        #define TFT_CS         0 // White can be wired to ground if you only have one device
        #define TFT_CS2        2 // Orange if you have 2 different screens
    #elif defined(ESP8266)
        #define TFT_RST       15
        #define TFT_DC         5
        #define TFT_CS         4 // this can be wired to ground if you have one device
        #define TFT_CS2        4
    #else
        #define TFT_RST        9 // Or set to -1 and connect to Arduino RESET pin
        #define TFT_DC         8
        #define TFT_CS         4 // this can be wired to ground if you have one device
        #define TFT_CS2        4
    #endif
    
    #define TFT_MOSI 23 // Blue
    #define TFT_CLK  18 // Green
    #define TFT_MISO 19 // Yellow
    #define TFT_BL 15
    #define TFT_SCK TFT_CLK

    #ifdef ADAFRUIT_TFT
        Adafruit_ST7735 *tft = new Adafruit_ST7735(TFT_CS, TFT_DC, TFT_RST);
        FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, mw, mh, tft, 0);
    #else
        Arduino_DataBus *bus = new Arduino_HWSPI(TFT_DC, TFT_CS);  // 42fps ILI9341 at 80Mhz
        Arduino_ILI9341 *tft = new Arduino_ILI9341(bus, TFT_RST, 0 /* rotation */);
    #endif

    // It would be great if we could do this, but many programs use size related variables to
    // define static arrays, which required constants
    const uint16_t mw = 128;
    #ifdef ST7735_128b128
    const uint16_t mh = 128;
    #else
    const uint16_t mh = 160;
    #endif
    const uint16_t tftw = mw;
    const uint16_t tfth = mh;

    // Used by LEDMatrix
    // templates prevents being able to get the screen size at runtime. This is why templates must die
    const uint16_t MATRIX_TILE_WIDTH =  mw;
    const uint16_t MATRIX_TILE_HEIGHT = mh;
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically
    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<-MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif

    // create the matrix object, and reset the matrixleds pointer in matrix_setup
    CRGB *matrixleds;
    uint8_t matrix_brightness = 255;

    #ifdef ADAFRUIT_TFT
        FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, mw, mh, tft, 0);
    #else
        FastLED_ArduinoGFX_TFT *matrix = new FastLED_ArduinoGFX_TFT(matrixleds, mw, mh, tft);
    #endif


//----------------------------------------------------------------------------
#elif defined(SSD1331)
    #define HAS_TFT

    #ifdef ADAFRUIT_TFT
        #include <Adafruit_SSD1331.h>
        #include <FastLED_SPITFT_GFX.h>
    #else
        #define NO_TFT_SPI_PIN_DEFAULTS
        #include <FastLED_ArduinoGFX_TFT.h>
    #endif

    /*  https://pinout.xyz/pinout/spi
    SD1331 Pin	    Arduino	ESP8266		ESP32	ESP32	rPi     rPi
    1 GND                                       VSPI    HSPI	SPI0    SPI1
    2 VCC
    3 SCL/SCK/CLK/D0	13	GPIO14/D5	18	14	BC11/22	BC21/40
    4 SDA/SDI/MOSI/D1	11	GPIO13/D7	23	13	BC10/19	BC20/38
    ---- 2 pins above and MISO are HWSPI, pins below are anything
    ---- RST is not part of SPI, it's an out of band signal to reset a TFT
    ---- This could be wired to the ESP32 EN(reset) pin
    5 RES/RST		9	GPIO15/D8	26	26	BC24
    ---- Data/Command pin is not part of SPI but used to tell the TFT if incoming SPI
    ---- data is actually a command, or pixel data.
    6 DC/A0/RS (data)	8	GPIO05/D1	25	25	BC23
    ---- Cable select chooses which SPI device we're talking to, if there is only
    ---- one, it can be tied to ground. Any pin is fine
    7 CS/SS => GND	10	GPIO04/D2	0	2	BC08

    CS2: 2 => if you have 2 different screens, need 2 CS pins

    ---- MISO is not used to talk to TFTs, but is one of the 3 SPI hardware pins
      MISO		12	GPIO12/D6	19	12	BM11/23	BC19/35
    */

    #ifdef ESP32
        #define TFT_RST  26 // Grey
        #define TFT_DC   25 // Purple
        #define TFT_CS    0 // White can be wired to ground if you only have one device
        #define TFT_CS2   2 // Orange if you have 2 different screens

        #define TFT_MOSI 23 // Blue
        #define TFT_CLK  18 // Yellow
        #define TFT_MISO 19 // Green

    #else
        // ESP8266 + Teensy?
        #define TFT_RST  15
        #define TFT_DC   5
        #define TFT_CS   4

        // You can use any (4 or) 5 pins
        // hwspi hardcodes those pins, no need to redefine them
        #define TFT_MOSI 13
        #define TFT_CLK  14
    #endif
    #define TFT_SCK TFT_CLK

    #ifdef ADAFRUIT_TFT
        #ifdef ESP32
            // Option 1: use any pins but a little slower
            #pragma message "Using SWSPI"
            Adafruit_SSD1331 *tft  = new Adafruit_SSD1331(TFT_CS, TFT_DC, TFT_MOSI, TFT_CLK, TFT_RST);
            // HWSPI hangs on ESP32 the moment it is run
            // https://github.com/adafruit/Adafruit-SSD1331-OLED-Driver-Library-for-Arduino/issues/27
            //Adafruit_SSD1331 *tft  = new Adafruit_SSD1331(TFT_CS, TFT_DC, TFT_RST);
        #else
            #pragma message "Using HWSPI"
            Adafruit_SSD1331 *tft = new Adafruit_SSD1331(&SPI, TFT_CS, TFT_DC, TFT_RST);
        #endif
    #else
        Arduino_DataBus *bus = new Arduino_HWSPI(TFT_DC, TFT_CS);
        // do not add 4th IPS argument, even FALSE. On the multi-board, it is sensitive to
        // tft_spi_speed, maybe 80Mhz only (24 seems unstable)
        #if SSD1331_ROTATE == 0
        Arduino_SSD1331 *tft = new Arduino_SSD1331(bus, TFT_RST, 0 /* rotation */);
        #else
        Arduino_SSD1331 *tft = new Arduino_SSD1331(bus, TFT_RST, 1 /* rotation */);
        #endif
    #endif

    uint8_t matrix_brightness = 255;
    #if SSD1331_ROTATE == 0
    const uint16_t mw = 96;
    const uint16_t mh = 64;
    #else
    const uint16_t mw = 64;
    const uint16_t mh = 96;
    #endif
    const uint16_t tftw = mw;
    const uint16_t tfth = mh;
    
    // Used by LEDMatrix
    // templates prevents being able to get the screen size at runtime. This is why templates must die
    const uint16_t MATRIX_TILE_WIDTH =  mw;
    const uint16_t MATRIX_TILE_HEIGHT = mh;
    const uint8_t MATRIX_TILE_H     = 1; // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1; // number of matrices arranged vertically


    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<-MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;


    #ifdef ADAFRUIT_TFT
        #if SSD1331_ROTATE == 0
        FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, 96, 64, tft, 0);
        #else
        FastLED_SPITFT_GFX *matrix = new FastLED_SPITFT_GFX(matrixleds, mw, mh, 96, 64, tft, 1);
        #endif
    #else
        FastLED_ArduinoGFX_TFT *matrix = new FastLED_ArduinoGFX_TFT(matrixleds, mw, mh, tft);
    #endif

//----------------------------------------------------------------------------
#elif defined(LINUX_RENDERER_X11)

    #include "TFT_LinuxWrapper.h"
    #include <FastLED_TFTWrapper_GFX.h>

    uint8_t matrix_brightness = 255;
    const uint16_t MATRIX_TILE_WIDTH = 64;
    const uint16_t MATRIX_TILE_HEIGHT= 96;
    //
    // Used by LEDMatrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    TFT_LinuxWrapper *tft = new TFT_LinuxWrapper(MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT);
    FastLED_TFTWrapper_GFX *matrix = new FastLED_TFTWrapper_GFX(matrixleds, mw, mh, tft);

//----------------------------------------------------------------------------
#elif defined(LINUX_RENDERER_SDL)
    #include <FastLED_NeoMatrix.h>

    uint8_t matrix_brightness = 128;
    //
    // Used by LEDMatrix
    // All running 1D neopixel code
    #ifdef NEOPIXEL_STRIP
	#pragma message "Neopixel 1D code"
	const uint16_t MATRIX_TILE_WIDTH =  64; // width of EACH NEOPIXEL MATRIX (not total display)
	const uint16_t MATRIX_TILE_HEIGHT=   1; // height of each matrix
    #else
        #undef gif_size
        #define gif_size 192
        #ifdef GFXDISPLAY_M384BY256
            #pragma message "M384BY256 read from /root/NM/gfxdisplay"
            const uint16_t MATRIX_TILE_WIDTH = 384;
            const uint16_t MATRIX_TILE_HEIGHT= 256;
        #elif GFXDISPLAY_M192BY160
            #pragma message "M192BY160 read from /root/NM/gfxdisplay"
            const uint16_t MATRIX_TILE_WIDTH = 192;
            const uint16_t MATRIX_TILE_HEIGHT= 160;
        #elif GFXDISPLAY_M128BY192
            #pragma message "M128BY192 read from /root/NM/gfxdisplay"
            const uint16_t MATRIX_TILE_WIDTH = 128;
            const uint16_t MATRIX_TILE_HEIGHT= 192;
	#elif GFXDISPLAY_M288BY192_9_3_Zmap_Rot
	    #pragma message "M288BY192_9_3_Zmap_Rot read from /root/NM/gfxdisplay"
	    const uint16_t MATRIX_TILE_WIDTH = 288;
	    const uint16_t MATRIX_TILE_HEIGHT= 192;
	#elif GFXDISPLAY_M288BY192_9_3_Zmap
	    #pragma message "M288BY192_9_3_Zmap read from /root/NM/gfxdisplay"
	    const uint16_t MATRIX_TILE_WIDTH = 192;
	    const uint16_t MATRIX_TILE_HEIGHT= 288;
	#elif GFXDISPLAY_M128BY192_4_3_Zmap
	    #pragma message "M128BY192_4_3_Zmap read from /root/NM/gfxdisplay"
	    const uint16_t MATRIX_TILE_WIDTH = 128;
	    const uint16_t MATRIX_TILE_HEIGHT= 192;
        #elif GFXDISPLAY_M128BY192_4_3
            #pragma message "M128BY192_4_3 read from /root/NM/gfxdisplay"
            const uint16_t MATRIX_TILE_WIDTH = 128;
            const uint16_t MATRIX_TILE_HEIGHT= 192;
        #elif GFXDISPLAY_M64BY96
            #pragma message "M64Y96 read from /root/NM/gfxdisplay"
            const uint16_t MATRIX_TILE_WIDTH =  64;
            const uint16_t MATRIX_TILE_HEIGHT=  96;
        #else
            #pragma message "Please write M384BY256 or equivalent to /root/NM/gfxdisplay (see ../../makeNativeArduino.mk)"
            const uint16_t MATRIX_TILE_WIDTH = 320;
            const uint16_t MATRIX_TILE_HEIGHT= 240;
        #endif
    #endif
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    CRGB *matrixleds;
    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, -MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    FastLED_NeoMatrix *matrix = new FastLED_NeoMatrix(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT,
        NEO_MATRIX_TOP + NEO_MATRIX_LEFT + NEO_MATRIX_ROWS );

//----------------------------------------------------------------------------
#elif defined(RPIRGBPANEL)

    #include <FastLED_RPIRGBPanel_GFX.h>
    // https://github.com/hzeller/rpi-rgb-led-matrix
    // Arduino min/max conflict with g++ math min/max
    #undef min
    #undef max
    #define min(a,b) ((a<b)?(a):(b))
    #define max(a,b) ((a>b)?(a):(b))
    #include <led-matrix.h>
    #undef gif_size
    #define gif_size 192

    uint8_t matrix_brightness = 255;
    #ifdef GFXDISPLAY_M384BY256
        #pragma message "M384BY256 read from /root/NM/gfxdisplay"
        const uint16_t MATRIX_TILE_WIDTH = 384;
        const uint16_t MATRIX_TILE_HEIGHT= 256;
    #elif GFXDISPLAY_M192BY160
        #pragma message "M192BY160 read from /root/NM/gfxdisplay"
        const uint16_t MATRIX_TILE_WIDTH = 192;
        const uint16_t MATRIX_TILE_HEIGHT= 160;
    #elif GFXDISPLAY_M128BY192
        #pragma message "M128BY192 read from /root/NM/gfxdisplay"
        const uint16_t MATRIX_TILE_WIDTH = 128;
        const uint16_t MATRIX_TILE_HEIGHT= 192;
    #elif GFXDISPLAY_M288BY192_9_3_Zmap_Rot
	#pragma message "M288BY192_9_3_Zmap_Rot read from /root/NM/gfxdisplay"
	const uint16_t MATRIX_TILE_WIDTH = 288;
	const uint16_t MATRIX_TILE_HEIGHT= 192;
    #elif GFXDISPLAY_M288BY192_9_3_Zmap
	#pragma message "M288BY192_9_3_Zmap read from /root/NM/gfxdisplay"
	const uint16_t MATRIX_TILE_WIDTH = 192;
	const uint16_t MATRIX_TILE_HEIGHT= 288;
    #elif GFXDISPLAY_M128BY192_4_3_Zmap
	#pragma message "M128BY192_4_3_Zmap read from /root/NM/gfxdisplay"
	const uint16_t MATRIX_TILE_WIDTH = 128;
	const uint16_t MATRIX_TILE_HEIGHT= 192;
    #elif GFXDISPLAY_M128BY192_4_3
	#pragma message "M128BY192_4_3 read from /root/NM/gfxdisplay"
	const uint16_t MATRIX_TILE_WIDTH = 128;
	const uint16_t MATRIX_TILE_HEIGHT= 192;
    #elif GFXDISPLAY_M64BY96
	#pragma message "M64Y96 read from /root/NM/gfxdisplay"
	const uint16_t MATRIX_TILE_WIDTH =  64;
	const uint16_t MATRIX_TILE_HEIGHT=  96;
    #else
        #pragma message "Please write M384BY256 or equivalent to /root/NM/gfxdisplay (see ../../makeNativeArduino.mk)"
        const uint16_t MATRIX_TILE_WIDTH = 128;
        const uint16_t MATRIX_TILE_HEIGHT= 192;
    #endif

    // Used by LEDMatrix
    const uint8_t MATRIX_TILE_H     = 1;  // number of matrices arranged horizontally
    const uint8_t MATRIX_TILE_V     = 1;  // number of matrices arranged vertically

    #ifdef LEDMATRIX
    // cLEDMatrix defines
    cLEDMatrix<MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT, HORIZONTAL_MATRIX,
        MATRIX_TILE_H, MATRIX_TILE_V, HORIZONTAL_BLOCKS> ledmatrix(false);
    #endif
    CRGB *matrixleds;

    FastLED_RPIRGBPanel_GFX *matrix = new FastLED_RPIRGBPanel_GFX(matrixleds, MATRIX_TILE_WIDTH, MATRIX_TILE_HEIGHT);


//============================================================================
#else
    #error "Please write a matrix config or choose one of the definitions above. If you have a FastLED matrix, define M24BY24 at the top of this file"
#endif

//============================================================================
// End Matrix defines (SMARTMATRIX vs NEOMATRIX and size)
//============================================================================

// Compat for some other demos
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wunused-variable"
const uint16_t MATRIX_WIDTH  = MATRIX_TILE_WIDTH *  MATRIX_TILE_H;
const uint16_t MATRIX_HEIGHT = MATRIX_TILE_HEIGHT * MATRIX_TILE_V;

// If the actual display is bigger than the framebuffer (this is needed
// for TFTs which require more FB RAM than you can get on chips like ESP32)
#ifdef HAS_TFT
uint8_t gfx_scale = (tftw*tfth)/(mw*mh);
#else
// Used by NeoMatrix
const uint16_t mw = MATRIX_WIDTH;
const uint16_t mh = MATRIX_HEIGHT;
#endif

// Used by some demos
const uint32_t NUMMATRIX = mw*mh;
const uint32_t NUM_LEDS = NUMMATRIX;

// Compat with SmartMatrix code that uses those variables
// (but don't redefine for SmartMatrix backend)
#ifndef SMARTMATRIX
const uint16_t kMatrixWidth = mw;
const uint16_t kMatrixHeight = mh;
#endif
#pragma GCC diagnostic pop

#ifdef ESP8266
// Turn off Wifi in setup()
// https://www.hackster.io/rayburne/esp8266-turn-off-wifi-reduce-current-big-time-1df8ae
//
#include "ESP8266WiFi.h"
extern "C" {
#include "user_interface.h"
}
#endif // ESP8266

uint8_t gHue = 0; // rotating "base color" used by many of the patterns
uint16_t speed = 255;

float matrix_gamma = 1; // higher number is darker, needed for Neomatrix more than SmartMatrix

// Like XY, but for a mirror image from the top (used by misconfigured code)
int XY2( int x, int y, bool wrap=false) {
    wrap = wrap; // squelch compiler warning
    return matrix->XY(x,MATRIX_HEIGHT-1-y);
}

// FastLED::colorutils needs a signature with uint8_t
uint16_t XY( uint8_t x, uint8_t y) {
    return matrix->XY(x,y);
}
// but x/y can be bigger than 256
uint16_t XY16( uint16_t x, uint16_t y) {
    return matrix->XY(x,y);
}

int wrapX(int x) {
    if (x < 0 ) return 0;
    if (x >= MATRIX_WIDTH) return (MATRIX_WIDTH-1);
    return x;
}

void show_free_mem(const char *pre=NULL) {
    Framebuffer_GFX::show_free_mem(pre);
}

void die(const char *mesg) {
    Serial.println(mesg);
    while(1) delay((uint32_t)1); // while 1 loop only triggers watchdog on ESP chips
}

void *mallocordie(const char *varname, uint32_t req, bool psram=true) {
    // If varname starts with @, show debug for the allocation
    void *mem;

#ifndef BOARD_HAS_PSRAM
    psram = false;
#endif
    if (varname[0] == '@') {
        if (psram) Serial.print("PS");
        Serial.print("Malloc ");
        Serial.print(varname);
        Serial.print(" . Requested bytes: ");
        Serial.println(req);
    }
#ifdef ESP32
    if (psram) {
        mem = ps_malloc(req);
    } else {
        mem = calloc(1, req);
    }
#else
    mem = calloc(1, req);
#endif

    if (mem) {
        return mem;
    } else {
        show_free_mem();
        Serial.println("vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv");
        Serial.print("FATAL: ");
        if (psram) Serial.print("ps_");
        Serial.print("malloc failed for ");
        Serial.print(varname);
        Serial.print(" . Requested bytes: ");
        Serial.println(req);
        Serial.println("^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^");
        while (1); // delay(1);  Adding this seems to cause an ESP32 bug
    }
    return NULL;
}

uint32_t millisdiff(uint32_t before) {
    return((millis()-before) ? (millis()-before): 1);
}

uint16_t text_width(char *text, Adafruit_GFX *gfx = NULL) {
    if (!gfx) gfx = matrix;
    int16_t dummy;
    uint16_t w, h;

    gfx->getTextBounds(text, 0, 0, &dummy, &dummy, &w, &h);
    return(w);
}

uint16_t text_xcenter(char *text, Adafruit_GFX *gfx = NULL) {
    uint8_t fudge = 0;

    if (!gfx) gfx = matrix;
    // workaround for bug in adafruit::gfx that returns a width too large?
    if (gfx->width() == 24) fudge = 2;
    //Serial.print(gfx->width() );
    //Serial.print(" ");
    //Serial.print(text_width(text, gfx));
    //Serial.print(" ");
    //Serial.println((gfx->width() - text_width(text, gfx)) / 2);
    return(fudge + (gfx->width() - text_width(text, gfx)) / 2);
}

void matrix_setup(bool initserial=true, int reservemem = 40000) {
    reservemem = reservemem; // squelch compiler warning if var is unused.

    if (init_done) {
        Serial.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> BUG: matrix_setup called twice");
        return;
    }
    init_done = 1;

    // It's bad to call Serial.begin twice, if your calling script runs it first, make sure
    // you request that it isn't called a 2nd time here.
    if (initserial) {
        Serial.begin(115200);
        Serial.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Serial.begin");
    }

    // Teensy takes a while to initialize serial port.
    // Teensy 3.0, 3.1/3.2, 3.5, 3.6, 4.0+4.1
    // https://docs.platformio.org/en/latest/platforms/teensy.html
    #if defined(__MK20DX128__) || defined(__MK20DX256__) || defined(__MK64FX512__) || defined(__MK66FX1M0__) || defined(__IMXRT1062__)
        delay(3000);
    #endif
    show_free_mem("Memory after setup() starts");

    // Smartmatrix defines the framebuffers itself. Other methods make their own allocation here
    #if !defined(SMARTMATRIX)
        // ESP32 has more memory available for allocation in setup than in global
        // (if this were a global array), so we use malloc here.
        // https://forum.arduino.cc/index.php?topic=647833
        matrixleds = (CRGB *) mallocordie("matrixleds", sizeof(CRGB) * NUMMATRIX, 1);
        // and then fix the until now NULL pointer in the object.
        matrix->newLedsPtr(matrixleds);
        show_free_mem("After matrixleds malloc");
        #ifdef LEDMATRIX
            Serial.println("ledmatrix.SetLEDArray");
            ledmatrix.SetLEDArray(matrixleds);
        #endif
    #endif


    //============================================================================================
    // Matrix Init Start
    //============================================================================================
    #if defined(M24BY24)
        FastLED.addLeds<NEOPIXEL,MATRIXPIN>(matrixleds, NUMMATRIX).setCorrection(TypicalLEDStrip);
        Serial.print("Neomatrix total LEDs: ");
        Serial.print(NUMMATRIX);
        Serial.print(" running on pin: ");
        Serial.println(MATRIXPIN);

    //============================================================================================
    // Example of parallel output
    #elif defined(M32BY8X3)
        // Init Matrix
        // Serialized, 768 pixels takes 26 seconds for 1000 updates or 26ms per refresh
        // FastLED.addLeds<NEOPIXEL,MATRIXPIN>(matrixleds, NUMMATRIX).setCorrection(TypicalLEDStrip);
        // https://github.com/FastLED/FastLED/wiki/Parallel-Output
        // WS2811_PORTA - pins 12, 13, 14 and 15 or pins 6,7,5 and 8 on the NodeMCU
        // This is much faster 1000 updates in 10sec
        // See  https://github.com/FastLED/FastLED/wiki/Parallel-Output for pin definitions
        #ifdef ESP8266
        FastLED.addLeds<WS2811_PORTA,3>(matrixleds, NUMMATRIX/MATRIX_TILE_H).setCorrection(TypicalLEDStrip);
        #else
            FastLED.addLeds<WS2812B,14, GRB>(matrixleds,0*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP).setCorrection(0x333333);
            FastLED.addLeds<WS2812B,12, GRB>(matrixleds,1*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP).setCorrection(0x333333);
            FastLED.addLeds<WS2812B,15, GRB>(matrixleds,2*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP).setCorrection(0x333333);
        #endif
        Serial.print("Neomatrix parallel output, total LEDs: ");
        Serial.println(NUMMATRIX);

    //============================================================================================
    // Serialized (slow-ish) output
    #elif defined(M16BY16T4)
        FastLED.addLeds<NEOPIXEL,MATRIXPIN>(matrixleds, NUMMATRIX).setCorrection(TypicalLEDStrip);
        Serial.print("Neomatrix total LEDs: ");
        Serial.print(NUMMATRIX);
        Serial.print(" running on pin: ");
        Serial.println(MATRIXPIN);

    //============================================================================================
    #elif defined(M64BY64) // 64x64 straight connection (no matrices)
        // https://github.com/FastLED/FastLED/wiki/Multiple-Controller-Examples
        FastLED.addLeds<WS2812B,23, GRB>(matrixleds, 0*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
        #ifdef ESP32
            FastLED.addLeds<WS2812B,22, GRB>(matrixleds, 1*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,27, GRB>(matrixleds, 2*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);   // was 3
            FastLED.addLeds<WS2812B,21, GRB>(matrixleds, 3*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,19, GRB>(matrixleds, 4*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,18, GRB>(matrixleds, 5*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B, 5, GRB>(matrixleds, 6*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B, 4, GRB>(matrixleds, 7*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);

            FastLED.addLeds<WS2812B, 0, GRB>(matrixleds, 8*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B, 2, GRB>(matrixleds, 9*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,15, GRB>(matrixleds,10*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,25, GRB>(matrixleds,11*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,26, GRB>(matrixleds,12*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,14, GRB>(matrixleds,13*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,12, GRB>(matrixleds,14*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);
            FastLED.addLeds<WS2812B,13, GRB>(matrixleds,15*NUM_LEDS_PER_STRIP, NUM_LEDS_PER_STRIP);

            Serial.print("Neomatrix 16 pin via RMT/I2S 16 way parallel output, total LEDs: ");
            Serial.println(NUMMATRIX);
        #endif // ESP32
        matrix_gamma = 2.4; // higher number is darker, needed for Neomatrix more than SmartMatrix

    //============================================================================================
    #elif defined(FRAMEBUFFER)
        Serial.print(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Framebuffer GFX output, total LEDs: ");
        Serial.println(NUMMATRIX);

    //============================================================================================
    #elif defined(SMARTMATRIX)
        matrix_gamma = 1; // SmartMatrix should be good by default.
        matrixLayer.addLayer(&backgroundLayer);
        Serial.print(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> SmartMatrix GFX output, total LEDs: ");
        Serial.println(NUMMATRIX);
        // SmartMatrix takes all the RAM it can get its hands on. Get it to leave some
        // free RAM so that other libraries can work too.
        #ifdef ESP32
            if (reservemem) matrixLayer.begin(reservemem); else matrixLayer.begin();
        #else
            matrixLayer.begin();
        #endif
        matrixLayer.setRefreshRate(240);
        backgroundLayer.enableColorCorrection(true);
        // Quick hello world test
        #ifndef DISABLE_MATRIX_TEST
            Serial.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> SmartMatrix Grey Demo");
            backgroundLayer.fillScreen( {0x80, 0x80, 0x80} );
            // backgroundLayer.swapBuffers();
            delay(1000);
        #endif
        // This sets the neomatrix and LEDMatrix pointers
        show_callback();

    //============================================================================================
    #elif defined(LINUX_RENDERER_X11)
        // Need to init the underlying TFT SPI engine
        Serial.println("ARDUINOONPC LINUX_RENDERER_X11 tft begin");
        tft->begin();
        matrix->fillScreen(LTDC_BLACK);

    //============================================================================================
    #elif defined(LINUX_RENDERER_SDL)
        FastLED.addLeds<SDL, mw, mh>(matrixleds, NUMMATRIX);
        Serial.print("Neomatrix on top of SDL. Please use '+' on numeric keypad for brighter, total LEDs: ");
        Serial.println(NUMMATRIX);

    //============================================================================================
    #elif defined(RPIRGBPANEL)
        Serial.println("Using rpi-rgb-led-matrix");

        rgb_matrix::RGBMatrix::Options defaults;
        defaults.hardware_mapping = "regular"; // or e.g. "adafruit-hat"
        #ifdef GFXDISPLAY_M384BY256
            defaults.rows = 64;
            defaults.cols = 128;
            defaults.chain_length = 4;
            defaults.parallel = 3;
            // 50 is faster but makes the screen dimmer
            defaults.pwm_lsb_nanoseconds = 100;
            // lower color depth definitely helps refresh
            defaults.pwm_bits = 7;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
            // 1 is also an option
            defaults.pwm_dither_bits = 2;
            defaults.led_rgb_sequence = "RBG";
            defaults.panel_type = "FM6126A";
    	    defaults.pixel_mapper_config = "V-mapper";
        #elif GFXDISPLAY_M192BY160
            defaults.rows = 32;
            defaults.cols = 64;
            defaults.chain_length = 5;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 7;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
            defaults.pwm_dither_bits = 2;
            //defaults.led_rgb_sequence = "RBG";
            defaults.panel_type = "FM6126A";
            defaults.pixel_mapper_config = "V-mapper:Z";
        #elif GFXDISPLAY_M128BY192
            defaults.rows = 64;
            defaults.cols = 128;
            defaults.chain_length = 1;
            defaults.parallel = 3;
	    // 100->50: 180Hz to 333Hz refresh
            defaults.pwm_lsb_nanoseconds = 70;
            defaults.pwm_bits = 7;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
	    // or 520Hz with lsb_ns at 50 not 100
	    // but things are 1/3rd as bright so
	    // we go back to 0 for 333Hz with 50ns
            defaults.pwm_dither_bits = 1;
            defaults.led_rgb_sequence = "RBG";
            defaults.panel_type = "FM6126A";
        #elif GFXDISPLAY_M128BY192_4_3_Zmap
            defaults.rows = 32;
            defaults.cols = 64;
            defaults.chain_length = 4;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 7;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
	    // or 520Hz with lsb_ns at 50 not 100
	    // but things are 1/3rd as bright so
	    // we go back to 0 for 333Hz with 50ns
            defaults.pwm_dither_bits = 1;
            //defaults.led_rgb_sequence = "RBG";
            defaults.pixel_mapper_config = "V-mapper:Z;Rotate:90";
        #elif GFXDISPLAY_M128BY192_4_3
            defaults.rows = 32;
            defaults.cols = 64;
            defaults.chain_length = 4;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 7;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
	    // or 520Hz with lsb_ns at 50 not 100
	    // but things are 1/3rd as bright so
	    // we go back to 0 for 333Hz with 50ns
            defaults.pwm_dither_bits = 1;
            //defaults.led_rgb_sequence = "RBG";
            defaults.pixel_mapper_config = "V-mapper;Rotate:90";
        #elif GFXDISPLAY_M288BY192_9_3_Zmap_Rot
            defaults.rows = 32;
            defaults.cols = 64;
            defaults.chain_length = 9;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 6;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
	    // or 520Hz with lsb_ns at 50 not 100
	    // but things are 1/3rd as bright so
	    // we go back to 0 for 333Hz with 50ns
            defaults.pwm_dither_bits = 1;
            //defaults.led_rgb_sequence = "RBG";
	    // Note that rotate is too slow on rPi3
            defaults.pixel_mapper_config = "V-mapper:Z;Rotate:270";
        #elif GFXDISPLAY_M288BY192_9_3_Zmap
            defaults.rows = 32;
            defaults.cols = 64;
            defaults.chain_length = 9;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 6;
	    // Time dithering of lower bits
	    // 2 changes speed from 400Hz (from 160Hz)
	    // or 520Hz with lsb_ns at 50 not 100
	    // but things are 1/3rd as bright so
	    // we go back to 0 for 333Hz with 50ns
            defaults.pwm_dither_bits = 1;
            //defaults.led_rgb_sequence = "RBG";
            defaults.pixel_mapper_config = "V-mapper:Z";
        #else
            defaults.rows = 64;
            defaults.cols = 128;
            defaults.chain_length = 1;
            defaults.parallel = 3;
            defaults.pwm_lsb_nanoseconds = 100;
            defaults.pwm_bits = 7;
            defaults.pwm_dither_bits = 2;
            defaults.led_rgb_sequence = "RBG";
            defaults.panel_type = "FM6126A";
        #endif

        rgb_matrix::RuntimeOptions ropt;
	#ifdef RPI4
	    ropt.gpio_slowdown = 4;
	#else
            ropt.gpio_slowdown = 1;
	#endif
	// stay root (useful for accessing /dev/ttyUSB0 and others)
	ropt.drop_privileges = -1;

        RGBMatrix *rgbmatrix = rgb_matrix::CreateMatrixFromOptions(defaults, ropt);
        while (rgbmatrix == NULL) Serial.println("RGBMatrix did not initialize");
        matrix->setMatrix(rgbmatrix);
        Serial.println("RGBPanel RGBMatrix initialized");

    //============================================================================================
    #elif defined(M5STACK)
        // Need to init the underlying TFT SPI engine
        Serial.println("M5STACK begin");
        M5.begin();
        M5.Power.begin();
        M5.Lcd.fillScreen(BLUE);

    //============================================================================================
    #elif defined(ILI9341)
        // On my test bench, my ILI9341 doesn't like more than 24Mhz, although when wired properly
        // it should run at 80Mhz
        tft_spi_speed = 60 * 1000 * 1000;
        Serial.println("");
        Serial.println("ILI9341 tft begin");
        // Need to init the underlying TFT SPI engine
        tft->begin(tft_spi_speed);
        #ifdef ADAFRUIT_TFT
            // Seems that filllscreen initializes the tft so that it works (setAddrWindow)
            tft->fillScreen(ILI9341_DARKGREY);
        #endif

    //============================================================================================
    #elif defined(ST7735_128b160)
        tft_spi_speed = 40 * 1000 * 1000;
        Serial.println("");
        Serial.println("ST7735_128b160 tft begin");
        Serial.println(">>> If you get no display, try resetting, and removing cross talk between wires or decreasing SPI speed <<<<");
        Serial.println("");
        #ifdef ADAFRUIT_TFT
            // initR calls begin for us but does not allow setting SPI speed (hardcoded in the file)
            tft->initR(INITR_BLACKTAB);
            tft->setSPISpeed(tft_spi_speed);
            // fillScreen below does the job
            //tft->setAddrWindow(0, 0, 128, 160);
            // This is required for the screen to work
            tft->fillScreen(ST77XX_GREEN);
        #else
            tft->begin(tft_spi_speed);
        #endif

    //============================================================================================
    #elif defined(ST7735_128b128)
        tft_spi_speed = 40 * 1000 * 1000;
        Serial.println("");
        Serial.println("ST7735_128b128 tft begin");
        Serial.println(">>> If you get no display, try resetting, and removing cross talk between wires or decreasing SPI speed <<<<");
        Serial.println("");
        #ifdef ADAFRUIT_TFT
            // initR calls begin for us but does not allow setting SPI speed (hardcoded in the file)
            tft->initR(INITR_144GREENTAB);
            tft->setSPISpeed(tft_spi_speed);
            // This is required for the screen to work
            tft->fillScreen(ST77XX_GREEN);
        #else
            tft->begin(tft_spi_speed);
        #endif

    //============================================================================================
    #elif defined(SSD1331)
        // Need to init the underlying TFT SPI engine
        tft_spi_speed = 40 * 1000 * 1000;
        Serial.println("");
        Serial.println(">>> If you get no display, try resetting, and removing cross talk between wires or decreasing SPI speed <<<<");
        Serial.println("");
        tft->begin(tft_spi_speed);
        #ifdef ADAFRUIT_TFT
            Serial.println("SSD1331 tft begin (HWSPI broken on ESP32)");
            tft->setSPISpeed(tft_spi_speed);
            // This is very important, or FastLED_SPITFT_GFX::show will not work.
            // Size is hardcoded by TFT size.
            tft->setAddrWindow(0, 0, 96, 64);
        #endif

    //============================================================================================
    #else
        #error "Undefined Matrix"
    #endif
    //============================================================================================
    // Matrix Init End
    //============================================================================================

    #ifdef HAS_TFT
    Serial.print("TFT configured, resolution: ");
    Serial.print(tftw);
    Serial.print("x");
    Serial.print(tfth);
    Serial.print(". GFX size:");
    Serial.print(mw);
    Serial.print("x");
    Serial.print(mh);
    Serial.print(". GFX Size Ratio: ");
    Serial.print(gfx_scale);
    Serial.print(". Speed: ");
    Serial.print(tft_spi_speed);
    Serial.println(" (80Mhz is fastest but sometimes unstable)");
    #endif

    show_free_mem("Before matrix->begin");
    matrix->begin();
    //show_free_mem("After matrix->begin");

    Serial.print("Setting Brightness: ");
    Serial.println(matrix_brightness);
    #if defined(SMARTMATRIX)
        matrixLayer.setBrightness(matrix_brightness);
    #else
        matrix->setBrightness(matrix_brightness);
    #endif
    Serial.print("Gamma Correction: ");
    Serial.println(matrix_gamma);
    // Gamma is used by AnimatedGIFs and others, as such:
    // CRGB color = CRGB(matrix->gamma[red], matrix->gamma[green], matrix->gamma[blue]);
    matrix->precal_gamma(matrix_gamma);

// LEDMatrix alignment is tricky, this test helps make sure things are aligned correctly
    #ifndef DISABLE_MATRIX_TEST
        #ifdef LEDMATRIX
            Serial.println("LEDMatrix Test");
            ledmatrix.DrawLine (0, 0, ledmatrix.Width() - 1, ledmatrix.Height() - 1, CRGB(0, 255, 0));
            ledmatrix.DrawPixel(0, 0, CRGB(255, 0, 0));
            ledmatrix.DrawPixel(ledmatrix.Width() - 1, ledmatrix.Height() - 1, CRGB(0, 0, 255));

            ledmatrix.DrawLine (ledmatrix.Width() - 5, 4, 4, ledmatrix.Height() - 5, CRGB(128, 128, 128));
            ledmatrix.DrawPixel(ledmatrix.Width() - 5, 4,  CRGB(255, 64, 64));
            ledmatrix.DrawPixel(4, ledmatrix.Height() - 5, CRGB(64, 64, 255));
            matrix->show();
            delay(1000);
        #endif
    #endif

    #ifndef DISABLE_SPEED_TEST
        uint32_t before;
        Serial.println("vvvvvvvvvvvvvvvvvvvvvvvvvv Speed vvvvvvvvvvvvvvvvvvvvvvvvvv");
        #ifdef HAS_TFT
            before = millis();
            for (uint8_t i=0; i<5; i++) {
                tft->fillScreen(0);
                tft->fillScreen(0xFFFF);
            }
            Serial.print("TFT SPI Speed: ");
            Serial.print(tft_spi_speed/1000000);
            Serial.print("Mhz (");
            Serial.print(millisdiff(before));
            Serial.print("ms) Resulting fps: ");
            Serial.println(10*1000 / millisdiff(before));

            before = millis();
            for (uint8_t i=0; i<10; i++) {
              matrix->show(0, 0);
              if (gfx_scale != 1) matrix->show(0, mh);
            }
            Serial.print("Matrix->show() Speed Test: ");
            Serial.print(millisdiff(before));
            Serial.print("ms, fps: ");
            Serial.println(10*1000 / (millisdiff(before)));
            // if only one show() command is run and the whole screen 
            // isn't covered, adjust the scale
            //Serial.println(10*1000 / (millisdiff(before)*gfx_scale));

            before = millis();
            for (uint8_t i=0; i<10; i++) {
              matrix->show(0, 0, true);
              if (gfx_scale != 1) matrix->show(0, mh, true);
            }
            // this bypasses accessing PSRAM but also converting, reading, and
            // writing data in the no PSRAM case.
            Serial.print("Matrix->show() BYPASS Speed Test: ");
            Serial.print(millisdiff(before));
            Serial.print("ms, fps: ");
            Serial.println(10*1000 / (millisdiff(before)));
        #endif // HAS_TFT
        before = millis();
        for (uint16_t i=0; i<5; i++) { 
            matrix->fillScreen(0xFC00);
            matrix->show();
            #ifdef HAS_TFT
                if (gfx_scale != 1) matrix->show(0, mh);
            #endif
            matrix->fillScreen(0x003F);
            matrix->show();
            #ifdef HAS_TFT
                if (gfx_scale != 1) matrix->show(0, mh);
            #endif
        }
        Serial.print("Framebuffer::GFX end to end speed test: ");
        Serial.print(millisdiff(before));
        Serial.print("ms, fps: ");
        Serial.println(10*1000 / (millisdiff(before)));
        // Arduino::GFX ILI9314
        //                     tft/gfx/bypass/copy
        // 40fhz, fps no PSRAM: 25/15/22/14       PSRAM: 25/11/21/8
        // 80fhz, fps no PSRAM: 42/19/33/18       PSRAM: 40/14/32/9 (Arduino_HWSPI)
        // 80fhz, fps no PSRAM: 53/21/38/20 Arduino_ESP32SPI
        // 80fhz, fps no PSRAM: 60/20/34/18 Arduino_ESP32SPI_DMA
        //
        // Adafruit ILI9314 (much slower)
        // 80Mhz: TFT 40fps, NO PSRAM: 32fps, PSRAM show: 12fps
        //
        // Old Adafruit numbers:
        // ST7735_128b160: 80Mhz: TFT153fps, NO PSRAM:104fps, PSRAM show: 45fps
        // ST7735_128b160: 40Mhz: TFT 68fps, NO PSRAM: 56fps, PSRAM show: 32fps
        // ST7735_128b160: 20Mhz: TFT 53fps, NO PSRAM: 45fps, PSRAM show: 29fps
        // ST7735_128b128: 40Mhz: TFT117fps, NO PSRAM: 90fps, PSRAM show: 48fps
        //
        // Arduino::GFX is a lot faster (over 100fps)
        // SSD1331: SWSPI: TFT  9fps, NO PSRAM:  9fps, PSRAM show:  8fps
        Serial.println("^^^^^^^^^^^^^^^^^^^^^^^^^^ Speed ^^^^^^^^^^^^^^^^^^^^^^^^^^");
    #endif // DISABLE_SPEED_TEST
    matrix->fillScreen(0x0000);
    matrix->show();
    #ifdef HAS_TFT
        if (gfx_scale != 1) matrix->show(0, mh);
    #endif


    // At least on teensy, due to some framework bug it seems, early
    // serial output gets looped back into serial input
    // Hence, flush input.
    while(Serial.available() > 0) { char t = Serial.read(); t = t; }
    Serial.println("matrix_setup done");
}
#endif // neomatrix_config_h
// vim:sts=4:sw=4:et