中山网站外包上海公布最新情况

CANoe CAPL——CAN CAPL函数

事件过程（Event Procedures）

函数名	简要描述
on ethernetErrorPacket	收到错误的以太网数据包时调用。
on ethernetMacsecStatus	当物理端口的以太网 MACsec 连接状态变化时调用。
on ethernetPacket	接收到以太网数据包后调用。
on ethernetPacketForwarded	网络接口转发以太网数据包后调用。
on ethernetPhyState	PHY 状态变化或触发相关活动时调用。
on ethernetStatus	以太网link状态发生变化时调用。
on serviceSignal	接收的Service Signal 值发生变化时调用。
on serviceSignal_update	接收到 Service Signal 时调用。

---

通用函数（General Functions）

函数名	简要描述
GetServiceSignal	读取 Service Signal 的值。
GetServiceSignalData	读取 Service Signal 的数据。
GetServiceSignalString	读取 Service Signal 的字符串内容。
SetServiceSignal	设置 Service Signal 的值。
SetServiceSignalData	设置 Service Signal 的数据。
SetServiceSignalString	设置 Service Signal 的字符串内容。
ethClearMacAddressTable	清除网络接口的 MAC 地址表。
ethGetLinkStatus	获取通道的link状态。
ethSetLinkStatus	配置Vector硬件通道建立或断开link。
ethGetMacAddressAsNumber	将 MAC 地址从字符串转换为数字。
ethGetMacAddressAsString	将 MAC 地址转换为字符串。
ethGetPhyState	获取 PHY 状态。
ethSetPhyState	设置 PHY 状态。
ethResetStatistics	重置 Eth 对象的统计值。
output	发送以太网数据包。

网络相关函数（Network-based）

函数名	简要描述
ethGetEthernetPort	获取当前仿真节点使用的以太网端口。
ethGetEthernetPortInfos	获取所有连接nethwork-based的以太网设备的端口信息。
ethInjectPacket	通过指定以太网端口发送数据包。
lookupEthernetPort	根据限定字符串获取以太网端口。
ethDisableStatisticsOfAllNetworks	禁用或启用所有以太网网络端口的RT统计值处理。
ethDisableStatisticsOfNetwork	禁用或启用对所传端口所在的以太网网络中所有端口的RT统计值处理。
ethDisableStatisticsOfPort	禁用或启用指定端口的RT统计值处理。
ethGetLinkSpeed	获取端口的link速率。
ethGetRxBitRate	获取端口的RX比特率。
ethGetRxBytesTotalCount	获取端口接收的总字节数。
ethGetRxErrorPacketsTotalCount	获取端口接收的错误包数量。
ethGetRxPacketRate	获取端口的RX包速率。
ethGetRxPacketsTotalCount	获取端口接收的总数据包数量。
ethGetSQI	获取端口的SQI（信号质量指标）。
ethGetTxBitRate	获取端口的TX比特率。
ethGetTxBytesTotalCount	获取端口发送的总字节数。
ethGetTxErrorPacketsTotalCount	获取端口发送的错误包数量。
ethGetTxPacketRate	获取端口的TX包速率。
ethGetTxPacketsTotalCount	获取端口发送的总数据包数量。
ethResetStatisticsOfAllNetworks	重置所有Ethernet网络端口的RT统计值。
ethResetStatisticsOfNetwork	重置所传端口所在的以太网网络中所有端口的RT统计值。
ethResetStatisticsOfPort	重置指定端口的RT统计值。

---

Methods

