Skip to content

doc: Add Windows WSL simulation setup guide#2399

Open
scarletnova20 wants to merge 1 commit into
lowRISC:masterfrom
scarletnova20:doc/windows-wsl-simulation-guide
Open

doc: Add Windows WSL simulation setup guide#2399
scarletnova20 wants to merge 1 commit into
lowRISC:masterfrom
scarletnova20:doc/windows-wsl-simulation-guide

Conversation

@scarletnova20
Copy link
Copy Markdown

This PR adds a setup guide for running the Ibex Verilator
simulation on Windows via WSL (Ubuntu 24).

Relates to #741.

What's documented

  • Setting up WSL and all required dependencies
  • Python venv setup (required on Ubuntu 24)
  • riscv64 → riscv32 symlink workaround
  • GCC 13 zicsr extension fix
  • srecord installation for vmem generation
  • Correct FuseSoC flags and absolute path requirement

Tested on

  • Windows 11, WSL2, Ubuntu 24.04
  • Verilator 5.020
  • GCC 13.2.0
  • FuseSoC 2.4.5

Document the steps required to run the Ibex Verilator
simulation on Windows via WSL, including all dependency
fixes needed for Ubuntu 24 and GCC 13.

Fixes encountered and documented:
- Python venv required due to externally-managed env
- edalize and packaging must be installed separately
- riscv32 symlinks needed for riscv64 toolchain
- zicsr extension required for GCC 13 compatibility
- srecord needed for vmem file generation
- SRAMInitFile requires absolute path

Relates to lowRISC#741
@h-filali
Copy link
Copy Markdown

h-filali commented May 6, 2026

Thanks a lot @scarletnova20 for opening this PR and sharing your WSL setup guide.

However, we try to keep the documentation aligned with environments we actively work on and maintain.

That being said I think this is still useful information that could be documented in an issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants