Project Files of ESP32-2432S028 Cheap Yellow Display Library for Proteus: TFT Touch

ESP32-2432S028 CHEAP YELLOW DISPLAY LIBRARY FOR PROTEUS - V1.0 (YOUR ESP32 SKETCH ON THE 2.8" TOUCH SCREEN 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/esp32-2432s028-cheap-yellow-display-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/esp32-2432s028-proteus-library
The demo's sensor, relay and phone are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/10/dht11-dht22-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/relay-module-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
The same display as a separate module:
  https://www.theengineeringprojects.com/2026/10/tft-ili9341-library-for-proteus-v1-0.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
ESP32-2432S028-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPCYD2432.LIB                                   25.6 KB   the ESP32-2432S028 CYD, to LIBRARY
|   |-- TEPDHT.LIB                                      155.3 KB   the DHT22 sensor (demo), to LIBRARY
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|   |-- TEPRELAY.LIB                                    490.4 KB   the relay module (demo), to LIBRARY
|-- Proteus Model Files/
|   |-- TEPDHT.DLL                                      306.5 KB   the DHT22 sensor, to MODELS
|   |-- TEPNET.DLL                                       2.84 MB   the board + monitors + network, to MODELS
|   |-- TEPRELAY.DLL                                    330.0 KB   the relay module, to MODELS
|-- Arduino Code/
|   |-- CYD_Touch_Thermostat/CYD_Touch_Thermostat.ino     7.7 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/               1,005.0 KB   the Arduino IDE add-on 1.50.0 (227 files)
|-- Proteus Simulation/
|   |-- CYD_Touch_Thermostat.hex                         94.6 KB   the demo sketch (U1)
|   |-- ESP32-2432S028-Touch-Thermostat.pdsprj           21.3 KB   the demo: a touch thermostat
|   |-- TEPDHT.DLL                                      306.5 KB   copy of the model
|   |-- TEPNET.DLL                                       2.84 MB   copy of the model
|   |-- TEPRELAY.DLL                                    330.0 KB   copy of the model
|-- README.txt                                          ~12.4 KB   this file
Total: 8.74 MB (unzipped). The source code of the models is not included.

WHAT IS IT?
Proteus 8 has no ESP32 processor model, so this is NOT a real ESP32 chip. Our team has put a lot of effort into
building this board
ourselves: it is the ESP32-2432S028, the popular "Cheap Yellow Display" - the yellow board with an ESP32-WROOM-32, a
2.8" 240 x 320
ILI9341 colour display and an XPT2046 resistive touch film - that runs YOUR ESP32 Arduino sketch in Proteus:
  * You write a normal sketch (the GPIO numbers of the product, analogRead 0-4095, analogWrite, ledcWrite,
    attachInterrupt, tone,
    Wire, SPI, Serial, WiFi, WebServer, HTTPClient ...) and compile it in the Arduino IDE with our board package "TEP
    Boards for
    Proteus" 1.50.0 (in Arduino Code - see INSTALLATION).
  * The display is ON the part: Adafruit_ILI9341 tft(TFT_CS, TFT_DC) with tft.begin() and tft.setRotation(1) stands
    upright.
  * The touch film is real: click the glass with the mouse and the sketch reads the place from the XPT2046 on its own
    pins.
  * The RGB LED on 4, 16 and 17 (lit when LOW) and the BOOT and RST keys work on the part.
The sockets: CN1 GND IO22 IO27 3V3; P3 GND IO35 IO22 IO21; P1 VIN TX RX GND. On P3 IO22 and IO21 are drawn only: IO22
is the same pin as
on CN1, and IO21 is the display's backlight. On the real board the RGB LED and the two keys sit on the back; we drew
them beside the
display so that you can see and press them. It is drawn a little smaller than the real board.
TEP additions: the PANEL pad opens the board's panel, the micro-USB port opens the serial monitor.
Limits (say them before you start): your sketch gets 8 KB of RAM in the simulation (the real one: 520 KB), 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 TF card, the speaker's sound and the LDR's light are NOT modelled, and LVGL does not fit in 8 KB of RAM.
See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "2432" in Pick Devices):
  ESP32-2432S028  "ESP32-2432S028 CYD" 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
  micro-USB 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 31 Oct 2026 with the demo project as shipped. What the Proteus run showed:
* ESP32-2432S028-Touch-Thermostat: the monitor printed "Wi-Fi: http://192.168.1.101/" and a status line every 10 s;
  the display showed the room's temperature, the set temperature and three touch buttons.
* At 19 C with 22 C set: ">> Heater ON", the relay on, the RGB LED red. +5 on the DHT22's window: 24 C, ">> Heater
  OFF", the LED green.
* The [+] button on the glass three times: ">> Set temperature 25.0 C", ">> Heater ON". The phone's DOWN link twice:
  ">> Set temperature 23.0 C", ">> Heater OFF". The ON/OFF button: ">> Thermostat OFF", the LED blue, then ">>
  Thermostat ON".
* A real mouse click on the glass: "Touch at" with the place clicked.
* about 100 s of simulation, no errors, with the pop-ups, the panel and the monitor 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). TEPCYD2432.LIB is the board;
   the others
   are the demo's parts: TEPDHT.LIB, TEPRELAY.LIB, TEPLAPTOP.LIB and TEPMOBILE.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPDHT.DLL, TEPRELAY.DLL) to the MODELS folder (...\Proteus 8
   Professional\MODELS) -
   replace an older TEPNET.DLL (this one is the first that knows the ESP32-2432S028).
