vFlash是一款上位機(jī)刷寫軟件。用戶既可以通過vFlash的圖形用戶界面實(shí)現(xiàn)ECU刷寫，也可以將配置好的工程導(dǎo)出成.vflashpack工程，借助于自動(dòng)化接口（Automation API）集成到已有的環(huán)境中實(shí)現(xiàn)自動(dòng)化刷寫。

使用Automation API，客戶端應(yīng)用程序可以加載現(xiàn)有的vFlash工程，啟動(dòng)/停止刷寫過程以及獲取刷寫進(jìn)度和狀態(tài)信息等。用戶可以在vFlash軟件界面中、安裝路徑下或者幫助文檔中獲取Automation API的詳細(xì)定義、描述以及示例工程（注：本文示例及相關(guān)截圖以vFlash v10為例）。

vFlash支持C++/C#調(diào)用

在vFlash安裝完成之后，在Visual Studio工程中添加VFlashAutomationTypes.h和VFlashAutomation.h的頭文件，就可以使用vFlash Automation C++ API函數(shù)加載現(xiàn)有的vFlash工程，啟動(dòng)/停止刷寫過程以及獲取刷寫進(jìn)度和狀態(tài)信息等。

上圖中的main函數(shù)中展示了常用的vFlash Automation API函數(shù)，例如在函數(shù)vFlashLoadProject中添加所使用的.vflashpack工程的路徑，以及如需進(jìn)行壓力刷寫測試，可以在for語句中設(shè)置需要重復(fù)刷寫的次數(shù)。

刷寫過程如下圖：

也支持通過C#調(diào)用vFlash的.vflashpack工程，實(shí)現(xiàn)刷寫。

用戶可以在vFlash安裝目錄下找到C++/C#調(diào)用.vflashpack工程的示例，路徑如下：

C:UsersPublicDocumentsVectorvFlash10ExamplesAutomationvFlashAutomation

vFlash支持.bat調(diào)用

vFlash支持.bat調(diào)用，在vFlash的安裝目錄下提供了一個(gè)vFlashCIAutomation示例，路徑如下：

C:UsersPublicDocumentsVectorvFlash10ExamplesAutomationvFlashCIAutomation

在該示例工程中，通過C#調(diào)用vFlash Automation API函數(shù)生成了一個(gè)可執(zhí)行文件vFlashCIAutomationExampleConsoleApp.exe；在ExecuteFlashing.bat文件中調(diào)用該可執(zhí)行文件，設(shè)置vFlash工程的路徑，如下圖：

配置好ExecuteFlashing.bat文件后，即可脫離vFlash的圖形用戶界面，通過命令行或者雙擊ExecuteFlashing.bat文件的方式實(shí)現(xiàn)ECU刷寫，刷寫過程如下圖：

vFlash支持Python調(diào)用

Python程序可以調(diào)用vFlash對(duì)ECU進(jìn)行刷寫。vFlash提供一個(gè)包含C函數(shù)API的DLL文件，Python可以加載此DLL，并使用Python “ctypes”模塊調(diào)用C函數(shù)。

DLL文件的路徑如下圖：

Python調(diào)用vFlash刷寫ECU的過程如下圖：

vFlashLoadAndFlashProject.py文件中包含的Python程序請(qǐng)參看下方鏈接：

https://support.vector.com/kb?id=kb_article_view&sysparm_article=KB0012257

vFlash支持CANoe調(diào)用

CANoe可以通過CAPL函數(shù)訪問vFlash Automation API，實(shí)現(xiàn)自動(dòng)化刷寫，如下圖：

用戶可以在vFlash和CANoe安裝目錄下找到CANoe示例工程：

1.

CANoe安裝目錄下的示例工程（以CANoe v18為例）

C:UsersPublicDocumentsVectorCANoeSample Configurations 18.3.118ProgrammingvFlashAutomation

2.

vFlash安裝目錄下的示例工程

C:UsersPublicDocumentsVectorvFlash10ExamplesvFlash with CANoevFlashViaNodeLayer

在該示例工程中，通過在CANoe的節(jié)點(diǎn)中添加vFlash節(jié)點(diǎn)層DLL文件，即可使用CAPL函數(shù)訪問vFlash Automation API。該示例中展示了兩種CAPL API函數(shù)以及對(duì)應(yīng)的測試用例。

Blocking Reprogramming API

測試用例Blocking Reprogramming API中使用到的API函數(shù)只能在Test Modules或者Test Units中使用，因?yàn)橹挥性跍y試用例中才允許使用TestWaitFor…函數(shù)。

