Changes to get platform-v8080 running again
[FUZIX.git] / INSTALL
1
2 Edit the top level Makefile and set ARCH
3 Read Kernel/platform-$ARCH/README
4 Adjust anything it recommends for your platform
5
6 The Z80 build tools get stuck in /opt/fcc as will others in future. Right now
7 /opt/fcc isn't moveable (yes we suck) but you can create that directory and
8 chown it to the building user.
9
10 Make sure you have the needed compilers on your path
11 If you are running cc65 remember you also need CC65_HOME set properly!
12
13 If you are using the lwtools gcc for 6809 ensure that $(pwd)/BUILD/tools is
14 on your path.
15
16 Cross fingers, type "make"
17
18 This should give you a build of libraries, user and kernel.
19 Standalone/filesystem-src contains some scripts to build filesystems
20 fuzix.org contains a bunch ready to download
21
22 For Z80 your VM needs at least 16GB including swap because sdcc is a bit of a
23 memory monster. Also use sdcc 3.7.1 or later as 3.7.0 is broken in ways that
24 cause Fuzix to break.
25
26 Fuzix expects yacc to be yacc not Bison. if your system for some reason thinks
27 that executing yacc should run bison you'll have a build failure. For Debian
28 and derivatives (eg Ubuntu) this can be fixed with
29
30  - sudo apt-get install -y byacc
31  - sudo update-alternatives --set yacc /usr/bin/byacc
32