Project Files of IoT Water Tank Level Monitor with ESP32 - Proteus Simulation

===============================================================================================================
  IoT Water Tank Level Monitor with ESP32 - Proteus Simulation Project V1.0
  The Engineering Projects - www.TheEngineeringProjects.com
===============================================================================================================

IMPORTANT LINKS
  The project tutorial (circuit, code, simulation results):
    https://www.theengineeringprojects.com/2026/11/iot-water-tank-level-monitor-esp32-proteus-simulation.html
  The libraries this project is built from (each post has its own full download and tutorial):
    ESP32 DevKit V1 board:
      https://www.theengineeringprojects.com/2026/10/esp32-devkit-v1-library-for-proteus-v2-0.html
    TF-Luna LiDAR distance sensor:
      https://www.theengineeringprojects.com/2026/10/tf-luna-lidar-sensor-library-for-proteus-v1-0.html
    ST7789 TFT LCD:
      https://www.theengineeringprojects.com/2026/10/st7789-tft-lcd-library-for-proteus-v1-0.html
    Mini submersible water pump:
      https://www.theengineeringprojects.com/2026/10/mini-submersible-water-pump-library-for-proteus-v1-0.html
    TIP122 Darlington transistor:
      https://www.theengineeringprojects.com/2026/11/tip122-darlington-library-for-proteus.html
    1N4007 diode:
      https://www.theengineeringprojects.com/2026/11/1n4007-diode-library-for-proteus.html
    Emergency stop switch:
      https://www.theengineeringprojects.com/2026/11/emergency-stop-switch-library-for-proteus.html
    Resistor:
      https://www.theengineeringprojects.com/2026/11/resistor-library-for-proteus.html
    Laptop WiFi Monitor:
      https://www.theengineeringprojects.com/2026/10/laptop-wifi-monitor-library-for-proteus.html
    Mobile WiFi Monitor:
      https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
  Support our free work: https://www.theengineeringprojects.com/donate

FILE STRUCTURE
ESP32-Water-Tank-Monitor-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEP1N4007.LIB                                   9.7 KB   a part of the project -> LIBRARY folder
|   |-- TEPESP32V1.LIB                                 36.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPESTOP.LIB                                   22.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPST7789.LIB                                  85.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPSUBPUMP.LIB                                 16.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPTFLUNA.LIB                                  50.3 KB   a part of the project -> LIBRARY folder
|   |-- TEPTIP.LIB                                     15.2 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEP1N4007.DLL                                 286.5 KB   a model -> MODELS folder
|   |-- TEPESTOP.DLL                                  278.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   a model -> MODELS folder
|   |-- TEPST7789.DLL                                 315.0 KB   a model -> MODELS folder
|   |-- TEPSUBPUMP.DLL                                296.5 KB   a model -> MODELS folder
|   |-- TEPTFLUNA.DLL                                 309.5 KB   a model -> MODELS folder
|   |-- TEPTIP.DLL                                    294.5 KB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_Water_Tank_Monitor.hex                   90.5 KB   the firmware
|   |-- ESP32-Water-Tank-Monitor.pdsprj                35.9 KB   the project simulation
|   |-- TEP1N4007.DLL                                 286.5 KB   copy of the model
|   |-- TEPESTOP.DLL                                  278.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|   |-- TEPST7789.DLL                                 315.0 KB   copy of the model
|   |-- TEPSUBPUMP.DLL                                296.5 KB   copy of the model
|   |-- TEPTFLUNA.DLL                                 309.5 KB   copy of the model
|   |-- TEPTIP.DLL                                    294.5 KB   copy of the model
|-- Arduino Code/
|   |-- ESP32_Water_Tank_Monitor/ESP32_Water_Tank_Monitor.ino   11.7 KB   the sketch (source of the .hex)
|-- README.txt                                        ~10.5 KB   this file
Total: 10.60 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A water tank level monitor you can run in Proteus: an ESP32 DevKit V1 measures the water in a rooftop tank with a
  LiDAR looking down from the lid, draws the tank on a colour TFT, fills it with a pump when it runs low, and stops
  the pump for a dry run, an overflow or an emergency stop. A web page shows the tank and runs the pump by hand.
    * TF-Luna LiDAR (TFLUNAADVTEP, U2) on the 5 V rail, UART at 115200 baud (CFG open): TXD to RX2 (GPIO16), RXD from
      TX2 (GPIO17). The sketch sets 10 frames a second and checks every frame's checksum.
    * ST7789 1.54" IPS TFT, 240 x 240 (TFT154ST7789ADVTEP, TFT1) on +3.3V: SCL D18, SDA D23, RES D15, DC D4, CS D5,
      BLK D21 (HIGH = the backlight on).
    * Mini submersible pump (SUBPUMPTEP, M1) on the 5 V rail, switched on its low side by Q1 TIP122 (TIP122TEP; base
      through R1 1k from D25, emitter to GND); D1 1N4007 (DIODE1N4007TEP) across the pump.
    * Emergency stop (SWITCHESTOPTEP, SW1): its NC block 11 - 12 from D27 (internal pull-up) to GND - READY = LOW,
      LATCHED = HIGH.
    * ESP32 DEVKIT V1 (U1) runs ESP32_Water_Tank_Monitor.hex on TEP-WiFi at 192.168.1.101.
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open http://192.168.1.101/.
  The tank and the rules (at the top of the sketch):
    * the sensor sees the bottom at 210 cm and a full tank at 30 cm; 1000 litres when full;
    * AUTO starts the pump under 25 % and stops it at 85 %;
    * pumping for 30 s without the level rising 2 % = DRY RUN: the pump stops until RESET;
    * over 100 % = OVERFLOW: the pump off; the E-stop stops the pump at once and keeps it off while latched.
  Its pages:
    /            the dashboard: the level, the litres, the surface's distance, the pump, the mode, the events
    /auto        automatic
    /on  /off    the pump on / off by hand
    /reset       clear a DRY RUN
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (simulation times):
    * Start: "ready - AUTO" at 3 s; the TF-Luna at 150 cm = 33 %, 330 L; the pump off. The TF-Luna took the sketch's
      frame rate command: 10 frames a second.
    * 200 cm (5 %): "pump ON (the tank is low)" at 12 s. 100 cm (61 %), then 50 cm (88 %): "pump OFF (the tank is
      full)" at 19 s.
    * 200 cm again: the pump ON at 23 s; the level stayed at 5 %: "DRY RUN - 5 % after 30 s of pumping" at 53 s.
    * RESET from the phone at 57 s: the pump ON again; the E-stop latched at 59 s: the pump OFF at once; released at
      62 s: the pump ON.
    * 10 cm: inside the TF-Luna's 20 cm dead zone it reported 16 cm, 107 %: "OVERFLOW" at 63 s, the pump OFF, the tank
      red on the TFT. 100 cm: back to 61 %.
    * The TF-Luna: 726 frames, none broken.
  Earlier runs: the TF-Luna stood partly off the sheet and the TFT, redrawing at every jitter of the raw distance, was
  captured half drawn - the sketch now takes the median of 5 frames.
  73 s of simulation took about 8.5 minutes on our PC with all the captures.

