实用指南：CAPL学习-SOME/IP交互层-TCP处理类函数

TCP Handling

SomeIpCloseEstablishedTCPConnection

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

函数功能

关闭一个或多个数据库中定义的 TCP 连接。

语法

dword SomeIpCloseEstablishedTCPConnection();                  // 形式 1
dword SomeIpCloseEstablishedTCPConnection(dword aepHandle);   // 形式 2
dword SomeIpCloseEstablishedTCPConnection(dword aepHandle, dword remoteIPv4Address);  // 形式 3
dword SomeIpCloseEstablishedTCPConnection(dword aepHandle, dword remoteIPv4Address, dword remotePort);  // 形式 4
dword SomeIpCloseEstablishedTCPConnection(dword aepHandle, byte remoteIPv6Address[]);  // 形式 5
long SomeIpCloseEstablishedTCPConnection(dword aepHandle, byte remoteIPv6Address[], dword remotePort);  // 形式 6
long SomeIpCloseEstablishedTCPConnection(dword aepHandle, IP_Endpoint remoteIPEndpoint);  // 形式 7

形式说明

• 形式 1：关闭本节点（作为 TCP 客户端）的所有 TCP 连接。
• 形式 2：关闭 TCP 客户端的所有 TCP 连接。
• 形式 3/5：关闭 TCP 客户端与特定 TCP 服务器的所有 TCP 连接。
• 形式 4/6：关闭 TCP 客户端与特定 TCP 服务器的 TCP 连接。

TCP 连接可通过 SomeIpEstablishTCPConnection 函数建立。

参数说明

• aepHandle：发起连接的源应用端点，必须在数据库中定义。
• remotePort：可发送和接收消息的端口。
• remoteIPv4Address：需关闭连接的 IPv4 地址，可通过 IPGetAddressAsNumber 函数转换。
• remoteIPv6Address：需关闭连接的 IPv6 地址，可通过 IpGetAddressAsArray 函数转换。
• remoteIPEndpoint：IP_Endpoint 类型对象，包含远程端点的地址和端口。

返回值

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

可用性

版本	支持形式	限制范围	测量配置	仿真/测试配置
11.0 SP3	形式 1-6	以太网	—	•
12.0 SP2	形式 7	以太网	—	•

示例

variables
{
  dword aep;  // 应用端点句柄
}
on start
{
  // 句柄需关联数据库中有效的应用端点
  aep = SomeIpOpenLocalApplicationEndpoint(IP_Endpoint(TCP:192.168.1.1:40000));
}
on key 'o'
{
  // 建立到特定端点的连接
  if (SomeIpEstablishTCPConnection(aep, IP_Endpoint(TCP:192.168.1.2:50000)) != 0)
  {
    write("连接未建立");
  }
}
on key 'c'
{
  // 关闭节点上下文中的所有连接
  if (SomeIpCloseEstablishedTCPConnection() == 0)
  {
    write("连接已关闭");
  }
}

SomeIpEstablishTCPConnection

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

函数功能

建立一个或多个数据库中定义的 TCP 连接。

语法

dword SomeIpEstablishTCPConnection();                  // 形式 1
dword SomeIpEstablishTCPConnection(dword aepHandle);   // 形式 2
dword SomeIpEstablishTCPConnection(dword aepHandle, dword remoteIPv4Address);  // 形式 3
dword SomeIpEstablishTCPConnection(dword aepHandle, dword remoteIPv4Address, dword remotePort);  // 形式 4
dword SomeIpEstablishTCPConnection(dword aepHandle, byte remoteIPv6Address[]);  // 形式 5
long SomeIpEstablishTCPConnection(dword aepHandle, byte remoteIPv6Address[], dword remotePort);  // 形式 6
long SomeIpEstablishTCPConnection(dword aepHandle, IP_Endpoint remoteIPEndpoint);  // 形式 7

形式说明

• 形式 1：建立本节点（作为 TCP 客户端）的所有 TCP 连接。
• 形式 2：建立 TCP 客户端的所有 TCP 连接。
• 形式 3/5：建立 TCP 客户端与特定 TCP 服务器的所有 TCP 连接。
• 形式 4/6：建立 TCP 客户端与特定 TCP 服务器的 TCP 连接。

TCP 连接可通过 SomeIpCloseEstablishedTCPConnection 函数关闭。

参数说明

• aepHandle：发起连接的源应用端点，必须在数据库中定义。
• remotePort：可发送和接收消息的端口。
• remoteIPv4Address：需建立连接的 IPv4 地址，可通过 IPGetAddressAsNumber 函数转换。
• remoteIPv6Address：需建立连接的 IPv6 地址，可通过 IpGetAddressAsArray 函数转换。
• remoteIPEndpoint：IP_Endpoint 类型对象，包含远程端点的地址和端口。

返回值

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

可用性

版本	支持形式	限制范围	测量配置	仿真/测试配置
11.0 SP3	形式 1-6	以太网	—	•
12.0 SP2	形式 7	以太网	—	•

示例

variables
{
  dword aep;  // 应用端点句柄
}
on start
{
  // 句柄需关联数据库中有效的应用端点
  aep = SomeIpOpenLocalApplicationEndpoint(IP_Endpoint(TCP:192.168.1.1:40000));
}
on key 'o'
{
  // 建立到特定端点的连接
  if (SomeIpEstablishTCPConnection(aep, IP_Endpoint(TCP:192.168.1.2:50000)) != 0)
  {
    write("连接未建立");
  }
}
on key 'c'
{
  // 关闭节点上下文中的所有连接
  if (SomeIpCloseEstablishedTCPConnection() == 0)
  {
    write("连接已关闭");
  }
}

SomeIpTCPListen

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

函数功能

监听此 TCP 应用端点。

语法

long SomeIpTCPListen(dword aepHandle)

参数说明

• aepHandle：应用端点。

返回值

• 0：函数执行成功。

可用性

版本	限制范围	测量配置	仿真/测试配置
11.0 SP3	以太网	—	•

示例

—