Download the latest release of Amiga Test Kit here (Github).
A Docker image has kindly been supplied (Docker Hub). You can run it as follows to generate the latest Amiga Test Kit zip file in your current directory:
docker run -v $(pwd):/output --rm -ti rjnorthrow/atk:latest
This is as simple as make all when all prerequisites are
installed. The ADF and distribution ZIP file will then be in the
testkit/ folder.
Pick a location to install your locally-built toolchains, and make sure it is on your PATH. For example:
mkdir -p $HOME/install/bin
export PATH=$PATH:$HOME/install/bin
I recommend binutils-2.34 and gcc-9.3.0, or newer, built with the following
configuration lines on a Linux host or VM. Note these are not
exhaustive toolchain build instructions, as GCC itself has a large number
of prerequisites. You can use the .github/workflow scripts for further
hints.
../binutils-2.34/configure --prefix=/path/to/install --target=m68k-elf
../gcc-9.3.0/configure --prefix=/path/to/install --target=m68k-elf --enable-languages=c --disable-libssp
On macOS you can instead straightforwardly install from Homebrew:
brew install m68k-elf-gcc
Clone, build and install bebbo's amiga-gcc toolchain (GitHub). Please follow the README instructions very carefully. This is especially important if building on macOS, where careful use of Homebrew-installed tools (including bison!) is required to avoid cryptic build failures.
Google's Zopfli is a gzip replacement. It can be installed using your OS package manager, for example apt (Ubuntu) or brew (macOS).
This is a Python package which can be installed using pip or pipx. For example:
pipx install amitools
This is a selection of code that I will add to over time. There are three main file types, distinguished by suffix:
- .S CPP + GAS assembler syntax (for cross-dev environments)
- .asm Amiga native asm syntax (Devpac, AsmOne, PhxAss, vasm, Barfly, ...)
- .c Somewhat-portable C (I will gladly take patches to make the C code work outside a GCC/POSIX environment).
All code is public domain (see the COPYING file).
For detailed build and usage instructions, see file header comments and run-time help info.
-
base/ GNU build rules, initialisation code, utility code and headers.
-
testkit/ Amiga Test Kit, built as a Workbench/CLI executable and as a bootable disk image.
-
host_tools/kickconv Convert Kickstart ROM images: byte-swap, word-split, decrypt, fix checksums. Especially useful for creating images for burning to EPROM.
-
attic/crc16_ccitt.S Table-driven CRC16-CCITT implementation.
-
inflate/degzip_{gnu,portable}.c Analyse gzip files, extract and write out their raw Deflate streams (can then be processed by inflate, see below). Original version for GNU/Linux, and portable version fixed by phx / EAB.
-
inflate/inflate.{S,asm} Small and efficient implementation of Inflate, as specified in RFC 1951 "DEFLATE Compressed Data Format Specification".