xroar man page

xroar — Dragon and Tandy CoCo 1/2 emulator

Synopsis

xroar [-c conffile] [OPTION]... [FILENAME]...

Description

xroar is a Dragon emulator that runs on a wide variety of platforms. Due to hardware similarities, XRoar also emulates the Tandy Colour Computer (CoCo) models 1 & 2.

Options

Options are first read from a configuration file (by default, $HOME/.xroar/xroar.conf). Options on the command line override any found in the configuration file.

-c conffile
specify a configuration file

Machines

-default-machine name
default machine on startup
-machine name
configure named machine (-machine help for list)

The remaining options configure the currently selected machine:

-machine-desc text
machine description
-machine-arch arch
machine architecture (dragon64, dragon32 or coco)
-machine-keyboard layout
keyboard layout (dragon, dragon200e or coco)
-machine-cpu cpu
machine CPU (6809 or 6309)
-bas name
BASIC ROM to use (CoCo only)
-extbas name
Extended BASIC ROM to use
-altbas name
64K mode Extended BASIC ROM (Dragon 64)
-nobas
disable BASIC
-noextbas
disable Extended BASIC
-noaltbas
disable 64K mode Extended BASIC
-ext-charset name
external character generator ROM to use
-tv-type type
TV type (pal, ntsc or pal-m)
-vdg-type type
VDG type (6847 or 6847t1)
-ram kbytes
amount of RAM in K
-machine-cart name
default cartridge for selected machine
-nodos
don't automatically pick a DOS cartridge

Cartridges

-cart name
configure named cartridge (-cart help for list)

The remaining options configure the currently selected cartridge:

-cart-desc text
cartridge description
-cart-type type
cartridge base type (rom, dragondos, delta, rsdos, orch90, mpi or ide
-cart-rom name
ROM image to load ($C000-)
-cart-rom2 name
second ROM image to load ($E000-)
-cart-autorun
autorun cartridge
-cart-becker
enable becker port where supported

Becker port

-becker
prefer becker-enabled DOS (when picked automatically)
-becker-ip address
address or hostname of DriveWire server [127.0.0.1]
-becker-port port
port of DriveWire server [65504]

Files

-load file
load or attach file
-run file
load or attach file and attempt autorun

Cassettes

-tape-write file
open file for tape writing
-tape-channel-mode mode
select stereo input channel (mix, left, right)
-no-tape-fast
disable fast tape loading
-tape-pad
force tape leader padding
-no-tape-pad-auto
disable automatic leader padding
-tape-rewrite
enable tape rewriting
-tape-ao-rate hz
set tape writing frame rate

Disks

-disk-write-back
default to enabling write-back for disk images
-no-disk-auto-os9
don't try to detect headerless OS-9 JVC disk images

Firmware ROM images

-rompath path
ROM search path (colon-separated list)
-romlist name=list
define a ROM list
-romlist-print
print defined ROM lists
-crclist name=list
define a ROM CRC list
-crclist-print
print defined ROM CRC lists
-force-crc-match
force per-architecture CRC matches

User interface

-ui module
user-interface module (-ui help for list)

Video

-vo module
video module (-vo help for list)
-fs
start emulator full-screen if possible
-fskip frames
frameskip (default: 0)
-ccr renderer
cross-colour renderer (simple, 5bit or simulated)
-gl-filter filter
OpenGL texture filter (auto, nearest or linear)
-geometry wxh+x+y
initial emulator geometry
-invert-text
start with text mode inverted

Audio

-ao module
audio module (-ao help for list)
-ao-device string
device to use for audio module
-ao-format fmt
set audio sample format (u8, s8, s16, s16se, s16be, s16le or float)
-ao-rate hz
set audio frame rate (if supported by module)
-ao-channels n
set number of audio channels, 1 or 2
-ao-fragments n
set number of audio fragments
-ao-fragment-ms ms
set audio fragment size in ms (if supported)
-ao-fragment-frames n
set audio fragment size in samples (if supported)
-ao-buffer-ms ms
set total audio buffer size in ms (if supported)
-ao-buffer-frames n
set total audio buffer size in samples (if supported)
-volume volume
audio volume (0 - 100)
-fast-sound
faster but less accurate sound

Keyboard

-keymap code
host keyboard type (-keymap help for list)
-kbd-translate
enable keyboard translation
-type string
intercept ROM calls to type string into BASIC

Joysticks

-joy-right name
map right joystick
-joy-left name
map left joystick
-joy-virtual name
specify the 'virtual' joystick to cycle [kjoy0]
-joy name
configure named joystick (-joy help for list)

The remaining options configure the currently selected joystick:

-joy-desc text
joystick description
-joy-axis axis=spec
configure joystick axis
-joy-button btn=spec
configure joystick button

Printing

-lp-file file
append printer output to file
-lp-pipe command
pipe printer output to command

Debugging

-gdb
enable GDB target
-gdb-ip address
address of interface for GDB target [127.0.0.1]
-gdb-port port
port for GDB target to listen on [65520]
-trace
start with trace mode on
-debug-ui flags
UI debugging (see manual, or -1 for all)
-debug-file flags
file debugging (see manual, or -1 for all)
-debug-fdc flags
FDC debugging (see manual, or -1 for all)
-debug-gdb flags
GDB target debugging (see manual, or -1 for all)
-v, --verbose level
general debug verbosity (0 to 3) [1]
-q, --quiet
equivalent to --verbose 0
-timeout s
run for s seconds then quit
-timeout-motoroff s
quit s seconds after tape motor switches off
-snap-motoroff file
write a snapshot each time tape motor switches off

Other options

-config-print
print configuration to standard out
-config-print-all
print configuration to standard out, including defaults
-h, --help
display help and exit
-V, --version
output version information and exit

Files

$HOME/.xroar/xroar.conf

Author

Ciaran Anscomb <xroar@6809.org.uk>

Info

Aug 2016 XRoar 0.34.5