Project Files of IoT Weather Station with ESP32 - Proteus Simulation

===============================================================================================================
  IoT Weather Station 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-weather-station-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
    BME280 temperature, humidity and pressure sensor:
      https://www.theengineeringprojects.com/2026/09/bme280-sensor-library-for-proteus.html
    BH1750 light sensor:
      https://www.theengineeringprojects.com/2026/09/bh1750-light-sensor-library-for-proteus.html
    OLED SSD1306 128x64:
      https://www.theengineeringprojects.com/2026/10/oled-ssd1306-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-Weather-Station-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPBH1750.LIB                                 132.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPBME280.LIB                                  89.4 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
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPOLED12864.LIB                              112.4 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPBH1750.DLL                                 363.0 KB   a model -> MODELS folder
|   |-- TEPBME280.DLL                                 381.0 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPOLED.DLL                                   342.5 KB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_Weather_Station.hex                     126.1 KB   the firmware
|   |-- ESP32-Weather-Station.pdsprj                   33.4 KB   the project simulation
|   |-- TEPBH1750.DLL                                 363.0 KB   copy of the model
|   |-- TEPBME280.DLL                                 381.0 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPOLED.DLL                                   342.5 KB   copy of the model
|-- Arduino Code/
|   |-- ESP32_Weather_Station/ESP32_Weather_Station.ino   11.6 KB   the sketch (source of the .hex)
|-- README.txt                                        ~12.2 KB   this file
Total: 8.50 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete IoT weather station you can run in Proteus: an ESP32 DevKit V1 measures the weather with two I2C sensors,
  shows it on an OLED and serves it to a laptop and a phone, all inside one Proteus simulation.
    * BME280 (BME280ADVTEP): temperature, humidity and pressure, I2C address 0x76 (SDO to ground, CSB high).
    * BH1750 (BH1750ADVTEP): light in lux, I2C address 0x23 (ADDR to ground).
    * OLED SSD1306 128x64 yellow-blue (OLED12864YELLOWBLUEADVTEP): the readings on the spot, I2C address 0x3C.
    * All three share one I2C bus: SDA on D21, SCL on D22. The OLED takes its 3.3 V from the board's 3V3 pin; the two
      sensors take theirs from power terminals (on a real build: the same 3V3 pin).
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open the dashboard at http://192.168.1.101/.
  The sketch works out the dew point (Magnus formula), the heat index (NOAA's formula, from 27 C), the sea-level
  pressure, the pressure's trend and a barometer forecast: Stormy (under 980 hPa), Rain, Change, Fair (1020 - 1040)
  and Very dry, with "falling fast: storm coming" or "rising fast: clearing" when the pressure moves more than 1.6 hPa
  in the trend window (3 hours on a real station; 30 s in this project, TREND_S in the sketch). Its pages:
    /            the dashboard: the forecast, the readings and a trend picture of the temperature and the pressure
    /trend.bmp   the last 2 minutes, drawn by the ESP32
    /units       switch between C and F (the OLED too)
    /data        all the readings as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots:
    * BME280 OK, BH1750 OK, OLED OK; TEP-WiFi joined, the dashboard at http://192.168.1.101/ after 2.4 s of
      simulation. First readings: 29.0 C, 48 %, 1016.0 hPa, 32000 lx - "Change, steady"; dew point 16.9 C.
    * STORM (BME280 pop-up) at 18.2 s: 22.0 C, 95 %, 975.0 hPa - "Stormy, steady"; Overcast 2k (BH1750 pop-up):
      2000 lx (cloudy). At 34.2 s the 30 s trend reached -41.0 hPa: "Stormy, falling fast: storm coming"; the dew
      point 21.2 C. The trend picture shows both lines drop.
    * C / F from the phone at 47.6 s: the page and the OLED in Fahrenheit; back to C from the laptop at 51.7 s.
    * SUNNY + Sun 30k at 55.9 s: 30.0 C, 35 %, 1020.0 hPa, 30000 lx - "Change, rising fast: clearing" (trend
      +45.0 hPa); dew point 12.9 C.
  69 s of simulation took about 7 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, BME280ADVTEP, BH1750ADVTEP or
     OLED12864YELLOWBLUEADVTEP to check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-Weather-Station.pdsprj". Keep the .hex and .DLL files beside it.
  2. Press Play. The OLED shows the weather; after about 2 s of simulation the serial monitor prints the address.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. Change the weather from the pop-ups (click a sensor while the simulation runs): the BME280's STORM, RAINY or
     SUNNY, the BH1750's Overcast 2k or Sun 30k. Watch the forecast and the trend picture follow.
  5. Press C / F on the page to switch the units on the page and on the OLED.
  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 Adafruit BME280, Adafruit Unified Sensor, 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_Weather_Station.hex
  U2 BME280ADVTEP      TEMPERATURE=29, HUMIDITY=48, PRESSURE=1016 (hPa)
  U3 BH1750ADVTEP      LUX=32000, STEP_TIME=0 (no timed step; the light comes from the pop-up)
  OLED1                ADDRESS=0x3C
  PC1, MOB1            HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * "BME280 missing" or "BH1750 missing" on the serial monitor: the sensor's VCC / GND are not on the supply, or its
    address pin is wrong (BME280 SDO to ground = 0x76; BH1750 ADDR to ground = 0x23). Its pop-up says NO POWER.
  * The OLED stays dark: its address is not 0x3C, or SDA / SCL are swapped.
  * The forecast's trend stays "steady": the trend needs TREND_S seconds of history first.
  * "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 Adafruit libraries below.
  * Proteus is a product of Labcenter Electronics and is not included. ESP32, BME280 and BH1750 are names of their
    owners; this project is not made or endorsed by them.

THIRD-PARTY LICENCES (compiled into ESP32_Weather_Station.hex; the libraries' sources are not included)
  Adafruit BME280 Library 2.3.0 - Copyright (c) 2015, Limor Fried & Kevin Townsend for Adafruit Industries.
  Adafruit SSD1306 2.5.17 - Copyright (c) 2012, Adafruit Industries.
  Adafruit GFX Library 1.12.6 - Copyright (c) 2012 Adafruit Industries.
  These three are under the 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 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, 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.
  Adafruit Unified Sensor - Copyright Adafruit Industries - Apache License 2.0
  (https://www.apache.org/licenses/LICENSE-2.0).

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