source/readme.txt

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