Proiectul reprezintă implementarea unui joc RPG cu interfață text. Jocul este alcătuit din mai multe evenimente generate aleator. Jucătorul poate interacționa în mai multe feluri cu evenimentele întâmpinate, ducând la rezultate diferite.

Schema bloc: Periferice de intrare:

• Butoane - pentru acțiuni de bază, alegeri, alte funcționalități
• Un joystick - pentru text scrolling (asemănător cu mouse wheel)
• Un potențiometru - pentru lock-picking (un minigame care poate apărea ca un eveniment aleator, necesită rotirea potențiometrului pentru a deschide un lacăt)

Periferice de ieșire:

• Un LED RGB care se modifică Verde→Galben→Roșu→Negru - pentru afișarea sănătății jucătorului (Health)
• Un LED RGB care se modifică Bleu→Albastru→Negru - pentru afișarea manei jucătorului (Mana)
• Un ecran LCD Nokia 5110 84×48 - pentru afișarea textului
• Un Buzzer pasiv - pentru efecte sonore (de exemplu, un efect sonor va alerta jucătorul dacă lacătul se deschide)

Lista de componente:

• 1 Arduino UNO R3
• 2 LED-uri RGB
• 1 LCD Nokia 5110 84×48
• 1 Joystick
• 1 Potențiometru
• 1 Buzzer Pasiv
• Butoane
• Rezistențe
• Fire

IDE folosite: Arduino pentru compilare și trimitere; VSC pentru editare surse

Tutorial LCD + Biblioteca LCD_Functions.h:

https://learn.sparkfun.com/tutorials/graphic-lcd-hookup-guide

Fișiere cu co: Text-Based_RPG.ino - fișierul de bază, afișează logo și pornește update-urile Text-Based_RPG.h - apelează funcții ale claselor UI UIAbstract.h - UI de bază NSText.h - un namespace care conține un UI cu text NSInfo.h - un namespace care conține un UI cu informații despre caracter NSActions.h - un namespace care conține un UI cu meniu cu acțiuni NSLockpicking.h - un namespace care conține un UI cu mini-game-ul de lockpicking ActionManager.h - definește acțiunile și encounter-urile GameUnit.h - clasa unitate, care are health și mana, și funcții pentru modificarea lor GamePlayer.h - clasa jucător, o unitate care mai are gold și lockpicks GameAction.h - clasa unei acțiuni care apare în meniu, având o funcție de afișare și un id corespunzător game_data.h - definește clasa Cost și ține instanța jucătorului definitions.h - are define-uri pentru pini, inputuri, acțiuni și alte constante LCD_Manager.h - funcții pentru modificarea și afișarea unui buffer cu text pe ecran LCD_Functions.h - biblioteca precizată mai sus, la care am adus mici modificări

Legarea plăcii cu ecranul: Jocul terminat:

Lucrând la acest proiect am realizat că trebuie să am foarte mare grijă la memorie. Au apărut foarte multe bug-uri în timpul implementări, cum ar fi pagini care nu apăreau în totalitate sau restartări ale plăcii. Foarte multe s-au datorat umplerii memoriei. Pentru a maximiza funcționalitățile și a minimaliza memoria utilizată am lucrat după următoarele reguli:

1) #define în loc de const

2) bufferii globali sunt reutilizați

3) variabilele sunt definite în blocuri

4) byte (unsigned char) și unsigned short în loc de int

5) variabilele globale și câmpurile din clasele globale folosite rar pot fi înlocuite cu funcții care le recalculează pentru a nu ocupa memorie când nu sunt utilizate (de exemplu am înlocuit UI::usesLeds cu UI::UsesLeds(), care întoarce true sau false în loc să rețină valoarea)

https://ocw.cs.pub.ro/courses/pm/prj2021/dbrigalda/text-based_rpg?do=revisions

LCD: https://learn.sparkfun.com/tutorials/graphic-lcd-hookup-guide

Joystick: https://www.youtube.com/watch?v=B6YEQj4d5WU

Potențiometru: https://www.youtube.com/watch?v=PUte1cmJ44A

Buzzer Pasiv: https://www.youtube.com/watch?v=dHYKRrlPNzM

Documentația în format PDF