doc/readme.txt

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