added vivado-vitis uart workflow to lab4

not yet tested

lab4/vivado/z710/README.md

@@ -0,0 +1,99 @@
+
+# 如何使用脚本使 CPU 烧录至 Zybo Z7-10 开发板并读取 UART 输出至电脑
+
+
+步骤如下：
+
+此处用 `vivado` 和 `xsct` 工具，并假设您已在 `vivado/z710` 目录下打开终端。（TODO）
+
+## 1. 生成 Vivado 项目
+
+确保您的 `verilog/z710` 下已生成 Top.v ，且其他组件的 verilog 文件都存在。
+执行命令以生成设计：
+
+```pwsh
+vivado -mode batch -source ./riscv-z710-v2020.tcl
+```
+
+完成后，您应见文件夹 `vivado/z710/riscv-z710-v2020`，且其中有 `riscv-z710-v2020.xpr`。
+
+
+
+## 2. 生成比特流并导出硬件平台
+
+完成上一步骤后，执行命令以生成比特流、导出硬件平台 .xsa 文件。
+
+```pwsh
+vivado -mode batch -source ./generate_bitstream.tcl
+```
+
+完成后，您应见 `vivado\z710\riscv-z710-v2020\design_1_wrapper.xsa` 文件。
+
+
+## 3. 构建 Vitis 项目并烧录至开发板
+
+完成上一步骤后，将开发板连接至电脑，并开启电源。随后执行命令将 CPU 烧录至开发板，并使 Zynq 处理器监听并返回 UART 输出：
+
+```pwsh
+xsct ./vitis_prj_run.tcl
+```
+
+若成功，您应看到开发板的 LD0 灯在打开其下方的 G15 开关（该开关控制输入CPU的时钟开关）时会闪烁，同时右侧 BTN16 上方的 LD12 已烧录指示灯亮起为绿色。
+
+打开任意的 COM 通信工具，连接至合适串口，即可收到 CPU 的输出 UART 信息，按 BTN0 （K18）会重置 CPU 以重新打印。
+
+
+
+## For Maintainers
+
+该段描述这些脚本如何获得，若您希望了解其中原理或做出贡献，可以阅读本节。
+
+### lab4 auxiliary file related
+
+CPU 输入频率4分频。
+
+### Use with Vivado 2020.1
+
+#### Vivado 项目重建脚本
+
+2020 版本的 Vivado 导出仍会引用 .bd 块设计文件（2022不会），即使勾选了用 TCL 重建块设计。从 Vivado 2022 版那里导出的脚本薅来一段代码让它不必引用 .bd 文件，从而单个文件就能重建项目。
+
+用 Vivado 2020 的 Write Project Tcl 导出脚本后，开头会提示需要的文件，包括了块设计的 `design_1_wrapper.v`，但里面其实已经有 TCL 连线。
+
+1. 在 `Set 'sources_1' fileset object` （Line 128）附近删除添加 `design_1_wrapper.v` 的一行
+2. 在注释`End of cr_bd_design_1()` 后，运行完 `cr_bd_design_ ""` 之后（Line 870），添加生成 wrapper Verilog 文件的指令，如下
+```tcl
+...
+# End of cr_bd_design_1()
+cr_bd_design_1 ""
+set_property REGISTERED_WITH_MANAGER "1" [get_files design_1.bd ] 
+set_property SYNTH_CHECKPOINT_MODE "Hierarchical" [get_files design_1.bd ] 
+
+# 加在这： call make_wrapper to create wrapper files
+set wrapper_path [make_wrapper -fileset sources_1 -files [ get_files -norecurse design_1.bd] -top]
+add_files -norecurse -fileset sources_1 $wrapper_path
+```
+
+修改后上述脚本就能重建项目。
+
+`open_project.tcl` 直接打开项目的 .xpr 项目文件，`generate_bitstream.tcl` 再生成比特流，并额外导出硬件平台。
+
+#### Vitis 项目重建脚本
+
+Vitis 仅在控制台的 Platform 控制台打印一些对硬件平台的操作指令，其他指令需要参照 XSCT（Xilinx Software Commandline Tool） 参考手册，以使用相关指令（纯苦工活）。一些流程在 Vitis IDE 里面的设置可以找到，比如 PS7 处理器的初始化流程（在脚本注释有写）。
+
+XSCT 会单独使用一个 cmd 窗口执行，因此如果中途因错误退出将来不及看到任何错误信息，因此需要在命令行打开 xsct（如 `E:\Xilinx\Vitis\2020.1\bin\xsct`），然后逐行执行（多行的 if 结构可一次性复制多行），并查看错误。
+
+注意 Vivado 和 Vitis 版本要一致，不要混用不同年份的版本。
+
+***
+
+### Use with Vivado 2022.1
+
+#### Vivado 项目重建脚本
+
+导（出）就完啦！
+
+#### Vitis 项目重建脚本
+
+应该和 2020 的一样。