feat(board): add LilyGo T-Beam Supreme support with AXP2101 and SH1106

Upgrades the existing TTGO_TBEAM_SX1262 board entry with full hardware
support for the LilyGo T-Beam Supreme S3, a newer revision of the same
board line. The original entry had basic pin mappings but lacked PMU
support, display driver, and auto-detection.

Board entry changes:
- TCXO voltage 1.6V to 1.8V (Meshtastic/community standard)
- LED pin uses SUPREME_LED define, GNSS pins mapped
- Renamed to "433 Mhz LilyGo T-Beam Supreme SX1262"
- Board index bounds check on boot prevents crash if enum changes

New hardware support:
- AXP2101 PMU on Wire1 (GPIO 42/41): battery voltage/percentage, VBUS,
  per-rail power control (ALDO1 sensors, ALDO3 radio, ALDO4 GNSS),
  sensor deep sleep, unused rails disabled
- SH1106 OLED auto-detection with 5-minute display timeout
- Auto-detection via AXP2101 probe on Wire1 in boardDetection()
- DIO2 RF switch enable for SX1262/SX1268
- Battery voltage via Power API replacing raw analogRead(36) median-sort

Includes board JSON, PlatformIO env, and setup documentation.
433 MHz SX1262 variant only.

Author: Bwooce

boards/lilygo-t-beam-supreme.json

@@ -0,0 +1,51 @@
+{
+  "build": {
+    "arduino":{
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "default.csv",
+      "memory_type": "qio_qspi"
+    },
+    "core": "esp32",
+    "extra_flags": [
+      "-DARDUINO_USB_MODE=1",
+      "-DARDUINO_USB_CDC_ON_BOOT=1",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "hwids": [
+      [
+        "0x303A",
+        "0x1001"
+      ]
+    ],
+    "mcu": "esp32s3",
+    "variant": "esp32s3"
+  },
+  "connectivity": [
+    "wifi"
+  ],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": [
+      "esp-builtin"
+    ],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": [
+    "arduino",
+    "espidf"
+  ],
+  "name": "LilyGo T-Beam supreme (8MB Flash 8MB PSRAM)",
+  "upload": {
+    "flash_size": "8MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 8388608,
+    "require_upload_port": true,
+    "speed": 460800
+  },
+  "url": "https://www.lilygo.cc/products/t-beamsupreme-m",
+  "vendor": "LilyGo"
+}

doc/LilyGo_T-Beam_Supreme.md

@@ -0,0 +1,55 @@
+# LilyGo T-Beam Supreme (S3) Setup for TinyGS
+
+The LilyGo T-Beam Supreme is an ESP32-S3 based board with an SX1262 LoRa radio, AXP2101 PMU, and an integrated GPS (Ublox M10 or L76K).
+
+## Pin Mapping (Verified)
+
+| Function | Pin (GPIO) |
+| :--- | :--- |
+| **LoRa CS (NSS)** | 10 |
+| **LoRa DIO1** | 1 |
+| **LoRa BUSY** | 4 |
+| **LoRa RESET** | 5 |
+| **LoRa SCK** | 12 |
+| **LoRa MISO** | 13 |
+| **LoRa MOSI** | 11 |
+| **I2C SDA** | 17 |
+| **I2C SCL** | 18 |
+| **GPS TX** | 8 |
+| **GPS RX** | 9 |
+| **GPS Wakeup** | 7 |
+| **PMU SDA** | 42 (Wire1) |
+| **PMU SCL** | 41 (Wire1) |
+| **User Button** | 0 |
+| **Green LED** | 3 |
+
+## Features
+
+### 1. Power Management (AXP2101)
+- Full support for AXP2101 PMU via Wire1.
+- Correct battery voltage reading (1mV/bit).
+- Accurate fuel gauge percentage.
+- Automatic power control for Radio and GPS.
+
+### 2. Display (SH1106)
+- SH1106 OLED driver (vs SSD1306 on other boards).
+- Auto-off after 5 minutes of inactivity to save power.
+- Wakes on button press or serial input.
+
+### 3. Power Saving
+- **Shared Rail (ALDO1)**: Powers the OLED and onboard sensors (QMC5883L Compass, BME280). This rail remains active even when the display is off.
+- **Radio Rail (ALDO3)**: Powers the SX1262 LoRa module.
+- **GPS Rail (ALDO4)**: Powers the GNSS module independently.
+- **Unused Rails**: Unused PMU rails (ALDO2, BLDO1/2, DLDO1/2) are explicitly disabled to minimize quiescent current.
+
+## Configuration
+
+1. Connect to the TinyGS Access Point.
+2. Navigate to `http://192.168.4.1/config`.
+3. Select **433 Mhz LilyGo T-Beam Supreme SX1262** as the board type.
+4. Save and Restart.
+
+## Troubleshooting
+
+- **No Packets**: Ensure you are using a 433MHz or 868/915MHz antenna matching your board variant. The SX1262 pins are identical for all frequency variants.
+- **Battery 0.00V**: Ensure the board is selected as "Supreme" to enable the AXP2101 driver.

