作者：碎碎思，來源：OpenFPGA微信公眾號

有的時候需要查找一些官網的例程進行學習和參考，但是總感覺無從下手，今天就教大家怎么利用官網和Vivado的Documention進行相關的操作。

不清楚使用哪些IP或者不清楚需要參考哪個文檔

首先點擊Help-->Documention and Tutorials就可以打開XIlinx Documention瀏覽器了。

打開后如下：

主要分為：1、分類窗口；2、文件選擇窗口；3、設置窗口；4、選擇窗口；

可以在3窗口進行搜索。

假如現在我需要查找一下7系列FPGA中關于HLS的使用，那么我可以通過1窗口進行分類選擇，如下：

就可以在2窗口得到我想要的文檔：

點擊進去就可以閱讀，如果想要下載也可以，這里可以進行兩種設置，一是下載路徑設置二是打開文檔的閱讀器設置，具體位置如下圖所示：

可以按照自己的需求進行設置。

找到了或者已知使用哪種或者哪個IP怎么下載例程

這里提供兩種方式：

1、使用Xilinx Doc直接搜索相關的Doc，這里舉例AXI ethernet，相關的應用手冊是xapp1082（還有其他的參考，這里以比較常見的舉例），直接搜索這個文檔，打開后如下圖所示：

這兩個位置可以下載相關參考例程，直接點擊下載即可，建議該文檔直接使用Chrome打開，點擊鏈接會知道跳轉，其他PDF閱讀器也可。

2、在IP管理器里找到該IP

雙擊進入

其中左上角的Documentation，有Product Guide等文檔，其中Change Log（修改BUG記錄）、Product Webpage和Answer Records都是比較重要的文檔，對使用好該IP都有很重要的作用，因為與本篇文章不想關，這里就不展開描述了，點擊Product Guide就能通過Xilinx Documentation打開這個文檔，這個文檔相當相當重要，包括整個IP的使用說明，每個參數的說明，時序相關，以及一些Debug，仿真相關說明，如果在使用該IP時出現問題，請仔細閱讀該文檔，同時該文檔會提供參考示例鏈接（這個IP比較特殊，是兩個IP結合在一起的，所以沒有refence（瘋狂翻車））。

怎么使用下載下來的參考設計

目前官網下載下來的參考例程異常“簡單"，主要通過TCL腳本提供，對于不熟悉使用該腳本的人可能會比較懵，但是不需要過于擔心，只需要按照下面的步驟就可以輕松利用該腳本構建Vivado工程。

下載下來的參考文件一定要先閱讀readme文件，里面包含了整個例程的作用和文件構成，以XAPP1082為例如下：

進入到/xapp1082/xapp1082_2017_4/hardware/vivado/scripts文件夾下，可以看到四個例程：

作用就不展開描述了，隨便進入一個文件夾下：

里面只用三個文件，總大小不足100k（要是一個完整的工程，至少要100M左右，所以TCL的作用不言而喻），進如這個文件夾主要想要確認下導出該腳本的Vivado版本（不確認的話，后期運行會報錯），外層文件夾已經有相關的版本說明了（xapp1082_2017_4）打開pl_eth_sgmii_bd.tcl（記事本及相關文本閱讀器都可以）：

如果你的Vivado版本和這個一樣，那么不需要修改，如果不一樣請修改和你的版本一樣，我使用的是Vivado2018.3，修改如下：

接下來打開Linux terminal or Vivado tcl shell in windows

通過CD命令進入歷程所在的文件夾：

注意這里是“/”不是WIN系統常用的“/”，之后執行：

vivado -source pl_eth_sgmii.tcl

就可以打開Vivado并自動構建Demo了：

這里說明一下，我使用的Vivado版本和例程版本不相同所以構建完成后會有一些小Bug，按照提示修改即可。

構建的工程保存在如下路徑：

至此這篇文章相關內容基本完成，如果覺得對你有幫助，請動動你的小手。