CAPL学习-ETH功能函数-方法类2

车载测试工程师2025-12-06 8:47

1. ethernetPacket::HasProtocolError

方法
语法

capl 复制代码 
word ethernetPacket.HasProtocolError();

功能

若以太网报文的IP协议包含协议错误（如校验和错误、长度字段错误等），返回1。可使用ethernetPacket::GetProtocolErrorText获取错误描述。

参数

无

返回值

  • 0：未检测到协议错误
  • 1：检测到协议错误

可用性

  • 版本：11.0 SP3
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

capl 复制代码 
on ethernetPacket *  
{  
  if (this.hasProtocolError())  
  {  
    char text[100];  
    this.GetProtocolErrorText(text);  
    write("Protocol error on Eth %d: %s", this.msgChannel, text);  
  }  
}

2. ethernetPacket::HasVlan

方法
语法

capl 复制代码 
long ethernetPacket.HasVlan(); // 形式1

功能

返回VLAN标签的数量。

参数

无

返回值

VLAN标签的数量。

可用性

  • 版本：10.0
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

capl 复制代码 
on ethernetPacket *  
{  
  if (this.hasVlan())  
  {  
    word vlanId;  
    vlanId = this.GetVlanId();  
    write("Received Ethernet packet with VLAN ID %d", vlanId);  
  }  
}

3. ethernetPacket::PDUCount

方法
语法

capl 复制代码 
long ethernetPacket.PDUCount();

功能

返回报文包含的所有PDU（协议数据单元）数量。

参数

无

返回值

  • ≥0：报文的PDU数量
  • -1：总线类型错误
  • -2：帧不支持访问PDU
  • -3：PDU对象无效
  • -4：PDU非接收类型
  • -5：参数过小（如数组字节数不足）
  • -6：报文或PDU不可用
  • -7：PDU索引越界（使用PDUCount()确定数量）

可用性

  • 版本：9.0
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

无

4. ethernetPacket::PDUOffset

方法
语法

capl 复制代码 
long ethernetPacket.PDUOffset(long n);

功能

返回索引为n的PDU在报文数据载荷中的起始字节偏移量。

参数

  • n：请求的PDU索引。第一个PDU索引为0，最后一个为PDUCount()-1

返回值

  • ≥0：请求PDU的偏移量
  • -1：总线类型错误
  • -2：帧不支持访问PDU
  • -3：PDU对象无效
  • -4：PDU非接收类型
  • -5：参数过小（如数组字节数不足）
  • -6：报文或PDU不可用
  • -7：PDU索引越界（使用PDUCount()确定数量）

可用性

  • 版本：9.0
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

无

5. ethernetPacket::protocol::field::GetData

方法
语法

capl 复制代码 
word ethernetPacket.<protocol>.<field>.GetData(word offset, char[] dest, word length);  
word ethernetPacket.<protocol>.<field>.GetData(word offset, byte[] dest, word length);  
word ethernetPacket.<protocol>.<field>.GetData(word offset, struct *dest);  
word ethernetPacket.<protocol>.<field>.GetData(word offset, sysvarStruct dest);

功能

获取以太网报文中协议字段的数据，并复制到指定类型的目标缓冲区。若缓冲区过小，数据将被截断；若指定长度大于可用数据，仅复制可用数据并返回字节数。若<protocol>.<field>不可用，返回0。仅适用于非整数类型的协议字段。

参数

  • dest：目标缓冲区（数据复制到此处）
  • length：复制的字节数
  • offset：载荷中开始复制数据的字节偏移量

返回值

复制到目标缓冲区的字节数。

可用性

  • 版本：11.0 SP3
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

capl 复制代码 
on ethernetPacket *  
{  
  if (this.ipv6.IsAvailable())  
  {  
    byte ipv6AddrData[16];  
    long ipv6AddrDataLength;  
    char ipv6AddrStr[40];  
    ipv6AddrDataLength = this.ipv6.source.GetData(0, ipv6AddrData, elcount(ipv6AddrData));  
    if (ipv6AddrDataLength == 16)  
    {  
      ipGetAddressAsString(ipv6AddrData, ipv6AddrStr, elcount(ipv6AddrStr));  
      writeLineEx(kWritSink, 0, "Received IPv6 packet from %s", ipv6AddrStr);  
    }  
  }  
}