這些API函數(shù)允許采用簡單的程序來控制刷寫ECU，程序流將在函數(shù)中停止，直到任務(wù)完成或檢測到錯(cuò)誤。文件Utilities.cin中的函數(shù)TestWaitForvFlashPackReprogrammed將在一次調(diào)用中處理所有必要的步驟，在simple-use-case.can中對(duì)此進(jìn)行了展示。

必要的步驟將按下圖展示的順序自動(dòng)執(zhí)行，包括啟動(dòng)vFlash、加載工程、開始刷寫、卸載工程和關(guān)閉vFlash。

Non Blocking Reprogramming API

測試用例Non Blocking Reprogramming API中使用到的API函數(shù)可以在任何節(jié)點(diǎn)中使用，而不僅僅是在Test Modules或者Test Units中使用。

在仿真節(jié)點(diǎn)中，CAPL程序流不得停止，因此不可以使用TestWaitFor…函數(shù)。但可以使用一組不同功能的函數(shù)來調(diào)用vFlash進(jìn)行刷寫。文件Utilities.cin中的函數(shù)vFlashStartPackReprogramming啟動(dòng)CAPL函數(shù)調(diào)用序列，通過調(diào)用同樣在該文件中的CAPL回調(diào)函數(shù)來指示完成。在simple-use-case.can中對(duì)此進(jìn)行了展示。

執(zhí)行這些用例需要在上位機(jī)安裝vFlash且具有vFlash軟件的License。

此外，CANoe工程只需進(jìn)行一些調(diào)整，還可以實(shí)現(xiàn)對(duì)LIN、FlexRay和Ethernet等ECU進(jìn)行刷寫。

vFlash支持CANoe.DiVa調(diào)用

CANoe.DiVa可以加載.vflashpack工程，生成刷寫相關(guān)的測試用例。在CANoe.DiVa中需要做以下配置（以CANoe.DiVa v18為例）：

在Test Configuration->Download頁面需要做如下配置：

1.

在下圖1處加載一個(gè).vflashpack工程；

2.

如果CANoe.DiVa軟件加載的診斷數(shù)據(jù)庫中有擦除內(nèi)存相關(guān)的服務(wù)，可以在下圖2處選擇相應(yīng)的服務(wù)，以及設(shè)置擦除內(nèi)存所需的時(shí)間；

3.

在下圖3處勾選配置項(xiàng)并設(shè)置支持正常刷寫的最小/最大電壓值。

在Test Configuration->Tests頁面需要勾選“Download Tests”且做如下配置：

1.

勾選下圖1處的配置項(xiàng)，生成刷寫過程中掉電的測試項(xiàng)；

2.

勾選下圖2處的配置項(xiàng)，生成刷寫過程中停止刷寫序列的測試項(xiàng)；

3.

勾選下圖3處的配置項(xiàng)以及設(shè)置Durability test的次數(shù)，生成重復(fù)多次刷寫的測試項(xiàng)。這里設(shè)置的是重復(fù)正向刷寫的次數(shù)，支持設(shè)置的最大刷寫次數(shù)是99次。

將CANoe.DiVa工程導(dǎo)入CANoe工程中（版本為CANoe v18），執(zhí)行刷寫測試用例。

*注：在CANoe中執(zhí)行CANoe.DiVa生成的刷寫測試用例時(shí)，需要同時(shí)具備CANoe、CANoe.DiVa以及vFlash這三個(gè)軟件的License

vFlash支持CANape調(diào)用

CANape可以加載.vflashpack工程，完成ECU刷寫。在CANape軟件中，通過Tools->vFlash加載.vflashpack工程后，會(huì)彈出Vector vFlash Run的界面，點(diǎn)擊“Flash”按鈕，執(zhí)行刷寫。

*注：CANape中的vFlash無法創(chuàng)建和編輯vFlash工程。如需創(chuàng)建和編輯vFlash工程，需要使用vFlash軟件

vFlash支持Indigo調(diào)用

Indigo可以加載vFlash的.vflashpack工程，實(shí)現(xiàn)多個(gè)ECU的按序刷寫。在Indigo中，通過Start->Manage Flash Projects加載.vflashpack工程（以Indigo v10為例）。

然后，在Manage Windows頁面添加Reprogramming的窗口，點(diǎn)擊Action下方的按鈕即可執(zhí)行刷寫，如下圖：

小結(jié)

vFlash采用定制化插件vFlash Template的方式適配不同刷寫規(guī)范的刷寫流程，刷寫功能穩(wěn)定可靠，目前已有100多個(gè)整車廠的vFlash Template可提供給客戶使用。借助于vFlash提供的Automation API，可以將.vflashpack工程集成到多種環(huán)境中實(shí)現(xiàn)自動(dòng)化刷寫，以滿足用戶更多的刷寫場景。