Open topic with navigation CAPL Functions » LIN » linGetBusLoad

linGetBusLoad

Valid for: CANoe DE Note
LIN bus statistics is deactivated by default and must be activated before calling this function. You can do this by calling function linEnableStatistics in an on start handler, see example below.

Function Syntax

double linGetBusLoad(long channel, ValueSelector selector);

Description

Gets the busload of a LIN channel in percent. The kind of value to be returned (average, current, maximum or minimum) can be selected.

Parameters

channel: LIN channel (1…64).
selector: Value selector:
- eCurrValue = current
- eMinValue = minimum
- eMaxValue = maximum
- eAvgValue = average

Return Values

Busload in percent, if LIN statistics is enabled; 0 otherwise.

Example

on start
{
  linEnableStatistics(1, 1); // Enable LIN statistics on channel 1
}

void myStatisticFunc()
{
  double value;

  value = linGetBusLoad(1, eAvgValue); // Average busload of channel 1
  // … do something with the value, e.g.:
  if (value > 30.0)
  {
    // alert
  }
}