Show page

Differences

This shows you the differences between two versions of the page.

--- pm:prj2025:eradu:stefan.ungureanu03 [2025/05/15 18:50]
stefan.ungureanu03 Added picture of the circuit.
+++ pm:prj2025:eradu:stefan.ungureanu03 [2025/05/29 19:03] (current)
stefan.ungureanu03 Added final demo video.
@@ Line 3: / Line 3: @@
 This project revolves around a box that can be opened remotely over a Wi-Fi connection.
-The box hosts a server locally and waits for a message to transition from the CLOSED to the OPEN state, or OPEN to CLOSED if it has transitioned previously.
+The box hosts a server locally and waits for the client to press a button on the webpage in order to transition from the CLOSED to the OPEN state, or OPEN to CLOSED if it has transitioned previously.
-This message will be sent over Wi-Fi, from a computer through a local webpage.
+Everything will be hosted on the same network, a mobile hotspot for the sake of the project.
 ===== General description =====
 {{ :pm:prj2025:eradu:stefan.ungureanu03:untitled_diagram.drawio.png?700 |}}
-Initially, the box is in the CLOSED state, where the motor isn't being acted upon, it's display has the "LOCKED" text, IP address and the box is considered closed.
+Initially, the box is in the OPEN state, where the servo is at a 90 degree angle, the display has the "OPENED" text, IP address and the box is considered opened(lid up).
-After it receives the specific Wi-Fi message, the box plays a sound, the motor activates to lift up the cover of the box and the displayed message changes to "UNLOCKED". A second message will revert to the initial state.
+After the user presses the button on the page, the box plays a sound, the motor activates to push down the cover of the box and the displayed message changes to "CLOSED". A toggle will revert to the initial state.
 ===== Hardware Design =====
@@ Line 23: / Line 23: @@
    * **Dupont cables**
    * **Accumulator 3,7V - 5000 mAh**
+   * **Cardboard**
+   * **Sticks/something to fuse the servo with the lid**
+   * **Glue tape**
 {{ :pm:prj2025:eradu:stefan.ungureanu03:schema_v5.png?700 |}}
@@ Line 44: / Line 47: @@
    * **Servomotor: Used with PWM at pin GPIO23 to lift the lid. Uses at most 500 mA but only when acted upon.**
    * **Display: Shows the IP of the server and also the state of the box. SDA is connected to GPIO21 and SCL TO GPIO22. Low power, uses less than 50 mA.**
-   * **Active buzzer: Makes sound when the box is transitioning to the open state, connected to GPIO14 (any pin that can be set from low to high would do). Uses around 50mA.**
+   * **Active buzzer: Makes sound when the box is transitioning to the open state and back, connected to GPIO14 (any pin that can be set from low to high would do). Uses around 50mA.**
    * **Battery: Supplies the whole circuit. Has enough power so that the servo can function multiple times. It's also very efficient in the idle state, as only the display and microcontroller are active most of the time.**
@@ Line 52: / Line 55: @@
 ===== Software Design =====
