https://github.com/bashmocha/chip8-emulator

A fully-featured Chip-8 emulator written in C and SDL
https://github.com/bashmocha/chip8-emulator

c chip8 emulator sdl2

Last synced: about 1 month ago
JSON representation

A fully-featured Chip-8 emulator written in C and SDL

• Host: GitHub
• URL: https://github.com/bashmocha/chip8-emulator
• Owner: BashMocha
• License: mit
• Created: 2023-09-08T22:58:52.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-03T17:31:36.000Z (over 1 year ago)
• Last Synced: 2024-12-06T09:38:40.487Z (about 2 months ago)
• Topics: c, chip8, emulator, sdl2
• Language: C
• Homepage:
• Size: 6.79 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chip8 Emulator

This repository contains an implementation of a Chip-8 interpreter written in C. It supports the complete set of the standard Chip-8 instructions however doesn't include support for Super Chip-48.

CHIP-8 is an interpreter programming language developed by Joseph Weisbecker in the mid-70s and was initially used on the COSMAC VIP and 

Telmac 1800 8-bit microcomputers to make game programming easier. CHIP-8 programs are run using a CHIP-8 virtual machine.



    

    




[This reference](http://devernay.free.fr/hacks/chip8/C8TECH10.HTM) explains the virtual machine (instruction, registers, stack, memory, display, and keypad) and the opcodes supported.

## Keyboard Layout

 The computers which originally used the Chip-8 Language had a 16-key hexadecimal keypad with the following layout:

    

        

            1

            2

            3

            C

        

    

    

        

            4

            5

            6

            D

        

        

            7

            8

            9

            E

        

        

            A

            0

            B

            F

        

    

## Dependencies

 - [Mingw-64 compiler](https://gcc.gnu.org/)

 - [SDL2 library (64-bit)](https://www.libsdl.org/)

 - [A copy of a Chip-8 ROM](https://www.zophar.net/pdroms/chip8/chip-8-games-pack.html)

## Compatibility

Verified compatible with Windows (64-bit).

## Building and Running

To build the project run:

```shell

  git clone https://github.com/CheesyFrappe/chip8-emulator.git

  cd chip8-emulator

  mingw32-make

```

Running from the command line:

 - You need to provide the path to a ROM file as an argument. Check [dependencies](https://github.com/CheesyFrappe/chip8-emulator/new/master?readme=1#dependencies) for the ROM file.

 - So you can start the INVADERS game available in the `bin` directory by:

```shell

  cd bin

  .\main.exe ./INVADERS

```

## License

This project is open source and available under the [MIT License](https://github.com/CheesyFrappe/chip8-emulator/blob/master/LICENSE).