NI DIGITAL PATTERN DRIVER DC Voltage Functions - ni/grpc-device GitHub Wiki
- niDigital_PPMU_ConfigureVoltageLevel
- niDigital_PPMU_ConfigureCurrentLimit
- niDigital_PPMU_ConfigureCurrentLimitRange
Configures the voltage level the PPMU outputs 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_ConfigureVoltageLevel (ViSession vi, ViConstString channelList, ViReal64 voltageLevel)
| 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. |
| voltageLevel | Voltage level that the PPMU forces to the DUT pin. |
Return value: Reports the status of the operation.
Specifies the current limit for the specified pins when forcing voltage.
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 voltage by setting the niDigital_PPMU_ConfigureOutputFunction function to NIDIGITAL_VAL_DC_VOLTAGE, the current sourced or sunk is clamped to the specified current limit. Select the smallest current limit that meets the expected current requirements of the DUT. If the current required by the DUT exceeds the selected current limit range, the voltage output may not meet the specified voltage level. Choose a larger current limit range if needed.
Not all instruments support this capability. Refer to the Current Limit Supported attribute to programmatically determine whether an instrument supports this capability. If high-accuracy current clamping functionality is required, consider using a Source Measure Unit (SMU) instrument.
C Function Prototype: ViStatus niDigital_PPMU_ConfigureCurrentLimit (ViSession vi, ViConstString channelList, ViInt32 behavior, ViReal64 limit)
| 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. |
| behavior |
Behavior of the output current when the current limit is reached. - NIDIGITAL_VAL_CURRENT_REGULATE (3100): Controls output current so that it does not exceed the current limit. Power continues to generate even if the current limit is reached. |
| limit | Current limit, in amps, on the pins in the channelList parameter.The valid values for this parameter are defined by the current limit range. |
Return value: Reports the status of the operation.
Specifies the current limit range for the specified pins when forcing voltage.
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 voltage by setting the niDigital_PPMU_ConfigureOutputFunction function to NIDIGITAL_VAL_DC_VOLTAGE, the current sourced or sunk is moderated by the specified current limit range. Select the smallest current range that meets the expected current requirements of the DUT.
If the current required by the DUT exceeds the selected current limit range, the voltage output may not meet the specified voltage level. Choose a larger current limit range if needed.
C Function Prototype: ViStatus niDigital_ConfigureCurrentLimitRange (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 range, in amps, to use when forcing a voltage from the PPMU to a DUT. |
Return value: Reports the status of the operation.