MediaWiki:Sitenotice:
2024-03-02: The wiki ran out of disk space, so things were not working. This has been resolved by adding another 5GB of quota ;-) Thanks to Tim Lindner for reporting the issues. 2020-05-17: If a page gives you an error about some revision not being found, just EDIT the page and the old page should appear in the editor. If it does, just SAVE that and the page should be restored. OS-9 Al (talk) 12:22, 17 May 2020 (CDT)

Using XRoar

From CoCopedia - The Tandy/Radio Shack Color Computer Wiki
Revision as of 15:13, 2 January 2015 by AllenHuffman (talk | contribs) (→‎ROMS: note about corrupt bas10)
Jump to navigation Jump to search
WELCOME
Looking for CoCo help? If you are trying to do something with your old Color Computer, read this quick reference. Want to contribute to this wiki? Be sure to read this first. This CoCo wiki project was started on October 29, 2004. --OS-9 Al

See Recent Changes. | About this site. | Join the E-Mail List or Facebook Group. | Contact me with updates/questions.

This page was last updated on 01/2/2015. Total Pages: 728. Total Files: 992.


Home / Emulators - Using XRoar


XRoar is a cross-platform Dragon/Color Computer emulator. It will emulate everything from a 1980 4K CoCo to a 64K CoCo 2. It does not emulate a CoCo 3. It runs on Windows, Mac OS X, and Linux. It has also been ported to Android, Commodore Amiga, Playstation 3 (PS3), PlayStation Portable (PSP), and various other systems.

Downloading

The latest version can be downloaded from: http://www.6809.org.uk/xroar/

ROMS

You will need to download .rom files for each system you plan to emulate. You can find them at The Dragon Archive: http://archive.worldofdragon.org/archive/index.php?dir=Roms/

In the CoCo section, look for files like "Color Basic v1.X (198X)(Tandy).zip", "Extended Color Basic v1.X (198X)(Tandy).zip" or "Disk Extended Color Basic v1.x (198X)(Tandy).zip". You will need to unzip these files to get to the .rom files inside.

NOTE: It appears the bas10.rom you find there is corrupt. There is another directory on that site with a fixed ROM, and I will post updates to this wiki entry when I know where it is.

Windows

For Windows, you will download a .zip file and extract it in to a directory. Inside you will see "xroar.exe". Copy the .rom files in to this folder, then double-click the xroar.exe to start emulation. Choose the CoCo you want to emulate from the Machine pull down menu and you are set.

Mac OS X

For Mac, you will download a .dmg disk image. Double-click that to open it, then copy the files to a folder on your hard drive (for instance, Applications/XRoar, or even on your Desktop). You will need to make an XRoar folder inside your home folder's Library folder. Copy the ROMs there. (~/Library/XRoar).

Linux

Anyone want to document that for me? I wll update this when I try it out on my Raspberry Pi - OS-9 Al (talk) 08:27, 29 December 2014 (CST)

Configuring XRoar

Depending on the .rom files you have installed, XRoar will start up as some default system (which one?). If you only have "bas10.rom" installed (the original 1980 Color BASIC), it will default to a Color Basic 1.0 machine with 32K memory (maybe 64K?). If you have other .roms installed, it will default to larger systems.

You can use the "Machine" pull-down menu to select the CoCo you wish to emulate. If you wish to create a custom machine, such as an original 1980 4K CoCo, you can either use command-line options when you run the .exe file (or Mac/Linux binary), or create a configuration file (suggested).

Create a plain TEXT file called "xroar.conf" in the same location where you put the .rom files (.exe directory on Windows, ~Library/XRoar on Mac OS X). You can view the xroar.pdf documentation file for details, but here is a short example of the file for a 4K CoCo:

default-machine coco4k
machine coco4k
machine-desc Tandy CoCo 4K
machine-arch coco
ram 4
bas bas10
noextbas
nodos
tv-type ntsc

There are other config options you can add to force it to default to an NTSC (America) machine, or a PAL machine. If you create this file, then run the XRoar program, it will boot up to a 4K CoCo (assuming you have bas10.rom). You will see a "Tandy CoCo 4K" entry in the Machine pull-down menu.

More to come...