VS Code+Ubuntu环境下Chisel开发环境搭建全攻略（含WSL2配置）

VS CodeUbuntu环境下Chisel开发环境搭建全攻略含WSL2配置最近几年硬件描述语言领域出现了一股新潮流——用高级编程语言来设计硬件。ChiselConstructing Hardware in a Scala Embedded Language正是这一趋势下的产物。作为一个基于Scala的领域特定语言DSLChisel让硬件设计变得更像软件开发这对于习惯传统Verilog/VHDL的工程师来说可能需要一个适应过程但一旦掌握开发效率将大幅提升。本文将手把手带你完成从零开始的Chisel开发环境搭建涵盖Ubuntu原生系统和WSL2两种环境。无论你是完全没有Scala/Verilog背景的新手还是想尝试新工具的资深工程师都能找到适合自己的配置方案。我们会重点解决环境配置中的常见坑点比如Java版本冲突、sbt下载慢等问题。1. 环境准备选择你的开发平台在开始之前你需要决定使用哪种开发环境。目前主流的有三种选择原生Ubuntu系统性能最佳适合长期进行Chisel开发的用户WSL2Windows Subsystem for LinuxWindows用户的折中方案云开发环境如GitHub Codespaces免配置但网络依赖性强提示如果你主要使用Windows系统WSL2是最佳选择。它比虚拟机更轻量又能提供完整的Linux开发体验。1.1 WSL2环境配置仅Windows用户如果你选择WSL2需要先完成以下准备工作# 以管理员身份打开PowerShell执行 wsl --install -d Ubuntu-22.04 wsl --set-default-version 2安装完成后在开始菜单中启动Ubuntu终端进行初始设置sudo apt update sudo apt upgrade -y sudo apt install build-essential git curl -y验证WSL2版本wsl --list --verbose应该能看到类似这样的输出NAMESTATEVERSIONUbuntu-22.04Running21.2 原生Ubuntu系统准备对于使用原生Ubuntu系统的用户确保系统已经更新到最新sudo apt update sudo apt upgrade -y sudo apt install build-essential git curl -y2. 基础工具链安装Chisel开发需要几个核心组件Java运行时、Scala编译器和sbt构建工具。以下是详细的安装步骤。2.1 Java开发环境配置Chisel需要Java 8或11推荐使用OpenJDK 11sudo apt install openjdk-11-jdk -y验证安装java -version应该能看到类似输出openjdk version 11.0.22 2024-01-16 OpenJDK Runtime Environment (build 11.0.227-post-Ubuntu-0ubuntu222.04.1) OpenJDK 64-Bit Server VM (build 11.0.227-post-Ubuntu-0ubuntu222.04.1, mixed mode, sharing)注意如果你的系统中有多个Java版本可以使用update-alternatives来管理默认版本。2.2 安装sbt构建工具sbt是Scala项目的标准构建工具。由于官方源的版本可能较旧我们手动添加sbt仓库echo deb https://repo.scala-sbt.org/scalasbt/debian all main | sudo tee /etc/apt/sources.list.d/sbt.list echo deb https://repo.scala-sbt.org/scalasbt/debian / | sudo tee /etc/apt/sources.list.d/sbt_old.list curl -sL https://keyserver.ubuntu.com/pks/lookup?opgetsearch0x2EE0EA64E40A89B84B2DF73499E82A75642AC823 | sudo apt-key add sudo apt update sudo apt install sbt -y验证安装sbt sbtVersion首次运行会下载大量依赖可能需要较长时间。完成后会显示类似[info] 1.9.72.3 解决sbt下载慢的问题国内用户可能会遇到sbt下载依赖慢的问题。可以通过以下方法加速创建~/.sbt/repositories文件mkdir -p ~/.sbt/repositories添加以下内容[repositories] local maven-central: https://maven.aliyun.com/repository/public typesafe-ivy-releases: https://repo.typesafe.com/typesafe/ivy-releases/, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]3. VS Code开发环境配置VS Code是目前最适合Chisel开发的IDE配合适当的插件可以提供接近专业EDA工具的开发体验。3.1 安装VS Code在Ubuntu/WSL2中安装VS Codesudo apt install wget gpg wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/ sudo sh -c echo deb [archamd64 signed-by/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main /etc/apt/sources.list.d/vscode.list sudo apt update sudo apt install code -y对于WSL2用户也可以在Windows端安装VS Code然后安装Remote - WSL扩展。3.2 必备插件安装打开VS Code后安装以下关键插件Scala (Metals)提供Scala语言支持Scala SyntaxScala语法高亮Chisel3 Syntax HighlightChisel语法高亮GitLensGit集成Rainbow Brackets括号匹配高亮安装完成后按CtrlShiftP打开命令面板输入Metals: New Scala project创建一个测试项目验证环境是否正常。4. 创建第一个Chisel项目现在我们来创建一个标准的Chisel项目结构。4.1 项目初始化mkdir my-chisel-project cd my-chisel-project mkdir -p src/main/scala touch build.sbt编辑build.sbt文件添加以下内容ThisBuild / scalaVersion : 2.13.10 ThisBuild / version : 0.1.0 lazy val root (project in file(.)) .settings( name : my-chisel-project, libraryDependencies edu.berkeley.cs %% chisel3 % 3.6.0, addCompilerPlugin(edu.berkeley.cs % chisel3-plugin % 3.6.0 cross CrossVersion.full) )4.2 编写第一个Chisel模块创建src/main/scala/Hello.scala文件import chisel3._ class Hello extends Module { val io IO(new Bundle { val led Output(Bool()) }) val counter RegInit(0.U(32.W)) counter : counter 1.U io.led : counter(25) } object Hello extends App { (new chisel3.stage.ChiselStage).emitVerilog(new Hello(), Array(--target-dir, generated)) }4.3 编译并生成Verilog在项目根目录运行sbt run如果一切正常你会在generated目录下看到生成的Verilog文件Hello.v。5. 常见问题解决在实际环境搭建过程中你可能会遇到以下问题5.1 Java版本冲突症状sbt运行时出现Unsupported major.minor version错误解决方案sudo update-alternatives --config java选择Java 11对应的版本号。5.2 WSL2中VS Code无法启动症状在WSL终端输入code .没有反应解决方案在Windows端安装VS Code安装Remote - WSL扩展在WSL终端中运行code --install-extension ms-vscode-remote.remote-wsl5.3 sbt下载卡住症状sbt在resolving dependencies阶段长时间无响应解决方案按CtrlC中断当前进程删除~/.ivy2和~/.sbt目录按照前面解决sbt下载慢的问题一节配置镜像源重新运行sbt命令6. 进阶配置与优化环境基本可用后我们可以进行一些优化配置提升开发体验。6.1 配置VS Code的Scala环境在项目根目录创建.scalafmt.conf文件version 3.7.14 maxColumn 120 align.preset more continuationIndent.defnSite 2 assumeStandardLibraryStripMargin true docstrings.style Asterisk lineEndings unix includeCurlyBraceInSelectChains false includeNoParensInSelectChains false optIn.breakChainOnFirstMethodDot false rewrite.rules [SortImports, RedundantBraces]然后在VS Code设置中启用Format on Save。6.2 添加测试支持修改build.sbt添加测试依赖libraryDependencies edu.berkeley.cs %% chiseltest % 0.6.0 % test创建测试目录和示例测试mkdir -p src/test/scala创建src/test/scala/HelloTest.scalaimport chisel3._ import chiseltest._ import org.scalatest.flatspec.AnyFlatSpec class HelloTest extends AnyFlatSpec with ChiselScalatestTester { behavior of Hello it should toggle led in { test(new Hello()) { c c.io.led.expect(false.B) c.clock.step(1 25) c.io.led.expect(true.B) } } }运行测试sbt test6.3 性能优化建议对于WSL2用户可以显著提升文件系统性能在Windows端创建%UserProfile%\.wslconfig文件添加以下内容[wsl2] memory8GB processors4 localhostForwardingtrue重启WSL实例wsl --shutdown对于大型项目可以配置sbt的JVM参数。创建~/.sbt/1.0/sbtopts文件-J-Xmx4G -J-Xms2G -J-XX:UseG1GC -J-XX:MaxGCPauseMillis200