By Pierre Sarrazin
Last update: 2017-07-03
The information on this page can be republished elsewhere without restriction.
This page gives practical procedures to install and run an emulator for the Tandy Color Computer (1, 2 or 3) under a GNU/Linux operating system.
MESS is part of MAME, the arcade emulator. The source code for both, as of version 0.158, is contained in mame0158.zip. This version requires SDL2, for which there are apparently no precompiled packages for Ubuntu 12.04, so I compiled it from sources, as explained below.
While MESS 0.152 used version 1.x of SDL, MESS 0.158 uses SDL2 and SDL2_ttf.
If your GNU/Linux distribution provides precompiled SDL2 and SDL2_ttf packages, you should try them first. As of February 2015, I had not found such packages for Ubuntu 12.04, so I installed them from the sources. Here is what worked for me:
If SDL2 was installed from sources, MESS's makefile must be told where it was installed. This is done with this command, to allow make to find the sdl2-config command:
Then, edit the "makefile" file and add a -I directive for SDL2 to the INCPATH variable (be sure to end the new line with a backslash):
INCPATH += \ -I/usr/local/SDL2-2.0.3/include \ -I$(SRC)/$(TARGET) \
To compile on a 64-bit system, go to the MESS compilation directory (the one that contains messnew.txt) and give the following command:
make TARGET=mess OSD=sdl TARGETOS=linux PTR64=1
On a 32-bit system, omit
The executable will be named "mess64" on a 64-bit system
and "mess" on a 32-bit system.
(To determine if you have a 64-bit system, run the
command: a 64-bit system will say "x86_64", while a 32-bit system will
typically say "i686".)
Expect the compilation to require several minutes.
You can pass the -jN flag to
the make command if your computer has
N processor cores.
To determine the number of cores, give this command:
grep -w ^processor /proc/cpuinfo | wc -l
You need to find the coco3.rom file, and optionally the disk11.rom, which provides Disk Basic. They must be put in a directory called coco3, which itself must be put in a general MESS roms directory, for example ~/roms. In this instance, there would be these two files:
Here are the MD5 sums for the files I use (using the md5sum command):
Assuming that MESS should be allowed to use the ~/coco directory to write its configuration files, and that the ROM files are stored in a directory called ~/roms, then give this command to run the CoCo 3 emulator on a 64-bit system:
./mess64 -window -cfg_directory ~/coco -biospath ~/roms coco3
On a 32-bit system, replace ./mess64 with ./mess.
If you have .dsk disk image files, you can tell the emulator to use them by adding "-flop1 foo.dsk" to the previous command line, where foo.dsk is the actual name of your image file.
Read the docs/config.txt in the MESS source directory to learn the keyboard commands that control the emulation.
Configuration menus are avaiable while running the emulation. To bring up the main menu, type Scroll Lock, then Tab.
The Scroll Lock key switches between the "full" and "partial" keyboard emulation modes. The idea here is to switch to partial mode, because it is the mode where MESS interprets Tab as the menu command. Otherwise, in full mode, the Tab key gets sent to the emulated machine. In the CoCo 3 case, that does nothing. To produce a tab character (ASCII 9) on the emulated CoCo, use the right arrow key instead.
The MESS documentation explains how to tell MESS to use a key other than Scroll Lock, which is useful on laptops that do not have that key. An alternative is to start MESS with -ui_active, which starts the emulation in the partial mode.
on a PC
" Shift 2 & Shift 6 ' Shift 7 ( Shift 8 ) Shift 9 * Shift ; + Shift NumPad+ / NumPad/ \ Shift Home : ; ; NumPad+ = Shift - ? Shift / or Shift NumPad/ @ NumPad* [ Shift down arrow ] Shift right arrow ↑ (ASCII 94) ↑ ← (ASCII 95) Shift ↑ CLEAR Home BREAK End kill line Shift ← pause Shift NumPad*
Version 0.158 of MESS supports the Becker port. The "Becker Port" entry in the System Configuration should say "On", and the "Drivewire Server TCP Port" entry should say 65504. See the DW4 Installation Guide for more on this.
DriveWire4 should be installed following the DW4 Installation Guide.
After the installation, go to the directory that contains
and give the command
The main DriveWire window should appear after a few seconds.
Go to Config menu and use the Simple Config Wizard. Choose Emulator or other TCP/IP, server mode, port 65504, MIDI and printer options do not matter (to me at least), then Finish.
Choose a 35-track disk image that you want to access through DriveWire. Mount it in DriveWire by taking the context menu of row 0 of the upper grid, then choose Insert disk for drive 0. After choosing a .dsk file, the path of this file should appear in row 0 of the grid and the Filesystem column should say DECB.
HDB-DOS is a version of DECB that supports DriveWire and the Becker port. (This guide does not cover NitrOS-9.)
-flop1 hdbdos.dsk(in addition to the usual options of your choice)
HDB-DOS 1.4 BECKER COCO 2".
DIR: you should see a listing of the disk image you mounted in the DriveWire server. If you get ?IO ERROR, you are probably not running the right version of HDB-DOS.
See the general HDB-DOS and DriveWire documentation for more details.
XRoar is another CoCo emulator, but as of 2015, it only emulates the CoCo 1 and 2, not the CoCo 3. It also emulates the Dragon, which was a clone of the Color Computer.
It is a much smaller program which also has the advantage of being free software distributed under the GNU General Public License.
If you want the GTK+ interface, the GTK+ and GtkGLExt libraries are needed. On my Ubuntu 11.04 system, I installed them this way:
sudo apt-get install libgtkgl2.0-dev libgtkglext1-dev
Give this command to prepare the compilation:
The --prefix option is only needed if one wants to properly install the program, which is not needed to run it. The path prefix used here is just an example.
To have the GTK+ interface, these lines should have appeared:
Checking for GTK+-2 ... yes
Checking for GtkGLExt ... yes
Also, these two lines should appear in config.h:
To compile the program under my Fedora 16 GNU/Linux system, I had to give this command to (1) avoid a linking error concerning "powf@@GLIBC_2.0" and (2) to avoid a makeinfo error ("xroar.texi:607: warning: unlikely character [ in @var") when compiling the documentation:
make LDLIBS=-lm SUBDIRS="portalib src"
The SUBDIRS makefile variable normally lists "doc" as its last element. The command above just avoids compiling the documentation. On my Ubuntu 12.04 system, no arguments were needed for the make command. The compilation should take around 20 seconds.
To check that the GTK+ interface has been compiled in, run
src/xroar -ui help
and check that a "gtk2" line is printed.
(If the "xroar" executable is not in "src", it may be in the
Three ROM files are needed to boot into Disk Extended Color Basic. Their MD5 sums are the following:
The disk11.rom file here is the same one used under MESS.
These files should go in directory ~/.xroar/roms (create it if not already done).
I start XRoar with the following command, assuming the "xroar" executable and the ROM files are in the current directory:
./xroar -machine cocous -ao sdl
The "-ao sdl" option tells XRoar to use SDL for the sound.
If the ROM files are not in the standard directory (~/.xroar/roms), their path can be specified on the command line like in the following example, where the files are in the current directory:
./xroar -machine cocous -ao sdl -bas ./bas13.rom -extbas ./extbas11.rom -cart ./disk11.rom
If XRoar starts with a screen containing mostly orange rectangles and "@" characters, it is typically because it has not found the ROM files. Check the contents of ~/.xroar/roms, and/or the -bas, -extbas and -cart options and their arguments.
Holding F12 in XRoar will cause it to run the emulation at the maximum possible speed. The XRoar manual specifies other keyboard commands.
To emulate the CoCo PMODE 4 artifact colors, pass the
-tv-type ntsc command-line option.
To use the
French Canadian keyboard,
-keymap fr_CA option.
Find the bas10.rom file, put it in the same directory as bas13.rom, then add these options to XRoar:
-noextbas -nodos -bas bas10.rom -ram 4
Here is the MD5 sum of the Color Basic 1.0 ROM file:
The following instructions work with XRoar 0.34.7:
-cart-autorun -cart EXAMPLE.rom
Expect a delay of about 3 seconds before the program starts running. This is due to Color Basic testing the RAM one byte at a time to find the end of the available RAM. (This delay also occurs without a cartridge.)
Pass the -cart-becker option to XRoar. See the section on the Becker port for programming details.
To create a Disk Basic 35 track disk image file in raw format, use this command in a shell:
perl -e 'print chr(255) x (35*18*256)' > somename.dsk
Such an image file is usable in MESS with the "-flop1 somename.dsk" option, and in XRoar with the "-disk-write-back -load somename.dsk" options.
In both emulators, write operations to the emulated disk are reflected in the .dsk file.
MESS and XRoar can both connect to a program that listens for TCP/IP connections on port 65504 or the machine the emulator runs on. They make that connection when started, so the TCP/IP server must be started before the emulator.
On the emulated CoCo, a byte written to $FF42 will be sent to the TCP/IP server. This server can send data on the connection: the CoCo must first check bit 1 of $FF41 to check if any data is present. If it is set, reading $FF42 gets the next available byte.
In late 2014, Richard Goedeken published DynoSprite, a full-featured video game engine for the CoCo 3.
By following the README file, I was able to compile it and run the demo, but at first, the compilation failed. The options passed to ffmpeg were not accepted by that command: I got an "Unrecognized option 'af'" error message. My system at that time (early Dec. 2014) had version 0.8.16-4:0.8.16-0ubuntu0.12.04.1 of ffmpeg.
The command aimed to convert a 44100 Hz 16-bit .wav file into a 6000 Hz 8-bit .raw file. Because my system has the sox command, I edited makefile to replace this line:
ffmpeg -v warning -i $< -acodec pcm_u8 -f u8 -ac 1 -ar $(AUDIORATE) -af aresample=$(AUDIORATE):filter_size=256:cutoff=1.0 $@
with this one:
sox $< -r $(AUDIORATE) -c 1 -u -1 $@
Then the make all command succeeded and produced a .dsk image that ran correctly in MESS 0.152, with sound.
After allowing Ubuntu's Update Manager to update from packages, I started getting errors of the following type from MESS 0.158 and MAME 0.145 (but not from MESS 0.152):
X Error of failed request: BadWindow (invalid Window parameter) Major opcode of failed request: 137 (NV-GLX) Minor opcode of failed request: 4 () Resource id in failed request: 0x4800002 Serial number of failed request: 90 Current serial number in output stream: 90
Similarly, XRoar 0.32 started giving me this error (when using the GTK+ interface):
The error was 'BadWindow (invalid Window parameter)'. (Details: serial 237 error_code 3 request_code 137 minor_code 4) (Note to programmers: normally, X errors are reported asynchronously; that is, you will receive the error a while after causing it. To debug your program, run it with the --sync command line option to change this behavior. You can then get a meaningful backtrace from your debugger if you break on the gdk_x_error() function.)
What resolved this was to reinstall the Nvidia driver (which are unfortunately required to get a 1280x1024 desktop instead of just 1024x768). I did this:
My original mistake was to choose a graphics card without checking if it would force me to use a fragile, proprietary driver to use the card's maximum resolution. I have had other problems with this driver after a kernel update. They are discussed in this Ask Ubuntu thread.
This is under Ubuntu 12.04 in March 2015. I ended up with kernel 3.8.0-44-generic. The PC is an x86_64. Its graphics card is a GeForce GT 630 Rev. 2 purchased in Fall 2013.