Difference between revisions of "F21: FollowMe"

From Embedded Systems Learning Academy
Jump to: navigation, search
(References Used)
(References Used)
Line 523: Line 523:
 
*  [https://www.sparkfun.com/products/14718 Datasheet and Hookup guide]
 
*  [https://www.sparkfun.com/products/14718 Datasheet and Hookup guide]
 
*  [https://cdn-learn.adafruit.com/downloads/pdf/32x16-32x32-rgb-led-matrix.pdf?timestamp=1543806512/ Wiring and pin information]
 
*  [https://cdn-learn.adafruit.com/downloads/pdf/32x16-32x32-rgb-led-matrix.pdf?timestamp=1543806512/ Wiring and pin information]
*  [https://www.prf.jcu.cz/generator-led-matrix/index.htm]
+
Matrix generator [https://www.prf.jcu.cz/generator-led-matrix/index.htm]
  
 
====== MP3 Decoder ======
 
====== MP3 Decoder ======

Revision as of 03:33, 12 December 2021

Abstract

FollowMe is a video game where you follow the correct directions. The LED matrix will display a series of arrows and the player or players need to correctly wave their hand over their gesture sensor to earn points. However, watch out for the background color of the arrow. If the background is green, then the players need to wave their hand in that direction; i.e, an arrow pointing left with a green background means wave your hand from the right to the left (wave left). If the background is red, then the players need to wave their hand in the opposite direction; i.e, an arrow pointing up with a red background means wave your hand from the top to the bottom (wave down).

There'll be two modes:

1. Timed mode: each player tries to get the most correct waves until the time runs out. The rate at which the arrows change will increase as the timer counts down.

2. Endurance mode: each player tries to stay alive the longest. One wrong wave then you're eliminated, the last player standing wins.

At the end, the LED matrix will display the leaderboard for the players and how many waves/instructions they got correct.



  • Block Diagram of Follow Me needs to be added

Objectives & Introduction

Project Introduction

1.Analyse hand waving/movement using a gesture sensor

2.Connect different microcontrollers wirelessly to exchange information

3.Read a file from SD card on the microcontroller and get the MP3 data using MP3 decoder

4.Display different screens according to the game level(Title screen, Arrows and leaderboards)


Project Objectives

1. Gestor Control: APDS-9960 gesture sensor on SJ2 board should respond to hand waving. I2C interface will be used for this sensor.

2. ZIGBEE wireless: UART interface used to connect the wireless devices, which will send information to other boards.

3. MP3 decoder: MP3 data will be fetched from mini SD card reader using SPI interface.

4. 64x64 RGB LED matrix: LED will be controlled by GPIO of SJ2 board. The LED will display game graphics.

5. 3D Printed enclosure: The system will be enclosed in a 3D printed enclosure.


Team Objectives

1.Learn and understand the APIs of the Real Time Operating System

2.Use different embedded protocol to interface the system

3.Learn to design a module and interface the modules by reading datasheets

4.Integration and testing to deliver the final product

5.Track and respond to the reported bug and document the bugs and solutions.

Team Members & Technical Responsibilities

  • Jonathan Doctolero
    • Gesture Sensor Driver
    • Gameplay Development
    • Enclosure Design
  • Priyanka Rai
    • RGB Matrix Driver
    • Wireless Driver/Application
  • Ravi Kiran Dendukuri
    • PCB Design
    • MP3 Decoder Design
  • Yashwanth Kumar Nelakuditi
    • PCB Design
    • MP3 Decoder Design

Administrative Responsibilities

Administrative Roles
  • Git Repository Manager
Jonathan Doctolero
  • Wiki Report Manager
Priyanka Rai
  • Finance Manager
Ravi Kiran Dendukuri
  • Bill of Materials Manager
Yashwanth Kumar Nelakuditi

Schedule

Week# Start Date End Date Task Status Deliverable
1
  • 10/12/2021
  • 10/18/2021
  • Read previous projects, gather information, and discuss among the group members.
  • Create GitLab repository for project
  • Completed
  • Completed
2
  • 10/19/2021
  • 10/22/2021
  • Create a Bill of Materials
  • Order necessary parts
  • Completed
  • Completed
  • BOM in "Parts List & Cost" Section
3
  • 10/26/2021
  • 11/20/2021
  • Read and familiarize with LED Matrix Datasheet
  • Read and familiarize with APDS-9960 datasheet
  • Read and familiarize with XBEE Wireless UART device
  • Read and familiarize with MP3 decoder and SD card reader on SJ2
  • Design PCB
  • Completed
  • Completed
  • Completed
  • Completed
  • Completed
  • PCB design in "Printed Circuit Board" Section
4
  • 11/08/2021
  • 11/20/2021
  • Finalize wiki schedule
  • Order circuit boards components and complete the design for printing
  • Additional accessories if required and finalization of hardware
  • Completed
  • In Progress
  • In Progress


5
  • 11/08/2021
  • 11/20/2021
  • Develop graphics driver for LED matrix and implement initial game objects
  • Develop code module for gesture sensor
  • Develop code module for MP3 decoder
  • Design/Plan game logic
  • Completed
  • Completed
  • Completed
  • In Progress
6
  • 11/16/2021
  • 11/27/2021
  • Receive circuit board and start component assembly
  • Circuit board testing
  • Integration of circuit boards and microcontroller
  • Test LED matrix API
  • Game logic development
  • Testing and debugging the game logic
  • Not started
  • Not started
  • Not started
  • In Progress
  • In Progress
  • In Progress
7
  • 11/23/2021
  • 11/29/2021
  • Initial integration of game logic code with LED matrix
  • Initial integration of game sounds with LED matrix
  • Initial integration of gesture sensor with LED matrix
  • Test wireless connections between 1 master and 1 slave
  • Debug minimum features: gesture inputs, game display, music playing, single player
  • Not started
  • Not started
  • Not started
  • Not started
  • Not started
8
  • 11/30/2021
  • 12/06/2021
  • Test full integration of LED matrix, MP3 decoder, gesture sensor, and wireless communication
  • Add multiple players, ensure each device can connect to the network
  • Update the wiki page.
  • Not started
  • Not started
  • Not started
9
  • 12/07/2021
  • 12/13/2021
  • Address bugs during testing of the integrated system
  • Thorough testing of the game
  • Debug multiple players
  • Not started
  • Not started
  • Not started
10
  • 12/15/2021
  • Final Demo
  • Update Gitlab repo with final code.
  • Update test video.
  • Update the wiki page.
  • Not started
  • Not started
  • Not started
  • Not started
11
  • 12/16/2021
  • Turn in Wiki Page Report
  • Not started


Bill of Materials (General Parts)

PART NAME

PART MODEL & SOURCE

QUANTITY

COST PER UNIT (USD)

  • Micro-Controller Eval-Boards
  • LPC 4078 (Purchased from Preet Kang)
  • 3
  • 50.00
  • RGB LED matrix
  • 1
  • 49.95
  • Power supply
  • 1
  • 12.95
  • Zigbee Adapter
  • Give the link
  • 1
  • 5
  • Zigbee Transreceiver
  • Give the link
  • 3
  • Borrowed from Preet
  • PCB Fabrication
  • 5
  • 29.53
  • Miscellaneous parts
  • Anchor Electronics and Digikey
  • 1
  • 50.00


Printed Circuit Board

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.

RGB LED Matrix

A 64 x 64 RGB LED Matrix will be powered up through a 5V/4A DC adapter and is interfaced with the board to play the game FOLLOW ME with the background music. The matrix has 2 planes (upper and lower), both of which will be programmed separately. Planes are made by dividing 64 rows into 2 halves, i.e. first 32 rows in plane 1 and the remaining 32 rows in plane 2. Five signals (viz. A, B, C, D, and E) which are connected to 5 GPIOs of the SJ-2 board are used to select rows from each plane. R1, G1, B1 signals with 64-bit registers are used to address individual led from the selected row in plane 1. Similarly, R2, G2, B2 signals used to address individual led from the selected row in plane 2.

A single clock is interfaced to these 6 64bit shift registers. Hence, at one clock signal, we fill and enable a column corresponding to two selected rows. Once the clocking and register shifting is done, the data need to be latched to the register which in turn enables the corresponding LED. Then the LATCH is set to mark end of the row and reset to move to next row. The output enable signal is enabled to push the data to the selected row. The output enable signal is disabled again to select the other row. All of these steps are repeated at very less time intervals so that the human eye perceives it as one complete frame (Persistence of Vision).

Pin Configuration

Pin Pin Description
R1 Sets upper panel's Red data
G1 Sets upper panel's Green data
B1 Sets upper panel's Blue data
R2 Sets lower panel's Red data
G2 Sets lower panel's Green data
B2 Sets lower panel's Blue data
A Sets row bit 0
B Sets row bit 1
C Sets row bit 2
D Sets row bit 3
E Sets row bit 4
nOE Set to switch the LEDs off when transitioning from one row to the next
LATCH Set to mark completion of one row
CLK Set to access each pixel
GND Ground pins to be connected with board's GND.

Hardware Design

The hardware involves 5V/4A DC power supply adapter, barrel jack connectors and IDC cables to power up the LED matrix and communicate with the board. Below is the pin interfacing diagram.

LED Matrix Pin Diagram

Software Design

1. Timer - Mode

a) Set the timer to finish the game in given time

b)

2. Endurance -Mode

a) Play until Far gesture is detected

b)


Game rules:

a) Game comprises of 3 levels (level 2 on reaching score 15 and level 3 on reaching score 30).

b) Primary objective is to move hands in direction of arrow if the color is GREEN and in opposite direction if the color is RED.

c) Score increases by 1 point for right hand movement.

d) Level 3 is faster so make sure you tune your reflexes up.

e) Reach score 50 to win the game.


There are 2 tasks involved to ensure functioning of the game.

a) Task 1:

  • Display the game's title screen. The game begins with receiving gesture from any of the player.
  • Also used to display game over screen / win screen.

b) Task 2:

  • Enter into game mode to play the game.
  • Generate arrow matrix frame for random direction(horizontal, vertical, up and down) and random color(Red/Green).
  • Detect the player's gesture from his board, compare it with arrow's location and color.
  • Display score and level.
  • Upon receiving Far gesture from the player, stop game and return to title screen or to restart the game once it is over.

Implementation

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 describe 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.


LED Matrix: faulty matrix , needed to buy another one. Lessons: order the obvious component as soon as possible and test it.

  • Measure the resistance between 5v and ground terminal

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

  • Git Project Link: [1]
  • Git Project Link(individual modules): [2]

References

Acknowledgement

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

References Used

RGB LED Matrix Interfacing and Designing
MP3 Decoder
Gesture & Orientation Sensors
General/Miscellaneous

Appendix

You can list the references you used.