Professional Documents
Culture Documents
Files included
==============
adamem The emulator
cvem A link starting the emulator in ColecoVision mode
adamem.snd The sound data used by the emulator
adamem.txt This file
OS7.rom ColecoVision OS ROM image
WP.rom SmartWRITER ROM image
EOS.rom Elementary Operating System ROM image
keys Program to alter key mappings for game controller #1
CWSDMI.ZIP (MS-DOS version only) A DPMI server required by ADAMEm MS-DOS.
If you don't run ADAMEm MS-DOS in a DPMI environment (OS/2, MS-
Windows, Linux DOSEmu, QDPMI, ...), put CWSDPMI.EXE included in
this archive somewhere in your path or in the emulator's
directory
Some utilities for use with ADAMEm can be found on the ADAMEm distribution
site at http://www.komkon.org/~dekogel/adamem.html
What's emulated
===============
- 4 disk drives
- 4 tape drives
- 1 ADAM printer
- 1 Parallel port
- 1 RAM expander, with a configurable amount of memory.
- 2 ColecoVision game controllers
- (Optional) 1 Roller controller, 1 Driving module, 1 Super Action
controller
Key Mappings
============
ADAM keyboard:
F1-F6 - Smart keys
F7 - WILD CARD
F8 - UNDO
Insert - INSERT
Delete - DELETE
Home - MOVE/COPY
End - STORE/GET
Page Up - CLEAR
Page Down - PRINT
Keypad 5 - HOME
ColecoVision game controllers:
Cursor keys - Joystick movement
Left Alt (Space in - Primary firing button
Unix/X version)
Left Ctrl - Secondary firing button
Left Shift - Third firing button (port 1)
Z - Fourth firing button (port 1)
NumPad - - Third firing button (port 2)
NumPad + - Fourth firing button (port 2)
0-9, -, = - Numpad 1
0-9, Del, Enter(right) - Numpad 2
Special Keys:
F9 - Toggle joystick/keyboard mode. In joystick
mode, the keyboard is used to emulate the
ColecoVision game controllers. In keyboard
mode, it is used to emulate the ADAM keyboard
F1-F4 - Toggle sound channel 1-4 on/off (Joystick mode
only)
F5 - Toggle sound on/off (Joystick mode only)
F11 - Decrease sound volume
F12 - Increase sound volume
Alt+F9 - Switch between 80 and 40-column mode, if TDOS
is running (MS-DOS only)
Ctrl+F9 - Change options
F7 (Alt+F7 in keyboard - Make snapshot
mode)
F8 (Alt+F8 in keyboard - Make screen shot (Not implemented in Unix/X
mode) version)
Ctrl+F11 - Pause & Blank screen
Ctrl+F12 - Pause
Insert - Switch to joystick emulation mode 1 (Joystick
mode only). For a description of the available
joystick emulation modes, check the description
of the -joystick command line option
Home - Switch to joystick emulation mode 2 (Joystick
mode only)
Page Up - Switch to joystick emulation mode 3 (Joystick
mode only)
Delete - Swap joystick buttons (Joystick mode only)
End - Swap keyboard buttons (Joystick mode only)
Page Down - Swap mouse buttons (Joystick mode only)
Alt+F12 - Main reset lever
Alt+F11 - Cartridge reset lever
F10 - Quit emulator
TDOS
====
TDOS is a freeware CP/M compatible operating system for the Coleco ADAM.
It can run in 40-column mode on an ADAM, or in 80-column mode on 80-column
mode adapters.
ADAMEm does not support 80-column mode adapters. When ADAMEm runs TDOS in
80-column mode, it copies the internal video buffer to the display at
every VDP interrupt. TDOS itself does not know it runs in 80-column mode,
so if you e.g. do a DIR, only half of the screen will be used.
To run TDOS in 80-column mode, you can either use the "-tdos 1" command
line option, or press ALT+F9 when TDOS is running.
Configuration files
===================
The emulator loads two configuration files (if present) before it loads a
cartridge ROM: adamem.cfg or cvem.cfg located in the emulator's directory
and CART.cfg (e.g. DKONG.cfg) located in the cartridge dump's directory.
These are plain text files containing optional command line options.
Options can be separated with spaces, tabs or returns.
History
=======
1.0 23-02-1999 - Replaced sound files and improved sound emulation
- Replaced Marat Fayzullin's Z80 emulation code with
Z80Em. Z80Em is a portable Z80 emulator, written by
myself.
- Improved ADAMNet emulation
- Replaced the colour palette. The palette used in older
versions can still be used with the "-palette 1"
option
- Added parallel port emulation
- Added expansion RAM support
- Added snapshot support
- Added 80-column TDOS support
- Added cheat-code support
- Added reverb and stereo support for SoundBlaster Pro
and SoundBlaster 16 compatibles
- Fixed some minor bugs
0.2 15-11-1996 Completely rewrote VDP emulation engine; it now has
support for sprite clipping, detection of 5th sprite in
a row and non-standard screen modes, added support for
GZIPped disk images, added ADAM printer control code
emulation, added Unix/X and Linux/SVGALib ports, fixed
some bugs
0.1 28-10-1996 Initial release
Credits
=======
- Joe Blenkle, Jim Marshall, Stephen Geyer, Grant Frost and Jim Notini
were of invaluable help getting ADAM software and technical information.
Thanks!
- Todd Aiken spent a lot of time finding bugs, many of which would have
never been fixed without his help. He also helped a lot improving the
sound output
- Martijn Zeedijk tested the GUS routines and helped me fix lots of bugs
- Neal Danner provided me with the sound hardware related technical
information on which the sound emulation code is based
- The SB AWE32 routines are heavily based on 'The Unofficial Sound Blaster
AWE32 Programming Guide' written by Vince Vu a.k.a. Judge Dredd. Thanks
a million for writing this!
- Some parts of the code were taken from Allegro. Allegro is a library for
DJGPP written by Shawn Hargreaves. Allegro is available at
ftp://x2ftp.oulu.fi/pub/msdos/programming/djgpp2
- ADAMEm MS-DOS was compiled using DJ Delorie's DJGPP v2.0. DJGPP is a 32
bit C compiler for MS-DOS. Source code and binaries of DJGPP are
available at http://www.delorie.com