Show page

Differences

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

--- pm:prj2025:eradu:stefan.ungureanu03 [2025/05/05 17:17]
stefan.ungureanu03 added diagram for hardware connection
+++ 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 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_2_.png?700 |}}
+{{ :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 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 =====
-Hardware components:
+====Hardware components====
-   * **ESP32 DevKit**
+   * **ESP32 Devkit with ESP-WROOM-32 XX5R69**
-   * **Servo motor MG90S**
+   * **Servo motor SG90**
-   * **Active buzzer 5V**
+   * **Active buzzer 3V**
    * **OLED 0.96" I2C Display**
-   * **USB cable**
+   * **USB cable (for developing)**
-   * **Breadboard**
+   * **Breadboards**
    * **Dupont cables**
+   * **Accumulator 3,7V - 5000 mAh**
+   * **Cardboard**
+   * **Sticks/something to fuse the servo with the lid**
+   * **Glue tape**
-===== Hardware Design =====
+{{ :pm:prj2025:eradu:stefan.ungureanu03:schema_v5.png?700 |}}
-<note tip>
-Aici puneţi tot ce ţine de hardware design:
+====Bill of materials====
-  * listă de piese
-  * scheme electrice (se pot lua şi de pe Internet şi din datasheet-uri, e.g. http://www.captain.at/electronic-atmega16-mmc-schematic.png)
+^ Nr.     	 ^ Component       ^ Link	        ^ Datasheet	        ^
-  * diagrame de semnal
+| 1    | 18650 Accumulator 3.7V 5000mAh     | https://www.emag.ro/acumulator-li-ion-3-7v-5000-mah-tip-18650-cu-fire-acum-fire/pd/DW190DMBM/        |
-  * rezultatele simulării
+| 2    | ESP32 Devkit with ESP-WROOM-32 (XX5R69) | https://www.emag.ro/placa-esp32-cu-esp-wroom-32-30-pini-usb-tip-c-3874784221589/pd/D0JH59YBM/ | https://lastminuteengineers.com/esp32-pinout-reference/ |
-</note>
+| 3    | Servomotor SG90      | https://www.optimusdigital.ro/ro/motoare-servomotoare/26-micro-servomotor-sg90.html        | https://www.friendlywire.com/projects/ne555-servo-safe/SG90-datasheet.pdf |
+| 4    | Display OLED 0.96” I2C     | https://www.emag.ro/ecran-oled-0-96-ai409-s322-323-324/pd/D69S02MBM/       | https://www.mouser.com/datasheet/2/1398/Soldered_333099-3395096.pdf |
+| 5    | Active buzzer 3V | https://www.optimusdigital.ro/ro/audio-buzzere/635-buzzer-activ-de-3-v.html |
+| 6    | 400 pins breadboards     | https://www.optimusdigital.ro/ro/prototipare-breadboard-uri/44-breadboard-400-points.html        |
+| 7    | Dupont cables 10-20cm    | "Borrowed" from friends ;)        |
+| 8    | Charger for 18650 batteries| https://www.emag.ro/incarcator-pentru-2-acumulatori-18650-li-ion-conectare-la-priza-220v-negru-32010609/pd/DHH2MWMBM/ |
+| 9    | USB-C cable     | https://www.optimusdigital.ro/ro/cabluri-cabluri-usb/2652-cablu-usb-31-tip-c-catre-usb-20-am.html        |
+====Hardware functionalities====
+   * **Microcontroller: WiFi, PWM, I2C, serial communication, low power (about 100 mA) and cheap, with breadboard ready pins.**
+   * **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 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.**
+{{ :pm:prj2025:eradu:stefan.ungureanu03:fizic2.png?700 |}}
+Accumulator, Servo, Display, Buzzer and Microcontroller.
 ===== Software Design =====
+==== Status ====
+The current implementation includes all the functionalities:
+    *Wi-Fi connection setup (using ssid + password, requires upload to change them)
+    *Hosting a web server on port 80
+    *Control of a servo motor to lift up and down the lid of the box
+    *Displaying IP and lock status on a display
+    *Buzzing whenever the state of the box changes
+    *Web interaction with the ESP32
+==== Libraries ====
+Libraries used are:
+    *WiFi.h – Library for WIFI connection
+    *Wire.h – Library used for I2C communaction for display
+    *Adafruit_GFX.h – Library for drawing functions used by the display
+    *Adafruit_SSD1306.h – OLED driver library for SSD1306-based displays
+    *ESP32Servo.h – Library used by the servo to make use of PWM
+==== What sets the project apart ====
+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
+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>
-<note tip>
-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 =====
+===== Resources =====
+== Software ==
+https://www.upesy.com/blogs/tutorials/esp32-servo-motor-with-arduino-code-sg90 - servo calibration
-<note tip>
+https://randomnerdtutorials.com/esp32-servo-motor-web-server-arduino-ide/ - another servo code I studied
-Care au fost rezultatele obţinute în urma realizării proiectului vostru.
-</note>
-===== Concluzii =====
+https://randomnerdtutorials.com/esp32-ssd1306-oled-display-arduino-ide/ - display calibration + usage
-===== Download =====
+https://randomnerdtutorials.com/esp32-web-server-arduino-ide/ - client response handling
-<note warning>
+https://github.com/stefungureanu/ESP32-remote-box - repository for the code
-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ă ;-).
-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**.
+https://www.silabs.com/developer-tools/usb-to-uart-bridge-vcp-drivers - needed to connect to the ESP32 with a USB
-</note>
-===== Jurnal =====
+https://www.electronicwings.com/esp32/esp32-timer-interrupts - timer interrupt guide, used for the client timeout
-<note tip>
+== Hardware ==
-Puteți avea și o secțiune de jurnal în care să poată urmări asistentul de proiect progresul proiectului.
+https://lastminuteengineers.com/esp32-pinout-reference/ -- shows exactly which pin supports what
-</note>
-===== Bibliografie/Resurse =====
+https://www.youtube.com/watch?v=2YbPyw5PS9A -- useful video to show how ESP32 can be mounted on 2 breadboards
-<note>
+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
-Listă cu documente, datasheet-uri, resurse Internet folosite, eventual grupate pe **Resurse Software** şi **Resurse Hardware**.
-</note>
 <html><a class="media mediafile mf_pdf" href="?do=export_pdf">Export to PDF</a></html>