F22: Bob Burgers

Soccer Pong

Project Title

SOCCER PONG

Abstract

At the time this project was created (fall 2022), the soccer world cup was taking place. Having caught a little of the world cup fever, Soccer Pong looks to combine the gameplay from soccer and the original Pong. Two games from different mediums but with great symmetry. Two players will face each trying to avoid being scored on. A ball will bounce from any surface that is not in the penalty area. Once a player has read the set maximum number of goals, a victor will be crowned. Press the reset button and let’s go again!!! Soccer Pong brings a new flavor to a historic game, taking you into the world of soccer.

Objectives & Introduction

The main objecive of this game was to create a simple pong game and then change it to something more unique. The following were the objectives we had to reach our goal.

Create a Matrix Driver to display all of the visuals of the game.
Implement ADC joysticks controllers Driver to handle the players blocks movement
Implement Reset and Pause buttons using semaphores interrupts to reset the game and pause the ball movement
Incorporate music and special effects by adding a mp3 modules with UART interface.
Design a PCB that will combine all of the peripherals dfevics with the sj2 board and matrix.
Create a task that will refresh the matrix driver buffer with the ball and player movement.
Develop control system with the ability to modify speed and size of blocks
Create task that will handle ball movement, placement, and hit detection.
Incorporate the music and sound effects after specific time based events (hitting block, goal, etc).
Integrate the pause and reset buttons

Team Members & Responsibilities

William Hernandez

Responsibilities

Led Matrix Graphics
Gameplay Logic
Music System Integration
Game Objects and Hit Detection
Debugging and Testing

Tin Nguyen

File:Put picture file here
PCB
Music Development

Matthew Hanna

Responsibilities

Joystick input with ADC reading potentiometer positions for paddle movement
GPIO input for button pressing pause and reset
locking mechanism for game pausing and game reset loop entrance
enclosure fabrication

Schedule

Week#	Start Date	End Date	Task	Status
1	10/11/2022 10/11/2022	10/18/2022 10/18/2022	Read previous projects, gather information and discuss among the group members. Create GitLab repository for project	Completed Completed
2	10/19/2022	10/24/2022	Order necessary parts	Completed
3	10/25/2022	11/01/2022	Read and familiarize with LED Matrix Datasheet Read Datasheet of all other components	Completed
4	11/02/2022	11/08/2022	Develop graphics driver for LED matrix and implement initial game objects Develop schematic and layout of PCB	Completed
5	11/09/2022 11/09/2022 11/09/2022 11/09/2022	11/10/2022 11/15/2022 11/15/2022 11/15/2022	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/2022	11/22/2022	Integration of circuit boards and microcontroller Game logic development Testing and debugging the game logic	Completed Completed Completed
7	11/23/2022	11/29/2022	Integrate game logic code with LED matrix Integrate game sounds with game logic	Completed Completed
8	11/30/2022	12/06/2022	Integrate subsystem Finalizing the video game Update the wiki page. Adding the ending closure for the game Bill of materials	Completed Completed Completed Completed Completed
9	12/07/2020	12/13/2022	Address bugs during testing of integrated system Test pause/play functionality	Completed Completed Completed
10	12/14/2022 12/14/2022 12/14/2022 12/14/2022	12/14/2022 12/15/2022 12/15/2022 12/15/2022	Final Demo Update Gitlab repo with final code. Update test video. Update the wiki page.	Completed Completed Completed Completed

General Parts

Item #	Part	Seller	Quantity	Total Cost
1	64x64 RGB LED Matrix	Sparkfun	1	$85.95
2	SJ-2 Boards	SJSU	1	$50.00
4	PEMENOL Voice Playback Module	Amazon	1	$10.19
5	Joysticks	Amazon	2	$20.00
6	5v Power Supply	Amazon	1	$15.19
7	Enclosed Speaker Set - 3W 4 Ohm	Amazon	1	$12.48
8	Buttons	Amazon	2	$8.95
9	Standoffs	Amazon	1	$24.95
10	PCB	[link Seller]	1	$40.00
11	Aluminum Enclosure	Anchor Electronics	1	$45.12

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.

Pin Configuration