platformio.ini

@@ -81,3 +81,17 @@ build_flags =
   ${env.build_flags}
   -DBOARD_HAS_PSRAM
 board_build.partitions = tinygs_4M_partition_table.csv
+
+[env:lilygo-t-beam-supreme]
+platform = https://github.com/pioarduino/platform-espressif32/releases/download/stable/platform-espressif32.zip
+board = lilygo-t-beam-supreme
+board_build.mcu = esp32s3
+framework = arduino
+build_flags =
+  ${env.build_flags}
+  -DARDUINO_USB_CDC_ON_BOOT=1
+  -DBOARD_HAS_PSRAM
+board_build.partitions = tinygs_4M_partition_table.csv
+lib_deps =
+  ${env.lib_deps}
+  mikalhart/TinyGPSPlus @ ^1.0.3

tinyGS/src/ConfigManager/ConfigManager.cpp

@@ -69,6 +69,14 @@ constexpr auto configVersion = "0.05"; //max 4 chars
 #define MQTT_DEFAULT_SERVER "mqtt.tinygs.com"
 #define MQTT_DEFAULT_PORT "8883"
 
+// T-Beam Supreme specific pins (Wire1 for PMU, separate from OLED Wire bus)
+#define SUPREME_GNSS_RX 9
+#define SUPREME_GNSS_TX 8
+#define SUPREME_GNSS_WAKEUP 7
+#define SUPREME_PMU_SDA 42
+#define SUPREME_PMU_SCL 41
+#define SUPREME_LED 3
+
 constexpr auto AP_TIMEOUT_MS = "300000";
 
 enum boardNum
@@ -130,15 +138,18 @@ struct board_t
   float L_TCXO_V;
   uint8_t RX_EN;
   uint8_t TX_EN;
+  uint8_t GNSS_RX;
+  uint8_t GNSS_TX;
+  uint8_t GNSS_WAKEUP;
   String BOARD;
 
   board_t() = default;
   board_t(uint8_t oled_addr, uint8_t oled_sda, uint8_t oled_scl, uint8_t oled_rst, uint8_t prog_btn, uint8_t board_led,
           uint8_t l_radio, uint8_t l_nss, uint8_t l_di00, uint8_t l_di01, uint8_t l_bussy, uint8_t l_rst, uint8_t l_miso, uint8_t l_mosi, uint8_t l_sck,
-          float l_tcxo_v, uint8_t rx_en, uint8_t tx_en, String board_name)
+          float l_tcxo_v, uint8_t rx_en, uint8_t tx_en, uint8_t gnss_rx, uint8_t gnss_tx, uint8_t gnss_wakeup, String board_name)
           : OLED__address(oled_addr), OLED__SDA(oled_sda), OLED__SCL(oled_scl), OLED__RST(oled_rst), PROG__BUTTON(prog_btn), BOARD_LED(board_led),
             L_radio(l_radio), L_NSS(l_nss), L_DI00(l_di00), L_DI01(l_di01), L_BUSSY(l_bussy), L_RST(l_rst), L_MISO(l_miso), L_MOSI(l_mosi), L_SCK(l_sck),
