USTC-RVSoC/README.md
2019-02-11 21:50:31 +08:00

120 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# USTCRVSoC
一个用SystemVerilog编写的基于RISC-V的SoC
# 特点
> * 5段流水线RISC-V能运行RV32I指令集
> * 简单直观的32bit握手总线 (naive_bus.sv)
> * 总线仲裁器(naive_bus_router.sv)可修改以方便拓展外设、多核、DMA等
> * 具有交互式UART调试器(isp_uart.sv)用户可以使用PC上的串口助手、minicom等软件实现系统复位、上传程序、查看内存等功能
> * 全部使用SystemVerilog实现不调用IP核方便在Altera、Xilinx、Lattice等不同FPGA平台上移植
> * RAM符合一定的Verilog写法自动综合成Block RAM
# SoC 结构
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/SoC.png)
上图展示了SoC的结构总线仲裁器bus_router为SoC的中心上面挂载了2个“主设备”和5个“从设备”。实际上CPU具有两个“主接口”因此bus_router共有3个“主接口”和5个“从接口”。
这个SoC使用的总线并不来自于任何标准例如AXI或APB总线而是笔者自编的因为简单所以命名为“naive_bus”。
每个“从接口”都占有一段地址空间。当“主接口”访问总线时bus_router判断该地址属于哪个地址空间然后将它“路由”到相应的“从接口”。下表展示了5个“从接口”的地址空间。
| 外设类型 | 起始地址 | 结束地址 |
| :-----: | :-----: | :----: |
| 指令ROM | 0x00000000 | 0x00007fff |
| 指令RAM | 0x00008000 | 0x00008fff |
| 数据RAM | 0x00010000 | 0x00010fff |
| 显存RAM | 0x00020000 | 0x00020fff |
| 用户UART | 0x00030000 | 0x00030003 |
### 主要部件
> * **多主多从总线仲裁器(naive_bus_router.sv)**:为每个从设备划分地址空间,将主设备的总线读写请求路由到从设备。当多个主设备同时访问一个从设备时,还能进行访问冲突控制。
> * **RV32I Core(core_top.sv)**:包括两个主接口。一个用于取指令,一个用于读写数据
> * **UART调试器(isp_uart.sv)**包括一个主接口。它接收用户从UART发来的命令对总线进行读写。它可以用于在线烧写、在线调试。
> * **指令ROM(instr_rom.sv)**CPU默认从这里开始取指令多用于仿真
> * **指令RAM(ram_bus_wrapper.sv)**:用户在线烧写程序到这里。
> * **数据RAM(ram_bus_wrapper.sv)**:存放运行时的数据。
> * **显存RAM(vedio_ram.sv)**在屏幕上显示98列*36行=3528个字符显存RAM的前3528B对应的ASCII码值就决定了每个字符是什么
> * **用户UART(user_uart_tx)**暂时只有发送功能向其中写一个字节相当于把该字节放入发送缓冲区FIFO缓冲区大小256B缓冲区的数据会尽快发送。
# RV32I CPU 结构
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/Core-RTL.png)
TODO
# 在DE0-Nano 开发板上运行SoC
我们提供了两种方式运行代码:
1、**使用指令ROM**修改instr_rom.sv中的代码然后重新编译综合重新烧写FPGA逻辑。虽然麻烦但这便于进行RTL仿真你可以将想要运行的程序放入指令ROM然后仅需在testbench中给予SoC一个时钟就可以观察整个SoC在运行这段代码时的波形。
2、**使用指令RAM**使用UART调试器在线上传程序到指令RAM。
### 部署电路到DE0-Nano FPGA
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/DE0-Nano.png)
1、**硬件连接**DE0-Nano上的接口的意义如上图。你至少需要一个USB转UART的模块将ISP-UART的TX和RX引脚连接上去使之能与电脑通信如下图
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/connection.png)
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/usb_uart.png)
2、**综合、烧写FPGA**用Quartus软件打开./Quartus/DE0_Nano/DE0_Nano.qpf综合并烧写到DE0-Nano。
3、**尝试读取总线**在电脑上的串口终端软件超级终端、串口助手、minicom使用格式(115200,n,8,1)发送00000000\n如果看到收到一个8位16进制数那么恭喜你SoC部署成功该数代表SoC数据总线的地址0x00000000处的读取数据。如果没有收到数据以下是可能的原因
> * **硬件连接问题**例如TX/RX接反杜邦线接触不良等
> * **共地问题**要求电脑的地与板子的地连接如果DE0-Nano上的USB口与电脑连接则已经共地否则请额外使用杜邦线将USB转UART的地与DE0-Nano的地连接。
> * **COM口号选错**如果不能确定USB转UART是哪个COM口请将它拔下来看哪个COM口消失了再重新插入就能确定COM号
> * **串口通信格式错误**必须是115200波特率、8个数据位、1个停止位、无校验位。
> * **发送数据不对**:每个命令后必须有一个\n或\r必须使用ASCII格式很多串口助手软件提供十六进制发送功能我们不需要UART调试接口会自动将收到的ASCII变为十六进制
4、上一步我们尝试了UART调试器的读总线命令下表显示了它的所有3种命令。
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/commands.png)
> * 注意:无论是发送还是接受,所有命令都以\n或\r结尾
根据这些命令,不难猜出,在线上传程序的流程是:
> 1、使用写命令将指令流写入指令RAM指令RAM的地址是00008000~00008fff
> 2、使用复位命令r00008000将CPU复位并从指令RAM种BOOT
### 使用工具USTCRVSoC-tool
./USTCRVSoC-tool/USTCRVSoC-tool.exe 是一个能汇编和烧写的小工具相当于一个汇编语言的IDE。界面如下图。
![Image text](https://github.com/WangXuan95/USTCRVSoC/blob/master/images/USTCRVSoC-tool-image.png)
我们提供了几个汇编小程序如下表。
| 文件名 | 说明 |
| :----- | :----- |
| uart_print.S | 用户UART循环打印hello! |
| vga_hello.S | 屏幕上显示hello |
| fibonacci_recursive.S | 递归法计算斐波那契数列第7个数并用用户UART打印结果 |
| load_store.S | 完成一些内存读写没有具体表现为了观察现象可以使用UART调试器查看内存 |
现在我们尝试让SoC运行一个UART打印的程序。点击“打开...”按钮,浏览到目录./software/asm-code打开汇编文件uart_print.S。点击右侧的“汇编”按钮可以看到右下方框里出现了一串16进制数这就是汇编得到的机器码。然后选择正确的COM口点击“烧写”如果下方状态栏里显示“烧写成功”则CPU就已经开始运行该机器码了。这是一个使用用户UART循环打印“hello!”的程序,
> 用户UART与UART调试器不是同一个UART。为了观察现象可以将UART调试器的杜邦线拔下来插在用户UART上或者使用两个USB转UART模块。通信格式依然是(115200,n,8,1)。
# RTL仿真
### 生成Verilog ROM
USTCRVSoC-tool.exe 除了进行烧写也可以生成指令ROM的Verilog代码。当你使用“汇编”按钮产生指令流后可以点击右侧的“保存指令流(Verilog)”按钮用生成的ROM代码替换 ./RTL/instr_rom.sv
### 进行仿真
生成ROM后请直接使用soc_top_tb.sv文件进行仿真这个仿真是针对整个SoC的因此你可以修改ROM程序后进行仿真观察SoC运行该程序的行为。
> 这里没有提供仿真工程的示例你可以新建Modelsim工程或Vivado工程进行仿真。仿真时请将./RTL/目录里的所有.sv文件都加入工程里。