Quick Start
本指南帮助你在30分钟内，在FPGA开发板上部署一个轻量级AI推理加速器（基于二值神经网络BNN），并验证边缘推理效果。请按以下步骤操作。
前置条件
- 一块Xilinx PYNQ-Z2或ZCU104开发板，并已安装PYNQ v2.7镜像到SD卡。
- PC上安装Vivado 2020.1或更高版本（用于综合与实现），以及Python 3.8+（用于模型转换与驱动）。
目标与验收标准
部署完成后，在PYNQ板卡上运行MNIST手写数字识别推理，准确率应大于95%，每帧推理延迟低于10毫秒。通过Jupyter Notebook输出结果即可验收。
实施步骤
步骤一：准备硬件
确保PYNQ-Z2或ZCU104开发板已插入SD卡（含PYNQ v2.7镜像），并通过USB与PC连接。上电后，等待板卡启动完成（约1分钟），可通过串口或网络确认IP地址。
步骤二：安装软件环境
在PC上安装Vivado 2020.1（或更新版本），并确保Python 3.8+已配置。建议创建虚拟环境以隔离依赖。
步骤三：下载示例工程
从GitHub仓库（链接见附录）克隆BNN-PYNQ加速器项目。使用命令：git clone https://github.com/example/bnn-pynq.git。
步骤四：生成比特流
在Vivado中打开项目，运行综合与实现。此过程约需10分钟，完成后生成.bit文件。注意：若板卡型号不同，需修改约束文件中的引脚映射。
步骤五：加载到板卡
将生成的.bit文件和对应的.hwh描述文件复制到PYNQ板卡的Jupyter目录（通常为/home/xilinx/jupyter_notebooks/）。可通过SCP或USB挂载完成。
步骤六：运行推理
打开Jupyter Notebook（浏览器访问板卡IP:8888），执行提供的推理脚本。脚本会自动加载预训练权重（MNIST手写数字识别），并启动推理循环。
步骤七：观察结果
脚本输出推理准确率（应>95%）和每帧推理延迟（单位毫秒）。若准确率偏低，请检查权重文件版本或输入数据预处理步骤。
验证结果
运行上述步骤后，记录准确率与延迟数据。典型结果：准确率96.2%，延迟8.3毫秒/帧。若偏差较大，请参考排障章节。
排障指南
- 比特流生成失败：检查Vivado版本是否匹配，或约束文件中的时钟频率是否超出板卡限制（PYNQ-Z2最大200MHz）。
- Jupyter无法连接：确认板卡IP地址正确，且防火墙未封锁8888端口。尝试通过串口登录板卡，运行
ifconfig查看网络状态。 - 推理准确率低：检查权重文件是否与BNN模型结构一致；验证输入图像是否已归一化至[0,1]范围。
- 延迟过高：可能因比特流未优化流水线。尝试在Vivado中启用综合优化（如retiming），或降低输入分辨率。
扩展与优化
本指南基于BNN实现推理加速，其核心机制在于将权重与激活值二值化（±1），从而将乘法累加运算简化为异或与位计数，大幅降低资源消耗。在边缘设备上，这种量化方法可在保持较高准确率的同时，将延迟降低至CPU方案的十分之一。
若需扩展至其他数据集（如CIFAR-10），需重新训练BNN模型，并调整FPGA上的数据通路宽度。风险边界：二值化网络对梯度噪声敏感，训练时需使用直通估计器（STE）技巧，否则准确率可能下降至80%以下。建议在仿真环境中验证后再部署。
参考资源
- BNN-PYNQ GitHub仓库：https://github.com/example/bnn-pynq
- PYNQ官方文档：https://pynq.readthedocs.io
- 二值神经网络论文：Courbariaux et al., "BinaryConnect: Training Deep Neural Networks with binary weights during propagations"
附录
附录A：硬件连接图
（此处可插入PYNQ-Z2与PC的USB连接示意图，以及SD卡插入位置标注。）
附录B：Vivado项目设置
在Vivado中创建新项目时，选择对应板卡型号（如xc7z020clg400-1 for PYNQ-Z2）。综合策略建议使用"Flow_PerfOptimized_high"，实现策略使用"Explore"以提升时序收敛概率。
附录C：常见错误代码
- Error: [Place 30-574]：资源不足，减少BNN层数或使用更小的输入尺寸。
- Error: [Timing 38-282]：时序未收敛，降低时钟频率或启用retiming。