函数名	简要描述
ethernetPacket::Clear	清除数据并重置长度
ethernetPacket::CompletePacket	计算数据包中所有协议的校验和和长度字段
ethernetPacket::FaultInjectDisableLengthPadding	发送小于最小允许长度的以太网包
ethernetPacket::FaultInjectFCS	发送具有无效帧校验和的以太网包
ethernetPacket::GetData	将ethernetPacket的数据复制到byte数组、char数组、CAPL 结构体或系统变量结构体中
ethernetPacket::GetBitLength	返回指定字段的位数（以 dword 表示）
ethernetPacket::GetInt	返回指定字段的值（以int表示）
ethernetPacket::GetInt64	返回指定字段的值（以int64表示）
ethernetPacket::IsAvailable	检查以太网包中是否存在指定协议及其字段
ethernetPacket::GetDestinationIPAddress	返回目标 IP 地址（类型为 IP_Address）
ethernetPacket::GetDestinationIPEndpoint	返回目标 IP 地址及 UDP/TCP 端口（类型为 IP_Endpoint）
ethernetPacket::GetPDU	获取该数据包中索引为 n 的 PDU
ethernetPacket::GetProtocolErrorText	获取无效以太网包的错误信息到buffer中
ethernetPacket::GetSourceIPAddress	返回源 IP 地址（类型为 IP_Address）
ethernetPacket::GetSourceEndpoint	返回源 IP 地址和 UDP/TCP 端口（类型为 IP_Endpoint）
ethernetPacket::GetVlan	返回 VLAN 标签
ethernetPacket::GetVlanId	返回 VLAN ID
ethernetPacket::GetVlanPriority	返回 VLAN 优先级
ethernetPacket::HasProtocolError	检查协议错误
ethernetPacket::HasVlan	返回 VLAN 标签数量
ethernetPacket::PDUCount	返回该消息中所有 PDU 的数量
ethernetPacket::PDUOffset	返回 PDU 起始位置的字节偏移量
ethernetPacket::protocol::field::GetData	获取以太网包中协议字段的数据
ethernetPacket::protocol::field::IsAvailable	判断以太网包中是否存在指定协议字段
ethernetPacket::protocol::field::ParseAddress	设置协议字段的 IPv4 或 IPv6 地址
ethernetPacket::protocol::field::SetData	设置以太网包中协议字段的payload数据
ethernetPacket::protocol::GetData	获取以太网包中指定协议的payload数据
ethernetPacket::protocol::Init	初始化以太网包中的协议
ethernetPacket::protocol::IsAvailable	判断以太网包中是否包含指定协议，如果包含returns 1
ethernetPacket::protocol::optional-structure::Clear	移除以太网包中的协议可选项
ethernetPacket::protocol::optional-structure::Init	在以太网包中为指定协议添加可选项
ethernetPacket::protocol::ResizeData	调整以太网包中协议payload数据的大小
ethernetPacket::protocol::SetData	设置以太网包中协议的payload数据
ethernetPacket::RemoveVlan	从以太网包中移除 VLAN 标签
ethernetPacket::SetData	从byte数组、char数组、CAPL 结构体或系统变量结构体中复制bytes写入以太网包的data部分
ethernetPacket::SetDestinationIPAddress	设置目标 IP 地址
ethernetPacket::SetDestinationIPEndpoint	设置目标 IP 地址和 UDP/TCP 端口
ethernetPacket::SetSourceIPAddress	设置源 IP 地址
ethernetPacket::SetSourceIPEndpoint	设置源 IP 地址和 UDP/TCP 端口
ethernetPacket::SetVlan	设置ethernetPacket的 VLAN 标签
ethernetPacket::SetVlanId	设置ethernetPacket的 VLAN ID
ethernetPacket::SetVlanPriority	设置ethernetPacket的 VLAN 优先级
ethernetPacket::source::ParseAddress	设置源或目标 MAC 地址
IP_Address::IsIPv4Address	检查当前地址是否为 IPv4 地址
IP_Address::IsIPv6Address	检查当前地址是否为 IPv6 地址
IP_Address::IsBroadcast	检查当前地址是否为广播地址
IP_Address::IsMulticast	检查当前地址是否为组播地址
IP_Address::GetAddressAsArray	将当前 IP 地址复制为字节数组
IP_Address::MatchesAddress	比较两个 IP 地址
IP_Address::ParseAddressFromString	将字符串转换为 IPv4 或 IPv6 地址
IP_Address::PrintAddressToString	将IP 地址转换为字符串
IP_Address::SetAddressAsArray	将字节数组设置为 IP 地址
IP_Endpoint::IsTCP	检查当前endpoint的传输协议是否为 TCP
IP_Endpoint::IsUDP	检查当前endpoint的传输协议是否为 UDP
IP_Endpoint::MatchesEndpoint	比较两个endpoints
IP_Endpoint::ParseEndpointFromString	将字符串转换为endpoint
IP_Endpoint::PrintEndpointToString	将endpoint转换为字符串
IP_Endpoint::SetToTCP	将传输协议设置为 TCP
IP_Endpoint::SetToUDP	将传输协议设置为 UDP
IP_Endpoint::SetTransportProtocolToUnknown	使传输协议无效

---

对象（Objects）

函数名	简要描述
ethernetErrorPacket	该对象用于访问 on ethernetErrorPacket 中的信息
ethernetPacket	创建一个以太网数据包对象
Eth	该对象用于访问以太网链路状态和统计信息
IP_Address	IPv4 和 IPv6 地址的变量类型
IP_Endpoint	IP endpoint的变量类型
ethernetPort	用于端口资格验证的基本类型

---

压力生成器（Stress Generator）

函数名	简要描述
ethStartPacketGenerator	启动以太网压力生成器
ethStopPacketGenerator	停止以太网压力生成器