Recently, I started down the path of getting a build environment to compile the current Fuzix release (0.3rc1) for the RC2014 platform using a 6502 processor. I ran into some problems when attempting to build the disk image, about 9 errors in all, showing missing files and such. Not being a big "C guy" I eventually opened a bug report on Github. Alan did get a chance to look at it and fixed it, so I did a fresh clone and all but one error went away (Alan said he had a successful build). Rummaging around the directory structures I found a pkg file that didn't seem to apply to the 6502 build, so I deleted it.... and got lucky, now it builds clean with images.
So, here's my cheat sheet instructions to do a full environment build from scratch. I prefer doing this stuff in virtual machines and use VMware Fusion. For Linux, I've basically settled on Ubuntu for when I need Linux, so here goes:
1- download the current Ubuntu desktop ISO image (version 21.10)
2- create a VM in Fusion using the "easy install" and the following config changes:
- CPU cores = 4
- Memory = 4096 MB
- DASD = 32GB
note: this install with updates and two reboots took a total of 12 minutes... not too bad (not including the ISO download).
3- configure the desktop for what you like... background, window size, etc.
Next, you need to install the rest of the tools and clone the Fuzix code. I did this in the home directory for my user, which is "km"
from a terminal window, enter the following:
sudo apt install gcc
sudo apt install make
sudo apt install -y byacc
sudo update-alternatives --set yacc /usr/bin/byacc
sudo apt install git
sudo git clone
https://github.com/EtchedPixels/FUZIX.gitsudo chown -R km FUZIX (note: change km to your user name)
sudo apt install cc65
- Now you have a full build environment... time to configure Fuzix
in the FUZIX directory, edit the makefile:
change the line TARGET=cpm22 to TARGET=RC2014-6502, then save the file
in the FUZIX/Applications/games directory, delete the file named "fuzix-games.pkg"
You can now attempt a build... crossed fingers... and from the FUZIX directory:
enter "make diskimage"
It should complete and create a directory under FUZIX/images/RC2014-6502
there should be 3 img files... one for the emulator, one of the filesystem and one for building a CF card disk image.
On my VM, the entire build process took a lengthy 20 seconds to compile and build the 3 images
Installing all of the tools and compiling the build took 5 minutes, including the 20 seconds build... nice!
Hope this helps anyone looking to start with Fuzix. Good luck.