https://github.com/thefox/i8086emu

An Intel 8086 CPU Emulator written in pure PHP.
https://github.com/thefox/i8086emu

emulator intel-8086 mit-license php php7 x86

Last synced: 24 days ago
JSON representation

An Intel 8086 CPU Emulator written in pure PHP.

• Host: GitHub
• URL: https://github.com/thefox/i8086emu
• Owner: TheFox
• License: mit
• Created: 2018-06-24T10:27:38.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-03-23T19:56:28.000Z (almost 5 years ago)
• Last Synced: 2024-04-19T16:43:03.245Z (8 months ago)
• Topics: emulator, intel-8086, mit-license, php, php7, x86
• Language: PHP
• Homepage: https://fox21.at
• Size: 298 KB
• Stars: 25
• Watchers: 5
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG-v0.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Intel 8086 CPU Emulator

An Intel 8086 CPU Emulator written in pure PHP.

## Project Outlines

The project outlines as described in my blog post about [Open Source Software Collaboration](https://blog.fox21.at/2019/02/21/open-source-software-collaboration.html).

- The main purpose of this software is to emulate the Intel 8086 CPU using pure PHP.

- The features should not go beyond Intel's features and functions. So the features of this software are limited to those of the Intel 8086 CPU.

- This list is open. Feel free to request features.

## Compile the BIOS

Run `make bios/bios`.

## TTY

In order to have a TTY for the in- and output you can specify `--tty `. This will start a `socat` subprocess to create an interface between PHP and TTY. The TTY then can be accessed using `screen`.

Optional, to use a different installation path for the `socat` binary you can specify `--socat `.

1. Install `socat`.

2. Open a shell and run `./bin/screen.sh`.

3. Open another shell and run `./bin/run.sh`.

## Terms

- `Byte` - 8 bit, one single character.

- `Word` - 16 bit, or 2 Byte.

## 8086 Resources

- [Wikipedia: Intel 8086](https://en.wikipedia.org/wiki/Intel_8086)

- [Wikipedia: Processor Register](https://en.wikipedia.org/wiki/Processor_register)

- [Wikipedia: FLAGS Register](https://en.wikipedia.org/wiki/FLAGS_register)

- [Wikipedia: Parity Flag](https://en.wikipedia.org/wiki/Parity_flag)

- [Wikipedia: Word](https://en.wikipedia.org/wiki/Word_(computer_architecture))

- [8086 opcodes](http://www.mlsite.net/8086/)

- [StackExchange: Emulate an Intel 8086 CPU](https://codegolf.stackexchange.com/questions/4732/emulate-an-intel-8086-cpu)

- [x86 Registers](http://www.eecg.toronto.edu/~amza/www.mindsec.com/files/x86regs.html)

- [Encoding x86 Instructions](https://www-user.tu-chemnitz.de/~heha/viewchm.php/hs/x86.chm/x86.htm)

- [Encoding x86 Instruction Operands, MOD-REG-R/M Byte](http://www.c-jump.com/CIS77/CPU/x86/X77_0060_mod_reg_r_m_byte.htm)

- [X86 Assembly/X86 Architecture](https://en.wikibooks.org/wiki/X86_Assembly/X86_Architecture)

- [X86-64 Instruction Encoding](http://wiki.osdev.org/X86-64_Instruction_Encoding)

- [OUT -- Output to Port](https://pdos.csail.mit.edu/6.828/2010/readings/i386/OUT.htm)

- [MDA, CGA, HGC, EGA, VGA, SVGA, TIGA](https://www.tu-chemnitz.de/informatik/RA/news/stack/kompendium/vortraege_98/grafik/adaptertypen.html) (German)

- [8086/88 Assembler Befehlsreferenz](http://www.i8086.de/asm/8086-88-asm.html) (German)

- [X86 Opcode and Instruction Reference](http://ref.x86asm.net/coder32.html)

- [Understanding Intel Instruction Sizes](https://www.swansontec.com/sintel.html)

## More Resources

- [How To Write a Computer Emulator](https://fms.komkon.org/EMUL8/HOWTO.html)