Files
MeshCore/variants/heltec_v4/target.cpp
T
mikecarper b00d346df7 Unify Heltec V4 OLED, TFT and headless display selection
Detect OLED or the original stock TFT touch assembly in ordinary V4.2/V4.3
images. Add saved live display.type auto/oled/tft/off selection and report
the active selection in board output. Keep sensors on primary I2C, preserve
shared power, and isolate TFT FSPI from radio HSPI through sleep and changes.

Consolidate future picker/build choices only with application capability
proof. Retain exact legacy OTA identities and separate R8 hardware images.
Document controls and physical qualification limits.

Validation: five serialized Full builds with capability/size/RAM checks;
focused host tests, existing R8/T-Deck/OLED regressions, build-profile suite,
and picker/provider tests. V4.3 OLED live changes and off/auto reboot
persistence passed on Mercerwood. Physical TFT qualification remains pending.
2026-10-26 15:19:17 -07:00

93 lines
3.1 KiB
C++

#include <Arduino.h>
#include "target.h"
#include <helpers/radiolib/SX126xBufferedRadioHal.h>
HeltecV4Board board;
#if defined(HELTEC_V4_OLED_KIT_COMPAT) && HELTEC_V4_OLED_KIT_COMPAT == 1
extern const char meshcore_capability_heltec_v4_oled_kit[];
const char meshcore_capability_heltec_v4_oled_kit[] =
"meshcore.capability.hardware.heltec_v4.oled_kit.v1";
#endif
#if defined(HELTEC_V4_TFT_KIT_COMPAT) && HELTEC_V4_TFT_KIT_COMPAT == 1 \
&& defined(HELTEC_LORA_V4_TFT) && defined(DISPLAY_CLASS) \
&& defined(PIN_BOARD_SDA) && PIN_BOARD_SDA == 4 \
&& defined(PIN_BOARD_SCL) && PIN_BOARD_SCL == 3 \
&& defined(PIN_TFT_RST) && PIN_TFT_RST == 18 \
&& defined(PIN_TFT_LEDA_CTL) && PIN_TFT_LEDA_CTL == 21 \
&& defined(PIN_TFT_CS) && PIN_TFT_CS == 15 \
&& defined(PIN_TFT_DC) && PIN_TFT_DC == 16 \
&& defined(PIN_TFT_SCL) && PIN_TFT_SCL == 17 \
&& defined(PIN_TFT_SDA) && PIN_TFT_SDA == 33
#define MESHCORE_HELTEC_V4_TFT_KIT_COMPAT 1
#include <type_traits>
extern const char meshcore_capability_heltec_v4_tft_kit[];
const char meshcore_capability_heltec_v4_tft_kit[] =
"meshcore.capability.hardware.heltec_v4.tft_kit.v1";
#endif
#if defined(P_LORA_SCLK)
#if defined(HELTEC_V4_DISPLAY_UNIFIED) && HELTEC_V4_DISPLAY_UNIFIED
static SPIClass spi(HSPI); // TFT owns FSPI; never share its reset/remap.
#else
static SPIClass spi;
#endif
static SX126xBufferedRadioHal radio_hal(spi);
RADIO_CLASS radio = new Module(&radio_hal, P_LORA_NSS, P_LORA_DIO_1, P_LORA_RESET, P_LORA_BUSY);
#else
static SX126xBufferedRadioHal radio_hal(SPI, MC_SX1262_SPI_HZ, true);
RADIO_CLASS radio = new Module(&radio_hal, P_LORA_NSS, P_LORA_DIO_1, P_LORA_RESET, P_LORA_BUSY);
#endif
WRAPPER_CLASS radio_driver(radio, board);
ESP32RTCClock fallback_clock;
AutoDiscoverRTCClock rtc_clock(fallback_clock);
#if ENV_INCLUDE_GPS
#include <helpers/sensors/MicroNMEALocationProvider.h>
MicroNMEALocationProvider nmea = MicroNMEALocationProvider(Serial1, &rtc_clock);
EnvironmentSensorManager sensors = EnvironmentSensorManager(nmea);
#else
EnvironmentSensorManager sensors;
#endif
#ifdef DISPLAY_CLASS
// VEXT is shared with the expansion sensors. Display selection must not
// acquire or switch that rail when entering headless/off mode.
DISPLAY_CLASS display(NULL);
MomentaryButton user_btn(PIN_USER_BTN, 1000, true);
#endif
bool radio_init() {
#if defined(HELTEC_V4_OLED_KIT_COMPAT) && HELTEC_V4_OLED_KIT_COMPAT == 1
const volatile char* capability = meshcore_capability_heltec_v4_oled_kit;
(void)*capability;
#endif
#if defined(MESHCORE_HELTEC_V4_TFT_KIT_COMPAT)
#if defined(HELTEC_V4_DISPLAY_UNIFIED) && HELTEC_V4_DISPLAY_UNIFIED
{
#else
if (std::is_same<DISPLAY_CLASS, ST7789LCDDisplay>::value) {
#endif
const volatile char* capability = meshcore_capability_heltec_v4_tft_kit;
(void)*capability;
}
#endif
fallback_clock.begin();
rtc_clock.begin(Wire);
#if defined(P_LORA_SCLK)
return radio.std_init(&spi);
#else
return radio.std_init();
#endif
}
mesh::LocalIdentity radio_new_identity() {
RadioNoiseListener rng(radio);
return mesh::LocalIdentity(&rng); // create new random identity
}