Skip to main content

​
J1939CheckMultiPG

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

long J1939CheckMultiPG(message multiPG);
long J1939CheckMultiPG(message multiPG, char[] errorText);

​
Description

Checks whether a J1939-22 Multi-PG and its Contained-PGs (C-PGs) are consistent.

​
Parameters

  • multiPG: A J1939-22 Multi-PG message.
  • errorText: Returns an error text if return value is < 0.

​
Return Values

  • 0: Multi-PG is valid
  • -1: Leading three bytes of Padding C-PG (TOS = 0) must be 0x00
  • -2: Padding bytes 4-15 shall be set all to 0xAA or all to 0x00
  • -3: Data length of Multi-PG is unnecessary big for the contained C-PGs
  • -4: Multi-PG is using the D_PDU1 format (destination specific) and therefore must not contain PDU2 C-PGs
  • -5: Not enough space for another C-PG. Expected padding bytes
  • -6: C-PG is a A-PDU1 and therefore PDU Specific (PS) field of PGN must be 0x00
  • -7: Length of C-PG exceeds Multi-PG
  • -8: C-PGs do not fit into the Multi-PG
  • -9: Length of C-PG exceeds maximum of 60 bytes
  • -10: Assurance Data length exceeds length of C-PG
  • -11: A Multi-PG shall not contain Address Claimed messages

​
Example

void CheckMultiPG(message * multiPG)
{
  long result;
  char errorText[128];
  result = J1939CheckMultiPG(multiPG, errorText);
  if (result != 0)
  {
    writeEx(-3, 3, "Multi-PG is not consistent: %s", errorText);
  }
}