alban098 / breadboard-cpu-emulator

Breadboard CPU Emulator

Compiler

This CLI will compile an assembly file into a .rom file that can be executed by the emulator and ran on the actual Breadboard computer (WIP).

See assembly details for more details on the Assembly language itself.

Usage

You can compile a file by passing the following parameter to the CLI of the compiler.

java -jar compiler.jar -f sample.asm -o sample.rom

if no -o X is passed, the binary file will be saved with the same name as the input file with a .rom extension.

Emulator

The emulator is based on real world breadboard computer inspired by this project that is not yet finished.

To run a binary file, just pass its path as an argument to the emulator.

ROM & Instructions dumps

To facilitate physical assembly and proper emulation from instruction opcode down to signal indices in the control words, the emulator has the ability to dump the content of it's program ROM, both in "humanly readable format" and as the binary blob that should be written to the 3 EEPROM that will be located in the Control Unit :

• Dump 0 for the 8 least bits of the Control Word
• Dump 1 for the 8 middle bits of the Control Word
• Dump 2 for the 8 most significant bits of the Control Word

The emulator can also dump the current instruction set.

Physical Computer

More details about the Breadboard computer in itself can be found there, along with the full parts list

Roadmap

• Instruction set
• Assembly compiler
• Emulator
  • Components
  • Signals
  • Instructions
• Documentation
• Electrical diagrams
• Electronic components ordering
• Physical assembly
  • Clock module
  • Program counter
  • Registers
  • ALU
  • Status register
  • Memory modules
  • Control Unit
  • ESP32 based programmer