60fps on an SPI display using the Raspberry Pi and fbcp-ili9341 (includes fix for 320x240 ST7789)

[@GoldenGrenadier]

This guide helped immensely! My only issue was that my display's controller was an ST7789V and not an ST7789. For anyone else struggling with an ST7789V, you can simply use -DST7789VW=ON instead of -DST7789=ON. Unfortunately, Genesis/Mega drive emulation doesn't have enough CPU cycles left over to run at full speed on a pi zeroW.

[@RazielMoesch]

I followed the guide and tried the same thing but its not working please help me.

[@somewhatunderstandable4373]

It actually worked for me. Just Changed the -DST7735R=ON to -DILI9341=ON for my specific board. Thank you so much. I tried several other guides/videos, but this one worked for me in 2020. Good luck everyone!

[@ScottMarley]

Good to know, I hope you make something cool with it!

[@allenwong3221]

Thanks so much for your detailed instructions. It really works! When I saw the screen on the tft, I was so happy. : )

[@ScottMarley]

I must admit I was blown away when I saw it working for the first time, I didn't really think it was possible!

[@VTXHobbies]

@@ScottMarley hello its scott manly

[@ScottMarley]

@@VTXHobbies fly safe ;)

[@willashland4597]

When sonic first came out and I was in elementary school, I never dreamed it would end up being emulated on a computer that fits in your pocket. Back when the Sega Genesis came out, cell phones weren't even a thing yet. Now, there are computers that are tiny and can play any game from multiple systems, and for not too much money :)

[@greglilly3866]

Dude!! I have a waveshare 2" SPI based on the ST7789V. After following the manufacturers instructions to install all the software... I had the shifted screen issue (video starts shifted to the right). Looked all over the place for a solution and stumbled across your video. I followed your instructions but just edited the "st7789.cpp" as waveshare has a patch that takes care of the native screensize resolution. Anyway... rebuilt according to your excellent instructions and restarted my pi. Works beautiful!!! 😉😊 Thanks for the excellent information!

[@RazielMoesch]

I followed the guide and tried the same thing but its not working please help me.

[@TheDARKSOMBAX]

Same here, couldn't make it work for st7789v but im using orangepi

[@emmamarx9284]

Thanks! This def gave me a good understanding of how this all works!

[@quinbuchanan8991]

Hey scott, Ive got a similar display (waveshare 2.8 inch 320x240), doing same as you seems to give a corrupt output somehow. Ive tried a few differnt clock divisor values and none seem to make a difference really. Thanks in advance.

[@maartenvantongeren4153]

Thank you just followed your steps i just was hoping for terminal and its giving me desktop on kali diddnt expect that to work WOW

[@rayandamas2894]

I have no idea of what actually happened but the video was amazing, Like it.

[@ScottMarley]

Thank you!

[@thesimpleeastern]

I learned about that ssh thing that I didn't know before from your video. Have a like from me for that.

[@ScottMarley]

Cheers, it's really useful in situations like this where you're messing with the display or if you don't have it plugged into a display at all. Glad you found it useful!

[@wskinnyodden]

Hmmm, do you know of a similar library for these screens (have a couple ili9341 but also have a 640x480 4" one) that works on the Arduino Mega 2560 and/or the Mega DUE? Want to use either the 2560 or the DUE as an touchscreen input device on another project but definitely need it to be able to draw WAY faster than it currently does...

[@azmax623]

Well, it's a good video to get it going, but I'm using a bunch of those pins for a PLC controlled sign, so it looks like no local screen for me :(

[@ds2kx]

Failed to open VideoCore kernel mailbox! when we launch driver (even in SUDO). solutions ?

[@lukasadelbrecht8276]

Hey :) Thank you for this video! Do you think the lib could also work with other SBCs? I have an OrangePi Zero

[@ScottMarley]

This library is specifically for the rpi, but as both this and the orangepi can be Debian based it might be possible to port it. You are best asking this on the fbcp-ili9341GitHub page.

[@lukasadelbrecht8276]

@@ScottMarley thank you for your quick answer! I will do that :)

[@puudogp1850]

