介绍

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
3. 把本项目的目录设置成环境变量NVBOARD_HOME

示例

example目录下包含一个示例项目，在该目录下通过 make run 命令可运行该项目。

接入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. 编写一个自定义格式的约束文件，其格式为