CAPLfunctionC2xOnC2xPacket

<OnC2xPacket> (Callback)

Valid for: CANoe DE

Note
This callback must be implemented in the CAPL program by the user to use the function C2xReceivePacket or the function C2xRegisterCallback for Receive Indications.

Function Syntax

void <OnC2xPacket>( long channel, long dir, long radioChannel, long signalStrength, long signalQuality, long packet );

Description

This callback is called when a registered WLAN packet is received.

Within this callback the following functions can be used to retrieve the received packet data:

• C2xGetThisData
• C2xGetThisTimeNS
• C2xGetThisValue8
• C2xGetThisValue16
• C2xGetThisValue32
• C2xGetThisValue64
• C2xGetThisMotorolaValue16
• C2xGetThisMotorolaValue32
• C2xGetThisMotorolaValue64

These functions access the payload of the highest interpretable protocol. Offset 0 starts at the beginning of the payload.

Parameters

• channel: WLAN channel on which the packet was received
• dir: Direction of the packet
  • 0: Rx
  • 1: Tx
• radioChannel: Radio channel, i.e. 176 or 180
• signalStrength: Signal strength of the received packet in [dBm]
• signalQuality: Signal quality of the received packet
• packet: Handle of the received packet

Return Values

—

Example

Node System - PreStart in CAPL Browser

on preStart
{
  C2xReceivePacket( "OnC2xPacket");
}

Node Callback Function in CAPL Browser

void <OnC2xPacket>( long channel, long dir, long radioChannel, long signalStrength, long signalQuality, long packet )
{
  byte rx_data[100];
  long rx_length;
  // get the payload of the packet
  rx_length = C2xGetThisData( 0, elCount(rx_data), rx_data );
  // do something with rx_data
}