Project Files of T-Beam Supreme Library for Proteus: ESP32-S3 LoRa GPS Tracker

LILYGO T-BEAM SUPREME LIBRARY FOR PROTEUS - V1.0 (YOUR ESP32-S3 SKETCH WITH LORA, GPS AND A 1.3" OLED ON THE BOARD)
Designed by The Engineering Projects
www.TheEngineeringProjects.com

IMPORTANT LINKS
Article (read it first - pictures, step by step, every feature explained):
  https://www.theengineeringprojects.com/2026/11/lilygo-t-beam-supreme-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/lilygo-t-beam-supreme-proteus-library
The demo's other parts are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/10/heltec-wifi-lora-32-v3-library-for-proteus.html
  https://www.theengineeringprojects.com/2026/09/bme280-sensor-library-for-proteus.html
The older T-Beam:
  https://www.theengineeringprojects.com/2026/10/lilygo-t-beam-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
LilyGO-T-Beam-Supreme-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPBME280.LIB                                    89.4 KB   the BME280 (demo), to LIBRARY
|   |-- TEPHELTECV3.LIB                                  34.3 KB   the base camp (Heltec V3) (demo), to LIBRARY
|   |-- TEPTBSUPREME.LIB                                 36.4 KB   the T-Beam Supreme, to LIBRARY
|-- Proteus Model Files/
|   |-- TEPBME280.DLL                                   381.0 KB   the BME280, to MODELS
|   |-- TEPNET.DLL                                       2.81 MB   the board + monitors + network, to MODELS
|-- Arduino Code/
|   |-- Heltec_Base_Camp/Heltec_Base_Camp.ino             4.2 KB   the demo sketch
|   |-- TBSupreme_Hiker_Tracker/TBSupreme_Hiker_Tracker.ino    8.0 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/                992.1 KB   the Arduino IDE add-on 1.48.0 (225 files)
|-- Proteus Simulation/
|   |-- Heltec_Base_Camp.hex                            166.2 KB   the base camp sketch (U2)
|   |-- T-Beam-Supreme-Hiker-Tracker.pdsprj              23.0 KB   the demo: a LoRa hiker tracker and its base camp
|   |-- TBSupreme_Hiker_Tracker.hex                     172.9 KB   the demo sketch (U1)
|   |-- TEPBME280.DLL                                   381.0 KB   copy of the model
|   |-- TEPNET.DLL                                       2.81 MB   copy of the model
|-- README.txt                                          ~12.9 KB   this file
Total: 7.87 MB (unzipped). The source code of the models is not included.

WHAT IS IT?
Proteus 8 has no ESP32-S3 or SX1262 processor model, so this is NOT a real ESP32-S3 chip. Our team has put a lot of
effort into
building this board ourselves: it is LilyGO's T-Beam Supreme - the black board with the T-Beam-S3 Core (ESP32-S3, an
SX1262 LoRa
radio and a MAX-M10S GNSS), the 1.3" SH1106 OLED, the SMA socket, USB-C and the RST, PWR and BOOT buttons - that runs
YOUR ESP32-S3
Arduino sketch in Proteus:
  * You write a normal T-Beam Supreme sketch (the GPIO numbers of the board, analogRead 0-4095, analogWrite, ledcWrite,
    attachInterrupt, Wire, SPI, Serial, WiFi, WebServer, HTTPClient ...) and compile it in the Arduino IDE with our
    board package
    "TEP Boards for Proteus" 1.48.0 (in Arduino Code - see INSTALLATION).
  * The SX1262 is ON the board: new Module(10, 1, 5, 4) with RadioLib talks to the other TEP LoRa boards of the design.
  * The GPS is ON the board: Serial1 gives NMEA at 9600 baud (RX 9, TX 8), read with TinyGPSPlus, from the properties
    GPSLAT, GPSLON,
    GPSALT, GPSSPEED, GPSHEADING, GPSSATS and GPSFIX.
  * The SH1106 OLED is ON the board at I2C 0x3C (SDA 17, SCL 18): what your sketch draws appears on the part.
The board lies in landscape, the SMA socket on the left. The 13 + 13 pads run along the OLED (top row: TXD RXD RST DC1
DC5 GND DC4
B-LDO2 GND VSYS GND VBUS VBAT; bottom row: IO48 IO21 IO6 IO3 IO2 IO38 IO39 IO45 IO46 A-LDO2 GND SCL SDA, from LilyGO's
pin diagram).
DC5, DC4, the LDOs, VSYS and VBAT are drawn only. It is smaller than the real board so that it fits an A4 sheet with
room to spare.
TEP additions: the PCB antenna's colours, the PANEL pad (or the OLED) opens the board's panel, the USB-C port opens
the serial
monitor.
Limits (say them before you start): your sketch gets 8 KB of RAM in the simulation (the real board: 512 KB plus 8 MB
of PSRAM), about
256 KB of flash, int is 16 bits in the simulation (use long / int32_t for big numbers), no FreeRTOS tasks, no second
core, no
Bluetooth, no ESP-IDF, no real TLS, no soft AP. The AXP2101 power chip, the board's own BME280, QMC6310, QMI8658,
PCF8563 and TF card,
and the second I2C bus are NOT modelled: the radio, the GPS and the OLED are always on. See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "T-BEAM SUPREME" in Pick Devices):
  T-BEAM SUPREME  "LilyGO T-Beam Supreme" V1.0 (Microprocessor ICs > ESP32 Boards), prefix U, model TEPNET.DLL. Two
  TEP windows, none
  with a Windows title bar: the panel (the PANEL pad: Wi-Fi, Pins, Test, Settings, Help) and the serial monitor (the
  USB-C port,
  115200 baud: Monitor, Plotter and Board tabs).
