******* M2000 *******
The Portable P2000 Emulator
Version 0.6
Copyright (C) 1996,1997 Marcel de Kogel
Hardware Requirements
=====================
MS-DOS version:
A 386DX-40 (486DX-33 recommended)
A VGA compatible video card
PC Speaker, SoundBlaster and joystick supported
Linux/SVGALib version:
A 486DX-33 (486DX-66 recommended)
A VGA compatible video card
Sound and joystick drivers supported
Unix/X version:
A 486DX-66 or DEC Alpha-150
An X-Windows server running in 8, 16 or 32 bpp mode
USS(/Lite) sound system and Linux joystick driver supported
Files included
==============
m2000 The emulator
M2000.txt This file
Default.fnt SAA5050 font
P2000ROM.bin P2000 ROM image
BASIC.bin BASIC cartridge ROM image (v. 1.1NL)
CWSDMI.ZIP (MS-DOS version only) A DPMI server required by M2000 MS-
DOS
Some utilities for use with M2000 can be found on the M2000 distribution
site at http://www.komkon.org/~dekogel/m2000.html
What's emulated
===============
- P2000T or P2000M model (P2000M emulation is buggy)
- Support for 1 ROM cartridge
- User-definable amount of RAM
- One tape drive
- Sound through PC Speaker or SoundBlaster (MS-DOS version), or
USS(/Lite) /dev/dsp (Linux/SVGALib and Unix/X versions)
- SAA5050 character rounding emulated in high resolution mode
Key Mappings
============
Cursor Keys, - Movement
Alt/Ctrl
Delete - < >
` ~ - CODE
Special Keys
============
F4 - Toggle tracing on/off (Debugging version only)
F5 - Toggle sound on/off
F11 - Decrease sound volume
F12 - Increase sound volume
F6 - Change options
F7 - Make screen shot (Not implemented in the Unix/X version)
F8 - Pause & Blank screen
F9 - Pause
ESC/F10 - Quit emulator
Command line options
====================
-trap <address> Trap execution when PC reaches specified address [-
1] (Debugging version only)
-help Print a help page describing all available command
line options
-verbose <level> Select debugging messages [1]
0 - Silent 1 - Startup messages
4 - Tape
-ifreq <frequency> Select interrupt frequency [50 Hz]
-cpuspeed <speed> Set Z80 CPU speed [100%]
-sync <value> Sync/Do not sync emulation [1]
0 - Do not sync 1 - Sync
Emulation is faster if sync is turned off
-ram <value> Select amount of RAM installed [32KB]
-uperiod <period> Number of interrupts per screen update [1]
Try -uperiod 2 or -uperiod 3 if emulation is a bit
slow
-t / -m Select P2000 model [-t]
-video <mode> Select video mode/window size [0]
0 - 500x300 (Unix/X)
320x240 (Linux/SVGALib, T-model emulation only)
256x240 (MS-DOS, T-model emulation only)
1 - 520x490 (Unix/X)
640x480 (Linux/SVGALib and MS-DOS)
-printer <filename> Select file for printer output
Default is PRN for the MS-DOS version, stdout for
the Unix versions
-printertype <value> Select printer type [0]
0 - Daisy wheel 1 - Matrix
-romfile <file> Select P2000 ROM dump file [P2000ROM.bin]
-tape <filename> Select tape image to use [P2000.cas]
-boot <value> Allow/Don't allow BASIC to boot from tape [0]
0 - Don't allow booting
1 - Allow booting
-font <filename> Select font to use [Default.fnt]
-sound <mode> Select sound mode [255]
0 - No sound
1 - PC Speaker (MS-DOS) or /dev/dsp (Unix)
2 - SoundBlaster (MS-DOS)
255 - Detect
-volume <value> Select initial volume
0 - Silent 15 - Maximum
-joystick <mode> Select joystick mode [1]
0 - No joystick support
1 - Joystick support
When joystick support is on, moving the joystick
emulates cursorkey presses, pressing a joystick
button emulates pressing the spacebar
-shm <mode> Use/Do not use MIT SHM extensions for X [1] (Unix/X
version only)
0 - Don't use SHM 1 - Use SHM
Configuration files
===================
The emulator loads two configuration files (if present) before it loads a
cartridge ROM: M2000.cfg located in the emulator's directory and CART.cfg
(i.e. BASIC.cfg by default) 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.
Please note that for the Unix versions, the configuration files should be
present in the current working directory.
Plans for the future
====================
- Fix the P2000M emulation
- Add disk drive emulation
History
=======
0.6 Fixed several bugs in the Z80 emulation engine, fixed several
compatibility problems, added high resolution and character
rounding emulation support
0.5 Completely rewrote the Z80 emulation engine, fixed various minor
bugs, fixed a major bug in the SoundBlaster detection routine
0.4.1 Fixed a major bug that caused bad compiling on high-endian
machines
0.4 Fixed some minor bugs, added P2000M emulation, added Linux/SVGALib
and Unix/X ports, speeded up screen refresh drivers (again)
0.3 Major speed increase in screen refresh drivers, added options
dialogue
0.2 Major sound emulation improvements, fixed some bugs in video
emulation, added -ram and -volume command line options
0.1 Initial release
Credits
=======
- Hans Bus (jbus@hzsbg01.nl.lucent.com) provided me with lots of technical
information on the P2000
- Marat Fayzullin (fms@freeflight.com) provided invaluable help improving
the Unix/X version
- M2000 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
Please send your comments to Marcel at
m.dekogel@student.utwente.nl