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

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