doc/VMs/readme.txt

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