Skip to main content
Open topic with navigation

​
CAPL Functions » Scope » testGetWaitScopeSignalTransitionTime

​
Function Syntax

  • long testGetWaitScopeSignalTransitionTime (message aMessage, dword msgFieldStart, dword msgFieldEnd, dword flags, long thresholdStart, long thresholdEnd, ScopeBitTransitionTimeResult result, ScopeAnalyseHandle handle); // form 1
  • long testGetWaitScopeSignalTransitionTime (char nodeName[], dword msgFieldStart, dword msgFieldEnd, dword flags, long thresholdStart, long thresholdEnd, ScopeBitTransitionTimeResult result, ScopeAnalyseHandle handle); // form 2
  • long testGetWaitScopeSignalTransitionTime (linFrame aMessage, dword msgFieldStart, dword msgFieldEnd, dword flags, long thresholdStart, long thresholdEnd, ScopeBitTransitionTimeResult result, ScopeAnalyseHandle handle); // form 3
  • long testGetWaitScopeSignalTransitionTime (frFrame aMessage, dword msgFieldStart, dword msgFieldEnd, dword flags, long thresholdStart, long thresholdEnd, ScopeBitTransitionTimeResult result, ScopeAnalyseHandle handle); // form 4

​
Description

  • Form 1: Measures the transition time of rising and falling edges of a CAN message within the defined area.
  • Form 2: Measures the transition time of rising and falling edges of all Tx messages of an ECU node within the defined area.
  • Form 3: Measures the transition time of rising and falling edges of a LIN message within the defined area.
  • Form 4: Measures the transition time of rising and falling edges of a FlexRay message within the defined area.

​
Parameters

  • aMessage: The message to be analyzed.
  • nodeName: The ECU node name of a database node.
  • msgFieldStart, msgFieldEnd: The start and end of the transition time measurement.
  • flags:
    • Bits:
      • 0: Define threshold level unit:
        • 0 = Threshold level in mV
        • 1 = Threshold level in %
      • 1-3: Select signal for transition time measurement (only valid for CAN):
        • Bit 1 = 1 Use CANhigh
        • Bit 2 = 1 Use CANLow
        • Bit 3 = 1 Use CANdiff
      • 4-5: Rising/falling edge selection:
        • Bit 4 = 1 Use rising edges
        • Bit 5 = 1 Use falling edges
      • 9:
        • 0 = Use last occurrence for transition time measurement
        • 1 = Use first occurrence for transition time measurement
    • All other bits are reserved and must be set to 0.
  • result: The transition time measurement result.
    • ScopeBitTransitionTimeResult Selectors:
      • minValue: The minimal transition time (float)
      • maxValue: The maximal transition time (float)
      • averageValue: The average transition time overall measured edges (float)
      • stdDeviation: The standard deviation of the transition time measurement (float)
      • scopeSamplingPeriod: The configured sample period of the scope device (float)
      • countAnalyzedEdges: The count of analyzed edges (long)
      • countAnalyzedFrames: The count of analyzed frames (long)
  • handle: A unique ID. The same handle must be used for all bit analysis function calls.
    • ScopeAnalyseHandle Selectors:
      • handle: A unique ID (long)

​
Return Values

  • 1: Success
  • 0: Timeout
  • <0: Error occurred.

​
Example

—