AGON dev C/C++ toolchain

Status

Early access Alpha: things will break.

The toolchain is currently compiled for Linux only.

I'm not ready to accept issues or PRs at this time. Contact me at Discord to discuss

Purpose

To assemble a C/C++ toolchain, based on modern, open-source software that can be ported to many platforms

Installation

• Download and extract the release.gz file from the releases tab, to a path without any space, e.g. /home/user/agondev
• Extend the PATH environment variable to point to agondev/bin. Example:

export PATH=/<insert path to agondev>/bin:$PATH

Toolchain components

• Clang 15.0 C/C++ compiler, emitting ez80 code, forked from (https://github.com/CE-Programming/llvm-project) and patched to output GNU-AS compatible assembly syntax
• GNU AS assembler, compiled to accept ez80 syntax and output ez80-none-elf objects
• GNU LD linker, compiled to link ez80-none-elf objects
• A significant portion of code from the AgDev toolchain, which is an extension of the CEDev toolchain to target the Agon platform

Compiling programs

Check out the provided example programs, which have a slightly different top-level Makefile with options that are similar to what AgDev provides.

All source files need to be placed under a project's ./src directory.

.c / .cpp / .s / .asm / .src sources will be compiled / assembled directly to an ELF-formatted object file in ./obj

The linker will link all objects together with the provided libaries (libc / agon / fp / crt) and create a binary in ./bin

Build toolchain from source

1. clone this repo
2. Run the make_llvmtools.sh shell script. This isn't robust, but should do the trick. You need the essentials for compiling and making stuff, e.g. using apt-get install build-essential, but also ninja. This is a hefty build that takes a long time and a lot of memory. About 30min on my AMD 4650, taking up 14-15GB of memory. When it finishes, all binary tools are in the ./bin folder
3. Perform a 'make clean;make all' to build the Agon libraries

Known limits

• My LLVM fork (https://github.com/envenomator/llvm-project) does not emit the special 'jq' mnemonic that the FASMG assembler used in CEDev/AgDev automagically translates to either 'jp' or 'jr'. GNU AS doesn't support this at this moment; so clang is set up to only emit 'jp' for now

Unknown limits

unknown_limits = INFINITE - known_limits;