Difference between revisions of "Atari"

From Free Pascal wiki
Jump to navigationJump to search
(→‎Linker: note linking issues with 68020)
(→‎Cross compiling: binutils and other dependencies availability)
Line 42: Line 42:
 
==Cross compiling==
 
==Cross compiling==
  
 +
===Dependencies===
 +
Free Pascal requires cross-binutils for the target platform. Additionally, the TOS version also needs '''vlink''' and optionally '''vasm'''. For Atari TOS/MiNT cross-binutils for various platforms, also as binary downloads, [http://vincent.riviere.free.fr/soft/m68k-atari-mint/ see this page by Vincent Rivière]. For [[#Linker|vlink]] and [[#Assembler|vasm]] see the relevant sections above.
 +
 +
===Building===
 
To build an Atari cross-compiler, use the following steps:
 
To build an Atari cross-compiler, use the following steps:
  

Revision as of 12:53, 21 January 2017

This page is about the Atari TOS version of Free Pascal, which means Motorola 680x0 CPU based Atari systems running TOS and compatibles.

Status

The initial port was done by Károly Balogh, maintainer of the m68k and Amiga ports, based on some existing bits from FPC 0.x and 1.x times done by Carl Eric Codere and others. The Atari TOS port lacks a maintainer currently. This means although we try to keep it working and do minor fixes to it, the port receives no new features. Contact the m68k port maintainer, if you are interested in stepping up as an Atari maintainer.

The RTL support is reasonably advanced, and it's sufficient to run the compiler itself on Atari TOS, but - given the real hardware's constraints - it's not extensively tested. Most of the System, Sysutils and DOS units are implemented, some parts of it are not, or not well tested though. The only known missing part is environment variable access in Sysutils and DOS units. Additionally, the "tosunits" package is very minimal at this point, which means FPC provides no bindings for most of the OS API for applications at this point. It's easy to add them though.

Identification

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

AppType directive

Atari is among the few platforms actually support the $APPTYPE directive, originating from Delphi and Windows. There are currently two states:

  • $APPTYPE CONSOLE - the resulting executable will have .TTP extension
  • $APPTYPE GUI - the resulting executable will have .PRG extension

The default is CONSOLE, so compiled programs will have .TTP extension. The directive doesn't affect any other code generation or run-time behavior, except the resulting executable name.

SysCalls

Free Pascal supports generating Atari TOS-style system calls, also known 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. The native compiler defaults to vlink, to switch the linker back to GNU ld use -XV- argument.

vlink is open source, and it is available here. Binaries are available as part of the vbcc compiler package. For advanced features like named sections and section garbage collection, use vlink 0.15d or newer.

Due to TOS executable format limitations, code compiled for 68020 and newer CPUs might not work at this time, so use the option -Cp68000 to force the compiler to 68000 only mode. See the additional notes about 68000 constraints on the m68k page.

Assembler

The Atari TOS port supports both GNU as assembler and vasm. Advanced features like named sections support are only available with vasm. To compile with vasm, you need to specify the argument -Avasm compile time. Please note that mixing GNU as and vasm compiled objects might cause issues during linking.

vasm is open source, and it is available here. Binaries are available as part of the vbcc compiler package. Only vasm versions 1.7h and newer were tested, older versions might not work.

Cross compiling

Dependencies

Free Pascal requires cross-binutils for the target platform. Additionally, the TOS version also needs vlink and optionally vasm. For Atari TOS/MiNT cross-binutils for various platforms, also as binary downloads, see this page by Vincent Rivière. For vlink and vasm see the relevant sections above.

Building

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

  1. Install the latest stable FPC version, 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 CROSSOPT="-Cp68000" 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>
-Cp68000
-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>