Project Files of M5Stack AtomS3 Library for Proteus: ESP32-S3 with TFT Display

M5STACK ATOMS3 LIBRARY FOR PROTEUS - V1.0 (YOUR ESP32-S3 SKETCH ON THE TINY CUBE WITH A SCREEN)
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-atoms3-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/m5stack-atoms3-proteus-library
The demo's probe, LED stick and phone are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/10/ds18b20-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/ws2812b-neopixel-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
A similar product from the same maker:
  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-AtomS3-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPATOMS3.LIB                                    25.0 KB   the M5Stack AtomS3, to LIBRARY
|   |-- TEPDS18B20.LIB                                   88.0 KB   the DS18B20 probe (demo), to LIBRARY
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|   |-- TEPWS2812.LIB                                    1.59 MB   the WS2812 stick (demo), to LIBRARY
|-- Proteus Model Files/
|   |-- TEPDS18B20.DLL                                  305.0 KB   the DS18B20 probe, to MODELS
|   |-- TEPNET.DLL                                       2.84 MB   the board + monitors + network, to MODELS
|   |-- TEPWS2812.DLL                                   312.5 KB   the WS2812 stick, to MODELS
|-- Arduino Code/
|   |-- AtomS3_Cooking_Thermometer/AtomS3_Cooking_Thermometer.ino    8.0 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/               1,011.3 KB   the Arduino IDE add-on 1.51.0 (228 files)
|-- Proteus Simulation/
|   |-- AtomS3_Cooking_Thermometer.hex                   98.8 KB   the demo sketch (U1)
|   |-- M5Stack-AtomS3-Cooking-Thermometer.pdsprj        20.4 KB   the demo: a cooking thermometer
|   |-- TEPDS18B20.DLL                                  305.0 KB   copy of the model
|   |-- TEPNET.DLL                                       2.84 MB   copy of the model
|   |-- TEPWS2812.DLL                                   312.5 KB   copy of the model
|-- README.txt                                          ~11.6 KB   this file
Total: 9.76 MB (unzipped). The source code of the models is not included.

WHAT IS IT?
Proteus 8 has no ESP32-S3 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 M5Stack's AtomS3 - the small dark cube, 24 mm on a side, with an ESP32-S3FN8, a 0.85" 128 x 128
GC9107 display, a key
under the screen, a Grove socket and six pins on the back - 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.51.0 (in Arduino Code - see INSTALLATION).
  * The display is ON the part. The GC9107 takes the same commands as an ST7789, so a short class on Adafruit_ST77xx
    drives it: copy it
    from the demo sketch.
  * The key is under the screen: click the screen with the mouse, and digitalRead(BUTTON_A) goes LOW.
  * The Grove socket gives I2C on G2 / G1; the back gives G5, G6, G7, G8, G38 and G39.
On the real product the pins are on the back; we drew them at the sides, so that you can wire them. The order of the
two rows follows
M5Stack's Atom range. It is drawn larger than the real product, so that the display can be read on the sheet.
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: 512 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 MPU6886 and IR light are NOT modelled, and the M5Unified / M5GFX libraries are not for this part: use
the pins directly.
See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "ATOMS3" in Pick Devices):
  M5STACK ATOMS3  "M5Stack AtomS3" 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-AtomS3-Cooking-Thermometer: the monitor printed "Wi-Fi: http://192.168.1.101/" and a status line every 10 s;
  the display showed the food, the temperature and a progress bar.
* The probe at 25 C, then 50 C: the LED stick filled up as the food warmed. The key under the screen: ">> Food: BEEF,
  target 57 C".
* The probe at 60 C: ">> READY", the screen and the stick green. The phone's STOP ALERT link: ">> Alert stopped from
  the phone". The probe at 70 C: ">> TOO HOT", the stick red.
* A real mouse click on the screen: the key pressed, the next food chosen.
* about 200 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). TEPATOMS3.LIB is the board; the
   others
   are the demo's parts: TEPDS18B20.LIB, TEPWS2812.LIB, TEPLAPTOP.LIB and TEPMOBILE.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPDS18B20.DLL, TEPWS2812.DLL) to the MODELS folder
   (...\Proteus 8 Professional\MODELS) -
   replace an older TEPNET.DLL (this one is the first that knows the AtomS3).
4. Delete TEPATOMS3.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 AtomS3 (TEP Proteus). From the Library Manager: Adafruit ST7735
   and ST7789,
   Adafruit GFX, Adafruit BusIO, OneWire, DallasTemperature and Adafruit NeoPixel.
6. Start Proteus. In Pick Devices (P) search "ATOMS3".

RUN THE DEMO
Keep the .hex file and the DLLs beside the project in "Proteus Simulation".
M5Stack-AtomS3-Cooking-Thermometer.pdsprj - U1 the AtomS3 (AtomS3_Cooking_Thermometer.hex) is a Wi-Fi cooking
thermometer: U2 = a DS18B20 probe
(Advance) on G5 with R1, its 4.7 kohm pull-up; NEO1 = a WS2812 stick of 8 LEDs (Advance) on G6; MOB1 = the Mobile WiFi
Monitor on its page.
Press Run. The screen shows the food, the temperature and a progress bar. Click +5 on the probe's window: the stick
fills up as the food warms.
Click the screen: the next food. At the target the screen and the stick turn green; click the screen, or STOP ALERT on
the phone (click ESP32 U1
first), to stop the blinking. Eight degrees above the target the stick turns red.
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)
  G5, G6, G7, G8  the left row: GPIO, PWM, interrupt, analogRead
  G38, G39        the right row: GPIO, PWM, interrupt
  G2, G1          the Grove socket: Wire SDA / SCL here (Wire.begin(2, 1) on a real one), or GPIO
  3V3, 5V, GND    3.3 V (the logic), 5 V, ground
Inside, not on the sockets: the display (MOSI 21, SCK 17, CS 15, RS 33, RST 34, backlight 16), the key 41 (LOW when
pressed), the IR emitter 4 and
Serial (the USB-C). The names in sketches: TFT_MOSI ... TFT_BL, BUTTON_A, KEY_PIN, IR_PIN, GROVE_SDA, GROVE_SCL.

PROPERTIES (double-click the part > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with M5Stack AtomS3 (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), then the class's init().
* The colours are wrong: the GC9107 needs ST77XX_INVON in its start-up list.
* The key does nothing: pinMode(BUTTON_A, INPUT_PULLUP); a click on the screen is the key.
* The probe reads -127: DQ needs its 4.7 kohm pull-up, and probe.begin() in setup().
* The LED stick stays dark: stick.begin() in setup(), then stick.show() after setPixelColor().
* 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-atoms3-proteus-library

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

MODEL SCOPE AND LIMITS
Modelled: the GPIOs on the sockets, the key 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 GC9107 display; WiFi station mode, DHCP, TCP, UDP,
WebServer, HTTPClient and mDNS.
Not modelled: the ESP32-S3 itself (the two 240 MHz cores, the flash), the MPU6886, IR light, Bluetooth. The simulation
runs below real time.

VERSION
TEP M5Stack AtomS3 library V1.0 (Nov 2026). Device M5STACK ATOMS3 (TEPATOMS3.LIB / TEPNET.DLL), TEP Boards for Proteus
1.51.0 (adds the
AtomS3). Demo sketch AtomS3_Cooking_Thermometer V1.0. Demo parts: DS18B20PROBEADVTEP, WS2812STICK8ADVTEP and MOBILE
WIFI MONITOR.