F22: Bob Burgers

From Embedded Systems Learning Academy
Revision as of 04:47, 15 December 2022 by 243 user1 (talk | contribs) (Led Matrix)

Jump to: navigation, search
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

Profile picture.PNG

Responsibilities

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


Tin Nguyen

Matthew Hanna

21CF6ADC-3151-40D7-A40F-DE8CC5FF3433 Small.jpeg

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.

      Mp3 module.PNG Joysticks.PNG Enclosure.PNG Led matrix front64x64.PNG Led matrix back.PNG Speakers.PNG Buttons.PNG

      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.