How to Use 2.4 Inch TFT LCD SPFD5408 With Arduino Uno and Mega




About: And an developer that love do projects open source

This Instructable is to know how to work TFT 2.4 with the controller SPFD5408
with the libraries of Adafruit for TFT.

This library is the Adafruit TFT Libraries changed to works in TFT 2.4 shields with the SPFD5408 controller.

Now it is for Uno and Mega, Teensy is on the way...

It is based in the last version of Adafruit, inclusive with buttons features.

The TFT 2.4 is cheap TFT, that generally is from China, without documentation or libraries for it.

I tested some mcufriend shields.

When we try to use the TFT 2.4 with SPFD5408 controller in sketches with Adafruit TFT libraries, several things can happen :

  • White Screen
  • All screen with noise
  • Touch not works or is inverted (coordinate Y)
  • The colors are inverted
  • And other things

After trying for several days trying the solutions I found on the web, and none works 100%. So I decided to do an library specific to this controller.

I changed the Adafruit libraries for TFT: GFX , TFTLCD and TouchScreen. I join all in this one library, the library SPFD5408, to avoid problems with duplicate libraries and enables also have the original library Adafruit ready for use in other projects with another TFT hardware.

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Download the SPFD5408 Library

I made available it in my GitHub .

Please download it in:

Attention: This library is ONLY for SPFD5408 TFT controller

If it not work, and you get a blank screen,

please access this site to help you identify the correct library:

Step 2: Install

Please follow the details in README.

Step 3: First Test - Graphicstest

I modified the Adafruit graphicstest to work.

Please open the folder in spfd5408_graphicstest sketch example.

Upload this to Arduino Uno

Step 4: Test 2 - Tftpaint

TftPaint is a sketch from Adafruit_TFTLCD, is a one simple paint, but important for learning and test the TFT.

I modified this to work.

Please open the folder in spfd5408_tftpaint sketch example

Step 5: Utility - Calibrate

This TFT is with a resistive touch, and need calibration for accurate the touch

I made one sketch to help this process.

Please open the folder in spfd5408_calibration sketch example.
After the run of this program , you have the parameters of calibration to put in your sketch code.

11 People Made This Project!


  • Made with Math Contest

    Made with Math Contest
  • Multi-Discipline Contest

    Multi-Discipline Contest
  • Robotics Contest

    Robotics Contest

189 Discussions


Tip 16 days ago

easy to folow instrunctions, succed very quicly, Nice, wait new projects

haroon naveed

Question 5 months ago

the library in step one


Question 5 months ago on Introduction

Hi, your library works perfectly, thank you very much! Only problem is my screen is 3.5" and 480 by 320 pixels. The images and examples appear short and only in 2.4" format, is there a way to fix this? Thanks


7 months ago

Joao, todo lo grafico me funciona perfecto, pero no funciona el TOUCH.... alguna idea?


Question 9 months ago

my tft is not working in this library.please help me to find the tft library?


1 year ago

Hello ,

I received one month my mcufriend 2.4" screen . I tried a lot of codes and the only one with some results is yours . But I have some issues . I tried the spfd...calibrate code on my UNO . I only get a red screen and then following problems :

avrdude: stk500_recv() : programmer is not responding

avrdude: stk500_getsync() attempt 1 of 10 : not in sync : resp=0xc8

attempt 2 =0x00 , 3 = 0x00 , 4 = 0xe0 and so one ..

Can you help me ?

Thanks a lot


1 year ago

My board arrived today and it looks like the one on your pic except for the silk screen print which simply says 2.4'' TFT LCD SHIELD.
And the ID with LCD_ID test returns 000.
I also found that the touch panel is connected to pins A2, A3, D8, D9.

With this adjustment touch gets recognized but the orientation is still a mess and I haven't found yet how to correct it.


1 year ago on Step 5

How to adjust the backlight at this TFT? Thank you! I think it would be useful to know how to change font type in letters and numbers!


1 year ago

hey, can you help me with this tft display, i have an rotary encoder on pin 0 and pin a5, in serial monitor and tft display used the counter is error while imn't using tft display rotary encoder work fine, can u help me with that problem?


2 years ago

Thank you so much for the post. But I still can't fix the mirrored text and also it occupies only partial screen :/ Can someone help? The below comments din't help :/

1 reply

Reply 1 year ago

I have same problem with HX8347G driver (0x7575)
did have someone solution?


1 year ago

hello everyone

i am using this screen for my project and the problem i am having is that once i touch on the screen and display the next one and try to touch again the screen doesnt recognize what it is basically doing is in the background the initial screen is still present and the touch point is sensing from the 1st screen

i tried using the function "screen.background(0, 0, 0);" but i am getting an error:- 'class TFT' has no member named 'background'

any help would be appreciated ASAP


1 year ago

Everything works fine, thank u soo much ,except when i change the screen rotation (tft.setRotation(3);) touch is not aligned ,touch x and y coordinates are not with the display x,y coordinates ,

how ca i fix this.

1 reply
Akshay KG

2 years ago

Thank you sir, finally i got a right library for it! while i run the "paint" example, i had noticed that the touch plate is not working properly, if i touch at the right corner it is selecting the left corner; how can i fix it?

2 replies
PeterGB66Akshay KG

Reply 2 years ago

Thanks to slava_gll, I tried his tip for editing SPFD5408_TouchScreen.cpp, and for the first time after quite some nights of struggling the touchscreen is working in the correct x-y directions!

So, in SPFD5408_TouchScreen.cpp, change lines 157-164 to:

return TSPoint(y, x, z);

// *** SPFD5408 change -- Begin
// SPFD5408 change, because Y coordinate is inverted in this controller
//return TSPoint(x, 1023 - y, z);
// -- End

NOTE: y and x reversed!


Reply 1 year ago

Thanks a lot Broda

Now my screen work perfectly.

U r genius.


1 year ago

This instructable and your library have been extremely useful. Thanks so much. I've got it all working, but now when I write a new sketch I'm finding I'm having trouble with waitOneTouch(). It appears that several "touches" are being buffered. I notice in the Adafruit_STMPE610 there is a bufferEmpty() function that lets me check the buffer and keep reading until it's empty. But I can't find such a function in the SPFD5408 lib. Any tips would be greatly appreciated. Thanks!

1 reply

Reply 1 year ago

In case this might be helpful to others, I've got this worked out to my satisfaction. I don't quite understand why it works, but if you add a short delay between calls to waitOneTouch() it seems to work normally.