add heltec-v4-r8 board#10268
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds support for the Heltec WiFi LoRa 32 V4 “R8” (16MB flash / 8MB PSRAM) as a distinct hardware variant due to its incompatible pinout, and wires it into default firmware behavior for TFT/touch + RF frontend configuration.
Changes:
- Introduces new ESP32-S3 variant definition for
heltec_v4_r8(pins, PlatformIO envs, and board JSON). - Updates TFT/touch configuration to support Heltec V4 / V4-R8 TFT specifics (touch I2C port selection, SPI 3-wire setting).
- Extends defaults/curves to cover the new model (BT default-off for TFT, PA gain curve).
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| variants/esp32s3/heltec_v4_r8/variant.h | Defines the Heltec V4 R8 pinout, LoRa + FEM wiring, and GPS pins. |
| variants/esp32s3/heltec_v4_r8/platformio.ini | Adds PlatformIO environments for OLED and TFT builds, including display/touch/SD settings and libs. |
| variants/esp32s3/heltec_v4_r8/pins_arduino.h | Provides Arduino core pin defaults for the new variant. |
| variants/esp32s3/heltec_v4/platformio.ini | Adjusts Heltec V4 TFT touch I2C port and SPI 3-wire setting. |
| src/mesh/NodeDB.cpp | Disables Bluetooth by default on HELTEC_V4_R8_TFT (consistent with other TFT targets). |
| src/graphics/TFTDisplay.cpp | Extends Heltec-specific touch driver logic and makes SPI 3-wire configurable. |
| src/configuration.h | Adds TX gain curve for HELTEC_V4_R8 with LoRa FEM enabled. |
| boards/heltec_v4_r8.json | Adds PlatformIO board definition for Heltec V4 R8 (flash/PSRAM/memory type). |
Co-authored-by: Copilot <copilot@github.com>
mverch67
approved these changes
Apr 26, 2026
mverch67
left a comment
Collaborator
There was a problem hiding this comment.
I've updated the platformio according my comments/changes in device-ui.
Note: latest device-ui commit depends on this PR and vice versa
1 task
thebentern
added a commit
that referenced
this pull request
Apr 27, 2026
* add heltec-v4-r8 board * Fixed default SPI pin and macro definition errors. * update platformio.ini according device-ui LGFX display definitions Co-authored-by: Copilot <copilot@github.com> * fix commit reference --------- Co-authored-by: Ben Meadors <benmmeadors@gmail.com> Co-authored-by: mverch67 <manuel.verch@gmx.de> Co-authored-by: Copilot <copilot@github.com> Co-authored-by: Manuel <71137295+mverch67@users.noreply.github.com>
mariotti
pushed a commit
to mariotti/firmware
that referenced
this pull request
May 6, 2026
* add heltec-v4-r8 board * Fixed default SPI pin and macro definition errors. * update platformio.ini according device-ui LGFX display definitions Co-authored-by: Copilot <copilot@github.com> * fix commit reference --------- Co-authored-by: Ben Meadors <benmmeadors@gmail.com> Co-authored-by: mverch67 <manuel.verch@gmx.de> Co-authored-by: Copilot <copilot@github.com> Co-authored-by: Manuel <71137295+mverch67@users.noreply.github.com>
Evil8it
pushed a commit
to Evil8it/ME4TACTNK
that referenced
this pull request
Jun 10, 2026
* add heltec-v4-r8 board * Fixed default SPI pin and macro definition errors. * update platformio.ini according device-ui LGFX display definitions Co-authored-by: Copilot <copilot@github.com> * fix commit reference --------- Co-authored-by: Ben Meadors <benmmeadors@gmail.com> Co-authored-by: mverch67 <manuel.verch@gmx.de> Co-authored-by: Copilot <copilot@github.com> Co-authored-by: Manuel <71137295+mverch67@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The RAM has been increased compared to the original v4 to facilitate the use of more functions such as maps. However, the pinout is significantly different from the original v4 and incompatible, so a new model has been submitted.
The other two relevant commits are meshtastic/device-ui#308 and meshtastic/protobufs#898.
🤝 Attestations