https://github.com/androidcrypto/esp32_h2_st7789_starter
Getting started with an ESP32-H2 Supermini device and a TFT display ST7789
https://github.com/androidcrypto/esp32_h2_st7789_starter
esp32 esp32-h2 spi st7789 tft-display
Last synced: 7 months ago
JSON representation
Getting started with an ESP32-H2 Supermini device and a TFT display ST7789
- Host: GitHub
- URL: https://github.com/androidcrypto/esp32_h2_st7789_starter
- Owner: AndroidCrypto
- License: mit
- Created: 2025-05-14T11:56:26.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-05-15T22:50:36.000Z (8 months ago)
- Last Synced: 2025-05-15T23:28:27.331Z (8 months ago)
- Topics: esp32, esp32-h2, spi, st7789, tft-display
- Language: C++
- Homepage: https://medium.com/@androidcrypto/getting-started-with-an-esp32-h2-supermini-device-connected-to-an-st7789-tft-display-6bfb87de7351
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32-H2 Supermini with ST7789 TFT display Starter
Getting started with an **ESP32-H2 Supermini** device and a TFT display with driver chip **ST7789**.
This is the accompanying repository for my article "**Getting Started with an ESP32-H2 Supermini device connected to an ST7789 TFT display**": https://medium.com/@androidcrypto/getting-started-with-an-esp32-h2-supermini-device-connected-to-an-st7789-tft-display-6bfb87de7351.
My display is a 2.0 inch large TFT display with 240 x 320 pixels.
## Settings for the display specific setup file
I'm using a display specific setup file for the combination ESP32-H2 Supermini with TFT display driver ST7789.This file contains e.g. the display driver, size and pins for the ESP32-device. If your display has a different size please change the height and width accordingly.
### Copy a file to the User_Setups folder
Please copy the file
Setup703_H2_SM_ST7789_240x320.h
to the **User_Setups** folder.
### Edit the User_Setup_Select.h file
You need to place the following line in the root folder's "**User_Setup_Select.h**" file
#include // ESP32-H2 Supermini, 80 MHz
Second: please comment all other "#include..." entries like this, especially the "//#include " entry.
````
// Example User_Setup files are stored in the "User_Setups" folder. These can be used
// unmodified or adapted for a particular hardware configuration.
#ifndef USER_SETUP_LOADED // Lets PlatformIO users define settings in
// platformio.ini, see notes in "Tools" folder.
///////////////////////////////////////////////////////
// User configuration selection lines are below //
///////////////////////////////////////////////////////
// Only ONE line below should be uncommented to define your setup. Add extra lines and files as needed.
//#include // Default setup is root library folder
// Setup file in folder Arduino/libraries (updates will not overwrite your setups)
#include // ESP32-H2 Super Mini, 80 MHz
````
## GPIO pins setup in the display specific setup file
```` plaintext
// file Setup703_H2_SM_ST7789_240x320.h
//#define TFT_BL 24 // LED back-light
#define TFT_MISO 22 // not used/connected, pin 22 is existing on soldered pin
#define TFT_MOSI 10 // = SDA
#define TFT_SCLK 0
#define TFT_CS 14
#define TFT_DC 12
#define TFT_RST 11 // Set TFT_RST to -1 if display RESET is connected to ESP32 board EN
````
## Important note
You need to modify the display library TFT_eSPI to get the code to work. Please find instructions on how to do this in my forked TFT_eSPI repository here on GitHub: [https://github.com/AndroidCrypto/TFT_eSPI](https://github.com/AndroidCrypto/TFT_eSPI).