******* M2000 ******* The Portable P2000 Emulator Version 0.4.1 Copyright (C) 1996 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 English teletext 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) 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
Trap execution when PC reaches specified address [- 1] (Debugging version only) -help Print a help page describing all available command line options -verbose Select debugging messages [1] 0 - Silent 1 - Startup messages 4 - Tape 16 - Illegal CPU ops -ifreq Select interrupt frequency [50 Hz] -cpuspeed Set Z80 CPU speed [100%] -sync Sync/Do not sync emulation [1] 0 - Do not sync 1 - Sync Emulation is faster if sync is turned off -ram Select amount of RAM installed [32KB] -uperiod 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] -printer Select file for printer output Default is PRN for the MS-DOS version, stdout for the Unix versions -printertype Select printer type [0] 0 - Daisy wheel 1 - Matrix -romfile Select P2000 ROM dump file [P2000ROM.bin] -tape Select tape image to use [P2000.cas] -boot Allow/Don't allow BASIC to boot from tape [0] 0 - Don't allow booting 1 - Allow booting -font Select font to use [Default.fnt] -sound Select sound mode [255] 0 - No sound 1 - PC Speaker (MS-DOS) or /dev/dsp (Unix) 2 - SoundBlaster (MS-DOS) 255 - Detect -volume Select initial volume 0 - Silent 15 - Maximum -joystick 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 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 - Add high-resolution video modes support History ======= 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 - The Z80 emulator used is heavily based on code written by Marat Fayzullin (fms@freeflight.com). The original code can be downloaded from his homepage at http://freeflight.com/fms Marat also 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