Earned my subscribe and like thanks man, I used a Hat version of the LCD but with this guide with the Read me from the Gethub repository were up and running. Quick question what do I adjust to make this full screen seems I have a black bar on top and bottom. This is a 1.44x1.44 running retro pi on a pi zero...

[@Chao5uns1]

When I make it it says: "taking address of packed member of 'SPITask' may result in unaligned pointer value

[@ahizarlopez2899]

the must useful tutuorial, THANKS!

[@rafaoli9918]

Hello i seem toi have a problem my screen turns on with the top white and bottom part have a lot of colors kindal ike the ancient screens what could this be?

[@josephstewart9518]

I'm having a problem with the waveshare 2" spi tft where the display is offset about 1/3 - ideas?

[@064_anuragverma8]

Hey! I Wanted TO Ask If You Can Make A Detailed Video On ST7735(1.8") display

[@DavidKK4GAF]

I got my 2.2 display to work on a Pi 4. But the display is mirrored. How can I flip the image 180 left to right?

[@ScottMarley]

You can do this, see this forum post forums.raspberrypi.com/viewtopic.php?f=91&t=132077#p880827. If using 0x10000 doesn't work, try 0x20000 instead

[@lewissmith9727]

Really helpful video thank you

[@ScottMarley]

Thanks chap!

[@Bannerz]

Great video! I got the screen working but I seem to have an offset of around 16 to 20 pixels. Its like a black border and shifts everything to the right. I can't seem to find any setting to fix this, any ideas?

[@ameliabuns4058]

damn this is impressive

[@ScottMarley]

Cheers dude, big thanks to juj on GitHub for providing the library!

[@pinobarbareschi6452]

hi brother but does this guide also apply to ILI9431 3.5 inch TFT display?

[@griffinbrooks6748]

how do i SSH into my pi? ( i have a windows 10 pc, w ethernet connection for wifi )

[@forestg6777]

Hi, is it possible to make a tutorial with recalbox ?

[@terrellmaryland12345]

Hey I completely new to the hobby, I mean newborn new!! I don’t understand what most of this means… I have a question hopefully somebody can steer my in the right direction, So I want to take one a these small screens and put a loop on it.. but I want to encase it in something very slim like the size of a box of cards.. is there a screen or a way that I can do that?

[@kamilek95]

What can i do, when i have same lagging problem with ili9341 screen? can someone help me?

[@jesusvasquez4381]

THANK YOU SOO MUCH. its works 2022

[@YamShargil]

Amzing video! I am looking to show regular Raspberry Pi OS GUI on a 240x240 round lcd with GC9A01 controller. Didn't manage do to it... Any ideas were to look? Thanks :)

[@ScottMarley]

Sorry, I'm not an expert on this stuff. Just figured out what I needed to do!

[@RuiNunesDev]

Does anyone know if/how video playback performs? in something like kodi or libreelec?

[@ScottMarley]

I haven't tried it myself. I don't see why it wouldn't work though, as the library basically just mirrors whatever would normally go out via the hdmi port. It's at least 60fps and runs with no discernable lag on video games. Would be interested if you get it to work or not!

[@JayzZenOmni]

Hey guys u have a Pi Zero 2w and i think i did the installation right also specifying my screen cotroller but i cant figure out the pinout, can anyone help

[@0Mindmachine0]

any news?

[@ramimehyar481]

Amazing! Many thanks, Do you think it is possible to let Raspberry Pi run an Eink display as a driver and a host at the same time? or should I build a driver MCU separate for the display and control it with the SPI on the GPIO's?

[@ScottMarley]

You can use the SPI pins to drive an eink display, something like www.amazon.co.uk/1-54inch-Display-Module-Resolution-Two-Color/dp/B07Q6V93HQ/. No point using the driver I used here, as your not getting more than about 1fps from an eink screen regardless of how fast you drive it!

[@jedandecko5585]

Hi, great tutorial. Do you think you can achive 30fps from some MCU like esp32, at least for video? Thank you for sharing.

[@ScottMarley]

Thank you! The library only works on the RPi so you won't be able to use it on the ESP32. However I have seen some really smooth animation etc from the ESP32 on similar displays, this for example; kzbin.info/www/bejne/jaLPZYqKpbWljdU. Regarding video, if the MP4 was on an SD card I don't know that it would be decoded fast enough for 30fps display. Here is someone who has done video, but the MP4 has to be converted to a dat file first github.com/MhageGH/esp32_ST7735_Movie. Let me know if you manage to get this to work!

[@jedandecko5585]

@@ScottMarley Thank you for your help, soon as I got some time, ill try to implement it and see what fps I can achive. Ill post here if I manage to do anything, programing is my weak spot :)

