--- name: "atari800.sdl" section: "1" platform: "linux" package: "atari800" version: "2.1.0-2" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/atari800" --- # atari800.sdl(1) Atari 800 Emulator, Version 2.1.0 Part of [atari800(1)](/atari800/1.md). ## NAME atari800 - Atari 800 Emulator, Version 2.1.0 ## SYNOPSIS **atari800** \[options\] \[files...\] ## DESCRIPTION *atari800* emulates the Atari 800, Atari 800 XL, Atari 130 XE and Atari 5200 Games System. ### Options - **-help** **Print complete and up-to-date list of command line switches** - **-v** **Print emulator version** - **-verbose** **Display framerate when exiting** - **-config filename** **Specify an alternative configuration filename** - **-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 filename** **Path to file containing Atari XL/XE Operating System.** **Used to override paths defined at compile time.** - **-5200\_rom filename** **Path to file containing Atari 5200 Games System ROM.** **Used to override paths defined at compile time.** - **-basic\_rom filename** **Path to file containing Atari BASIC ROM.** **Used to override paths defined at compile time.** - **-atari** **Emulate Atari 800** - **-xl** **Emulate Atari 800 XL** - **-xe** **Emulate Atari 130 XE** - **-320xe** **Emulate Atari 320 XE (Compy Shop)** - **-rambo** **Emulate Atari 320 XE (Rambo)** - **-5200** **Emulate Atari 5200** - **-emuos** **Use EmuOS** - **-a** **Use Atari OS/A for Atari 800** - **-b** **Use Atari OS/B for Atari 800** - **-c** **Enable RAM between 0xc000 and 0xcfff in Atari 800** - **-axlon \** **Use Atari 800 Axlon memory expansion: \ k total RAM** - **-axlon0f** **Use Axlon shadow at 0x0fc0-0x0fff** - **-mosaic \** **Use 400/800 Mosaic memory expansion: \ k total RAM** - **-pal** **Emulate PAL TV mode** - **-ntsc** **Emulate NTSC TV mode** - **-nobasic** **Used to disable Basic when starting the emulator in XL/XE mode.** **Simulates the Option key being held down during system boot.** - **-basic** **Turn on Atari BASIC ROM** - **-cart \** **Insert cartridge (CART or raw format)** - **-run \** **Run Atari program (EXE, COM, XEX, BAS, LST)** - **-state \** **Load saved-state file** - **-tape \** **Attach cassette image (CAS format or raw file)** - **-boottape \** **Attach cassette image and boot it** - **-1400** **Emulate the Atari 1400XL** - **-xld** **Emulate the Atari 1450XLD** - **-bb** **Emulate the CSS Black Box** - **-mio** **Emulate the ICD MIO board** - **-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.** - **-nopatchall** **Don't patch OS at all, H:, P: and R: devices won't work** - **-H1 \** **Set path for H1: device** - **-H2 \** **Set path for H2: device** - **-H3 \** **Set path for H3: device** - **-H4 \** **Set path for H4: device** - **-Hpath \** **Set path for Atari executables on the H: device** - **-hreadonly** **Enable read-only mode for H: device** - **-hreadwrite** **Disable read-only mode for H: device** - **-devbug** **Put debugging messages for H: and P: devices in log file** - **-rtime** **Enable R-Time 8 emulation** - **-nortime** **Disable R-Time 8 emulation** - **rdevice \[\\]** **Enable R: device. If \ is specified then it's used as host serial device** **name (e.g. /dev/ttyS0 on linux). If there is no \ specified then R:** **is directed to network.** - **-mouse off** **Do not use mouse** - **-mouse pad** **Emulate paddles** - **-mouse touch** **Emulate Atari Touch Tablet** - **-mouse koala** **Emulate Koala Pad** - **-mouse pen** **Emulate Light Pen** - **-mouse gun** **Emulate Light Gun** - **-mouse amiga** **Emulate Amiga mouse** - **-mouse st** **Emulate Atari ST mouse** - **-mouse trak** **Emulate Atari Trak-Ball** - **-mouse joy** **Emulate joystick using mouse** - **-mouseport \** **Set mouse port 1-4 (default 1)** - **-mousespeed \** **Set mouse speed 1-9 (default 3)** - **-multijoy** **Emulate MultiJoy4 interface** - **-directmouse** **Use mouse's absolute position** - **-cx85 \** **Emulate CX85 numeric keypad on port \** - **-grabmouse** **SDL only, prevent mouse pointer from leaving the window** - **-record \** **Record all input events to \. Can be used for gaming contests** **(highest score etc).** - **-playback \** **Playback input events from \. Watch an expert play the game.** - **-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.** - **-artif \** **Set artifacting mode 0-4 (0 = disable)** - **-paletten/p \** **Read Atari NTSC/PAL colors from ACT file** - **-blackn/p \** **Set NTSC/PAL black level 0-255** - **-whiten/p \** **Set NTSC/PAL white level 0-255** - **-colorsn/p \** **Set NTSC/PAL color intensity** - **-genpaln/p** **Generate artifical NTSC/PAL palette** - **-colshiftn/p \** **Set color shift (-genpal only)** - **-screenshots \** **Set filename pattern for screenshots. Use to override the default** **atari000.png, atari001.png etc. filenames. Hashes are replaced with** **raising numbers. Existing files are overwritten only if all the files** **defined by the pattern exist.** - **-showspeed** **Show percentage of actual speed** - **-sound** **Enable sound** - **-nosound** **Disable sound** - **-dsprate \** **Set mixing frequency (Hz)** - **-snddelay \** **Set sound delay (milliseconds)** ### 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.** ### Falcon Options - **-interlace \** **Generate Falcon screen only every x frame** - **-videl** **Direct VIDEL programming (Falcon/VGA only)** - **-double** **Double the screen size on NOVA** - **-delta** **Delta screen output (differences only)** - **-joyswap** **Swap joysticks** ### Java NestedVM - **-scale \** **Scale width and height by \** ### SDL Options - **-fullscreen** **Start in fullscreen mode (tries to switch to 336x240 resolution)** - **-windowed** **Start in a window (does not change your working resolution)** - **-rotate90** **Run the emulator with rotated display (useful for devices with 240x320** **screen)** - **-width number-of-pixels** **Host horizontal resolution for fullscreen** - **-height number-of-pixels** **Host vertical resolution for fullscreen** - **-bpp number-of-bits** **Host color depth for running in fullscreen** - **-audio16** **Enable 16-bit sound output** - **-nojoystick** **Do not initialize SDL joysticks** - **-joy0 path-to-device** **Define path to device used in LPTjoy 0. Available on linux-ia32 only.** - **-joy1 path-to-device** **Define path to device used in LPTjoy 1. Available on linux-ia32 only.** - **-ntscemu** **Emulate NTSC composite video (640x480x16 only)** **This includes NTSC TV artifacts. "-artif" is not needed in this mode and will** **not work. This mode does not use a palette. The video signal is emulated** **instead. Palette options such as -genpaln have no effect in this mode.** **The following items are for -ntscemu only:** - **-ntsc\_hue \** **Set NTSC hue -1..1 (like TV Tint control)** - **-ntsc\_sat \** **Set NTSC saturation (like TV Colour control)** - **-ntsc\_cont \** **Set NTSC contrast (also called white level)** - **-ntsc\_bright \** **Set NTSC brightness (also called black level)** - **-ntsc\_sharp \** **Set NTSC sharpness** - **-ntsc\_burst \** **Set NTSC burst phase (artificating colours) (CTIA?) Drol, Choplifter,** **Ultima: 0.70** - **-ntsc\_gauss \** **Set NTSC Gaussian factor (can affect artifacting colours, sharpness and** **ghosting)** - **-ntsc\_gamma \** **Set NTSC gamma adjustment** - **-ntsc\_ramp \** **Set NTSC saturation ramp factor (amount by which bright colours become** **desaturated or washed out)** - **-scanlines \** **Set scanlines percentage (ntscemu only)** - **-scanlinesnoint** **Disable scanlines interpolation (ntscemu only)** - **-proto80** **Emulate a prototype 80 column board for the 1090** - **-xep80** **Emulate the XEP80** - **-xep80port \** **Use XEP80 on joystick port \** ### X11 Options - **-small** **Run 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** **Set left offset for clipping** - **-clip\_width number-of-pixels** **Set the width of the clipping-area** - **-clip\_y number-of-pixels** **Set top offset for clipping** - **-clip\_height number-of-pixels** **Set the height of the clipping-area** - **-private\_cmap** **Use private colormap** - **-sio** **Show SIO monitor** - **-x11bug** **Enable debug code in atari\_x11.c** - **-keypad** **Keypad mode** ## KEYBOARD, JOYSTICK AND OTHER CONTROLLERS - **F1** **Built in user interface** - **F2** **Option key** - **F3** **Select key** - **F4** **Start key** - **F5** **Reset key ("warm reset")** - **Shift+F5** **Reboot ("cold reset")** - **F6** **Help key (XL/XE only)** - **F7** **Break key** - **F8** **Enter monitor** - **F9** **Exit emulator** - **F10** **Save screenshot** - **Shift+F10** **Save interlaced screenshot** - **Alt+R** **Run Atari program** - **Alt+D** **Disk management** - **Alt+C** **Cartridge management** - **Alt+Y** **Select system** - **Alt+O** **Sound settings** - **Alt+W** **Sound recording start/stop** - **Alt+S** **Save state file** - **Alt+L** **Load state file** - **Alt+A** **About the emulator** - **Insert** **Insert line (Atari Shift+'\>')** - **Ctrl+Insert** **Insert character (Atari Ctrl+'\>')** - **Shift+Ctrl+Insert** **Shift+Ctrl+'\>'** - **Delete** **Delete line (Atari Shift+Backspace)** - **Shift+Backspace** **Delete line (Atari Shift+Backspace)** - **Ctrl+Delete** **Delete character (Atari Ctrl+Backspace)** - **Ctrl+Backspace** **Delete character (Atari Ctrl+Backspace)** - **Shift+Ctrl+Delete** **Shift+Ctrl+Backspace** - **Shift+Ctrl+Backspace** **Shift+Ctrl+Backspace** - **Home** **Clear (Atari Shift+'\<')** - **Ctrl+Home** **Ctrl+'\<' (also clears screen)** - **Shift+Ctrl+Home** **Shift+Ctrl+'\<'** - **~** **Inverse video** - **Up** **Up (Atari Ctrl+'-')** - **Down** **Down (Atari Ctrl+'=')** - **Left** **Left (Atari ctrl+'+')** - **Right** **Right (Atari ctrl+'\*')** - **Ctrl+Up** **-** - **Ctrl+Down** **=** - **Ctrl+Left** **+** - **Ctrl+Right** **\*** - **Shift+Up** **\_ (Atari Shift+'-')** - **Shift+Down** **\| (Atari Shift+'=')** - **Shift+Left** **(Atari Shift+'+')** - **Shift+Right** **^ (Atari Shift+'\*')** - **Shift+Ctrl+Up** **Shift+Ctrl+-** - **Shift+Ctrl+Down** **Shift+Ctrl+=** - **Ctrl+'\\'** **Ctrl+Esc (Workaround for Windows)** - **Shift+Ctrl+'\\'** **Shift+Ctrl+Esc (Workaround for Windows)** **CX85 Keypad (if enabled):** - **host keypad 0123456789-.** **0123456789-.** - **host keypad /** **NO** - **host keypad Ctrl+/** **ESCAPE** - **host keypad \*** **DELETE** - **host keypad +** **YES** - **host keypad Enter** **+ENTER** **Paddles, Atari touch tablet, Koala pad, light pen, light gun,** **ST/Amiga mouse, Atari trak-ball, joystick and Atari 5200 analog** **controller are emulated using mouse on ports that support it.** **See the options above for how to enable mouse.** ### Basic **No function keys or Alt+letter shortcuts.** **Use Ctrl+C to enter the monitor.** **Controllers not supported in this version.** ### Curses **F10 (Save screenshot) does not work in the default CURSES\_BASIC build.** **Shift+F5 and Shift+F10 don't work at all.** **Avoid Ctrl + C, H, J, M, Q, S and Z. The remaining control characters** **can be typed. Control characters are displayed on the screen** **with the associated upper case character in bold.** **Controllers not supported in this version.** ### Falcon - **Help** **Help key (XL/XE)** **Joystick 0 is operated by the numeric keypad (make sure that the numeric** **keypad has been enabled).** **7 8 9**\ **\\\|/**\ **4 5 6**\ **/\|\\**\ **1 2 3** **And 0 is the fire key.** **Mouse not supported in this version.** ### SDL - **\`** **Atari/Inverse key** - **LSUPER** **Atari/Inverse key (unusable under Windows)** - **RSUPER** **CapsToggle (+Shift = CapsLock)** - **LAlt+F** **Switch fullscreen (probably doesn't work in Windows)** - **LAlt+G** **Switch WIDTH\_MODE (so you can set 320x240)** - **LAlt+B** **Switch BLACK-AND-WHITE** - **LAlt+J** **Swap keyboard\_emulated joysticks** - **LAlt+E** **Switch bpp (for debug only, will be removed soon)** - **LAlt+M** **Grab mouse (prevents mouse pointer from leaving the window)** **These keys work with the NTSC composite video emualtion (-ntscemu):** **(This interface should be considered experimental and is subject to change)** - **LAlt+1** **Decrease NTSC sharpness** - **LAlt+2** **Increase NTSC sharpness** - **LAlt+3** **Decrease NTSC saturation (like TV Colour control)** - **LAlt+4** **Increase NTSC saturation** - **LAlt+5** **Decrease NTSC brightness (also called black level)** - **LAlt+6** **Increase NTSC brightness** - **LAlt+7** **Decrease NTSC contrast (also called white level)** - **LAlt+8** **Increase NTSC contrast** - **LAlt+9** **Decrease NTSC burst phase (use this to change artifacting colours)** - **LAlt+0** **Increase NTSC burst phase** - **LAlt+-** **Decrease NTSC Gaussian factor (ghosting, sharpness, artif colours)** - **LAlt+=** **Increase NTSC Gaussian factor (ghosting, sharpness, artif colours)** - **LAlt+\[** **Decrease scanlines percentage (NTSC mode only)** - **LAlt+\]** **Increase scanlines percentage (NTSC mode only)** - **LAlt+;** **Decrease NTSC hue (like TV Tint control)** - **LAlt+'** **Increase NTSC hue (like TV Tint control)** - **LAlt+Ins** **Decrease NTSC saturation ramp(reduce saturation for bright colours)** - **LAlt+Ins** **Increase NTSC saturation ramp(reduce saturation for bright colours)** - **LAlt+Shift+X** **Enable/disable XEP80 screen (use with -xep80)** **Apart from standard joysticks (handled by the SDL) up to two keyboard joysticks** **are supported. The keys used for joystick directions and the trigger can be** **freely defined in the config UI (Controller Config -\> Define layout).** **Keyboard joystick emulation can be enabled/disabled in the Controller Config.** **By default, joy 0 is enabled and joy 1 is disabled (to not steal normal** **AWDS keys in the emulator).** ### X11 - **Alt** **Atari key (either Alt key will work)** **Joystick 0 is operated by the mouse position relative to the center of** **the screen. The mouse button acts as the trigger. On Linux, standard** **joysticks are also supported.** ## FILES - */usr/share/atari800/ATARIOSA.ROM* Atari O/S A - */usr/share/atari800/ATARIOSB.ROM* Atari O/S B - */usr/share/atari800/ATARIXL.ROM* Atari 800 XL O/S - */usr/share/atari800/ATARI5200.ROM* Atari 5200 O/S - */usr/share/atari800/ATARIBAS.ROM* Atari Basic ## BUGS See the BUGS file.