Skip to main content
Open topic with navigation CAPL Functions » Ethernet » Function Overview » ethernetPacket::protocol::field::SetData

​
ethernetPacket::protocol::field::SetData

Valid for: CANoe DE • CANoe4SW DE

​
Method Syntax

  • word ethernetPacket.<protocol>.<field>.SetData( word offset, char[]data, word length ); // from 1
  • word ethernetPacket.<protocol>.<field>.SetData( word offset, byte[]data, word length ); // form 2
  • word ethernetPacket.<protocol>.<field>.SetData( word offset, struct * data); // from 3
  • word ethernetPacket.<protocol>.<field>.SetData( word offset, sysvarStruct data); // from 4

​
Description

Sets payload data of a protocol within an Ethernet packet. The length of the protocol field is not changed. If the source data is larger than the protocol field, the data is truncated. If <protocol> or <field> is not available in the packet, no data is set and 0 is returned.

​
Parameters

  • data: buffer where the data is copied from.
  • length: Number of bytes to copy to the protocol field data.
  • offset: Byte offset in the protocol field data where it starts to copy data.

​
Return Values

Number of bytes copied to the Ethernet packet.

​
Example

ethernetPacket pkt;
byte ipv6AddrData[16];

// initialize packet with IPv6 and UDP protocols
pkt.ipv6.Init();
pkt.udp.Init();

// set IPv6 addresses
ipGetAddressAsArray( "FC00::01", ipv6AddrData );
pkt.ipv6.source.SetData( 0, ipv6AddrData, elcount(ipv6AddrData) );

ipGetAddressAsArray( "FC00::02", ipv6AddrData );
pkt.ipv6.destination.SetData( 0, ipv6AddrData, elcount(ipv6AddrData) );

// set UDP ports
pkt.udp.source      = 40001;
pkt.udp.destination = 40002;

// set UDP payload
pkt.udp.SetData( 0, "Hello", 5 );

// calculate UDP and IPv6 checksum and send Ethernet packet
pkt.CompletePacket();
output( pkt );