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.
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.
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.
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.
More details about the Breadboard computer in itself can be found there, along with the full parts list
That build uses some 28C series EEPROM to emulate large combinatorial logic, those will need to be programmed
I used that EEPROM Programmer : https://tomnisbet.github.io/TommyPROM/docs/hardware If like me, you used an Arduino Nano Every instead of a Nano V3 for the EEPROM Programmer, that Programmer will need some rework to actually work as intended (see this repo for the adapted code and wiring diagram)
- 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
- Arduino Programmer
