source/readme.txt

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