ST7789 TFT LCD working on ESP32 WROOM Dev Kit but not working on ESP32-C3-WROOM-02 Dev Kit in Arduino

[cgandrewdev]

Hi I have been successfully using the TFT_eSPI library on an ESP32 WROOM dev kit in conjunction with an ST7789 based SPI TFT LCD 240x240 module in the Arduino UI. The library works really well, thank you.

I have switched to a newer dev kit, the ESP32-C3-WROOM-02 dev kit which uses the newer C3 module. But I have not been able to compile the example project, for example the Read_User_Setup project. It compiles and runs fine when I set the Board to ESP32 Dev Module but as soon as I change the board to ESP32C3 Dev Module and change the port and recompile, I get pages full of errors:

In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:20:
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: error: 'HSPI_HOST' was not declared in this scope
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: note: suggested alternative: 'SPI3_HOST'
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
                                  SPI3_HOST
In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.h:12,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.h:65,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:17:
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: error: 'REG_SPI_BASE' was not declared in this scope
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));
                                                            ^~~~~~~~~~~
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: note: suggested alternative: 'REG_I2S_BASE'
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));

... and so on, I would have attached the full output as a file but I might not be able to add files.

I am not sure where to start, the errors seem to be SPI related. I have been looking at the specifications for the C3 module and found that it has three SPI ports SPI0, SPI1, and SPI2, only SPI2 is configurable as general purpose SPI. I dont really know what I should be doing to solve this.

If anyone has any advice it would be much appreciated! Thanks

[Bodmer]

The new ESP32-C3 is not currently supported. Today I received an ESP32-S2 board so will be working on adapting the library for that processor, maybe the C3 will then work too.

As you note the issue seems to be SPI port references.

[cgandrewdev]

Thanks very much! I'll be happy to do testing when ready.

[Bodmer]

The library has been updated for the ESP32 S2 processor variant, the changes may also work with the C3 but this is untested and I do not have a C3 board.

[BeijingUncle]

There is a post from Twitter maybe useful: https://twitter.com/martinfasani/status/1386019656016728068?s=20

[cgandrewdev]

Thanks for doing the work on the S2.

I have finally been able to get some time to look at this. I noted that ESP32 Arduino board package 2.0.0 is required per the notes, so I reinstalled with GIT etc. per the instructions here: https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html

I have Arduino 1.8.16,

The first test, with no dev module plugged in, was to set the target board to ESP32S2 Dev Module and just do a compile, and that worked just fine.

Then I switched to ESP32C3 Dev Module and tried to recompile but I get a similar list of errors as before. This is without any dev module plugged in at all, just compiling for the C3 dev module as the target. You mentioned that you didnt have a C3 dev module but errors I am getting exist without even a dev module plugged in, just by changing to the C3 module as target.

I have attached the error list if that helps any.

If I selected S2 Dev Module and compiled and tried to upload to the C3 module anyway it wont because it knows I have a C3 Module. I am not sure what else I can do to from here. Thoughts?

TFT_eSPI errors.txt

[freemanzwin]

arduino esp32c3 spi is not implemented yet.

esp32s2 spi_reg.h

#include "soc.h"
#define REG_SPI_BASE(i) (DR_REG_SPI2_BASE + (((i)>3) ? (((i-2) 0x1000) + 0x10000) : ((i - 2) 0x1000 )))**

#define SPI_CMD_REG(i) (REG_SPI_BASE(i) + 0x000)

===================================================================

esp32c3 spi_reg.h

#include "soc.h"

#define SPI_CMD_REG(i) (REG_SPI_BASE(i) + 0x0)

[Bodmer]

The compile problem is caused by bugs and inconsistencies in the IDF for the ESP32C3.

I have added some patches to the latest Github master.

The examples compile OK now but I have not tested the library on the ESP32C3 as I do not have one!

[Aqamoe]

The compile problem is caused by bugs and inconsistencies in the IDF for the ESP32C3.

I have added some patches to the latest Github master.

The examples compile OK now but I have not tested the library on the ESP32C3 as I do not have one!

Hello, I use your latest library to run on ESP32C3 and drive the ST7789 display screen, but it does not work properly. I use oscilloscope to measure the pin and find no SPI signal output.

[Bodmer]

Thanks for your information. I think we can say the C3 is currently unsupported. I may get a C3 at some point to figure out what is happening.

[gabrielcsapo]

I recently got the c3 working with https://github.com/PaulStoffregen/XPT2046_Touchscreen. I published an article about it https://www.gabrielcsapo.com/arduino-esp32-c3-32s-ili9341-with-touchscreen/. My next step is getting this library to work with it. @Bodmer if you need a test chip DM me and I can send you one.

[gabrielcsapo]

I can get the touchscreen to respond, but no dice on any TFT output.

[code]
TFT_eSPI ver = 2.4.2
Processor = ESP32
Frequency = 80MHz
Transactions = Yes
Interface = SPI
Display driver = 9341
Display width = 240
Display height = 320
MOSI = GPIO 6
MISO = GPIO 5
SCK = GPIO 4
TFT_CS = GPIO 7
TFT_DC = GPIO 8
TFT_RST = GPIO 1
TOUCH_CS = GPIO 2
Font GLCD loaded
Font 2 loaded
Font 4 loaded
Font 6 loaded
Font 7 loaded
Font 8 loaded
Smooth font enabled
Display SPI frequency = 2.50
Touch SPI frequency = 2.50
[/code]

[Bodmer]

The problem with the C3 variant is likely to do with the SPI configuration. I do not have an ESP32 C3 so am unable to test any changes. At the moment the C3 is no supported. If you can figure out what the problem is then do let me know.

[gabrielcsapo]

FSPI=0
HSPI=1

Looking at debugging this further tonight.

[gabrielcsapo]

If anyone has a c3 and wants to help figure this out #1586 I have a draft PR opened to collaborate.

[Bodmer]

The library uses register level access to the SPI registers. Looking at the ESP32 board package I see the C3 requires extra code before triggering the transmit. At the moment the library does not have this, so that is likely to be the problem:
https://github.com/espressif/arduino-esp32/blob/master/cores/esp32/esp32-hal-spi.c#L734-L737

[gabrielcsapo]

Thanks @Bodmer , I will look into this.

[gabrielcsapo]

@Bodmer I have added this 9266855 which seems to do exactly what the lines you sent do. Still no dice.

[Bodmer]

I patched the branch here so that it might now work with the ESP32 C3. Note I do not have an ESP32 C3 to test it with but it compiled OK under v 2.0.3 RC1 of the ESP32 Arduino board package!

[Bodmer]

@cgandrewdev @BeijingUncle @gabrielcsapo @GYSS1204 @freemanzwin et al

ESP32 C3 is now supported in v2.4.61 and tested with a SPI ILI9341 display

[argi19]

Hola, he estado utilizando con éxito la biblioteca de TFT_eSPI en un kit de desarrollo ESP32 WROOM junto con un módulo SPI TFT LCD 240x240 basado en ST7789 en la interfaz de usuario de Arduino. La biblioteca funciona muy bien, gracias.

He cambiado a un kit de desarrollo más nuevo, el kit de desarrollo ESP32-C3-WROOM-02 que utiliza el módulo C3 más nuevo. Pero no he podido compilar el proyecto de ejemplo, por ejemplo el proyecto de Read_User_Setup. Se compila y funciona bien cuando configuro la placa en ESP32 Dev Module, pero tan pronto como cambio la placa a ESP32C3 Dev Module y cambio el puerto y la recompilo, obtengo páginas llenas de errores:

In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:20:
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: error: 'HSPI_HOST' was not declared in this scope
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: note: suggested alternative: 'SPI3_HOST'
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
                                  SPI3_HOST