-            L_TCXO_V(l_tcxo_v), RX_EN(rx_en), TX_EN(tx_en), BOARD(board_name) {}
+            L_TCXO_V(l_tcxo_v), RX_EN(rx_en), TX_EN(tx_en), GNSS_RX(gnss_rx), GNSS_TX(gnss_tx), GNSS_WAKEUP(gnss_wakeup), BOARD(board_name) {}
 };
 
 const uint8_t UNUSED = -1;

tinyGS/src/ConfigManager/ConfigManager.h

@@ -29,9 +29,9 @@ const char BOARD_NAMES[][BOARD_NAME_LENGTH] PROGMEM =
   #if CONFIG_IDF_TARGET_ESP32S3
   "433MHz HELTEC LORA32 V3",
   "Custom ESP32-S3 433MHz SX1278",
-  "433 Mhz TTGO T-Beam Sup SX1262 V1.0",
-  "EBYTE EoRa-HUB ESP32S3 + LR1121",
+  "433 Mhz LilyGo T-Beam Supreme SX1262",
   "2.4Ghz LILYGO SX1280",
+  "EBYTE EoRa-HUB ESP32S3 + LR1121",
   #elif CONFIG_IDF_TARGET_ESP32C3  
   "433MHz HELTEC LORA32 HT-CT62 SX1262",
   "Custom ESP32-C3 433MHz SX1278",

tinyGS/src/ConfigManager/html.h

@@ -23,9 +23,13 @@
 #include "../Mqtt/MQTT_credentials.h"
 #include "../Logger/Logger.h"
 
-SSD1306* display;
+OLEDDisplay* display;
 OLEDDisplayUi* ui = NULL;
 
+#define DISPLAY_TIMEOUT 300000  // 5 minutes
+static unsigned long lastDisplayActivity = 0;
+static bool displayTimedOut = false;
+
 void msOverlay(OLEDDisplay *display, OLEDDisplayUiState* state);
 void drawFrame1(OLEDDisplay *display, OLEDDisplayUiState* state, int16_t x, int16_t y);
 void drawFrame2(OLEDDisplay *display, OLEDDisplayUiState* state, int16_t x, int16_t y);
@@ -55,8 +59,18 @@ void displayInit()
    if (!ConfigManager::getInstance().getBoardConfig(board))
     return;
 
-  display = new SSD1306(board.OLED__address, board.OLED__SDA, board.OLED__SCL);
+  uint8_t boardIdx = ConfigManager::getInstance().getBoard();
+#if CONFIG_IDF_TARGET_ESP32S3
+  if (boardIdx == TTGO_TBEAM_SX1262) {
+      Log::console(PSTR("Display: Initializing SH1106 for T-Beam Supreme"));
+      display = new SH1106Wire(board.OLED__address, board.OLED__SDA, board.OLED__SCL);
+  } else
+#endif
+  {
+      display = new SSD1306Wire(board.OLED__address, board.OLED__SDA, board.OLED__SCL);
+  }
 
+  lastDisplayActivity = millis();
   ui = new OLEDDisplayUi(display);
   ui->setTargetFPS(60);
   ui->setActiveSymbol(activeSymbol);
@@ -355,6 +369,15 @@ void displayUpdate()
   // Get the current OLED brightness from configuration
   uint8_t oledBright = ConfigManager::getInstance().getOledBright();
 
+  // Check display timeout
+  if (oledBright && !displayTimedOut && (millis() - lastDisplayActivity > DISPLAY_TIMEOUT)) {
+    displayTimedOut = true;
+    display->displayOff();
+    return;
+  }
+
+  if (displayTimedOut) return;
+
   // Check if brightness has changed
   if (oldOledBright != oledBright) {
     if (oledBright) {
@@ -374,6 +397,16 @@ void displayUpdate()
   }
 }
 
