Project Files of IoT Water Quality Monitoring System with ESP32 - Proteus Simulation

===============================================================================================================
  IoT Water Quality Monitoring System 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-quality-monitoring-system-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
    TDS meter:
      https://www.theengineeringprojects.com/2026/10/tds-meter-library-for-proteus-v1-0.html
    Turbidity sensor:
      https://www.theengineeringprojects.com/2026/10/turbidity-sensor-library-for-proteus-v1-0.html
    DS18B20 temperature sensor and waterproof probe:
      https://www.theengineeringprojects.com/2026/10/ds18b20-library-for-proteus-v1-0.html
    Relay module:
      https://www.theengineeringprojects.com/2026/10/relay-module-library-for-proteus-v1-0.html
    12V solenoid water valve:
      https://www.theengineeringprojects.com/2026/11/12v-solenoid-water-valve-library-for-proteus-v1-0.html
    1N4007 diode:
      https://www.theengineeringprojects.com/2026/11/1n4007-diode-library-for-proteus.html
    OLED SSD1306 (128x64):
      https://www.theengineeringprojects.com/2026/10/oled-ssd1306-library-for-proteus-v1-0.html
    5mm LED:
      https://www.theengineeringprojects.com/2026/11/5mm-led-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-Quality-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEP1N4007.LIB                                   9.7 KB   a part of the project -> LIBRARY folder
|   |-- TEPDS18B20.LIB                                 88.0 KB   a part of the project -> LIBRARY folder
|   |-- TEPESP32V1.LIB                                 36.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPLED5MM.LIB                                  21.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPOLED12864.LIB                              112.4 KB   a part of the project -> LIBRARY folder
|   |-- TEPRELAY.LIB                                  490.4 KB   a part of the project -> LIBRARY folder
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPTDS.LIB                                     63.4 KB   a part of the project -> LIBRARY folder
|   |-- TEPTURBIDITY.LIB                               68.2 KB   a part of the project -> LIBRARY folder
|   |-- TEPVALVE.LIB                                   18.4 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEP1N4007.DLL                                 286.5 KB   a model -> MODELS folder
|   |-- TEPDS18B20.DLL                                305.0 KB   a model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPOLED.DLL                                   342.5 KB   a model -> MODELS folder
|   |-- TEPRELAY.DLL                                  330.0 KB   a model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   a model -> MODELS folder
|   |-- TEPTDS.DLL                                    314.5 KB   a model -> MODELS folder
|   |-- TEPTURBIDITY.DLL                              322.0 KB   a model -> MODELS folder
|   |-- TEPVALVE.DLL                                  281.0 KB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_Water_Quality.hex                       111.5 KB   the firmware
|   |-- ESP32-Water-Quality.pdsprj                     40.7 KB   the project simulation
|   |-- TEP1N4007.DLL                                 286.5 KB   copy of the model
|   |-- TEPDS18B20.DLL                                305.0 KB   copy of the model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPOLED.DLL                                   342.5 KB   copy of the model
|   |-- TEPRELAY.DLL                                  330.0 KB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|   |-- TEPTDS.DLL                                    314.5 KB   copy of the model
|   |-- TEPTURBIDITY.DLL                              322.0 KB   copy of the model
|   |-- TEPVALVE.DLL                                  281.0 KB   copy of the model
|-- Arduino Code/
|   |-- ESP32_Water_Quality/ESP32_Water_Quality.ino    11.2 KB   the sketch (source of the .hex)
|-- README.txt                                        ~14.3 KB   this file
Total: 12.63 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete IoT water quality monitor you can run in Proteus: an ESP32 DevKit V1 checks the water that flows into a
  tank, closes the supply valve when the water is not safe, and shows everything on an OLED and on a web page for a
  laptop or a phone.
    * TDS meter (TDSMETERADVTEP, U2) on 5 V (the board's VIN): A (0 - 2.3 V) on D34. TDS = EC x 0.5, the EC from
      the maker's curve after the voltage is brought back to 25 C (2 % per C) with the probe's temperature.
    * Turbidity sensor (TURBIDITYADVTEP, U3) on 5 V: OUT (0 - 4.5 V) through R1 10k / R2 20k to D35 (the ADC sees
      2/3). The maker's curve NTU = -1120.4 V^2 + 5742.3 V - 4352.9; the voltage averaged over 8 s; CAL CLEAR stores
      this probe's clear-water voltage (the divider loads the board's output by about 3 %).
    * DS18B20 waterproof probe (DS18B20PROBEADVTEP, U4) on 3V3: DQ on D4 with R3 4.7k to 3V3 (OneWire), 12 bits,
      read without waiting (setWaitForConversion false).
    * 1-channel relay (RELAY1ADVTEP, RLY1) on 5 V: IN on D26 (active LOW); COM from +12V, NO to the 12 V solenoid
      water valve (WATERVALVETEP, SV1, normally closed); D3 1N4007 across the valve's coil.
    * OLED 128x64 SSD1306 (OLED12864YELLOWBLUEADVTEP, OLED1) at 0x3C: SDA D21, SCL D22.
    * Green LED on D25 (SAFE) and red LED on D27 (NOT SAFE), each through 220 ohm (R4, R5).
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open the dashboard at http://192.168.1.101/.
  The water is SAFE while TDS <= 900 ppm and turbidity <= 50 NTU; once unsafe it must come back below 880 ppm and
  40 NTU. In AUTO the valve closes 2 s after the water turns unsafe and opens after 5 s of safe water. Its pages:
    /            the dashboard: the verdict, the valve, TDS, EC, turbidity (with the voltages), the temperature,
                 the events (newest first)
    /open        open the valve (MANUAL)
    /close       close the valve (MANUAL)
    /auto        back to AUTO
    /cal         the turbidity probe is in clear water: store its voltage as this probe's zero
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (simulation times):
    * OLED at 0x3C OK, DS18B20 found on D4 (25.0 C); tap water (TDS 249 ppm) but the turbidity probe not yet
      calibrated: 4.056 - 4.060 V read as about 500 NTU - "water NOT SAFE" at 2 s, the valve CLOSED.
    * CAL CLEAR from the laptop at 10 s: "CAL: clear water reads 4.056 V", "water SAFE: 251 ppm, 10 NTU"; the valve
      OPEN (AUTO) at 16 s (the valve's window: 14.1 L/min at 2 bar, 0.45 A).
    * MUD on the turbidity sensor: NOT SAFE at 21 s (458 NTU, then 3000 NTU), the valve CLOSED at 23 s; TAP again:
      SAFE at 35 s, OPEN at 41 s.
    * SEA on the TDS meter: NOT SAFE at 43 s (1103 ppm, then 1121 ppm - the top of the range), CLOSED at 46 s.
    * OPEN from the phone at 50 s: the valve OPEN (MANUAL); AUTO from the laptop at 54 s: CLOSED again at 56 s.
    * TAP on the TDS meter: SAFE at 60 s (249 ppm, 36 NTU), the valve OPEN at 65 s.
    * Clear water averages between 0 and about 50 NTU after the calibration: the probe's few millivolts of noise
      on the steep part of the curve; the 8 s average and the hysteresis keep the verdict steady.
  70 s of simulation took about 17 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 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, TDSMETERADVTEP or TURBIDITYADVTEP to
     check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-Water-Quality.pdsprj". Keep the .hex and .DLL files beside it.
  2. Press Play. The ESP32 joins TEP-WiFi; the OLED shows NOT SAFE until the turbidity probe is calibrated.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. With the turbidity sensor (U3) in clear or tap water, press CAL CLEAR: the water reads SAFE, the valve opens.
  5. Change the water in the pop-ups: MUD (U3) or SEA (U2) closes the valve; TAP opens it again. OPEN / CLOSE on
     the page switch to MANUAL; AUTO hands the valve back to the sensors.
  Your own sketch: the source is in "Arduino Code". Install the TEP Boards for Proteus add-on from the ESP32 DevKit V1
  post, and the OneWire, DallasTemperature, Adafruit SSD1306, Adafruit GFX and Adafruit BusIO libraries from the
  Arduino Library Manager; choose Tools > Board > ESP32 DevKit V1 (TEP Proteus), export the compiled binary and set
  the board's PROGRAM property to the new .hex file. The same sketch runs on a real ESP32 Dev Module.

PROPERTIES USED IN THIS PROJECT
  U1 ESP32 DEVKIT V1          PROGRAM=ESP32_Water_Quality.hex
  U2 TDSMETERADVTEP           TDS=250 (ppm; TAP), the water at 25 C
  U3 TURBIDITYADVTEP          (no changes: TAP water, 1 NTU)
  U4 DS18B20PROBEADVTEP       TEMPERATURE=25 (the same water as U2's)
  SV1 WATERVALVETEP           (no changes: 12 V, 2 bar)
  PC1, MOB1                   HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * Clear water reads hundreds of NTU: press CAL CLEAR with the turbidity probe in clear water.
  * "DS18B20 missing (25 C used)": DQ is not on D4, or R3 4.7k is missing.
  * TDS reads too high or too low: the DS18B20's temperature differs from the TDS meter's water temperature.
  * The valve never opens: the water is unsafe, or the page is in MANUAL with the valve closed - press AUTO.
  * "Connecting to TEP-WiFi......" never ends: the .hex file is missing beside the project, or TEPNET.DLL is not in
    MODELS. Copy the files again and restart Proteus.

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 .hex file is built from the sketch with TEP Boards for Proteus, the Arduino add-on in the ESP32 DevKit V1
    download (its licences are listed in that download), and contains the libraries below.
  * Proteus is a product of Labcenter Electronics and is not included. ESP32 (Espressif Systems) and DS18B20 (Analog
    Devices / Maxim) are names of their owners; this project is not made or endorsed by them.

THIRD-PARTY LICENCES (compiled into ESP32_Water_Quality.hex)
  OneWire 2.3.8 - Copyright (c) 2007 Jim Studt, 2008 - 2012 Paul Stoffregen and others - Permission is hereby granted,
  free of charge, to any person obtaining a copy of this software and associated documentation files (the
  "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
  modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom
  the Software is furnished to do so, subject to the following conditions: The above copyright notice and this
  permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED
  "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.
  DallasTemperature (Arduino-Temperature-Control-Library) 4.0.6 - Copyright (c) 2024 Miles Burton - MIT licence, the
  same terms as OneWire above.
  Adafruit SSD1306 2.5.17 - Copyright (c) 2012, Adafruit Industries - BSD licence: Redistribution and use in source
  and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
  Redistributions of source code must retain the above copyright notice, this list of conditions and the following
  disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions
  and the following disclaimer in the documentation and/or other materials provided with the distribution. 3.
  Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote
  products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE
  COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  CONSEQUENTIAL DAMAGES HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGE.
  Adafruit GFX Library 1.12.6 - Copyright (c) 2012 Adafruit Industries - BSD licence: the same terms as Adafruit
  SSD1306 above, without condition 3.
  Adafruit BusIO 1.17.4 - Copyright (c) 2017 Adafruit Industries - MIT licence: Permission is hereby granted, free
  of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to
  deal in the Software without restriction, subject to the following conditions: The above copyright notice and this
  permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS
  PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.

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