+==== Status ====
+The current implementation includes all the functionalities:
+    *Wi-Fi connection setup (using ssid + password, requires upload to change them)
-<note tip>
+    *Hosting a web server on port 80
-Descrierea codului aplicaţiei (firmware):
-  * mediu de dezvoltare (if any) (e.g. AVR Studio, CodeVisionAVR)
-  * librării şi surse 3rd-party (e.g. Procyon AVRlib)
-  * algoritmi şi structuri pe care plănuiţi să le implementaţi
-  * (etapa 3) surse şi funcţii implementate
-</note>
-===== Rezultate Obţinute =====
+    *Control of a servo motor to lift up and down the lid of the box
-<note tip>
+    *Displaying IP and lock status on a display
-Care au fost rezultatele obţinute în urma realizării proiectului vostru.
-</note>
-===== Concluzii =====
+    *Buzzing whenever the state of the box changes
-===== Download =====
+    *Web interaction with the ESP32
-<note warning>
+==== Libraries ====
-O arhivă (sau mai multe dacă este cazul) cu fişierele obţinute în urma realizării proiectului: surse, scheme, etc. Un fişier README, un ChangeLog, un script de compilare şi copiere automată pe uC crează întotdeauna o impresie bună ;-).
+Libraries used are:
+    *WiFi.h – Library for WIFI connection
-Fişierele se încarcă pe wiki folosind facilitatea **Add Images or other files**. Namespace-ul în care se încarcă fişierele este de tipul **:pm:prj20??:c?** sau **:pm:prj20??:c?:nume_student** (dacă este cazul). **Exemplu:** Dumitru Alin, 331CC -> **:pm:prj2009:cc:dumitru_alin**.
+    *Wire.h – Library used for I2C communaction for display
-</note>
-===== Jurnal =====
+    *Adafruit_GFX.h – Library for drawing functions used by the display
-<note tip>
+    *Adafruit_SSD1306.h – OLED driver library for SSD1306-based displays
-Puteți avea și o secțiune de jurnal în care să poată urmări asistentul de proiect progresul proiectului.
-</note>
-===== Bibliografie/Resurse =====
+    *ESP32Servo.h – Library used by the servo to make use of PWM
-<note>
+==== What sets the project apart ====
-Listă cu documente, datasheet-uri, resurse Internet folosite, eventual grupate pe **Resurse Software** şi **Resurse Hardware**.
+It is a very straight forward project, making use of multiple libraries and concepts (WiFi communication, HTML design, PWM, I2C, GPIO, UART). For end users, it's very simple to use, as the IP is clearly displayed, and could be even easier to connect to using a DNS. There's no need for them
-</note>
+to do anything other than charge the battery every now and then as long as the network stays the same.
+==== Labs used ====
+    *GPIO - For buzzer
+    *UART - Testing and for making sure board is actually connecting + displaying the correct IP
+    *PWM - To move the servo a number of degrees
+    *I2C - To allow communication with the display
+    *Timers and interrupts - To treat client timeouts
+==== Calibration ====
+The servo was calibrated according to the first link in the software section and does a 90 degree turn. The display was calibrated using the 3rd link. The timeout is 10s, because a mobile hotspot could be a bit slow at times, in a real scenario this should be <1s.
+==== Functions ====
+    *onTimeout() - interrupt function that sets the timeout flag to true
+    *startClientTimer() - function that resets and enables timer
+    *buzz(int duration) - makes a sound for the provided duration
+    *moveServo() - alternates between 0 and 90 degrees depending on the state of the box
+    *updateDisplay() - draws the IP and current state of the box
+    *toggleLock() - function that applies the previous changes
+    *setup() - sets up all components and the server
+    *loop() - handles the client respones
+I implemented one function at a time, first to make a sound, then to move the servo and then to draw on the display. I observed them working normally, whereas for the server I first used the serial to make sure it's connecting to the WiFi and later my laptop to connect to the server.
+==== Optimizations ====
+    *Display Refresh – OLED updates only when lock state changes
+    *Single Button Toggle – one endpoint and function for toggling lock state
+===== Demo =====
+<html><iframe width="560" height="315" src="https://www.youtube.com/embed/hsLbZObhrM0?si=66_ZbxzMmTviumGV" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></html>
+===== Resources =====
+== Software ==
+https://www.upesy.com/blogs/tutorials/esp32-servo-motor-with-arduino-code-sg90 - servo calibration
+https://randomnerdtutorials.com/esp32-servo-motor-web-server-arduino-ide/ - another servo code I studied
+https://randomnerdtutorials.com/esp32-ssd1306-oled-display-arduino-ide/ - display calibration + usage
+https://randomnerdtutorials.com/esp32-web-server-arduino-ide/ - client response handling
+https://github.com/stefungureanu/ESP32-remote-box - repository for the code
+https://www.silabs.com/developer-tools/usb-to-uart-bridge-vcp-drivers - needed to connect to the ESP32 with a USB
+https://www.electronicwings.com/esp32/esp32-timer-interrupts - timer interrupt guide, used for the client timeout
+== Hardware ==
+https://lastminuteengineers.com/esp32-pinout-reference/ -- shows exactly which pin supports what
+https://www.youtube.com/watch?v=2YbPyw5PS9A -- useful video to show how ESP32 can be mounted on 2 breadboards
+https://esp32io.com/tutorials/how-to-power-esp32 -- very important read in case you want to power the board and the components with different sources
 <html><a class="media mediafile mf_pdf" href="?do=export_pdf">Export to PDF</a></html>