Skip to content

doc: Add Windows WSL simulation setup guide#2399

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

doc: Add Windows WSL simulation setup guide#2399
scarletnova20 wants to merge 1 commit intolowRISC: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
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.

1 participant