Skip to content

Getting Started~

openHASP currently supports the ESP32 family of microcontrollers. It needs a compatible micro-controller with drivers supporting the attached display, touch controller, storage and network.

Below is a list of recommended development boards and a TFT touchscreen to get you up-and-running in no time.

Plug-and-play

  Basic Standard Capacity
Dev. Board* D1 mini ESP32 TTGO T7 v1.5 Mini32 Lolin D32 Pro V2.0
MCU ESP32-WROOM ESP32-WROVER ESP32-WROVER
CPU Freq. 240Mhz 240Mhz 240Mhz
Ram 520Kb 520Kb 520Kb
PSRam no yes yes
Flash 4MB 4MB or 16MB 16MB
Display ILI9341 SPI ILI9341 SPI ILI9341 SPI
Touch XPT2046 SPI XPT2046 SPI XPT2046 SPI
Network Wi-Fi Wi-Fi Wi-Fi
Firmware Download Download Download

Note

Due to the large number of possible hardware options a selection of 3 popular ESP development boards has been made for the precompiled binaries.

For new projects we recommend ESP32-WROVER boards with PSram and minimal 8MB of flash.

Tip

Advanced users can build and compile custom hardware configurations using PlatformIO locally or online with Gitpod, however this is not currently supported.

Lolin TFT 2.4"~

TFT-LED PWM dimming

ILI9341 SPI touchscreens with backlight dimming via PWM are quite cheap to get. An ILI9341 TFT display with SPI is required when using a pre-built binary. The touch controller needs to be the XPT2046 Resistive Touch driver.

The Lolin TFT 2.4" is plug-and-play with the 3 recommended ESP development boards. If you have another ESP or MCU, you can still use this display using jumper cables. You can also solder a row of headers at the bottom of the display to plug it into a breadboard. Therefor the Lolin TFT 2.4 Touch Shield is used as the development display of choice.

Backlight Control~

To use PWM dimming on the Lolin TFT 2.4" you must connect the TFT-LED pin to either D1, D2 or D4. D1 is recommended for backlight control and configured by default.

TFT-LED PWM dimming

Do not use D3 for backlight control because it is already in use for touch!

It is not recommended to use D4 for backlight control because it is already in use for PSram on the ESP32-Wrover. The D1-mini has D4 connected to on-board LED and boot fails if pulled LOW

Compatible ESP boards~

TFT-LED PWM dimming

The Lolin TFT 2.4" header is plug-and-play compatible with these development boards, no need to use any jumper cables:

ESP32:

  • Wemos D1 Mini ESP32 (only solder the inner row of pin headers)
  • TTGO T7 V1.5 MINI32 ESP32 (only solder the inner row of pin headers)
  • LOLIN D32 Pro V2.0.0 using an additional TFT cable

ESP32-S2:

  • Wemos S2 Mini ESP32-S2 (only solder the outer row of pin headers)

Note

If you have a Lolin TFT 2.4" Display and a compatible ESP development board, you have all the hardware that is needed. In that case you can skip ahead to the Firmware Installation.

Alternative SPI Display~

Any common ILI9341 320x240 4-wire SPI touchscreen with XPT2046 Resistive Touch driver can be used, like:

You will need to connect the GPIO pins using jumper wires.

Ready-made devices~

Some manufacturers offer IoT devices which are ready to go with openHASP: