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.
Recommended Boards~
| 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.
Recommended Display~
Lolin TFT 2.4"~
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.
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~
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: