Zx7E4

Zx7E4 is a processor simulated using VHDL.
The name is the combination of zero-based and 0x7E4 (2020 in HEX).

Stack

• GHDL: an open-source simulator for the VHDL language.
• VUint: an open source unit testing framework for VHDL.
• GTKWave: a fully featured GTK+ based wave viewer.

Start

1. Install Docker Desktop for Windows.
2. Install VcXsrv Windows X Server.
3. Run both Docker Desktop and VcXsrv (with default config).

Run Container

docker-compose run --rm main python run.py

VS Code Task: run-container (Ctrl + Shift + B)

Run Container (Graphical Mode)

docker-compose run --rm main python run.py -g

VS Code Task: run-container-graphical

Guidelines

• Use VHDL Formatter for code formatting.
• Use short descriptive names.
• Use Generics and Constants wherever possible.
• Configure tab size to 2 spaces.