Skip to main content

​
SetBusContext

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE Note
The bus context plays a role in modeling gateways and in tests of control units with several bus connections. In this case, a series of CAPL functions such as canOnline and canOffline may have more than one meaning in terms of the network interface (channel) to be used. A similar type of problem occurs when identical node layer modules are used simultaneously within a CAPL block. A distinction must be made between the instances of the node layer, both for calls to CAPL functions that are implemented in the node layers and for implementing callbacks. To facilitate this distinction, a bus context is placed in the CAPL program by the runtime environment while a callback is being executed by the node layer. This context unambiguously identifies the node layer that is making the call. In a similar manner, the call of a CAPL function that is implemented in a node layer is forwarded on to the appropriate node layer, depending on the current bus context. This also applies to the CAPL functions mentioned above, canOnline and canOffline, as well as to many wait points of the Test Feature Set. You should use the functions GetBusNameContext, GetBusContext and SetBusContext to determine the context of a bus, to query the current bus context, or to change the context.

​
Function Syntax

dword SetBusContext( dword context);

​
Description

Sets the bus context of the CAPL block.

​
Parameters

  • context: The new bus context to be set.

​
Return Values

The bus context that was valid before the call was made is returned.

​
Example

This is an example for a simulation node.
Test nodes should copy the bus context to a CAPL variable in the Main() function because all global variables are cleared when the test module is started. 
variables
{
    dword ibus_context = 0;
    dword motbus_context = 0;
}
on preStart
{
    ibus_context = GetBusNameContext( "ibus");
    motbus_context = GetBusNameContext( "motbus");
}
void apCanOn()
{
    dword context;
    // activate the CAN channel on the "current" context
    CanOnline();
    // determine the "other" context
    context = ibus_context == GetBusContext() ? motbus_context : ibus_context;
    // set the context to the "other" bus...
    SetBusContext( context);
    // ...and activate its CAN chip as well
    CanOnline();
}
GetBusNameContext • GetBusContext