Atari

This page is about the Atari TOS version of Free Pascal, which means Motorola 680x0 CPU based Atari systems running TOS and compatibles. Currently, Atari TOS is only supported as a cross-compilation target. The RTL support is currently minimal and lacks functionality to run the compiler itself on Atari TOS.

Identification

To identify Atari TOS during compile-time, use {$IFDEF ATARI}.

SysCalls

Free Pascal supports generating Atari TOS-style system calls, also know as traps. It's not required to use inline assembly to do system calls. However, you must declare every function you're going to use in the following way:

function gemdos_fwrite(handle: smallint; count: longint; buf: pointer): longint; syscall 1 64;

Note the syscall modifier in the function declaration. The first argument to the syscall modifier is the trap number to call, and the second one is the trap opcode. All syscall parameters are passed on the stack and they're word (2 byte) aligned. For further examples, see rtl/atari/gemdos.inc in the RTL source.

Linker

For Atari, some versions of GNU ld linker available online is known to be problematic when working together with Free Pascal. It's recommended to use vlink by Frank Wille, while compiling to Atari TOS with FPC. Specifying -XV argument enables vlink for cross compilers. vlink is open source, and it is available here. Binaries are available as part of the vbcc compiler package.

Cross compiling

To build an Atari cross-compiler, use the following steps:

1. Install FPC the latest stable compiler, at the time of the writing of this article this is FPC 3.0.0. This will be used as the startup compiler.
2. Check out FPC SVN trunk into a directory.
3. Make sure you have Atari TOS cross-binutils and vlink in the PATH.
4. Go to the trunk's main directory and use the following command to build an FPC cross-compiler:

  make clean crossall crossinstall OS_TARGET=atari CPU_TARGET=m68k INSTALL_PREFIX="<path/to/install>"

If you've done everything right, you should find a working Atari cross-compiler in the install path you've specified.

Now, lets create a default fpc.cfg for Atari cross compiling. Create a file called <path/to/install>/lib/fpc/etc/fpc.cfg. Put the following lines into that file, and fix up the paths:

#IFDEF CPUM68K
-Fu<path/to/install>/lib/fpc/$fpcversion/units/$FPCTARGET
-Fu<path/to/install>/lib/fpc/$fpcversion/units/$FPCTARGET/*
#IFDEF ATARI
-FD</path/to/atari-cross-binutils>
-XV
#ENDIF
#ENDIF

Optionally add <path/to/install>/lib/fpc/3.1.1/ directory to the PATH, so you'll have direct access to the cross-compiler. If you've done everything right, you now should be able to build Atari executables:

ppcross68k -Tatari <source.pas>