https://github.com/eric15342335/inspirelab-game

CH32V003J4M6 (In progress)
https://github.com/eric15342335/inspirelab-game

buzzer c ch32v003 oled-display-ssd1306 risc-v

Last synced: about 2 months ago
JSON representation

CH32V003J4M6 (In progress)

• Host: GitHub
• URL: https://github.com/eric15342335/inspirelab-game
• Owner: eric15342335
• License: gpl-3.0
• Created: 2024-06-24T03:23:22.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-08-29T09:23:36.000Z (4 months ago)
• Last Synced: 2024-08-29T10:47:42.334Z (4 months ago)
• Topics: buzzer, c, ch32v003, oled-display-ssd1306, risc-v
• Language: C
• Homepage: https://inspirelab.hk
• Size: 982 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING.txt

Awesome Lists containing this project

README

        
# InspireLab Game

## Description

This repository discovers extra potential on the CH32V003 RISC-V Game console.

A link to the original repository is below.

## How to use

### Snake Game

1. Install MounRiver Studio and add the following to `PATH`:

    * `$(your_install_directory)/MounRiver_Studio/toolchain/RISC-V Embedded GCC 12/bin`

        * For `riscv-none-elf` compiler toolchain

    * `$(your_install_directory)/MounRiver_Studio/toolchain/Build Tools/bin`

        * For `make` tool

2. Open terminal in the corresponding game folder (e.g. `snakegame`)

3. type `make` on the terminal to make the executable for CH32V003

4. flash the hex file into the game console (`CH32V003J4M6`) using WCH-LinkUtility (`Windows` only) or `todo`

5. Have fun!

#### Notes:

* the driver in `riscv/include` has been modified (compared to [original implementation](https://github.com/wagiminator/CH32V003-GameConsole/tree/main/software/tiny_arkanoid/include)) to allow direct copy from the emulator to run the RISC-V controller

* buzzer function plays real frequency in Hz

### Emulator

* `emulator/include` contains a port of the `riscv/include` libraries

which allows code using such libraries to run on desktop platforms for ease of debugging

  * Windows / MacOS are supported

  * See [emulator/README.md](emulator/README.md) for more information.

  * Usage: `make -f makefile-emulator` inside game directory.

### Utilities and Tools

* Contains an [python script](utils/pixelConvert.py) that faciliates game texture conversion from 128x64 png file to C-array which the OLED monitor accepts

![image](https://github.com/eric15342335/inspirelab-game/assets/70310617/66b99c52-8682-482c-8fdb-ba39357e72e0)

## Links

* Original Repository: 

* WCH-LinkUtility.exe: 

* MounRiver Studio Installer: