使用VectorCAST MATLAB Toolbox獲取代碼覆蓋度的基本步驟

在使用MATLAB Simulink進(jìn)行可視化仿真設(shè)計(jì)過程中，軟件在環(huán)測(cè)試（SIL，Software-in-Loop）和處理器在環(huán)測(cè)試（PIL，Processor-in-Loop）是兩種針對(duì)模型開發(fā)不同階段的常用方法，用于有效驗(yàn)證生成的嵌入式代碼。SIL測(cè)試目的是驗(yàn)證嵌入式代碼的正確性，甄別潛在的問題，并評(píng)估程序的初步性能，一般在PC上即可執(zhí)行；PIL則須運(yùn)行在物理目標(biāo)板上，主要用于驗(yàn)證嵌入式程序與硬件的交互。在SIL或PIL驗(yàn)證的過程中，可以使用VectorCAST MATLAB Toolbox來捕獲代碼的覆蓋數(shù)據(jù)，從代碼覆蓋的角度體現(xiàn)SIL/PIL驗(yàn)證的充分性。

VectorCAST MATLAB Toolbox簡(jiǎn)介

VectorCAST MATLAB Toolbox是VectorCAST研發(fā)團(tuán)隊(duì)在年中完成內(nèi)部驗(yàn)證和確認(rèn)后推出的升級(jí)工具箱產(chǎn)品，可獨(dú)立安裝或內(nèi)嵌于最新版安裝包，用來獲取SIL/PIL測(cè)試過程中的代碼覆蓋數(shù)據(jù)，以提高基于模型的需求-設(shè)計(jì)-實(shí)現(xiàn)流程測(cè)試的完整性。目前此工具箱支持的編譯鏈如下：

Microsoft Visual Studio各版本

MinGW

Green Hills PowerPC

下文將以SIL測(cè)試為例介紹其安裝和使用方法。

使用前提

1.已安裝VectorCAST/QA 2021SP5或更高版本，并配置啟用有效的許可證?？赏ㄟ^Help -> About VectorCAST菜單查看工具版本信息。

通過Help -> Available License查看支持的許可證特性，確保具有INSTRUMENTER和CLICOVER許可證特性。

圖2：必需的許可證特性

2.已安裝并能使用MATLAB R2021b或更高版本。

3.待驗(yàn)證的Simulink模型文件和測(cè)試用例均已設(shè)計(jì)完成，且能夠成功執(zhí)行SIL驗(yàn)證。

安裝工具箱

1.準(zhǔn)備安裝包。在VectorCAST 2023SP3及之后的版本中，自帶工具箱安裝包，安裝包文件VectorCAST.mltbx在VectorCAST安裝目錄下的simulink文件夾中。2023SP3之前的版本，請(qǐng)致信支持郵箱（support@cn.vector.com）獲取安裝包文件。

2.打開MATLAB，將VectorCAST.mltbx安裝包文件拖放到MATLAB主界面中的命令行窗口中開始安裝。

安裝完畢，在MATLAB中點(diǎn)擊菜單Add-Ons | Manage Add-Ons查看是否已安裝成功。如果列出VectorCAST插件條目，則表明此插件已安裝成功，如圖3所示：

圖3：VectorCAST MATLAB Toolbox信息

可以通過插件所在行后的隱藏菜單中的“Open Documentation”子菜單打開幫助文檔，如下圖：

圖4：打開文檔菜單

配置覆蓋度類型

1.在Simulink中打開已經(jīng)配置好測(cè)試用例的被測(cè)模型

2.在Simulink界面的菜單欄中找到VECTORCAST工具欄

3.點(diǎn)擊Coverage Configuration

4.選擇“Industry Mode”

5.選擇“Coverage type”

6.勾選“Generate Reports”

7.點(diǎn)擊OK

圖5：設(shè)置覆蓋度類型

設(shè)置SIL驗(yàn)證選項(xiàng)

1.點(diǎn)擊SIL/PIL菜單

2.點(diǎn)擊Settings按鈕打開配置窗口

3.展開Code Generation代碼生成欄目

4.在Build Process組中選擇Toolchain為MinGW64

圖6：選擇編譯工具鏈

5.展開Verification欄目

6.在代碼覆蓋組中選擇第三方工具為VectorCAST

7.點(diǎn)擊Configure按鈕打開配置界面

8.選擇VectorCAST安裝路徑

圖7：設(shè)置覆蓋度工具為VectorCAST

圖8：配置VectorCAST安裝路徑

執(zhí)行SIL驗(yàn)證

設(shè)置SIL/PIL模式為SIL，并點(diǎn)擊Run Verification開始驗(yàn)證。

圖9：開始SIL驗(yàn)證

驗(yàn)證完成后，會(huì)在日志窗口顯示三種測(cè)試報(bào)告，點(diǎn)擊可直接打開報(bào)告文件。

圖10：三種測(cè)試報(bào)告

Aggregate Coverage Report（匯總代碼報(bào)告）顯示模型生成代碼在驗(yàn)證過程中的匯總覆蓋度數(shù)據(jù)

VectorCAST Metrics Report（度量報(bào)告）顯示所有函數(shù)的覆蓋度數(shù)據(jù)

VectorCAST Management Report（測(cè)試項(xiàng)目管理報(bào)告）顯示當(dāng)前模型多次驗(yàn)證的所有結(jié)果

圖11：匯總代碼報(bào)告

圖12：函數(shù)覆蓋度報(bào)告

圖13：測(cè)試結(jié)果報(bào)告

以上是在SIL驗(yàn)證中如何使用VectorCAST MATLAB Toolbox獲取代碼覆蓋度的基本步驟。關(guān)于此工具箱的更多定制功能和詳細(xì)說明，請(qǐng)參見插件的說明文檔或致信支持郵箱。

審核編輯：湯梓紅