vFlash是一款上位機刷寫軟件。用戶既可以通過vFlash的圖形用戶界面實現ECU刷寫，也可以將配置好的工程導出成.vflashpack工程，借助于自動化接口（Automation API）集成到已有的環境中實現自動化刷寫。

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

vFlash支持C++/C#調用

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

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

刷寫過程如下圖：

也支持通過C#調用vFlash的.vflashpack工程，實現刷寫。

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

C:UsersPublicDocumentsVectorvFlash10ExamplesAutomationvFlashAutomation

vFlash支持.bat調用

vFlash支持.bat調用，在vFlash的安裝目錄下提供了一個vFlashCIAutomation示例，路徑如下：

C:UsersPublicDocumentsVectorvFlash10ExamplesAutomationvFlashCIAutomation

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

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

vFlash支持Python調用

Python程序可以調用vFlash對ECU進行刷寫。vFlash提供一個包含C函數API的DLL文件，Python可以加載此DLL，并使用Python “ctypes”模塊調用C函數。

DLL文件的路徑如下圖：

Python調用vFlash刷寫ECU的過程如下圖：

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

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

vFlash支持CANoe調用

CANoe可以通過CAPL函數訪問vFlash Automation API，實現自動化刷寫，如下圖：

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

1.

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

C:UsersPublicDocumentsVectorCANoeSample Configurations 18.3.118ProgrammingvFlashAutomation

2.

vFlash安裝目錄下的示例工程

C:UsersPublicDocumentsVectorvFlash10ExamplesvFlash with CANoevFlashViaNodeLayer

在該示例工程中，通過在CANoe的節點中添加vFlash節點層DLL文件，即可使用CAPL函數訪問vFlash Automation API。該示例中展示了兩種CAPL API函數以及對應的測試用例。

Blocking Reprogramming API

測試用例Blocking Reprogramming API中使用到的API函數只能在Test Modules或者Test Units中使用，因為只有在測試用例中才允許使用TestWaitFor…函數。

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

必要的步驟將按下圖展示的順序自動執行，包括啟動vFlash、加載工程、開始刷寫、卸載工程和關閉vFlash。

Non Blocking Reprogramming API

測試用例Non Blocking Reprogramming API中使用到的API函數可以在任何節點中使用，而不僅僅是在Test Modules或者Test Units中使用。

在仿真節點中，CAPL程序流不得停止，因此不可以使用TestWaitFor…函數。但可以使用一組不同功能的函數來調用vFlash進行刷寫。文件Utilities.cin中的函數vFlashStartPackReprogramming啟動CAPL函數調用序列，通過調用同樣在該文件中的CAPL回調函數來指示完成。在simple-use-case.can中對此進行了展示。

執行這些用例需要在上位機安裝vFlash且具有vFlash軟件的License。

此外，CANoe工程只需進行一些調整，還可以實現對LIN、FlexRay和Ethernet等ECU進行刷寫。

vFlash支持CANoe.DiVa調用

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

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

1.

在下圖1處加載一個.vflashpack工程；

2.

如果CANoe.DiVa軟件加載的診斷數據庫中有擦除內存相關的服務，可以在下圖2處選擇相應的服務，以及設置擦除內存所需的時間；

3.

在下圖3處勾選配置項并設置支持正常刷寫的最小/最大電壓值。

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

1.

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

2.

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

3.

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

將CANoe.DiVa工程導入CANoe工程中（版本為CANoe v18），執行刷寫測試用例。

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

vFlash支持CANape調用

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

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

vFlash支持Indigo調用

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

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

小結

vFlash采用定制化插件vFlash Template的方式適配不同刷寫規范的刷寫流程，刷寫功能穩定可靠，目前已有100多個整車廠的vFlash Template可提供給客戶使用。借助于vFlash提供的Automation API，可以將.vflashpack工程集成到多種環境中實現自動化刷寫，以滿足用戶更多的刷寫場景。