Skip to content

Commit

Permalink
add esp32 w/ st7789v tft (#14)
Browse files Browse the repository at this point in the history
  • Loading branch information
@jandelgado
jandelgado authored Dec 27, 2024
1 parent 57131f9 commit 2865840
Show file tree
Hide file tree
Showing 7 changed files with 424 additions and 39 deletions.
133 changes: 94 additions & 39 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,32 +5,33 @@ Notes on Arduino libraries and sketches and other related stuff.
<!-- vim-markdown-toc GFM -->

* [My Libraries and projects](#my-libraries-and-projects)
* [JLed](#jled)
* [log4arduino](#log4arduino)
* [eps32-aws-iot](#eps32-aws-iot)
* [USB Spinner Game Controller](#usb-spinner-game-controller)
* [Simpson Device (virtual Drinking Bird)](#simpson-device-virtual-drinking-bird)
* [JLed](#jled)
* [log4arduino](#log4arduino)
* [eps32-aws-iot](#eps32-aws-iot)
* [USB Spinner Game Controller](#usb-spinner-game-controller)
* [Simpson Device (virtual Drinking Bird)](#simpson-device-virtual-drinking-bird)
* [Sketches](#sketches)
* [Interfacing SSD1306 based OLED displays (SPI)](#interfacing-ssd1306-based-oled-displays-spi)
* [Colorduino RGB matrix driver](#colorduino-rgb-matrix-driver)
* [CJMCU-8x8 RGB matix](#cjmcu-8x8-rgb-matix)
* [WEMOS D-Duino](#wemos-d-duino)
* [ESP32 TTGO](#esp32-ttgo)
* [Heltec WiFi Lora 32](#heltec-wifi-lora-32)
* [Raspberry Pi 480x320 SPI TFT Display (3.5 inches)](#raspberry-pi-480x320-spi-tft-display-35-inches)
* [Further info](#further-info)
* [Sipeed Longan Nano RISC-V proto board (GD32VF103CBT6)](#sipeed-longan-nano-risc-v-proto-board-gd32vf103cbt6)
* [DFU mode](#dfu-mode)
* [Upload demo sketch](#upload-demo-sketch)
* [Raspberry Pi HDMI LCD display (800x480, 4")](#raspberry-pi-hdmi-lcd-display-800x480-4)
* [Raspberry Pi Pico (RP2040)](#raspberry-pi-pico-rp2040)
* [PCA9685 driver board](#pca9685-driver-board)
* [MP3 Modules](#mp3-modules)
* [VS1053 notes](#vs1053-notes)
* [Bosch BMP280](#bosch-bmp280)
* [TM1637 based Display](#tm1637-based-display)
* [Interfacing SSD1306 based OLED displays (SPI)](#interfacing-ssd1306-based-oled-displays-spi)
* [Colorduino RGB matrix driver](#colorduino-rgb-matrix-driver)
* [CJMCU-8x8 RGB matix](#cjmcu-8x8-rgb-matix)
* [WEMOS D-Duino](#wemos-d-duino)
* [ESP32 TTGO](#esp32-ttgo)
* [Heltec WiFi Lora 32](#heltec-wifi-lora-32)
* [Raspberry Pi 480x320 SPI TFT Display (3.5 inches)](#raspberry-pi-480x320-spi-tft-display-35-inches)
* [Further info](#further-info)
* [Sipeed Longan Nano RISC-V proto board (GD32VF103CBT6)](#sipeed-longan-nano-risc-v-proto-board-gd32vf103cbt6)
* [DFU mode](#dfu-mode)
* [Upload demo sketch](#upload-demo-sketch)
* [Raspberry Pi HDMI LCD display (800x480, 4")](#raspberry-pi-hdmi-lcd-display-800x480-4)
* [Raspberry Pi Pico (RP2040)](#raspberry-pi-pico-rp2040)
* [PCA9685 driver board](#pca9685-driver-board)
* [MP3 Modules](#mp3-modules)
* [VS1053 notes](#vs1053-notes)
* [Bosch BMP280](#bosch-bmp280)
* [TM1637 based Display](#tm1637-based-display)
* [ESP32 board with 1.14" RGB ST7789V TFT display](#esp32-board-with-114-rgb-st7789v-tft-display)
* [Misc](#misc)
* [WS2812 protection circuit](#ws2812-protection-circuit)
* [WS2812 protection circuit](#ws2812-protection-circuit)
* [Author](#author)

<!-- vim-markdown-toc -->
Expand Down Expand Up @@ -112,11 +113,11 @@ to play games like e.g. Arkanoid. Simulates an USB mouse and needs no drivers.
Simulates an USB mouse using an Attiny85 (Digispark board) and randomly moves
your mouse (see The Simpsons S07E07).
* https://github.com/jandelgado/simpson-device
* https://github.com/jandelgado/simpson-device
## Sketches
To build the demo sketches you can either copy the folders to the source
To build the demo sketches you can either copy the folders to the source
folder of your Arduino IDE or use PlatformIO and the provided makefiles, e.g.:
```
Expand Down Expand Up @@ -155,13 +156,13 @@ rmation.
### WEMOS D-Duino
The Wemos D-Duino is an ESP8266 board with an integrated SSD1306 OLED display
connected via I2C.
connected via I2C.
<img alt="wemos-d-duino" width=256 src="images/wemos-d-duino.png">
* SSD1306 is connected with I2C and SCL connected to D2 and SDA connected
to D1.
* see [example sketch](wemos_d_duino) for an example on how to use it with
* see [example sketch](wemos_d_duino) for an example on how to use it with
the u8g2 library.
### ESP32 TTGO
Expand All @@ -178,7 +179,7 @@ switch.
* SSD1306 is connected with I2C and SCL connected to GPIO4 and SDA connected
to GPIO5.
* the builtin blue LED is connected to GPIO 16
* see [example sketch](esp32_ttgo) for an example on how to use it with
* see [example sketch](esp32_ttgo) for an example on how to use it with
the u8g2 library.
### Heltec WiFi Lora 32
Expand All @@ -201,7 +202,7 @@ transceiver.
</p>
The display is labeled with `RPi Display 480x320 Pixel XPT246 Touch Controller`
and uses an `ILI9486` controller. In raspian (tested with `2018-11-13 Raspian`).
and uses an `ILI9486` controller. In raspian (tested with `2018-11-13 Raspian`).
no additional drivers are needed. I got it running with the following configuration:
Add to `/boot/config.txt`:
Expand Down Expand Up @@ -275,7 +276,7 @@ Found DFU: [28e9:0189] ver=1000, devnum=7, cfg=1, intf=0, path="1-2", alt=1, nam
Found DFU: [28e9:0189] ver=1000, devnum=7, cfg=1, intf=0, path="1-2", alt=0, name="@Internal Flash /0x08000000/512*002Kg", serial="??"
```
#### Upload demo sketch
#### Upload demo sketch
Before uploading to the MCU, make sure you installed [the udev rules as described here](https://docs.platformio.org/en/latest/faq.html#faq-udev-rules). Afterwards a
`udevadm control --reload-rules && udevadm trigger` (as root) might be necessary.
Expand Down Expand Up @@ -304,7 +305,7 @@ TODO
<img alt="rpi tft hdmi" width=256 src="images/rpi_tft_hdmi_2.jpg">
</p>
The display is labelled "4inch HDMI LCD". The resolution is 800x480 and the
The display is labelled "4inch HDMI LCD". The resolution is 800x480 and the
display has a built in XPT2046 touch controller.
I had to power both the Raspi (RPi 3) and the display to get it run. The display
Expand Down Expand Up @@ -353,7 +354,7 @@ and a [simple build script](https://github.com/jandelgado/jled/blob/4.7.0/exampl
The PCA9685 is an **I2C bus** controlled LED/Servo controller **with 16
individually controllable PWM channels**. Each channel has a resolution of 12
bits, resulting in 4096 steps. All channels operate at the same fixed
frequency, which must be in the range between 24Hz and 1526Hz.
frequency, which must be in the range between 24Hz and 1526Hz.
The board operates at 3V to 5V, which is fed through the VCC pin. The V+ pin
is optional and is used to power servos or LEDs with up to 6V. The V+ voltage
Expand All @@ -368,14 +369,14 @@ SDA and SCL are the I2C data and clock pins. The OE pin is optional (and pulled
down by default) and is used to quickly disable all outputs (by setting OE to
high level).
The I2C address is by default `0x40` and can be changed by closing the `A0` to
The I2C address is by default `0x40` and can be changed by closing the `A0` to
`A5` pins using a soldering iron.
<img src="images/pca9685.png" width=400>
There are many libraries for PCA9685 based boards out there, I successfully
used the [Adafruit PWM Servo Driver
library](https://github.com/adafruit/Adafruit-PWM-Servo-Driver-Library).
library](https://github.com/adafruit/Adafruit-PWM-Servo-Driver-Library).
Have a look at [this example here](pca9685).
### MP3 Modules
Expand Down Expand Up @@ -410,7 +411,7 @@ Summary:
* WTV020M01 is not recommended since not supporting MP3 format and very
restrictive regarding SD cards used and audio encoding
* The GPD2856A based boards are designed as stand alone players and are not
meant to be controlled by a micro controller.
meant to be controlled by a micro controller.
* The DFPlayer Mini is a reliable board which can be controlled by a micro
controller. It has an amplifier built in as well as an equalizer.
* The VL1053 based shield supports many file formats and even recording of
Expand All @@ -419,7 +420,7 @@ Summary:
controller. It lacks an amplifier and offers only a serial interface for
control.
Addiontial links:
Addiontial links:
* DFPlayerMini: https://wiki.dfrobot.com/DFPlayer_Mini_SKU_DFR0299
* Catalex: http://geekmatic.in.ua/pdf/Catalex_MP3_board.pdf
* GPD2856A: https://www.petervis.com/Electronics_Kits/gpd2856a/gpd2856a-mp3-decoder-board.html
Expand All @@ -440,7 +441,7 @@ plugin did not load. Refer to the
[documentation](http://www.vlsi.fi/fileadmin/software/VS10XX/VorbisEncoder170c.pdf)
for more details.
Libraries and examples:
Libraries and examples:
* https://github.com/adafruit/Adafruit_VS1053_Library
* https://github.com/madsci1016/Sparkfun-MP3-Player-Shield-Arduino-Library
Expand All @@ -456,7 +457,7 @@ boards available, mine is labeled `GY-BME/PM280` and costs about 1.60€
(02/2023). I successfully connected it using I²C and CircuitPython, running on
an Raspberry Pi Pico W using the
[adafruit_bmp280](https://github.com/adafruit/Adafruit_CircuitPython_BMP280)
library (install on the Pico Pi with `circup adadfruit_bmp280`).
library (install on the Pico Pi with `circup adadfruit_bmp280`).
In the example I connected the sensor as follows:
Expand Down Expand Up @@ -526,6 +527,60 @@ display.scroll("hello world")
display.temperature(23)
```

### ESP32 board with 1.14" RGB ST7789V TFT display

<p float="left">
<img src="images/esp32_st7789v_3.jpg" height=200>
<img src="images/esp32_st7789v_1.jpg" height=200>
<img src="images/esp32_st7789v_2.jpg" height=200>
</p>

This module was sold on aliexpress in different variations as
_T-Display T-PicoC3 ESP32 S3 1,9 Zoll WiFi und Bluetooth-kompatibles Modul
ESP32 C3 Entwicklungsboard 1,14 Zoll LCD für Arduino_. I ordered the ESP32-S3
version, but the one I got had an ESP32-D0WDQD6 and not an ESP32-S3, as
advertised. According to the specs, the display is a 1.14" RGB TFT display with
an ST7789V controller, connected through SPI and wired as follows:

| Signal | Pin |
|------------- |-----|
| `MOSI` | 19 |
| `SCLK` | 18 |
| `CS` | 5 |
| `DC` | 16 |
| `RST` | 23 |
| `BL` | 4 |

I tested 2 different libraries to control the TFT:

1. [deirvlon/ST7789v-Arduino](https://github.com/deirvlon/ST7789v-Arduino):
while I had initially success in getting displayed at least anything,
further inspection of the [code](https://github.com/deirvlon/ST7789v-Arduino/blob/main/ST7789v_arduino.cpp#L545)
revealed, that the lib is hardwired to a resoultion of 240x320 pixels, resulting
in a wrong geometry of displayed graphics
2. [adafruit/Adafruit ST7735 and ST7789 Library](https://github.com/adafruit/Adafruit-ST7735-Library):
this lib worked, and I have adapted one of the original [demos here](esp32_st7789v/test.ino),
with the proper configuration

I eventually found out, that `BL` stands for `BACKLIGHT` and that the backlight
must be turned on for obvious reasons.For that, I added the following code:

```c++
...
#define BL 4
...

void setup() {
...
// turn the backlight on
pinMode(BL, OUTPUT);
digitalWrite(BL, 1);
...
}
```

See this [sketch](esp32_st7789v/test.ino) for a working example.

## Misc

### WS2812 protection circuit
Expand Down
1 change: 1 addition & 0 deletions esp32_st7789v/Makefile
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
../.common/Makefile
10 changes: 10 additions & 0 deletions esp32_st7789v/platformio.ini
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
[platformio]
default_envs = esp32
src_dir = .

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 9600
lib_deps=adafruit/Adafruit ST7735 and ST7789 [email protected]
Loading

0 comments on commit 2865840

Please sign in to comment.