Skip to content
Support for SPI driven TFT screens supported by Adafruit::GFX (like SSD1331 or ILI3941)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

FastLED_SPITFT::GFX, TFT Screens Like SSD1331, ST7735, or ILI9341 with Adafruit GFX and FastLED APIs

Blog post with more pictures/details:

Adafruit_GFX and FastLED-compatible library for TFT displays like SSD1331 or ILI9341.

Adafruit provides basic GFX support for them, but this library maps a FastLED RGB888 (24bit) framebuffer onto those chips (downsampling to 16bit RGB565 color resolution as needed), as well as allows rotating the display when it's not supported like for SSD1331.


SSD1331 (96x64) vs ST7735 (128x128) vs ST7735 (160x128) vs ILI9341 (320x240): image (note that the ESP32 was sending ST7735 160x128 SPI which didn't work at all on SSD1331 and not quite on the ILI screen which requires its own protocol)

This is the same 96x64 display and demo between a P3 RGBPanel and an SSD1331: image

The big thing to note is that this library has to store the entire framebuffer in memory, so you'll need a processor with more RAM (like ESP8266, ESP32, Teensy, etc...), but then you benefit from having the entire framebuffer in memory which is used for code that apply transformations to the entire framebuffer like fading or rotations. details the 3 APIs available to you and why you'd want to use this layer on top of the SSD1331 driver.
Similarly this driver works great with ST7735 based TFTs (128x128 or 128x160). It does also work with ILI9341, but memory becomes an issue as the framebuffer uses 225KB of RAM which only fits on a teensy 3.5/3.6 for me (too big for ESP32) and leaves very little room to run other code.

This library requires FastLED and Adafruit_GFX libraries as well as this base class library:

You can find a lot of demo code here: as well as a big integrated demo here:

This library requires one of:

and these:

You can’t perform that action at this time.