feat(heltec): solo dual-transport builds for Heltec V3/V4

Port the Wio Tracker L1 solo firmware (full on-device UI, dual BLE/USB
companion transport) to Heltec V3 and V4 OLED boards. Neither board has
a joystick or CardKB on-board, so each new env wires up both as optional
peripherals with default pins from what the board leaves free, gated
behind the existing UI_HAS_JOYSTICK/ENV_PIN_SDA+SCL flags.

DUAL_SERIAL was nRF52-only; added an ESP32 helpers/esp32/DualSerialInterface.h
counterpart so the flag isn't silently ignored on these boards. On V4's
native USB CDC, isClientConnected() also honours (bool)Serial (real DTR),
same as the nRF52 version; V3 has no native CDC so it stays BLE-only there.

Screen (SDA 17/SCL 18) and CardKB (SDA 3/SCL 4) confirmed working on real
V4 hardware.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Jakub
2026-08-06 20:08:31 +02:00
co-authored by Claude Sonnet 5
parent f8b9e1acb8
commit 2bde84a573
10 changed files with 307 additions and 0 deletions
+14
View File
@@ -26,6 +26,20 @@ AutoDiscoverRTCClock rtc_clock(fallback_clock);
#ifdef DISPLAY_CLASS
DISPLAY_CLASS display(NULL);
MomentaryButton user_btn(PIN_USER_BTN, 1000, true);
#if UI_HAS_JOYSTICK
// Optional wired joystick — see the heltec_v4_companion_solo_dual env for the
// pin defines this needs. Unlike the Wio Tracker L1 (external pull-ups on
// board) these pass pulldownup = true, so each contact only has to short its
// pin to GND; the internal pull-up does the rest. Back gets multiclick = true
// because the UI's triple-click buzzer toggle lives on it.
MomentaryButton joystick_left (JOYSTICK_LEFT, 1000, true, true, false);
MomentaryButton joystick_right(JOYSTICK_RIGHT, 1000, true, true, false);
MomentaryButton back_btn (PIN_BACK_BTN, 1000, true, true, true);
#if UI_HAS_JOYSTICK_UPDOWN
MomentaryButton joystick_up (JOYSTICK_UP, 1000, true, true, false);
MomentaryButton joystick_down(JOYSTICK_DOWN, 1000, true, true, false);
#endif
#endif
#endif
bool radio_init() {