https://github.com/federicobruzzone/chip-8-stm32

CHIP-8 and S-CHIP emulator on STM32 Cortex M4
https://github.com/federicobruzzone/chip-8-stm32

c chip-8 chip8 chip8-emulator emulator stm32 stm32f4 superchip

Last synced: about 2 months ago
JSON representation

CHIP-8 and S-CHIP emulator on STM32 Cortex M4

• Host: GitHub
• URL: https://github.com/federicobruzzone/chip-8-stm32
• Owner: FedericoBruzzone
• License: agpl-3.0
• Created: 2023-10-18T21:15:37.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-12T15:56:22.000Z (5 months ago)
• Last Synced: 2024-08-12T18:29:38.566Z (5 months ago)
• Topics: c, chip-8, chip8, chip8-emulator, emulator, stm32, stm32f4, superchip
• Language: C
• Homepage:
• Size: 717 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chip-8 STM32

This repository contains the port of our [Chip-8 emulator](https://github.com/CHIP-8-Org/Core) for the STM32 microcontroller platform. The Chip-8 emulator allows you to run vintage video games originally designed for the CHIP-8, CHIP-48, S-CHIP 1.0 and S-CHIP 1.1 on STM32-based hardware.

## Features

- Emulates Chip-8 virtual machine on STM32 microcontroller.

- Display output on ILI9341 TFT screen.

- Read game files from an SD card for easy game loading.

- Beeper support for audio feedback during gameplay.

- Matrix keypad integration for user input.

- Low power consumption, suitable for battery-powered operation.

## Compilation and Usage

You need to have installed `bear` command in your machine in order to generate the `compile_commands.json`. You can find more information [here](https://github.com/rizsotto/Bear).

```bash

./build.sh [COMMAND]

Command:

    clean   [remove  the content of `./Release` and `./Debug` folders and `compile_commands.json` file]

    release [compile, generate `compile_commands.json` and flash in release mode]

    debug   [compile, generate `compile_commands.json` and flash in debug mode]

```

## Contributing

Contributions to this project are welcome! If you have any suggestions, improvements, or bug fixes, feel free to submit a pull request.

## License

This repository is licensed under the [GNU General Public License (GPL)](https://www.gnu.org/licenses/gpl-3.0.html). Please review the license file provided in the repository for more information regarding the terms and conditions of the GPL license.

## Contact

If you have any questions, suggestions, or feedback, do not hesitate to [contact me](https://federicobruzzone.github.io/).

Maintainers:

  - [FedericoBruzzone](https://github.com/FedericoBruzzone)

  - [Andreal2000](https://github.com/Andreal2000)