ATARI800(1)

NAME
atari800 - Atari 800 Emulator, Version 0.8.1

SYNOPSIS
atari800 [options] [diskfiles...]

DESCRIPTION
atari800 emulates the Atari 800, Atari 800 XL, Atari 130 XE and Atari 5200 Games System.

  Options

-a  Use Atari OS/A.

-b  Use Atari OS/B.

-xl Emulate Atari 800 XL.

-xe Emulate Atari 130 XE - but Antic accesses the same bank the CPU is using.

-5200
    Emulate Atari 5200 - Games controller emulation has not been implemented yet!

-config filename
    Specify an alternative configuration filename.

-configure
    Starts emulator in run-time configuration mode.

-nobasic
    Used to disable Basic when starting the emulator in XL/XE mode. Simulates the Option key being held down during system boot.

-nopatch
    Normally the OS is patched giving very fast I/O. This options prevents the patch from being applied so that the OS accesses the serial port hardware directly. This option will probably never be needed since programs that access the serial hardware should work even if the OS has been patched.

-xcolpf1
    Enables Extended Use of COLPF1 register as used by Antic Modes 2, 3 and f. This option allows two different colours to be displayed in these modes - i.e. Not one colour and two luminances.

-rom filename
    Path to file containing a standard 8K ROM cartridge.

-rom16 filename
    Path to file containing a standard 16K ROM cartridge.

-ags32 filename
    Path to file containing 32K ROM cartridge for the Atari 5200 Games System.

-oss filename
    Path to file containing OSS super-cartridge.

-db filename
    Path to file containing DB super-cartridge.

-osa_rom filename
    Path to file containing Atari Rev.A Operating System. Used to override paths defined at compile time.

-osb_rom filename
    Path to file containing Atari Rev.B Operating System. Used to override paths defined at compile time.

-xlxe_rom
    Path to file containing Atari XL/XE Operating System. Used to override paths defined at compile time.

-5200_rom
    Path to file containing Atari 5200 Games System ROM. Used to override paths defined at compile time.

-basic_rom
    Path to file containing Atari BASIC ROM. Used to override paths defined at compile time.

-c  Enable RAM between $c000 and $d000.

-v  Print emulator version.

-refresh
    Controls screen refresh rate. A numerical value follows this option which specifies how many emulated screen updates are required before the actual screen is updated. This value effects the speed of the emulation: A higher value results in faster CPU emulation but a less frequently updated screen.

  SVGALIB Options

-sound
    Enable sound using the Network Audio System.

-interlace
    Enable screen interlace option

  X Window Options

-private_cmap
    Tells the Emulator to use its own private colormap.

-small
    Runs the emulator in a small window where each Atari 800 pixel is represented by one X Window pixel.

-large
    Runs the emulator in a large window where each Atari 800 pixel is represented by a 2x2 X Window rectange. This mode is selected by default.

-huge
    Runs the emulator in a huge window where each Atari 800 pixel is represented by a 3x3 X Window rectange.

-sound
    Enable sound using the Network Audio System.

  Amiga Options

-ocs
    Used for OCS based Amigas. It has not been tested on a real OCS based computer and there could be problems with regard to Workbench versions.

-ecs
    Used for ECS based Amigas. It has not been tested on a real ECS based computer and there could be problems with regard to Workbench versions.

-aga
    Used for AGA based Amigas. It has been tested on an Amiga 1200 with 68030 + 4Mb Fast RAM.

-grey
    Produce a grey scale display.

-colour
    Produce a full colour on AGA machines and up to 32 simultaneous colours on OCS and ECS machines.

-wb Runs the emulator in a Workbench Window. Use a screen mode with a minimum of 16 colours for best results.

  Curses Options

-left
    Use columns 0 to 39.

-central
    Use columns 20 to 59.

-right
    Use columns 40 to 79.

-wide1
    Use columns 0 to 79. In this mode only the even character positions are used. The odd locations are filled with spaces.

-wide2
    Use columns 0 to 79. This mode is similar to -wide1 except that the spaces are in reverse video if the previous character was also in reverse video.

FILES

/usr/local/lib/atari/atariosa.rom
    Atari O/S A

/usr/local/lib/atari/atariosb.rom
    Atari O/S B

/usr/local/lib/atari/atarixl.rom
    Atari 800 XL O/S

/usr/local/lib/atari/atari5200.rom
    Atari 5200 O/S

/usr/local/lib/atari/ataribas.rom
    Atari Basic

BUGS
A few programs cause the emulator to enter its built in debugger. The reason for this is unknown at the moment.