source/readme.txt

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