上海潤(rùn)欣科技股份有限公司創(chuàng)研社

一、什么是chipwatcher

在編程開(kāi)發(fā)過(guò)程的調(diào)試階段，可以借助一些編譯環(huán)境集成的工具幫助我們更好地定位問(wèn)題。當(dāng)我們完成一份工程代碼但是觀測(cè)不到我們想要的結(jié)果時(shí)，我們需要進(jìn)一步確認(rèn)是哪部分的代碼出現(xiàn)了偏差導(dǎo)致得不到我們想要的結(jié)果。

對(duì)于MCU來(lái)說(shuō)，我們可以借助JLINK仿真器來(lái)實(shí)現(xiàn)斷點(diǎn)測(cè)試，進(jìn)而觀察每一步的數(shù)據(jù)變化，從而定位到問(wèn)題所在；對(duì)于FPGA而言，想要觀察內(nèi)部信號(hào)的變化，也有對(duì)應(yīng)的工具可以使用。

這些工具，不同的芯片廠商根據(jù)自家的編譯環(huán)境集成了他們各自的工具，例如，XilinxISE的chipscope，alteraquartusII的SignalProbe等。本文中安路TD的chipwatcher也是用于觀測(cè)電路內(nèi)部信號(hào)變化的工具，可以認(rèn)為這是一款類(lèi)似于邏輯分析儀的工具，只不過(guò)觀測(cè)的信號(hào)不是芯片引腳上面的信號(hào)，而是電路內(nèi)部的信號(hào)。

當(dāng)我們需要定位問(wèn)題的時(shí)候，可以在工具中添加我們想要查看的信號(hào)，通過(guò)抓取波形來(lái)確認(rèn)信號(hào)是否在根據(jù)我們的需求進(jìn)行變化。

二、Chipwatcher使用流程

首先，一個(gè)FPGA工程常見(jiàn)的構(gòu)成如下：

1.功能代碼文件：后綴為.v的文件，通俗地講就是我們自己寫(xiě)的代碼。

2.例化的IP文件：通過(guò)編譯軟件來(lái)例化的IP的代碼，不同廠商例化后的IP文件名后綴有差異，安路的TD中直接將例化完畢后的.v文件加入工程即可。這類(lèi)文件不是必須的，有用到需要的IP就加，沒(méi)有不加。

3.IO約束文件：用來(lái)定義整個(gè)工程的輸入輸出信號(hào)對(duì)應(yīng)的具體芯片引腳是哪個(gè)。這類(lèi)文件可以不加，不加的話編譯工具會(huì)自動(dòng)分配IO口。

4.時(shí)鐘約束文件：即SDC文件。同IO約束文件，不加的話編譯器會(huì)自己約束，因此當(dāng)工程較大時(shí)序較為復(fù)雜時(shí)通常需要我們自己約束。

以上四種文件通過(guò)編譯后一起生成的整個(gè)工程的bit文件燒錄進(jìn)FPGA芯片后，假設(shè)代碼功能正常，則芯片開(kāi)始工作。

假設(shè)功能不正常，當(dāng)我們想要觀察電路內(nèi)部信號(hào)的時(shí)候，我們還需要在工程中加入另一類(lèi)文件，即第五類(lèi)文件，然后將這五類(lèi)文件統(tǒng)一打包成bit文件后下載進(jìn)FPGA，此時(shí)才可以利用工具觀測(cè)和抓取到我們想看的信號(hào)。

這第五類(lèi)文件，在TD中，即為Chipwatcher工具生成的.cwc文件。

下圖展示了一個(gè)加入.cwc文件后的工程目錄（該工程中未加入時(shí)序約束文件）：

生成cwc文件的過(guò)程如下：

Tools->DebugTools->chipwatcher

進(jìn)入到chipwatcher頁(yè)面：

如上圖，①區(qū)是選擇采樣時(shí)鐘和采樣深度，采樣時(shí)鐘的選擇注意要選擇全局時(shí)鐘中頻率最高的時(shí)鐘，采樣深度越深（即數(shù)值越大），最終生成的bit文件所占用的芯片資源越多。

②區(qū)是添加想觀察的信號(hào)的區(qū)域，添加方法：在該區(qū)域右鍵后，選擇addnodes進(jìn)入到信號(hào)選擇的頁(yè)面，如下：

如圖可以選擇想要觀察的信號(hào)至右側(cè)，全部選擇完畢后，點(diǎn)擊OK即可。

