Difference between revisions of "F21: Skeh-lleybones"

From Embedded Systems Learning Academy
Jump to: navigation, search
(Team Members & Responsibilities)
(Design & Implementation)
Line 260: Line 260:
  
 
=== Implementation ===
 
=== 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.
 +
 +
 +
=== MP3 and Ultrasonic Hardware Design ===
 +
Discuss your hardware design here.  Show detailed schematics, and the interface here.
 +
 +
=== MP3 and Ultrasonic Hardware Interface ===
 +
In this section, you can describe how your hardware communicates, such as which BUSes used.  You can discuss your driver implementation here, such that the '''Software Design''' section is isolated to talk about high level workings rather than inner working of your project.
 +
 +
=== MP3 and Ultrasonic Software Design ===
 +
Show your software design.  For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level.  Do not show the details of the code.  For example, do not show exact code, but you may show psuedocode and fragments of code.  Keep in mind that you are showing DESIGN of your software, not the inner workings of it. 
 +
 +
=== MP3 and Ultrasonic 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.
 
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.
  

Revision as of 08:12, 17 December 2021

Block Breaker

Block Breaker

Block Breaker is a fun game in which you control a paddle and destroy blocks with a moving ball. The player controlled paddle deflects the ball at different angles to target different blocks and destroy them.

Grading Criteria

  • How well is Software & Hardware Design described?
  • How well can this report be used to reproduce this project?
  • Code Quality
  • Overall Report Quality:
    • Software Block Diagrams
    • Hardware Block Diagrams
      Schematic Quality
    • Quality of technical challenges and solutions adopted.

Abstract

As the capstone project for this class, we were instructed to create a video game using a few required elements. As the cornerstone of development in this class, we were required to use the SJ2 development board. Additionally, we were required to use a LED matrix as means of displaying the video game movement. Finally, we were required to facilitate the usage of an external peripheral or sensor that would contribute to the end result in a meaningful way.

Introduction

In order to realize the requirements of this project, we constructed a plan to verbally prototype a few different elements of the project:

  • The idea of the game - we discussed two player snake as a potential idea, but ultimately decided on block breaker.
  • The task logic - it made sense to run a single task that would serve as the "clock" task to operate the game at a stable refresh rate. Another task could serve to update the data structure that held the state of the LED matrix at any given moment in time.
  • The LED matrix driver - because of the nature of the LED matrix's operation, a consistent order of operations is required to update each pixel. More on this will be discussed in later sections.
  • The enclosure - since we had access to a 3D printer, we concluded that a tabletop arcade cabinet would serve to house all necessary components.
  • The music - we decided to use the theme song from the video game Geometry Dash since we used rectangular blocks and doing so pull us in scope of using the theme song.

Objectives & Introduction

In order to accomplish the objective of the game, we split the project into a few sub-topics that could be tackled individually:

  • Main "clock" task for updating the LED matrix.
  • Main gameplay loop task that would update the position of the ball, paddle, and blocks.
  • Design of various game screens via a state machine.
  • Game logic to determine the ball's bounce relative to its current trajectory.
  • Design of PCB to utilize a ground plane and avoid excessive loose wiring.
  • Design of a 3D printed enclosure to display a clean look.
  • MP3 background track during gameplay.
  • Speaker volume adjustment based on user proximity to enclosure.

Team Members & Responsibilities

Prabjyot Obhi

  • Core MP3 module driver development.
  • Task logic for sending music data to MP3 module.

Justin Stokes

  • Core game logic development.
  • Debugging and testing of game logic and LED Matrix functionalities.

Manas Abhyankar

  • Develop LED Matrix driver.
  • Design and print enclosure for project.
  • Design and send PCB for manufacturing.

Schedule

Week# Start Date End Date Task Status
1
  • 11/1/2021
  • 11/5/2021
  • Read previous projects, gather information and discuss among the group members.
  • Create GitLab repository for project
  • Finalize Parts list
  • Completed
  • Completed
  • Completed
2
  • 11/5/2021
  • 11/9/2021
  • All parts ordered
  • Decide final pinout
  • PCB generated and ordered
  • Completed
  • Completed
  • Completed
3
  • 11/9/2021
  • 11/12/2021
  • Simple display driver finished (display pixel at given coordinate)
  • Finalize game design (powerups, scoring system, boss?)
  • Completed
  • Completed
4
  • 11/12/2021
  • 11/17/2021
  • Fully functional display driver
  • Game menu finish
  • Preliminary enclosure design
  • Completed
  • Completed
  • Completed
5
  • 11/17/2021
  • 11/26/2021
  • Basic game implementation finished
  • Verify PCB
  • Enclosure design finalized
  • Completed
  • Completed
  • Completed
6
  • 11/26/2021
  • 12/3/2021
  • Enclosure printed and tested
  • Final game implementation finished
  • Completed
  • Completed
7
  • 12/3/2021
  • 12/10/2021
  • Free week to allow for schedule shifting
  • Bug fixes
  • Completed
8
  • 12/10/2021
  • 12/16/2021
  • Finish wiki report
  • Completed
9
  • 12/16/2021
  • 12/16/2021
  • Demo
  • Completed


Parts List & Cost

Part Link Price Quantity
LED Matrix Sparkfun $80 1
Power Supply Adafruit $30 1
Barreljack connector Adafruit $0.95 1
Joystick Sparkfun $16.95 1
Button Adafruit $2.50 2
Quick connect wires Adafruit $4.95 1
Resistors/Capacitors N/A N/A 3 of each
Ultrasonic Sensor Adafruit $3.95 1
MP3 Module Adafruit $34.95 1
Speakers Adafruit $7.50 1
3D Printed Enclosure To be 3D printed N/A 1
40-pin ribbon cable Adafruit $2.95 2

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

In this section, you can describe how your hardware communicates, such as which BUSes used. You can discuss your driver implementation here, such that the Software Design section is isolated to talk about high level workings rather than inner working of your project.

Software Design

Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

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.


MP3 and Ultrasonic Hardware Design

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

MP3 and Ultrasonic Hardware Interface

In this section, you can describe how your hardware communicates, such as which BUSes used. You can discuss your driver implementation here, such that the Software Design section is isolated to talk about high level workings rather than inner working of your project.

MP3 and Ultrasonic Software Design

Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

MP3 and Ultrasonic 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

Block Breaker project source code

References

Acknowledgement

We'd like to thank Preet for giving us the opportunity to develop and learn through an interactive team project. We would also like to acknowledge the TAs Ellis and Tirth for their feedback throughout the semester.