Raspberry-ili9340spi

ILI9340 SPI TFT Library for Raspberry Pi.
This may works with other boards like OrangePi/NanoPi.

You can show a chart to ILI9340/ILI9341/ILI9163C/ST7735 SPI TFT.
You can choose bmc2835 library/WiringPi library.

I tested these TFT.
1.44 inch 128x128 ST7735
1.44 inch 128x128 ILI9163C
1.8 inch 128x160 ST7735
2.2 inch 240x320 ILI9340
2.4 inch 240x320 ILI9341
2.4 inch 240x320 ILI9341

This project can be built with either:

• Build using bcm2835 library
• Build using Hardware SPI of the WiringPi library
• Build using Software SPI of the WiringPi library

---

Wirering

TFT		GPIO Header
VCC	--	3.3V	*4
GND	--	GND
CS	--	Pin#24(SPI CS0)	*2 *3
RES	--	Pin#12	*1
D/C	--	Pin#11	*1
MOSI	--	Pin#19(SPI MOSI)	*3
SCK	--	Pin#23(SPI SCLK)	*3
LED	--	3.3V	*4
MISO	--	N/C

(*1) You can change it to any pin by changing source.

(*2) You can use CS1 by specifying compilation flags.

(*3) For Software SPI, you can change it to any pin by changing source.

(*4) SPI TFTs require a lot of current.
If it is supplied from the Raspberry Pi's 3.3V pin, it may run out of current.
Use the 5V pin and the regulator to power it and it will be stable.
I used AMS1117.

---

Build using bcm2835 library

RPi Only, Very fast

Install bcm2835 library

wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.56.tar.gz
tar zxvf bcm2835-1.56.tar.gz
cd bcm2835-1.56
./configure
make
sudo make check
sudo make install

* This tool require 1.56 or later.
* Because this tool uses bcm2835_spi_write.

Using other GPIO

You can change GPIO to any pin by changing here.

#ifdef BCM
#include <bcm2835.h>
#define D_C 17  // BCM IO17=Pin#11
#define RES 18  // BCM IO18=Pin#12
#endif

Using SPI0

Use Pin#24 as ChipSelect.

cd $HOME   
git clone https://github.com/nopnop2002/Raspberry-ili9340spi
cd Raspberry-ili9340spi
make lib
cc -o demo demo.c fontx.c ili9340.c jpeg.a png.a -lbcm2835 -lm -DBCM
sudo ./demo

Using SPI1

Use Pin#26 as ChipSelect.

cd $HOME   
git clone https://github.com/nopnop2002/Raspberry-ili9340spi
cd Raspberry-ili9340spi
make lib
cc -o demo demo.c fontx.c ili9340.c jpeg.a png.a -lbcm2835 -lm -DBCM -DSPI1
sudo ./demo

SPI bus speed for bcm2835

By default it uses 7.8125MHz on Rpi2, 12.5MHz on RPI3.
Can be changed at compile time.

• -DSPI_SPEED16 : 15.625MHz on Rpi2, 25MHz on RPI3.
• -DSPI_SPEED32 : 31.25MHz on Rpi2, 50MHz on RPI3.

50MHz is an overclock.

SPI Bus speed comparison

	7.8125MHz	15.625MHz	31.25MHz
ColorBarTest	245	160	107
ArrowTest	286	193	155
LineTest	595	397	294
CircleTest	558	373	282
RoundRectTest	560	371	273
DirectionTest	304	199	153
HorizontalTest	430	283	209
VerticalTest	438	290	214
FillRectTest	448	285	221
ColorTest	500	327	234
JPEGTest	1607	1076	816
PNGTest	1742	1231	974

---

Build using Hardware SPI of the WiringPi library

WiringPi library initializes GPIO in one of the following ways:

• int wiringPiSetup (void);
• int wiringPiSetupGpio (void);
• int wiringPiSetupPhys (void);
• int wiringPiSetupSys (void);

This project by default uses the wiringPiSetup() function to initialize GPIOs.
Then use the wiringPiSPISetup() function to initialize the SPI.
If you use it on a board other than the RPI board, you may need to change the WiringPi number.

#define D_C   0 // wPi IO00=Pin#11
#define RES   1 // wPi IO01=Pin#12

As far as I know, there are these WiringPi libraries.

• WiringPi for OrangePi
• WiringPi for BananaPi
• WiringPi for NanoPi
• WiringPi for Pine-64

If you want to initialize GPIO with wiringPiSetupGpio(), Use the -DGPIO compilation flag.
In this case, use the following GPIOs.

#define D_C  17 // BCM IO17=Pin#11
#define RES  18 // BCM IO18=Pin#12

Using SPI0

Use Pin#24 as ChipSelect.

