手把手教你用Verilog实现双控开关接入nvboard（附避坑指南）

从零实现Verilog双控开关与nvboard联调实战指南

开篇：为什么选择Verilog与nvboard组合？

第一次接触FPGA开发时，看到那些闪烁的LED和跳动的波形，总有种打开新世界大门的兴奋感。但随之而来的环境配置、语法错误和仿真问题，又常常让人望而却步。Verilog作为硬件描述语言的入门首选，配合南京大学开源的nvboard虚拟开发板，确实为初学者提供了极佳的学习路径。特别是在"一生一芯"这样的教学项目中，这种组合能快速验证数字电路设计，所见即所得。

本文将从一个真实的双控开关案例出发，不仅展示标准实现流程，更会重点剖析那些官方文档没写的细节问题。比如为什么引脚绑定脚本突然报错？Makefile变量究竟该怎么设置？仿真时界面显示正常但功能失效又是怎么回事？这些坑我都亲自踩过，现在把解决方案整理成可复用的经验。

1. 开发环境准备与项目初始化

1.1 工具链安装清单

开始前需要准备以下工具（以Ubuntu 20.04为例）：

# 基础编译工具
sudo apt install build-essential git make

# Verilator仿真器（建议4.0以上版本）
sudo apt install verilator

# Python3及相关依赖
sudo apt install python3 python3-pip

注意：不同Linux发行版的包管理命令可能略有差异，遇到依赖问题时建议查阅对应发行版的文档。

1.2 nvboard环境配置

从GitHub克隆最新版nvboard仓库：

git clone https://github.com/NJU-ProjectN/nvboard.git

配置环境变量是第一个容易出错的地方。很多教程会建议在~/.bashrc中添加：

export NVBOARD_HOME=/path/to/nvboard

但实际使用时要注意两点：

1. 路径必须使用绝对路径
2. 在Makefile中引用时要用${NVBOARD_HOME}而非$(NVBOARD_HOME)

验证配置是否生效：

source ~/.bashrc
echo ${NVBOARD_HOME}

2. Verilog核心模块设计

2.1 双控开关的电路原理

双控开关的本质是一个异或逻辑：当两个开关状态相同时输出0，不同时输出1。用真值表表示如下：