NVBoard学习笔记

最新推荐文章于 2024-10-15 16:11:30 发布
最新推荐文章于 2024-10-15 16:11:30 发布
阅读量4.1k 收藏 42
点赞数 20
分类专栏： 课外学习记录 文章标签： 学习 笔记 fpga
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_61336760/article/details/134309784
版权

NVBoard

介绍

NVBoard(NJU Virtual Board)是基于SDL开发的虚拟FPGA开发板，可以在Verilator仿真环境中模拟FPGA，支持LED，七段数码管，开关，键盘和VGA。

项目文件说明

.
├── board                   # 引脚说明文件
│   └── ...
├── example                 # 示例项目
│   └── ...
├── include
│   ├── at_scancode.h
│   ├── component.h
│   ├── configs.h
│   ├── constrs.h
│   ├── keyboard.h
│   ├── macro.h
│   ├── nvboard.h
│   ├── render.h
│   └── vga.h
├── pic                     # NVBoard图片资源
│   └── ...
├── scripts
│   ├── auto_pin_bind.py    # 生成引脚绑定代码的脚本
│   └── nvboard.mk          # NVBoard构建规则
└── src                     # NVBoard源码
│   ├── component.cpp
│   ├── event.cpp
│   ├── nvboard.cpp
│   ├── render.cpp
│   └── vga.cpp
├── LICENSE
└── README.md

安装教程

  1. 将项目拷贝到本地，git clone https://github.com/NJU-ProjectN/nvboard.git
  2. 通过apt-get install libsdl2-dev libsdl2-image-dev安装SDL2和SDL2-image；对于macOS，可以通过brew install sdl2 sdl2_image安装
  3. 把本项目的目录设置成环境变量NVBOARD_HOME

示例

example目录下包含一个示例项目，在该目录下通过 make run 命令可运行该项目。
在这里插入图片描述 该示例的演示效果如下:

  1. 左边8个LED为流水灯效果(8-15)
    在这里插入图片描述

  2. 拨动右边的8个拨码开关, 可控制对应LED的亮灭
    在这里插入图片描述

  3. 8个数码管流水显示数字0-7

  4. 按钮暂无展示效果

  5. 窗口右侧为VGA输出, 将会展示一张图片

  6. 敲击键盘, 终端将会输出按键的扫描码
    在这里插入图片描述

接入verilator步骤

API说明

NVBoard提供了以下几组API

  • void nvboard_init(): 初始化NVBoard
  • void nvboard_quit(): 退出NVBoard
  • void nvboard_bind_pin(void *signal, bool is_rt, bool is_output, int len, ...): 将HDL的信号signal连接到NVBoard里的引脚上，具体地
    • is_rt为true时，表示该信号为实时信号，每个周期都要更新才能正确工作，如键盘和VGA相关信号；
      is_rt为false时，表示该信号为普通信号，可以在NVBoard更新画面时才更新，从而提升NVBoard的性能，如拨码开关和LED灯等，无需每个周期都更新
    • is_output为true时，表示该信号方向为输出方向(从RTL代码到NVBoard)；否则为输入方向(从NVBoard到RTL代码)
    • len为信号的长度，大于1时为向量信号
    • 可变参数列表...为引脚编号列表，编号为整数；绑定向量信号时，引脚编号列表从MSB到LSB排列
  • void nvboard_update(): 更新NVBoard中各组件的状态，每当电路状态发生改变时都需要调用该函数

引脚绑定

手动调用nvboard_bind_pin()来绑定所有引脚较为繁琐。
为了方便进行信号的绑定，NVBoard项目提供了一套从自定义约束文件生成绑定代码的流程。具体地

  1. 编写一个自定义格式的约束文件，其格式为
top=top_name

# Line comment inside nxdc
signal pin
signal (pin1, pin2, ..., pink)

在约束文件的第一行，需要指定顶层模块名（上文中为top_name）。
约束文件支持两种信号绑定方式，signal pin表示将顶层模块的signal端口信号绑定到引脚pin上，
signal (pin1, pin2, ..., pink)表示将顶层模块的signal信号的每一位从高到低依次绑定到pin1, pin2, ..., pink上。
约束文件支持空行与行注释。

  1. 通过命令python $(NVBOARD_HOME)/scripts/auto_pin_bind.py nxdc约束文件路径 auto_bind.cpp输出路径来生成C++文件。

调用该文件中的nvboard_bind_all_pins(dut)函数即可完成所有信号的绑定。

注意，该脚本的错误处理并不完善，若自定义约束文件中存在错误，则可能无法生成正确的报错信息与C++文件。
如果发现脚本中的错误也可以尝试修复一下然后丢pr

可以在board目录下的引脚说明文件中查看引脚信息。

其中，复位引脚RST不使用，因为NVBoard在cpp文件中包含一些内部状态，仅复位RTL设计部分会使其与NVBoard状态不一致。
一个实现全系统复位效果的简单方法是退出NVBoard并重新运行。RTL设计的复位工作由verilator的wrapper完成，具体见example/csrc/main.cpp。

#include <nvboard.h>
#include <Vtop.h>

static TOP_NAME dut;

void nvboard_bind_all_pins(Vtop* top);

static void single_cycle() {
  dut.clk = 0; dut.eval();
  dut.clk = 1; dut.eval();
}

static void reset(int n) {
  dut.rst = 1;
  while (n -- > 0) single_cycle();
  dut.rst = 0;
}

int main() {
  nvboard_bind_all_pins(&dut);
  nvboard_init();

  reset(10);

  while(1) {
    nvboard_update();
    single_cycle();
  }
}

RTL（Register Transfer Level，寄存器传输级）指：不关注寄存器和组合逻辑的细节（如使用了多少逻辑门，逻辑门之间的连接拓扑结构等），通过描述寄存器到寄存器之间的逻辑功能描述电路的HDL层次。RTL级是比门级更高的抽象层次，使用RTL级语言描述硬件电路一般比门级描述简单高效得多。

调用API

在C仿真代码中调用NVBoard提供的API

#include <nvboard.h>

// ...
nvboard_bind_all_pins(&dut);
nvboard_init();

while (1) {
  // ...
  nvboard_update();
}

nvboard_quit();

具体地

  • 在进入verilator仿真的循环前，先对引脚进行绑定，然后对NVBoard进行初始化
  • 在verilator仿真的循环中更新NVBoard各组件的状态
  • 退出verilator仿真的循环后，销毁NVBoard的相关资源

编译链接

在Makefile中

  • 将生成的上述引脚绑定的C++文件加入源文件列表
  • 将NVBoard的构建脚本(nvboard.mk)包含进来
include $(NVBOARD_HOME)/scripts/nvboard.mk
  • 通过make nvboard-archive生成NVBoard的库文件
  • 在生成verilator仿真可执行文件(即$(NVBOARD_ARCHIVE))将这个库文件加入链接过程，并添加链接选项-lSDL2 -lSDL2_image

可以参考示例项目中的Makefile文件，即example/Makefile
下面是对于Makefile中每行代码含义的解释，参考自南京大学数字电路与计算机组成实验的Verilator仿真（二）

TOPNAME = top
NXDC_FILES = constr/top.nxdc  #约束文件路径
INC_PATH ?=  #?=的意义是，INC_PATH如果被未被定义，则为?=后的值，如果被定义过，则保持原来的值

VERILATOR = verilator
#在代码段结束后看这一句的详细注解
VERILATOR_CFLAGS += -MMD --build --cc -O3 \
                    --x-assgin fast --x-initial fast --noassert --trace
BUILD_DIR = ./build
OBJ_DIR = $(BUILD_DIR)/obj_dir
 #OBJ_DIR = ./build/obj_dir
BIN = $(BUILD_DIR)/$(TOPNAME)
 #BIN = ./build/top

default: $(BIN) #终极目标为default，依赖./build/top

$(shell mkdir -p $(BUILD_DIR)) #建立./build目录

SRC_AUTO_BIND = $(abspath $(BUILD_DIR)/auto_bind.cpp) #abspath:返回文件的绝对路径
#SRC_AUTO_BIND = ~/vtest/ex2/part4/build/auto_bind.cpp 此为约束文件
$(SRC_AUTO_BIND): $(NXDC_FILES) # 目标文件（约束文件SRC_AUTO_BIND)的建立依赖于constr/top.nxdc
	python3 $(NVBOARD_HOME)/scripts/auto_pin_bind.py $^ $@
	# python3 $(NVBOARD_HOME)/scripts/auto_pin_bind.py constr/top.nxdc auto_bin.cpp 
	#此命令用来生成auto_bin.cpp文件