The same TEPNET.DLL also runs our other Wi-Fi boards; it replaces any older TEPNET.DLL (keep only this newest one in
MODELS).

TEST STATUS
V1.0: verified in Proteus 8.5 on 30 Oct 2026 with the demo project as shipped. What the Proteus run showed:
* T-Beam-Supreme-Hiker-Tracker: U1's monitor printed "BME280 ready", "SX1262 ready, 868.0 MHz SF7" and "GPS fix:
  35.3950, 74.5900  3300 m"; U2 printed "Listening on 868.0 MHz SF7".
* Every 5 s U1 sent a LoRa packet, U2 printed the distance, the direction, the height and the pressure, and answered:
  U1 printed "The base camp heard".
* STORM on the BME280's window: ">> STORM WARNING" on U1, ">> Storm warning from the hiker" on U2, both OLEDs showing
  it.
* BOOT (the monitor's Board tab): ">> SOS ON" on U1, ">> SOS from the hiker" on U2, its white LED on.
* about 30 s of simulation, no errors, with the pop-ups, the panels and the monitors open.

INSTALLATION (about 3 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" to the LIBRARY folder of Proteus, for example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (on some PCs: C:\ProgramData\Labcenter Electronics\Proteus 8 Professional\LIBRARY). TEPTBSUPREME.LIB is the board;
   the others
   are the demo's parts: TEPHELTECV3.LIB and TEPBME280.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPBME280.DLL) to the MODELS folder (...\Proteus 8
   Professional\MODELS) -
   replace an older TEPNET.DLL (this one is the first that knows the T-Beam Supreme).
4. Delete TEPTBSUPREME.IDX from the LIBRARY folder if it is there.
5. The Arduino IDE (only to compile your own sketches - the demo has its HEX files): copy the folder
   "Arduino Code\TEP Boards for Proteus\hardware" into your sketchbook folder (normally Documents\Arduino), so that
   Documents\Arduino\hardware\tep\avr\boards.txt exists (replace an older copy); restart the IDE. The Arduino AVR Boards
   platform must be installed (it comes with IDE 1.8.x; in IDE 2.x install "Arduino AVR Boards" from the Boards
   Manager once).
   Tools > Board > TEP Boards for Proteus > T-Beam Supreme (TEP Proteus). From the Library Manager: RadioLib,
   TinyGPSPlus,
   Adafruit BME280, Adafruit Unified Sensor, Adafruit GFX, Adafruit SSD1306.
6. Start Proteus. In Pick Devices (P) search "T-BEAM SUPREME".

RUN THE DEMO
Keep the .hex files and the DLLs beside the project in "Proteus Simulation".
T-Beam-Supreme-Hiker-Tracker.pdsprj - U1 the T-Beam Supreme (TBSupreme_Hiker_Tracker.hex) is a hiker's tracker in the
mountains, far
from any phone network: its GPS walks at 5 km/h, and U3 = a BME280 (Advance) on its I2C bus at 0x77 stands for the
sensor on a real
board. U2 = a Heltec WiFi LoRa 32 V3 (Heltec_Base_Camp.hex) is the base camp.
Every 5 s U1 sends a LoRa packet with its position, height, temperature and pressure. U2 answers, and shows how far
away the
hiker is, in which direction, and the weather up there.
Press Run. Click STORM on the BME280's window: the pressure falls 5 hPa below the first reading and both OLEDs warn.
Press BOOT on
the board (or its key on the monitor's Board tab): SOS goes out at once and the base camp's white LED lights.
Closed a window? The USB-C port of the board opens the monitor, the PANEL pad the panel.

THE PINS (the label on the board, what it can do in the simulation)
  SDA / SCL     GPIO17 / 18: Wire (the OLED at 0x3C is on it; put your own I2C parts here)
  TXD / RXD     GPIO43 / 44: Serial (the board's monitor)
  IO2, IO3, IO6 GPIO, PWM, interrupt, analogRead 0 .. 4095 for 0 .. 3.3 V
  IO21, IO38, IO39, IO45, IO46, IO48   GPIO, PWM, interrupt
  RST           the reset
  DC1, VBUS, GND  3.3 V (the logic), 5 V, ground
On the board, not on the pads: the SX1262 (NSS 10, SCK 12, MOSI 11, MISO 13, RESET 5, BUSY 4, DIO1 1), the GPS
(Serial1: RX 9, TX 8), BOOT
(GPIO0, LOW when pressed). The sketches' names: RADIO_CS_PIN, RADIO_DIO1_PIN, RADIO_RST_PIN, RADIO_BUSY_PIN,
GPS_RX_PIN, GPS_TX_PIN,
I2C_SDA, I2C_SCL, BUTTON_PIN.

PROPERTIES (double-click the board > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with T-Beam Supreme (TEP Proteus))
  LORADIST  the LoRa distance to the other boards (10 m ... 20 km)
  GPSLAT, GPSLON, GPSALT  where the GPS starts and its height;  GPSSPEED  km/h (0 = standing);  GPSHEADING  degrees
  GPSSATS   the satellites;  GPSFIX  the seconds to the first fix
  WIFISSID  the router in range (default TEP-WiFi);  WIFIPASS  its password (default 12345678)
  MONITOR   YES = the built-in serial monitor on Serial;  BAUD  its speed (115200, or AUTO)
  AUTOOPEN  YES = the monitor window opens at Run (the demo: YES)

TROUBLESHOOTING
* RadioLib fails with -2 (chip not found): new Module(10, 1, 5, 4), and on a real board first the AXP2101 and
  SPI.begin(12, 13, 11).
* No packet arrives: the same frequency, spreading factor, bandwidth and sync word on both boards.
* Packets go out but no answer comes back: radio.startReceive() after each transmit, and setPacketReceivedAction() in
  setup().
* The OLED stays dark: it is an SH1106, not an SSD1306: use a driver with page addressing, and start at column 2.
* The BME280 is not found: the demo's sensor is at 0x77 (SDO HIGH); SDA 17, SCL 18.
* An integer goes wrong above 32767: int is 16 bits in the simulation - use long.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot and the Serial Monitor text:
  https://www.theengineeringprojects.com/forum/category/lilygo-t-beam-supreme-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model (TEPNET.DLL), the symbols and artwork (TEPTBSUPREME.LIB) and the sensor model are made by The
  Engineering
  Projects. The source code of the models is not included.
* TEP Boards for Proteus (Arduino Code): its core, the variants and the EEPROM, SPI and Wire libraries are modified
  copies of the Arduino AVR core 1.8.6 - GNU Lesser General Public License 2.1 (LGPL 2.1, the text:
  LICENSE-LGPL-2.1.txt); its WiFi, WebServer and the other libraries and our core files are MIT (LICENSE-MIT.txt).
* The demo sketches use RadioLib (MIT), TinyGPSPlus (LGPL 2.1), Adafruit BME280, Adafruit Unified Sensor, Adafruit GFX
  and Adafruit
  SSD1306 (BSD / Apache): install them with the Library Manager to rebuild.
* Proteus is a product of Labcenter Electronics and is not included. T-Beam is a name of LilyGO, SX1262 of Semtech and
  ESP32-S3 of
  Espressif Systems. This library is not made or endorsed by them or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX files are supplied. Install TEP Boards for Proteus (INSTALLATION step 5), open Arduino
Code\TBSupreme_Hiker_Tracker, select
T-Beam Supreme (TEP Proteus) and use Sketch > Export Compiled Binary; Heltec_Base_Camp with Heltec WiFi LoRa 32 V3
(TEP Proteus). For a
real board use LilyGO's LoRa series examples for the board's settings, and power the radio, the GPS and the OLED first
through the AXP2101
with XPowersLib.

MODEL SCOPE AND LIMITS
Modelled: the board's 13 header GPIO pins and BOOT; digital I/O, analogRead 0 .. 4095, PWM (analogWrite / ledc) and
attachInterrupt
through the board model; RST, the CHG and PPS LEDs; Serial (the board's monitor), Wire and SPI; WiFi station mode,
DHCP, TCP, UDP,
WebServer, HTTPClient and mDNS; the SX1262 with RadioLib, between the TEP LoRa boards of a design; the GPS on Serial1,
NMEA RMC and GGA; the
SH1106 OLED.
Not modelled: the ESP32-S3 itself (the two 240 MHz cores, the PSRAM, the flash), the AXP2101, the board's BME280,
QMC6310, QMI8658 and
PCF8563, the TF card, the second I2C bus (SDA 42, SCL 41), UBX commands to the GPS, the battery, Bluetooth. The
simulation runs below real
time.

VERSION
TEP T-Beam Supreme library V1.0 (Nov 2026). Device T-BEAM SUPREME (TEPTBSUPREME.LIB / TEPNET.DLL), TEP Boards for
Proteus 1.48.0 (adds the
T-Beam Supreme). Demo sketches TBSupreme_Hiker_Tracker and Heltec_Base_Camp V1.0. Demo parts: HELTEC WIFI LORA 32 V3
and BME280ADVTEP.