Sitenotice: 11/29/2018: The wiki is back. It turns out, some anti-virus product on my web server had an issue with the latest version of PHP. My server techs have resolved this issue, and things should be working again. During the investigation, I did restore to a backup from September. There is a chance that any changes done since then were lost, but I do not recall any edits. --OS-9 Al

8/30/2016: Massive re-work is being done on the InfoBox Templates. Read that page to keep up with the plan for that, and adding better keyword tags (categories) to all the pages. --OS-9 Al (talk) 15:28, 31 August 2016 (CDT)

Using XRoar

From CoCopedia - The Tandy/Radio Shack Color Computer Wiki
Jump to: navigation, 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, Facebook Group or Google+ | Contact me with updates/questions.

This page was last updated on 01/3/2015. Total Pages: 544. Total Files: 907.


Home / Emulators - Using XRoar


Download XRoar

The XRoar CoCo 1/2/Dragon emulator may be downloaded here:

http://www.6809.org.uk/xroar/

It is available for Windows, Mac OS X, Linux and various other platforms. You will also need to download the ROM files for the computer (CoCo, Dragon, Color or Extended BASIC, Disk BASIC, etc.).

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.

The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.

Here are some examples of making XRoar run as a 1980 4K Color Computer (4K RAM, Color BASIC 1.0).

Creating a Windows shortcut for a 4K CoCo

If you have placed the .rom files in the same directory as xroar.exe, you can make a Windows shortcut that will launch it with specific options (see the list in the xroar.pdf documentation).

1. In Windows Explorer, browse to where you have the xroar.exe.

XRoar win properties.PNG

2. Right-click on xroar.exe and select "Create Shortcut". This will make a new file called "xroar.exe - Shortcut"

3. Right-Click on "xroar.exe - Shortcut" and select "Properties". A new window comes up. In the "Target:" box is the path to the .exe file. Edit that by adding to the END of the .exe line the following command line options:

-ram 4 -bas bas10 -noextbas -nodos

XRoar win shortcut.PNG

4. Click "OK" to save this shortcut. Now you can rename the shortcut to whatever you like, such as "4K CoCo", and move the shortcut anywhere you like (such as the Desktop) and when you double-click it, it should open XRoar with those options as a 4K CoCo.

Adding a 4K entry to the Machine pull-down menu

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