You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

28 lines
1.2 KiB
Markdown

# The arm-stmos toolchain
A special binutils/gcc toolchain is necessary to build stmos and associated
programs. For convenience, a bash script has been written to attempt to automate
the majority of the compilation/installation process. This process is based of
off various tutorials from [osdev.org](https://wiki.osdev.org).
Some programs are required for the build process. A list can be found [here](https://wiki.osdev.org/GCC_Cross-Compiler#Installing_Dependencies). Once
installed, just run the script:
```
./create-toolchain.sh
```
It should be safe to re-run the script, if necessary.
After successful installation, be sure to add the toolchain to your path ($HOME
/arm-stmos/bin). Then, follow these steps to build pdclib and the crt0:
* Cd to src/pdclib
* Make sure the Makefile does not have the ```-g``` flag set under CFLAGS
* Build pdclib (make)
* Copy pdclib.a to ~/arm-stmos/lib/gcc/arm-stmos/8.2.0/libc.a
* Add the ```-g``` flag to CFLAGS in the Makefile; Rebuild pdclib
* Copy pdclib.a to ~/arm-stmos/lib/gcc/arm-stmos/8.2.0/libg.a
* Cd to the stmos root directory; run ```make crt```
* Copy crt0.o ~/arm-stmos/lib/gcc/arm-stmos/8.2.0/crt0.o
Now everything should be ready. Build stmos, run it, hope it works.