Configures a series of voltage, current, resistance or power outputs and corresponding source delays. The source mode must be set to NIDCPOWER_VAL_SEQUENCE for this function to take effect.

Syntax

ViStatus _VI_FUNC niDCPower_SetSequence(ViSession vi, ViConstString channelName, const ViReal64 values[], const ViReal64 sourceDelays[], ViUInt32 size)

Remarks

Use this function in the Uncommitted or Committed programming states.

Support for this Function

Using this function and advanced sequence functions for the same channel in the same session is not supported.

Note

NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.

Note

This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

channelName[in]ViConstString

Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.

If you do not pass this control, all channels in the session are used.

values[in]const ViReal64[]

Specifies the series of voltage, current, resistance or power levels, depending on the configured NIDCPOWER_ATTR_OUTPUT_FUNCTION .

Valid Values:
The valid values for this parameter are defined by the voltage level range, current level range, constant resistance level range or constant power level range.

sourceDelays[in]const ViReal64[]

Specifies the source delay that follows the configuration of each value in the sequence.

Valid Values:
The valid values are between 0 and 167 seconds.

size[in]ViUInt32

The number of elements in the Values and the Source Delays arrays. The Values and Source Delays arrays should have the same size.

Returns

Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors