fxrobin/m68k-compiler repository overview

⁠m68k-compiler

Reproducible Docker environment to compile C into Atari ST (TOS, Motorola 68000) binaries, then run them in Hatari⁠.

Toolchain: m68k-atari-mint-gcc (Vincent Riviere's PPA⁠) on Ubuntu 22.04, slim multi-stage image (~136 MB).

⁠Quick start

docker run --rm -u $(id -u):$(id -g) -v "$PWD:/app" fxrobin/m68k-compiler make
ls -l target/build/hello.tos

With this Makefile layout (all src/*.c linked into one TOS program):

.
├── Makefile          # src/*.c -> target/obj/*.o -> target/build/hello.tos
└── src/
    └── hello.c

⁠Run in Hatari

hatari --tos tos.img -d target/build
# then on the GEM desktop: open drive C, double-click HELLO.TOS

(You must provide your own TOS image, tos.img, for licensing reasons.)

⁠Links

• Sources & docs: https://github.com/fxrobin/docker-m68k-compiler⁠
• Tutorial (FR): https://github.com/fxrobin/fxrobin.github.io/blob/master/_posts/retro-prog/m68k-docker-compiler/2024-09-20-m68k-docker-compiler-fr.md⁠