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.
This commit is contained in:
mikecarper committed 2026-10-26 15:19:17 -07:00
1 parent 5b5708283d
commit b00d346df7
43 files changed
+2123 -76

No files matched your search

+34
View File
@@ -1310,6 +1310,40 @@ build flag is needed.
---
## Select the original Heltec V4 display
New unified original-V4 images support V4.2/V4.3 OLED, the original TFT
touchscreen expansion kit, and operation without a screen. This feature is
not present in the older 1.17.1.1 or 1.17.1.5 images. V4 R8 remains a separate
hardware target.
```text
get display.type
set display.type auto
set display.type oled
set display.type tft
set display.type off
board
```
The default `auto` requires an OLED I2C response or a stable identity from the
stock TFT assembly's touch controller. No OLED response alone is not evidence
of a TFT. When neither responds, the node runs without a screen and `board`
reports `none detected`. Touch identification establishes the stock assembly,
not LCD health. A damaged or nonstandard panel can require an override.
`oled` explicitly selects and checks the OLED driver. `tft` explicitly selects
the TFT driver and reports `TFT (forced)` rather than claiming detection.
`off` disables display initialization and reports `off`, distinct from
`none detected`. Selections apply immediately and survive reboot in the checked
`/display_type` file. A failed save leaves the live selection unchanged.
`board` combines the detected radio front end with the live display status,
for example `Heltec V4.3 OLED`, `Heltec V4.2 TFT`, or `Heltec V4.3 off`.
The radio front end identifies the V4.2/V4.3 hardware generation; it is not a
read of a PCB revision register. Use `display.mode` below for normal screen
sleep/wake policy without changing the selected hardware driver.
## Set display modes and timeouts
Companion message sound, vibration, LED, screen and GPIO rules have separate