CAPLfunctionLINSendVariableBitStream

Open topic with navigation

CAPL Functions » LIN » linSendVariableBitStream

linSendVariableBitStream

Valid for: CANoe DE

Function Syntax

• long linSendVariableBitStream(byte dataBuffer[], int64 lengthInNS[], dword numberOfBits, dword roundUp); // form 1
• long linSendVariableBitStream(byte dataBuffer[], int64 lengthInNS[], dword numberOfBits, dword roundUp, dword timeoutPrevention) // form 2
• long linSendVariableBitStream(byte dataBuffer[], int64 lengthInNS[], dword numberOfBits, dword roundUp, dword timeoutPrevention, dword interruptingTx) // form 3

Description

Sends an arbitrary bitstream with bits of variable length on the LIN bus.

Parameters

• dataBuffer: The bitstream to be sent. Maximum number of bits: 2^31-1.
• lengthInNS: The length of each bit in nanoseconds.
• numberOfBits: The number of bits in the bitStream-array. Note that while the dataBuffer-array will usually have a size of ceil(numberOfBits / 8), the size of lengthInNS will need to be at least numberOfBits.
• roundUp: If true, the lengths specified in lengthInNS will be rounded up to the next possible length that can be transmitted by the LIN hardware, otherwise the lengths will be rounded down.
• timeoutPrevention:
  • 0: deactivates the timeout prevention for the 7259-transceiver.
  • 1: activates the timeout prevention for the 7259-transceiver.
• interruptingTx: When activated (= 1) the transmission of the bitstream starts immediately without waiting for the bus to be free. Note that this mode may disturb a running transmission.

Return Values

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

Example

// This function sends a disturbance of 1 second, followed by a pause of 1 second,
// followed by a disturbance of 7 seconds using the variable bitstream functionality
void SendDisturbances()
{
    byte data[1] = { 2 };
    int64 lengthInNS[3] = { 1000000000LL, 1000000000LL, 7000000000LL };
    linSendVariableBitStream(data, lengthInNS, 3, 1, 1);  byte data[25];
}

linSendBitStream