diff --git a/readme.txt b/readme.txt deleted file mode 100644 index 30afba3fd..000000000 --- a/readme.txt +++ /dev/null @@ -1,775 +0,0 @@ -PCem v10.1 - -PCem is licensed under the GPL, see COPYING for more details. - -Changes since v10: - -- Fixed buffer overruns in PIIX and ET4000/W32p emulation -- Add command line options to start in fullscreen and to specify config file -- Emulator doesn't die when the CPU jumps to an unexecutable address -- Removed Voodoo memory dump on exit - - -PCem emulates the following machines: - -IBM 5150 PC (1981) -The original PC. This shipped in 1981 with a 4.77mhz 8088, 64k of RAM, and a cassette port. -Disc drives quickly became standard, along with more memory. - -ROM files needed: - -ibmpc\pc102782.bin -ibmpc\basicc11.f6 -ibmpc\basicc11.f8 -ibmpc\basicc11.fa -ibmpc\basicc11.fc - - -IBM 5160 XT (1983) -From a hardware perspective, this is a minor tweak of the original PC. It originally shipped -with 128k of RAM and a 10mb hard disc, both of which could be easily fitted to the 1981 machine. -However, this was targetted as businesses and was more successful than the original. - -ROM files needed: - -ibmxt\5000027.u19 -ibmxt\1501512.u18 - - -IBM PCjr (1984) -A home machine, which had better graphics and sound than most XTs but was not hardware compatible -with the PC. - -ROM files needed: - -ibmpcjr\bios.rom - - -IBM AT (1984) -This was the 'next generation' PC, fully 16-bit with an 80286. The original model came with a 6mhz -286, which ran three times as fast as the XT. This model also introduced EGA. - -ROM files needed: - -ibmat\at111585.0 -ibmat\at111585.1 - - -Olivetti M24 (1984) -An enhanced XT clone, also known as the AT&T PC 6300. Has an 8086 CPU, and an unusual 'double-res' -CGA display. - -ROM files needed: - -olivetti_m24\olivetti_m24_version_1.43_low.bin -olivetti_m24\olivetti_m24_version_1.43_high.bin - - -Tandy 1000 (1985) -This is a clone of the unsuccessful IBM PCjr, which added better graphics and sound to the XT, -but removed much expandability plus some other hardware (such as the DMA controller). The Tandy -puts back the DMA controller and ISA slots, making it a much more useful machine. Many games -from the late 80s support the Tandy. - -ROM files needed: - -tandy\tandy1t1.020 - - -DTK Clone XT (1986) -A generic clone XT board. - -ROM files needed: - -dtk\DTK_ERSO_2.42_2764.bin - - -Amstrad PC1512 (1986) -This was Amstrad's first entry into the PC clone market (after the CPC and PCW machines), and -was the first cheap PC available in the UK, selling for only £500. It was a 'turbo' clone, -having an 8mhz 8086, as opposed to an 8088, and had 512k RAM as standard. It also had a -perculiar modification to its onboard CGA controller - the 640x200 mode had 16 colours instead -of the usual 2. This was put to good use by GEM, which shipped with the machine. - -Amstrad's CGA implementation has a few oddities, these are emulated as best as possible. This -mainly affects games defining unusual video modes, though 160x100x16 still works (as on the real -machine). - -ROM files needed: - -pc1512\40043.v1 -pc1512\40044.v2 -pc1512\40078.ic127 - - -Amstrad PC1640 (1987) -Amstrad's followup to the PC1512, the PC1640 had 640k of RAM and onboard EGA, but was otherwise -mostly the same. - -ROM files needed: - -pc1640\40043.v3 -pc1640\40044.v3 -pc1640\40100 - - -Sinclair PC200/Amstrad PC20 (1988) -This was Amstrad's entry to the 16-bit home computer market, intended to compete with the Atari -ST and Commodore Amiga. It's similar to the PC1512, but is based on Amstrad's portable PPC512 -system. With stock CGA and PC speaker, it couldn't compare with the ST or Amiga. - -ROM files needed: - -pc200\pc20v2.0 -pc200\pc20v2.1 -pc200\40109.bin - - -Schneider Euro PC (1988) -A German XT clone. An 'all-in-one' system like the Sinclair PC200. I don't know much about this -machine to be honest! This doesn't appear to work with the XTIDE BIOS, so therefore this is the -only model that does not support hard discs. - -ROM files needed: - -europc\50145 -europc\50146 - - -(c)Anonymous Generic Turbo XT BIOS (1988?) -This is a BIOS whose source code was made available on Usenet in 1988. It appears to be an -anonymous BIOS from an XT clone board. It was then heavily modified to fix bugs. The history of -this BIOS (and the source code) is at http://dizzie.narod.ru/bios.txt - -ROM files needed: - -genxt\pcxt.rom - - -AMI XT clone (1989) - -ROM files needed: - -amixt\AMI_8088_BIOS_31JAN89.BIN - - -DTK XT clone (1988) - -ROM files needed: - -dtk\DTK_ERSO_2.42_2764.bin - - -VTech Laser Turbo XT (1987) - -ROM files needed: - -ltxt\27C64.bin - - -VTech Laser XT3 (1989) - -ROM files needed: - -lxt3\27C64D.bin - - -Phoenix XT clone (1986) - -ROM files needed: - -pxxt\000p001.bin - - -Juko XT clone (1988) - -ROM files needed: - -jukopc\000o001.bin - - -Commodore PC30-III (1988) -A fairly generic 286 clone. - -ROM files needed: - -cmdpc30\commodore pc 30 iii even.bin -cmdpc30\commodore pc 30 iii odd.bin - - -Amstrad PC2086 (1989) -The PC2086 is essentially a PC1640 with VGA and 3.5" floppy drives. - -ROM files needed: - -pc2086\40179.ic129 -pc2086\40180.ic132 -pc2086\40186.ic171 - - -Amstrad PC3086 (1990) -The PC3086 is a version of the PC2086 with a more standard case. - -ROM files needed: - -pc3086\fc00.bin -pc3086\c000.bin - - -Dell System 200 (1990?) -This is a pretty generic 286 clone with a Phoenix BIOS. - -HIMEM.SYS doesn't appear to work on this one, for some reason. - -ROM files needed: - -dells200\dell0.bin -dells200\dell1.bin - - -AMI 286 clone (1990) -This is a generic 286 clone with an AMI BIOS. - -ROM files needed: - -ami286\amic206.bin - - -IBM PS/1 Model 2011 (1990) -This is a 286 with integrated VGA and a basic GUI and DOS 4.01 in ROM. - -ROM files needed: - -ibmps1\f80000.bin - - -Compaq Deskpro 386 (1989) -An early 386 system. I don't think this BIOS is from the original 1986 version -(the very first 386 system), but from a 1989 refresh. - -ROM files needed: - -deskpro386\109592-005.U11.bin -deskpro386\109591-005.U13.bin - - -Acermate 386SX/25N (1992?) -An integrated 386SX clone, with onboard Oak SVGA and IO. - -ROM files needed: -acer386\acer386.bin -acer386\oti067.bin - - -DTK 386SX clone (1990) - -ROM files needed: - -dtk386\3cto001.bin - - -Phoenix 386 clone (1989) - -ROM files needed: - -px386\3iip001l.bin -px386\3iip001h.bin - - -Amstrad MegaPC (1992) -A 386SX clone (otherwise known as the PC7386SX) with a built-in Sega Megadrive. Only the PC section -is emulated, obv. - -ROM files needed: -megapc\41651-bios lo.u18 -megapc\211253-bios hi.u19 - - -AMI 386 clone (1994) -This is a generic 386 clone with an AMI BIOS. The BIOS came from my 386DX/40, the motherboard is -dated June 1994. - -ROM files needed: - -ami386\ami386.bin - - -AMI 486 clone (1993) -This is a generic 486 clone with an AMI BIOS. The BIOS came from my 486SX/25, bought in December -1993. - -ROM files needed: - -ami486\ami486.bin - - -AMI WinBIOS 486 clone (1994) -A 486 clone with a newer AMI BIOS. - -ROM files needed: - -win486\ali1429g.amw - - -Award SiS 496/497 (1995) -A 486 clone using the SiS 496/497 chipset, with PCI bus and Award BIOS. - -ROM files needed: - -sis496\SIS496-1.AWA - - -Intel Premiere/PCI (Batman's Revenge) (1994) -A Socket 4 based board with 430LX chipset. - -Has an odd bug where on soft-reset, the memory count never ends. Hard-reset works okay. - -ROM files needed: - -revenge\1009AF2_.BI0 -revenge\1009AF2_.BI1 - - -Intel Advanced/EV (Endeavor) (1995) -A Socket 5/7 based board with 430FX chipset. The real board has a Sound Blaster Vibra 16 on board, -which is not emulated - use a discrete card instead. Some Advanced/EVs also had a Trio64 on board, -the emulated board does not have this either. - -Has essentially the same BIOS as the Premiere/PCI, and the same soft-reset bug. - -ROM files needed: - -endeavor\1006CB0_.BI0 -endeavor\1006CB0_.BI1 - - -Award 430VX PCI (1996) -A generic Socket 5/7 board with 430VX chipset. - -ROM files needed: - -430vx\55XWUQ0E.BIN - - - -PCem emulates the following graphics adapters : - -MDA -The original PC adapter. This displays 80x25 text in monochrome. - - -Hercules -A clone of MDA, with the addition of a high-resolution 720x348 graphics mode. - - -CGA -The most common of the original adapters, supporting 40x25 and 80x25 text, and -320x200 in 4 colours, 640x200 in 2 colours, and a composite mode giving 160x200 -in 16 colours. - - -IBM EGA -The original 1984 IBM EGA card, with 256k VRAM. - -ROM files needed: - -ibm_6277356_ega_card_u44_27128.bin - - -Trident 8900D SVGA -A low cost SVGA board circa 1992/1993. Not the greatest board in it's day, but -it has a reasonable VESA driver and (buggy) 15/16/24-bit colour modes. - -ROM files needed: - -trident.bin - - -Trident TGUI9440 -A later Trident board with GUI acceleration. Windows 9x doesn't include drivers -for this, so they have to be downloaded and installed separately. - -ROM files needed: - -9440.vbi - - -Tseng ET4000AX SVGA -A somewhat better SVGA board than the Trident, here you get better compatibility -and speed (on the real card, not the emulator) in exchange for being limited to -8-bit colour. - -ROM files needed: - -et4000.bin - - -Diamond Stealth 32 SVGA -An ET4000/W32p based board, has 15/16/24-bit colour modes, plus acceleration. - -ROM files needed: - -et4000w32.bin - - -Paradise Bahamas 64 -An S3 Vision864 based board. - -ROM files needed: - -bahamas64.bin - - -Number Nine 9FX -An S3 Trio64 based board. - -ROM files needed: - -s3_764.bin - - -ATI VGA Edge-16 -A basic SVGA clone. - -ROM files needed: - -vgaedge16.vbi - - -ATI VGA Charger -A basic SVGA clone, similar to the Edge-16. - -ROM files needed: - -bios.bin - - -ATI Graphics Pro Turbo -A Mach64GX based board. Probably the best of the emulated boards for use in -Windows. - -ROM files needed: - -mach64gx/bios.bin - - -OAK OTI-067 -A basic SVGA clone. - -ROM files needed: - -oti067/bios.bin - - -Diamond Stealth 3D 2000 -An S3 ViRGE/325 based board. - -PCem emulates the ViRGE S3D engine in software. This works with most games I tried, but -there may be some issues. The Direct3D drivers for the /325 are fairly poor (often showing -as missing triangles), so use of the /DX instead is recommended. - -The streams processor (video overlay) is also emulated, however many features are missing. - -ROM files needed: - -s3virge.bin - - -S3 ViRGE/DX -An S3 ViRGE/DX based board. The drivers that come with Windows are similar to those for the -/325, however better ones do exist (try the 8-21-1997 version). With the correct drivers, -many early Direct3D games work okay (if slowly). - -ROM files needed: - -86c375_1.bin - - -3DFX Voodoo Graphics -3D accelerator. Widely supported in late 90s games. - -PCem emulates this in software. The emulation isn't quite as fast as the real thing, but in -most games the emulated CPU is the bottleneck rather than the 3DFX, unless you insist on -running in 800x600. PCem can split rendering over two threads - this doesn't double performance, -but can give a noticeable improvement. - -PCem can emulate 6 and 8 MB configurations, but defaults to 4 MB for compatibility. It can also -emulate the screen filter present on the original card, though this does at present have a -noticeable performance hit. - -Almost everything I've tried works okay, with a very few exceptions - Screamer 2 and Rally have -serious issues, and Need For Speed II SE and III don't draw the map correctly. - - - -Some models have fixed graphics adapters : - -IBM PCjr -CGA with various new modes - 160x200x16, 320x200x16, 640x200x4. - -Olivetti M24 -CGA with double-res text modes and a 640x400 mode. I haven't seen a dump of the font -ROM for this yet, so if one is not provided the MDA font will be used - which looks slightly odd -as it is 14-line instead of 16-line. - -Tandy 1000 -Clone of PCjr video. Widely supported in 80s games. - -Amstrad PC1512 -CGA with a new mode (640x200x16). Only supported in GEM to my knowledge. - -Amstrad PC1640 -Paradise EGA. - -Amstrad PC2086/PC3086 -Paradise PVGA1. An early SVGA clone with 256kb VRAM. - -IBM PS/1 Model 2011 -Stock VGA with 256kb VRAM. - -Amstrad MegaPC -Paradise 90C11. A development of the PVGA1, with 512kb VRAM. - -Acer 386SX/25N -Oak OTI-067. Another 512kb SVGA clone. - - - -PCem emulates the following sound devices : - -PC speaker -The standard beeper on all PCs. Supports samples/RealSound. - -Tandy PSG -The Texas Instruments chip in the PCjr and Tandy 1000. Supports 3 voices plus -noise. I reused the emulator in B-em for this (slightly modified). - -Gameblaster -The Creative Labs Gameblaster/Creative Music System, Creative's first sound card -introduced in 1987. Has two Philips SAA1099, giving 12 voices of square waves plus 4 noise -voices. In stereo! - -Adlib -Has a Yamaha YM3812, giving 9 voices of 2 op FM, or 6 voices plus a rhythm section. PCem -uses the DOSBox dbopl emulator. - -Adlib Gold -OPL3 with YM318Z 12-bit digital section. Possibly some bugs (not a lot of software to test). - -Sound Blaster -Several Sound Blasters are emulated : - SB v1.0 - The original. Limited to 22khz, and no auto-init DMA (can cause crackles sometimes). - SB v1.5 - Adds auto-init DMA - SB v2.0 - Upped to 41khz - SB Pro v1.0 - Stereo, with twin OPL2 chips. - SB Pro v2.0 - Stereo, with OPL 3 chip - SB 16 - 16 bit stereo - SB AWE32 - SB 16 + wavetable MIDI. This requires a ROM dump from a real AWE32. -All are set to Address 220, IRQ 7 and DMA 1 (and High DMA 5). IRQ and DMA can be changed for the -SB16 & AWE32 in the drivers. -The relevant SET line for autoexec.bat is - SET BLASTER = A220 I7 D1 Tx - where Tx is T1 for SB v1.0, T3 for SB v2.0, T4 for SB Pro, - and T6 for SB16. - -AWE32 requires a ROM dump called awe32.raw. AWE-DUMP is a utility which can get a dump from a real -card. Most EMU8000 functionality should work, however filters are not correct and reverb/chorus -effects are not currently emulated. - -Gravis Ultrasound -32 voice sample playback. Port address is fixed to 240, IRQ and DMA can be changed from the drivers. -Emulation is improved significantly over previous versions. - -Windows Sound System -16-bit digital + OPL3. Note that this only emulates WSS itself, and should not be used with drivers -from compatible boards with additional components (eg Turtle Beach Monte Carlo) - -Innovation SSI-2001 -SID6581. Emulated using resid-fp. Board is fixed to port 280. - - -Other stuff emulated : - -Serial mouse -A Microsoft compatible serial mouse on COM1. Compatible drivers are all over the place for this. - -M24 mouse -I haven't seen a DOS mouse driver for this yet, but the regular scancode mode works, as does the -Windows 1.x driver. - -PC1512 mouse -The PC1512's perculiar quadrature mouse. You need Amstrad's actual driver for this one. - -PS/2 mouse -A PS/2 mouse is emulated on the MegaPC, 386SX/25N and Premiere/PCI models. As with serial, -compatible drivers are common. - -ATAPI CD-ROM -Works with OAKCDROM.SYS. It can only work with actual CD-ROM drives at the minute, so to use ISO images -you need a virtual CD drive. - - -XTIDE : - -The XTIDE board is emulated for machines that don't natively support IDE hard discs. - -You will need to download the XTIDE BIOS seperately. Of the various versions, ide_at.bin and ide_xt.bin -should be placed in the ROMS directory. ide_xt is used on all XT models, and ide_at is used on the IBM AT -and Commodore PC30-III machines. - -The BIOS is available at : - -http://code.google.com/p/xtideuniversalbios/ - -v2.0.0 beta 1 is the version I've mostly tested. v2.0.0 beta 3 is known to have some issues. - -For the PS/1, you will need v1.1.5. The PS/1 is a bit fussy with XTIDE, and I've found that it works best -when the XTIDE configuration has 'Full Operating Mode' disabled. This version must be called -ide_at_1_1_5.bin and should also be placed in the ROMS directory. - - -Notes : - -- The time on the PC1512 clock is wrong. The date is correct, though since the PC1512's bios isn't - Y2k compliant, it thinks it's 1988. - -- The envelope system on the Gameblaster isn't emulated. The noise may not be right either. - -- Some of the more unusual VGA features are not emulated. I haven't found anything that uses them yet. - -- On some versions of Windows the AWE32 is not set up correctly, claiming a resource conflict. To correct - this open the relevant item in Device Manager, choose 'Set Configuration Manually' and accept the - options presented. - - -Software tested: - -MS-DOS 3.3 -MS-DOS 6.22 - - Most of the supplied software seems to work, eg Drivespace, Defrag, Scandisk, QBASIC - etc - -Windows 1.03 -Windows 2.03 -Windows/286 2.1 -Windows/386 2.1 -Windows 3.0 -Windows 3.1 -Windows 3.11 for Workgroups -Windows NT 3.1 -Windows NT 3.51 -Windows NT 4 -Windows 95 -Windows 95 OSR 2 -Windows 98 -Windows 98 SE -Windows ME -Windows 2000 -Windows XP - -OS/2 1.0 - hard disk must be formatted beforehand -OS/2 1.21 - hard disk must be formatted beforehand -OS/2 1.3 -OS/2 2.0 -OS/2 Warp 3 -OS/2 Warp 4 - -BeOS 5 Personal Edition (only seems to work correctly on Award SiS 496/497) - -Mandrake Linux 7.1 -RedHat Linux 7.1 (Seawolf) -SUSE Linux 6.3 - -NetBSD 6.1.5 - -Office 97 -Word for Windows 2.0 -Works for Windows 3.0 - -Alien vs Predator -All New World of Lemmings -Alley Cat -Breakneck -Civilization (DOS and Windows versions) -Colin Mcrae Rally -Colonization -Command and Conquer : Red Alert (DOS and Windows versions) -Croc (demo, ViRGE and 3DFX) -Curse of Monkey Island -Dawn Patrol -Deus Ex (3DFX) (slow) -Discworld 2 -Doom -Duke Nukem 3D -Dune (floppy and CD versions) -Ecstatica -Epic Pinball -Expendable (3DFX) (slow) -Final Fantasy VII (3DFX) -Forsaken (3DFX) -G-Police (ViRGE and 3DFX) -Grand Theft Auto (3DFX) -Grand Theft Auto 2 (3DFX) -Grim Fandango (ViRGE and 3DFX) -Half-Life (3DFX) -Incoming (3DFX) -Interstate '76 -Jazz Jackrabbit -Jazz Jackrabbit 2 -Jedi Knight (3DFX) -Kings Quest (PC booter, PCjr and Tandy 1000) -Kings Quest II (booter) -Lemmings -Lemmings 2 : The Tribes -Lotus III -Mortal Kombat Trilogy (DOS and Windows versions) -Mystic Towers -Need for Speed II SE (3DFX) -Need for Speed III -Network Q RAC Rally -Oddworld : Abe's Oddysee -Overlord -Pinball Fantasies -Populous : The Beginning (3DFX) -Power Drive -Prince of Persia -Pro Pinball : Big Race USA -Pro Pinball : The Web -Psycho Pinball -Quake (3DFX) -Quake II (3DFX) -Rebel Assault -Return of Arcade -Rise of the Triad -Rollercoaster Tycoon -Screamer -Screamer Rally (not 3DFX) -Secret of Monkey Island -Sensible World of Soccer -Simcity 2000 (DOS, Windows 3.1, Windows 95 and OS/2 versions) -Simcity 3000 -SiN (3DFX) -Stargunner -System Shock -Terminal Velocity -The 7th Guest -The Humans -Theme Hospital (DOS and Windows versions) -Theme Park -Tomb Raider (ViRGE and 3DFX) -Tomb Raider II (3DFX) -Total Annihilation -Transport Tycoon -Turok (3DFX) -Tyrian -UFO : Enemy Unknown -Ultima Underworld II -Unreal -Unreal Tournament (3DFX) -Wacky Wheels -Wing Commander III -Wolfenstein 3D -Worms -X-Com : Apocalypse -X-Com : Terror From The Deep -X-Wing -