Skip to content

Display Config Table

Calvin Hass edited this page May 15, 2019 · 35 revisions

Overview > Configuring GUIslice >

GUIslice TFT/OLED Display Configuration Table

The following tables provide a list of common displays along with some additional information useful in configuring GUIslice:

  • Example Config: This column provides the filename for the sample configuration that is intended to work with the display. These example configs can be found in the /configs directory. Ultimately, we will instruct GUIslice to use this specific configuration by modifying the GUIslice_config.h file to #include it.
  • Arduino Libs: For Arduino devices, this column provides a list of supporting display / touch libraries that need to be installed in the Arduino IDE Library Manager as the GUIslice Example Configs will expect to load these.

Arduino & Compatible Display Configurations

The following displays are intended to support both Arduino and Arduino IDE-compatible devices (such as ESP8266, ESP-32, Cortex-M, STM32, etc.).

Shields

With shields, the wiring between the microcontroller and the display is hardcoded. Therefore, no additional PIN configurations should be necessary. Please note that many of these GUIslice Example Configurations have not been tested against each shield yet, so some updates are expected to be made in the future. Any user feedback for these would be greatly appreciated.

The file name in the Example Config column indicates which included config file should be selected (by uncommenting the line) in the src/GUIslice_config.h file.

NOTE 2019/02/09: A number of shield configurations will be updated over the next few days. A direct link to the spreadsheet may be provided later.

Manufacturer Model Example Config Arduino Libs Notes
Adafruit 2.8“ TFT Touch Shield for Arduino ard-adagfx-tftlcd-simple TFTLCD-Library
Adafruit_TouchScreen
Not yet supported
Adafruit 2.8“ TFT Touch Shield for Arduino with Resistive Touch Screen ard-shld-adafruit_28_res Adafruit_ILI9341
Adafruit_STMPE610
Adafruit 2.8“ TFT Touch Shield for Arduino w/ Capacitive Touch ard-shld-adafruit_28_cap Adafruit_ILI9341
Adafruit_FT6206_Library
Adafruit Adafruit 1.8“ Color TFT Shield w/ microSD and Joystick - v2 ard-shld-adafruit_18_joy Adafruit-ST7735-Library
Adafruit_Seesaw
Adafruit TFT FeatherWing - 2.4“ 320x240 Touchscreen For All Feathers mult-shld-adafruit_24_feather_touch Adafruit_ILI9341
Adafruit_STMPE610
Adafruit Adafruit TFT FeatherWing - 3.5“ 480x320 Touchscreen for Feathers mult-shld-adafruit_35_feather_touch Adafruit_HX8357_Library
Adafruit_STMPE610
Not yet tested
Adafruit Adafruit Mini Color TFT with Joystick FeatherWing ard-adagfx-st7735-notouch Adafruit-ST7735-Library
Adafruit_Seesaw
Not yet tested
Elegoo Elegoo UNO R3 2.8“ TFT Touch Screen ard-shld-elegoo_28_res MCUFRIEND_kbv
Adafruit_TouchScreen
Waveshare 2.8inch Touch LCD Shield for Arduino ard-shld-waveshare_28_touch HX8347D_kbv
XPT2046_Touchscreen
mcufriend MCUFRIEND 2.4“ TFT shield (UNO/MEGA) ard-shld-mcufriend MCUFRIEND_kbv
mcufriend MCUFRIEND 2.4“ TFT 4-wire Touch shield (UNO/MEGA) ard-shld-mcufriend_4wire MCUFRIEND_kbv
Adafruit_TouchScreen
mcufriend MCUFRIEND 2.4“ TFT XPT2046 Touch shield (UNO/MEGA) ard-shld-mcufriend_xpt2046 MCUFRIEND_kbv
XPT2046_Touchscreen
Seeedstudio 2.8“ TFT Touch Shield v2.0 ard-adagfx-ili9341-simple Adafruit_ILI9341
Adafruit_TouchScreen
Not yet tested
M5stack M5stack (ESP32) esp-shld-m5stack M5stack Support 3 buttons
TTGO TTGO T4 BTC Ticker (ESP32) esp-shld-ttgo_btc_ticker Adafruit_ILI9341
Generic 3.5“ TFT LCD Shield ard-shld-generic1_35_touch MCUFRIEND_kbv
Adafruit_TouchScreen

Breakout Boards

With breakout boards, the wiring between the microcontroller and the display is up to the user. Therefore, the pin settings in the configuration file’s SECTIONs 2 & 4A must be changed to match your setup.

Manufacturer Model Example Config Arduino Libs Notes
Adafruit 2.8“ TFT LCD with Touchscreen Breakout Board w/MicroSD Socket - ILI9341 ili9341-simple Adafruit_ILI9341
Adafruit_TouchScreen
Adafruit 2.8“ TFT LCD with Cap Touch Breakout Board w/MicroSD Socket ili9341-ft6206 Adafruit_ILI9341
Adafruit_FT6206_Library
Adafruit 3.5“ TFT 320x480 + Touchscreen Breakout Board w/MicroSD Socket - HXD8357D hx8357-simple Adafruit_HX8357_Library
Adafruit_TouchScreen
Adafruit 3.2“ TFT LCD with Touchscreen Breakout Board w/MicroSD Socket - ILI9341 ili9341-notouch Adafruit_ILI9341
Adafruit_TouchScreen
Adafruit 1.8“ Color TFT LCD display with MicroSD Card Breakout - ST7735R st7735-notouch Adafruit-ST7735-Library
Adafruit Adafruit 2.4“ TFT LCD with Touchscreen Breakout w/MicroSD Socket - ILI9341 ili9341-simple Adafruit_ILI9341
Adafruit_TouchScreen
Adafruit 2.2“ 18-bit color TFT LCD display with microSD card breakout ili9341-notouch Adafruit_ILI9341
Adafruit Adafruit 1.44“ Color TFT LCD Display with MicroSD Card breakout - ST7735R st7735-notouch Adafruit-ST7735-Library
Adafruit Adafruit 0.96“ 160x80 Color TFT Display w/ MicroSD Card Breakout - ST7735 st7735-notouch Adafruit-ST7735-Library
Adafruit Adafruit 1.54“ 240x240 Wide Angle TFT LCD Display with MicroSD - ST7789 st7789-notouch Adafruit-ST7735-Library
Adafruit 2.2“ 18-bit color TFT LCD display with microSD card breakout - HX8340BN hx8340-notouch Adafruit-HX8340B Not yet supported
Adafruit 2.8“ 18-bit color TFT LCD with touchscreen breakout board - ILI9325 tftlcd-simple TFTLCD-Library
Adafruit_TouchScreen
Not yet supported
EastRising LCD 3.5" 320x480 TFT Display Module esp-tftespi-default-xpt2046 TFT_eSPI XPT2046_Touchscreen
PJRC Color 320x240 TFT Touchscreen, ILI9341 Controller Chip teensy-adagfx-ili9341-xpt2046 Adafruit_ILI9341
PaulStoffregen/XPT2046
Teensy 3.2
PJRC Color 320x240 TFT Touchscreen, ILI9341 Controller Chip teensy-adagfx-ili9341-xpt2046-audio Adafruit_ILI9341
PaulStoffregen/XPT2046
Teensy 3.2 + Audio board
PJRC Color 320x240 TFT Touchscreen, ILI9341 Controller Chip teensy-adagfx-ili9341_t3-xpt2046 PaulStoffregen/ILI9341_t3
PaulStoffregen/XPT2046
Teensy 3.2
PJRC Color 320x240 TFT Touchscreen, ILI9341 Controller Chip teensy-adagfx-ili9341_t3-xpt2046-audio PaulStoffregen/ILI9341_t3
PaulStoffregen/XPT2046
Teensy 3.2 + Audio board
Adafruit Monochrome 0.96“ 128x64 OLED graphic display ssd1306-notouch Adafruit_SSD1306
Adafruit Monochrome 1.3“ 128x64 OLED graphic display ssd1306-notouch Adafruit_SSD1306
Adafruit Monochrome 128x32 SPI OLED graphic display ssd1306-notouch Adafruit_SSD1306
Adafruit Monochrome 128x32 I2C OLED graphic display ssd1306-notouch Adafruit_SSD1306
Adafruit OLED Breakout Board - 16-bit Color 1.5“ w/microSD holder ssd1351-notouch Adafruit-SSD1351-Library Not yet supported
Adafruit OLED Breakout Board - 16-bit Color 0.96“ w/microSD holder ssd1331-notouch Adafruit-SSD1331-OLED-Driver-Library-for-Arduino Not yet supported
Adafruit OLED Breakout Board - 16-bit Color 1.27“ w/microSD holder ssd1351-notouch Adafruit-SSD1351-Library Not yet supported
Adafruit Monochrome 2.42“ 128x64 OLED Graphic Display Module Kit ssd1305-notouch Adafruit_SSD1305_Library Not yet supported
Adafruit Monochrome 1.54“ 128x64 OLED Graphic Display Module Kit ssd1305-notouch Adafruit_SSD1305_Library Not yet supported
Adafruit Monochrome 2.7“ 128x64 OLED Graphic Display Module Kit ssd1325-notouch Adafruit_SSD1325_Library Not yet supported
Adafruit Monochrome 2.3“ 128x32 OLED Graphic Display Module Kit ssd1305-notouch Adafriut_SSD1305_Library Not yet supported
Adafruit/Nokia Nokia 5110/3310 monochrome LCD + extras pcd8544-notouch Adafruit-PCD8544-Nokia-5110-LCD-library

Raspberry Pi Display Configurations

Manufacturer Model Example Config Resolution
Adafruit PiTFT 2.8“ TFT 320x240 + Capacitive Touchscreen for Raspberry Pi rpi-sdl1-default-tslib 240x320
Adafruit Adafruit PiTFT Plus 320x240 2.8“ TFT + Capacitive Touchscreen rpi-sdl1-default-tslib 240x320
Adafruit PiTFT Plus Assembled 320x240 2.8“ TFT + Resistive Touchscreen rpi-sdl1-default-tslib 240x320
Adafruit Adafruit PiTFT - 320x240 2.8“ TFT+Touchscreen for Raspberry Pi rpi-sdl1-default-tslib 240x320
Adafruit PiTFT - Assembled 480x320 3.5“ TFT+Touchscreen for Raspberry Pi (coming soon) 480x320
Adafruit PiTFT Plus 320x240 3.2“ TFT + Resistive Touchscreen (coming soon) 320x240
Adafruit Adafruit PiTFT 2.4“ HAT Mini Kit - 320x240 TFT Touchscreen (coming soon) 320x240
Adafruit Adafruit PiTFT 2.2“ HAT Mini Kit - 320x240 2.2“ TFT - No Touch (coming soon) 320x240
**
Adafruit Adafruit PiOLED - 128x32 Monochrome OLED Add-on for Raspberry Pi (coming soon) 128x32
Adafruit Adafruit 128x64 OLED Bonnet for Raspberry Pi (coming soon) 128x64
Clone this wiki locally
You can’t perform that action at this time.