add vivado docs

README.md

@@ -11,7 +11,6 @@
 
 ## 本整合仓库具有以下特点：
 
-- 提供基于 Docker 的一键环境配置工具和配套文档
 - 提供基于 Vscode + Dev Container 一键环境配置工具和配套文档
 - 已提前用 cmake 编译好测试文件，无须再运行 <code>build.bat</code> 或 <code>build.sh</code>
 - 完全保留了原教学仓库的代码段填空设置和项目架构，代码迁移便利
@@ -23,7 +22,7 @@
 
 1. **使用 Vscode + Dev Container 来一键完成环境配置**
     > 如果你已经在你的设备上完成了开发的环境配置，可以跳过此内容。
-    > 此部分内容搬运自 [YatCPU 的 Dev Container 环境配置](http://tokisakix.cn/2023/11/14/%5BDocker%5D%20YatCPU%20%E7%9A%84%20Dev%20container%20%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE/)，你可以前往文档原地址获得更好的阅读体验
+    > **此部分内容搬运自 [YatCPU 的 Dev Container 环境配置](http://tokisakix.cn/2023/11/14/%5BDocker%5D%20YatCPU%20%E7%9A%84%20Dev%20container%20%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE/)**，你可以前往文档原地址获得更好的阅读体验
 
     使用 Docker + Dev Container 配置开发环境比较简单，而且也经过了测试，所以，我们推荐在 Windows 上直接使用 Dev Container 来设置开发环境。
 
@@ -66,8 +65,54 @@
 
     后续当你需要再次启动开发环境时，按相同的步骤运行 Dev Containers 即可，此时 Dev Containers 会自动使用之前已经配置好的环境，不需要再次花费十几分钟等待环境配置
 
+2. **使用一键烧板脚本**
+
+    > 此烧板脚本对任意方式配置的开发环境都有效，因为 vivado 的烧板跟开发环境是**相互独立**的，如果你使用 Dev Container 或 WSL 配置环境，你需要回到 Windows 下打开 PowerShell 进行烧板。
+
+    **生成 Verilog 文件**
+
+    根据开发板型号，在命令行输入对应型号的运行指令，运行相应目录的 Top.scala 文件，生成的结果位于 verilog/开发板名称 目录下的 Top.v，下方是参考的代码：
+
+    ```
+    sbt "runMain board.basys3.VerilogGenerator"
+    sbt "runMain board.verilator.VerilogGenerator"
+    sbt "runMain board.pynq.VerilogGenerator"
+    sbt "runMain board.z710.VerilogGenerator"
+    ```
+
+    **生成比特流二进制文件**
+
+    下面的教程以 ZYBO-Z710 开发板为例，其他开发板可以根据开发板名称自行替换。
+
+    执行下述指令，可以根据 verilog/z710/Top.v 生成二进制文件 vivado/z710/riscv-z710/riscv-z710.runs/impl_1/Top.bit。
+
+    假设你的 Vivado 安装目录是 ~/Xilinx(其他目录自行修改):
+
+    ```
+    cd vivado/z710
+    ~/Xilinx/Vivado/2020.1/bin/vivado -mode batch -source ./generate_bitstream.tcl
+    ```
+
+    **烧板**
+
+    执行下述指令，可以将二进制文件 vivado/z710/riscv-z710/riscv-z710.runs/impl_1/Top.bit 烧录到跟设备连接的开发板上。
+
+    假设你的 Vivado 安装目录是 ~/Xilinx(其他目录自行修改):
+
+    ```
+    cd vivado/z710
+    ~/Xilinx/Vivado/2020.1/bin/vivado -mode batch -source ./program_device.tcl
+    ```
+
+    **如果烧板无误，你会看到黄灯亮起**
+
+    ![image](asset/z710.jpg)
+
+    后续将上述 program_device.tcl 换成 generate_and_program.tcl 可以将生成比特流和烧板在一个脚本中完成。
+
 ## 外部参考链接
 - [YatCPU 文档地址](https://yatcpu.sysu.tech)
 - [YatCPU 的 Dev Container 环境配置](http://tokisakix.cn/2023/11/14/%5BDocker%5D%20YatCPU%20%E7%9A%84%20Dev%20container%20%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE/)
+- [测试 Tokisakix 的烧板文件](https://blog.skyw.cc/archives/258.html)
 
 (PS: 能求个 star⭐ 吗 QAQ ~)