doc/readme.txt

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