VSRCS = $(shell find $(abspath ./vsrc) -name "*.v")
#在~/vtest/ex2/part4/vsrc目录中寻找所有的.v文件
#VSRCS = top.v bcd7seg.v
CSRCS = $(shell find $(abspath ./csrc) -name "*.c" -or -name "*.cc" -or -name "*.cpp")
#CSRCS = sim_main.cpp
CSRCS += $(SRC_AUTO_BIND)
#CSRCS = sim_main.cpp auto_bind.cpp

include $(NVBOARD_HOME)/scripts/nvboard.mk
#在该Makefile中引用其他Makefile

INCFLAGS = $(addprefix -I, $(INC_PATH))
#INCFLAGS = -I
CFLAGS += $(INCFLAGS) -DTOP_NAME="\"V$(TOPNAME)\""
#CFLAGS = -I -DTOP_NAME="\"Vtop\""
LDFLAGS += -lSDL2 -lSDL2_image

$(BIN): $(VSRCS) $(CSRCS) $(NVBOARD_ARCHIVE)
#./build/top文件的建立依赖于 top.v bcd7seg.v sim_main.cpp auto_bind.cpp 以及verilator仿真可执行文件
	@rm -rf $(OBJ_DIR)
	$(VERILATOR) $(VERILATOR_CFLAGS)\
	--top-module $(TOPNAME) $^\
	$(addprefix -CFLAGS , $(CFLAGS)) $(addprefix -LDFLAGS , $(LDFLAGS)) \
	--Mdir $(OBJ_DIR) --exe -o $(abspath $(BIN))
	# verilator -MMD --build --cc -O3 --x-assgin fast --x-initial fast --noassert --trace \
	#--top-module top top.v bcd7seg.v sim_main.cpp auto_bind.cpp \
	#-CFLAGS -I -DTOP_NAME="\"VTOP\"" -LDFLAGS -lSDL2 -lSDL2_image \
	#--Mdir ./build/obj_dir --exe -o ./build/top
	#--top-module top 指定顶层文件名 --Mdir 将生成的文件都放入obj_dir目录中 --exe -o ./build/top 产生可执行文件并指定名字为./build/top
all: default

run:$(BIN)
	@$^
	#make run 执行可执行文件 ./build/top

clean:
	rm -rf $(BUILD_DIR)
.PHONY: default all clean run

For best performance, run Verilator with the -O3 --x-assign fast --x-initial fast --noassert options. The -O3 option will require a longer time to run Verilator, and --x-assign fast --x-initial fast may increase the risk of reset bugs in trade for performanc．
上句摘录自verilator官网

GCC的命令参数有很多，下面只介绍-MMD：
生成文件关联的信息。包含目标文件所依赖的所有源代码，但是输出将导入到.d的文件里面。
想要了解更多可以点击这里

.PHONY（伪目标）
伪目标是这样一个目标：它不代表一个真正的文件名，在执行make时可以指定这个目标来执行所在规则定义的命令，有时也可以将一个伪目标称为标签。伪目标通过PHONY来指明。 PHONY定义伪目标的命令一定会被执行。
更详细的内容可以参考这里

特技

  1. 可以用 include/configs.h选择贴图，让自己的虚拟FPGA开发板更有特色，贴图放在 pic目录下；
