Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » ISO11783 Interaction Layer » Iso11783IL_PDDGetSectionState

Iso11783IL_PDDGetSectionState

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long Iso11783IL_PDDGetSectionState(dword ddiOfCondensedState, dword elementNumber, dword sectionNumber); // form 1
long IsoO11783IL_PDDGetSectionState(dbNode implement, dword ddiOfCondensedState, dword elementNumber, dword sectionNumber); // form 2

Description

Returns the current state of a single section. For the already specified DDIs (currently in range DDI=0 and DDI=520), the functions check if the sectionNumber fits to the DDI.

Parameters

  • ddiOfCondensedState: Data dictionary identifier the condensed state belongs to, e.g.:
    • 161..176 (0x0A1..0x0B0) for Actual Condensed Work State
    • 290..305 (0x122..0x131) for Setpoint Condensed Work State
    • 367..382 (0x16F..0x17E) for Condensed Section Override State
    • 517 (0x205) for Setpoint Tramline Condensed Work State 1-16
    • 518 (0x206) for Actual Tramline Condensed Work State 1-16
  • elementNumber: Element number, 0x000..0xFFF.
  • sectionNumber: Section number within the object, 1..256.
  • implement: Simulation node to apply the function.

Return Values

  • 0: disabled/off
  • 1: enabled/on
  • 2: error indicator
  • 3: no change
  • < 0: An error has occurred, see error codes

Example

long value;
char text[256];
value = Iso11783IL_PDDGetSectionState(290, 10, 1);
if (value < 0)
{
  Iso11783IL_GetLastErrorText(elCount(text), text);
  write("ERROR: %s", text);
}