CAPLfunctionAfdxSetSignalOpaque

AfdxSetSignalOpaque

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

Function Syntax

long AfdxSetSignalOpaque( long packet, char signalName[], long length, byte value[], long fdsStatus ); // form 1
long AfdxSetSignalOpaque( long packet, long offset, long length, byte value[] ); // form 2

Description

This function updates an opaque AFDX signal. There are two different opaque data types available in AFDX:

• Fixed length opaque data: n bytes
• Variable length opaque type: 16-bit length value n, data field filled up with n bytes, padding area filled with 0.

Parameters

• packet: Handle of the message.
• signalName: Name of the signal.
  Note: The signal, the signal’s data type and the message need to be defined in the assigned DBC file.
• offset: The offset value points to the starting byte of the opaque signal in the AFDX payload area.
• length: This is the number of bytes, the opaque signal is occupying in the value buffer.
• value:
  • For form 1 the bytes of the opaque data have to be provided.
  • For form 2 the complete opaque signal is available in the buffer (for variable length the length value belongs to the opaque data).
• fdsStatus:
  • 255: The status is not updated
  • valid status enumeration: The functional status is updated with this value.

Return Values

• 0:
• other value: error code

Example

long packet;
long msgID = 0x1A112B73;

// create a new AFDX packet as defined in the DBC with this msgID
packet = AfdxInitPacket( msgID, NULL, 0 );

// set integer signal 1 to 78 degrees, don’t change status byte
AfdxSetSignalInt( packet, "VFG_OIL_TEMP_A_34", 78 );

// set float-signal 2 to 52 degree, set corresponding status to <NO>
AfdxSetSignalReal( packet, "VFG_OIL_TEMP_AB_32", 52, 3 );

// set boolean signal 3 to 1, set corresponding status to <NO>
AfdxSetSignalBool( packet, "VFG_OIL_TEMP_A_ON", 1, 3 );

// set enumeration signal 4 to 5, don’t change status byte
AfdxSetSignalInt( packet, "FLIGHT_GROUND_COND_3", 5 );

// set string signal 6 to hello, don’t change status byte
AfdxSetSignalString( packet, "TEST_STRING14_CITY", "hello" );

// set opaque signal 7 to 0x31,0x32,0x33, don’t change status byte
AfdxSetSignalOpaque( packet, "TEST_OPAQUE14_IDENT", 3, "123" );

AfdxOutputPacket( packet );