4. Delete TEPCYD2432.IDX from the LIBRARY folder if it is there.
5. The Arduino IDE (only to compile your own sketches - the demo has its HEX file): 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 > ESP32-2432S028 Cheap Yellow Display (TEP Proteus). From the Library
   Manager: Adafruit ILI9341,
   Adafruit GFX, Adafruit BusIO, DHT sensor library, Adafruit Unified Sensor.
6. Start Proteus. In Pick Devices (P) search "2432".

RUN THE DEMO
Keep the .hex file and the DLLs beside the project in "Proteus Simulation".
ESP32-2432S028-Touch-Thermostat.pdsprj - U1 the ESP32-2432S028 (CYD_Touch_Thermostat.hex) is a wall thermostat: DHT1 =
a DHT22 (Advance) on
IO27, RLY1 = the heater's relay (Advance) on IO22, MOB1 = the Mobile WiFi Monitor on its page.
Press Run. The screen shows the room's temperature, the set temperature and three buttons. Below the set temperature
the relay closes and the
RGB LED turns red. Click +5 on the DHT22's window: the room warms up, the heater stops and the LED turns green. Click
the [+] and [-] buttons
on the glass with the mouse. On the phone click ESP32 U1 for the page; its UP and DOWN links do the same. The ON/OFF
button stops the
thermostat and turns the LED blue.
Closed a window? The micro-USB port opens the monitor, the PANEL pad the panel.

THE PINS (the label on the part, what it can do in the simulation)
  IO27, IO22    CN1: GPIO, PWM, interrupt; Wire SDA / SCL by default
  IO35          P3: input only, analogRead
  TX, RX        P1: Serial (the board's monitor)
  3V3, VIN, GND 3.3 V (the logic), 5 V, ground
Inside, not on the sockets: the display (MOSI 13, MISO 12, SCK 14, CS 15, DC 2, backlight 21), the touch (CLK 25, DIN
32, CS 33, IRQ 36,
DOUT 39), the RGB LED (4 red, 16 green, 17 blue, lit when LOW), the LDR 34, the speaker 26, BOOT 0. The names in
sketches: TFT_MOSI ... TFT_BL,
XPT2046_CLK, XPT2046_MOSI, XPT2046_CS, XPT2046_IRQ, XPT2046_MISO, CYD_LED_RED, CYD_LED_GREEN, CYD_LED_BLUE, CYD_LDR,
CYD_SPEAKER, BOOT_PIN.

THE TOUCH FILM
The XPT2046 has its own pins, away from the display's SPI bus, so clock it by hand as the demo does: CS LOW, the
command byte, then 12 bits.
0x90 reads X and 0xD0 reads Y, and IRQ goes LOW while the glass is pressed. With setRotation(1):
  x = map(rawX, 240, 3855, 0, 319);   y = map(rawY, 290, 3805, 0, 239);
A click holds the pen down for at least 0.1 s of simulation. Hold the mouse button for a longer press.

PROPERTIES (double-click the part > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with ESP32-2432S028 Cheap Yellow Display
  (TEP Proteus))
  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
* The display stays black: set TFT_BL HIGH, SPI.begin(TFT_SCLK, TFT_MISO, TFT_MOSI, TFT_CS), tft.begin().
* The picture is upside down: use tft.setRotation(1), with the micro-USB on the left.
* The touch does nothing: read IRQ with pinMode(XPT2046_IRQ, INPUT), and send one command first, as the demo does in
  setup().
* The touch lands in the wrong place: use the map() lines above, after setRotation(1).
* The DHT22 does not answer: it is on IO27 with dht.begin() in setup().
* 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/esp32-2432s028-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model (TEPNET.DLL), the symbols and artwork (TEPCYD2432.LIB) and the part models 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 sketch uses Adafruit ILI9341, Adafruit GFX, Adafruit BusIO, the DHT sensor library and Adafruit Unified
  Sensor (MIT / BSD): install
  them with the Library Manager to rebuild.
* Proteus is a product of Labcenter Electronics and is not included. ESP32 is a name of Espressif Systems. This
  library is not made or
  endorsed by them, by the board's makers or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied. Install TEP Boards for Proteus (INSTALLATION step 5), open Arduino
Code\CYD_Touch_Thermostat, select ESP32-2432S028
Cheap Yellow Display (TEP Proteus) and use Sketch > Export Compiled Binary. For a real board select "ESP32 Dev Module"
in Espressif's "esp32"
package, define the pins of the variant and upload.

MODEL SCOPE AND LIMITS
Modelled: the GPIOs on the sockets, the RGB LED, BOOT and RST; digital I/O, analogRead 0 .. 4095, PWM (analogWrite /
ledc), tone and
attachInterrupt through the board model; Serial (the board's monitor), Wire and SPI; the ILI9341 display and the
XPT2046 touch film; WiFi
station mode, DHCP, TCP, UDP, WebServer, HTTPClient and mDNS.
Not modelled: the ESP32 itself (the two 240 MHz cores, the flash), the TF card, the speaker's sound, the LDR's light,
Bluetooth. The
simulation runs below real time.

VERSION
TEP ESP32-2432S028 CYD library V1.0 (Nov 2026). Device ESP32-2432S028 (TEPCYD2432.LIB / TEPNET.DLL), TEP Boards for
Proteus 1.50.0 (adds the
ESP32-2432S028). Demo sketch CYD_Touch_Thermostat V1.0. Demo parts: DHT22ADVTEP, RELAY1ADVTEP and MOBILE WIFI MONITOR.