From e27fb0d284d71dd3946f9c270f5f217b86e77dcd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9C=8D=E6=8C=AF=E9=A3=9E?= <8217398+huozf123@user.noreply.gitee.com> Date: Fri, 28 May 2021 09:09:35 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20README.m?= =?UTF-8?q?d?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 275 ------------------------------------------------------ 1 file changed, 275 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index d58a10d..0000000 --- a/README.md +++ /dev/null @@ -1,275 +0,0 @@ -# Rocket Chip在ZYNQ上的实现 - -该仓库包含在Vivado 2016.2上的各种Zynq FPGA开发板（Zybo，Zedboard，ZC706，PYNQ-z2）上运行RISC-V rocket chip所需的文件。 （注：因为Vivado版本问题，推荐使用Ubuntu16.04操作系统） - -### 如何使用该README： - -该README主要包含3部分： - -[1 - 快速开始](#quickinst)：使用编译好的文件极速上手，无需下载各种工具。 - -[2 - RISCV工具链（riscv-tools）编译](#toolchain)：安装编译rocket chip所需的工具链。 - -[3 - 工程编译的详细步骤](#compile)：从头开始一步步编译整个工程。 - -[附录](#appendices)：主机和开发板传输文件的方法。 - -注：以下的`$REPO`均代表`fpga-pynq`repo在本地的目录，建议执行以下命令将REPO加入环境变量（替换repo在本地的目录）： - -``` -$ export REPO=repo在本地的目录 -``` - -## 目录 - -+ [0 - 克隆整个工程到本地](#start) -+ [1 - 快速开始](#quickinst) -+ [2 - RISCV工具链（riscv-tools）编译](#toolchain) -+ [3 - 工程编译的详细步骤](#compile) - + [创建工程](#setup) - + [生成比特流文件](#bitstream) - + [编译FSBL](#fsbl) - + [编译u-boot](#u-boot) - + [Building u-boot for the Zynq ARM Core](#u-boot) - + [创建boot.bin](#boot.bin) - + [编译zynq ARM的linux内核](#arm-linux) - + [生成设备树文件](#arm-dtb) - + [启动](#booting) -+ [附录](#appendices) -+ [说明](#note) - -## 0) 克隆整个工程到本地 - -为了方便大家快速获取源码，已将全部源码（包括子模块）打包上传到百度网盘，可以直接下载。 - -``` -链接：https://pan.baidu.com/s/1mTCcKG0EiFdxq4C5HTey3w -提取码：1234 -``` - -``` -$ cat fpga-pynq.0* > fpga-pynq.tar.gz #组装文件 -$ md5sum fpga-pynq.tar.gz > md5 #计算MD5校验码 -$ cmp md5 md5sum #比对校验码，如果此处没有任何输出，则为正确 -$ tar -zxvf fpga-pynq.tar.gz #解压文件 -``` - -或者从github获取源码： - -``` -$ git clone https://github.com/huozf123/fpga-pynq.git -$ cd fpga-pynq -$ git submodule update --init --recursive #快速开始不需要执行该指令，自己编译工程才需要 -``` - -1) 快速开始 ------------------- - -*用预先编译好的镜像，运行hello world程序在rocket chip上 (注：此环节无需安装任何工具)* - -首先，格式化SD卡，文件系统格式为FAT32，将`$REPO/pynq-z2/fpga-images-pynq`目录下的四个文件拷贝至SD卡。 -然后，弹出SD卡，将其插入开发板，将开发板的启动跳线设置为“SD”，然后打开开发板的电源。 使用网线连接至开发板，打开主机终端用SSH登录ARM端的linux系统（用户名密码均为*root*），并在rocket chip上运行hello world： - - $ ssh root@192.168.1.5 - root@zynq:~# ./fesvr-zynq pk hello - hello! - -## 2) RISCV工具链（riscv-tools）编译 - -（如果机器上已经有编译好的工具链，则只需将其加入环境变量即可，这一步可以跳过） - -1）安装依赖： - -``` -$ sudo apt-get install autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev libusb-1.0-0-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev device-tree-compiler pkg-config libexpat-dev -``` - -2）编译工具链，此处需要指定工具链要安装的目标路径（绝对路径）： - -``` -$ export RISCV=工具链要安装的目的路径 -$ export PATH=${RISCV}/bin:$PATH -$ cd $REPO/rocket-chip/riscv-tools/ -$ ./build.sh -``` - -注：此处需要GCC>=4.8，详情请参照[README](https://github.com/riscv/riscv-tools#readme)。 - -3) 工程编译的详细步骤 -------------------------- - -*前提：安装好的Vivado 2016.2 ，一个可以运行scala代码的JVM（注：测试使用的java版本为1.8.0_271，如果编译rocket chip过程中遇到java错误，可能是java版本的原因）* - -首先添加Vivado相关的环境变量，执行（替换掉“你的vivado安装目录”）： - -``` -$ source 你的vivado安装目录/Vivado/2016.2/settings64.sh -$ source 你的vivado安装目录/SDK/2016.2/settings64.sh -``` - -因为Vivado、SDK存在bug，所以需要执行以下命令（替换“你的vivado安装目录”）： - -``` -$ sudo apt-get install libgoogle-perftools-dev -$ export SWT_GTK3=0 -$ sed -i "11,15s/^/#/" 你的vivado安装目录/Vivado/2016.2/.settings64-Vivado.sh #注释该文件第11-15行 -``` - -然后初始化子模块，进入目标开发板的目录，执行： - - $ make init-submodules - -### 3.1) 创建工程 - -首先，进入目标开发板的目录，执行如下命令生成工程。 - - $ make project - -### 3.2) 生成比特流文件 - -然后，我们通过如下命令打开vivado: - - $ make vivado - -然后点击左下角的*Generate Bitstream*按钮， Vivado将自动生成比特流文件。该文件位置为： - -`$REPO/pynq-z2/pynq_rocketchip_ZynqFPGAConfig/pynq_rocketchip_ZynqFPGAConfig.runs/impl_1/rocketchip_wrapper.bit` - -下一步，点击*File -> Export -> Export Hardware*。这将创建以下目录： - -`$REPO/pynq-z2/pynq_rocketchip_ZynqFPGAConfig/pynq_rocketchip_ZynqFPGAConfig.sdk` - -该目录包含的各种文件向SDK提供有关硬件的信息。 - - -### 3.3) 编译FSBL - -在Vivado界面点击*File -> Launch SDK* 打开SDK： - -1) 点击 *File -> New -> Application Project* - -2) 在弹出的新窗口中，输入"FSBL" 作为Project name，其他项保持默认： - -3) 点击*Next*，然后依次点击*Zynq FSBL* 和*Finish*。然后SDK将继续自动编译FSBL。 - -4) 编译完成后，继续下一步。 - -### 3.4) 编译u-boot - -打开一个新的终端，进入目标开发板的目录，执行如下命令： - - $ source 你的vivado安装目录/Vivado/2016.2/settings64.sh - $ source 你的vivado安装目录/SDK/2016.2/settings64.sh - $ make arm-uboot - -编译好的u-boot所在位置为：`$REPO/pynq-z2/soft_build/u-boot.elf`。 - -### 3.5) 创建boot.bin - -回到SDK界面，点击 *Xilinx Tools -> Create Zynq Boot Image*。 - -1) 点击*Output BIF file path*后面的*Browse..*,然后找到并选择`$REPO/pynq-z2/deliver_output`。 - -2) 点击右下角的*Add*，并在弹出的对话框中点击*Browse*，找到如下文件（First Stage BootLoader）： - -`$REPO/pynq-z2/pynq_rocketchip_ZynqFPGAConfig/pynq_rocketchip_ZynqFPGAConfig.sdk/FSBL/Debug/FSBL.elf` - -*Partition type*选择bootloader，然后点击*OK*。 - -3) 再一次点击 *Add*，并在弹出的对话框中点击*Browse*，找到如下文件（bitstream）： - -`$REPO/pynq-z2/pynq_rocketchip_ZynqFPGAConfig/pynq_rocketchip_ZynqFPGAConfig.runs/impl_1/rocketchip_wrapper.bit` - -*Partition type* 选择datafile，然后点击*OK*。 - -4) 再一次点击 *Add*，并在弹出的对话框中点击*Browse*，找到如下文件（uboot）： - -`$REPO/pynq-z2/soft_build/u-boot.elf` - -*Partition type* 选择datafile，然后点击*OK*。 - -5) 点*Create Image*。这将产生 `BOOT.bin` 文件在 `$REPO/pynq-z2/deliver_output` 目录下。 - -进行完以上5个步骤之后，如果再次修改其中的文件，可以进入目标开发板的目录，通过如下命令快速生成boot.bin文件（注：最终写入到SD卡中的boot.bin文件名不区分大小写）。 - - $ make deliver_output/boot.bin - -### 3.6) 编译zynq ARM的linux内核 - -进入目标开发板的目录，然后编译linux内核： - - $ make arm-linux - -### 3.7) 生成设备树文件 - -生成linux的dtb： - - $ make arm-dtb - -### 3.8) 启动 - -此时，`$REPO/pynq-z2/deliver_output` 目录下包含如下文件： - -* `BOOT.bin` - 包含FSBL、bitstream、u-boot。 -* `uImage` - zynq ARM端的Linux内核。 -* `devicetree.dtb` - Linux需要的设备树文件。 -* `uramdisk.image.gz` - ARM linux的文件系统。 - -最终只需将linux根文件系统复制到该目录下即可完成SD卡内所有文件的准备工作，进入目标开发板的目录，执行： - - $ cp fpga-images-pynq/uramdisk.image.gz ./deliver_output/ - -现在将`deliver_output/`中的如下四个文件拷贝到SD卡中，然后将SD卡插入到pynq-z2开发板中，将开发板右上角跳线帽调整到SD端（即从SD卡启动）。SD卡内的目录结构如下： - - SD_ROOT/ - |-> boot.bin - |-> devicetree.dtb - |-> uImage - |-> uramdisk.image.gz - -此时已经完成了所有工作，打开开发板电源，使用网线（用户名密码均为*root*）连接至开发板并运行hello world： - - $ ssh root@192.168.1.5 - root@zynq:~# ./fesvr-zynq pk hello - hello! - - 附录 ------------- - - -### 主机与开发板传输文件 - -#### 通过以太网传输文件 -最简单的方法，使用scp在线传输文件： - - $ scp file root@192.168.1.5:~/ - -*注意*：上电期间对文件系统的修改不会写入`uramdisk.image.gz`文件中，如需永久修改文件系统参见如下： - -#### 修改linux文件系统 -1）首先需要安装uboot tools： - -``` -sudo apt-get install u-boot-tools -y -``` - -2）将SD卡通过读卡器插入主机。 - -3）进入目标开发板的目录，解压文件系统： - - $ cd $REPO/pynq-z2 - $ make ramdisk-open - -解压后的文件系统位置为：`$REPO/pynq-z2/ramdisk`，可以在此处修改文件系统。 - -4）修改完成后压缩文件系统，覆盖旧的文件系统： - - $ make ramdisk-close - -（注：文件系统的位置为：`$REPO/pynq-z2/fpga-images-pynq/uramdisk.image.gz`） - -5）将文件系统`$REPO/pynq-z2/fpga-images-pynq/uramdisk.image.gz`拷贝到SD卡。 - -## 说明 - -此工程基于[fpga-zynq](https://github.com/ucb-bar/fpga-zynq)，如果需要更加深入的了解，请参考[fpga-zynq](https://github.com/ucb-bar/fpga-zynq)。