Repository files navigation

I've written a blog article that gives an overview of this project and how it is used.

https://martypc.blogspot.com/2023/06/hardware-validating-emulator.html

This project was originally called Arduino8088, but then I expanded it to support the 8086, 80186, 80286, with plans forthe 80386, so it is now named the suitably generic ArduinoX86.

This project expands on the basic idea of controlling a CPU via GPIO pins to clock the CPU and read and write controland data signals. This can be used to validate an emulator's accuracy, but also as a general method of exploring theoperation of CPU instructions and timings.

This project currently supports the following CPUs:

• CMOS variants of the 8088 (Oki, Harris 80C88, etc.)
• AMD D8088
• CMOS variants of the 8086 (Intel 80C86, Harris 80C86)
• NEC V20
• NEC V30
• Intel 80L186
• Harris 80C286
• Intel 80386EX

Where it differs from existing Raspberry Pi-based projects is that it uses an Arduino Giga for the expanded number ofGPIO pins available. The Giga has enough GPIO to operate 808X-compatible CPUs in Maximum mode. This enables severaluseful signals to be read such as the QS0 & QS1 processor instruction queue status lines, which give us more insightinto the internal state of the CPU. We can also enable inputs such as READY, NMI, INTR, and TEST, so we can executeinterrupts, NMIs, emulate wait states, and potentially even simulate FPU and DMA operations.

I have been using this project to validate the cycle-accuracy of my PCemulator,MartyPC, and produce CPU testsuites for emulators, coveringthe8088,V20and8086 and286 to date.

This project has three main components:

• The CPU server software, which runs on the Arduino, and establishes a serial protocol to reset the CPU, load and storeregister state, as well as interactively operate the CPU if desired;
• The CPU client software, which runs on your computer and controls the CPU after the CPU server has set up initialregister state as desired, or uploads an entire program to be run automatically with register state collected at theend of execution;
• The CPU socket PCB shields, which seat on top of the Arduino, and provide a physical interface between the CPU andGPIOlines.

The original "Arduino8088" project utilized an Arduino MEGA, but this board no longer supported.It is painfully slow and limited to a serial UART instead of fast native USB communication. As of the currentrelease, anArduino Due, or preferably,anArduino GIGA should be used instead. A GIGA is required tooperate 5V CPUs such as older 80186's and the 80286. Despite Arduino's official warnings, the STM32 GPIO in the Giga is5V tolerant (with a few exceptions). You will likely void your warranty and I take no responsibility for any damage toyour Arduino that occurs attempting to use a 5V CPU with your Arduino.

Revision 1.1 of the 808X shield supports the 8086 and NEC V30 by adding a connection for the 8086's BHE pin.

The Due can operate the 8088, 8086, V20 and V30, despite these chips being 5V. The current 8088 shield feeds those CPUs3.3V which they tolerate quite well at low clock speeds.

The Giga can operate the 8088, 8086, V20 and V30 directly at 5V if desired. The Giga requires the 3V supply pin to becut off the shield's pin headers and external power supplied due to the lower available overall power budget.

The ArduinoX86 cpu_server sketch supports operation of a low-voltage 80L186 on an Arduino Due.

There is no shield yet for the 80186, you will need to use a breakout board and connect directly to the Arduino Due'sheaders. SeeUsing an 80186 for more information.

A shield for the 80C286 is in the design phase, located in/shields/286_5V

Current support for the 80286 has been performed via breadboard.

A shield for the 80386EX CPU is provided in/shields/386EX_V4

In short, no. We are well past the published minimum cycle times when executing programs via a serial protocol, cycle bycycle. Some chips tolerate this better than others. When working with an Intel branded 8088, I noticed that effectiveaddress calculations were failing to add the displacement or index register, but otherwise functioned. I have had moreluck with the AMD second-source 8088 CPUs, which seem to function perfectly under slow clocks, although they will hangand need to be reset if not cycled for a several milliseconds. The issue is "dynamic logic" - logic gates that losetheir state if not refreshed electrically within a frequent enough interval. To be absolutely safe, it is best to use afully CMOS process CPU such as the 80C88. CMOS versions of most x86 chips are available.

An example application for cpu_server is provided, written in Rust, in the/crates/exec_program directory. Itdemonstrates how to upload arbitrary code to the ArduinoX86 and display cycle traces. The client will emulate theentire address space and set up a basic IVT.

Assembly language files, intended to be assembled with NASM. To execute code on the ArduinoX86, one must supply twobinary files, one containing the program to be executed, and one containing the register values to load onto the CPUbefore program execution.

A library crate that implements a client for the ArduinoX86's serial protocol.

A library crate built on top of thearduinox86_client crate, this provides aRemoteCpu struct that models CPU stateand can execute programs.

A GUI (written in egui) for ArduinoX86, supporting the 386EX. It allows you to write and assemble assembly-languageprograms and execute them on the CPU with an easy-to-use interface.

A binary implementing an interface for thearduinox86_cpu crate that will load a provided register state binary andexecute the specified program binary.

A program that generates CPU tests for emulator authors.

Contains the KiCad project files and Gerber files for the various ArduinoX86 shields. See the README.md in each shielddirectory for more information and BOMs for building each.

The main server code that runs on the Arduino Due or GIGA. You must haveplatformio installedto build and upload the project to your Arduino.

The original cpu_server Arduino IDE sketch. Development has since moved to platformio.

The original sketch for Arduino MEGA only demonstrating how to control an 8088. It does not contain a serial protocolserver - code is run directly from an array defined within the sketch.

• Ordering boards from any of the KiCad projects is extremely simple using PCBWay's KiCad fabrication plugin.
  • From the Plugin and Content Manager, go the Fabrication Plugins tab, find the PCBWay plugin and install.
  • 
  • Open the PCB editor and click the PCBWay Button
  • 
  • A browser window will open to PCBWay's website with the project uploaded and acceptable defaults selected.
  • If you like you can change the board color, or get a nicer finish with gold (ENIG).
  • 
  • You can then proceed to ordering. Part of your purchase goes back to help fund the KiCad project, which is cool.
  • 

Inspired by the Pi8088 validator created by Andreas Jonsson as part of the VirtualXT project:

https://github.com/andreas-jonsson/virtualxt/tree/develop/tools/validator/pi8088

• 8bitforce's Retroshield:https://www.8bitforce.com/projects/retroshield/

• homebrew8088's Raspberry Pi Hat:https://github.com/homebrew8088/pi86

• The Universal Chip Analyser (U. C. A.):https://x86.fr/uca/

• Foxtech's 486 Breadboard Computer:https://www.youtube.com/watch?v=wSiDSdHS2QQ