Difference between revisions of "F20: Bubble Shooter"

Revision as of 04:02, 13 December 2020

Abstract

Bubble shooter is an arcade game that has bubbles or balls present on the screen. The bubbles are of different colors and the goal is to clear them by forming a group of bubbles (3 or more) of the same color. Points are earned upon clearing the bubbles and increases with the number of bubbles cleared in a single shot. The player wins upon clearing the screen and loses when the bubbles touch the bottom of the screen.

Objectives & Introduction

Show a list of your objectives. This section includes the high-level details of your project. You can write about the various sensors or peripherals you used to get your project completed.

Team Members

Technical Responsibilities

Game Logic Development	Hisaam Hashim, Amiraj Nigam, Anirudh Ashrit, Akshat Bhutiani
PCB Design	Anirudh Ashrit
LED Display Driver	Hisaam Hashim
Graphics Driver	Hisaam Hashim, Akshat Bhutiani
Mp3 Decoder Driver	Amiraj Nigam, Anirudh Ashrit
Joystick Integration	Akshat Bhutiani
Hardware Integration	Amiraj Nigam, Hisaam Hashim

Administrative Responsibilities

Team Leader	Hisaam Hashim
Git Repository Managers	Akshat Bhutiani & Anirudh Ashrit
Code Reviewer	Hisaam Hashim
Wiki Report Managers	Amiraj Nigam & Anirudh Ashrit
Bill of Materials Manager	Akshat Bhutiani

Schedule

Week#	Start Date	End Date	Task	Status
1	10/12/2020 10/16/2020	10/18/2020 10/18/2020	Literature Survey of Previous year Projects Submission of Project Proposal	Completed Completed
2	10/18/2020	10/20/2020	Gitlab Repository Created Wiki Schedule page Created	Completed Completed
3	10/20/2020	11/01/2020	Read and familiarize with LED Matrix Datasheet. Finalize the Components and place the order	Completed Completed
4	11/01/2020	11/10/2020	Understand the ball tracing logic Understand the logic for ball queue	Completed Completed
5	11/09/2020 11/09/2020 11/09/2020 11/09/2020	11/10/2020 11/15/2020 11/15/2020 11/15/2020	Finalize wiki schedule LED Matrix Driver Development MP3 Decoder Driver Development Joystick driver development and interfacing Game logic development	Completed Completed Completed Completed In progress
6	11/16/2020	11/22/2020	Designing of levels in the game Testing trigger motions Testing and debugging the game logic PCB Designing	Completed Completed In progress Completed
7	11/23/2020	11/29/2020	Integrate game logic code with LED matrix Integrate game sounds with game logic	In progress Completed
8	11/30/2020	12/06/2020	Integrate subsystem Finalizing the video game Update the wiki page.	In progress In progress In progress
9	12/07/2020	12/13/2020	Address bugs during testing of an integrated system Test pause/play functionality Implementation of Graph algorithm to track down the balls of the same color	In progress In progress In progress
10	12/16/2020 12/14/2020 12/14/2020 12/14/2020	12/16/2020 12/16/2020 12/16/2020 12/16/2020	Final Demo Update Gitlab repo with final code. Update test video. Update the wiki page.	Not started Not started Not started In progress

Bill Of Materials

Item#	Part Description	Part Model & Vendor	Quantity	Cost
1	Microcontroller Boards	SJ2 Boards (Purchased from Preet Kang)	1	$50.00
2	LED Matrix Display	RGB LED Matrix Panel - 32X64	1	$55.00
3	Audio decoder Breakout Board	MP3 PLayer Shield	1	$26.95
4	Analog 2-axis Thumb Joystick	Analog 2-axis Joystick	1	$10.36
5	Power Supply	5V/3A Power Supply	1	$8.99

PCB Design

The board is designed to connect modules in the game directly. Autodesk's Eagle software is used to design the Schematics and Board layout. The board has 2 layers(Top and Bottom). JLCPCB is the manufacturer of the PCB board.

Schematic Design of PCB

PCB Board Layout

Design Overview of the PCB

Hardware Design & Implementation

Analog Joystick

An ADA512 2-axis Analog Joystick and Button is used for controlling the movement of the launcher and shooting the ball. The data from the joystick is read using the ADC pins of the SJTwo board. The button switch is detected using a digital pin on the board.

Breakout board layout

Soldered joystick

X values & Mapping	Y values & Mapping
2297 (center)	2295 (center)

VS1053B MP3 Decoder Interfacing

Interfacing with MP3 Decoder. Image source: https://learn.sparkfun.com/tutorials/mp3-player-shield-hookup-guide-v15

Label	Name	Function	Pin Connection
1	MP3-DREQ	Decoder Data Request	Pin 0.1
2	MP3-CS	VS1053B Chip Select	Pin 0.22
3	MP3-DCS	VS1053B Data CS	Pin 0.0
4	MP3-RST	VS1053 Reset	Pin 0.10
5	MOSI	SPI Bus (Master Output Slave Input)	Pin 0.18
6	MISO	SPI Bus (Master Input Slave Output)	Pin 0.17
7	SCK	SPI Clock	Pin 0.15
8	+5V	+5V	PCB Vout
9	GND	GND	GND

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 the 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 the exact code, but you may show pseudocode and fragments of code. Keep in mind that you are showing the 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 implementations.

Testing & Technical Challenges

Describe the challenges of your project. What advice would you give yourself or someone else if your project can be started from scratch again? Make a smooth transition to the 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 learned 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

Sourceforge Source Code Link

References

Acknowledgement

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

References Used

List any references used in the project.

Appendix

You can list the references you used.

@@ Line 239: / Line 239: @@
 * <span style="color:red">Not started</span>
 * <span style="color:red">Not started</span>
-* <span style="color:yellow">In progress</span>
+* <span style="color:orange">In progress</span>
 |-
 |}
@@ Line 304: / Line 304: @@
 An ADA512 2-axis Analog Joystick and Button is used for controlling the movement of the launcher and shooting the ball. The data from the joystick is read using the ADC pins of the SJTwo board. The button switch is detected using a digital pin on the board.
-[[File:Break out board.jpg|500x250px |thumb|left|Breakout board layout]]
+[[File:Break out board.jpg|500x280px |thumb|left|Breakout board layout]]
-[[File:.Soldered and working.jpg|500x250px |thumb|right|Soldered joystick]]
+[[File:.Soldered and working.jpg|500x280px |thumb|right|Soldered joystick]]
@@ Line 312: / Line 312: @@
+{| class="wikitable"
+|-
+! scope="col"| X values & Mapping
+! scope="col"| Y values & Mapping
+|-
+! scope="row"| 2297 (center)
+! scope="col" | 2295 (center)
+|-
+|}