This VS Code extension provides a user interface and commands for working with the RV64I toolchain, including setup, building, and simulation of RV64I assembly programs.
Features
Setup Wizard (UI): Interactive webview panel for detecting and installing required toolchain components.
Automated Setup: Command-line based setup for headless environments.
Build All: Compile all targets in the project using CMake.
Build Current Target: Build the target corresponding to the currently open file.
Simulate Current Target: Run simulation for the current target using xsim.
Tool Detection: Automatically detect installed tools and report missing ones.
Path Configuration: Manually set paths for toolchain executables.
Requirements
This extension requires the following tools to be installed:
CMake: For building projects (version 3.10 or higher recommended).
RISC-V GCC Toolchain: Specifically riscv64-unknown-elf-gcc for compiling RV64I code.
Xilinx Simulator (xsim): For simulating compiled binaries.
Git: For cloning repositories during setup (optional but recommended).
The extension includes an automated setup wizard that can detect and install missing tools. On Windows, it supports automatic installation of MinGW-w64 and other components.
How to Use
Installation: Install the extension from the VS Code marketplace or by packaging it with vsce package.
Initial Setup:
Open the Command Palette (Ctrl+Shift+P) and run RV64I: Setup Extension Wizard(UI) to launch the interactive setup panel.
Alternatively, run RV64I: Setup Wizard for a command-line based setup.
Using Commands:
Build All: Run RV64I: Build All to compile all targets in your project.
Build Current: With an RV64I assembly file open, run RV64I: Build Current Target to build that specific target.
Simulate: After building, run RV64I: Simulate Current Target to launch the simulator.
Project Structure: Ensure your project has a CMakeLists.txt file configured for RV64I builds. The extension assumes targets are named like fw_asm_<filename> for firmware and sim_<filename> for simulations.
Extension Settings
This extension does not contribute any VS Code settings at this time.
Known Issues
Simulation requires proper setup of Xilinx Vivado environment.
Path detection may not work on all systems; manual configuration is available.
Release Notes
0.0.1
Initial release with basic toolchain commands and setup wizard.
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
Split the editor (Cmd+\ on macOS or Ctrl+\ on Windows and Linux)
Toggle preview (Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux)
Press Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets
