Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nopnop2002/raspberry-ili9340spi
ILI9340 SPI TFT Library & XPT2046 Touch Screen Library for Raspberry
https://github.com/nopnop2002/raspberry-ili9340spi
ili9340 ili9341 raspberrypi st7735 wiring-pi xpt2046
Last synced: 12 days ago
JSON representation
ILI9340 SPI TFT Library & XPT2046 Touch Screen Library for Raspberry
- Host: GitHub
- URL: https://github.com/nopnop2002/raspberry-ili9340spi
- Owner: nopnop2002
- License: mit
- Created: 2017-04-13T12:59:22.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-16T22:11:12.000Z (6 months ago)
- Last Synced: 2024-10-11T13:44:11.510Z (27 days ago)
- Topics: ili9340, ili9341, raspberrypi, st7735, wiring-pi, xpt2046
- Language: C
- Homepage:
- Size: 3.39 MB
- Stars: 41
- Watchers: 6
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
#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](https://github.com/xofc/xpt2uinput).
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.
