平顶山市网站建设_网站建设公司_PHP_seo优化
2026/1/17 12:38:50 网站建设 项目流程

实用指南:CAPL学习-SOME/IP交互层-值处理类函数1

Value Access

SomeIpGetDestinationAddress

函数
获取SOME/IP消息的目的IP地址。

语法

dword SomeIpGetDestinationAddress(dword messageHandle);  // 形式1(IPv4)
long SomeIpGetDestinationAddress(dword messageHandle, byte ipv6Address[]);  // 形式2(IPv6)

参数

  • messageHandle:接收的SOME/IP消息句柄(仅在OnSomeIpMessage回调函数中调用)。
  • ipv6Address:存储IPv6地址的字节数组(形式2专用)。

返回值

  • 形式1:IPv4目的地址(网络字节序);错误时返回0,可通过SomeIpGetLastError获取错误码。
  • 形式2:0表示成功,>0表示错误码(IPv6地址写入ipv6Address数组)。

说明

  • 可使用IpGetAddressAsString函数将数值型IP地址转换为字符串格式。

可用性

  • 形式1:CANoe 8.1及以上,支持以太网仿真/测试环境。
  • 形式2:CANoe 10.0 SP4及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD dstAddress = 0;LONG errorCode = 0;LONG errorOccured = 0;char buffer[100];// 获取IPv4目的地址if ((dstAddress = SomeIpGetDestinationAddress(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {IpGetAddressAsString(dstAddress, buffer, elcount(buffer));write("接收到SOME/IP消息,目的地址:%s", buffer);}
}

SomeIpGetDestinationPort

函数
获取SOME/IP消息的目的端口号(UDP/TCP)。

语法

dword SomeIpGetDestinationPort(dword messageHandle);

参数

  • messageHandle:接收的SOME/IP消息句柄(仅在OnSomeIpMessage回调函数中调用)。