[@adriang.4628]

Howdy, I get a "Please specify which display controller to use on command line to CMake!" error. How can I specify the display controller? Here is the command I am running: ""cmake -DHX8357D=ON -DGPIO_TFT_DATA_CONTROL=25 -DGPIO_TFT_RESET_PIN=24 -DSPI_BUS_CLOCK_DIVISOR=10 -DSTATISTICS=0 .."" so the back of my screen says HX8357D so I assume that is the driver or controller right? how to fix?

[@adriang.4628]

well I went into the Cmakelists.txt and saw there was an ADAFRUIT_HX8357D_PITFT so I will use that if not then I'll do what you did and edit the text files

[@ScottMarley]

@@adriang.4628 Yes, definitely give that a go. You might also want to open an issue in GitHub. The readme.md says that you can use -DHX8357D=ON but there is no code in CMakeLists.txt to check for that build option. Must have been an oversight.

[@ScottMarley]

At first glance, it looks like editing CMakeLists.txt to add the HX8357D should be straightforward, use the other entries as an example.

[@Go_Digital_Gr]

Can that display works if I install android on a pi 4?

[@ScottMarley]

I don't have one to test, but I believe this library does work on the RPi4

[@OndrejPopp]

6:41 actually what you did here is to replace 320 - DISPLAY_WIDTH for zero. So, setting DISPLAY_WIDTH to 320 will do the same thing...

[@harmanndhiman9492]

Does this work with raspbian? Oh nvm u explained it really well!!

[@lrios4403]

Ye just tested it

[@JKiel-de1kt]

I tryed to run it on the "240x240, General 1.3inch LCD display Module, IPS, HD" from Waveshare and only get a blackscreen (back lite is on) How could I find out whats wrong?

[@ScottMarley]

There are so many things that can make this not work! The 240x240 from adafruit (which I believe is the same screen) definitely does work, so you might have to keep trying. Double check all your pin connections, and the cmake command should be something like this: -DST7789=ON -DGPIO_TFT_DATA_CONTROL=5 -DGPIO_TFT_RESET_PIN=6 -DSPI_BUS_CLOCK_DIVISOR=8 .. (don't forget the two dots on the end!) providing you have reset on pin 31 and dc on pin 29. Try increasing -DSPI_BUS_CLOCK_DIVISOR=8 to =40 or something. See if it works at all. If all else fails, you can ask on the github page for help there.

[@JKiel-de1kt]

@@ScottMarley because of the strange pin labeling of the screen i connected it wrong, but now its running. Thx :)

[@ivanravenski]

@@JKiel-de1kt hey bud how did you wire the wave share im cofnused because there is no mosi or miso only CS DIN etc

[@JKiel-de1kt]

@@ivanravenski Jo, thats why I was confused too.... Here you are: purple/vcc = 1 white/GND = 6 green/DIN = 19 orange/CLK = 23 yellow/CS = 24 blue/DC = 18 brown/RST = 22 grey/BL = unused

[@Shelf7840]

Can I use two ST7789 with this library at the same time?

[@ScottMarley]

I have no idea but I'd guess probably not!

[@cjlowe1650]

When I do the cmake is says "You need a project name" Any ideas?

[@ScottMarley]

No idea. I just followed the github instructions carefully and it worked out for me. Sorry!

[@inspiredtiny]

Awesome tutorial Sir! My problem is that I have an ILI9341 2.8" TFT SPI 240x320.. but it is not like yours which is ST7789.. what I have has TJCTM24028-SPI written at the back.. After following the steps in you video the screen is output is a mirror image of what should be displayed.. 😔 I will look at juj link and see if there is a way this TFT display will work with some hacks.. thanks!

