Show page

Differences

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

--- pm:prj2026:cezar.zlatea:tiberiu_florin.gila [2026/05/16 18:05]
tiberiu_florin.gila
+++ pm:prj2026:cezar.zlatea:tiberiu_florin.gila [2026/05/23 11:38] (current)
tiberiu_florin.gila [Scheletul proiectului și interacțiunea dintre funcționalități]
@@ Line 102: / Line 102: @@
-<note tip>
+==== Scheletul proiectului și interacțiunea dintre funcționalități ====
-Descrierea codului aplicaţiei (firmware):
-  * mediu de dezvoltare (if any) (e.g. AVR Studio, CodeVisionAVR)
+Firmware-ul este organizat în trei straturi funcționale care rulează concurent în bucla principală.
-  * librării şi surse 3rd-party (e.g. Procyon AVRlib)
-  * algoritmi şi structuri pe care plănuiţi să le implementaţi
+Stratul de intrare se execută la fiecare 2 secunde și are rolul de a citi valorile de la senzori și de a actualiza starea sistemului. Pe baza temperaturii citite de DHT22 se calculează culoarea țintă, iar pe baza luminozității citite de BH1750 se calculează intensitatea țintă în modul AUTO. La finalul fiecărei achiziții, display-ul OLED este actualizat cu valorile curente.
-  * (etapa 3) surse şi funcţii implementate
-</note>
+Stratul de control al butonului rulează la fiecare iterație a buclei și verifică dacă ISR-ul a semnalat o apăsare. Dacă da, aplică debouncing-ul de 50ms, apoi comută între modurile AUTO și MANUAL sau avansează treapta de luminozitate. De asemenea, monitorizează timeout-ul de 5 secunde după care sistemul revine automat la modul AUTO.
+Stratul de ieșire rulează la aproximativ 50fps și este responsabil de actualizarea benzii LED. La fiecare frame, culoarea curentă avansează treptat spre culoarea țintă prin blending, iar intensitatea curentă avansează cu un pas spre intensitatea țintă. Valorile rezultate sunt trimise benzii WS2812B.
+Validarea sistemului a fost realizată pe mai multe niveluri. Temperatura și luminozitatea au fost comparate cu valori de referință prin Serial Monitor. Maparea culorii a fost verificată prin printarea valorilor RGB calculate la diverse temperaturi simulate. Butonul a fost testat prin apăsări rapide pentru a confirma că debouncing-ul funcționează corect. Timeout-ul de revenire la AUTO a fost verificat cu cronometru pe telefon, iar tranziția de culoare a fost validată vizual, confirmând absența salturilor la schimbări bruște de temperatură.
+===== Biblioteci folosite =====
+FastLED - aleasă pentru controlul benzii WS2812B datorită funcției nblend() care realizează interpolarea lină între culori fără a fi nevoie de implementarea manuală fiecare canal RGB. De asemenea, fill_solid() și FastLED.setBrightness() simplifică controlul întregii benzi. #define FASTLED_ALLOW_INTERRUPTS 0 dezactivează întreruperile în timpul scrierii pe LED-uri, prevenind coruperea semnalului one-wire al WS2812B care e foarte sensibil la timing
+DHT (Adafruit) - biblioteca standard pentru protocolul one-wire proprietar al senzorului DHT22
+BH1750 - bibliotecă simplă pentru senzorul de luminozitate care comunică pe I2C. lightMeter.readLightLevel() returnează direct valoarea în lux, nefiind necesară conversia manuală din valori ADC
+Adafruit SSD1306 + Adafruit GFX - set standard de biblioteci pentru display-uri OLED. GFX oferă funcții de desenare text și grafice, SSD1306 gestionează comunicația I2C cu display-ul. Alternativa ar fi fost controlarea display-ului prin registre TWI care ar fi adus complexitate codului
+Wire - biblioteca Arduino pentru I2C, utilizată implicit de BH1750 și SSD1306
+avr/interrupt.h - inclusă pentru configurarea întreruperii hardware PCINT2 prin registre directe
+===== Elementul de noutate =====
+Proiectele de tip ambient light existente folosesc în general o singură variabilă de intrare (cel mai des temperatura sau lumina, separat). Noutatea proiectului constă prin combinarea a două variabile de mediu - temperatura și luminozitatea, pentru a le putea controla simultan
+===== Funcționalități din laborator =====
+Lab 0 - GPIO: Butonul este configurat prin registrele DDR și PORT ale ATmega, cu pull-up intern activat
+Lab 2 - Întreruperi: Butonul este gestionat printr-un Pin Change Interrupt, evitând polling-ul în bucla principală. Configurarea registrelor, marcarea volatile a flag-ului partajat între ISR și main, și debouncing-ul fără blocare
+Lab 6 - I2C: BH1750 și SSD1306 comunică pe magistrala I2C.
+===== Logica de proiectare a culorii/intensității =====
+La fiecare 2 secunde, senzorii furnizează o nouă culoare și intensitate țintă. În loc să fie aplicate imediat, valorile curente sunt interpolate spre cele țintă la fiecare frame (~50fps). Interpolarea funcționează proporțional cu diferența rămasă - pasul aplicat la fiecare frame este o fracțiune fixă din distanța dintre valoarea curentă și cea țintă, astfel: tranziția este rapidă la început și încetinește natural pe măsură ce valorile se apropie. Acest comportament este obținut prin nblend() pentru culoare, care operează independent pe fiecare canal RGB, și printr-un increment/decrement de 1 pas per frame pentru intensitate.
+===== Calibrarea elementelor de senzoristică =====
+DHT22: Senzorul a fost comparat cu temperatura camerei. Intervalele TEMP_MIN = 24.0°C și TEMP_MAX = 31.0°C au fost alese pentru a acoperi domeniul de temperatură interior tipic vară/iarnă și pentru a produce variație vizibilă de culoare în condiții normale de utilizare.
+BH1750: Senzorul returnează direct lux calibrați din fabrică, fără a necesita calibrare suplimentară. Pragurile LUX_DARK = 10 lux (lcameră întunecată) și LUX_BRIGHT = 800 lux (lumină puternică de zi) au fost determinate prin testarea acestuia în cameră, similar cu senzorul de temperatură
+===== Optimizări realizate =====
+. Non-blocking timing: Citirea senzorilor folosește millis() - lastRead >= READ_INTERVAL_MS în loc de delay(2000), permițând buclei principale să ruleze continuu la 50fps pentru tranziții line și răspuns rapid la buton, indiferent de intervalul de citire al senzorilor.
+. Separarea target/current: Prin delimitarea valorilor dorite de cele afișate fiecare rulează la frecvența proprie fără a se bloca reciproc.
+. BRIGHTNESS_MAX = 20 în loc de 255: WS2812B la putere maximă pe 12 LED-uri consumă până la ~720mA. Limitând la 20/255, aprox. 8%, consumul scade la ~56mA, astfel fiind compatibil cu alimentarea prin USB fără risc de supraîncărcare și fără a necesita sursă externă dedicată
 ===== Rezultate Obţinute =====
 <note tip>
-Care au fost rezultatele obţinute în urma realizării proiectului vostru.
+Sistemul funcționează conform specificațiilor inițiale. Temperatura și luminozitatea sunt citite corect și reflectate în timp real pe bandă și pe display. Tranziția de culoare este lină și continuă, fără salturi vizibile între citiri, efectul vizual fiind cel al unei lumini care se schimbă organic. Intensitatea se adaptează automat la lumina ambientală, banda fiind discretă în întuneric și mai prezentă în lumină puternică.
+Modul MANUAL funcționează corect - butonul ciclează prin cele 5 trepte de luminozitate, iar sistemul revine automat la modul AUTO după 5 secunde de inactivitate, fără intervenția utilizatorului.
+Display-ul afișează în permanență valorile numerice de temperatură și luminozitate, precum și modul curent.
 </note>
 ===== Concluzii =====
+Prin realizarea acestui proiect am reușit să înțeleg mai bine cum se integrează o serie de periferice simultan. Am realizat că integrarea mai multor componente într-un sistem care trebuie să răspundă constant și natural cere detalii care par mici la prima vedere (cum ar fi modul în care treci de la o culoare la alta), însă pot face diferența dintre un rezultat care își atinge obiectivul și unul care nu.
 ===== Download =====
-<note warning>
+<note>
-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ă ;-).
+Arhivă proiect: {{:pm:prj2026:cezar.zlatea:pm_proiect.zip|}}
-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**.
 </note>
-===== Jurnal =====
+===== Bibliografie/Resurse =====
-<note tip>
+=== Resurse Hardware ===
-Puteți avea și o secțiune de jurnal în care să poată urmări asistentul de proiect progresul proiectului.
-</note>
-===== Bibliografie/Resurse =====
+[[https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf|Datasheet DHT22 AM2302]]
-<note>
+[[https://www.mouser.com/datasheet/2/348/bh1750fvi-e-186247.pdf|Datasheet BH1750FVI]]
-Listă cu documente, datasheet-uri, resurse Internet folosite, eventual grupate pe **Resurse Software** şi **Resurse Hardware**.
-</note>
+[[https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf|Datasheet SSD1306]]
+[[https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf|Datasheet WS2812B]]
+=== Resurse Software ===
+[[https://fastled.io/|Documentație FastLED]]
+[[https://github.com/adafruit/Adafruit_SSD1306|Documentație Adafruit SSD1306]]
+[[https://github.com/adafruit/Adafruit-GFX-Library|Documentație Adafruit GFX]]
+[[https://github.com/claws/BH1750|Documentație BH1750 Arduino]]
+[[https://github.com/adafruit/DHT-sensor-library|Documentație DHT sensor library]]
 <html><a class="media mediafile mf_pdf" href="?do=export_pdf">Export to PDF</a></html>