Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dbalsom/martypc
An IBM PC/XT emulator written in Rust.
https://github.com/dbalsom/martypc
emulation emulator ibm rust x86
Last synced: 3 months ago
JSON representation
An IBM PC/XT emulator written in Rust.
- Host: GitHub
- URL: https://github.com/dbalsom/martypc
- Owner: dbalsom
- License: other
- Created: 2022-05-23T01:40:18.000Z (about 2 years ago)
- Default Branch: version_0_2_0
- Last Pushed: 2024-02-21T19:28:00.000Z (3 months ago)
- Last Synced: 2024-02-22T16:02:10.043Z (3 months ago)
- Topics: emulation, emulator, ibm, rust, x86
- Language: Rust
- Homepage:
- Size: 8.03 MB
- Stars: 427
- Watchers: 20
- Forks: 15
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Lists
- awesome-emulators-android - MartyPC
- awesome-emulators - MartyPC
- awesome-rust - MartyPC
README
# MartyPC
### User Guide
[Click here to access the MartyPC User Guide.](https://github.com/dbalsom/martypc/wiki/MartyPC-User-Guide)
MartyPC is a cross-platform IBM PC emulator written in Rust. Development began April, 2022. It should build on Windows, Linux and MacOS (Including M1). Currently, releases are Windows only.
### Why another PC emulator?
MartyPC was originally just a hobby project to see if I could write an emulator from scratch, while learning the Rust programming language. My original goals were modest, but MartyPC has reached a level of functionality that I never thought possible when originally starting. I would be happy if MartyPC could serve as a "reference emulator" - perhaps not the fastest or most fully featured, but written in a clear, readable way that describes the operation of the system and hardware, and is packed with debugging tools and ample logging for developers of emulators or oldschool software.
## Accuracy
I began work on making MartyPC's 8088 CPU emulation cycle-accurate in November of 2022. To do so, I validated the operation of the CPU against a real 8088 CPU connected to an Arduino MEGA microcontroller. See my [Arduino8088 project](https://github.com/dbalsom/arduino_8088) for more details. This allows an instruction to be simultaneously executed on the emulator and a real CPU and the execution results compared, cycle-by-cycle. More info on this process is described [on my blog](https://martypc.blogspot.com/2023/06/hardware-validating-emulator.html).
In April 2023, MartyPC became accurate enough to run the infamous PC demo, 8088MPH.
In May 2023, MartyPC became the first PC emulator capable of emulating every effect in the PC demo Area 5150. (See video here: https://www.youtube.com/watch?v=zADeLm9g0Zg )
In June of 2023, the WebAssembly build of MartyPC could run both [8088MPH](https://dbalsom.github.io/martypc/web/player.html?title=8088mph) and [Area 5150](https://dbalsom.github.io/martypc/web/player.html?title=area5150) in your web browser!
## Special Thanks
I have a long list of people to thank (See the About box!) but I would especially like to mention the contributions made by reenigne. Without his work reverse-engineering the 8088 microcode, this emulator would never have been possible. I also thank him for putting up with my endless questions.
## Features
Currently MartyPC will emulate an original IBM 5150 PC or 5160 XT.
The following devices are at least partially implemented:
* CGA Card - A fairly accurate, cycle-based implementation of the IBM CGA including the Motorola MC6845 CRTC controller allows MartyPC to run many demanding PC demos. Composite output and monitor simulation is supported, with MartyPC emulating an "old style" CGA. Some work still remains on getting better composite color accuracy.
* EGA/VGA Cards - Basic graphics modes are supported: 320x200, 640x350 & 640x480 16-color, and Mode13 (320x200 /w 256 colors). CGA compatibility modes remain unimplemented. May need conversion to cycle-accurate forms for games like Commander Keen. Work in progress.
* µPD764 Floppy Disk Controller - Enough FDC commands are implemented to make DOS happy.
* IBM 20MB Fixed Disk Controller - Emulated with basic VHD support, although only one specific drive geometry is supported so you will need to use the VHDs created by the emulator.
* 8255 PPI
* 8259 PIC
* 8253 PIT - Recently rewritten after microcontroller-based research. At least one previously undocumented feature discovered. Accurate enough for PCM audio.
* 8237 DMA Controller - Mostly implemented, but DMA transfers are currently "faked". DRAM refresh DMA is simulated using a scheduling system.
* 8250 UART - COM1 hard-coded to mouse, COM2 is available for serial passthrough to a host adapter.
* Mouse - A standard Microsoft Mouse is implemented on COM1.
* PC Speaker - Beeps and boops, although still a little glitchy, it can produce reasonable PCM audio in demos such as 8088MPH, Area5150, and Magic Mushroom.
Marty has a GUI with a several useful debugging displays including instruction disassembly, CPU status, memory viewer, and various internal device states.
## Screenshots