需要注意的是，有些信號(hào)會(huì)自動(dòng)被編譯器優(yōu)化，而在list中不被顯示，此時(shí)若是想觀測(cè)對(duì)應(yīng)的信號(hào)，可以回到我們的代碼中加上如下關(guān)鍵詞即可：

添加完想要觀察的信號(hào)后，設(shè)置觸發(fā)條件。

如圖，在triggerenable欄選擇觸發(fā)信號(hào)，在riggercondition欄選擇觸發(fā)條件（右鍵）

觸發(fā)條件共有以下幾種：

分別表示低電平觸發(fā)、高電平觸發(fā)、上升沿觸發(fā)、下降沿觸發(fā)和邊沿觸發(fā)。

在如上圖處設(shè)置觸發(fā)信號(hào)之間的關(guān)系。圖中設(shè)置為或，即只要其中一個(gè)信號(hào)滿足條件即可。

上圖中的整體觸發(fā)條件設(shè)置完畢后可敘述為：當(dāng)int_mem_we信號(hào)或int_mem_re信號(hào)其中之一為高電平時(shí)，抓取當(dāng)前int_mem_wdata[31:0]、int_mem_addr[10:0]、int_mem_rdata[31:0]、int_mem_we和int_mem_re的波形。

編輯完畢后即可保存文件。

保存后生成對(duì)應(yīng)的cwc文件，同時(shí)將文件加入工程，最后編譯下載至開(kāi)發(fā)板。

（注釋?zhuān)孩贋閷⑸傻腸wc文件加入工程，②為編譯工程，③為將bit文件下載至開(kāi)發(fā)板）

下載成功后，返回chipwatcher設(shè)置頁(yè)面，如下圖選擇singletrigger，即單次觸發(fā)。

當(dāng)程序運(yùn)行并滿足觸發(fā)條件時(shí)，chipwatcher會(huì)抓取到波形，如下：

三、FPGA調(diào)試與MCU調(diào)試的一些思路差異

Chipwatcher的調(diào)試過(guò)程大體如第二章中所示，但是很長(zhǎng)一段時(shí)間，我并沒(méi)有在chipwatcher中觀察到任何波形，究其原因是沒(méi)有從MCU調(diào)試的思維轉(zhuǎn)變過(guò)來(lái)。

MCU的斷點(diǎn)調(diào)試，可以認(rèn)為是一步一步執(zhí)行的，沒(méi)有點(diǎn)擊下一步之前，程序會(huì)一直停留在當(dāng)前位置（除非程序跑飛）。

而FPGA調(diào)試沒(méi)有這種機(jī)制，當(dāng)bit文件下載至芯片后，程序是一直執(zhí)行的，而點(diǎn)擊singletrigger后只不過(guò)是當(dāng)滿足觸發(fā)條件時(shí)抓取當(dāng)前波形而已。抓取完畢會(huì)顯示波形，程序卻依舊在繼續(xù)執(zhí)行，不會(huì)停留在抓取完畢的那一刻。

當(dāng)我使用chipwatcher觀察AHB協(xié)議傳輸時(shí)，沒(méi)有在數(shù)據(jù)線和地址線上面觀察到波形就是沒(méi)有意識(shí)到這點(diǎn)。在bit文件下載進(jìn)芯片時(shí)傳輸就已經(jīng)開(kāi)始了（對(duì)比MCU的調(diào)試，通常MCU調(diào)試開(kāi)始時(shí)，環(huán)境一般會(huì)在main函數(shù)起始自動(dòng)設(shè)置斷點(diǎn)），假設(shè)傳輸在我開(kāi)啟觸發(fā)按鍵前就已經(jīng)完成，則傳輸線上就會(huì)一直觀察不到數(shù)據(jù)，觸發(fā)條件也會(huì)一直不成立。

因此，為了確保能夠順利抓取到傳輸?shù)臄?shù)據(jù)，需要在傳輸前設(shè)置相應(yīng)的延時(shí)，保證當(dāng)點(diǎn)擊singletrigger，chipwatcher開(kāi)始根據(jù)設(shè)置的觸發(fā)條件抓取波形時(shí)，數(shù)據(jù)的傳輸還沒(méi)有開(kāi)始。

例程是MCU和FPGA根據(jù)AHB協(xié)議進(jìn)行通信，因此后來(lái)我在MCU的工程中添加了一段延時(shí)：

確保留出足夠的時(shí)間來(lái)操作chipwatcher。
fqj