doc/VMs/readme.txt

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