doc/VMs/readme.txt

   1 Binary archive of retro pc emulator common source code
   2                                                                 2/9/2017
   3
   4 --- What's this ?
   5
   6 This archive includes the binaries of the emulators listed below:
   7
   8         ASCII
   9                 yaMSX1          MSX1 (by Mr.tanam and Mr.umaiboux)
  10                 yaMSX2          MSX2 (by Mr.tanam and Mr.umaiboux)
  11         BANDAI
  12                 eRX-78          RX-78
  13         CANON
  14                 eX-07           X-07
  15         CASIO
  16                 eFP-200         FP-200
  17                 eFP-1100        FP-1100
  18                 ePV-1000        PV-1000
  19                 EmuGaki         PV-2000
  20         COLECO
  21                 yaCOLECOVISION  ColecoVision
  22         EPOCH
  23                 eSCV            Super Cassette Vision
  24         EPSON
  25                 eHC-20          HC-20/HX-20
  26                 eHC-40          HC-40/PX-4
  27                 eHC-80          HC-80/PX-8/Geneva
  28                 eQC-10          QC-10/QX-10
  29         FUJITSU
  30                 eFM8            FM-8 (by Mr.Artane.)
  31                 eFM7            FM-7 (by Mr.Artane.)
  32                 eFM77           FM-77 (by Mr.Artane.)
  33                 eFM77AV         FM77AV (by Mr.Artane.)
  34                 eFM77AV40       FM77AV40 (by Mr.Artane.)
  35                 eFM77AV40EX     FM77AV40EX (by Mr.Artane.)
  36                 eFM16pi         FM16pi
  37                 eFMR-30         FMR-30
  38                 eFMR-50         FMR-50
  39                 eFMR-60         FMR-60
  40                 eFMR-70         FMR-70
  41                 eFMR-80         FMR-80
  42         Gijutsu Hyoron Sha
  43                 eBabbage-2nd    Babbage-2nd
  44         HITACHI
  45                 eBASICMasterJr  BASIC Master Jr
  46         Homebrew
  47                 eZ80TVGAME      Homebrew Z80 TV GAME SYSTEM
  48         IBM Japan Ltd
  49                 eJX             PC/JX
  50         Japan Electronics College
  51                 eMYCOMZ-80A     MYCOMZ-80A
  52         MITSUBISHI Electric
  53                 EmuLTI8         MULTI8
  54         National
  55                 eJR-100         JR-100
  56         NEC
  57                 ePC-2001        PC-2001
  58                 yaPC-6001       PC-6001 (by Mr.tanam)
  59                 yaPC-6201       PC-6001mkII (by Mr.tanam)
  60                 yaPC-6401       PC-6001mkIISR (by Mr.tanam)
  61                 yaPC-6601       PC-6601 (by Mr.tanam)
  62                 yaPC-6801       PC-6601SR (by Mr.tanam)
  63                 ePC-8001mkIISR  PC-8001mkIISR
  64                 ePC-8201        PC-8201/PC-8201A
  65                 ePC-8801MA      PC-8801MA
  66                 ePC-9801        PC-9801
  67                 ePC-9801E       PC-9801E/F/M
  68                 ePC-9801U       PC-9801U
  69                 ePC-9801VF      PC-9801VF
  70                 ePC-9801VM      PC-9801VM
  71                 ePC-98DO        PC-98DO
  72                 ePC-98LT        PC-98LT
  73                 eHANDY98        PC-98HA
  74                 ePC-100         PC-100
  75                 eTK-80BS        TK-80BS (COMPO BS/80)
  76                 eTK-85          TK-85
  77         NEC-HE
  78                 ePCEngine       PC Engine / SuperGrafx + CD-ROM^2
  79         Nintendo
  80                 eFamilyBASIC    Family BASIC
  81         Pioneer
  82                 ePX-7           PX-7 (MSX1 + LaserDisc)
  83         SANYO
  84                 ePHC-20         PHC-20
  85                 ePHC-25         PHC-25
  86         SEGA
  87                 eSC-3000        SC-3000
  88                 yaGAME GEAR     GAME GEAR (by Mr.tanam)
  89                 yaMASTER SYSTEM MASTER SYSTEM (by Mr.tanam)
  90         SEIKO
  91                 eMAP-1010       MAP-1010
  92         SHARP
  93                 EmuZ-80A        MZ-80A (by Mr.Suga)
  94                 EmuZ-80B        MZ-80B
  95                 EmuZ-80K        MZ-80K/C
  96                 EmuZ-700        MZ-700
  97                 EmuZ-800        MZ-800
  98                 EmuZ-1200       MZ-1200
  99                 EmuZ-1500       MZ-1500
 100                 EmuZ-2200       MZ-2200
 101                 EmuZ-2500       MZ-2500
 102                 EmuZ-2800       MZ-2800
 103                 EmuZ-3500       MZ-3500
 104                 EmuZ-5500       MZ-5500
 105                 EmuZ-6500       MZ-6500
 106                 eSM-B-80TE      SM-B-80TE
 107                 eX1             X1
 108                 eX1twin         X1twin
 109                 eX1turbo        X1turbo
 110         Shinko Sangyo
 111                 eYS-6464A       YS-6464A
 112         SONY
 113                 eSMC-70         SMC-70
 114                 eSMC-777        SMC-777
 115         SORD
 116                 Emu5            m5
 117         TOMY
 118                 ePyuTa          PyuTa/PyuTa Jr.
 119         TOSHIBA
 120                 eEX-80          EX-80
 121                 EmuPIA          PASOPIA
 122                 EmuPIA7         PASOPIA7
 123         Yuasa Kyouku System
 124                 eYALKY          YALKY
 125
 126 These binaries are for Windows XP/Vista/7.
 127 DirectX9 and GDI+ are required.
 128 They are tested on Windows 7 Home Premium with SP1.
 129
 130
 131 --- How to use
 132
 133 Common menus:
 134
 135         Control
 136                 Reset           Reset the virtual machine
 137                 -
 138                 CPU x1          Set CPU clock multipler
 139                 CPU x2
 140                 CPU x4
 141                 CPU x8
 142                 CPU x16
 143                 -
 144                 Paste           Auto key hitting from the clip board text
 145                 Stop            Stop the auto key hitting
 146                 -
 147                 Save State      Save the virtual machine state
 148                 Load State      Load the virtual machine state
 149                 -
 150                 Debug CPU       Open console and debug target CPU like SYMDEB
 151                 Close Debugger  Close debugger console
 152                 -
 153                 Exit            Terminate the emulator
 154
 155         Cart
 156                 Insert          Insert the cart image
 157                 Eject           Eject the cart image
 158                 -
 159                 History         Insert the cart image
 160
 161         FD*
 162                 Insert          Insert the floppy disk image
 163                 Eject           Eject the floppy disk image
 164                 -
 165                 Write Protected         Set the write protection of the inserted disk
 166                 Correct Timing          Emulate FDC with correct timing
 167                 Ignore CRC Errors       Ignore crc error status
 168                 -
 169                 History         Insert the floppy disk image
 170
 171         CMT
 172                 Play            Insert the cassette tape image to play
 173                 Rec             Insert the cassette tape image to record
 174                 Eject           Eject the cassette tape image
 175                 -
 176                 Play Tape Sound Enable playing tape sound
 177                 Waveform Shaper Enable waveform shaping for *.wav data
 178                 -
 179                 History         Insert the cassette tape image to play
 180
 181         Screen
 182                 Rec 60fps       Record the movie to avi and wav files
 183                 Rec 30fps
 184                 Rec 15fps
 185                 Rec 10fps
 186                 Stop            Stop recording the movie
 187                 Capture         Capture the screen to png file
 188                 -
 189                 Window x1       Set the window size
 190                         :
 191                 Window x8
 192                 Fullscreen ?x?  Set the fullscreen size
 193                 -
 194                 Dot By Dot      Set the stretch screen mode in the fullscreen
 195                 Stretch (Aspect)
 196                 Stretch (Fill)
 197                 -
 198                 Use Direct3D9   Enable Direct3D9 to render screen
 199                 Wait Vsync      Wait Vsync when Direct3D9 is enabled
 200                 -
 201                 CRT Filter      Enable the CRT filter
 202
 203         Sound
 204                 Rec             Record the sound to wav file
 205                 Stop            Stop recording the sound
 206                 -
 207                 2000Hz          Set the sound frequency
 208                 4000Hz          You need to restart the emulator
 209                 8000Hz
 210                 11025Hz
 211                 22050Hz
 212                 44100Hz
 213                 48000Hz
 214                 96000Hz
 215                 -
 216                 50msec          Set the sound buffer size (latency)
 217                 100msec         You need to restart the emulator
 218                 200msec
 219                 300msec
 220                 400msec
 221
 222         Input
 223                 Use DirectInput         Enable DirectInput for keyboard
 224                 Disable Windows8 DWM    Disable the Desktop Window Manager
 225                 Swap Joystcik Buttons   Swap the odd and even number buttons
 226
 227
 228 --- Note
 229
 230 For Windows PC environment:
 231
 232         Support Windows PC compatible mouse and joystick devices.
 233
 234         Shortcut key:
 235                 ALT+RETURN  - Switch window / fullscreen
 236                 CTRL+RETURN - Swtich enable / disenable the mouse control
 237
 238         *) While the mouse control is enabled, the mouse cursor is hidden.
 239
 240 Floppy disk images:
 241
 242         Supoort D88, TeleDisk, ImageDisk and CPDRead format disk images.
 243
 244 Cassette tape images:
 245
 246         Support wav files (PCM only) or special format images for each machine.
 247
 248 CD-ROM images:
 249
 250         Support BIN/IMG+CUE or IMG+CCD (CloneCD) format images.
 251
 252 Save/Load State info:
 253
 254         The state file contains any disk or other images.
 255         Please NEVER upload your state files on the web.
 256
 257         The state file format will be often changed.
 258         Please don't invite your state file can be loaded after you update
 259         the emulator binary.
 260
 261
 262 --- Thanks
 263
 264 - vm/datarec.*
 265         MESS formats/fmsx_cas.c for fMSX cas image decoder
 266 - vm/device.h
 267         XM6 by Mr.PI.
 268 - vm/fmgen/*
 269         M88/fmgen by Mr.CISC
 270 - vm/disk.*
 271         TDLZHUF for Teledisk floppy disk image decoder
 272         MESS formats/dsk_dsk.c for CPDRead floppy disk image decorder
 273         MESS formats/imd_dsk.c for ImageDisk floppy disk image decorder
 274 - vm/hd63484.*
 275         MAME HD63484 core
 276 - vm/huc6280.*
 277         MESS huc6280 core
 278 - vm/i86.*
 279         MAME i86 core
 280 - vm/i286.*
 281         MAME i286 core
 282 - vm/i386.*
 283         MAME i386 core
 284 - vm/i8259.*
 285         Neko Project 2 and MESS 8259 core
 286 - vm/ld700.*
 287         openMSX LD-700
 288 - vm/m6502.*
 289         MAME m6502 core
 290 - vm/mb8877.*
 291         XM7 by Mr.PI.
 292 - vm/mc6800.*
 293         MAME mc6800 core
 294 - vm/mc6809.*
 295         MAME mc6809 core and improved by Mr.Artane.
 296 - vm/mc6840.*
 297         MAME Motorola 6840 (PTM) by Mr.James Wallace
 298 - vm/mc6847.*
 299         MAME mc6847 core
 300 - vm/msm5205.*
 301         MAME msm5205 core
 302 - vm/mz1p17.*
 303         MZ-80P3 / MZ-80P4 mode by Mr.Suga
 304 - vm/pc6031.*
 305         iP6 by Mr.Nishida
 306 - vm/scsi_dev.*
 307 - vm/scsi_host.*
 308         MAME SCSI bus codes gives me a good hint to implement SCSI protocols
 309 - vm/scsi_cdrom.*
 310         NEC CD-ROM^2 features by MAME TG16 CD-ROM^2 driver (pce_cdrom.*)
 311 - vm/sn76489an.*
 312         MAME SN76496 core
 313 - vm/sy6522.*
 314         MAME Rockwell 6522 VIA by Mr.Peter Trauner and Mr.Mathis Rosenhauer
 315 - vm/t3444a.*
 316         Mr.Oh!Ishi for the chip specification info
 317 - vm/tf20.*
 318         vfloppy 1.4 by Mr.Justin Mitchell and Mr.Fred Jan Kraan
 319         Mr.Fred Han Kraan for EPSON TF-20 hardware design info
 320 - vm/tms3631.*
 321         Neko Project 2 by Mr.Yui
 322 - vm/tms9918a.*
 323         MAME TMS9928 core
 324 - vm/tms9995.*
 325         MAME TMS99xx core
 326 - vm/upd71071.*
 327         88VA Eternal Grafx by Mr.Shinra
 328 - vm/upd7220.*
 329         Neko Project 2 by Mr.Yui
 330 - vm/upd765a.*
 331         M88 fdc/fdu core by Mr.CISC
 332 - vm/upd7752.*
 333         iP6 by Mr.Nishida
 334 - vm/upd7801.*
 335         MAME uPD7810 core
 336         Mr.Komatsu for the chip specification info
 337 - vm/upd7810.*
 338         MAME uPD7810 core and PockEmul uPD7907 core
 339 - vm/upd16434.*
 340         PockEmul uPD16434 core
 341 - vm/v99x8.*
 342         Zodiac V99x8 core, converted to C++ class by Mr.umaiboux
 343 - vm/w3100a.*
 344         Mr.Oh!Ishi for the chip specification info
 345 - vm/z80.*
 346         MAME Z80 core
 347 - vm/z80dma.*
 348         MAME Z80DMA core and improved by Mr Y.S.
 349 - vm/bmjr/*
 350         bm2 by Mr.maruhiro
 351         Mr.Enri for HITACH BASIC Master Jr hardware design info
 352 - vm/colecovision/*
 353         yaCOLECOVISION by Mr.tanam
 354 - vm/familybasic
 355         nester by Mr.Darren Ranalli
 356 - vm/fm7/*
 357         eFM7/77/77AV by Mr.Artane.
 358 - vm/fmr50/bios.*
 359         FM-TOWNS emulator on bochs
 360         UNZ pseudo BIOS by Mr.Kasanova
 361 - vm/fp200/*
 362         PockEmul gives much hints about LCD driver
 363 - vm/gamegear/*
 364         yaGAMEGEAR/yaMASTERSYSTEM by Mr.tanam
 365 - vm/hc20/*
 366         Mr.Fred Han Kraan for EPSON HC-20/HX-20 hardware design info
 367 - vm/hc40/*
 368         Mr.Fred Han Kraan for EPSON HC-40/PX-4 hardware design info
 369 - vm/hc80/*
 370         Mr.Fred Han Kraan for EPSON HC-80/PX-8/Geneva hardware design info
 371 - vm/hc80/io.*
 372         Mr.Dennis Heynlein for intelligent ram disk unit
 373 - vm/jr100/*
 374         Mr.Enri for National JR-100 hardware design info
 375 - vm/m5/*
 376         MESS sord driver
 377         Mr.Moriya for Sord M5 hardware design info
 378 - vm/msx/*
 379         yaMSX1 and yaMSX2 by Mr.tanam
 380 - vm/msx/memory.*
 381         fMSX Disk BIOS
 382 - vm/mycomz80a/mon/mon.c
 383         Based on MON80 by Mr.Tesuya Suzuki
 384 - vm/mz80k/memory.*
 385 - vm/mz80k/mz80aif.*
 386         MZ-80A emulator by Mr.Suga
 387 - vm/mz80k/mz80fio.*
 388         Mr.Enri for SHARP MZ-80FIO and MZ-80FD hardware design info
 389 - vm/mz80k/printer.*
 390         The printer interface by Mr.Suga
 391 - vm/mz2500/sasi.*
 392         X millenium by Mr.Punyu
 393 - vm/mz3500/keyboard.*
 394         The keycode tables are from Martinuv 8-bitovy blog
 395         http://www.8bity.cz/2013/adapter-pro-pripojeni-ps2-klavesnice-k-sharp-mz-3500/
 396 - vm/pc6001/*
 397         yaPC-6001/yaPC-6201/yaPC-6601 by Mr.tanam
 398 - vm/pc8801/pc88.*
 399         M88 by Mr.CISC
 400         XM8 by Mr.PI.
 401         MESS PC-8801 driver
 402 - vm/pcengine/pce.*
 403         Ootake (joypad)
 404         xpce (psg)
 405         MESS TG16 driver (vdc/vce/vpc/cdrom)
 406 - vm/phc25/*
 407         PHC-25 emulator by Mr.Tago
 408 - vm/pv1000/*
 409         Mr.Enri for CASIO PV-1000 hardware design info
 410 - vm/pv2000/*
 411         Mr.Enri for CASIO PV-2000 hardware design info
 412 - vm/pyuta/*
 413         MESS tutor driver
 414         Mr.Enri for TOMY PyuTa Jr. hardware design info
 415 - vm/qc10/*
 416         Mr.Fred Han Kraan for EPSON QC-10/QX-10 hardware design info
 417 - vm/scv/*
 418         Mr.Enri and Mr.333 for Epoch Super Cassette Vision hardware info
 419 - vm/x07/io.*
 420         x07_emul by Mr.Jacques Brigaud
 421 - vm/x1/*
 422         Many advices by Mr Y.S.
 423 - vm/x1/psub.*
 424         X millenium T-tune by Mr.Sato
 425 - vm/x1/display.*
 426         KANJI ROM support by X1EMU
 427 - vm/z80tvgame/*
 428         This homebrew cnosole is designed by Mr.Ishizu
 429         http://w01.tp1.jp/~a571632211/z80tvgame/index.html
 430 - win32/osd_sound.cpp
 431         XM7 by Mr.PI. for DirectSound implement
 432 - res/*.ico
 433         Mr.Temmaru, Mr.Marukun, and Mr.Yoshikun
 434         See also res/icon.txt
 435
 436 - emulation core design
 437         nester by Mr.Darren Ranalli
 438         XM6 by Mr.PI.
 439
 440 ----------------------------------------
 441 TAKEDA, toshiya
 442 t-takeda@m1.interq.or.jp
 443 http://takeda-toshiya.my.coocan.jp/