Skip to main content

​
ChkStart_SignalCycleTimeViolation

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

dword ChkStart_SignalCycleTimeViolation (Signal ObservedSignal, duration MinCycleTime, duration MaxCycleTime);
dword ChkStart_SignalCycleTimeViolation (Signal ObservedSignal, duration MinCycleTime, duration MaxCycleTime, char[] CaplCallback);

​
Check Name

Signal Cycle Time Absolute

​
Description

Checks the occurrences of a signal. An event will be generated if the time between two consecutive signal occurrences is out of the specified range. Note: Limit set to 0 is considered as “cycle time is undefined”; at least one limit has to be more than 0.

​
Parameters

  • ObservedSignal: Signal to observe. It must exist in DB
  • MinCyc:
    • 0: Minimum cycle time shall not be checked
    • \> 0: Minimum allowed cycle time
    • Unit: Is set with ChkConfig_SetPrecision()
  • MaxCycleTime:
    • 0: Maximum cycle time shall not be checked
    • \> 0: Maximum allowed cycle time
    • Unit: Is set with ChkConfig_SetPrecision()
  • CaplCallback: Name of CAPL callback function to be called on generated event. In simulation nodes this parameter has to be set. In test modules this parameter is optional.

​
Return Values

  • 0: Check could not be created and must not be referenced
  • > 0: Check was created successfully and may be referenced using the returned (handle-) value.

​
Possible Errors

  • Signal does not exist in DB
  • Range specified for cycle time is invalid
  • Signal is not mapped to a message
  • CAPL callback does not exist

​
Check-specific Queries

​
Example

...
dword checkId;
// Create and start the check for LIN wake-up request
checkId = ChkStart_SignalCycleTimeViolation(Motor1State_Cycl::Motor1Temp,
          29,    // min. cycle time in ms
          32,    // max cycle time in ms
          "SigCycleTimeCallback");
...
// CAPL callback for violation notification
void SigCycleTimeCallback (dword aCheckId)
{
    ChkQuery_EventStatusToWrite(aCheckId);
}
Functions to Configure Checks • Commands to Control Checks