[@ScottMarley]

You can definitely mirror it in software, although I've forgotten how... I'll have a look later and see if I can remember!

[@ScottMarley]

Got it, you can mirror the display by adding either display_rotate=0x10000 for a horizontal flip or display_rotate=0x20000 for a vertical flip to /boot/config.txt. From www.raspberrypi.org/forums/viewtopic.php?t=120793#p816458 Hope that helps

[@FixationwithCarnage]

can you compile this with retropie instead of having to compile it inside of retropie?

[@sanuga_dinhas]

Hi can i please have the whole code for this project

[@ScottMarley]

I can't give you a single piece of code that makes this work. How you configure everything depends on the exact SPI screen you have. Download and write retropie to a MicroSD, make sure it works fine over HDMI. Then follow the instructions on this video and the GitHub page for the spi driver, to set up the spi screen. Links are in the description.

[@stan6458]

Is there a cpu performance impact using this display?

[@ScottMarley]

Yes, as the CPU has to keep pushing data to the BM2835 chip, the GPU is not used at all for SPI screens (afaik). I don't think I ever checked how much of an impact it had, as the CPU was still plenty fast enough for what I was doing with it.

[@Jalecko]

im using a wavehare board with a ssd1351 but it doesnt wanna boot after rebooting

[@ScottMarley]

There are many things that can go wrong here, have you closely followed the instructions on the GitHub page? Have you set the -DSSD1351=ON directive? Have you started with -DSPI_BUS_CLOCK_DIVISOR set to somethhing high like 60 and see if that works? Are you certain that all your connections are correct, and that -DGPIO_TFT_DATA_CONTROL and -DGPIO_TFT_RESET_PIN are set correctly using the BCM pin numbers? If you're still stuck, I advise posting on the GitHub page for further help, but when you do, mak sure you are very specific and give all of your connections, compilation arguments, hardware info, exactly what you have tried etc or people won't be able to help.

[@KineticEgg]

was writing a little retropie acttacy screen.. but after seeing this do you think this will work with the PiMoroni Breakout Garden 1.54 240x240 SPI display?

[@ScottMarley]

I have no idea, it depends on wether the display driver chip for that screen is supported by the library. So you'll have to find out what the driver chip is.

[@ScottMarley]

Actually just looked and it's the ST7789 so in theory it should work.

[@KineticEgg]

@@ScottMarley thanks for the quick reply.. suppose the only way to find out is to muck around with it.. Cheers 🖖

[@KineticEgg]

@@ScottMarley sadly looks like it won't work using a breakout garden thanks to BCM 9 for data.. oh well.. out comes the bread board

[@ScottMarley]

@@KineticEgg oh I see, I'd never heard of breakout garden before. Looks a bit like that qwik system or seeeds grove stuff. I generally prefer breadboards anyway ;) have fun!

[@cjlowe1650]

I tried the Waveshare (it's the version I have, (2in) and it has errors all over the place). Someone PLEASE HELP!

[@ScottMarley]

Try posting here and see if anyone can help github.com/juj/fbcp-ili9341/issues

[@MikeNugget]

Nice video. Should LCD show Pi's terminal after reboot?

[@ScottMarley]

Not immediately, but once the library has loaded. Did you follow the instructions to make it load on boot?

[@MikeNugget]

@@ScottMarley thanks for the answer. Yes I did, of course. I will figure out the problem and leave comment ;)

[@kamran_aghlami]

Hello, thanks for the video I have a question, does v-sync work in this kind of setup? or are you having variable refresh rate depending how many frames you push into the screen? do these kind of displays suffer from screen tearing?

[@ScottMarley]

The short answer is that no, vsync doesn't work as SPI screens have no idea what vsync is. The long answer along with some ways to mitigate it can be found here github.com/juj/fbcp-ili9341/blob/master/README.md#about-tearing

[@griffinbrooks6748]

will this work on pi zero 2 as well or only pi zero, 1, 2, 3, 4, etc.

