Show page

Differences

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

--- pm:prj2026:vlad.radulescu2901:daria.campeanu [2026/05/06 00:11]
daria.campeanu created
+++ pm:prj2026:vlad.radulescu2901:daria.campeanu [2026/05/25 10:50] (current)
daria.campeanu
@@ Line 1: / Line 1: @@
 ====== Alcohol-Lock ======
-===== 1. Introducere =====
+===== Introducere =====
-Acest proiect propune realizarea unui sistem de siguranță auto care condiționează pornirea motorului de rezultatul unui etilotest digital. Obiectivul principal este creșterea siguranței rutiere prin blocarea accesului la volan persoanelor care au consumat alcool. Sistemul măsoară nivelul de alcool din aerul expirat și acționează un mecanism de blocare simulat, oferind în același timp informații despre timpul necesar pentru revenirea la o stare de sobrietate.
+Proiectul **Alcohol-Lock** este un sistem de siguranță activă destinat vehiculelor, conceput pentru a condiționa pornirea motorului de starea de sobrietate a șoferului. Dispozitivul măsoară concentrația de alcool din aerul expirat, procesează datele în timp real și acționează un mecanism de blocare simulat, asigurând în același timp stocarea istoricului de testări pe un suport extern.
-===== 2. Descriere Generală =====
+Sistemul vizează eliminarea erorii umane în autoevaluarea capacității de condus, oferind o barieră tehnică obiectivă împotriva condusului sub influența alcoolului.
-Dispozitivul este construit în jurul microcontrolerului **ATmega324P** și îndeplinește următoarele funcții:
-  * **Măsurare**: Utilizează un senzor analogic **MQ-3** pentru a detecta concentrația de alcool prin modulul **ADC**.
-  * **Decizie și Execuție**: Un **servomotor** (controlat prin **PWM**) simulează contactul mașinii: rămâne blocat dacă alcoolemia este peste limită și se rotește la 90 de grade dacă testul este negativ.
-  * **Interfațare**: Rezultatele și timpul estimat până la sobrietate sunt afișate pe un **LCD 16x2** cu adaptor **I2C**.
-  * **Alerte**: Sistemul include un **buzzer** pentru alerte acustice și **LED-uri** pentru semnalizare vizuală (roșu/verde).
-  * **Monitorizare PC**: Valorile brute sunt transmise în timp real prin **UART** către un terminal serial pentru calibrare.
-===== 3. Componente Utilizate =====
+===== Descriere generală =====
-^ Componentă ^ Rol ^ Protocol / Pin ^
+Dispozitivul integrează module de achiziție date, control și stocare pentru a îndeplini următoarele funcții:
-| ATmega324P | Microcontroler principal | - |
+  * **Monitorizare**: Detectarea precisă a vaporilor de alcool folosind un senzor electrochimic.
-| Senzor MQ-3 | Analiza vaporilor de alcool | ADC (PA0) |
+  * **Control Interlock**: Blocarea sau deblocarea contactului auto (simulată prin servomotor) în funcție de pragul legal setat.
-| LCD 16x2 I2C | Afișare BAC și timp de așteptare | I2C (SDA/SCL) |
+  * **Avertizare**: Semnalizarea vizuală și acustică a stării sistemului și a tentativelor de pornire neautorizate.
-| Servomotor SG90 | Simulare interlock (contact motor) | PWM (Timer 1) |
+  * **Data Logging**: Înregistrarea fiecărei măsurători pe un card microSD pentru trasabilitatea utilizării vehiculului.
-| Buzzer & LED-uri | Alerte acustice și vizuale | GPIO / PWM |
-| Adaptor Serial-USB | Transmitere date către PC | UART |
-===== 4. Schema Bloc =====
+==== Schemă Bloc ====
-{{:pm:prj2026:vlad.radulescu2901:safedrive_block_diagram.png?600 |Schema Bloc SafeDrive}}
+{{:pm:prj2026:vlad.radulescu2901:alcohol_lock.png?800|Schema Bloc Alcohol-Lock}}
-  * **Input**: Senzor MQ-3 (PA0), Buton declanșare test (PD2 - Întrerupere externă).
+===== Hardware Design =====
-  * **Procesare**: ATmega324P (folosind modulele ADC, PWM, I2C, UART).
-  * **Output**: LCD (SDA/SCL), Servomotor (OC1A), Buzzer, LED-uri.
-===== 5. Schema Electrică =====
+==== Componente hardware ====
-{{:pm:prj2026:vlad.radulescu2901:schema_electrica_safedrive.png?600 |Schema Electrică SafeDrive}}
+^ Componentă ^ Cantitate ^ Scop ^
+| Microcontroler **ATmega328P** | 1 | Unitatea centrală de procesare și control |
+| Senzor Alcool **MQ-3** | 1 | Achiziția semnalului analogic pentru concentrația de alcool |
+| **Modul cititor Card SD** | 1 | Interfață pentru salvarea datelor pe suport extern |
+| **Servomotor SG90** | 1 | Simulare mecanică pentru blocarea contactului (PWM) |
+| **LCD 16x2 cu adaptor I2C** | 1 | Afișarea concentrației și a mesajelor de stare |
+| **Buzzer Pasiv** | 1 | Semnalizare acustică a pragurilor critice |
+| **LED-uri** (Roșu/Verde) | 2 | Indicarea vizuală a permisiunii de pornire |
+| **Buton Push** | 1 | Declanșarea manuală a procesului de testare |
+| **Breadboard Full-size** | 1 | Suport pentru realizarea montajului experimental |
-Conexiuni principale:
+==== Pinii folosiți ====
-  * **Senzor MQ-3**: VCC la 5V, GND la GND, AO la pinul **PA0**.
+^ Componentă ^ Pin ATmega328P ^ Tip semnal ^ Justificare ^
-  * **LCD I2C**: VCC, GND, SDA la **PC1**, SCL la **PC0**.
+| Senzor MQ-3 | PC0 (A0) | Intrare analogică | PC0 este conectat la ADC0; semnalul MQ-3 este o tensiune continuă 0–5V proporțională cu concentrația de alcool |
-  * **Servomotor**: VCC, GND, Semnal la pinul **PD5** (OC1A).
+| Buton START | PD2 | Intrare digitală (INT0) | PD2 este legat la întreruperea externă INT0, permițând detecția apăsării fără polling continuu |
-  * **Buzzer**: Conectat la un pin digital (ex. **PB0**).
+| LED Verde | PD6 | Ieșire digitală | Pin digital setat ca ieșire; controlează starea LED-ului verde |
-  * **Buton**: Conectat la pinul **PD2** (folosind rezistență de pull-up internă).
+| LED Roșu | PD7 | Ieșire digitală | Pin digital setat ca ieșire; controlează starea LED-ului roșu |
+| Buzzer Pasiv | PB0 | Ieșire digitală | Pin digital configurat ca ieșire pentru activarea/dezactivarea directă a buzzerului |
+| Servomotor SG90 | PB1 (OC1A) | PWM (Timer1, 16 biți) | Servomotorul necesită PWM la 50 Hz; PB1 este conectat la canalul OC1A al Timerului 1 pe 16 biți |
+| LCD SDA | PC4 (SDA) | I2C date | Pin hardware pentru linia de date SDA a interfeței TWI interne |
+| LCD SCL | PC5 (SCL) | I2C ceas | Pin hardware pentru linia de ceas SCL a interfeței TWI interne |
+| SD Card CS | PB2 | Ieșire digitală (SPI CS) | Chip Select pentru perifericul SPI, controlat software |
+| SD Card MOSI | PB3 (MOSI) | SPI date ieșire | Master Out Slave In - Linia hardware de transmisie SPI |
+| SD Card MISO | PB4 (MISO) | SPI date intrare | Master In Slave Out - Linia hardware de recepție SPI |
+| SD Card SCK | PB5 (SCK) | SPI ceas | Serial Clock - Ceasul hardware generat de master pentru magistrala SPI |
-===== 6. Jurnal de Progres =====
+==== Schema electrică ====
-  * **Etapa 1**: Definirea conceptului și alegerea componentelor.
+{{ :pm:prj2026:vlad.radulescu2901:schema-electrica-alcohol-lock.jpeg?800 |Schema electrică Alcohol-Lock}}
-  * **Etapa 2**: Achiziționarea senzorului MQ-3, a servomotorului și a ecranului I2C.
+{{ :pm:prj2026:vlad.radulescu2901:project-alcohol-lock.jpeg?300 |}}
-  * **Etapa 3**: Implementarea codului pentru citirea ADC și controlul PWM pentru servo.
+<html><a class="media mediafile mf_pdf" href="?do=export_pdf">Export to PDF</a></html>
+===== Software Design =====
+==== Stadiul actual al implementării software ====
+Proiectul software este complet funcțional și structurat modular pe straturi de abstractizare hardware:
+  * **adc.c / adc.h**: Inițializare și citire ADC pentru senzorul MQ-3.
+  * **button.c / button.h**: Gestionarea butonului pe pinul PD2 folosind întreruperea externă INT0.
+  * **lcd_i2c.c / lcd_i2c.h**: Driver I2C scris direct pe registre pentru ecranul LCD.
+  * **servo.c / servo.h**: Controlul servomotorului prin generare de semnal PWM la 50Hz folosind Timer1.
+  * **sd_logger.c**: Interfațarea cu sistemul de fișiere Petit FatFs pentru înregistrarea istoricului de măsurători.
+  * **spi.c / spi.h**: Driverul pentru comunicația SPI hardware utilizat de cardul SD.
+  * **uart.c / uart.h**: Configuarea transmisiei seriale și redirectarea fluxului standard stdout.
+==== Motivarea alegerii bibliotecilor folosite ====
+Pentru a eficientiza spațiul redus de memorie al microcontrolerului ATmega328P, s-au scris drivere directe pe registre și s-au adăugat exclusiv componentele software strict necesare:
+  * **Petit FatFs (R0.02)**: S-a ales varianta extrem de simplificată dezvoltată de ChaN pentru sistemul de fișiere FAT. Aceasta nu utilizează alocare dinamică în memoria RAM și scrie direct în blocul de sectoare deja existente ale fișierului LOG.TXT, reducând masiv amprenta de memorie.
+  * **avr/io.h & avr/interrupt.h**: Bibliotecile standard din avr-libc folosite pentru maparea regiștriilor specifici microcontrolerului și manipularea vectorilor de întreruperi.
+  * **util/delay.h**: Utilizată pentru temporizările precise necesare la inițializarea ecranului LCD și a pașilor din mașina de stări.
+==== Elementul de noutate al proiectului ====
+Proiectul realizează un dispozitiv de siguranță autonom bazat pe Edge Processing. Calculele matematice pentru determinarea concentrației clinice (mg/L) din rezistența brută a senzorului sunt executate local, în timp real, direct pe cip. Totodată, componenta de Data Logger securizează utilizarea vehiculului printr-o jurnalizare continuă pe card, formând o barieră tehnică ce previne pornirea neautorizată a motorului.
+==== Justificarea utilizării funcționalităților din laborator ====
+Aplicația integrează organic cunoștințele acumulate de-a lungul celor 7 laboratoare ale disciplinei:
+  * **Laboratorul GPIO**
+    * Configuarea direcției pinilor prin registrele DDR și controlul stărilor logice prin registrele PORT. A fost esențial pentru gestionarea LED-urilor de stare (Roșu/Verde) și activarea/dezactivarea buzzerului.
+  * **Laboratorul UART**
+    * Configurarea baude-rate-ului, activarea transmisiei și maparea fluxului `stdout` către registrul `UDR0`. Acest lucru a permis utilizarea funcției standard `sprintf` pentru formatarea mesajelor, fiind esențial în faza de depanare a algoritmului de calcul.
+  * **Laboratorul Întreruperi**
+    * Configurarea registrului `EICRA` pentru detecția pe front căzător (ISC01) și activarea măștii `INT0` din `EIMSK`. Acest laborator este critic deoarece permite preluarea promptă a acțiunii utilizatorului prin ISR(INT0_vect) fără a încărca procesorul cu bucle de polling.
+  * **Laboratorul Timere. PWM**
+    * Configurarea Timerului 1 hardware în mod Fast PWM sau Phase Correct pe 16 biți, definind perioada totală prin registrul `ICR1 = 40000` și factorul de umplere prin `OCR1A`. Este vital pentru generarea semnalului de comandă la frecvența fixă de 50Hz cerută de servomotorul SG90.
+  * **Laboratorul ADC**
+    * Activarea convertorului prin bitul `ADEN` și setarea unui prescaler la 128 pentru o conversie stabilă la frecvența de 16MHz a ceasului. Permite citirea semnalului analogic brut furnizat de senzorul MQ-3 pe canalul ADC0.
+  * **Laboratorul SPI**
+    * Configurarea pinilor MOSI, SCK și SS ca ieșiri, trecerea modulului SPI în mod Master și setarea divizorului de viteză din registrul `SPCR`. Această funcționalitate este fundamentul pe care rulează driverul de card SD (`sd.c`), permițând transferul rapid de blocuri de date.
+  * **Laboratorul I2C**
+    * Configurarea reguștriilor `TWSR` și `TWBR` pentru stabilirea frecvenței de ceas la 100kHz și gestionarea biților de START/STOP/WRITE prin bitul `TWINT`. Permite scrierea datelor către expandorul PCF8574 atașat ecranului LCD, reducând numărul de pini folosiți.
+==== Scheletul proiectului și validarea ====
+Aplicația funcționează sub forma unei mașini de stări rulate într-o buclă infinită:
+  * **1. Așteptare**: Sistemul stă în repaus și afișează instrucțiunile inițiale pe LCD până când rutina de întrerupere de la buton modifică flag-ul intern.
+  * **2. Citire și Procesare**: Se prelevează valoarea analogică ADC și se transformă prin calcul în alcoolemie exprimată în mg/L.
+  * **3. Salvare**: Datele finale (valoarea ADC brută și cea calculată) sunt înregistrate imediat pe cardul SD în fișierul LOG.TXT.
+  * **4. Decizie Interlock**: Dacă alcoolemia depășește pragul de 0.15 mg/L, servomotorul rămâne blocat, se aprinde LED-ul Roșu și buzzerul sună alert. Dacă șoferul este sub prag, se aprinde LED-ul Verde, iar servomotorul deblochează contactul.
+Validarea s-a făcut prin monitorizarea mesajelor de debug pe interfața UART și prin citirea ulterioară a cardului SD pe un PC pentru a asigura scrierea corectă a datelor text.
+==== Demo Video ====
+Demonstrația practică a funcționării sistemului în ambele cazuri de testare:
+[[https://youtube.com/shorts/0Pz0abMM4Bo?feature=share|Demo Video Alcohol-Lock - YouTube]]
+  * **Cazul Sobru**: Se detectează o concentrație sigură (0.00 mg/L), se aprinde LED-ul Verde și servomotorul deblochează contactul.
+  * **Cazul Alcool detectat**: La apropierea vaporilor de alcool, ecranul afișează valoarea depășită și alerta "Nu poti conduce!", fiind acompaniată de aprinderea LED-ului Roșu și sunetul de avertizare al buzzerului.
+==== Calibrarea senzorului ====
+Senzorul MQ-3 își modifică rezistența internă la contactul cu alcoolul. Calibrarea s-a făcut folosind valoarea determinată experimental în aer curat R0 = 60.0 kΩ și o rezistență de sarcină RL = 10.0 kΩ:
+  * Tensiunea de ieșire se obține din raportul valorii brute ADC raportat la 1024 pași.
+  * Se determină rezistența curentă a senzorului Rs pe baza divizorului de tensiune.
+  * Concentrația finală în mg/L se calculează pe baza raportului dintre Rs și R0 folosind coeficienții curbei logaritmice din fișa tehnică.
+  * Valorile reziduale mici, sub 1.00 mg/L, sunt interpretate ca fiind 0.0 mg/L pentru a elimina zgomotul de fond.
+==== Optimizări software realizate ====
+  * **Oprirea PWM-ului la repaus**: În `servo.c`, funcția `servo_lock` decuplează semnalul PWM din registre și pune pinul PB1 direct pe starea LOW. Acest lucru elimină vibrațiile parazite ale servomotorului și scade consumul de curent când nu se face mișcare.
+  * **Eliminarea operanzilor float din sprintf**: Pentru a salva spațiu prețios în memoria Flash, valoarea float a fost extrasă prin conversie directă în două variabile întregi separate (partea întreagă și partea zecimală), salvând peste 15% din spațiul de stocare al programului.
+  * **Forțarea salvării pe card (Flush)**: Imediat după scrierea textului, se apelează funcția de încheiere cu parametri nuli din Petit FatFs. Acest lucru golește bufferul RAM direct în memoria nevolatilă a cardului, securizând logurile în cazul unei deconectări bruște a bateriei vehiculului.
+==== Cod Relevant ====
+Mai jos este prezentată funcția principală care orchestrează algoritmul de prelevare, calculul alcoolemiei, scrierea pe cardul SD și decizia de blocare a contactului:
+<code c>
+float calculeaza_alcoolemie(uint16_t adc_raw) {
+    if (adc_raw == 0) adc_raw = 1;
+    float v_out = ((float)adc_raw / 1024.0) * 5.0;
+    float rs = RL_VALUE * (5.0 - v_out) / v_out;
+    float ratio = rs / R0_CLEAN_AIR;
+    float mgL = 0.4 * pow(ratio, -1.431);
+    if (mgL < 1.00) { mgL = 0.0; }
+    return mgL;
+}
+</code>
+Rutina de tratare a întreruperii externe asociată butonului START:
+<code c>
+ISR(INT0_vect) {
+    button_flag = 1;
+}
+</code>
+==== Repozitor GitHub ====
+Întregul cod sursă al proiectului, driverele dezvoltate și fișierele de configurare PlatformIO pot fi consultate la următorul link:
+  * [[https://github.com/dariacampeanu/Alcohol-Lock]]
+===== Bibliografie =====
+  * **ChaN**, *Petit FatFs Module User Application Interface*, disponibil online la: [[http://elm-chan.org/fsw/ff/00pff.html]].
+  * **Microchip Technology**, *ATmega328P 8-bit AVR Microcontroller with 32K Bytes In-System Programmable Flash - Datasheet*, [[https://www.microchip.com]].
+  * **Hanwei Electronics Co., Ltd**, *MQ-3 Gas Sensor for Alcohol Detection - Technical Data*, Product Datasheet.
+  * **Librăria avr-libc**, *AVR Libc Reference Manual*, disponibil online la: [[https://www.nongnu.org/avr-libc/]].