First Steps

[Português]

[← Previous Page | Next Page →]

First Steps

Before running the simulation, a few tools are required. This isn't a precise step-by-step guide, but it provides all the information you need to get started.

---

🖥️ Visual Simulation (Logisim Evolution)

If you just want to explore the visual simulation, you'll need:

• Java 21 — required to run the simulator
• Logisim Evolution — preferably the latest version

After installing Java and downloading the .jar file for Logisim Evolution, you can open it directly. To load the simulation file, go to File > Open and select either drisc.circ or drisc_with_no_csr.circ located at the root of this repository.

---

⚙️ SystemVerilog Simulation

To run the SystemVerilog simulation, you'll need:

• Icarus Verilog — the recommended simulator (others may work but could lack full compatibility)
• Visual Studio Code — for editing and running the simulation via its internal terminal
  (Note: Running the simulation directly through the Windows terminal may not display colors correctly)

🔍 Recommended Tools for SV Simulation

• VaporView — VS Code extension for inspecting waveform output
• SystemVerilog - Language Support — syntax highlighting for SystemVerilog
• .NET Framework — required if you prefer using the lightweight executable instead of the full SV interface
• ⚠️ The simulation may run on Linux, but some features are not guaranteed to work

Once everything is installed, open the verilog folder in Visual Studio Code by going to File > Open Folder, selecting the folder, and choosing to trust its authors.

---

🧾 Writing Assembly Programs

For writing assembly code for the simulations, it's recommended to use Notepad++, as this repository includes syntax highlighting support.

To install the custom language definition in Notepad++:

1. Go to Language > User Defined Language > Define Your Language
2. In the window that appears, click Import
3. Select the file DRISC_Notepad++_Syntax_Hilight.xml located at the root of this repository