Project Files of Arduino Nano ESP32 Library for Proteus: ESP32-S3 Wi-Fi + RGB LED

ARDUINO NANO ESP32 LIBRARY FOR PROTEUS - V1.0 (YOUR NANO ESP32 SKETCH, THE RGB LED, WI-FI, LAPTOP + PHONE)
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/10/arduino-nano-esp32-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/arduino-nano-esp32-proteus-library
The demo talks to our Laptop WiFi Monitor and Mobile WiFi Monitor (both included) - their articles:
  https://www.theengineeringprojects.com/2026/10/laptop-wifi-monitor-library-for-proteus.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
The other boards with the same ESP32-S3 / the same Arduino Wi-Fi family, our ESP32-S3 DevKitC-1 and UNO R4 WiFi:
  https://www.theengineeringprojects.com/2026/10/esp32-s3-devkitc-1-library-for-proteus.html
  https://www.theengineeringprojects.com/2026/10/arduino-uno-r4-wifi-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
Arduino-Nano-ESP32-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPLAPTOP.LIB                                              39.5 KB   our Laptop WiFi Monitor (the demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                              13.1 KB   our Mobile WiFi Monitor (the demo), to LIBRARY
|   |-- TEPNANOESP32.LIB                                           27.6 KB   the Arduino Nano ESP32 board, to LIBRARY
|-- Proteus Model Files/
|   |-- TEPNET.DLL                                                 1.89 MB   the boards + the Wi-Fi network, to MODELS
|-- Proteus Simulation/
|   |-- Arduino-Nano-ESP32-Board.pdsprj                            15.1 KB   demo 1: the board alone
|   |-- NanoESP32_RGB_Mixer.hex                                    64.8 KB   U1 of both demos
|   |-- Nano-ESP32-RGB-Mixer-with-Laptop-and-Mobile.pdsprj         22.4 KB   demo 2: RGB mixer + laptop + phone
|   |-- TEPNET.DLL                                                 1.89 MB   copy of the model
|-- Arduino Code/
|   |-- NanoESP32_RGB_Mixer/NanoESP32_RGB_Mixer.ino                 6.1 KB   the Nano ESP32 sketch
|   |-- TEP Boards for Proteus/hardware/tep/avr/                  552.4 KB   the Arduino IDE add-on 1.10.0 (141 files)
|-- README.txt                                                    ~18.9 KB   this file
Total: 4.52 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
Proteus 8 has no ESP32-S3 (Xtensa) processor model, so this is NOT a real ESP32-S3 chip. It is the Arduino Nano ESP32 - the
Nano's size and 2 x 15 pins, the u-blox NORA-W106 module (ESP32-S3), USB-C and an RGB LED - that runs YOUR Nano ESP32 sketch
in Proteus:
  * You write a normal Nano ESP32 sketch (D0 .. D13, A0 .. A7, LED_BUILTIN, LED_RED, LED_GREEN, LED_BLUE, Serial, Serial0, Wire,
    SPI, analogWrite, the Arduino-ESP32 libraries WiFi, WebServer, ESPmDNS, HTTPClient, Preferences ...) and compile it in the
    Arduino IDE with our board package "TEP Boards for Proteus" 1.10.0 (in Arduino Code - see INSTALLATION).
  * Inside the board, Proteus's own ATmega2560 model runs the compiled sketch at 16 MHz; our model (TEPNET.DLL) wraps it: the
    Nano's 30 pins with the Arduino pin numbers, A0 .. A7 (0 .. 4095 for 0 .. 3.3 V), the RESET button, the L LED on D13, the
    ON LED, the RGB LED (its colour from LED_RED / GREEN / BLUE, lit when LOW, PWM included), the built-in serial monitor on the
    USB (Serial) and the Wi-Fi radio.
  * Wi-Fi: a virtual router (TEP-WiFi, password 12345678 - the WIFISSID / WIFIPASS properties) with DHCP (192.168.1.101 for U1,
    .102 for U2 ...), a scan list, RSSI, mDNS names (nano.local), NTP time, TCP and UDP between all the TEP Wi-Fi parts in the
    design (boards, modules, the Laptop and Mobile WiFi Monitors), and a virtual internet host that answers HTTP.
The board is drawn our way at its real proportions (45 x 18 mm, teal), seen from above with USB-C on the left: RESET, the RGB
LED, the L and ON LEDs, the PANEL pad and the NORA-W106 with its antenna at the right end; the two rows of 15 pins along the long
edges (top D12 .. D2, GND, RST, RX0, TX1; bottom D13, 3.3V, B0, A0 .. A7, VBUS, B1, GND, VIN).
TEP additions: the antenna changes colour (gold not joined, green on Wi-Fi, orange sending, cyan receiving), the PANEL pad (or
the module) opens the board's panel, USB-C opens the serial monitor.
Limits (say them before you start): 16 MHz, 8 KB of RAM, 256 KB of flash, int is 16 bits (use long / int32_t for big numbers),
no FreeRTOS tasks, no Bluetooth, no PSRAM, no USB keyboard / mouse, no real TLS, no soft AP. See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "NANO ESP32" in Pick Devices):
  ARDUINO NANO ESP32  "Arduino Nano ESP32" V1.0 (category Microprocessor ICs > Arduino Wi-Fi Boards), prefix U, model TEPNET.DLL
  The panel (a TEP pop-up window, the look of the TEP Serial Monitor; it opens at Run, the PANEL pad opens it again). Tabs:
    Wi-Fi     a phone with three tabs - BROWSER (OPEN NANO PAGE: the phone opens the sketch's web page, tap its links), ROUTER
              (the DHCP list of every board and phone), CLOUD (the internet host's requests); WI-FI SIGNAL GOOD / WEAK / OUT OF
              RANGE; the cards BOARD, WI-FI, TRAFFIC
    Pins      every pin live (HIGH, LOW, PWM with its duty, interrupt, input, pull-up) and A0 .. A7 with their voltage
    Test      Web request test (the phone opens the page n times - measured) and Wi-Fi re-join test
    Settings  theme, text size, open at Run, window size
    Help      report a bug, suggest a feature, article, updates, donate, forum; Copy diagnostics
  The serial monitor (115200 baud by default) has its own window with Monitor, Plotter and Board tabs (the Board tab shows the ON,
  L and RGB LEDs, the RESET button and every pin).
The same TEPNET.DLL also runs our UNO R4 WiFi, the ESP8266 and ESP32 boards, the ESP-01 / ESP-07 / ESP-12 modules, the AirLift and
WiFi shields and the Laptop / Mobile WiFi Monitors (TEPLAPTOP.LIB, TEPMOBILE.LIB, included for the demo); it replaces any older
TEPNET.DLL (keep only this newest one in MODELS).

TEST STATUS
V1.0: verified in Proteus 8.5 on 23 Oct 2026 (the two demo projects as shipped, the window off-screen, posted clicks and keys).
What the runs showed:
  * L blinked while the board joined, then stayed on: joined TEP-WiFi in 2.2 s (IP 192.168.1.101, MAC 34:85:18:01:00:01, mDNS
    nano.local); "Colour R 0 G 255 B 0 by start" - the RGB LED green.
  * The laptop (192.168.1.21) opened http://192.168.1.101/set?r=255&g=96&b=0: "Colour R 255 G 96 B 0 by page" - the RGB LED
    orange. The phone (192.168.1.41) opened http://nano.local/ (HTTP 200, 416 bytes) and PURPLE made it R 160 G 0 B 255.
  * RGB 0 255 255 typed in the monitor turned it cyan; FADE started the rainbow (the PWM of the three pins changing every 40 ms);
    STATUS and HELP answered.
  * Speed: about 0.4 x real time with the two monitors.

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 - use the folder that already holds
   Proteus's own .LIB files). TEPNANOESP32.LIB is the Nano ESP32; TEPLAPTOP.LIB and TEPMOBILE.LIB are our Laptop WiFi Monitor
   and Mobile WiFi Monitor (the demo's tools).
3. Copy TEPNET.DLL from "Proteus Model Files" to the MODELS folder (...\Proteus 8 Professional\MODELS) - replace an older
   TEPNET.DLL (this one is the first that knows the Nano ESP32 and its RGB LED).
4. Delete TEPNANOESP32.IDX, TEPLAPTOP.IDX and TEPMOBILE.IDX from the LIBRARY folder if they are there.
5. The Arduino IDE (only to compile your own sketches - the demos have their 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).
   WiFi, WebServer and ESPmDNS are inside the package - nothing else to install.
   Tools > Board > TEP Boards for Proteus > Arduino Nano ESP32 (TEP Proteus).
6. Start Proteus. In Pick Devices (P) search "NANO ESP32".

RUN THE DEMOS
Keep the .hex file and TEPNET.DLL beside the projects in "Proteus Simulation".
1. Arduino-Nano-ESP32-Board.pdsprj - the board alone (NanoESP32_RGB_Mixer.hex): press Run. The monitor and the panel open (move
   them aside); L blinks while the board joins, then the RGB LED turns green. Type RED, RGB 255 0 128, FADE or STATUS in the
   monitor; the panel's phone (OPEN NANO PAGE) shows the colour page.
2. Nano-ESP32-RGB-Mixer-with-Laptop-and-Mobile.pdsprj - U1 the Nano ESP32 (NanoESP32_RGB_Mixer.hex); PC1 the Laptop WiFi Monitor
   (home page http://192.168.1.101/set?r=255&g=96&b=0) and MOB1 the Mobile WiFi Monitor (home page http://nano.local/) - no
   wires, they are on TEP-WiFi.
   Press Run. On the laptop: Browser > Go makes the RGB LED orange; on the phone: Browser > Go opens the page - tap RED, GREEN,
   BLUE, PURPLE, WHITE, FADE or OFF. In the monitor: RGB <r> <g> <b>, a colour name, FADE, STATUS, HELP.
Closed a window? USB-C of the board opens the monitor, the PANEL pad the panel.

PINS (the label on the board, the Arduino pin number, what it can do in the simulation)
  RX0 / TX1          D0 / D1: Serial0 (as on the Nano ESP32), GPIO, interrupt
  D2 .. D13          2 .. 13: GPIO, PWM (analogWrite), interrupt; D13 drives the L LED (lit when HIGH)
  D10 .. D13         also SPI SS / MOSI / MISO / SCK
  A0 .. A7           17 .. 24: analogRead 0 .. 4095 for 0 .. 3.3 V; also GPIO; A4 / A5 = Wire SDA / SCL
  LED_RED / GREEN /  14 / 15 / 16: the RGB LED (not on the header), lit when LOW - analogWrite(LED_RED, 255 - level) mixes
  LED_BLUE           colours
  3.3V / VBUS        3.3 V (the board's logic), 5 V (USB)
  GND, RST           ground; reset (LOW holds the board in reset; the RESET button does the same)
  B0, B1, VIN        drawn, not modelled (B0 / B1 are the bootloader pads; VIN the 6 - 21 V input)
Serial is the USB (the board's monitor), not RX0 / TX1 - as on the real Nano ESP32. The pins are 3.3 V logic. The board package
uses the Nano ESP32's default "By Arduino pin" numbering (D2 is 2); the ESP32-S3's own GPIO numbers are not used.

THE DEMO SKETCH (Arduino Code)
  NanoESP32_RGB_Mixer   WiFi + WebServer + ESPmDNS: joins TEP-WiFi as "nano" (L blinks, then stays on), the RGB LED green when
                        ready; the page / with the colour and the buttons, /set?r=&g=&b= any colour, /red /green /blue /purple
                        /white /off, /fade (a rainbow: the hue moves every 40 ms around the colour wheel); the same in the
                        serial monitor (RGB <r> <g> <b>, a colour name, FADE, STATUS, HELP). The LED pins are LOW-active, so the
                        sketch writes 255 - level with analogWrite.

PROPERTIES (double-click the board > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with the board Arduino Nano ESP32 (TEP Proteus))
  WIFISSID  the router in range (default TEP-WiFi)
  WIFIPASS  its password (default 12345678); a sketch with another name or password gets WL_NO_SSID_AVAIL / WL_CONNECT_FAILED,
            as on the bench
  MONITOR   YES = the built-in serial monitor on the USB (Serial)
  BAUD      the monitor's speed (115200 by default, or AUTO)
  AUTOOPEN  YES = the monitor window opens at Run (the demos: YES)
  TIME      the clock NTP gives the sketch: PC (the PC's clock) or a fixed start time YYYY-MM-DD HH:MM:SS in UTC
Every run starts again from the properties. The IP address follows the part's number: U1 192.168.1.101, U2 .102 ... - give
every Wi-Fi part its own number. One Nano ESP32 per design: its USB serial and RGB LED lines are hidden pins, and Proteus joins
hidden pins of the same name across parts.

LINKS.INI (OPTIONAL)
The Help page cards open web pages. To point them somewhere else without a new DLL, put a text file named links.ini next to
TEPNET.DLL with lines KEY=URL, for example:
  ARTICLE=https://www.theengineeringprojects.com/...
Keys: WEBSITE, FORUM, BUG_REPORT, FEATURE_REQUEST, ARTICLE, USER_GUIDE, UPDATE_CHECK, DONATE. Only http:// and https:// links
are used; lines starting with # are comments.

TROUBLESHOOTING
* Nothing happens at Run / "the sketch's core is link version ...": the HEX was not built with TEP Boards for Proteus - select
  Arduino Nano ESP32 (TEP Proteus) and export the binary again.
* "LED_RED was not declared": an older add-on is installed - 1.10.0 is the first with the Nano ESP32.
* The RGB LED is white when you expect it off: the pins are LOW-active - write HIGH (or analogWrite 255) to switch a colour off.
* The board stays on "joining": the sketch's SSID / password differ from the WIFISSID / WIFIPASS properties, or the panel's
  WI-FI SIGNAL is OUT OF RANGE.
* A sketch from the ESP32 DevKit uses GPIO numbers: on this board the pin numbers are the Arduino ones (D2 is 2, A0 is 17).
* An integer goes wrong above 32767: int is 16 bits on the hidden AVR - use long.
* No monitor window: click USB-C; no panel: click the PANEL pad, or turn "Open the panel at Run" back on (Settings).

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the simulation log and the Copy diagnostics text of
the panel:
  https://www.theengineeringprojects.com/forum/category/arduino-nano-esp32-proteus-library

SUPPORT US
This library is free. If it saves you time, please support our work:
  https://www.theengineeringprojects.com/donate

WEBSITE
  https://www.theengineeringprojects.com/

LICENCES AND THIRD-PARTY NOTES
* The board model and the Wi-Fi network (TEPNET.DLL), the symbols and artwork (TEPNANOESP32.LIB, TEPLAPTOP.LIB, TEPMOBILE.LIB)
  are made by The Engineering Projects. The board's processor is Proteus's own ATmega2560 model (Labcenter's AVR model). The
  model uses only standard Windows libraries; no Visual C++ redistributable is needed. The C++ source code of the models is not
  included.
* TEP Boards for Proteus (Arduino Code\TEP Boards for Proteus): its core (cores\tep32), 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 (the licence text is
  included: LICENSE-LGPL-2.1.txt; the original source: https://github.com/arduino/ArduinoCore-avr/tree/1.8.6). Its WiFi, WiFiS3,
  Arduino_LED_Matrix, WebServer, HTTPClient, ESPmDNS, ESP8266WiFi, ESP8266WebServer, ESP8266HTTPClient, ESP8266mDNS,
  Preferences, ESP32Servo and Servo libraries and our core files are MIT (LICENSE-MIT.txt). The API follows the Arduino-ESP32
  core (names only - no Espressif or Arduino code).
* Proteus is a product of Labcenter Electronics and is not included. Arduino and Nano are trademarks of Arduino SA, ESP32-S3 a
  name of Espressif Systems, NORA-W106 and u-blox of u-blox AG. This library is not made or endorsed by them or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied; the Arduino IDE is not needed to run the demos. Install TEP Boards for Proteus (INSTALLATION step 5),
open Arduino Code\NanoESP32_RGB_Mixer, select Arduino Nano ESP32 (TEP Proteus) and use Sketch > Export Compiled Binary.
Flash / RAM: NanoESP32_RGB_Mixer 23,574 / 2,278 bytes.
Put the exported HEX in place of the simulation's .hex. For a real Nano ESP32 select "Arduino Nano ESP32" of the Arduino ESP32
Boards package (pin numbering "By Arduino pin") and upload as usual - the same sketch, no change.

MODEL SCOPE AND LIMITS
Modelled: the Nano ESP32's pins with the Arduino pin numbers on a hidden ATmega2560 (Proteus's AVR model, 16 MHz); digital I/O,
analogRead(A0 .. A7) 0-4095 for 0-3.3 V (the board model reads the pin's voltage), PWM (analogWrite, ledcAttach / ledcWrite) and
attachInterrupt on every pin through the board model; the RESET button, the L LED on D13, the ON LED, the RGB LED on
LED_RED / GREEN / BLUE (its colour from the three pins' levels and PWM duties); Serial (the USB, the board's monitor), Serial0
on D0 / D1, Wire on A4 / A5 and SPI on D10 .. D13 (the AVR's hardware), EEPROM and Preferences; the clock (configTime, time());
Wi-Fi station mode (begin, status, scan, RSSI, hostname, disconnect, re-join), DHCP addresses, TCP client and server, HTTP client,
UDP, mDNS names, NTP time, the virtual internet host; the other TEP Wi-Fi parts on the same network.
Not modelled: the ESP32-S3 itself (Xtensa LX7, 240 MHz, 512 KB RAM, two cores), PSRAM, Bluetooth, the USB keyboard / mouse
(HID), DFU upload and the B0 / B1 bootloader pads, deep sleep timing (the board restarts), the soft AP and WiFi events, real TLS,
the radio's real timing. Upload over USB is not used (Proteus loads the HEX).
The model's own choices: every board in the design sees the same router and the same two neighbour networks; the WI-FI SIGNAL
buttons set the router's RSSI; the internet host answers HTTP on ports 80 and 443 (no certificates); the clock starts from the
PC's time or the TIME property; the simulation runs below real time.

VERSION
TEP Arduino Nano ESP32 library V1.0 (Oct 2026). Device ARDUINO NANO ESP32 (TEPNANOESP32.LIB / TEPNET.DLL, which also runs our UNO
R4 WiFi, the ESP8266 and ESP32 boards, the ESP-01 / ESP-07 / ESP-12 modules, the AirLift and WiFi shields and the Laptop / Mobile
WiFi Monitors), TEP Boards for Proteus 1.10.0 (adds the Nano ESP32 with the Arduino pin numbers and its RGB LED).
Demo sketch NanoESP32_RGB_Mixer V1.0 (the RGB LED from the page, the laptop and the monitor, the rainbow fade).
Demo tools: LAPTOP WIFI MONITOR and MOBILE WIFI MONITOR (TEP Laptop / Mobile WiFi Monitor libraries V1.0).