NI DIGITAL PATTERN DRIVER DC Current Functions

DC Current Functions

• niDigital_PPMU_ConfigureCurrentLevel
• niDigital_PPMU_ConfigureCurrentLevelRange
• niDigital_PPMU_ConfigureVoltageLimits

niDigital_PPMU_ConfigureCurrentLevel

Specifies the current level that the PPMU forces to the DUT.

You must call the niDigital_PPMU_Source function for changes to the PPMU configuration to take effect, even if the PPMU is already sourcing.

C Function Prototype: ViStatus niDigital_PPMU_ConfigureCurrentLevel (ViSession vi, ViConstString channelList, ViReal64 currentLevel)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
channelList	List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis.
currentLevel	Current level, in amps, that the PPMU forces to the DUT.

Return value: Reports the status of the operation.

niDigital_PPMU_ConfigureCurrentLevelRange

Configures the current level range and defines the valid values that the current level can be set to using the niDigital_PPMU_ConfigureCurrentLevel function. The current level range setting is applicable only if the channel is set to the DC Current output function using the niDigital_PPMU_ConfigureOutputFunction function.

You must call the niDigital_PPMU_Source function for changes to the PPMU configuration to take effect, even if the PPMU is already sourcing.

C Function Prototype: ViStatus niDigital_PPMU_ConfigureCurrentLevelRange (ViSession vi, ViConstString channelList, ViReal64 range)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
channelList	List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis.
range	Current level range, in amps, to use when forcing a current from the PPMU to a DUT. Selecting the smallest range adequate for the desired current level provides the best current accuracy for the force current and measure current operations.

Return value: Reports the status of the operation.

niDigital_PPMU_ConfigureVoltageLimits

Specifies the voltage limit high, or high clamp voltage (VCH), and voltage limit low, or low clamp voltage (VCL), for the specified pins when forcing current.

You must call the niDigital_PPMU_Source function for changes to the PPMU configuration to take effect, even if the PPMU is already sourcing.

When forcing current by setting the niDigital_PPMU_ConfigureOutputFunction function to DC Current, the voltage is clamped to the specified voltage limits. Select the smallest voltage limits appropriate for the DUT.

If the voltage required by the DUT exceeds the specified voltage limits, the current output may not meet the specified current level. Choose larger voltage limits as needed and appropriate for the DUT.

C Function Prototype: ViStatus niDigital_PPMU_ConfigureVoltageLimits (ViSession vi, ViConstString channelList, ViReal64 lowerVoltageLimit, ViReal64 upperVoltageLimit)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
channelList	List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis.
lowerVoltageLimit	The nominal voltage at the pin at which the low side voltage clamp activates when the PPMU forces current to the DUT.
upperVoltageLimit	The nominal voltage at the pin at which the high side voltage clamp activates when the PPMU forces current to the DUT.

Return value: Reports the status of the operation.