git clone https://github.com/nopnop2002/Raspberry-ili9340spi
cd Raspberry-ili9340spi
make lib
cc -o demo demo.c fontx.c ili9340.c jpeg.a png.a -lwiringPi -lm -pthread -DWPI
sudo ./demo

Using SPI1

Use Pin#26 as ChipSelect.

git clone https://github.com/nopnop2002/Raspberry-ili9340spi
cd Raspberry-ili9340spi
make lib
cc -o demo demo.c fontx.c ili9340.c jpeg.a png.a -lwiringPi -lm -pthread -DWPI -DSPI1
sudo ./demo

Note for OrangePi
Opi have only 1 SPI.
OPi-PC has SPI0 on pin 24.
OPi-ZERO has SPI1 on pin 24.

SPI bus speed for WiringPi

By default it uses 8MHz on all Rpi.
Can be changed at compile time.

• -DSPI_SPEED16 : 16MHz on all Rpi.
• -DSPI_SPEED32 : 32MHz on all Rpi.

SPI Bus speed comparison

	8MHz	16MHz	32MHz
ColorBarTest	208	116	93
ArrowTest	389	296	239
LineTest	1800	1637	1560
CircleTest	1630	1481	1393
RoundRectTest	1633	1490	1412
DirectionTest	461	354	315
HorizontalTest	878	723	663
VerticalTest	909	769	702
FillRectTest	454	246	148
ColorTest	558	234	159
JPEGTest	6292	5862	5640
PNGTest	6439	5989	5803

---

Build using Software SPI of the WiringPi library

WiringPi library initializes GPIO in one of the following ways:

• int wiringPiSetup (void);
• int wiringPiSetupGpio (void);
• int wiringPiSetupPhys (void);
• int wiringPiSetupSys (void);

This project by default uses the wiringPiSetup() function to initialize GPIOs.
Then use the wiringPiSPISetup() function to initialize the SPI.
If you use it on a board other than the RPI board, you may need to change the WiringPi number.

#define D_C   0 // wPi IO00=Pin#11
#define RES   1 // wPi IO01=Pin#12
#define MOSI 12 // wPi IO12=Pin#19
#define SCLK 14 // wPi IO14=Pin#23
#define CS   10 // wPi IO10=Pin#24

If you want to initialize GPIO with wiringPiSetupGpio(), Use the -DGPIO compilation flag.
In this case, use the following GPIOs.

#define D_C  17 // BCM IO17=Pin#11
#define RES  18 // BCM IO18=Pin#12
#define MOSI 10 // BCM IO10=Pin#19
#define SCLK 11 // BCM IO11=Pin#23
#define CS   24 // BCM IO24=Pin#24

git clone https://github.com/nopnop2002/Raspberry-ili9340spi
cd Raspberry-ili9340spi
make lib
cc -o demo demo.c fontx.c ili9340.c jpeg.a png.a -lwiringPi -lm -pthread -DWPI -DSOFT_SPI
sudo ./demo

---

TFT resolution and GRAM offset

TFT resolution is set to tft.conf.

If your TFT doesn't use a memory from 0th address in GRAM, It use GRAM offset which set to tft.conf.

#width=128 height=128
width=240 height=320
#width=240 height=400

#If TFT have GRAM offset
#offsetx=2
#offsety=1

---

JPEG File

PNG File

---

From left to right:
2.8" 240x320 ILI9341
2.4" 240x320 ILI9341
2.2" 240x320 ILI9340

---

From left to right:
2.2" 240x320 ILI9340
1.44" 128x128 ST7735
1.44" 128x128 ILI9163C
1.8" 128x160 ST7735

---

XPT2046 Touch Screen

There is a TFT equipped with XPT2046.

A library of XPT2046 Touch Screen is included in this library.
I ported from here.

There is a TFT equipped with HR2046.
XPT2046 and HR2046 are very similar. But HR2046 does not work properly.

Wirering

TFT		Rpi
VCC	--	3.3V
GND	--	GND
CS	--	Pin#24(SPI CS0)
RES	--	Pin#12	(*1)
D/C	--	Pin#11	(*1)
MOSI	--	Pin#19(SPI MOSI)	(*2)
SCK	--	Pin#23(SPI SCLK)	(*2)
LED	--	3.3V
MISO	--	N/C
T_CLK	--	Pin#23(SPI SCLK)	(*2)
T_CS	--	Pin#26(SPI CE1)
T_DIN	--	Pin#19(SPI MOSI)	(*2)
T_OUT	--	Pin#21(SPI MISO)	(*2)
T_IRQ	--	Pin#22	(*1)

(*1) You can change any pin.

(*2) SPI is shared by TFT and XPT2046.

---

cc -o xpt xpt.c xpt2046.c -lbcm2835   
sudo ./xpt

If you touch screen, point will show.

---

cc -o touch touch.c fontx.c ili9340.c xpt2046.c -lbcm2835 -lm -DBCM
sudo ./touch

If you touch area, number will show.