作者：碎碎思，來源：OpenFPGA微信公眾號(hào)

有的時(shí)候需要查找一些官網(wǎng)的例程進(jìn)行學(xué)習(xí)和參考，但是總感覺無從下手，今天就教大家怎么利用官網(wǎng)和Vivado的Documention進(jìn)行相關(guān)的操作。

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

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

打開后如下：

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

可以在3窗口進(jìn)行搜索。

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

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

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

可以按照自己的需求進(jìn)行設(shè)置。

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

這里提供兩種方式：

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

這兩個(gè)位置可以下載相關(guān)參考例程，直接點(diǎn)擊下載即可，建議該文檔直接使用Chrome打開，點(diǎn)擊鏈接會(huì)知道跳轉(zhuǎn)，其他PDF閱讀器也可。

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

雙擊進(jìn)入

其中左上角的Documentation，有Product Guide等文檔，其中Change Log（修改BUG記錄）、Product Webpage和Answer Records都是比較重要的文檔，對(duì)使用好該IP都有很重要的作用，因?yàn)榕c本篇文章不想關(guān)，這里就不展開描述了，點(diǎn)擊Product Guide就能通過Xilinx Documentation打開這個(gè)文檔，這個(gè)文檔相當(dāng)相當(dāng)重要，包括整個(gè)IP的使用說明，每個(gè)參數(shù)的說明，時(shí)序相關(guān)，以及一些Debug，仿真相關(guān)說明，如果在使用該IP時(shí)出現(xiàn)問題，請(qǐng)仔細(xì)閱讀該文檔，同時(shí)該文檔會(huì)提供參考示例鏈接（這個(gè)IP比較特殊，是兩個(gè)IP結(jié)合在一起的，所以沒有refence（瘋狂翻車））。

怎么使用下載下來的參考設(shè)計(jì)

目前官網(wǎng)下載下來的參考例程異?！昂?jiǎn)單"，主要通過TCL腳本提供，對(duì)于不熟悉使用該腳本的人可能會(huì)比較懵，但是不需要過于擔(dān)心，只需要按照下面的步驟就可以輕松利用該腳本構(gòu)建Vivado工程。

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

進(jìn)入到/xapp1082/xapp1082_2017_4/hardware/vivado/scripts文件夾下，可以看到四個(gè)例程：

作用就不展開描述了，隨便進(jìn)入一個(gè)文件夾下：

里面只用三個(gè)文件，總大小不足100k（要是一個(gè)完整的工程，至少要100M左右，所以TCL的作用不言而喻），進(jìn)如這個(gè)文件夾主要想要確認(rèn)下導(dǎo)出該腳本的Vivado版本（不確認(rèn)的話，后期運(yùn)行會(huì)報(bào)錯(cuò)），外層文件夾已經(jīng)有相關(guān)的版本說明了（xapp1082_2017_4）打開pl_eth_sgmii_bd.tcl（記事本及相關(guān)文本閱讀器都可以）：

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

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

通過CD命令進(jìn)入歷程所在的文件夾：

注意這里是“/”不是WIN系統(tǒng)常用的“/”，之后執(zhí)行：

vivado -source pl_eth_sgmii.tcl

就可以打開Vivado并自動(dòng)構(gòu)建Demo了：

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

構(gòu)建的工程保存在如下路徑：

至此這篇文章相關(guān)內(nèi)容基本完成，如果覺得對(duì)你有幫助，請(qǐng)動(dòng)動(dòng)你的小手。