https://github.com/androidcrypto/esp32_c3_st7789_starter
Getting started with an ESP32-C3 Supermini device and a TFT display ST7789
https://github.com/androidcrypto/esp32_c3_st7789_starter
esp32 esp32-c6 spi st7789 tft-display
Last synced: 7 days ago
JSON representation
Getting started with an ESP32-C3 Supermini device and a TFT display ST7789
- Host: GitHub
- URL: https://github.com/androidcrypto/esp32_c3_st7789_starter
- Owner: AndroidCrypto
- License: mit
- Created: 2025-05-06T08:59:39.000Z (13 days ago)
- Default Branch: main
- Last Pushed: 2025-05-06T09:06:35.000Z (13 days ago)
- Last Synced: 2025-05-06T10:27:02.159Z (13 days ago)
- Topics: esp32, esp32-c6, spi, st7789, tft-display
- Language: C++
- Homepage: https://medium.com/@androidcrypto/getting-started-with-an-esp32-c3-supermini-device-connected-to-an-st7789-tft-display-1fd02d828917
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32-C3 Supermini with ST7789 TFT display Starter
Getting started with an **ESP32-C3 Supermini** device and a TFT display with driver chip **ST7789**.
This is the accompanying repository for my article "**Getting Started with an ESP32-C3 Supermini device connected to an ST7789 TFT display**": https://medium.com/@androidcrypto/getting-started-with-an-esp32-c3-supermini-device-connected-to-an-st7789-tft-display-1fd02d828917.
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-C3 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_C3_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-C3 Supermini, 40 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-C3 Super Mini, 40 MHz
````
## GPIO pins setup in the display specific setup file
```` plaintext
// file Setup703_C3_SM_ST7789_240x320.h
//#define TFT_BL 5 // LED back-light
#define TFT_MISO 20 // not used/connected
#define TFT_MOSI 6 // = SDA
#define TFT_SCLK 7
#define TFT_CS 21
#define TFT_DC 10
#define TFT_RST 9 // 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).