Skip to main content

​
StandaloneConfigOpen

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

​
Function Syntax

dword StandaloneConfigOpen(CHAR rtcfgFileName[], dword stopCurrentMeasurement, dword startNewMeasurement, dword returnToActiveConfig)

​
Description

Opens the RTCFG file with the given name as standalone configuration.
  • The given standalone configuration file must have been downloaded to the device before.
  • The command is only allowed while standalone mode is activated.
  • If standalone measurement is currently running the command is deferred until end of measurement (unless overwritten by another subsequent open command).
  • If standalone measurement is not running but standalone mode is activated the file is loaded but measurement is not started automatically.
  • Basic behavior corresponds to changing the default standalone configuration file.

​
Parameters

  • rtcfgFileName: Name of the standalone configuration file (without path) to be set as default file.
  • stopCurrentMeasurement: If this parameter is 1 measurement is stopped immediately (but still waiting for deferred stop clients). If the parameter value is 0 the request to load another configuration is queued until end of measurement.
  • startNewMeasurement: If this parameter is set to 1 measurement will start immediately after the new configuration has been loaded.
  • returnToActiveConfig: If this parameter is set to 1 the default configuration (usually a sort of “master configuration”) will be loaded automatically after measurement based on the new configuration will have been stopped.

​
Return Values

The function returns an error code with 0 representing successful operation.

​
Example

// "Config1.RTCFG" (master config.) contains following CAPL code:

on key F2
{
   StandaloneConfigOpen("Config2.RTCFG", 1, 1, 1);
}
on key F3
{
   StandaloneConfigOpen("Config3.RTCFG", 1, 0, 1);
}
StandaloneConfigSetDefault