Project Files of M5StickC PLUS2 Library for Proteus: ESP32 Stick with Display

M5STICKC PLUS2 LIBRARY FOR PROTEUS - V1.0 (YOUR ESP32 SKETCH ON THE ORANGE STICK WITH ITS 1.14" DISPLAY)
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/m5stickc-plus2-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/m5stickc-plus2-proteus-library
The demo's sensor and phone are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/09/sht31-proteus-library.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
A similar board with the same display:
  https://www.theengineeringprojects.com/2026/10/ttgo-t-display-esp32-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
M5StickC-PLUS2-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|   |-- TEPSHT31.LIB                                     44.4 KB   the SHT31 (demo), to LIBRARY
|   |-- TEPSTICKCP2.LIB                                  24.3 KB   the M5StickC PLUS2, to LIBRARY
|-- Proteus Model Files/
|   |-- TEPNET.DLL                                       2.81 MB   the board + monitors + network, to MODELS
|   |-- TEPSHT31.DLL                                    537.0 KB   the SHT31, to MODELS
|-- Arduino Code/
|   |-- StickC_Climate_Badge/StickC_Climate_Badge.ino     6.6 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/                998.6 KB   the Arduino IDE add-on 1.49.0 (226 files)
|-- Proteus Simulation/
|   |-- M5StickC-PLUS2-Climate-Badge.pdsprj              18.1 KB   the demo: a climate badge
|   |-- StickC_Climate_Badge.hex                         96.9 KB   the demo sketch (U1)
|   |-- TEPNET.DLL                                       2.81 MB   copy of the model
|   |-- TEPSHT31.DLL                                    537.0 KB   copy of the model
|-- README.txt                                          ~11.5 KB   this file
Total: 7.90 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 StickC Plus2 - the small orange stick with the ESP32-PICO-V3-02, the 1.14" 135 x 240
ST7789V2 display, the
M5 key, the side keys, the red LED, the Grove socket and the 8-pin HAT socket - 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.49.0 (in Arduino Code - see INSTALLATION).
  * The display is ON the part: Adafruit_ST7789 tft(&SPI, TFT_CS, TFT_DC, TFT_RST) with tft.init(135, 240) and
    setRotation(1).
  * The Grove socket gives I2C on G32 / G33; the HAT socket G26, G25 and G0.
The part lies on its side, the USB-C port on the left, so that setRotation(1) stands upright. The HAT socket: GND 5VO
G26 G25 G0 BAT 3V3 5VI
(5VO, BAT and 5VI are drawn only; G25 shares its pin with G36 on the real product); the Grove socket: GND 5V G32 G33.
It is drawn larger
than the real product, so that the display can be read on the sheet.
TEP additions: the PANEL pad (or the display) 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 2 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 microphone and the IR emitter's light are NOT
modelled, and the
M5Unified / M5StickCPlus2 libraries are not for this part: use the pins directly. See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "M5STICKC" in Pick Devices):
  M5STICKC PLUS2  "M5StickC PLUS2" 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:
* M5StickC-PLUS2-Climate-Badge: the monitor printed "Wi-Fi: http://192.168.1.101/" and a status line every 10 s; the
  display showed the temperature, the humidity and the low and high.
* SHOWER on the SHT31's window: ">> TOO DAMP", the screen red, the red LED blinking. Key A (the monitor's Board tab):
  ">> Key A: the graph", the graph on the screen.
* ROOM: ">> Dry again". The phone showed the page; its CLEAR link: ">> Low and high cleared from the phone".
* about 180 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). TEPSTICKCP2.LIB is the board;
   the others
   are the demo's parts: TEPSHT31.LIB, TEPLAPTOP.LIB and TEPMOBILE.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPSHT31.DLL) to the MODELS folder (...\Proteus 8
   Professional\MODELS) - replace
   an older TEPNET.DLL (this one is the first that knows the M5StickC PLUS2).
4. Delete TEPSTICKCP2.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 > M5StickC PLUS2 (TEP Proteus). From the Library Manager: Adafruit ST7735
   and ST7789,
   Adafruit GFX, Adafruit BusIO.
6. Start Proteus. In Pick Devices (P) search "M5STICKC".

RUN THE DEMO
Keep the .hex file and the DLLs beside the project in "Proteus Simulation".
M5StickC-PLUS2-Climate-Badge.pdsprj - U1 the M5StickC PLUS2 (StickC_Climate_Badge.hex) is a climate badge for a server
room, a greenhouse
or a store: U2 = an SHT31 (Advance) on its Grove socket, MOB1 = the Mobile WiFi Monitor on its page.
Press Run. The screen shows the temperature, the humidity and the lowest and highest temperature. Click SHOWER on the
SHT31's window: above
70 % the screen turns red, the red LED blinks and the buzzer pin sounds. Press the M5 key (or BOOT on the monitor's
Board tab): the screen
shows the graph of the humidity. ROOM brings it back. On the phone click ESP32 U1 for the page; its CLEAR link clears
the low and high.
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     the Grove socket: Wire SDA / SCL here (Wire.begin(32, 33) on a real one), or GPIO
  G26, G25, G0  the HAT socket: GPIO, PWM, interrupt, analogRead on G26 and G25
  3V3, 5V, GND  3.3 V (the logic), 5 V, ground
Inside, not on the sockets: the display (MOSI 15, SCLK 13, CS 5, DC 14, RST 12, backlight 27), the keys A 37, B 39 and
C 35 (LOW when
pressed), HOLD 4, the red LED and IR 19 (HIGH = on here), the buzzer 2, Serial 1 / 3. The names in sketches: TFT_MOSI
... TFT_BL, BUTTON_A,
BUTTON_B, BUTTON_C, POWER_HOLD, LED_RED, BUZZER_PIN, GROVE_SDA, GROVE_SCL.

PROPERTIES (double-click the part > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with M5StickC PLUS2 (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, -1, TFT_MOSI, TFT_CS), tft.init(135, 240).
* The picture is shifted or sideways: tft.setRotation(1), with the USB-C on the left.
* The SHT31 does not answer: Wire.begin(GROVE_SDA, GROVE_SCL), and the address 0x44 with ADDR LOW.
* A real PLUS2 turns off when you release the power key: set POWER_HOLD HIGH first thing 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/m5stickc-plus2-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model (TEPNET.DLL), the symbols and artwork (TEPSTICKCP2.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 ST7735 and ST7789, Adafruit GFX and Adafruit BusIO (MIT / BSD): install them with the
  Library Manager to
  rebuild.
* Proteus is a product of Labcenter Electronics and is not included. M5StickC PLUS2 is a name 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\StickC_Climate_Badge, select M5StickC PLUS2
(TEP Proteus) and use Sketch > Export Compiled Binary. For a real one select "M5StickCPlus2" in Espressif's "esp32"
package, define the pins
of the variant and upload.

MODEL SCOPE AND LIMITS
Modelled: the five GPIOs on the sockets, the keys, HOLD, the red LED and the buzzer pin; 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 ST7789V2
display; 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 microphone,
IR light, the battery and
the power key's hold logic, sound from the buzzer, Bluetooth. The simulation runs below real time.

VERSION
TEP M5StickC PLUS2 library V1.0 (Nov 2026). Device M5STICKC PLUS2 (TEPSTICKCP2.LIB / TEPNET.DLL), TEP Boards for
Proteus 1.49.0 (adds the
M5StickC PLUS2). Demo sketch StickC_Climate_Badge V1.0. Demo parts: SHT31ADVTEP and MOBILE WIFI MONITOR.