Project Files of M5Stack Core2 Library for Proteus: ESP32 TFT LCD Touch Screen

M5STACK CORE2 LIBRARY FOR PROTEUS - V1.0 (YOUR ESP32 SKETCH ON THE 2.0" TOUCH SCREEN CUBE)
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/m5stack-core2-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/m5stack-core2-proteus-library
The demo's sensor and phone are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/09/max30102-proteus-library.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
Smaller products from the same maker:
  https://www.theengineeringprojects.com/2026/11/m5stack-atoms3-library-for-proteus.html
  https://www.theengineeringprojects.com/2026/11/m5stickc-plus2-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
M5Stack-Core2-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPCORE2.LIB                                     25.4 KB   the M5Stack Core2, to LIBRARY
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMAX30102.LIB                                  44.2 KB   the MAX30102 sensor (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|-- Proteus Model Files/
|   |-- TEPMAX30102.DLL                                 537.0 KB   the MAX30102 sensor, to MODELS
|   |-- TEPNET.DLL                                       2.84 MB   the board + monitors + network, to MODELS
|-- Arduino Code/
|   |-- Core2_Pulse_Station/Core2_Pulse_Station.ino      10.7 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/               1,019.0 KB   the Arduino IDE add-on 1.52.0 (229 files)
|-- Proteus Simulation/
|   |-- Core2_Pulse_Station.hex                          99.9 KB   the demo sketch (U1)
|   |-- M5Stack-Core2-Pulse-Station.pdsprj               18.3 KB   the demo: a pulse station
|   |-- TEPMAX30102.DLL                                 537.0 KB   copy of the model
|   |-- TEPNET.DLL                                       2.84 MB   copy of the model
|-- README.txt                                          ~12.0 KB   this file
Total: 7.99 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 M5Stack's Core2 - the dark square case with an ESP32-D0WDQ6-V3, a 2.0" 320 x 240 ILI9342 display, an
FT6336U capacitive
touch screen with three touch dots under it, a red Grove PORT.A socket and the M-BUS - 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.52.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 is real: click the glass or a dot with the mouse, and Wire1 reads the place from the FT6336U at 0x38.
  * Wire is PORT.A (G32, G33); Wire1 is the inside bus. The AXP192 at 0x34 answers too (a plain set of registers).
On the real product the M-BUS is at the back; we drew ten of its pins on the right, so that you can wire them. It is
drawn at about the same
width as the real product and a little lower.
TEP additions: the PANEL pad 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 one: 520 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 MPU6886, the BM8563 clock, the speaker, the microphone, the vibration motor and the TF card
are NOT modelled, the
AXP192 does not switch anything here, and the M5Core2 / M5Unified / LVGL libraries are not for this part: use the pins
directly.
See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "CORE2" in Pick Devices):
  M5STACK CORE2  "M5Stack Core2" 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 31 Oct 2026 with the demo project as shipped. What the Proteus run showed:
* M5Stack-Core2-Pulse-Station: the monitor printed "Wi-Fi: http://192.168.1.101/" and an estimate every 4 s; the
  display showed the pulse waveform, the heart rate and the oxygen level.
* RUN 150 on the MAX30102's window: ">> HIGH PULSE", the red band. The dot C and + on the glass: ">> Back to normal",
  ">> High pulse limit 160 BPM".
* REST 60, then LOW SPO2: ">> LOW OXYGEN". The dot B: the TREND page. The phone's LIMIT -10: ">> High pulse limit 150
  BPM". FINGER OFF: ">> No finger".
* Real mouse clicks on the part: the dot C and + on the glass did the same.
* about 105 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). TEPCORE2.LIB is the board; the
   others
   are the demo's parts: TEPMAX30102.LIB, TEPLAPTOP.LIB and TEPMOBILE.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPMAX30102.DLL) to the MODELS folder (...\Proteus 8
   Professional\MODELS) -
   replace an older TEPNET.DLL (this one is the first that knows the Core2).
4. Delete TEPCORE2.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 > M5Stack Core2 (TEP Proteus). From the Library Manager: Adafruit ILI9341,
   Adafruit GFX,
   Adafruit BusIO and SparkFun MAX3010x Pulse and Proximity Sensor Library.
6. Start Proteus. In Pick Devices (P) search "CORE2".

