SOMEIP_IL CAPL Function

一、SOMEIP_IL CAPL Function API

为了方便进行SOME/IP的通信仿真，CANoe提供了SOME/IP Interaction layer函数API接口

这里仅介绍我用到过的API接口，满足了SOME/IP一般仿真通信的需求

如果要学习更加详细的API使用方法，建议通过F1查看CANoe官方帮助文档。

二、添加SOME/IP_IL库

如果要使用该CAPL API，仿真节点必须添加SOME/IP_IL.dll动态库，该库位于自己电脑CANoe软件安装目录下：

如D:\Program Files\Vector CANoe 16\Exec32\SomeIP_IL.dll

或D:\Program Files\Vector CANoe 16\Exec64\SomeIP_IL.dll

或D:\Program Files\Vector CANoe 16\Exec64\SomeIP_IL.vmodule

对于Network Node，可以右键节点->点击Configuration->选择Components->点击Add，找到本机上库的路径添加

对于Test Module节点，添加方式类似，右键节点->点击Configuration->选择Components->点击Add

三、Endpoints Function

Endpoints帮助文档中有四个函数接口，我常用的只有前两个，用法也非常简单，分别是打开和关闭用于SOME/IP通信的endpoint。

Endpoint操作不论仿真节点是做客户侧还是服务侧都是必须的，在创建SOME/IP通信前打开endpoint，停止通讯时关闭该endpoint。至于什么是endpoint，官方文档上描述"An endpoint represents a socket."

SomeIpOpenLocalApplicationEndpoint的四种用法：

//格式1
dword SomeIpOpenLocalApplicationEndpoint( dword transportProtocol, dword port );

//格式2
dword SomeIpOpenLocalApplicationEndpoint( dword transportProtocol, dword port, dword ipv4Address );

//格式3
dword SomeIpOpenLocalApplicationEndpoint( dword transportProtocol, dword port, byte ipv6Address[] );

//格式4
dword SomeIpOpenLocalApplicationEndpoint( IP_Endpoint localIPEndpoint);

/*API参数介绍
*transportProtocol: 6->TCP, 17->UDP
*port: TCP或UDP的port
*ipv4Address：ipv4的地址
*ipv6Address: ipv6的地址
*localIPEndpoint：IP_Endpoint类型的Object
*/

简单举个open Application Endpoint例子：

void Initialize()
{
    DWORD aep; // Application Endpoint handle
    
    //格式1用法，使用UDP，port为50002
    //aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);

    //格式4用法，使用UDP，IP采用192.168.0.1，port为50002
    aep = SomeIpOpenLocalApplicationEndpoint(IP_Endpoint(UDP:192.168.0.1:50002));
}

以上四种用法根据需要任选其一即可，但是需要注意，不论是API中是否指定IP地址，在使用该API前，都需要首先配置仿真节点的TCP/IP stack，这一步骤在CANoe窗口的Simulation->TCP/IP Stack中配置，当然也可以通过CAPL函数进行配置，这里就不做赘述。

SomeIpCloseLocalApplicationEndpoint用法：

关闭Endpoint的方法十分简单，只需要将Open时返回的aep当做参数传入该API接口即可。

LONG SomeIpCloseLocalApplicationEndpoint( dword aepHandle );

四、待更新