https://github.com/sun0fabeach/riscv_snake

Play snake on a browser based RISC-V microcontroller emulator
https://github.com/sun0fabeach/riscv_snake

Last synced: about 1 month ago
JSON representation

Play snake on a browser based RISC-V microcontroller emulator

• Host: GitHub
• URL: https://github.com/sun0fabeach/riscv_snake
• Owner: Sun0fABeach
• License: mit
• Created: 2022-07-03T17:42:56.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-08-24T14:50:44.000Z (over 2 years ago)
• Last Synced: 2024-04-15T15:32:40.206Z (8 months ago)
• Language: Assembly
• Homepage:
• Size: 35.2 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RISC-V Snake

An implementation of the classic game _snake_ on the [emulsiV]( "emulsiV") RISC-V microcontroller emulator. Entirely written in RISC-V assembly (integer subset RV32I).

To play, you can either take the direct link or build from source and upload.

## Direct Link

Play the game preconfigured on the emulator [here]().

## Build From Source

1. Install RISC-V bare-metal compiler and bin utils. For example, in Manjaro:

  ```bash

  pamac install riscv64-elf-gcc riscv64-unknown-elf-binutils

  ```

  * If your distro uses a differently named compiler, install that and change line 1 in Makefile accordingly. For example `gcc-riscv64-unknown-elf` on Ubuntu.

2. Run Makefile:

```

make

```

3. Open [emulsiV]( "emulsiV") and upload executable `snake.hex` by clicking the folder button top left: ![folder](https://user-images.githubusercontent.com/8113158/180611214-6f8428d5-6920-42cd-9ef3-8fa9d964cf38.png)

## Controls

To start the program, press "Run", top right.

Afterwards, you can control the game via the gpio buttons. They are preconfigured if you follow the direct link. If you've built and uploaded manually, you need to configure them yourself by right-clicking the fields until you have the following layout.

![gpio](https://user-images.githubusercontent.com/8113158/180611145-5773455a-fb3b-4036-a7e9-e19aec77a820.png)

Once the game is running, you can give inputs by left-clicking the buttons.

* the d-pad aligned buttons on the left change the snake's direction

* the button top right restarts the game

* the LED bottom right is on as long as the game is running and the player didn't reach game over

The Snake will speed up and grow longer the more food it eats. Hitting the edge of the screen or itself means game over.

### Performance Caveat

The game speed can vary greatly depending on your CPU speed, browser, and sometimes by pausing / restarting. That is because the implementation simply uses idle CPU cycles to pause between moves.