Project Files of IoT Environmental Data Logger with ESP32 - Proteus Simulation

===============================================================================================================
  IoT Environmental Data Logger 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-environmental-data-logger-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
    BME680 gas sensor:
      https://www.theengineeringprojects.com/2026/10/bme680-gas-sensor-library-for-proteus-v1-0.html
    Micro SD card module:
      https://www.theengineeringprojects.com/2026/10/micro-sd-card-module-library-for-proteus-v1-0.html
    E-paper display 1.54":
      https://www.theengineeringprojects.com/2026/10/e-paper-display-library-for-proteus-v1-0.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-Air-Data-Logger-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPBME680.LIB                                  66.2 KB   a part of the project -> LIBRARY folder
|   |-- TEPEPAPER.LIB                                  54.9 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
|   |-- TEPMICROSD.LIB                                 60.3 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPBME680.DLL                                 342.0 KB   a model -> MODELS folder
|   |-- TEPEPAPER.DLL                                 315.0 KB   a model -> MODELS folder
|   |-- TEPMICROSD.DLL                                318.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_Environmental_Data_Logger.hex           182.6 KB   the firmware
|   |-- ESP32-Air-Data-Logger.pdsprj                   29.7 KB   the project simulation
|   |-- TEPBME680.DLL                                 342.0 KB   copy of the model
|   |-- TEPEPAPER.DLL                                 315.0 KB   copy of the model
|   |-- TEPMICROSD.DLL                                318.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|-- Arduino Code/
|   |-- ESP32_Environmental_Data_Logger/ESP32_Environmental_Data_Logger.ino   12.5 KB   the sketch (source of the .hex)
|-- README.txt                                        ~10.6 KB   this file
Total: 8.18 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  An environmental data logger you can run in Proteus: an ESP32 reads a BME680 every 5 seconds, writes every
  reading to a micro SD card as a CSV file, shows the latest values on a 1.54" e-paper display and serves a web
  dashboard from which you download the whole log.
    * BME680 (BME680ADVTEP, U2) on the 5 V rail, I2C: SDA D21, SCL D22, address 0x77 (SDO and CS left open).
      Temperature, humidity, pressure and the gas resistance (the heater at 320 C for 150 ms). BURNIN=20 s for the demo.
    * Micro SD card module (MICROSDADVTEP, U3) on the 5 V rail, SPI: CS D5, SCK D18, MISO D19, MOSI D23. CARD=EMPTY
      (a formatted FAT16 card). One CSV file per start-up: LOG001.CSV, LOG002.CSV ... with a header row.
    * 1.54" e-paper 200 x 200, SSD1681 (EPAPER154ADVTEP, EPD1) on the 5 V rail, the same SPI: CS D27, DC D26, RST D25,
      BUSY D33, CLK D18, DIN D23. A partial refresh at every reading, a full refresh every 10th (clears the ghosting).
    * ESP32 DEVKIT V1 (U1) runs ESP32_Environmental_Data_Logger.hex on TEP-WiFi at 192.168.1.101 (port 80).
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open http://192.168.1.101/.
  The rules (at the top of the sketch):
    * air quality 0 - 100 % = a humidity score (25 points, best at 38 - 42 %RH) + a gas score (75 points: the gas
      resistance / the cleanest resistance seen after the burn-in); 80+ GOOD, 60+ FAIR, 40+ POOR, below BAD;
    * every reading: the card is asked first (CMD13 SEND_STATUS - the SD library's close() reports no error, so a
      pulled card would go unnoticed), then the file is opened, one line added, the file closed;
    * no card: SD: NO CARD on the display, a write error counted, the card mounted again at every reading - a new
      file when it comes back.
  Its pages:
    /            the dashboard: the readings, the card, the file, the last readings, the events
    /log.csv     the whole log file as it is on the card (a download)
    /new         start a new log file
    /data        everything as JSON
  Libraries for your own builds (not included): Adafruit BME680 2.0.6 with Adafruit Unified Sensor and Adafruit BusIO,
  SD 1.3.0, GxEPD2 1.6.9 (GxEPD2_154_D67) and Adafruit GFX 1.12.6 - install them in the Arduino IDE.

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (the sketch's times):
    * 7 s: card ready - logging to LOG001.CSV; the first reading at 9 s (23.00 C, 40.0 %RH, 1013.3 hPa, 85.6 kOhm
      during the burn-in); the gas resistance settled at 123 - 124 kOhm (the clean-air reference 123.8 kOhm).
    * BREATH: "air POOR - 42 %" at 54 s (55.6 %RH, 38.7 kOhm).
    * SANITIZER: "air BAD - 30 %" at 69 s (19.0 kOhm), 17.9 kOhm at 74 s.
    * VENTILATE: POOR at 89 s, "air FAIR - 60 %" at 119 s (61.9 kOhm), "air GOOD - 80 %" at 149 s (94.1 kOhm).
    * SHOWER: "air POOR - 40 %" at 154 s (90.0 %RH, 59.0 kOhm); FRESH: "air GOOD - 84 %" at 174 s.
    * The card pulled out: "SD write failed - no card in the socket" at 184 s, SD: NO CARD on the e-paper; put back:
      "card ready - logging to LOG002.CSV" at 198 s.
    * DOWNLOAD CSV from the laptop at 212 s (LOG002.CSV); NEW FILE from the phone at 221 s: LOG003.CSV.
    * The card at the end: LOG001.CSV 1262 B (35 readings), LOG002.CSV 249 B, LOG003.CSV 214 B; 829 commands,
      105 blocks read, 105 written, 0 errors. The BME680: 46 measurements.
  An earlier run showed why the sketch asks the card before writing: with the card pulled out, the SD library went on
  "writing" into its cache and every line looked fine - 18 readings went nowhere.
  236 s of simulation took about 30 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, BME680ADVTEP or EPAPER154ADVTEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-Air-Data-Logger.pdsprj". Keep the HEX and the DLL files beside it.
  2. Press Play. The e-paper shows starting, the card gets LOG001.CSV, a reading follows every 5 seconds.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the BME680's pop-up (U2) click BREATH, SANITIZER, VENTILATE or SHOWER - each stays on until you click it
     again. Click CARD in the SD card's pop-up (U3) to pull the card out, and again to put it back.
  Your own sketch: compile it, export the compiled binary and set U1's PROGRAM property to the new file.

PROPERTIES USED IN THIS PROJECT
  U1 ESP32 DEVKIT V1           PROGRAM=ESP32_Environmental_Data_Logger.hex, AUTOOPEN=YES (TEP-WiFi, 192.168.1.101)
  U2 BME680ADVTEP              BURNIN=20 (the gas burn-in shortened for the demo)
  U3 MICROSDADVTEP             CARD=EMPTY (a formatted FAT16 card, no files)
  EPD1 EPAPER154ADVTEP         (no changes)
  PC1, MOB1                    HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * SD: NO CARD at the start: check CS (D5), MISO and MOSI; a card property of RAW (never formatted) or NONE.
  * The e-paper stays blank: BUSY is not connected (the library waits for it), or CS / DC are swapped.
  * Faint old text on the e-paper: ghosting after partial refreshes - the full refresh every 10th reading clears it.
  * BME680 not found at 0x77: SDA / SCL swapped, or SDO tied LOW (the address is then 0x76).
  * The air quality reads 100 % at the start: normal during the burn-in, before the clean-air reference is set.

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 Adafruit BME680, Adafruit Unified Sensor, Adafruit BusIO and Adafruit GFX libraries (BSD,
    Apache 2.0 and MIT licences), SD (GNU GPL v3) and GxEPD2 (GNU GPL v3); they are named here, not included.
  * Proteus is a product of Labcenter Electronics and is not included. ESP32 is a product of Espressif Systems and
    BME680 a product of Bosch Sensortec. This project is not made or endorsed by them. The air-quality score is a
    relative score, not a certified air quality index.

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