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: Difference between revisions

From CoCopedia - The Tandy/Radio Shack Color Computer Wiki
Jump to navigation Jump to search
(→‎ROMS: note about corrupt bas10)
No edit summary
Line 1: Line 1:
{{NavEmulators}}
= Configuring 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.
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.


= Downloading =
== Creating a Windows shortcut for a 4K CoCo ==
The latest version can be downloaded from: http://www.6809.org.uk/xroar/
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).


== ROMS ==
1. In Windows Explorer, browse to where you have the xroar.exe.
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.
[[File:XRoar_win_properties.PNG]]


'''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.
2. Right-click on xroar.exe and select "Create Shortcut". This will make a new file called "xroar.exe - Shortcut"


== Windows ==
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:
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.
-ram 4 -bas bas10 -noextbas -nodos


== Mac OS X ==
[[File:XRoar_win_shortcut.PNG]]
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 ==
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.
Anyone want to document that for me? I wll update this when I try it out on my Raspberry Pi - [[User:AllenHuffman|OS-9 Al]] ([[User talk:AllenHuffman|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.


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



Revision as of 16:05, 2 January 2015

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.

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.

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

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