Project Files of IoT RGB Mood Lamp with ESP32 - Proteus Simulation

===============================================================================================================
  IoT RGB Mood Lamp 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-rgb-mood-lamp-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
    WS2812B NeoPixel (the ring of 16):
      https://www.theengineeringprojects.com/2026/10/ws2812b-neopixel-library-for-proteus-v1-0.html
    Slide potentiometer:
      https://www.theengineeringprojects.com/2026/11/slide-potentiometer-library-for-proteus.html
    Push button:
      https://www.theengineeringprojects.com/2026/11/push-button-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-RGB-Mood-Lamp-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPBUTTON.LIB                                  20.7 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
|   |-- TEPSLIDEPOT.LIB                                75.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPWS2812.LIB                                  1.59 MB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPBUTTON.DLL                                 274.0 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPSLIDEPOT.DLL                               305.0 KB   a model -> MODELS folder
|   |-- TEPWS2812.DLL                                 312.5 KB   a model -> MODELS folder
|-- Proteus Simulation/
|   |-- ESP32_RGB_Mood_Lamp.hex                        71.0 KB   the firmware
|   |-- ESP32-RGB-Mood-Lamp.pdsprj                     41.5 KB   the project simulation
|   |-- TEPBUTTON.DLL                                 274.0 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPSLIDEPOT.DLL                               305.0 KB   copy of the model
|   |-- TEPWS2812.DLL                                 312.5 KB   copy of the model
|-- Arduino Code/
|   |-- ESP32_RGB_Mood_Lamp/ESP32_RGB_Mood_Lamp.ino     8.9 KB   the sketch (source of the .hex)
|-- README.txt                                        ~10.5 KB   this file
Total: 9.43 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  An RGB mood lamp you can run in Proteus: an ESP32 drives a ring of 16 WS2812B LEDs, a slide potentiometer sets
  the brightness, a push button steps through the modes and a web dashboard picks the mode, the colour and a sleep
  timer.
    * WS2812B ring of 16 (WS2812RING16ADVTEP, NEO1): 5V on VIN (5 V), DIN on D13, DOUT open (the end of the chain).
      One data wire: 24 bits a LED (green, red, blue, MSB first) at 800 kHz, 384 bits for the whole ring, then a
      reset pause latches the frame. 50 frames a second.
    * 60 mm slide potentiometer (SLIDEPOT60TEP, RV1, B10K): pin 1 to GND, pin 3 to 3V3, the wiper W on D34 (ADC,
      0 - 4095). The reading is mapped to a brightness of 0 - 255.
    * Push button (BUTTONBLUETEP, SW1): pin 1 on D27 (INPUT_PULLUP), pin 2 to GND. Its contacts bounce for 5 ms
      (BOUNCE=5), and the sketch accepts a change only after the pin has been still for 30 ms.
    * ESP32 DEVKIT V1 (U1) runs ESP32_RGB_Mood_Lamp.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 modes (the button goes round them in this order):
    SOLID (one colour), BREATHE (the colour fading in and out, 4 s), RAINBOW (the colour wheel turning round the
    ring, one turn in 5 s), FIRE (a warm flicker, every LED on its own), NIGHT (a warm glow at 10 % of the
    brightness), OFF. The colours: RED, GREEN, BLUE, WARM, COOL, PURPLE. The sleep timer fades the lamp out in a
    straight line and switches it OFF (30 s in the demo; make it 30 minutes on a real lamp).
  Its pages:
    /                                           the dashboard: the mode, the colour, the brightness, the events
    /solid /breathe /rainbow /fire /night /off  the mode
    /red /green /blue /warm /cool /purple       the colour (and SOLID; in BREATHE it keeps breathing)
    /sleep                                      the sleep timer
    /data                                       everything as JSON
  Only / and /data are registered with server.on(); every other address goes to server.onNotFound(), the same
  dashboard handler, which reads the address with server.uri(). (The ESP32 WebServer holds 12 routes at most; a
  13th server.on() is dropped without a word and its page answers 404.)
  Library for your own builds (not included): Adafruit NeoPixel 1.12.3 - install it 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):
    * 2 s: mode RAINBOW at 49 % (the slider at 2047 of 4095, 1.65 V): 16 of 16 LEDs lit, 50 frames a second, each
      frame 384 bits = 16 pixels in 0.48 ms (T0H 0.31 us, T1H 0.81 us, 1.25 us a bit); the ring drew 254 mA.
    * The slider to 100 % (4087): 99 %, 493 mA; to 0 % then +10 % (416): 9 %, 62 mA; back to 50 %.
    * The button: "mode FIRE" at 26 s - "press 1: 9 edges, 8 of them bounces" - FIRE drew 176 mA; "mode NIGHT" at 31 s
      ("press 2: 5 edges, 4 of them bounces"), 36 mA.
    * WARM from the laptop at 34 s: SOLID WARM, 267 mA. BREATHE from the phone at 36 s, PURPLE at 38 s: 233 mA at the
      top of a breath, 93 mA near its bottom.
    * SLEEP 30 s from the laptop at 44 s: halfway 89 mA, "mode OFF (the sleep timer)" at 74 s: 0 of 16 lit, 16 mA (the
      LEDs' own idle current, 1 mA each).
    * The button at 78 s: "mode SOLID (the button)" ("press 3: 7 edges, 6 of them bounces"), SOLID PURPLE, 281 mA.
    * At the end: 4,190 frames; the highest current 494 mA (full white would be 976 mA); the button 3 presses and 52
      edges - every bounce filtered out, no press counted twice.
  84 s of simulation took about 6.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 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, WS2812RING16ADVTEP, SLIDEPOT60TEP or
     BUTTONBLUETEP to check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\ESP32-RGB-Mood-Lamp.pdsprj". Keep the HEX and the DLL files beside it.
  2. Press Play. The ring turns in the RAINBOW mode at half brightness.
  3. Move the slider in its pop-up (RV1): the buttons 0 %, 50 %, 100 % and the steps of 1 % and 10 %.
  4. Press the button in its pop-up (SW1) to go to the next mode.
  5. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Try the colours, BREATHE
     and SLEEP 30 s; press Refresh to update the page.
  The ring's pop-up (NEO1) shows every LED, its colour value, the frames and the current.
  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_RGB_Mood_Lamp.hex, AUTOOPEN=YES (TEP-WiFi, 192.168.1.101)
  NEO1 WS2812RING16ADVTEP      (no changes)
  RV1 SLIDEPOT60TEP            VALUE=B10K (a linear 10 kOhm track), POWER=0.25
  SW1 BUTTONBLUETEP            BOUNCE=5 (5 ms of contact bounce), RCLOSED=0.1
  PC1, MOB1                    HOMEPAGE=http://192.168.1.101/

TROUBLESHOOTING
  * The ring stays dark: the data goes into DIN, not DOUT; check the 5 V on the ring's 5V pin.
  * Red and green swapped: the ring is RGB, not GRB - change NEO_GRB to NEO_RGB in the sketch.
  * One press jumps two modes: the debounce time is shorter than the bounce - raise DEBOUNCE_MS.
  * The brightness never reaches 0 or 100 %: the slider's ends are swapped or not on GND and 3V3.
  * A dashboard link answers 404: more than 12 server.on() routes - send the rest to onNotFound().
  * The dashboard does not open: wait for the "Dashboard: http://192.168.1.101/" line in the serial monitor.

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 NeoPixel library (GNU LGPL v3); it is named here, not included.
  * Proteus is a product of Labcenter Electronics and is not included. ESP32 is a product of Espressif Systems;
    NeoPixel is a name used by Adafruit. This project is not made or endorsed by them.

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