6502/erc-c
1
0
Fork 0
mirror of https://github.com/pevans/erc-c.git synced 2024-11-23 08:31:55 +00:00
Code Issues Projects Releases Wiki Activity
An emulator for old / retro computers
10 Commits 6 Branches 0 Tags 917 KiB
C 96.6%
Assembly 1.5%
Python 1.4%
CMake 0.4%
eaaf63a069
Go to file
Peter Evans eaaf63a069 Zero out last_addr and cycles 
This fixes a super-annoying bug in the unit-test suite where we would
fail randomly because sometimes last_addr would have garbage in it.
2017-12-05 18:41:34 -06:00
build First commit 2017-11-21 23:24:51 -06:00
include Use C-style to denote documentation 2017-12-05 18:40:40 -06:00
src Zero out last_addr and cycles 2017-12-05 18:41:34 -06:00
tests Add instruction handler function, handler table 2017-12-05 18:38:36 -06:00
.gitignore First commit 2017-11-21 23:24:51 -06:00
CMakeLists.txt First commit 2017-11-21 23:24:51 -06:00
README.md Add the name of the software 2017-12-05 18:38:14 -06:00
sources.cmake Adding all of the instruction files 2017-12-02 13:05:53 -06:00

README.md

erc

(Emulator of old, Retro Computers)

Erc is software that allows you to emulate computers from the days of yore. (The "days of yore" may be defined as the 1980s.) You may find it interesting if you feel nostalgia for those old machines, or if you want to see how those computers worked.

Erc is also a sound you might make when feeling slightly frustrated, or if you were a small cat that happens to make funny sounds that aren't quite meows.

Running

Right now, erc is mostly unusable; large components of it are still being built out. However, if you do run it, you will see a string that reads:

Hello, world!

In and of itself, this is not so bad, as the software is at least cheerful. If you were having a bad day, seeing "Hello, world!" might make you feel a little bit better.

Compiling and installing

This software uses CMake to build its makefiles, so if you're familiar with that, you should feel somewhat at home.

If you've never compiled any C code before, you will need to install a few things first. If you have not done so, you should install the excellent Homebrew if using a Mac. If you are using Linux, you are probably already acquainted with your local package manager. You will also need to have XCode installed in a Mac environment. You can do so through the App Store.

The following other things you must install are given as Homebrew commands. If you are using Linux, I will leave the appropriate commands you must run as an exercise for the reader.

brew install cmake
brew install snaipe/soft/criterion

Once all that is accomplished, you can do this:

cd build
cmake ..
make

This should produce an executable of the emulator, which you can install wherever you wish.

Testing

If you're feeling a bit nosy, you can run unit tests by doing the following:

cd tests/build
cmake ..
make; ./emp-test

This will execute the testing build of the software, which is handled through Criterion.

Contributing

Right now, I am not accepting pull requests as so much of the design of erc is in flux. I am happy to receive any issues you may file.