Show page

Differences

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

--- pm:prj2022:imacovei:andreea.nistor2208 [2022/05/22 23:30]
andreea.nistor2208 [Software Design]
+++ pm:prj2022:imacovei:andreea.nistor2208 [2022/05/25 21:18] (current)
andreea.nistor2208 [Rezultate Obţinute]
@@ Line 47: / Line 47: @@
 ===== Software Design =====
-<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>
 Mediul de dezvoltare folosit este Arduino IDE, schema bloc a fost realizata in Lucidchart, iar schema electrica in EAGLE. De asemenea am folosit librăriile LiquidCrystal.h pentru LCD si EEPROM.h pentru memoria EEPROM.
@@ Line 97: / Line 89: @@
 == Funcții ==
+  * void BtnInterrupt() -> funcția de întrerupere a butonului BUTTON_GameState
+  * bool debounce_activate_edge(unsigned long* debounceStart), void debounce_deactivate(unsigned long* debounceStart) -> funcții care stabilesc și verifică dacă valoarea logică a unui buton este cea corespunzatoare (atât după apăsarea lui, cât și dacă apar efecte mecanice/zgomot).
+  * void graphic_flush(), void graphic_generate_characters(), void graphic_clear(), void graphic_add_item(uint8_t x, uint8_t y, enum DisplayItem item) -> funcții care generează RAM-ul jocului și prin care jocul, chiar dacă e pe un lcd 16x2, este jucat pe 4 linii. De asemenea, sunt definite și generate modelele snake-ului si ale marului
+  * void setLedColorHSV(int h, double s, double v)
+  * void setLedColor(int redValue, int greenValue, int blueValue) -> funcțile date la laborator pentru a seta culoarea rgb-ului mai usor.
+  * void game_new_apple_pos() -> generează o poziție random pentru măr. De asemenea, se asigură că un măr nu se generează pe poziția snake-ului
+  * void game_calculate_logic() -> calculează mișcarea și direcția snake-ului, verifică dacă s-a produs o coloziune (perete/ self) și mărește rata de refresh a jocului dacă snake-ul a mâncat un măr (pana la un maxim al scorului de 20)
+  * void game_calculate_display() -> schimbă Game State-ul curent al jocului dacă s-a intâmplat un eveniment (de exemplu: jucatorul a pierdut sau a câștigat)
+  * void Game_INIT() -> starea inițială a jocului (cea inițializată în setup)
+  * void Game_LOSE() -> starea atunci când jucătorul pierde
+  * void Game_MAIN() -> starea în care este prezentat ecranul de început
+  * void Game_WIN()  -> starea atunci când jucătorul câștigă
+  * void Game_PLAY() -> stare care generează snake-ul și mărul la început
+  * void Game_CHECKHIGHSCORES() -> verifică dacă jucătorul curent a obținut un scor mai mare decât cei salvați în memoria EEPROM
+  * void Game_HIGHSCORES() -> afișează cei mai buni 4 jucatori cu cele mai mari score-uri și schimbă în memorie top-ul în cazul în care alt jucător a obținut un highscore mai bun
+  * void Test_SnakeLength() -> funcție care pune un 0 în fața scorului în caz ca acesta este mai mic decat 9 (pur estetic)
+  * void rgb_color() -> setează culoarea Led-ului RGB in funcție de cât de mare e scor-ul (verde -> albastru -> turcoaz -> roz -> portocaliu)
+  * void writeStringToEEPROM(int addrOffset, const String &strToWrite) -> permite scrierea în memoriea EEPROM
+  * String readStringFromEEPROM(int addrOffset) -> permite citirea din memoria EEPROM
 ** setup() **
+  void setup(){
+    pinMode(redPin,OUTPUT);
+    pinMode(greenPin,OUTPUT);
+    pinMode(bluePin,OUTPUT);
+    pinMode(BUTTON_GameState, INPUT_PULLUP);
+    pinMode(BUTTON_UP, INPUT_PULLUP);
+    pinMode(BUTTON_RIGHT, INPUT_PULLUP);
+    pinMode(BUTTON_LEFT, INPUT_PULLUP);
+    pinMode(BUTTON_DOWN, INPUT_PULLUP);
+    attachInterrupt(digitalPinToInterrupt(BUTTON_GameState), BtnInterrupt, FALLING);
+    graphic_generate_characters();
+    Game_MAIN();
+    gameState = GAME_MENU;
+  }
+Definesc:
+  * pinii pentru Led-ul RGB ca OUTPUT (low-impedance state) astfel permințând să treacă curent prin ei.
+  * pinii pentru butoane ca INPUT_PULLUP folosiți să seteze o valoare fixă pentru un pin, în cazul nostru, dacă butonul este apăsat, acesta o să fie activ pe 0.
+  * o întrerupe pentru butonul BUTTON_GameState aflat pe pinul 3. Atunci când este apasat, generează în avans caracterele jocului și se apelează funcția pentru interfața inițiala a jocului.
 ** loop() **
+  if(Interrupt){ // verifică dacă a apărut o întrerupere
+         delay(5*DEBOUNCE_DURATION); // un delay cu rol de debounce
+         switch(gameState){...} // schimbă starea curentă a jocului prematur la apăsarea butonului GameState
+	 Interrupt = false;} // resteaza valoarea setată in întrerupere până la următoarea întrerupere
+  if(digitalRead(BUTTON_UP) == pressed){ // verifică dacă butonul respectiv a fost apelat
+      if(debounce_activate_edge(&debCountBUTTON_UP)){ -// verifică debounce-ul
+        snakeDirection=SNAKE_UP; // schimbă direcția snake-ului
+      }
+  }else{
+      debounce_deactivate(&debCountBUTTON_UP); // în cazul în care butonul nu a fost apăsat, resetează timer-ul de debounce
+  }
+Același tipar de verificare este apelat pentru restul butoanelor care definesc mișcarea snake-ului.
+  if(millis()-lastGameUpdateTick > gameUpdateInterval){
+    game_calculate_logic();
+    game_calculate_display();
+    graphic_clear();
+    rgb_color();
+    lastGameUpdateTick = millis();
+  } // verifica constant dacă jocul trebuie să-ți dea refresh să recalculeze starea jocului, culoarea led-ului, dimensiunea, pozitia snake-ului și a mărului
 ===== Rezultate Obţinute =====
@@ Line 106: / Line 166: @@
 {{:pm:prj2022:imacovei:snake_lost.jpg?800|}}
-{{:pm:prj2022:imacovei:snake_name_highscore.jpg?800|}}
-{{:pm:prj2022:imacovei:snake_highscore.jpg?800|}}
 Demo youtube: https://www.youtube.com/watch?v=DwJfF1_lE9Y
@@ Line 119: / Line 175: @@
 ===== Download =====
-{{:pm:prj2022:imacovei:snake_nistorandreeaiuliana.zip|}}
+{{:pm:prj2022:imacovei:proiect_pm.zip|}}
 ===== Jurnal =====
-<note tip>
   * 13.04.2022 : Alegere proiect
   * 20.04.2022 : Realizare pagină
@@ Line 129: / Line 187: @@
   * 20.05.2022 : Realizare schemă electrică EAGLE
   * 23.05.2022 : Finalizare pagină wiki
-</note>
 ===== Bibliografie/Resurse =====
-<note>
+[[https://ocw.cs.pub.ro/courses/pm/lab/lab3-2022]]
-Listă cu documente, datasheet-uri, resurse Internet folosite, eventual grupate pe **Resurse Software** şi **Resurse Hardware**.
-</note>
 [[https://www.arduino.cc/en/Tutorial/BuiltInExamples/Debounce]]