Skip to main content
Open topic with navigation CAPL Functions » LIN » linSetRespDisturbance

​
linSetRespDisturbance

Valid for: CANoe DE

​
Function Syntax

long linSetRespDisturbance (long frameId, long lengthInBits, 
 long level, long offsetInSixteenthBits);

​
Description

Activates a disturbance in the response space of the specified LIN frame. A normal response by a simulated slave will be deactivated as long as the disturbance is active. Note: The disturbance starts with the next occurrence of the specified frame. To stop the disturbance the functions linResetRespDisturbance() shall be used.

​
Parameters

  • frameId: LIN frame identifier in the range 0 .. 63.
  • lengthInBits: The duration of the disturbance [in bit times].
  • level: The level of the disturbance.
    • 0: dominant disturbance (inverts recessive bits)
    • 1: recessive disturbance (inverts dominant bits - requires mag-Cab/Piggyback and external power supply)
  • offsetInSixteenthBits: The offset [in 1/16th bits] of the disturbance relative to the end of the header, i.e., to the PID byte.

​
Return Values

On success, a value unequal to zero, otherwise zero.

​
Example

On pressing ‘c’ key start corrupting the response space and the first databyte of the response for LIN frame Motor1State_Cycl. 
on key 'c'
{
    linFrame Motor1State_Cycl mMotor1State_Cycl;
    if (0!=linSetRespDisturbance (mMotor1State_Cycl.id, 1, 0, 20))
    {
        // for the next the first bit of the response space 
        // or of the first databyte
        // (if the response space is zero) is inverted from recessive to dominant
    }
}
linResetRespDisturbance • linStartDisturbance