+void displayResetTimeout()
+{
+  lastDisplayActivity = millis();
+  if (displayTimedOut) {
+    displayTimedOut = false;
+    display->displayOn();
+    oldOledBright = -1; // force brightness reapply
+  }
+}
+
 void displayTurnOff()
 {
   display->displayOff();

tinyGS/src/Display/Display.cpp

@@ -17,8 +17,10 @@
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-#include "SSD1306.h"                         // https://github.com/ThingPulse/esp8266-oled-ssd1306
-#include "OLEDDisplayUi.h"                   // https://github.com/ThingPulse/esp8266-oled-ssd1306
+#include "OLEDDisplay.h"                        // https://github.com/ThingPulse/esp8266-oled-ssd1306
+#include "SSD1306Wire.h"
+#include "SH1106Wire.h"
+#include "OLEDDisplayUi.h"
 #include "../ConfigManager/ConfigManager.h"
 #include "../Status.h"
 
@@ -30,7 +32,9 @@ void displayShowStaMode(bool ap);
 void displayUpdate();
 void displayTurnOff();
 void displayNextFrame();
+void displayResetTimeout();
 
+extern OLEDDisplay* display;
 extern Status status;
 
 

tinyGS/src/Display/Display.h

@@ -26,6 +26,7 @@
 #include "../Radio/Radio.h"
 #include "../OTA/OTA.h"
 #include "../Logger/Logger.h"
+#include "../Power/Power.h"
 #include <esp_ota_ops.h>
 
 
@@ -108,7 +109,7 @@ void MQTT_Client::loop()
     else
     {
       StaticJsonDocument<192> doc;
-      doc["Vbat"] = voltage();
+      doc["Vbat"] = Power::getInstance().getBatteryVoltage();
       doc["Mem"] = ESP.getFreeHeap();
       doc["MinMem"] = ESP.getMinFreeHeap();    // Mínimo histórico
       doc["MaxBlk"] = ESP.getMaxAllocHeap();   // Bloque más grande disponible
@@ -249,7 +250,7 @@ void MQTT_Client::sendWelcome()
   doc["board"] = configManager.getBoard();
   doc["mac"] = clientId;
   doc["seconds"] = millis()/1000;
-  doc["Vbat"] = voltage();
+  doc["Vbat"] = Power::getInstance().getBatteryVoltage();
   doc["chip"] = ESP.getChipModel();
   doc["slot"] = esp_ota_get_running_partition ()->label;
   doc["pSize"] = esp_ota_get_running_partition ()->size;
@@ -1180,34 +1181,4 @@ void MQTT_Client::begin()
 
 
 
-int MQTT_Client::voltage() {
-  int medianVoltage;
-  int length = 21;
-  int voltages[22];
-  
-  for (int i = 0; i < 21; i++)
-  {
-    voltages[i] = analogRead(36); 
-    }
-  
-  //    BubbleSortAsc   from https://www.luisllamas.es/arduino-bubble-sort/
-   int i, j, flag = 1;
-   int temp;
-   for (i = 1; (i <= length) && flag; i++)
-   {
-      flag = 0;
-      for (j = 0; j < (length - 1); j++)
-      {
-         if (voltages[j + 1] < voltages[j])
-         {
-            temp = voltages[j];
-            voltages[j] = voltages[j + 1];
-            voltages[j + 1] = temp;
-            flag = 1;
-         }
-      }
-   }
-  medianVoltage = voltages[10];
-  return medianVoltage;
-}
 

tinyGS/src/Mqtt/MQTT_Client.cpp

@@ -115,8 +115,6 @@ class MQTT_Client : public PubSubClient {
   void processRxQueue();
   void sendRxFromQueue(const RxPacketMessage& msg);  // Envía paquete desde la cola
 
-  int  voltage();
-  
   //bool usingNewCert = true;
   SemaphoreHandle_t radioConfigMutex;
   QueueHandle_t rxQueue;