dbalsom/martypc: A cycle-accurate IBM PC/XT/Jr/Tandy emulator · GitHub

MartyPC is an emulator of early IBM PCs and compatibles. It supports Windows, Linux and macOS.

Click here to access the MartyPC User Guide

Builds are offered through routinereleases Newer, automated builds are offered by means of the Actions tab under the Artifacts for each workflow run. (You will require to be visited to GitHub to download Artifacts).

If you’re not on Windows, or you desire the current bleeding-edge variation, you’ll require to develop MartyPC from source.

• Last Released Version: 0.4.1
• Current Developement Version: 0.5.0

See the Building MartyPC guide on the MartyPC Wiki for develop directions.

MartyPC started as a pastime job to see if I might compose an emulator from scratch while discovering the Rust programs language. My initial objectives for MartyPC were modest, however it has actually reached a level of performance that I might have never ever pictured.

MartyPC’s designated specific niche in the emulation world is an assistant for retro PC advancement. It is loaded with debugging tools and logging centers, with much more prepared. It might not be as easy to use to establish as other emulators, however if you recognize with modifying setup files you should not have any significant issues. Programmers composing software application for the Intel 8088 can see and determine the specific cycle-by-cycle execution of their code.

Development of MartyPC began in April 2022. I started deal with making MartyPC’s 8088 CPU emulation cycle-accurate in
November 2022. To do so, I verified the operation of the CPU versus a genuine 8088 CPU linked to an Arduino MEGA
microcontroller. See my Arduino8088 project for more information. This enables a direction to be at the same time carried out on the emulator and a genuine CPU and the execution results compared, cycle-by-cycle. More information on this procedure is explained on my blog.

In June 2024 I upgraded the 8088 test suite when again to support working out of the 8088’s prefetch line. Many more cycle errors were discovered and fixed. MartyPC passes the 8088 V2 Test Suite with 99.9997% cycle-accuracy.

Extensive hardware research study has actually been carried out to enhance MartyPC’s peripheral emulation too, consisting of
examining the 8253 timer chip with an Arduino, examining DMA timings with an oscilloscope, and eventually, building a bus sniffer utilizing a reasoning analyzer.

In April 2023, MartyPC ended up being precise sufficient to run the notorious PC demonstration, 8088 MPH.