In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.h:12,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.h:65,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:17:
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: error: 'REG_SPI_BASE' was not declared in this scope
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));
                                                            ^~~~~~~~~~~
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: note: suggested alternative: 'REG_I2S_BASE'
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));

... y así sucesivamente, habría adjuntado la salida completa como un archivo, pero es posible que no pueda agregar archivos.

No estoy seguro de por dónde empezar, los errores parecen estar relacionados con SPI. He estado mirando las especificaciones para el módulo C3 y descubrí que tiene tres puertos SPI SPI0, SPI1 y SPI2, solo SPI2 es configurable como SPI de propósito general. Realmente no sé qué debería estar haciendo para resolver esto.

Si alguien tiene algún consejo sería muy apreciado! Gracias

Hola, he estado utilizando con éxito la biblioteca de TFT_eSPI en un kit de desarrollo ESP32 WROOM junto con un módulo SPI TFT LCD 240x240 basado en ST7789 en la interfaz de usuario de Arduino. La biblioteca funciona muy bien, gracias.

He cambiado a un kit de desarrollo más nuevo, el kit de desarrollo ESP32-C3-WROOM-02 que utiliza el módulo C3 más nuevo. Pero no he podido compilar el proyecto de ejemplo, por ejemplo el proyecto de Read_User_Setup. Se compila y funciona bien cuando configuro la placa en ESP32 Dev Module, pero tan pronto como cambio la placa a ESP32C3 Dev Module y cambio el puerto y la recompilo, obtengo páginas llenas de errores:

In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:20:
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: error: 'HSPI_HOST' was not declared in this scope
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:23:34: note: suggested alternative: 'SPI3_HOST'
     spi_host_device_t spi_host = HSPI_HOST;
                                  ^~~~~~~~~
                                  SPI3_HOST
In file included from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.h:12,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.h:65,
                 from C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\TFT_eSPI.cpp:17:
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: error: 'REG_SPI_BASE' was not declared in this scope
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));
                                                            ^~~~~~~~~~~
C:\Users\P50\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.1/tools/sdk/esp32c3/include/soc/esp32c3/include/soc/spi_reg.h:23:34: note: suggested alternative: 'REG_I2S_BASE'
 #define SPI_CMD_REG(i)          (REG_SPI_BASE(i) + 0x0)
                                  ^~~~~~~~~~~~
C:\Users\P50\Documents\Arduino\libraries\TFT_eSPI\Processors/TFT_eSPI_ESP32.c:31:60: note: in expansion of macro 'SPI_CMD_REG'
   volatile uint32_t* _spi_cmd       = (volatile uint32_t*)(SPI_CMD_REG(SPI_PORT));

... y así sucesivamente, habría adjuntado la salida completa como un archivo, pero es posible que no pueda agregar archivos.

No estoy seguro de por dónde empezar, los errores parecen estar relacionados con SPI. He estado mirando las especificaciones para el módulo C3 y descubrí que tiene tres puertos SPI SPI0, SPI1 y SPI2, solo SPI2 es configurable como SPI de propósito general. Realmente no sé qué debería estar haciendo para resolver esto.

Si alguien tiene algún consejo sería muy apreciado! Gracias

Excuse me and greetings, I'm new to esp 32 and I would like to connect a st7789 screen to esp32 but I haven't been able to do it with the TFT_eSPI library, could you help me?

[MigraineMan33]

I have been successful in getting the ESP32-C3-12F module from AI-Thinker working with the BuyDisplay 240x240 IPS TFT module. I configured the ESP32 to use the secondary SPI interface hardware - designated as the FastSPI interface in the C3 Technical Reference Manual. Modded the associated config files in the TFT_eSPI library. Most of the demos work ... but sprites don't. Might be an issue with readback from the display. Haven't dug into that yet.
esp32-c3_240x240_setup.pdf