从零到点亮LED：用Chisel和VSCode在Ubuntu上快速构建你的第一个数字电路（含波形仿真）-平芜编程栈

从零到点亮LED：用Chisel和VSCode在Ubuntu上快速构建你的第一个数字电路（含波形仿真）

在数字电路设计领域，Chisel（Constructing Hardware in a Scala Embedded Language）正逐渐成为连接软件思维与硬件实现的高效桥梁。不同于传统的Verilog或VHDL，Chisel允许开发者使用Scala这一强大的函数式编程语言来描述硬件，从而获得更高级的抽象能力和代码复用性。本教程专为硬件设计初学者或具备软件背景的探索者设计，将带领你在Ubuntu系统中完成从环境配置到波形仿真的全流程实践，最终实现一个可交互验证的LED控制电路。

1. 环境配置：构建Chisel开发基础

1.1 Java与Scala环境部署

Chisel作为基于Scala的DSL，其运行依赖于Java虚拟机环境。我们推荐使用OpenJDK 11这一长期支持版本，它在稳定性和兼容性方面都有良好表现。在终端中执行以下命令完成安装：

sudo apt update sudo apt install -y openjdk-11-jdk

安装完成后，通过java -version和javac -version验证安装是否成功。接下来安装Scala 2.12.x系列（目前Chisel对Scala 3的支持仍在完善中），建议从官网下载tgz包进行手动安装：

wget https://downloads.lightbend.com/scala/2.12.15/scala-2.12.15.tgz tar -xvzf scala-2.12.15.tgz sudo mv scala-2.12.15 /usr/local/share/

将Scala添加到系统路径中，编辑~/.bashrc文件，在末尾添加：

export PATH="$PATH:/usr/local/share/scala-2.12.15/bin"

执行source ~/.bashrc使配置生效，然后运行scala -version检查安装结果。

1.2 SBT构建工具配置

SBT（Simple Build Tool）是Scala项目的标准构建工具，相当于Java中的Maven或Gradle。虽然Ubuntu仓库提供了sbt包，但版本往往较旧，我们推荐手动安装最新稳定版：

echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x2EE0EA64E40A89B84B2DF73499E82A75642AC823" | sudo apt-key add sudo apt update sudo apt install -y sbt

为加速依赖下载，可配置国内镜像源。创建~/.sbt/repositories文件，内容如下：

[repositories] local huaweicloud-maven: https://repo.huaweicloud.com/repository/maven/ maven-central: https://repo1.maven.org/maven2/

2. 创建第一个Chisel项目

2.1 初始化项目结构

使用VSCode作为开发环境，首先安装Scala Metals插件以获得语法高亮和代码补全功能。然后创建一个新目录作为项目根目录，并建立标准的sbt项目结构：

led_project/ ├── build.sbt ├── project/ │ └── build.properties └── src/ ├── main/ │ └── scala/ │ └── LedController.scala └── test/ └── scala/ └── LedControllerTester.scala

在build.sbt中配置项目依赖：

scalaVersion := "2.12.15" libraryDependencies ++= Seq( "edu.berkeley.cs" %% "chisel3" % "3.5.0", "edu.berkeley.cs" %% "chiseltest" % "0.5.0" % "test" ) addCompilerPlugin("edu.berkeley.cs" % "chisel3-plugin" % "3.5.0" cross CrossVersion.full)

2.2 编写LED控制器模块

在src/main/scala/LedController.scala中实现一个简单的LED闪烁控制器：

import chisel3._ class LedController(maxCount: Int) extends Module { val io = IO(new Bundle { val led = Output(Bool()) }) val counter = RegInit(0.U(32.W)) counter := counter + 1.U when(counter >= maxCount.U) { counter := 0.U } io.led := counter < (maxCount/2).U } object LedController extends App { (new chisel3.stage.ChiselStage).emitVerilog( new LedController(10000000), Array("--target-dir", "generated") ) }

这个模块实现了一个32位计数器，当计数值超过设定的阈值时复位，并控制LED在计数值小于阈值一半时点亮。

3. 测试与波形仿真

3.1 编写测试用例

在src/test/scala/LedControllerTester.scala中添加测试逻辑：

import chisel3._ import chiseltest._ import org.scalatest.flatspec.AnyFlatSpec class LedControllerTest extends AnyFlatSpec with ChiselScalatestTester { behavior of "LedController" it should "toggle LED periodically" in { test(new LedController(10)).withAnnotations(Seq(WriteVcdAnnotation)) { dut => dut.clock.setTimeout(0) for (_ <- 0 until 30) { dut.clock.step() println(s"LED state: ${dut.io.led.peek().litToBoolean}") } } } }

3.2 运行测试并生成波形

在项目根目录下执行测试命令：

sbt "testOnly LedControllerTest"

测试完成后，会在test_run_dir目录下生成.vcd波形文件。安装VSCode的WaveTrace插件，打开生成的波形文件，可以看到类似如下的信号变化：

时钟周期	计数器值	LED状态
0	0	低
1	1	低
...	...	...
5	5	高
6	6	高
...	...	...
10	0	低

4. 进阶功能与优化建议

4.1 参数化设计改进

Chisel的强大之处在于可以利用Scala的特性实现高度参数化的硬件设计。我们可以改进LED控制器，使其支持更多功能：

class AdvancedLedController( maxCount: Int, blinkPattern: Seq[Boolean] = Seq(true, false) ) extends Module { val io = IO(new Bundle { val led = Output(Bool()) }) val counter = RegInit(0.U(log2Ceil(maxCount).W)) val patternIndex = RegInit(0.U(log2Ceil(blinkPattern.size).W)) counter := counter + 1.U when(counter >= (maxCount-1).U) { counter := 0.U patternIndex := patternIndex + 1.U when(patternIndex >= (blinkPattern.size-1).U) { patternIndex := 0.U } } io.led := blinkPattern(patternIndex.litValue().toInt).B }