In May 2023, MartyPC ended up being the very first PC emulator efficient in replicating every impact in the PC demonstrationArea 5150 (See video here: https://www.youtube.com/watch?v=zADeLm9g0Zg)

Currently, MartyPC can replicate the following systems:

• The IBM Model 5150 (PC)
• The IBM Model 5160 (XT)
• Generic Turbo XT
• The IBM PCjr
• The Tandy 1000

MartyPC replicates the following gadgets:

• • Intel 8088 – A cycle-accurate application of the Intel 8088 consisting of the asynchronous BIU, processor direction line and prefetch reasoning. Tested for accuracy and cycle-accuracy versus hardware.
  • NEC V20 – An initial application of the NEC V20 CPU. Cycle- based, however not completely cycle-accurate or as performant as the genuine thing, as timings have actually not been changed from the 8088 that was utilized as a base. All native-mode V20 directions are executed and evaluated for accuracy versus hardware.
• • 8255 PPI – Low- level keyboard emulation is supported by means of the PPI and keyboard shift register. Supports the ‘turbo bit’ discovered in Turbo XT clones.
  • 8259 PHOTO – Mostly total, however still missing out on innovative functions such as concern rotation and embedded modes.
  • 8253 PIT – Highly precise, supporting PCM audio.
  • 8237 DMAC – Mostly executed, however DMA transfers are presently “fabricated”. DRAM revitalize DMA is simulated utilizing a scheduling system.
  • 8250 UART – Supports serial passthrough or mouse emulation.
  • Game Port – Supports 2 analog joysticks with 2 buttons each.
  • Parallel Port – Enough of a fundamental parallel port is imitated to be discovered, however is not truly practical for any function yet.
• • CGA – A vibrant, cycle-or-character clocked application of the IBM CGA consisting of the Motorola MC6845 CRTC controller enables MartyPC to run requiring PC demonstrations like 8088MPH and Area 5150. MartyPC takes a special method to PC video card emulation by replicating the whole display screen field – consisting of overscan. Composite output and display simulation is supported, by means of reenigne’s outstanding composite conversion code (likewise utilized by DOSBox and 86Box)
  • TGA – A character-clocked application of the PCJr andTandy Graphics Video Gate Array Work in development.
  • MDA – A character-clocked application of the IBM MDA card developed on the Motorola MC6845 CRTC controller.
  • Hercules – The MDA gadget additionally supports emulation of the Hercules Graphics Adapter.
  • EGA – A character-clocked application of the IBM EGA develops on the strategies utilized establishing the CGA. It is structured to duplicate the sensible functions of each of the LSI chips on the initial hardware. It supports redefinable typefaces, vsync disrupts and per-scanline pel-panning for smooth scrolling.
  • VGA – IBM VGA card emulation remains in advancement, however graphics modes such as Mode 13h and Mode X are working.
• • PC Speaker – Not truly its own noise gadget, the PC speaker is driven by MartyPC’s timer chip emulation. It can produce affordable quality PWM audio in demonstrations such as 8088MPH, Area 5150, and Magic Mushroom.
  • Adlib – The initial Adlib Music Synthesizer is imitated, with OPL2 emulation supplied by nuked-opl3, by means of my opl3-rs bidings. This is a bit CPU heavy, so you’ll require a quick computer system.
  • SN76489 – The 3-voice sound chip discovered in the Tandy 10000 design line and the IBM PCjr is imitated – with a cool debug display screen that offers UV meters and oscilloscope views of each channel.
  • Disney Sound Source – The Disney Sound Source was an affordable parallel DAC with a 16-sample FIFO and volume knob. Not a great deal of video games support it, however it works well in the couple of titles that do.
• • µPD765 FDC – Currently robust sufficient to support both DOS and Minix running systems. MartyPC utilizes my disk
    image library, fluxfox, which enables it to support a wide array of PC disk image formats.
    MartyPC’s FDC emulation is still not as precise as I’d like it to be, however it can support a number
    of copy-protected titles, offered a disk picture of the proper format.
  • IBM/Xebec 20MB HDC – Emulated with fundamental VHD assistance. MartyPC presently supports a single disk geometry of 20MB when utilizing this controller.
  • XT-IDE – Emulation of the XT-IDE Rev 2 board enables MartyPC to support a vast array of hard drive formats. This emulation is still in early phases, and might be a bit rough around the edges. Not all ATA commands are executed.
  • jr-IDE – Emulation of the jr-IDE offers the IBM PCjr maker with IDE hard drive assistance and 736K of memory backfill. Other functions such as the RTC and flash are not yet executed.
  • PCjr Cartridges – PCjr cartridge ROMs are supported, in Jr RipCart (. JRC) format

• Memory Expansion Devices:

  • Lo Tech 2MB EMS Card – 2MB of EMS memory is provided by means of the LoTech EMS board.
  • Generic Memory Expansion Cards – Memory growth cards can be specified for either the ISA bus or PCjr SideCar growth slot.
• • Keyboard Support – IBM Model F, Tandy 1000, and PCjr keyboards are imitated.
  • Serial Mouse – A basic Microsoft serial mouse can be linked to the COM port of your option.
  • Joystick – Game port joysticks are imitated by means of configurable keyboard controls.
  • Light Pen – A light pen is imitated for the CGA card and the PCjr.

MartyPC supports dual-video card and multi-monitor setups, so you can run a secondary display powered by an MDA or Hercules adapter – even in the exact same window. Each show viewport can get independent shader setups.

MartyPC supports customized maker setups by means of base maker setup profiles plus optional extensions called ‘overlays’, analagous to setting up extension cards or other upgrades.

MartyPC has a comprehensive debugging GUI with numerous helpful display screens consisting of direction disassembly, CPU state, memory audience,
and numerous peripheral states. Code and memory breakpoints are supported. MartyPC likewise supports direction and cycle-based logging.

A fundamental, configurable CRT shader is consisted of with more to come (LibraShader assistance is prepared)

For more, have a look at the Screenshot Gallery section of the Wiki!

I have a long list of individuals to thank (See the About box!), however I would specifically like to point out the contributions made byreenigne Without his work reverse-engineering the 8088 microcode, this emulator would never ever have actually been possible. I would likewise like to thank Ken Shirriff and his excellent blog, covering much of the silicon reasoning of the 8086 (and 8088 by extension).