doc/readme.txt

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