freechw / arduino-stm32-8bittft

8bit parallel TFT Library for Arduino_Core_STM32

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
LCD_WR	--	PB1
LCD_RS	--	PB5
LCD_CS	--	PB6
LCD_RST	--	PB7
LCD_D0	--	PA0
LCD_D1	--	PA1
LCD_D2	--	PA2(*1)
LCD_D3	--	PA3
LCD_D4	--	PA4
LCD_D5	--	PA5
LCD_D6	--	PA6
LCD_D7	--	PA7
5V	--	5V(*2)
3.3V	--	3.3V(*2)
GND	--	GND

(*1) Serial.print of NUCLEO and DISC1 gose to PA2
If you use NUCLEO or DISC1, you need to change it.

(*2) 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:You can change to any pin. To change the pin, change Arduino-STM32-8bitTFT.h.

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
• OPEN-SMART ILI9225 TFT-Shield
• OPEN-SMART ILI9327 TFT-Shield
• OPEN-SMART ILI9340 TFT-Shield

I found that these display cannot follow high-speed GPIO-ON and GPIO-OFF.

• 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.
Probably all boards that can use the LL GPIO Generic Driver are available.
Here is support status of low-layer drivers.
https://www.st.com/content/st_com/en/search.html#q=Descriptions%20hal%20and%20ll-t=resources-page=1

---

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

---

Benchmark using ILI9341(240x320)

Benchmark	STM32F103	STM32F303	STM32F401	STM32F407	STM32F446	ATmega328
Screen fill	2241101	1854703	1208997	647337	604184	1379560
Text	138955	106085	69792	38303	35748	344024
Lines	1337689	999535	660532	361830	337721	3390180
Horiz/Vert Lines	185661	152992	99924	53548	49978	144664
Rectangles (outline)	120109	98346	64325	34627	32311	104260
Rectangles (filled)	4756300	3935313	2583183	1386162	1293716	3267476
Circles (filled)	610890	471781	310337	167938	156716	1211484
Circles (outline)	588951	439863	290416	159225	148621	1475108
Triangles (outline)	302008	225153	148665	81285	75894	1075596
Triangles (filled)	1550456	1262459	821918	440290	410928	1721636
Rounded rects (outline)	262224	201583	132647	72231	67431	506428
Rounded rects (filled)	4711541	3899510	2555561	1372596	1281003	3795228