[@thomaspritchard2449]

did you ever find this found? trying to figure it out myself

[@cheat_steve10]

I have a screen with the same PINs exept TFCS. Do i need to do anything different?

[@ScottMarley]

TFCS is the same as CS on mine. TFCS is the chip select line for the TFT, SDCS is the the chip select for the SD card if your screen has one.

[@cheat_steve10]

So my screen has only a screen, no sd card and no touch screen. My PINs are: 1.VCC 2.GND 3.MISO 4.MOSI 5.BLK 6.DC 7.RES 8.CLK So the Chip is automaticly selected?

[@ScottMarley]

@@cheat_steve10 it's not automatically selected as such, its selected via the TFCS pin on your screen, so that needs to be wired as per the diagram in the video (except mine is called CS). Just follow that diagram and you'll be good.

[@ScottMarley]

Oh, you'll also want to connect the BLK pin to 3.3V, as this is for the backlight. I didn't do this on mine, as I wasn't using the backlight.

[@cheat_steve10]

The thing is my screen doesn't have a TFCS pin. My screen only has those 8 pin.

[@Currychicken5]

It works great although my backlight seems to flicker it goes bright every frame update do you know what could be causing it?

[@ScottMarley]

Hi, that sounds strange! The backlight is connected to the correct pin I guess? (Usually 3V3)

[@Currychicken5]

@@ScottMarley I have tried both 3v and 5v they both have the problem ground seems to turn the backlight off

[@ScottMarley]

@@Currychicken5 is it definitely the backlight and not the LCD itself flickering?

[@Currychicken5]

@@ScottMarley I’m gonna unplug the backlight and see if it still flickers when i hold a flashlight to it

[@Currychicken5]

@@ScottMarley its hard to see but it seems like it could be either lcd or backlight

[@acatisfinetoo3018]

Does this work with the raspberry pi 4 model b?

[@ScottMarley]

Yes, works fine with the 4

[@acatisfinetoo3018]

@@ScottMarley I did everything in your video and got as far as configuring boot options...i am missing the hdmi_cvt =320 240 60 1 0 0 0. line. i enabled the "hdmi force_hotplug =1" but i get the error vc_dispmanx_display_open failed! Make sure to have hdmi_force_hotplug=1 setting in /boot/config.txt. I have the ili9341 2.8 display. any ideas?

[@cjlowe1650]

I'm on a raspberry pi 4 8gb, latest update as of 2021/08/19 (64 bit os)

[@ivanravenski]

If anyone can help I’ve been trying to figure this out for a while my screen is a 2inch 240x320 waveshare screen but my pin out is Vcc,gnd,Din,Clinton,cs,DC,RST, BACKLIGHT. So I’m confused what should Goto mosi miso etc if anyone knows how to plug this in lmk please

[@ScottMarley]

Din on your screen connects to MOSI (RPi pin 19). Clk goes to pin 23, CS goes to pin 24, RST goes to pin 31, DC goes to pin 29. Backlight usually goes to Vcc if you want it on, but might be ground. Try it and see. You can leave MISO unconnected. Vcc goes to either 3.3V or 5V depending on your screen. GND goes to ground. If you do that and follow the rest of the instructions to build the library then it should (might!) work.

[@ivanravenski]

Scott Marley hey thanks a lot for the reply I appreciate your video I’m going to try this out on my pi4 after my morning coffee ☕️ 🧉

[@harmanndhiman9492]

Scott Marley where did u get those cables?

[@Currychicken5]

@@harmanndhiman9492 they are called jumper wires most electronic shops sell them

[@ivanravenski]

@@ScottMarley didn’t work on pi4 so I tried on my pi3 B+ with retro pie I think I have it hooked up right but nothing is on the screen just the backlight and the hdmi put doesn’t work either the tv says something about resolution

[@FixationwithCarnage]

retropie graphic be lookin a lil sus

[@pandaman4273]

how to use touch？

[@ScottMarley]

The display I have here is none touch so I cant help.

[@pandaman4273]

@@ScottMarley thanks😥

[@pabloh318]

works for raspberry pi zero?

