Difference between revisions of "F24: Tilt Maze"

From Embedded Systems Learning Academy
Jump to: navigation, search
(Hardware Interface)
(Software Design)
Line 242: Line 242:
  
 
=== Software Design ===
 
=== Software Design ===
Show your software designFor example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high levelDo not show the details of the codeFor example, do not show exact code, but you may show psuedocode and fragments of codeKeep in mind that you are showing DESIGN of your software, not the inner workings of it.   
+
* **LED Matrix**: 
 +
  * 1. Initialized LED matrix connected pins to board IOs.   
 +
  * 2. Designed matrix driver for screen display by rendering maze patterns and player movements.   
 +
 
 +
* **Accelerometer**: 
 +
  * 1. Initialized I2C communication for ADXL345 accelerometer.   
 +
  * 2. Configured accelerometer in measurement mode and set sensitivity to ±2g. 
 +
  * 3. Processed tilt data to calculate real-time player movement commands. 
 +
 
 +
* **Mp3 Player**: 
 +
  * 1. Initialized using UART2.   
 +
  * 2. Set the device to the selected SD card and configured volume level.   
 +
  * 3. Played background music and sound effects based on game state.
  
 
=== Implementation ===
 
=== Implementation ===

Revision as of 23:27, 19 December 2024

Project Title

Tilt Maze

Tilt maze Logo

Abstract

Tilt Maze is a motion-controlled puzzle game that challenges players to navigate a luminous ball through procedurally generated mazes using device tilting mechanics. Players must reach the exit within time constraints while maneuvering around obstacles and collecting power-ups that provide temporary advantages. The game combines physical device control with strategic gameplay elements, offering high replayability through its randomized level design and emphasizing skills in balance, spatial reasoning, and quick decision-making.

Objectives & Introduction

The Tilt Maze Game combines hardware and software to create an interactive puzzle experience. It uses an ADXL345 accelerometer for tilt-based movement control, navigating a character through a maze displayed on a 64x64 LED matrix. FreeRTOS manages concurrent tasks like accelerometer input, display updates, and game logic, ensuring smooth and responsive gameplay. Game states, collision detection, and immersive audio feedback via an MP3 decoder enhance the experience. Semaphores and mutexes ensure thread-safe resource management, while debug outputs provide insights during development. This project demonstrates advanced integration of peripherals and real-time systems in a cohesive gaming application.

Team Members & Responsibilities

  • Shreya Belide
  • Jyoshna Mallineni
  • Pavan Charith

Schedule

Week# Start Date End Date Task Status
1
  • 10/20/2024
  • 10/27/2024
  • 10/20/2024
  • 10/27/2024
  • Completed
  • Completed
2
  • 10/27/2024
  • 11/02/2024
  • Order necessary parts - LED Matrix , Speaker , Accelerometer
  • Completed
3
  • 11/02/2024
  • 11/08/2024
  • Read and familiarize with LED Matrix Datasheet
  • Completed
4
  • 11/02/2024
  • 11/08/2024
  • Develop graphics driver for LED matrix and implement initial game objects
  • Completed
5
  • 11/09/2024
  • 11/09/2024
  • 11/09/2024
  • 11/09/2024
  • 11/10/2024
  • 11/15/2024
  • 11/15/2024
  • 11/15/2024
  • Finalize wiki schedule
  • Order circuit boards components and complete the design for printing
  • circuit board and component assembly
  • Circuit board testing
  • Additional accessories if required and finalization of hardware
  • Completed
  • Completed
  • Completed
  • Completed
  • Completed
6
  • 11/16/2024
  • 11/22/2024
  • Integration of circuit boards and microcontroller
  • Game logic development
  • Testing and debugging the game logic
  • Completed
  • Completed
  • Completed
7
  • 11/23/2024
  • 11/29/2024
  • Integrate game logic code with LED matrix
  • Integrate game sounds with game logic
  • Completed
  • In progress
8
  • 11/30/2024
  • 12/06/2024
  • Integrate subsystem
  • Finalizing the video game
  • Update the wiki page.
  • In Progess
  • In progess
  • In progess
9
  • 12/07/2024
  • 12/13/2024
  • Address bugs during testing of integrated system
  • Test pause/play functionality
  • In Progess
  • Not started
  • Not started
10
  • 12/14/2024
  • 12/14/2024
  • 12/14/2024
  • 12/14/2024
  • 12/16/2024
  • 12/16/2024
  • 12/16/2024
  • 12/16/2024
  • Final Demo
  • Update Gitlab repo with final code.
  • Update test video.
  • Update the wiki page.
  • Not started
  • Not started
  • Not started
  • Not started


Parts List & Cost

Part # Cost Source
SJ2 Board 1 $50.00 Preet
Sparkfun RGB (64x64) LED Matrix Display 1 $37.90 Amazon
Accerelometer 1 $10.99 JLC PCB
MP3 Decoder 1 $6.99 JLC PCB
5V/4A Power Adapter 1 $8.99 Amazon
12v DC Power Jack Adapter Connector 1 $10.90 Amazon
Packaging 1 $5.00 Target
Jumper Wires 1 $6.99 Amazon
Total Cost $137.76

Design & Implementation

The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

Hardware Design

Discuss your hardware design here. Show detailed schematics, and the interface here.

Hardware Interface

Hardware Interface

  • **LED Matrix Display**: 13 GPIO channels on SJ2 microcontroller
  • **Accelerometer (ADXL345)**: I2C communication on SJ2 microcontroller (SCL, SDA)
  • **MP3 Decoder**: SPI communication using MOSI, CS, SCK on SJ2 microcontroller
  • **Speaker**: AUX cord for audio output
  • **Power Supply**: 5V/4A adapter for powering the LED matrix and SJ2 microcontroller

Software Design

  • **LED Matrix**:
 * 1. Initialized LED matrix connected pins to board IOs.  
 * 2. Designed matrix driver for screen display by rendering maze patterns and player movements.  
  • **Accelerometer**:
 * 1. Initialized I2C communication for ADXL345 accelerometer.  
 * 2. Configured accelerometer in measurement mode and set sensitivity to ±2g.  
 * 3. Processed tilt data to calculate real-time player movement commands.  
  • **Mp3 Player**:
 * 1. Initialized using UART2.  
 * 2. Set the device to the selected SD card and configured volume level.  
 * 3. Played background music and sound effects based on game state.

Implementation

This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

Testing & Technical Challenges

Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again? Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

<Bug/issue name>

Discuss the issue and resolution.

Conclusion

Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

Project Video

Upload a video of your project and post the link here.

Project Source Code

References

Acknowledgement

Any acknowledgement that you may wish to provide can be included here.

References Used

List any references used in project.

Appendix

You can list the references you used.