INSTALLATION
  1. Close Proteus. Extract the WHOLE zip file, for example to your Desktop.
  2. Copy the files from "Proteus Library Files" into the LIBRARY folder of Proteus, for example
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
  3. Copy the DLL files from "Proteus Model Files" into the MODELS folder (next to LIBRARY).
  4. Start Proteus. Press P in the schematic and search for ESP32 DEVKIT V1, TFLUNAADVTEP or SWITCHESTOPTEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-Water-Tank-Monitor.pdsprj". Keep ESP32_Water_Tank_Monitor.hex and the DLL files
     beside it.
  2. Press Play. The board joins TEP-WiFi; the TFT draws the tank at 33 % (the TF-Luna's 150 cm).
  3. In the TF-Luna's pop-up (U2) pick 200 cm: LOW, the pump starts. 100 cm, then 50 cm: the tank fills and the pump
     stops at 88 %. 200 cm again and wait 30 s: DRY RUN. 10 cm: OVERFLOW.
  4. Open the E-stop's pop-up (the small dot on it) and press Flip: the pump stops. Flip again to release it.
  5. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1), press Go; try RESET, PUMP ON / OFF, AUTO.
  Your own sketch: open "Arduino Code\ESP32_Water_Tank_Monitor" in the Arduino IDE with the TEP Boards for Proteus
  package and the Adafruit GFX, Adafruit ST7735 and ST7789 and Adafruit BusIO libraries, export the compiled binary
  and set U1's PROGRAM to the new HEX.

PROPERTIES USED IN THIS PROJECT
  U1 ESP32 DEVKIT V1          PROGRAM=ESP32_Water_Tank_Monitor.hex
  U2 TFLUNAADVTEP             (no changes: the target at 150 cm, CFG open = UART)
  TFT1 TFT154ST7789ADVTEP     (no changes)
  R1 RESISTOR4BANDTEP         1k
  PC1, MOB1                   HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * The level stays at "--": no frames from the TF-Luna - TXD / RXD swapped, CFG at GND (I2C mode), or no 5 V.
  * The level jumps or reads far too high: the beam hits the tank's wall or a pipe - mount the sensor in the middle.
  * The TFT stays dark: BLK is LOW, or CS / DC / RES are on the wrong pins.
  * DRY RUN at every start: the pump really moves too little water for DRY_RISE in DRY_MS - raise DRY_MS.
  * The pump never starts: the E-stop is latched, or the TIP122's base resistor is not on D25.

LICENCES
  * The project, the sketch, the parts (LIB files) and the models (DLL files) are made by The Engineering Projects
    and are free for learning and for your own projects. The models use only standard Windows libraries. The C++
    source code of the models is not included; the source code is not included for any model.
  * The sketch uses the ESP32 core's WiFi and WebServer and three Adafruit libraries (install them with the Library
    Manager): Adafruit GFX (BSD licence), Adafruit ST7735 and ST7789 (MIT licence) and Adafruit BusIO (MIT licence).
  * Proteus is a product of Labcenter Electronics and is not included. ESP32 is a name of Espressif Systems; TF-Luna
    is a product of Benewake. This project is not made or endorsed by them.

VERSION
  V1.0 - the first release of the project.
===============================================================================================================