[@ScottMarley]

According to the GitHub page, it does. I have never tried it though.

[@pabloh318]

@@ScottMarley when I do sudo ./fbcp-ili9341 my raspberry resets the GPIO pins and later my screen won't turn on

[@pabloh318]

any solution? Thanks

[@ScottMarley]

@@pabloh318 I don't know I'm afraid, I haven't used it with the zero or had an issue like that I'm afraid. You can post on GitHub if you need help

[@pabloh318]

Thanks for your answers. Bye! ;)

[@rodrigomiranda8779]

Hey Scott! Amazing job man! PErfect. I wonder if you could assist. i cannot get it to work. i keep getting white screen. My screen is a ili9341 and i use the following specs - sudo apt-get install cmake cd ~ git clone github.com/juj/fbcp-ili9341.git cd fbcp-ili9341 mkdir build cd build cmake -DSPI_BUS_CLOCK_DIVISOR=6 -DILI9341=ON -DGPIO_TFT_DATA_CONTROL=24 -DGPIO_TFT_RESET_PIN=25 -DSTATISTICS=0 .. make -j i have the core of my pi at 360. this means that 360/6 = 60hz ... But the screen keeps getting white .... any ideas?

[@ScottMarley]

Hi, there are a bunch of things that can go wrong here, and I can't see anything obvious from what you've posted. Check your connections and pins are correct. Also increase your divisor to 40 or so and see if that helps. If so, you can then reduce it until it works. You might be better asking for help on the GitHub page however, where people far more knowledgeable than me may be able to help!

[@sketchonk]

would this work with the pico?

[@ScottMarley]

No, that has a completely different chip, software, etc.

[@harmanndhiman9492]

where did you get these cables

[@ScottMarley]

They're just standard female - female Dupont cables.

[@harmanndhiman9492]

Scott Marley thanks nice vid

[@ПетрГуберт]

Hi! Is your st7789 2.0 inch display ips or tft?

[@ScottMarley]

That particular one is ips

[@joselobato3959]

Does it work in a raspberry pi 4 B? :

[@ScottMarley]

Yes, it works with the Pi 4

[@joselobato3959]

@@ScottMarley Thx, man.

[@sebastianputlitz2708]

my screen is mirrored, what to do?

[@ScottMarley]

You need to add a line to /boot/config.txt, either 'display_rotate=0x10000' for a horizontal flip or 'display_rotate=0x20000' for a vertical flip. If you just need to rotate the screen instead of flip it, use 'display_rotate=#' where # is 1, 2 or 3. Hope that helps.

[@sebastianputlitz2708]

@@ScottMarley Hi Scott, thank you for your reply. display_rotate=0x20000 in config.txt works. But it flips the HDMI Output too. So any ideas, howt to flip only the ili9341 Display?

[@ScottMarley]

@@sebastianputlitz2708 I don't know if that's possible. Try some more config.txt options from here and see if anything works www.raspberrypi.org/documentation/configuration/config-txt/video.md

[@ScottMarley]

Looks like it isn't possible as far as I can tell. You can rotate the spi display separately from the hdmi, but not mirror it. The library is written to just display the hdmi buffer, as stated here github.com/juj/fbcp-ili9341#do-i-have-to-show-the-same-image-on-hdmi-output-and-the-spi-display-or-can-they-be-different

[@sebastianputlitz2708]

@@ScottMarley Ok Thank you. I think it is not necessary, at the end.

[@dummypg6129]

Does the library supports st7735?

[@ScottMarley]

Yes

[@dummypg6129]

@@ScottMarley cool, excited to try. Waiting for my display to arrive.

[@cjlowe1650]

Thanks. But seriously, couldn't you of put the commands attached here or on a webpage. Going back and forth between screens is crazy!

[@ScottMarley]

The commands will be different depending on the model of the LCD, screen controller, resolution, orientation and a load of other stuff so its vital that you read through the docs carefully to make it work for your use case. The GitHub documentation is really good, much better than anything I could write here.

[@miguelfoguila6607]

😅😅

[@jonathanstein6056]

Edit out your mouth sounds/noises. Very distracting.