6. ethernetPacket::protocol::field::IsAvailable

方法
语法

capl 复制代码 
long ethernetPacket.<protocol>.<field>.IsAvailable();

功能

判断以太网报文中的协议字段是否可用（适用于含可选字段或选项的协议）。

参数

无

返回值

  • 1：协议字段可用
  • 0：协议字段不可用

可用性

  • 版本：11.0 SP3
  • 适用对象：Ethernet
  • 支持场景：测量设置 ✓，仿真/测试设置 ✓

示例

capl 复制代码 
on ethernetPacket *  
{  
  if (this.udp.checksum.IsAvailable())  
  {  
    Write("Protocol field udp.checksum is available and has value 0x%X", this.udp.checksum);  
  }  
}

7. ethernetPacket::protocol::field::ParseAddress

方法
语法
long ethernetPacket.<protocol>.<field>.ParseAddress( char addressAsString[] );

功能

设置协议字段（IPv4或IPv6地址类型）。地址必须按以下格式提供：

  • IPv4地址：IPv4格式（如192.168.1.1）
  • IPv6地址：IPv6格式（如FC00::0001:0002）
    仅适用于IPv4或IPv6地址字段。

参数
addressAsString：IPv4或IPv6格式的文本地址。

返回值

  • 0：成功
  • -1：错误
  • -2：字段或协议不在数据包中
  • -4：地址格式无效

可用性

  • 版本：11.0 SP3
  • 适用场景：测量设置、仿真/测试设置

示例1

capl 复制代码 
ethernetPacket pkt;
pkt.udp.Init();
pkt.ipv4.source.ParseAddress("192.168.1.1");
pkt.ipv4.destination.ParseAddress("255.255.255.255");

示例2

capl 复制代码 
ethernetPacket pkt;
pkt.ipv6.Init();
pkt.udp.Init();
pkt.ipv6.source.ParseAddress("FC01::1");
pkt.ipv6.destination.ParseAddress("FF00::1");

8. ethernetPacket::protocol::field::SetData

方法
语法

capl 复制代码 
word ethernetPacket.<protocol>.<field>.SetData( word offset, char[] data, word length );
word ethernetPacket.<protocol>.<field>.SetData( word offset, byte[] data, word length );
word ethernetPacket.<protocol>.<field>.SetData( word offset, struct * data );
word ethernetPacket.<protocol>.<field>.SetData( word offset, sysvarStruct data );

功能

设置以太网数据包中协议的 payload 数据。协议字段长度不变，若源数据大于字段长度则截断。若协议或字段不存在，返回0且不设置数据。

参数

  • data：源数据缓冲区
  • length：复制到协议字段的字节数
  • offset：协议字段数据中开始复制的字节偏移量

返回值

复制到以太网数据包的字节数。

可用性

  • 版本：11.0 SP3
  • 适用场景：测量设置、仿真/测试设置

示例

capl 复制代码 
ethernetPacket pkt;
byte ipv6AddrData[16];
// 初始化IPv6和UDP协议
pkt.ipv6.Init();
pkt.udp.Init();
// 设置IPv6地址
ipGetAddressAsArray("FC00::01", ipv6AddrData);
pkt.ipv6.source.SetData(0, ipv6AddrData, elcount(ipv6AddrData));
ipGetAddressAsArray("FC00::02", ipv6AddrData);
pkt.ipv6.destination.SetData(0, ipv6AddrData, elcount(ipv6AddrData));
// 设置UDP端口
pkt.udp.source = 40001;
pkt.udp.destination = 40002;
// 设置UDP payload
pkt.udp.SetData(0, "Hello", 5);
// 计算校验和并发送
pkt.CompletePacket();
output(pkt);

9. ethernetPacket::protocol::GetData

方法
语法

capl 复制代码 
word ethernetPacket.<protocol>.GetData( word offset, char[] dest, word length );
word ethernetPacket.<protocol>.GetData( word offset, byte[] dest, word length );
word ethernetPacket.<protocol>.GetData( word offset, struct * dest );
word ethernetPacket.<protocol>.GetData( word offset, sysvarStruct dest );

功能

获取以太网数据包中协议的 payload 数据，复制到目标缓冲区。若缓冲区过小则截断，若长度超过可用数据则仅复制可用部分。若协议不存在，返回0。

