HLS-QCNN 完整交付包操作教程

解压后双击 index.html;打开 HLS 用 open_hls_gui.bat;打开 Vivado 用 open_vivado_project.bat。

1. 先打开哪个文件

  1. 解压 hls_qcnn_full_delivery_package.zip。
  2. 进入解压后的根目录。
  3. 双击 index.html 查看教程。
  4. 双击 open_hls_gui.bat 可唤起 Vitis HLS。
  5. 双击 open_vivado_project.bat 可打开 Vivado 工程。
不要单独移动 HTML 或 bat 文件;本包依赖当前目录中的相对路径。

2. 一键打开 Vitis HLS

完整包包含当前 HLS 工程:

hls_cnn/build/hls_qcnn_hls/hls.app

双击:

open_hls_gui.bat

启动器会先复制到 ASCII 路径,再打开 HLS:

C:\hls_qcnn_work\hls_cnn
F:\ZYNQ_\Vitis_HLS\2020.2\bin\vitis_hls.bat -p C:\hls_qcnn_work\hls_cnn\build\hls_qcnn_hls

如果路径不同,编辑 open_hls_gui.bat 里的:

set "HLS_BAT=F:\ZYNQ_\Vitis_HLS\2020.2\bin\vitis_hls.bat"

3. 一键打开 Vivado

完整包包含 Vivado 工程:

hls_cnn/vivado/hls_qcnn_pynq_z2.xpr

双击:

open_vivado_project.bat

如果路径不同,编辑 open_vivado_project.bat 里的:

set "VIVADO_BAT=F:\ZYNQ_\Vivado\2020.2\bin\vivado.bat"

4. 完整包实际文件

5. 命令式重新生成

python hls_cnn/hls_qcnn_fixed_ref.py --data_dir data/processed/val --output results/hls_qcnn_slim_fixed_eval.json --min_acc 70
python hls_cnn/generate_hls_qcnn_artifacts.py --test_image data/processed/val/class_0/10.jpg
hls_cnn/run_hls_qcnn.bat
hls_cnn/run_vivado_qcnn.bat
完整包包含模型和工程,但不一定包含完整验证集原图。没有 data/processed/val 时可直接使用包内已有 bit/hwh 上板。

6. HLS/Vivado 成功后看哪些文件

hls_cnn/build/hls_qcnn_hls/solution1/syn/report/csynth.rpt
hls_cnn/build/hls_qcnn_hls/solution1/syn/report/hls_qcnn_accel_csynth.rpt
hls_cnn/vivado/hls_qcnn_pynq_z2.xpr
hls_cnn/output/hls_qcnn.bit
hls_cnn/output/hls_qcnn.hwh

7. 上板部署

ssh xilinx@<BOARD_IP> "mkdir -p /home/xilinx/hls_qcnn_test"
scp hls_cnn/output/hls_qcnn.bit xilinx@<BOARD_IP>:/home/xilinx/hls_qcnn_test/
scp hls_cnn/output/hls_qcnn.hwh xilinx@<BOARD_IP>:/home/xilinx/hls_qcnn_test/
scp hls_cnn/include/hls_qcnn_weights_flat.npy xilinx@<BOARD_IP>:/home/xilinx/hls_qcnn_test/
scp fpga_deployment/hls_qcnn_inference.py xilinx@<BOARD_IP>:/home/xilinx/hls_qcnn_test/

8. 结果截图

三次实验汇总
三次 100 张验证集实验汇总,三次均为 79/100。
终端日志截图
由板端 SSH 原始日志整理得到的终端风格截图。