CAPL学习-SOME/IP交互层-控制类API函数

Control API

SomeIpILControlGetStatus

函数
语法
long SomeIpILControlGetStatus();

功能

返回 SOME/IP IL 的当前状态。

参数

无

返回值

0 -- 未初始化
1 -- 已初始化（允许自动启动）
2 -- 已初始化（禁止自动启动）
3 -- 已初始化（预启动后禁止自动启动）
4 -- 激活
5 -- 已停止；已挂起
6 -- 测量停止中
7 -- 测量已结束

可用性

起始版本：13.0
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

无

SomeIpILControlInit

函数
语法
long SomeIpILControlInit();

功能

初始化 SOME/IP IL，阻止其自动启动。若使用此函数，必须通过 SomeIpILControlStart 函数手动启动 SOME/IP IL。
仅可在 on preStart 事件中使用。

参数

无

返回值

0：函数执行成功
0：错误代码

可用性

起始版本：8.1
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

capl 复制代码

on preStart  
{  
  // 阻止自动启动  
  SomeIpILControlInit();  
}

SomeIpILControlResume

函数
语法
long SomeIpILControlResume();

功能

在调用 SomeIpILControlWait 后恢复周期性消息发送。应用端点和提供的服务无需重新创建。

参数

无

返回值

0：函数执行成功
0：错误代码

可用性

起始版本：8.1
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

capl 复制代码

on key 'r'  
{  
  // 恢复消息发送  
  SomeIpILControlResume();  
}

SomeIpILControlStart

函数
语法
long SomeIpILControlStart();

功能

启动 SOME/IP IL，启用 SOME/IP 消息的收发及服务发现。启动后，必须创建所有应用端点和提供的服务。

可通过 SomeIpILControlStop 函数停止 SOME/IP IL。

参数

无

返回值

0：函数执行成功
0：错误代码

可用性

起始版本：8.1
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

capl 复制代码

on key '1'  
{  
  // 手动启动 IL  
  SomeIpILControlStart();  
  // 在此处添加应用端点和提供的服务  
}

SomeIpILControlStop

函数
语法
long SomeIpILControlStop();

功能

停止 SOME/IP IL，禁用 SOME/IP 消息的收发及服务发现。应用端点和提供的服务将被关闭。

可通过 SomeIpILControlStart 函数重新启动 SOME/IP IL。

参数

无

返回值

0：函数执行成功
0：错误代码

可用性

起始版本：8.1
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

capl 复制代码

on key '2'  
{  
  // 手动停止 IL  
  SomeIpILControlStop();  
}

SomeIpILControlWait

函数
语法
long SomeIpILControlWait();

功能

停止周期性消息发送，但不删除应用端点和提供的服务，服务发现继续运行。SOME/IP IL 仍可接收消息并进行评估。

通过 SomeIpILControlResume 函数可恢复周期性消息发送。

参数

无

返回值

0：函数执行成功
0：错误代码

可用性

起始版本：8.1
限制：Ethernet
测量设置：不支持
仿真/测试设置：支持

示例

capl 复制代码

on key 'w'  
{  
  // 停止消息发送  
  SomeIpILControlWait();  
}