RUN THE DEMO
Keep the .hex file and the DLLs beside the project in "Proteus Simulation".
M5Stack-Core2-Pulse-Station.pdsprj - U1 the Core2 (Core2_Pulse_Station.hex) is a pulse station: U2 = a MAX30102
(Advance) on PORT.A, MOB1 = the Mobile
WiFi Monitor on its page. It is a demonstration, not a medical instrument.
Press Run. The screen shows the pulse waveform, the heart rate and the oxygen level. Click RUN 150 on the MAX30102's
window: above the limit a red
band says HIGH PULSE. Click the dot C for the LIMIT page, and + on the glass to raise the limit. The dot A is the LIVE
page, the dot B the TREND page.
LOW SPO2 gives the LOW OXYGEN alarm. On the phone click ESP32 U1 for the page; its links change the limit too.
Closed a window? The USB-C port opens the monitor, the PANEL pad the panel.

THE PINS (the label on the part, what it can do in the simulation)
  G32, G33        PORT.A: Wire SDA / SCL, or GPIO
  G27, G19, G25, G26  the M-BUS: GPIO, PWM, interrupt; analogRead on G27, G25, G26
  G35, G36        the M-BUS: input only, analogRead
  G13, G14        the M-BUS: Serial2 (RX, TX), or GPIO
  3V3, 5V, GND    3.3 V (the logic), 5 V, ground
Inside, not on the sockets: the display (MOSI 23, MISO 38, SCK 18, CS 5, DC 15), the touch's INT 39 and Serial. The
names in sketches: TFT_MOSI ... TFT_DC,
TOUCH_INT, TOUCH_ADDR, AXP192_ADDR, PORTA_SDA, PORTA_SCL, INT_SDA, INT_SCL.

THE TOUCH
Wire1.beginTransmission(TOUCH_ADDR); Wire1.write(0x02); Wire1.endTransmission(); Wire1.requestFrom(TOUCH_ADDR, 5);
then the number of touches and the
X and Y of the first one. X is 0 - 319, Y is 0 - 239 on the glass and 240 or more on the three dots. INT (39) is LOW
while a finger is down.
A click holds the finger down for at least 0.1 s of simulation. Dragging on the glass is not followed.

PROPERTIES (double-click the part > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with M5Stack Core2 (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: SPI.begin(TFT_SCLK, TFT_MISO, TFT_MOSI, TFT_CS), tft.begin(). On a real Core2 the AXP192
  must switch it on first.
* The picture is upside down: tft.setRotation(1).
* The touch does nothing: pinMode(TOUCH_INT, INPUT), and Wire1.begin(INT_SDA, INT_SCL).
* The MAX30102 is not found: it is on PORT.A, Wire.begin(PORTA_SDA, PORTA_SCL).
* 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/m5stack-core2-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model (TEPNET.DLL), the symbols and artwork (TEPCORE2.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 sketch uses Adafruit ILI9341, Adafruit GFX, Adafruit BusIO and the SparkFun MAX3010x library: install them
  with the Library Manager to rebuild.
* Proteus is a product of Labcenter Electronics and is not included. M5Stack and Core2 are names of M5Stack and ESP32
  of Espressif Systems.
  This library is not made or endorsed by them or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied. Install TEP Boards for Proteus (INSTALLATION step 5), open Arduino Code\Core2_Pulse_Station,
select M5Stack Core2 (TEP Proteus)
and use Sketch > Export Compiled Binary. For a real one select "M5Stack Core2" in Espressif's "esp32" package, start
the AXP192 with M5Unified, define
the pins of the variant and upload.

MODEL SCOPE AND LIMITS
Modelled: the GPIOs on the sockets; digital I/O, analogRead 0 .. 4095, PWM (analogWrite / ledc), tone and
attachInterrupt through the board model; Serial
(the board's monitor), Serial2, Wire and SPI; the ILI9342 display and the FT6336U touch; WiFi station mode, DHCP, TCP,
UDP, WebServer, HTTPClient and mDNS.
Not modelled: the ESP32 itself (the two 240 MHz cores, the PSRAM, the flash), the MPU6886, the BM8563, the speaker,
the microphone, the vibration motor,
the TF card, the battery, Bluetooth. The AXP192 is a set of registers only. The simulation runs below real time.

VERSION
TEP M5Stack Core2 library V1.0 (Nov 2026). Device M5STACK CORE2 (TEPCORE2.LIB / TEPNET.DLL), TEP Boards for Proteus
1.52.0 (adds the Core2). Demo sketch
Core2_Pulse_Station V1.0. Demo parts: MAX30102ADVTEP and MOBILE WIFI MONITOR.