CAPLfunctionVTSSetRefVoltageMode

Open topic with navigation

CAPL Functions » VT System » SetRefVoltageMode

SetRefVoltageMode

Valid for: CANoe DE • CANoe:lite DE

Note
The function can only be called on system variable namespaces of channels that represent a power supply in a power module VT7001.

Method Syntax

long SysVarNamespace.SetRefVoltageMode (eVTSRefVoltageMode Mode); // form 1
long SysVarNamespace.SetRefVoltageMode (eVTSRefVoltageMode Mode, double Factor); // form 2

Description

Sets the mode for the reference voltage output to control the power supply’s output voltage.

Parameters

• Mode
  Values see eVTSRefVoltageMode

• Factor
  Factor (Ref voltage factor) to determine the control voltage from the defined (using the system variable or the wave form) power supply output voltage.

  Notice!
  The factor is given by the external power supply. This factor is the ratio of the control voltage to the output voltage. For example, if a power supply outputs 50 V at a control voltage of 5 V, its factor is 0.1 (5/50).

  Use form 1 for the internal power supply - the factor is always 1.
  Use form 2 with explicitly given factor for the external power supplies. The default factor is 1.0.

Return Values

• 0
  Successful call

• -1
  Call error

• -2
  The namespace on which the command was called does not exist, is not a valid VT System namespace or does not support this command.

• -3
  The specified mode is not valid

• -4
  The function wasn’t called in the context of the main method of a test module. So it is not possible to wait until the setting will be taken over from the VT System. Otherwise the call was successful but it is not sure if the settings have been taken over already when the call returns.

Example

In order to output a control voltage (V_Control) which leads to the desired output voltage V_Out, the VT7001 must know the power supply factor. In the following example, the factor of the external power supply is 0.1 and the desired output voltage V_Out is 15 V. To achieve the desired output voltage (V_Out), the VT7001 calculates and sets the control voltage (V_Control) automatically (1.5 V =15 * 0.1), which results in an output voltage of 15 V.

CAPL

SetRefVoltageMode ()
{
  // Set mode to one power supply only -> external power supply 1
  sysvar::VTS::PowerSupply.SetInterconnectionMode(eVTSInterconnectionModeSup1);

  // The factor 0.1 of the external power supply is transmitted to the VT7001
  sysvar::VTS::ExtSupply.SetRefVoltageMode(eVTSRefVoltageModeConstant, 0.1);

  // The following line sets the output voltage to 15 V,
  // VControl (1.5 V) is calculated with the given factor automatically
  @sysvar::VTS::ExtSupply::RefVoltage = 15;

  // Switch output on
  @sysvar::VTS::Clamp30::Active = eVTSOutputModeActive;
}

.NET (C#)

public void SetRefVoltageMode()
{
  // Get VTS interface, VT7001 module, internal supply and a output channel
  IVTSystem vts = VTSystem.Instance;
  IVT7001 powerSupply = vts.GetModule("PowerSupply") as IVT7001;
  IVT7001SupplyExternal extSupply = vts.GetChannel("ExtSupply") as IVT7001SupplyExternal;
  IVT7001Channel clamp30 = vts.GetChannel("Clamp30") as IVT7001Channel;

  // Set mode to one power supply only -> external power supply 1
  powerSupply.InterconnectionMode.Value = InterconnectionMode.Sup1;

  // Activate the reference voltage mode with constant value mode
  // and a factor of 0.1
  extSupply.SetRefVoltageMode(RefVoltageMode.Constant, 0.1);

  // The following line sets the output voltage to 15 V,
  // VControl (1.5 V) is calculated with the given factor automatically
  extSupply.RefVoltage.Value = 15.0;

  // Switch output on
  clamp30.Active.Value = OutputMode.Active;
}

VT System Control

Select PowerSupply
Set Sidebar | Interconnection Settings | Mode to sup1

Select ExtSupply
Set Sidebar | Output | Ref Voltage Mode to Constant
Set Sidebar | Output | Ref Voltage Factor to 0.1
Set Sidebar | Output | RefVoltage to 15.0

Select Clamp30
Set Schematic | Active to active

vtsSetRefVoltageMode