CAPLfunctionVTSvtsSetOutputMask

Open topic with navigation

CAPL Functions » VT System » vtsSetOutputMask

vtsSetOutputMask

Valid for: CANoe DE • CANoe:lite DE

Note
The function may not be called in any CAPL handler routines or in ECU nodes. It may only be called in the context of the MainTest method of a test module.

Function Syntax

long vtsSetOutputMask (DWORD RowMask);

Description

Activates the requested rows of a switch matrix module for dynamic stimulation (PWM, Bitstreams). The row selection is binary encoded into the call parameter.

Parameters

• RowMask: Binary interpreted 32bit unsigned integer value where the least significant five bits encode the connection of the corresponding matrix row with the current matrix channel.

  The assignment of matrix rows to bits of RowMask is implemented as follows:

  • Matrix Row 1 is activated with Bit0
  • Matrix Row 2 is activated with Bit1
  • Matrix Row 3 is activated with Bit2
  • Matrix Row 4 is activated with Bit3
  • Direct Switch is activated with Bit 4 (channel 5-8)

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.

Example

The following example demonstrates how an identical switch sequence defined in MyBitstream.txt (e.g. a bouncing contact simulation) is applied subsequently to all rows of a VT2832 channel.

CAPL

ToggleMatrixRows()
{
  int iRow;

  // This calls the method SetCurveType on VTS::MyMatrixChannel
  sysvar::VTS::MyMatrixChannel_1.SetCurveType(eVTSCurveTypeBitStream);

  // This calls the method LoadWFBitStream on VTS::MyMatrixChannel_2
  sysvar::VTS::MyMatrixChannel_1.LoadWFBitStream("MyBitstream.txt");

  // Configure waveform Parameters:
  // TimeIncrement (time to hold each sample)       = 20ms
  // Pause (pause between two waveform repetitions) = 0s
  // NumberOfRepeats (number of repetitions)        = 1

  sysvar::VTS::MyMatrixChannel_1.SetWFParams(0.020, 0.0, 1);

  // Start stimulation
  vtsStartStimulation("VTS::MyMatrixChannel_1");

  for (iRow = 1; iRow < 16; iRow = iRow << 1)
  {
    // This calls the method SetOutputMask on VTS::MyMatrixChannel_1
    vtsSetOutputMask("VTS::MyMatrixChannel_1", iRow);
  }

  // Stop the simulation
  vtsStopStimulation("VTS::MyMatrixChannel_1");
}

.NET (C#)

—

VT System Control

Select MyMatrixChannel_1
Set Sidebar | Output Settings | Curve Type to Bitstream
Set Sidebar | Bitstream Output | Bitstream to MyBitstream.txt
Set Sidebar | Bitstream Output | Parameters | Time Increment to 0.02
Set Sidebar | Bitstream Output | Parameters | Pause to 0.0
Set Sidebar | Bitstream Output | Parameters | Repeats to 0
Click Sidebar | Output Settings | Start Stimulation
Enable each row, one by one
Set Sidebar | PWM /Bitstream Output Mask | Row 1 to ON
Set Sidebar | PWM /Bitstream Output Mask | Row 1 to OFF
Set Sidebar | PWM /Bitstream Output Mask | Row 2 to ON
Set Sidebar | PWM /Bitstream Output Mask | Row 2 to OFF
Set Sidebar | PWM /Bitstream Output Mask | Row 3 to ON
Set Sidebar | PWM /Bitstream Output Mask | Row 3 to OFF
Set Sidebar | PWM /Bitstream Output Mask | Row 4 to ON
Set Sidebar | PWM /Bitstream Output Mask | Row 4 to OFF
Click Sidebar | Output Settings | Stop Stimulation

SetOutputMask