Snake Game Application on Curiosity PIC32MZ EF 2.0 Development Board + High-Performance WVGA LCD Display Module with maXTouch Technology using Legato Graphics

Download

Description:

This demonstration represents the classic snake game wherein the player maneuvers the snake and tries to eat the mice (food), which eventually grows the length of the snake. The player needs to protect the snake from hitting the boundary.
The application uses the Legato Graphics library to implement the user interface. The template of each screen is made using the Legato Graphics Composer, while the snake was created using a rectangle widgets used inside a double chained list. The control for the thumbstick was implemented using the SPI driver library from Harmony 3.

Modules/Technology Used:

Legato Graphics Library
SSD1936 driver
SPI Driver Library
Time System Service Library
Core Timer

Hardware Used:

Software/Tools Used:

This project has been verified to work with the following versions of software tools:

Refer Project Manifest present in harmony-manifest-success.yml under the project folder firmware/src/config/default

Refer the Release Notes to know the MPLAB X IDE and MCC Plugin version. Alternatively, Click Here.

Because Microchip regularly update tools, occasionally issue(s) could be discovered while using the newer versions of the tools. If the project doesn’t seem to work and version incompatibility is suspected, It is recommended to double-check and use the same versions that the project was tested with. To download original version of MPLAB Harmony v3 packages, refer to document How to Use the MPLAB Harmony v3 Project Manifest Feature

Setup:

Mount SSD1963 LCD Controller Graphics Card on the Graphics connector(J601) of Curiosity PIC32MZ EF 2.0 Development Board
Mount Thumbstick click board on mikro bus click 1 connector of Curiosity PIC32MZ EF 2.0 Development Board
Connect the WVGA LCD Display Module ribbon to the connector(J2) of the SSD1963 LCD Controller Graphics Card
Plug the 5.5-14V power cable to the power connecter(J200) of the Curiosity PIC32MZ EF 2.0 Development Board

Programming hex file:

The pre-built hex file can be programmed by following the below steps.

Steps to program the hex file

Open MPLAB X IDE
Close all existing projects in IDE, if any project is opened.
Go to File -> Import -> Hex/ELF File
In the “Import Image File” window, Step 1 - Create Prebuilt Project, Click the “Browse” button to select the prebuilt hex file.
Select Device has “PIC32MZ2048EFM144”
Ensure the proper tool is selected under “Hardware Tool”
Click on Next button
In the “Import Image File” window, Step 2 - Select Project Name and Folder, select appropriate project name and folder
Click on Finish button
In MPLAB X IDE, click on “Make and Program Device” Button. The device gets programmed in sometime
Follow the steps in “Running the Demo” section below

Programming/Debugging Application Project:

Open the project (snake_game/firmware/pic32mz_ef_curiosity_v2.X) in MPLAB X IDE
Ensure “Curiosity/Starter Kits (PKOB4)” is selected as hardware tool to program/debug the application
Build the code and program the device by clicking on the “Make and Program Device” button in MPLAB X IDE tool bar
Follow the steps in “Running the Demo” section below

Running the Demo:

Perform a reset by pressing RESET button on the Curiosity PIC32MZ EF 2.0 Development Board
After the board powers up, a splash screen should appear followed by the Menu screen.
By using the Thumbstick, select the desired level to play and press the thumbstick to enter the level.
Use the thumbstick to change the snake direction in order to reach the food.
By pressing the Thumbstick button the user can go back to the Menu.

Comments:

The game should end when the snake hit an obstacle when it doesn’t have any remaining lives or when it eats food 8 times
This application demo builds and works out of box by following the instructions above in “Running the Demo” section. If you need to enhance/customize this application demo, you need to use the MPLAB Harmony v3 Software framework. Refer links below to setup and build your applications using MPLAB Harmony.
- How to Setup MPLAB Harmony v3 Software Development Framework
- How to Build an Application by Adding a New PLIB, Driver, or Middleware to an Existing MPLAB Harmony v3 Project
- MPLAB Harmony v3 is also configurable through MPLAB Code Configurator (MCC). Refer to the below links for specific instructions to use MPLAB Harmony v3 with MCC.

Revision:

v1.6.0 Regenerated and tested the application.
v1.5.0 Removed MHC support, Regenerated and tested application.
v1.4.0 Added MCC support, Regenerated and tested application.
v1.3.0 regenerated and tested demo application
v1.2.0 regenerated and tested demo application
v1.1.0 released demo application