南京大学数字电路与计算机组成实验的Verilator仿真（二）
alinna1234的博客
11-21 3247
南京大学数字电路与计算机组成实验，一生一芯PA0数字电路基础实验。使用开源仿真器verilator并接入nvboard虚拟FPGA板卡
[实验一] 选择器
qq_42162595的博客
09-13 2537
该个栏目的博客都是基于数字逻辑与计算机组成 课程实验的文档进行学习的，方便以后进行总结归纳而准备的。
双控开关接入NVBoard
强我强国
09-24 1645
一生一芯
【一生一芯笔记】Verilator和NVBoard简单使用
Naruto123456__的博客
08-17 3702
最近在搞一生一芯，前期还算比较顺利，但是在仿真环境搭建这部分遇到了大问题。一是因为自己之前都是直接烧录到真实的FPGA等板卡上，很少链接这样的仿真环境，二是因为Verilator和NVBoard的资料很少，尤其是NVBoard。 在摸索了好几天后，大致摸索出来一点点门路，所以希望缓一下，整理一下，也帮大家少走一些弯路。
nvboard初次使用
qq_47163558的博客
02-04 1439
经过不懈努力，终于能够将nboard跑通了，真的非常怪，一开始是把nvboard直接make run结果不识别，最后不断地安装卸载库，导致了各种各样的问题，在经过查找之后才发现，由于安装的是SDL_ttf2.0.15版本的库，缺少了部分函数，所以说才会跑不起来，所以我在网上查找后发现最早的包含该函数的库是2.19.2版本，所以先使用sudo apt remove SDL_ttf命令将原来的库移除，再按照下列指令安装SDL_ttf库。随后安装好了后，又提示找不到路径，最后把路径加上了才算完成。
NVboard初次运行，环境变量配置
csdn18818963826的博客
03-05 922
vim ~/.bashrc`就可以了，这里如果想看自己到底有没有这个文件可以在`~`目录下用`ls -a`看一下，一般来说是有的，因为这是系统自带的点文件，打开之后呢我们直接到最后一行去添加环境变量`export NVBOARD_HOME=/HOME/......`这里的点点点就是你具体的目录地址，如果不清楚呢就打开nvboard，然后输入`pwd`去查看，这里只要设置到nvboard目录下就可以了，不需要具体到example，值得注意的是目录的最后不用加`/`
NVBoard快速上手指南
最新发布
ZSHSTC的博客
10-15 525
相当于为你的DUT提供一些常见的外设：Button、Led、SegDisplay、SW、KeyBoard（maybe）、UART这样DUT内部的情况就可以以可视的方式呈现出来需要做的就是将输入输出进行“绑定”
verilog键盘输入示例代码及分析（摩尔型有限状态机）
m0_51194302的博客
09-19 3268
该示例代码使用摩尔型有限状态机的思想，设计的verilog键盘输入程序。本文分析了该代码并补充了相关知识。
NJU数电实验1-3
DanielSYC的博客
03-02 2710
南京大学数电实验
vivado环境下用zedboard实现流水灯功能
qq_41262334的博客
03-04 597
开发环境：vivado 2018.2 硬件平台：zedboard 实验目的：流水灯 新建工程 输入工程名称，同时选择创建子目录 选择RTL级工程，同时不指定源文件 选择器件 通过开发板型号进行搜索，选定zedboard 确定硬件信息，finish 进入vivado主界面如下 点击add sources，添加源文件 选择create file，语言选择 verilog，输入源文件名称 点击OK，finish，完成源文件的创建 跳过端口定义 OK 在主界面中，source模块下可见添加好的源文
linux设置环境变量目录,Linux的环境变量设置方法
weixin_32696821的博客
04-28 619
一.和环境变量有关的常用命令1.使用echo显示环境变量HOME$ echo $HOME/home/admin2.使用export设置一个新的环境变量NAME$ export NAME="RaidCheng"$ echo $NAMERaidCheng3.使用env命令显示所有的环境变量$ envHOSTNAME=testTERM=vt100SHELL=/bin/bashHISTSIZE=1000S...
linux设置环境变量目录,Linux环境变量配置方法详解
weixin_42237925的博客
04-28 1794
Linux 系统中的程序和脚本都是通过环境变量来获取系统信息、存储数据和配置信息。在 Linux 中，一般通过环境变量配置操作系统的环境，例如提示符、查找命令的路径和用户家目录等，这些系统默认的环境变量的变量名是固定的，因此只能修改其变量的值。环境变量也称全局变量，环境变量可用于定义 Shell 的运行环境，环境变量可以在配置文件中定义与修改，也可以在命令行中设置，但是命令行中的修改操作在终端重启...
Windows中安装配置Maven详细教程
IT教育任姐姐的博客
01-15 1万+
前言 我们现在进行Java项目开发时，项目中一般都会有依赖包的存在，而这些依赖包一般都是利用Maven进行下载管理的。但很多小伙伴还不知道Maven怎么安装配置，所以专门编写一篇详细教程，教会大家如何安装、配置Maven。 本文会图文结合，各位只要按照以下图片所示，即可安装配置好Maven。 一. 下载&安装 1. 下载地址 maven下载地址如下，各位请选择对应系统的maven版本进行下载。 https://maven.apache.org/download.cgi 2. 解压mav
linux设置环境变量目录,Linux环境变量的设置和查看方法 .
weixin_28793831的博客
04-28 459
1.使用env命令显示所有的环境变量$ envHOSTNAME=redbooks.safe.orgPVM_RSH=/usr/bin/rshShell=/bin/bashTERM=xtermHISTSIZE=1000...2.使用set命令显示所有本地定义的Shell变量$ set3. 使用unset命令来清除环境变量set可以设置某个环境变量的值。清除环境变量的值用unset命令。如果未指定值，则...
linux将目录路径加入环境变量中,如何添加路径到PATH环境变量
weixin_29016865的博客
05-02 5813
1、直接用export命令：#export PATH=$PATH:/opt/au1200_rm/build_tools/bin命令解释：设置环境变量 PATH 为 /usr/local/arm/3.3.2/bin 外加原来的 PATH 变量内容。比如 PATH 原来的变量为 /usr/bin这个命令之后，PATH 内容就是 /usr/local/arm/3.3.2/bin:/usr/bin其中 :...
将当前目录加入环境变量
weixin_43476824的博客
12-01 774
import sys.path import os current_path = os.getcwd()) # 获取当前工作目录路径 sys.path.append(current_path)
把当前目录添加到新的环境变量中
weixin_30825199的博客
07-29 709
@echo off rem 把当前运行的目录添加到系统环境变量里面 rem 环境win7_64 2014/7/29 rem 获得当前目录 set fileName=%0 set fileDir=%fileName:~1,-12% rem 查询注册表中对应的环境变量 for /f "tokens=3*" %%i in ('reg query HKEY_CURRENT_USER\Environ...
NJUCS南京大学数字电路实验--字符输入界面（verilog）
Zero_wym的博客
11-17 2357
实验目的 本实验将利用前面实现过的键盘和显示器功能来搭建一个简单的字符输入界面，通过该系统的实现深入理解多个模块之间的交互和接口的设计。 模块设计 基础功能实现 基础功能实现的时候，我用了两个思路。 首先基础功能有 支持所有小写英文字母和数字输入 输入至行尾后自动换行，输入回车也换行。 一直按压某个键时，重复输出该字符。 我和同学讨论的时候，我说第三个最不好实现，我同学都说第三个最好实现，实际上是实现的方法不一样导致的 我的方法：在实验七中，有键盘计数功能，按键按下，抬起，就算一次按键，按键数即为现在
智能开关双控实现方法(附电路图)
热门推荐
power139的博客
02-22 1万+
常见问题： 如何实现兼容机械开关布线的双控智能开关？ 智能开关和普通双控开关如何实现总体双控(双控开关和智能开关同时接)？ 智能开关如何兼容传统双控开关？ 智能开关如何替换普通传统双控开关？ 传统机械双控开关怎么改智能（传统双控改智能双控）？ 传统双控、多控如何升级为智能开关控制? 想把房间的两个双控开关之一改成智能开关，实行远程控制，求解决办法? 什么样的智能开关可以兼容传统意义的双控?* 背景...
nvboard接入verilator
07-14
您好！感谢您的提问。要将 NVBoard 接入 Verilator 进行仿真，您可以按照以下步骤操作： 1. 确保您已经安装了 Verilator。您可以从 Verilator 的官方网站（https://www.veripool.org/wiki/verilator）上下载并按照说明进行安装。 2. 将 NVBoard 的设计代码（通常是 Verilog 或 SystemVerilog）与测试代码准备好。确保这些代码位于同一个文件夹中。 3. 编写一个顶层的仿真测试台，用于实例化 NVBoard 的模块，并提供时钟和其他必要的信号。这个仿真测试台是一个 C++ 文件，可以使用 Verilator 进行编译和仿真。 4. 在仿真测试台中，使用 Verilator 提供的 DPI（Direct Programming Interface）机制，将 C++ 代码与 Verilog 或 SystemVerilog 代码进行交互。通过 DPI，您可以在 C++ 代码中调用 Verilog 或 SystemVerilog 的任务和函数，并将数据传递给它们。 5. 编译和运行仿真测试台。使用 Verilator 将仿真测试台的 C++ 代码编译为可执行文件，并运行该文件以启动仿真。 请注意，这只是一个概述，并且具体的步骤可能会根据您的实际情况有所不同。如果您需要更详细的指导，请参考 Verilator 的文档或搜索相关的教程和示例代码。 希望这可以帮助到您！如果您有任何更多的问题，请随时提问。
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值