功能覆蓋率指令說明(個(gè)人總結(jié)).doc

功能覆蓋率指令說明一、簡(jiǎn)介功能覆蓋率指令主要包括編譯、運(yùn)行和生成覆蓋率報(bào)告三個(gè)部分。編譯時(shí)將引入功能覆蓋率的定義，運(yùn)行將生成功能覆蓋率數(shù)據(jù)庫文件夾，最后通過覆蓋率報(bào)告生成工具根據(jù)功能覆蓋率數(shù)據(jù)庫文件夾生成對(duì)應(yīng)的覆蓋率報(bào)告。為了工具的統(tǒng)一性和方便界面提取，先做如下規(guī)定： 覆蓋率數(shù)據(jù)庫文件夾均放在CovData目錄下，ncsim生成的放入ncsim子目錄、vcs生成的放入vcs子目錄。 覆蓋率報(bào)告均放在FcovReport目錄下，ncsim生成的放入ncsim子目錄、vcs生成的放入vcs子目錄。 每條用例都生成獨(dú)自的同用例名的覆蓋率數(shù)據(jù)庫和覆蓋率報(bào)告文件夾。 最后生成總的覆蓋率數(shù)據(jù)庫和覆蓋率報(bào)告文件夾，名稱為total。文檔指令描述中，TC_NAME表示匹配用例名。二、VCS 指令說明1、樣例rm -r simv* CovData/vcs/*vcs +v2k -sverilog +define+marco=VCS+ test_1.sv./simv -cm_dir CovData/vcs/test_1 +ntb_random_seed=666666vcs +v2k -sverilog +define+marco=VCS+ test_2.sv./simv -cm_dir CovData/vcs/test_2 +ntb_random_seed=888888vcs +v2k -sverilog +define+marco=VCS+ test_3.sv./simv -cm_dir CovData/vcs/test_3 +ntb_random_seed=555555urg -dir CovData/vcs/test_1.vdb -report FcovReport/vcs/test_1 -format texturg -dir CovData/vcs/test_2.vdb -report FcovReport/vcs/test_2 -format texturg -dir CovData/vcs/test_3.vdb -report FcovReport/vcs/test_3 -format texturg -dir CovData/vcs/*.vdb -report FcovReport/vcs/total -format text2、指令說明(1)編譯-sverilog：增加對(duì)System Verilog語言的支持。+define+marco=VCS+：編譯的時(shí)候增加宏“VCS”。因?yàn)閚csim和vcs對(duì)功能覆蓋率某些關(guān)鍵字和用法支持不同，需要用宏來區(qū)分。(2)運(yùn)行-cm_dir CovData/vcs/TC_NAME：將生成的覆蓋率數(shù)據(jù)庫放到CovData/vcs目錄中，若目錄不存在，將自動(dòng)創(chuàng)建。生成的覆蓋率數(shù)據(jù)庫文件夾以vdb后綴，名稱要求同用例名，例：test_1.vdb。(3)生成覆蓋率報(bào)告urg dir CovData/vcs/TC_NAME.vdb report FcovReport/vcs/TC_NAME format text：用于生成各個(gè)用例的覆蓋率報(bào)告。urg dir CovData/vcs/*.vdb report FcovReport/vcs/total format text：用于生成總的覆蓋率報(bào)告。其中：-dir用于讀入指定目錄下指定覆蓋率數(shù)據(jù)庫XXX.vdb文件夾，通配符 * 表示讀入指定目錄下所有覆蓋率數(shù)據(jù)庫文件夾。 -report用于指定輸出覆蓋率報(bào)告的路徑，每個(gè)用例的報(bào)告要求分別輸出到同用例名FcovReport/vcs/TC_NAME的目錄下，總報(bào)告要求輸出到FcovReport/vcs/total的目錄下。若指定的目錄不存在，將自動(dòng)創(chuàng)建。 -format用于指定輸出報(bào)告的格式，text表示輸出文本格式，不指定則輸出html格式。三、NC指令說明1、樣例cov.cmd（ICCR腳本文件）set TC_NAME test_1set TC_NAME test_2set TC_NAME test_3set TC_NAME totalset_dut_modules testmerge CovData/ncsim/* -output totalsh mkdir -p FcovReport/ncsim/$TC_NAMEload_test CovData/ncsim/$TC_NAMEreport_summary -d -instance -cgopt test FcovReport/ncsim/$TC_NAME/dashboard.txtreport_detail -both -d -instance -cgopt test FcovReport/ncsim/$TC_NAME/grpinfo.txtrm -r irun* iccr* CovData/ncsim/* IN*mkdir FcovReport/ncsimirun -sv -svseed 666666 -covoverwrite test_1.sv -coverage u -covwork CovData -covdesign ncsim -covtest test_1iccr -keywords+summary+detail+test_1 cov.cmdirun -sv -svseed 888888 -covoverwrite test_2.sv -coverage u -covwork CovData covdesign ncsim -covtest test_2iccr -keywords+summary+detail+test_2 cov.cmdirun -sv -svseed 555555 -covoverwrite test_3.sv -coverage u -covwork CovData -covdesign ncsim -covtest test_3iccr -keywords+summary+detail+test_3 cov.cmdiccr -keywords+summary+detail+total cov.cmd2、指令說明(1)編譯-sv：增加對(duì)System Verilog語言的支持。(2)運(yùn)行-coverage u：收集覆蓋率選項(xiàng)，u表示基于SV的功能覆蓋率。-covoverwrite：再次運(yùn)行時(shí)可覆蓋已生成的覆蓋率數(shù)據(jù)庫，不加則不能覆蓋。-covwork：指定生成的cov_work目錄，要求指定為CovData目錄。-covdesign：指定成生的design目錄，要求指定為ncsim目錄。-covtest：指定生成的test目錄，要求指定為TC_NAME目錄，用于存放覆蓋率數(shù)據(jù)庫icc.data。(3)生成覆蓋率報(bào)告-keywords 腳本：用命令行的方式啟動(dòng)ICCR，關(guān)鍵字的功能在腳本中描述。ICCR生成覆蓋率報(bào)告的流程為：合并覆蓋率數(shù)據(jù)庫（僅用于輸出總覆蓋率報(bào)告） = 讀覆蓋率數(shù)據(jù)庫 = 輸出覆蓋報(bào)告（概要報(bào)告或者詳細(xì)報(bào)告）。cov.cmd腳本說明：1) 和中間描述在-keywords中添加該關(guān)鍵字將執(zhí)行的指令。注意，一條指令只能在一行中描述，和也必須分列一行。2) 在-keywords中添加的關(guān)鍵字順序和關(guān)鍵字所對(duì)應(yīng)的指令執(zhí)行的順序無關(guān)。3) 每一條用例必須對(duì)應(yīng)一套和，在該套關(guān)鍵字描述內(nèi)將給通配符$TC_NAME賦值為用例名，如：set TC_NAME TC_NAME。用于在每次運(yùn)行用例時(shí)在-keywords中添加用例名使每次運(yùn)行只輸出以該條用例名命名的覆蓋率報(bào)告文件，以方便界面處理。4) 需在腳本中添加和的關(guān)鍵字套，用于輸出總的覆蓋率報(bào)告。其中的指令包括：set：指定通配符為total；set_dut_modules：指定用例的模塊名，不指定則合并不成功；merge：合并覆蓋率數(shù)據(jù)庫，CovData/ncsim/* 表示合并CovData/ncsim/目錄下的所有覆蓋率數(shù)據(jù)庫文件，-output total表示輸出合并后的覆蓋率數(shù)據(jù)庫至CovData/ncsim/total目錄下。5) sh mkdir：在配置好通配名或者合并好覆蓋率數(shù)據(jù)庫后需要?jiǎng)?chuàng)建覆蓋率報(bào)告目錄，按照要求為FcovReport/ncsim/TC_NAME|total。6) load_test：讀指定目錄下覆蓋率數(shù)據(jù)庫，目錄為CovData/ncsim/TC_NAME|total。7) report_summary：輸出覆蓋率概要信息。-d 表示輸出報(bào)告為基于數(shù)據(jù)的功能覆蓋率；-instance表示為基于例化件的；-cgopt表示參詳coverpoint的結(jié)果；test為用例模塊名； 表示將覆蓋率報(bào)告重鏡象至指定文件中，按照要求每條用例或總覆蓋率概要信息必須保存在FcovReport/ncsim/TC_NAME|total/dashboard.txt文件中。這些參數(shù)都是必須的，否則輸出報(bào)告有誤。8) report_detail：輸出覆蓋率詳細(xì)信息。-both表示包含所有例化件；-d 表示輸出報(bào)告為基于數(shù)據(jù)的功能覆蓋率；-instance表示為基于例化件的；-cgopt表示參詳coverpoint的結(jié)果；test為用例模塊名； 表示將覆蓋率報(bào)告