返回值

  • 目的端口号;错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD dstPort = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((dstPort = SomeIpGetDestinationPort(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,目的端口:%d", dstPort);}
}

SomeIpGetInterfaceVersion

函数
获取SOME/IP消息头中的接口版本号。

语法

dword SomeIpGetInterfaceVersion(dword messageHandle);

参数

  • messageHandle:SOME/IP消息句柄。

返回值

  • 接口版本号;错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD interfaceVers = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((interfaceVers = SomeIpGetInterfaceVersion(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,接口版本:0x%02x(%d)", interfaceVers, interfaceVers);}
}

SomeIpGetLength

函数
获取SOME/IP消息头中的长度字段(字节数)。

语法

dword SomeIpGetLength(dword messageHandle);

参数

  • messageHandle:SOME/IP消息句柄。

返回值

  • 消息长度(不含消息ID和长度字段本身);错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

SomeIpGetMessageId

函数
获取SOME/IP消息头中的消息ID。

语法

dword SomeIpGetMessageId(dword messageHandle);

参数

  • messageHandle:SOME/IP消息句柄。

返回值

  • SOME/IP消息ID;错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD msgId = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((msgId = SomeIpGetMessageId(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,消息ID:0x%08x", msgId);}
}

SomeIpGetMessageType

函数
获取SOME/IP消息头中的消息类型。

语法

dword SomeIpGetMessageType(dword messageHandle);

参数

  • messageHandle:SOME/IP消息句柄。

返回值

  • 消息类型(十六进制):
    • 0x00:REQUEST(请求)
    • 0x01:REQUEST_NO_RETURN(无返回请求)
    • 0x02:NOTIFICATION(通知)
    • 0x40:REQUEST ACK(请求确认)
    • 0x41:REQUEST_NO_RETURN ACK(无返回请求确认)
    • 0x42:NOTIFICATION ACK(通知确认)
    • 0x80:RESPONSE(响应)
    • 0x81:ERROR(错误)
    • 0xC0:RESPONSE ACK(响应确认)
    • 0xC1:ERROR ACK(错误确认)
  • 错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD msgType = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((msgType = SomeIpGetMessageType(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,消息类型:0x%02x", msgType);}
}

SomeIpGetProtocol

函数
获取SOME/IP消息使用的传输协议(TCP/UDP)。

语法

dword SomeIpGetProtocol(dword messageHandle);

参数

  • messageHandle:接收的SOME/IP消息句柄(仅在OnSomeIpMessage回调函数中调用)。

返回值

  • 0:错误(通过SomeIpGetLastError获取错误码)
  • 6:TCP协议
  • 17:UDP协议

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD protocol = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((protocol = SomeIpGetProtocol(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,协议类型:0x%x(%d)", protocol, protocol);}
}

SomeIpGetProtocolVersion

函数
获取SOME/IP消息头中的协议版本号。

语法

dword SomeIpGetProtocolVersion(dword messageHandle);

参数

  • messageHandle:SOME/IP消息句柄。

返回值

  • 协议版本号;错误时返回0,可通过SomeIpGetLastError获取错误码。

可用性

  • CANoe 8.1及以上,支持以太网仿真/测试环境。

示例

void OnSomeIpMessage(DWORD messageHandle) {DWORD protVers = 0;LONG errorCode = 0;LONG errorOccured = 0;if ((protVers = SomeIpGetProtocolVersion(messageHandle)) == 0) {if ((errorCode = SomeIpGetLastError()) != 0) {write("SOME/IP IL错误:错误码:%d", errorCode);errorOccured = 1;}}if (errorOccured == 0) {write("接收到SOME/IP消息,协议版本:0x%02x(%d)", protVers, protVers);}
}

SomeIpGetRequestId

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetRequestId

函数

语法
dword SomeIpGetRequestId ( dword messageHandle );

功能
该函数返回 SOME/IP 消息头中的请求 ID(Request ID)。

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例

void OnSomeIpMessage( DWORD messageHandle )
{DWORD requestId = 0;LONG errorCode = 0;LONG errorOccured = 0;// 从 SOME/IP 消息中获取数据if((requestId = SomeIpGetRequestId(messageHandle)) == 0){// 检查上一个函数是否执行正确if((errorCode = SomeIpGetLastError()) != 0){write("SOME/IP IL 错误发生:错误代码:%d", errorCode);errorOccured = 1;} // if} // ifif(errorOccured == 0){write("接收到请求 ID 为 0x%08x 的 SOME/IP 消息", requestId);} // if
}

SomeIpGetReturnCode

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetReturnCode

函数

语法
dword SomeIpGetReturnCode ( dword messageHandle );

功能
该函数返回 SOME/IP 消息头中的返回码(Return Code)。

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例

void OnSomeIpMessage( DWORD messageHandle )
{DWORD retCode = 0;LONG errorCode = 0;LONG errorOccured = 0;// 从 SOME/IP 消息中获取数据if((retCode = SomeIpGetReturnCode(messageHandle)) == 0){// 检查上一个函数是否执行正确if((errorCode = SomeIpGetLastError()) != 0){write("SOME/IP IL 错误发生:错误代码:%d", errorCode);errorOccured = 1;} // if} // ifif(errorOccured == 0){write("接收到返回码为 0x%02x 的 SOME/IP 消息", retCode);} // if
}

SomeIpGetSourceAddress

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetSourceAddress

函数

语法

功能

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网(形式 1)
10.0 SP4以太网(形式 2)

示例

void OnSomeIpMessage( DWORD messageHandle )
{DWORD srcAddress = 0;LONG errorCode = 0;LONG errorOccured = 0;char buffer[100];// 从 SOME/IP 消息中获取数据if((srcAddress = SomeIpGetSourceAddress(messageHandle)) == 0){// 检查上一个函数是否执行正确if((errorCode = SomeIpGetLastError()) != 0){write("SOME/IP IL 错误发生:错误代码:%d", errorCode);errorOccured = 1;} // if} // ifif(errorOccured == 0){IpGetAddressAsString(srcAddress, buffer, elcount(buffer));write("接收到来自源地址 %s 的 SOME/IP 消息", buffer);} // if
}

SomeIpGetSourcePort

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetSourcePort

函数

语法
dword SomeIpGetSourcePort ( dword messageHandle );

功能
该函数返回源端口(UDP/TCP)。

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例

void OnSomeIpMessage( DWORD messageHandle )
{DWORD srcPort = 0;LONG errorCode = 0;LONG errorOccured = 0;// 从 SOME/IP 消息中获取数据if((srcPort = SomeIpGetSourcePort(messageHandle)) == 0){// 检查上一个函数是否执行正确if((errorCode = SomeIpGetLastError()) != 0){write("SOME/IP IL 错误发生:错误代码:%d", errorCode);errorOccured = 1;} // if} // ifif(errorOccured == 0){write("接收到来自源端口 %d 的 SOME/IP 消息", srcPort);} // if
}

SomeIpGetValueDWord

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetValueDWord

函数

语法
dword SomeIpGetValueDWord( dword objectHandle, char valuePath[] );

功能
该函数用于从 objectHandle 参数指定的对象中读取原始值,通过符号访问路径访问该值。

注意:指定访问路径时必须遵循相应语法。访问路径由待读取值的数据库描述生成(另见《基于数据库的访问路径语法》)。
该函数也可读取服务发现(Service Discovery)消息的内容,此时通过预定义访问路径访问值(另见《预定义 SD 访问路径语法》)。

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例

variables
{DWORD gPm; // 提供的方法句柄
}
void Initialize()
{DWORD aep; // 应用端点句柄DWORD psi; // 提供的服务实例句柄// 打开应用端点aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);// 创建服务实例psi = SomeIpCreateProvidedServiceInstance(aep, 11, 1);// 创建方法gPm = SomeIpAddMethod(psi, 31, "OnMethodRequest");
}
void OnMethodRequest(dword methodHandle, dword messageHandle, dword messageResponseHandle)
{WORD val1; // 输入参数 1 的值WORD val2; // 输入参数 2 的值DWORD res; // 返回参数的值// 从请求中获取值val1 = (WORD)SomeIpGetValueDWord(messageHandle, "Member_value1");val2 = (WORD)SomeIpGetValueDWord(messageHandle, "Member_value2");// 计算结果res = val1 + val2;// 设置响应值SomeIpSetValueDWord(messageResponseHandle, "Result", (val1 + val2));
}

SomeIpGetValueFloat

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetValueFloat

函数

语法
float SomeIpGetValueFloat( dword objectHandle, char valuePath[] );

功能
该函数用于从 objectHandle 参数指定的对象中读取原始浮点值,通过符号访问路径访问该值。

注意:指定访问路径时必须遵循相应语法。访问路径由待读取值的数据库描述生成(另见《基于数据库的访问路径语法》)。
该函数也可读取服务发现消息的内容,此时通过预定义访问路径访问值(另见《预定义 SD 访问路径语法》)。

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例
参见 SomeIpGetValueDWord

SomeIpGetValueInt64

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetValueInt64

函数

语法
int64 SomeIpGetValueInt64( dword objectHandle, char valuePath[] );

功能
该函数用于从 objectHandle 参数指定的对象中读取原始 64 位整数值,通过符号访问路径访问该值。

注意:访问路径语法及支持对象同 SomeIpGetValueDWord

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例
参见 SomeIpGetValueDWord

SomeIpGetValueLong

CAPL 函数 » 以太网 » SOME/IP IL » SomeIpGetValueLong

函数

语法
long SomeIpGetValueLong( dword objectHandle, char valuePath[] );

功能
该函数用于从 objectHandle 参数指定的对象中读取原始长整数值,通过符号访问路径访问该值。

注意:访问路径语法及支持对象同 SomeIpGetValueDWord

参数

返回值

可用性

版本适用范围测量设置仿真/测试设置
8.1以太网

示例
参见 SomeIpGetValueDWord

SomeIpGetValuePhys

函数
语法
float SomeIpGetValuePhys( dword objectHandle, char valuePath[] );

功能
该函数用于从 objectHandle 参数指定的对象中读取物理值。数据类型和转换公式等必要信息必须存储在 FIBEX 数据库中。

注意

  • 若数据库中未存储转换公式,将隐式应用恒等转换(系数为 1,偏移量为 0)。
  • 对于大数值,实数转换为整数可能导致偏差。

参数

  • objectHandle:SOME/IP IL 对象句柄,支持消息、字段、方法调用(通过 SomeIpCreateMethodCall 创建)。
  • valuePath:待读取值的路径,复杂路径需遵循数据库访问路径语法。

返回值
物理值;若出错则返回 0,可通过 SomeIpGetLastError 检查错误。

可用性
自版本 8.2 起支持,仅限 Ethernet 仿真/测试环境。

示例
假设 FIBEX 数据库中包含方法 ID 31 的方法,含两个输入参数 Member_value1Member_value2 和返回参数 Result,前两者在数据库中设置了系数和偏移量。

variables
{DWORD gPm; // 提供的方法句柄
}
void Initialize()
{DWORD aep; // 应用端点句柄DWORD psi; // 提供的服务实例句柄// 打开应用端点aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);// 创建服务实例psi = SomeIpCreateProvidedServiceInstance(aep, 11, 1);// 创建方法gPm = SomeIpAddMethod(psi, 31, "OnMethodRequest");
}
void OnMethodRequest(dword methodHandle, dword messageHandle, dword messageResponseHandle)
{WORD val1; // 输入参数 1 的值WORD val2; // 输入参数 2 的值DWORD res; // 返回参数的值// 从请求中获取值val1 = (WORD)SomeIpGetValuePhys(messageHandle, "Member_value1");val2 = (WORD)SomeIpGetValuePhys(messageHandle, "Member_value2");// 计算结果res = val1 + val2;// 设置响应值SomeIpSetValueDWord(messageResponseHandle, "Result", res);
}

SomeIpGetValueQWord

函数
语法
qword SomeIpGetValueQWord( dword objectHandle, char valuePath[] );

功能
通过符号访问路径从 objectHandle 指定的对象中读取原始值。

注意

  • 访问路径需遵循数据库描述的语法(见数据库访问路径语法)。
  • 支持读取服务发现(SD)消息内容,需使用预定义 SD 访问路径。

参数

  • objectHandle:SOME/IP IL 对象句柄(需在 FIBEX 数据库中完整描述),支持消息、字段、方法调用。
  • valuePath:待读取值的访问路径。

返回值
原始值;若出错则返回 0,可通过 SomeIpGetLastError 检查错误。

可用性
自版本 8.1 起支持,仅限 Ethernet 仿真/测试环境。

示例:参见 SomeIpGetValueDWord

版本:14 SP2
© Vector Informatik GmbH

SomeIpGetValueString

函数
语法
dword SomeIpGetValueString( dword objectHandle, char valuePath[], dword bufferLength, char buffer[] );

功能
objectHandle 指定的对象中读取字符串;对于枚举类型,返回符号值。

注意

  • 目前仅支持基本类型 A_ASCIISTRING
  • 访问路径需遵循数据库描述语法,支持通过预定义 SD 路径读取服务发现消息内容。

参数

  • objectHandle:SOME/IP IL 对象句柄(需在 FIBEX 数据库中完整描述),支持消息、字段、方法调用。
  • valuePath:待读取值的路径。
  • bufferLength:缓冲区字节长度;若缓冲区过小,仅复制能容纳的字符(含空终止符)。
  • buffer:输出参数,存放空终止字符串。

返回值
复制的字节数;若出错则返回 0,可通过 SomeIpGetLastError 查询错误码。

可用性
自版本 8.1 起支持,仅限 Ethernet 仿真/测试环境。

示例

variables
{DWORD gPm; // 提供的方法句柄
}
void Initialize()
{DWORD aep; // 应用端点句柄DWORD psi; // 提供的服务实例句柄// 打开应用端点aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);// 创建服务实例psi = SomeIpCreateProvidedServiceInstance(aep, 11, 1);// 创建方法gPm = SomeIpAddMethod(psi, 31, "OnMethodRequest");
}
void OnMethodRequest(dword methodHandle, dword messageHandle, dword messageResponseHandle)
{CHAR Member_value1[256]; // 输入参数 1 的值WORD val2; // 输入参数 2 的值// 从请求中获取字符串值SomeIpGetValueString(messageHandle, "Member_value1", elcount(Member_value1), Member_value1);val2 = (WORD)SomeIpGetValueDWord(messageHandle, "Member_value2");// 业务逻辑处理
}

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询