Pin(s) to NI-DCPower Session(s) (TSM)
- Updated2024-02-02
- 8 minute(s) read
Pin(s) to NI-DCPower Session(s) (TSM)
Requires: TSM
Returns the NI-DCPower instrument sessions and channel strings required to access one or more pins. You must manually select the polymorphic instance you want to use. Select the single pin or multiple pins polymorphic instance based on the number of pins the test is designed to test. Select the single instrument or multiple instrument polymorphic instance based on the number of instruments you expect the pin to be connected to in the pin map. Use the multiple instrument polymorphic instances to ensure that code modules work with any pin map. Use the single instrument instance only when you know the code module will never be used with a pin map that has more than one instrument connected to the specified pins.
Multiple Pins - Multiple Sessions
Returns the NI-DCPower sessions and channel strings required to access the pins.
![]()
| Semiconductor Module Context is a valid ActiveX reference to a Semiconductor Module context object. | |
| Pins specifies the names of the pins or pin groups to translate to Instrument Sessions and Channel Strings. | |
| error in (no error) describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. | |
| Pin Query Context is the pin query context object that tracks the sessions and channels associated with a pin query. TSM uses this object to publish measurements and extract data from a set of measurements. | |
| Semiconductor Module Context Out returns the Semiconductor Module Context parameter unchanged. | |
| Channel Strings returns the channel string for each instrument session required to access the Pins for all sites in the Semiconductor Module Context. Each channel string is a comma-separated list of channels, where each channel is defined as <instrument>/<channel>. | |
| Instrument Sessions returns the NI-DCPower sessions for the instruments and channels connected to Pins for all sites in the Semiconductor Module Context. | |
| error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. |
Single Pin - Multiple Sessions
Returns the NI-DCPower sessions and channel strings required to access the pin.
![]()
| Semiconductor Module Context is a valid ActiveX reference to a Semiconductor Module context object. | |
| Pin specifies the name of the pin or pin group to translate to Instrument Sessions and Channel Strings. | |
| error in (no error) describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. | |
| Pin Query Context is the pin query context object that tracks the sessions and channels associated with a pin query. TSM uses this object to publish measurements and extract data from a set of measurements. | |
| Semiconductor Module Context Out returns the Semiconductor Module Context parameter unchanged. | |
| Channel Strings returns the channel string for the NI-DCPower session required to access the Pin for all sites in the Semiconductor Module context. Each channel string is a comma-separated list of channels, where each channel is defined as <instrument>/<channel>. | |
| Instrument Sessions returns the NI-DCPower sessions for the instruments and channels connected to the Pin for all sites in the Semiconductor Module Context. | |
| error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. |
Single Pin - Single Session
Returns the NI-DCPower session and channel string required to access the pin. If more than one session is required to access the pin, the VI returns an error.
![]()
| Semiconductor Module Context is a valid ActiveX reference to a Semiconductor Module context object. | |
| Pin specifies the name of the pin to translate to an Instrument Session and Channel String. If multiple sessions are required, the VI returns an error. | |
| error in (no error) describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. | |
| Pin Query Context is the pin query context object that tracks the sessions and channels associated with a pin query. TSM uses this object to publish measurements and extract data from a set of measurements. | |
| Semiconductor Module Context Out returns the Semiconductor Module Context parameter unchanged. | |
| Channel String returns the channel string for the instrument Session required to access the Pin for all sites in the Semiconductor Module Context. The channel string is a comma-separated list of channels, where each channel is defined as <instrument>/<channel>. | |
| Instrument Session returns the NI-DCPower instrument session for the instrument and channel connected to Pin. | |
| error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. |
Multiple Pins - Single Session
Returns the NI-DCPower session and channel string required to access the pins. If multiple sessions are required, the VI returns an error.
![]()
| Semiconductor Module Context is a valid ActiveX reference to a Semiconductor Module context object. | |
| Pins specifies the names of the pins or pin groups to translate to an instrument session and channel resource name list. | |
| error in (no error) describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. | |
| Pin Query Context is the pin query context object that tracks the sessions and channels associated with a pin query. TSM uses this object to publish measurements and extract data from a set of measurements. | |
| Semiconductor Module Context Out returns the Semiconductor Module Context parameter unchanged. | |
| Channel String returns the channel string for the NI-DCPower instrument session required to access the pins for all sites in the Semiconductor Module Context. The channel string is a comma-separated list of resources, where each resource is defined as <instrument>/<channel>. | |
| Instrument Session returns the NI-DCPower instrument session for the instruments and channels connected to Pins for all sites in the Semiconductor Module Context. | |
| error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. |