Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nopnop2002/arduino-stm32-8bittft
8bit parallel TFT Library for Arduino_Core_STM32
https://github.com/nopnop2002/arduino-stm32-8bittft
arduino ili9325 ili9340 ili9341 ili9481 lgdp4532 r61505 r61509v rm68140 spfd5408 st7783 stm32
Last synced: about 2 months ago
JSON representation
8bit parallel TFT Library for Arduino_Core_STM32
- Host: GitHub
- URL: https://github.com/nopnop2002/arduino-stm32-8bittft
- Owner: nopnop2002
- License: apache-2.0
- Created: 2020-03-28T00:31:37.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-05T23:42:39.000Z (about 1 year ago)
- Last Synced: 2024-10-11T13:44:52.213Z (2 months ago)
- Topics: arduino, ili9325, ili9340, ili9341, ili9481, lgdp4532, r61505, r61509v, rm68140, spfd5408, st7783, stm32
- Language: C++
- Homepage:
- Size: 502 KB
- Stars: 18
- Watchers: 4
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arduino-STM32-8bitTFT
8bit TFT Library for Arduino_Core_STM32(ST Core)
I ported from here.
https://github.com/prenticedavid/MCUFRIEND_kbv
----
# Software requirement
- Core library
https://github.com/stm32duino/Arduino_Core_STM32
- Adafruit GFX Library
https://github.com/adafruit/Adafruit-GFX-Library
----
# Wirering for 8bit Parallel TFT
|TFT||STM32|
|:-:|:-:|:-:|
|LCD_RD|--|PB0(*1)|
|LCD_WR|--|PB1(*1)|
|LCD_RS|--|PB5(*1)|
|LCD_CS|--|PB6(*1)|
|LCD_RST|--|PB7(*1)|
|LCD_D0|--|PA0(*2)|
|LCD_D1|--|PA1(*2)|
|LCD_D2|--|PA2(*2)|
|LCD_D3|--|PA3(*2)|
|LCD_D4|--|PA4(*2)|
|LCD_D5|--|PA5(*2)|
|LCD_D6|--|PA6(*2)|
|LCD_D7|--|PA7(*2)|
|5V|--|5V(*3)|
|3.3V|--|3.3V(*3)|
|GND|--|GND|
(\*1)
You can change to other PB pin. To change the pin, change Arduino-STM32-8bitTFT.h.
Some boards assign PB3 and PB4 to the JTAG debug port by default.
Therefore, depending on the board, PB3 and PB4 may not be available as GPIO.
These GPIO are controlled using LL_GPIO_WriteOutputPort().
```
#define TFT_RD LL_GPIO_PIN_0 // PB0
#define TFT_WR LL_GPIO_PIN_1 // PB1
#define TFT_RS LL_GPIO_PIN_5 // PB5
#define TFT_CS LL_GPIO_PIN_6 // PB6
#define TFT_RST LL_GPIO_PIN_7 // PB7
```
(\*2)
__Serial.print of NUCLEO and DISC1 gose to PA2.__
__Serial.print of STM32G series gose to PA2.__
__Serial.print of STM32H series gose to PA0.__
__If you are using these, you will need to do one of the following:__
#### Change GPIO from D0 to D7
To change the port, change Arduino-STM32-8bitTFT.h.
D0 to D7 are controlled using CMSIS ODR Register.
This register can change multiple IOs at once, but only IOs on the same port.
Therefore, D0 to D7 must be the same port.
If PORT-A is used for D0-D7, __all GPIOs on PORT-A cannot be used for other purposes.__
Because CMSIS ODR Register manipulates all GPIOs of PORT-A.
You can use any of the following:
- PORT-A LOW
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PA7|PA6|PA5|PA4|PA3|PA2|PA1|PA0|
- PORT-A HIGH
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PA15|PA14|PA13|PA12|PA11|PA10|PA9|PA8|
- PORT-C LOW
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PC7|PC6|PC5|PC4|PC3|PC2|PC1|PC0|
- PORT-C HIGH
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PC15|PC14|PC13|PC12|PC11|PC10|PC9|PC8|
- PORT-D LOW
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PD7|PD6|PD5|PD4|PD3|PD2|PD1|PD0|
- PORT-D HIGH
TFT Pin|D7 |D6 |D5 |D4 |D3 |D2 |D1 |D0 |
STM32 Pin|PD15|PD14|PD13|PD12|PD11|PD10|PD9|PD8|
#### Change default Serial instance pins
You can use another GPIO as a Serial object.
GPIO that can be used as a Serial object differs depending on the MCU.
You can know which GPIOs can be used in PeripheralPins.c of the MCU.
PeripheralPins.c is [here](https://github.com/stm32duino/Arduino_Core_STM32/tree/main/variants).
```
Serial.setTx(PB3);
Serial.setRx(PB4);
Serial.begin(115200);
```
(\*3)
When a regulator(It's often AMS1117) is mounted on the back, it's operated 5V.
When a regulator is NOT mounted on the back, it's operated 3.3V.
__Note:Keep the wire length as short as possible.__
----
# Tested TFT
- ILI9325 2.4inch 240x320 TFT-Shield
- ILI9341 2.4inch 240x320 TFT-Shield
- ILI9342 2.4inch 240x320 TFT-Shield
- SPFD5408 2.4inch 240x320 TFT-Shield
- R61505 2.4inch 240x320 TFT-Shield
- ST7783 2.4inch 240x320 TFT-Shield
- LGDP4532 2.4inch 240x320 TFT-Shield
- R61509V 3.6inch 240x400 TFT-Shield
- ST7793 3.6inch 240x400 TFT-Shield
- ILI9481 3.5inch 320x480 TFT-Shield
- ILI9486 3.5inch 320x480 TFT-Shield
- RM68140 3.95inch 320x480 TFT-Shield
- ST7796 3.95inch 320x480 TFT-Shield
I found that these display cannot follow high-speed GPIO-ON and GPIO-OFF.
- OPEN-SMART ILI9225 TFT-Shield
- OPEN-SMART ILI9327 TFT-Shield
- OPEN-SMART ILI9340 TFT-Shield
- OPEN-SMART S6D1121 16Pin-Parallel
- OPEN-SMART ST7775 16Pin-Parallel
- OPEN-SMART ST7783 16Pin-Parallel
- OPEN-SMART R61509V 16Pin-Parallel
- OPEN-SMART ILI9488 16Pin-Parallel
----
# Boards available
This library uses LL GPIO Generic Driver and CMSIS ODR Register.
Probably all boards have these available.
I tested with these.
- STM32F0/F1/F3/F4 series
- STM32G4 series
- STM32H5 series
- STM32L4 series
----
# Setting your TFT's resolution
The default resolution of this library is 240x320.
If your TFT's resolution is 320x480,
you have to set your TFT's resolution using tft.setResoution.
```
ID = tft.readID();
tft.setResolution(320, 480); // Set your resolution
Serial.print("Device ID: 0x"); Serial.println(ID, HEX);
tft.begin(ID);
uint32_t width = tft.width();
Serial.print("Width: "); Serial.println(width); // You will see 320
uint32_t height = tft.height();
Serial.print("Height: "); Serial.println(height); // You will see 480
```
If your TFT's resolution is 240x400,
you have to set your TFT's resolution and TFT's offset.
```
ID = tft.readID();
tft.setResolution(240, 400); // Set your resolution
tft.setOffset(32); // Set your offset
Serial.print("Device ID: 0x"); Serial.println(ID, HEX);
tft.begin(ID);
uint32_t width = tft.width();
Serial.print("Width: "); Serial.println(width); // You will see 240
uint32_t height = tft.height();
Serial.print("Height: "); Serial.println(height); // You will see 400
```
---
- STM32F103 + R61505 2.4 inch TFT
- STM32F103 + SPFD5408 2.4 inch TFT
- STM32F103 + ILI9325 2.4 inch TFT
- STM32F103 + ILI9341 2.4 inch TFT
- STM32F103 + ILI9342 2.4 inch TFT
- STM32F401 + ILI9341 2.4 inch TFT
- STM32F407 + ILI9341 2.4 inch TFT
- NUCLEO F446RE + ILI9341 2.4 inch TFT (Use PC0-PC7 for D0-D7)
- STM32G431 + ILI9341 2.4 inch TFT (Use Serial remapping)
- STM32H750 + ILI9341 2.4 inch TFT (Use PC0-PC7 for D0-D7)
----
# Benchmark using ILI9341(240x320)
|Benchmark|F072|F103|F303|F401|F411|F407|F446|G431|H750|L452|ATmega328|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|Screen fill |713964 |737158 |358057 |247223 |216304 |141878 |132427 |140239 |222478 |259637 |1379560|
|Text |73319 |58985 |37647 |25814 |22605 |15097 |14272 |16275 |14691 |28825 |344024 |
|Lines |675985 |556282 |336332 |235522 |206064 |137693 |130958 |134605 |147000 |250545 |3390180|
|Horiz/Vert Lines |60070 |61299 |30165 |20825 |18221 |11958 |11173 |11847 |18372 |21950 |144664 |
|Rectangles (outline) |39824 |39994 |20040 |13835 |12106 |7953 |7437 |8178 |11863 |14875 |104260 |
|Rectangles (filled) |1482576|1530389|743518 |513383 |449170 |294609 |274991 |291313 |461782 |539271 |3267476|
|Circles (filled) |237519 |215466 |120380 |83212 |72840 |48080 |45358 |58606 |59632 |97797 |1211484|
|Circles (outline) |297537 |245302 |148705 |103680 |90733 |60769 |57622 |59807 |64510 |110695 |1475108|
|Triangles (outline) |149009 |123427 |74211 |51938 |45477 |30354 |28766 |29767 |32825 |55313 |1075596|
|Triangles (filled) |542331 |528554 |268777 |185711 |162496 |106788 |99944 |112922 |155465 |202875 |1721636|
|Rounded rects (outline)|117285 |101407 |58746 |40758 |35682 |23791 |22529 |23750 |27519 |43702 |506428 |
|Rounded rects (filled) |1495318|1534484|750346 |518107 |453320 |297450 |277742 |298242 |132427 |548296 |3795228|