NI DIGITAL PATTERN DRIVER DC Current Functions - ni/grpc-device GitHub Wiki
- niDigital_PPMU_ConfigureCurrentLevel
- niDigital_PPMU_ConfigureCurrentLevelRange
- niDigital_PPMU_ConfigureVoltageLimits
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.
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.
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.