CAPLfunctionEthInjectPacket

Open topic with navigation

CAPL Functions » Ethernet » Function Overview » ethInjectPacket

ethInjectPacket

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long ethInjectPacket (ethernetPacket packet, byte direction);

Description

Transmits an Ethernet packet by a specific ethernetPort defined in <packet>. Allows to output a frame not only on a simulation port like output, but on a physical port as well e.g. for error injection.

Note: The injection is not supported for measurement ports that are connected to a multidrop segment in the hardware configuration.

Parameters

• packet: Variable of type ethernetPacket.
• direction: Transmit direction from viewpoint of the connected segment:
  • <rx> or <0> to send from a simulated port (into the connected segment) in real mode
  • <tx> or <1> to send from a physical measurement port (away from the connected segment) in real mode
  • In simulated mode use <tx> or <rx> (respectively <0> or <1>) to send from simulated ports either into the connected segment (rx) or away from the connected segment (tx).

Return Values

• 0: Success
• 1: Invalid Ethernet port
• 2: Packet failure
• 3: Output not allowed

Example

ethernetPacket txPacket;

txPacket.hwPort = ethernetPort::Ethernet1::Port1;
txPacket.source = EthGetMacAddressAsNumber("20:00:00:00:00:01");
txPacket.destination = EthGetMacAddressAsNumber("FF:FF:FF:FF:FF:FF");
txPacket.Length = 100;
txPacket.type = 0xF123;

ethInjectPacket(txPacket, tx);  // send over physical port <Port1> of network <Ethernet1>