Reference

atari800.svgalib(1)

Atari 800 Emulator, Version 0.8.1

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

-clip_x number-of-pixels

Sets left offset for clipping.

-clip_width number-of-pixels

Sets the width of the clipping-area.

-clip_y number-of-pixels

Sets top offset for clipping.

-clip_height number-of-pixels

Sets the height of the clipping-area.

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

History

-clip_height since Debian 3.0 (Woody); -clip_width since Debian 3.0 (Woody); -clip_x since Debian 3.0 (Woody); -clip_y since Debian 3.0 (Woody); -private_cmap since Debian 2.0 (Hamm).

-ffp until Debian 1.3 (Bo).