CANoe：.vmodule文件是什么
目录
问题背景
Why：文件有什么用（.vmodule:模块描述文件） (Help文档)
模块类型1：CAPL-DLL
模块类型2：NodeLayer-DLL
模块类型3：C Library
What：简而言之
有什么：文件内容
HOW-操作：如何为节点添加DLL/vmodule文件
方式1：为单个Node添加
方式2：按通道添加
方式3： 通过DBC定义添加
When： 何时需要添加这个配置文件
问题背景
今天新建一个CANoe简易工程的时候，没有直接在DBC里面添加Network Node，中间遗漏了添加Node的IL配置文件，导致报文未按照DBC中的定义正常发出。
后来，添加Node的IL配置文件时，发现能找的文件不是dll格式的（以前操作的时候，都是dll文件），而是.vmodule的后缀。搜了下各网站，发现对.vmodule文件的介绍都很少。
图1 节点添加DLL文件
但Help文档的介绍还比较清晰。因此在这里记录下，help文档中对.vmodule文件的介绍。
Why：文件有什么用（.vmodule:模块描述文件） (Help文档)
先放结论：主要是为了解耦CANoe工程运行的平台与工程的配置，使得可以在不同平台都能共用同一个工程配置。
下面是help文档中的详细描述。
中文翻译：
模块描述文件(*.vmodule)包含模块的文件路径和元数据。
支持以下模块类型:
· CAPL DLL ：CAPL动态链接库
· Moduling Library： 建模库(节点层DLL)
· C Library： C库
在CANoe的旧版本中，模块的实现(例如CAPL DLL的路径)被直接输入到CANoe的配置文件。
又因为工程实现通常特定于一个平台，这使得在不同平台间交换配置非常困难
(例如：Windows 32位和 64位或Linux 64位)。
因此，从CANoe版本12.0 SP3开始，可以在配置中输入模块描述文件，而不是具体的实施。
这个模块描述文件可以包含不同平台的实现的文件路径。
从CANoe版本13.0开始，还可以指定与应用程序(CANoe)相关的版本。
这使得它可以在不同的版本中使用不同版本的DLL或者定义应用程序的最小版本。
模块类型1：CAPL-DLL
模块类型2：NodeLayer-DLL
模块类型3：C Library
What：简而言之
也就是说，vmodule文件就是原本的dll文件，而且不止包含dll文件。
vmodule和dll都使用xml文件格式编写内容。
有什么：文件内容
下图是CANoe Sample中附带的vmodule文件，也是简易工程中常用的IL文件：CANoeILNLVetctor.vmodule(C:\ProgramData\Vector\AddOn Packages\Vector AddOn\vModules)
可以发现文件中，除了路径、版本等的说明之外，主要功能是对IL层的相关函数做出说明。
HOW-操作：如何为节点添加DLL/vmodule文件
有3种方法，可以分别通过Simulation和DBC文件添加。
前两种是通过Simulation Setup添加，其中
- 一种是逐个节点添加vmodule文件
- 另一种是为当前网络通道统一添加vmodule
方式1：为单个Node添加
1.Simulation Setup中对相应节点点击右键，选中Configuration
2. 在第2个标签页Components中，点击ADD，添加所需要的文件
添加完成后，节点的配置显示如下（网络显示为当前网络名，且不可remove？）：
方式2：按通道添加
如果同一通道中的所有节点，使用相同的vmodule文件，那么可以使用此方法统一添加。
如图，在通道节点上右键选择Assign Module to all Network Nodes，选择所需文件即可。
使用此方法添加完成后，点击单个节点configuration如下：
方式3： 通过DBC定义添加
如果DBC文件：
- 是基于IL的DBC模板建立的
- DBC中定义好了Network Node节点
- 将DBC文件导入到Simulation Setup时，也把节点同步(Node Synchronization)导入了工程
图2 基于IL新建DBC
图3 DBC中定义完善Network Node与Message Signal的收发关系
图4 Node Synchronization
那么node节点不需要再通过上述两种方式添加IL配置，查看配置，可以发现已经具备了IL配置。
When 何时需要添加这个配置文件
这里所使用的配置文件是IL文件，IL文件是用于定义message、signal的发送方式的。
也就是说，如果需要使用DBC中所定义的信号发送方式来进行仿真或测试，那么就需要添加这个配置文件，
而如果不需要使用DBC中的定义，只是依靠手动发送，比如
- 通过panel面板点击控制发送，
- 通过IG节点发送
- 通过CAPL编程发送
则不添加这个配置，也不会影响报文的收发。
END