Pin#	LED Matrix Pin	SJ-2 PIN
R1	High Red Led Data	P0_6
G1	High Green Led Data	P0_7
B1	High Blue Led Data	P0_8
R2	Low Red Led Data	P0_26
G2	Low Green Led Data	P0_9
B2	Low Blue Led Data	P1_31
A	Mux row select A	P1_20
B	Mux row select B	P1_23
C	Mux row select C	P1_28
D	Mux row select D	P1_29
E	Mux row select E	P2_4
OE	Output Enable	P2_2
LAT	Data Latch	P2_1
CLK	Clock Signal	P2_0
	MP3 Module
RX	UART Receive	P4_28
TX	UART Transmitter	P4_29
	Buttons
Either Pin	Pause Button	P2_5
Either Pin	Reset Button	P2_6
	Joysticks
X	Player 1	P1_30
X	Player 2	P0_25

Hardware Design

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

Hardware Interface

Circuit Block Diagram

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

Gameplay Flowchart

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.

Led Matrix

  void led_driver__drawBoard(void) {
 int row, col;
 for (row = 0; row < 32; row++) {
   for (col = 0; col < 64; col++) {
     led_driver__colors_RGB1(led_matrix_refresh_array[row][col]);
     led_driver__colors_RGB2(led_matrix_refresh_array[row + 32][col]);
     led_driver__clock_toggle();
   }
   gpio__set(pins.LAT);
   gpio__set(pins.OE);
   led_driver__drawRow(row);
   gpio__reset(pins.LAT);
   gpio__reset(pins.OE);
 }
 led_driver__insync_row();
}

void led_driver__refill_refresh(uint8_t (*update_matrix)[64]) {
 for (int row = 0; row < 64; row++) {
   for (int col = 0; col < 64; col++) {
     led_matrix_refresh_array[row][col] = update_matrix[row][col];
   }
 }
}

static void fill_word(uint8_t y, uint8_t x, uint8_t array_x, uint8_t array_y, uint8_t insert_word[array_y][array_x],
                     color_code color) {
 for (int row = 0; row < array_y; row++) {
   for (int col = 0; col < array_x; col++) {
     if (insert_word[row][col] == 1) {
       led_driver__setPixel(row + y, col + x, color);
     } else {
       led_driver__setPixel(row + y, col + x, insert_word[row][col]);
     }
   }
 }
}

static void led_screen_task(void *p) {
 const uint8_t top_edge = 6;
 const uint8_t bottom_edge = 58;
 while (1) {
   if (start_game < 1) {
     x_ball = 31;
     y_ball = 30;
     state = STAY;
     if ((xTaskGetTickCount() % 20300 < 100) || song_name == intro) {
       song_name = celebration;
       music_player__volume(20);
       music_player__song(intro);
     }
     fill_starting_background();
     if ((xSemaphoreTake(switch0_pressed_signal, 0) == pdTRUE) ||
         (xSemaphoreTake(switch1_pressed_signal, 0) == pdTRUE)) {
       start_game++;
     }
     led_driver__drawBoard_flashing();
   } else {
     fill_main_background();
     if ((bottom_block >= top_edge) && (bottom_block <= (bottom_edge - block_length))) {
       bottom_block -= (int)(top_edge * joystick__get_reading(JOYSTICK__1)) / 4;
     } else if (bottom_block < top_edge) {
       bottom_block = top_edge;
     } else if (bottom_block > (bottom_edge - block_length)) {
       bottom_block = (bottom_edge - block_length);
     }
     if ((top_block >= top_edge) && (top_block <= (bottom_edge - block_length))) {
       top_block += (int)(top_edge * joystick__get_reading(JOYSTICK__2) / 4);
     } else if (top_block < top_edge) {
       top_block = top_edge;
     } else if (top_block > (bottom_edge - block_length)) {
       top_block = (bottom_edge - block_length);
     }
     game_object__block(top_block, 3, block_length, Purple);
     game_object__block(bottom_block, 59, block_length, Yellow);
     vTaskDelay(10);
     led_driver__drawBoard();
   }
 }
}

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>

Bugs

Joystick input had a fixed paddle speed
Pause and Reset buttons service with ISR was difficult to debounce, moving button input detection to a Task would be more practical

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

SOCCER PONG Youtube Link

Project Source Code

SOURCE CODE GITLAB

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.