用户自定义操作Custom Action的两种开发方式

vFlash专为汽车OEM和ECU供应商中执行刷写任务的人员所设计，用以实现高效的ECU刷写。vFlash可以通过标准软件的图形界面进行控制，也可以简单地作为库集成到现有环境中实现自动刷写。使用特别版本“vFlash Station”，可以实现多达8个ECU的并行刷写。此外，使用vFlash Option Remote，可以实现远程刷写任务。

vFlash采用定制化插件vFlashTemplate定义不同刷写规范的刷写流程，全球已经有超过80家OEM定制vFlashTemplate。每个vFlashTemplate对应一份刷写规范或一家OEM相同流程的不同总线刷写规范。换句话说，同一个车型遵循同一份刷写规范，该车型上所有ECU可以使用同一个vFlashTemplate。

然而，在刷写规范所定义的统一刷写流程之外，不同的ECU可能还需要执行不同的动作来满足该ECU或用户特定的任务，例如刷写前读取ECU相关配置信息并记录，刷写后将这些配置信息重新写入新的软件中，同时生成报告。vFlash的自定义操作-Custom Action即可满足这样的任务需求。Custom Action分为Pre Custom Action和Post Custom Action（图1），即刷写执行前的自定义动作和刷写执行后的自定义动作。

Custom Action的开发可以采用手动和自动两种方式。

01

手动开发Custom Action

Custom Action是一个常规的C#/.NET程序集。但是，Custom Action开发必须调用一组vFlash所需的附加库，以便执行诊断任务。可调用的附加库为：

Vector.Diagnostics

Vector.vFlash.CustomActions

Vector.vFlash.Tools

Vector Diagnostics API是Vector Diagnostic Scripting（VDS）诊断脚本库，通过该脚本库可以调用诊断数据库CDD或ODX中描述的诊断服务，从而快速有效地获取诊断服务的发送与接收指令。

Vector vFlash Custom Action API定义的函数通常用于与vFlash软件相关的Custom Action的动作，例如CustomActionAttribute接口函数提供将数据从vFlash传输给Custom Action的方式，IAuthenticationProperties接口函数用于向ECU验证vFlash的信息。

Vector vFlash Tools API用于在Custom Action中生成报告。

用户可以在vFlash软件界面中、安装路径下或帮助文档中获取以上API的详细定义、描述以及示例工程（图2）。

根据这些API以及参考示例工程，用户通过C#编程软件（例如Microsoft Visual Studio）实现所需的Custom Action，编译生成DLL动态链接库。

此外，为了简化用户编程的工作量，在vFlash软件安装包中附带有Visual Studio Extension for Custom Action Development插件安装（图3）。

该插件适用于Visual Studio 2015和2017。通过该插件，可以在新建工程时选择vFlash Custom Action模板（图4），该模板工程中已经正确关联了Vector Diagnostics、Vector vFlash Custom Actions等相关程序集（图5），便于用户快速开启程序编辑。

02

自动开发Custom Action

参数化诊断仪Indigo具有记录诊断脚本的功能Script Recording（详情可见《基于参数化诊断仪Indigo的二次开发》），该功能记录的诊断序列可保存为vFlash Custom Action脚本提供给vFlash工程使用。使用Indigo的脚本记录功能，无需用户掌握编程技巧，即可快速有效地定制诊断序列脚本。

在Indigo的脚本记录器的界面上（图6），可以通过选择激活的ECU列表，选择需要执行诊断操作的ECU；通过左侧的服务列表执行具体的诊断服务；同时可以通过菜单行的确认对话框等窗口定义脚本中所需的非诊断序列的执行动作，满足脚本执行过程中的用户交互的相关功能。

在完成所需的脚记录后，可将脚本另存为vFlash Custom Action脚本（图7）：

保存脚本之前还可以根据用户需求设置vFlash Custom Action属性（图8），确认后即可保存C#工程：

通过Indigo的脚本记录器生成的脚本工程，还可以通过C#编译软件二次开发，满足用户更多的自定义需求，编译生成DLL动态链接库。

03

Custom Action的使用

手动或自动开发Custom Action的DLL动态链接库之后，可以在vFlash工程中，通过Configure-Custom Action页面加载相关ECU的CDD文件以及开发好的DLL文件，同时对相关属性进行配置（图9）。

添加Custom Action内容的vFlash工程在执行时，可在软件刷写界面查看Custom Action执行的情况以及Trace（图10）：

vFlash Custom Action的主要用例：

质量保证 – 例如在数据库或报告中读取ECU信息并记录刷写成功与否信息；

标签打印 – 读取序列号等ECU信息并将信息发送到打印机；

恢复ECU信息 – 刷写前从ECU读取数据，刷写后重新写入/恢复数据；

参数化 – 刷入参数化系统后将数据写入ECU。

04

小结

vFlashTemplate固化刷写流程的主序列，保证刷写功能的稳定性和可靠性，目前已有80多个OEM的vFlashTemplate可供客户使用。

Custom Action能够满足刷写流程的用户自定义应用场景，在不改动刷写流程主序列的前提下，实现刷写序列的定制化。

通过Custom Action的补充，在刷写的同时实现ECU所需数据的自动写入或报告自动生成，使得刷写工程更完整，更易用。

责任编辑：haq