chips-test
Tests and sample emulators for https://github.com/floooh/chips
Live demos of the example emulators: https://floooh.github.io/tiny8bit
To build and run on Windows, OSX or Linux (exact versions of tools shouldn't matter):
Check prerequisites:
> python --version
Python 2.x or 3.x
> cmake --version
cmake version 3.x
NOTE: on Linux, additional dev packages need to be present for X11, GL and ALSA development.
Create a 'workspace' directory (which will be populated with additional dependencies),
clone and cd into chips-test
:
> mkdir workspace
> cd workspace
> git clone https://github.com/floooh/chips-test
> cd chips-test
Finally, build and run one of the emulators (for instance the Amstrad CPC):
> ./fips build
> ./fips list targets
> ./fips run cpc
To get optimized builds for performance testing:
# on OSX:
> ./fips set config osx-make-release
> ./fips build
> ./fips run [target]
# on Linux
> ./fips set config linux-make-release
> ./fips build
> ./fips run [target]
# on Windows
> fips set config win64-vstudio-release
> fips build
> fips run [target]
To open project in IDE:
# on OSX with Xcode:
> ./fips set config osx-xcode-debug
> ./fips gen
> ./fips open
# on Windows with Visual Studio:
> ./fips set config win64-vstudio-debug
> ./fips gen
> ./fips open
# experimental VSCode support on Win/OSX/Linux:
> ./fips set config [linux|osx|win64]-vscode-debug
> ./fips gen
> ./fips open
To build the WebAssembly demos (Linux or OSX recommended here, Windows might work too, but this is not well tested).
# first get ninja (on Windows a ninja.exe comes with the fips build system)
> ninja --version
1.8.2
# now install the emscripten toolchain, this needs a lot of time and memory
> ./fips setup emscripten
...
# from here on as usual...
> ./fips set config wasm-ninja-release
> ./fips build
...
> ./fips list targets
...
> ./fips run c64
...
When the above emscripten build steps work, you can also build and test the entire samples webpage like this:
> ./fips webpage build
...
> ./fips webpage serve
...
Many Thanks To:
- utest.h: https://github.com/sheredom/utest.h