Project Files of IoT Smart Dustbin with ESP32 - Proteus Simulation

===============================================================================================================
  IoT Smart Dustbin 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-smart-dustbin-esp32-proteus-simulation.html
  The libraries this project is built from (each post has its own full download and tutorial):
    ESP32 DevKit V1 board (and the TEP Boards for Proteus Arduino add-on):
      https://www.theengineeringprojects.com/2026/10/esp32-devkit-v1-library-for-proteus-v2-0.html
    HC-SR04 ultrasonic sensor:
      https://www.theengineeringprojects.com/2026/10/ultrasonic-sensor-library-for-proteus-v2-0.html
    Sharp GP2Y0A21YK0F IR distance sensor:
      https://www.theengineeringprojects.com/2026/10/sharp-ir-distance-sensor-library-for-proteus-v1-0.html
    TM1637 4-digit 7-segment display:
      https://www.theengineeringprojects.com/2026/10/tm1637-7-segment-display-library-for-proteus-v1-0.html
    SG90 servo motor:
      https://www.theengineeringprojects.com/2026/10/sg90-servo-motor-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-Smart-Dustbin-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPESP32V1.LIB                                 36.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPHCSR04.LIB                                 170.1 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
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPSG90.LIB                                    24.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPSHARPIR.LIB                                 62.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPTM1637.LIB                                  84.8 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPHCSR04.DLL                                 382.5 KB   a model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   a model -> MODELS folder
|   |-- TEPSG90.DLL                                   294.5 KB   a model -> MODELS folder
|   |-- TEPSHARPIR.DLL                                325.0 KB   a model -> MODELS folder
|   |-- TEPTM1637.DLL                                 284.0 KB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_Smart_Dustbin.hex                        77.4 KB   the firmware
|   |-- ESP32-Smart-Dustbin.pdsprj                     40.6 KB   the project simulation
|   |-- TEPHCSR04.DLL                                 382.5 KB   copy of the model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|   |-- TEPSG90.DLL                                   294.5 KB   copy of the model
|   |-- TEPSHARPIR.DLL                                325.0 KB   copy of the model
|   |-- TEPTM1637.DLL                                 284.0 KB   copy of the model
|-- Arduino Code/
|   |-- ESP32_Smart_Dustbin/ESP32_Smart_Dustbin.ino    13.2 KB   the sketch (source of the .hex)
|-- README.txt                                        ~10.9 KB   this file
Total: 10.35 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A touch-free dustbin you can run in Proteus: an ESP32 opens the lid when a hand comes near, measures how full the
  bin is, shows it on a 4-digit display and LEDs, and reports it to any laptop or phone on the Wi-Fi.
    * Sharp GP2Y0A21YK0F IR distance sensor (GP2Y0A21ADVTEP, U3) on the front of the lid, 5 V: VO on D34 (ADC).
      A hand within 20 cm opens the lid. DISTANCE=0: nothing in front at the start.
    * HC-SR04 ultrasonic sensor (HCSR04ADVTEP, U2) under the lid looking down, 5 V: TRIG on D5, ECHO on D18. The
      distance to the rubbish; the bin is 50 cm deep (0 %), 5 cm below the sensor is 100 %.
    * SG90 servo (SG90SERVOTEP, SERVO1), 5 V: SIG on D13 (50 Hz, 544 - 2400 us): the lid, 0 deg closed, 100 deg
      open.
    * TM1637 4-digit display (TM1637ADVTEP, TM1), 3.3 V: CLK on D22, DIO on D21: the fill in %, OPEn while the lid is
      open, FULL when the bin is full. The sketch drives it with its own code (two wires, open drain).
    * LEDs (LED5MMGREENTEP / LED5MMYELLOWTEP / LED5MMREDTEP) on D25 / D26 / D27 through 220 ohm: room in the bin /
      almost full / full (the red LED flashes when a hand is refused).
    * ESP32 DEVKIT V1 (U1) runs ESP32_Smart_Dustbin.hex on TEP-WiFi at 192.168.1.101; the dashboard is on port 80.
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open http://192.168.1.101/.
  The 5 V parts and the board's VIN share the VCC net (the simulation's 5 V rail).
  The rules (at the top of the sketch):
    * a hand within 20 cm opens the lid; it closes 3 s after the hand has gone;
    * the level is measured only while the lid is closed and still (1.5 s after closing), the median of 3 pings;
    * almost full from 50 %, full from 85 % (each clears 5 % lower); a full bin keeps its lid closed;
    * a bin that was at least 50 % full and reads below 20 % has been emptied (counted).
  Its pages:
    /            the dashboard: the fill, the lid, the hand sensor, the counts, the events
    /open        open the lid for 15 s to empty the bin (also when full)
    /close       close the lid now
    /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: "TM1637 display OK", "ready - the lid closed" at 2 s; the bin 0 % (49.9 cm; the HC-SR04's ECHO 2911.9 us).
    * HAND on the Sharp sensor (15 cm, VO 1.658 V): "lid OPEN (a hand at 15 cm)" at 12 s (the servo 1575 us = 100 deg,
      OPEn on the display); "lid CLOSED (the hand has gone)" at 16 s.
    * 25 cm on the HC-SR04 (ECHO 1455.9 us): "56 % full - ALMOST FULL" at 19 s (the display 00 00 6D 7D).
    * 10 cm: "89 % full - FULL - please empty it" at 23 s (FULL: 71 3E 38 38, the red LED).
    * HAND again: "a hand, but the bin is FULL - the lid stays closed" at 26 s.
    * OPEN from the laptop: "lid OPEN for emptying" at 30 s; 50 cm on the HC-SR04; CLOSE from the phone at 33 s;
      "the bin was emptied (89 % to 0 %) - collection 1" at 35 s.
  39 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, HCSR04ADVTEP or GP2Y0A21ADVTEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-Smart-Dustbin.pdsprj". Keep the .hex and .DLL files beside it.
  2. Press Play. The ESP32 joins TEP-WiFi; the display shows 0 (an empty bin) and the green LED is on.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the Sharp sensor's pop-up (U3) press HAND: the lid opens, and closes 3 s after the hand has gone.
  5. In the HC-SR04's pop-up (U2) press 25 (cm): ALMOST FULL; 10: FULL. HAND again: the lid stays closed.
  6. OPEN on the page opens the lid to empty the bin; set U2 back to 50 and press CLOSE: the bin was emptied.
  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 ESP32Servo library from the Arduino Library Manager (for a real board); 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_Smart_Dustbin.hex
  U2 HCSR04ADVTEP             (no changes: a WALL at 50 cm, 20 C)
  U3 GP2Y0A21ADVTEP           DISTANCE=0 (nothing in front)
  TM1 TM1637ADVTEP            (no changes)
  SERVO1 SG90SERVOTEP         (no changes: PULSE_MIN 544, PULSE_MAX 2400)
  PC1, MOB1                   HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * The level never changes: the lid is open (the level is read only with the lid closed), or TRIG / ECHO are swapped.
  * The HC-SR04's pop-up says NO POWER: its VCC must be on the 5 V rail (VCC) and its GND on ground.
  * The lid opens by itself: something stands within 20 cm of the Sharp sensor - press NONE in its pop-up.
  * The lid never opens: the bin is FULL (empty it with OPEN on the page), or VO is not on D34.
  * The display stays dark: CLK and DIO are swapped, or the display has no 3.3 V.
  * "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); its ESP32Servo is the add-on's own (MIT). No third-party
    library is compiled into it.
  * Proteus is a product of Labcenter Electronics and is not included. ESP32 (Espressif Systems), Sharp and TM1637
    (Titan Micro Electronics) are names of their owners; this project is not made or endorsed by them.

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