参数

  • dest：目标数据缓冲区
  • length：复制的字节数
  • offset：payload 中开始复制的字节偏移量

返回值

复制到目标缓冲区的字节数。

可用性

  • 版本：11.0 SP3
  • 适用场景：测量设置、仿真/测试设置

示例

capl 复制代码 
on ethernetPacket *
{
  _align(1) struct MyData { long value1; long value2; } buffer;
  if ((this.udp.IsAvailable()) && (this.udp.destination == 0xF123))
  {
    if (this.GetData(0, buffer, bufferLength) > 0)
    {
      write("Value1=%d, Value2=%d", buffer.value1, buffer.value2);
    }
  }
}

10. ethernetPacket::protocol::Init

方法
语法
long ethernetPacket.<protocol>.Init();

功能

初始化以太网数据包中的协议。若协议未包含在数据包中，则追加并初始化为默认值。若协议依赖底层协议（如UDP默认依赖IPv4），会自动添加底层协议。如需特定协议栈（如UDP over IPv6），需从低层到高层依次初始化（先IPv6，再UDP）。初始化后，高层协议将被移除。

返回值

  • 0：成功
  • -1：错误

可用性

  • 版本：11.0 SP3
  • 适用场景：测量设置、仿真/测试设置

示例1（IPv4 + UDP）

capl 复制代码 
ethernetPacket pkt;
pkt.udp.Init(); // 自动添加IPv4
pkt.ipv4.source.ParseAddress("192.168.1.1");
pkt.ipv4.destination.ParseAddress("192.168.1.255");
pkt.udp.source = 40001;
pkt.udp.destination = 40002;
pkt.udp.SetData(0, "Hello", 5);
pkt.CompletePacket();
output(pkt);

示例2（IPv6 + UDP）

capl 复制代码 
ethernetPacket pkt;
pkt.ipv6.Init(); // 先初始化IPv6
pkt.udp.Init();  // 再初始化UDP
pkt.ipv6.source.ParseAddress("FC00::01");
pkt.ipv6.destination.ParseAddress("FC00::02");
pkt.udp.source = 40001;
pkt.udp.destination = 40002;
pkt.udp.SetData(0, "Hello", 5);
pkt.CompletePacket();
output(pkt);
相关推荐
优化Henry20 分钟前
LTE-TDD小区光路闪断故障处理典型案例
运维·网络·5g·信息与通信
成都易yisdong22 分钟前
实现三北方向转换计算器（集成 WMM2025 地磁模型）
开发语言·windows·算法·c#·visual studio
杨凯凡41 分钟前
【006】常见 WebSocket 场景与后端 session/鉴权的关系
网络·websocket·网络协议
red_redemption1 小时前
自由学习记录（165）
学习
CDN3601 小时前
高防切换后网站打不开？DNS 解析与回源路径故障排查
前端·网络·数据库
西西弟1 小时前
网络编程基础之TCP循环服务器
运维·服务器·网络·网络协议·tcp/ip
Oll Correct1 小时前
实验十六：路由环路问题
网络·笔记
@insist1231 小时前
网络工程师-虚拟专用网技术（一）：核心精讲
网络·网络工程师·软考·软件水平考试
没头脑的男大1 小时前
宇树的自己电脑的适配
linux·服务器·网络
guygg881 小时前
OPC UA Helper: 连接PLC获取变量值
服务器·网络·c#
热门推荐
012026年4月技术前沿：AI大模型爆发、智能体革命与量子安全新纪元02一周AI热点速览（2026.03.31-04.06）：GPT-6曝光、谷歌开源Gemma 4、资本狂飙与模型军备竞赛03GitHub 镜像站点04基于 Docker 部署 Hermes Agent 并接入飞书机器人的完整指南05GPT-6核心能力解析及与现有主流大模型对比06免费！不限量！用opencode接入英伟达（NVIDIA）大模型，轻松打造你的 AI 编程助手07从限购到畅通：GLM-5.1 Coding Plan接入攻略08AI Weekly | 2026年4月第二周 · GitHub热门项目与AI发展趋势深度解析09LLM Wiki：让大模型替你打理知识库的完整指南10Oh My Codex 快速使用指南