NI DIGITAL PATTERN DRIVER PPMU Action Functions

PPMU Action Functions

• niDigital_PPMU_Source
• niDigital_PPMU_Measure

niDigital_PPMU_Source

Starts sourcing voltage or current from the PPMU. This function automatically selects the PPMU function. Changes to PPMU source settings do not take effect until you call this function.

If you modify source settings after you call this function, you must call this function again for changes in the configuration to take effect.

C Function Prototype: ViStatus niDigital_PPMU_Source (ViSession vi, ViConstString channelList)

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.

Return value: Reports the status of the operation.

niDigital_PPMU_Measure

Instructs the PPMU to measure voltage or current. This function can be called to take a voltage measurement even if the pin function is not set to PPMU.

C Function Prototype: ViStatus niDigital_PPMU_Measure (ViSession vi, ViConstString channelList, ViInt32 measurementType, ViInt32 bufferSize, ViReal64[] measurements, ViInt32* actualNumRead)

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.
measurementType	Parameter that specifies whether the PPMU measures voltage or current from the DUT. - NIDIGITAL_VAL_MEASURE_CURRENT (2400): The PPMU measures current from the DUT. - NIDIGITAL_VAL_MEASURE_VOLTAGE (2401): The PPMU measures voltage from the DUT.
bufferSize	The number of elements in the ViReal64 array you specify for measurements. To determine the size of the buffer to allocate for the measurements array, pass a value of 0 to the bufferSize parameter and a value of VI_NULL to the measurements parameter. In this case, the value returned by the actualNumRead parameter is the size of the array necessary to hold the measurements.
Output
measurements	The returned array of measurements in the order you specify in the channelList. If a site is disabled, the function does not return data for that site. Use the niDigital_SortPinResultsBySiteViReal64 function to order and combine the data to match the channelList. You can also use the niDigital_GetResultsPinMapInformation function to obtain a sorted list of returned sites and channels.
actualNumRead	Number of measurements written to the measurements array.

Return value: Reports the status of the operation.