ATARI800(1)

NAME
atari800 - Atari 800 Emulator, Version 0.4.5

SYNOPSIS
atari800 [options] [diskfiles...]

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

  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!

-ffp
    Replace standard floating point with a set of fast floating point routines implemented within the emulator without using 6502 CPU emulation.

-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.

-rom
    The following file is a standard 8K ROM cartridge.

-rom16
    The following file is a standard 16K ROM cartridge.

-ags32
    The following file is a 32 ROM cartridge for the Atari 5200 Games System.

-oss
    The following file is an OSS super-cartridge.

-db The following file is a DB super-cartridge.

-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.

-countdown
    Controls the number of instructions that are executed in the vertical blank period. The default value is 4000.

  SVGALIB Options

-sound
    Enable sound using the Network Audio System.

-interlace
    Enable screen interlace option

  X Window Options

-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. Antic Modes 2, 3 and f display two true colours and not one colour with two luminances. Should this be called a bug or feature, and should it be corrected?