Shell Commands
Cross-Compiling with Xita
At present, Xita only supports ARM 64-bit Architecture and can be ran as xcs-aarch64. As more architectures are supported in the future, this name is subject to change.
Basic Compilation
If you want to simply compile Xita source code into a binary object, you can run the following:
$ xcs-aarch64 main_driver.xs
This will produce a file main_driver.o in the same directory in AArch64 binary format. This object file gets linked into a final image file (*.iso) that can be burned to MicroSD.
NOTE: This will also produce an assembly file main_driver.xs.s in the same directory. This file is used for current debugging processes and will not be produced/kept in long-term.
Compiler Flags
Implemented
| Flag | Purpose |
|---|---|
| --version | Displays version information for installed Xita compiler |
| -a (--assembly) | Preserves generated assembly files for manual review |
| -h (--help) | Provides help message containing compiler flags and usage |
| -v (--verbose) | Provides additional debugging messages in Standard I/O about compiling process |
Unimplemented (Planned)
| Flag | Purpose |
|---|---|
| -c (--chip) file.chip | Indicates the cross-compiler should compile for the given chip |
| -b (--boot) loader.s | Indicates the cross-compiler should compile using the desired boot script |
| -l (--link) linker.ld | Indicates the cross-compiler should compile using the desired linker script |
Note that the -c can be fed generic options such as: -c RPi3 to fetch the chip, boot, and linker files for RPi3 within the Xita repository.