IviDigitizer Send Software Arm [SA]
IviDigitizerSoftwareArm Capability Group
This VI sends a software-generated arm to the instrument. It is only applicable for instruments using interfaces or protocols which support an explicit arm function.
Since instruments interpret a software-generated arm in a wide variety of ways, the precise response of the instrument to this arm is not defined.
This VI should not use resources which are potentially shared by other devices (for example, the VXI trigger lines). Use of such shared resources may have undesirable effects on other devices.
This VI should not check the instrument status. Typically, the end-user calls this VI only in a sequence of calls to other low-level driver VIs. The sequence performs one operation. The end-user uses the low-level VIs to optimize one or more aspects of interaction with the instrument. To check the instrument status, call the appropriate error query VI at the conclusion of the sequence.
The arm source property must accept Software Arm as a valid setting for this VI to work. If the arm source is not set to Software Arm, this VI does nothing and returns the error Arm Not Software.
![IviDigitizer Send Software Arm [SA].vi](ividigitizer_send_software_arm_[sa]c.gif)
 |
instrument handle Returns an Instrument Handle that you use to identify the instrument in all subsequent instrument driver VI calls.
Notes: (1) This VI creates a new session each time you invoke it. This is useful if you have multiple physical instances of the same type of instrument. (2) Avoid creating multiple concurrent sessions to the same physical instrument. Although you can create more than one IVI session for the same resource, it is best not to do so. A better approach is to use the same IVI session in multiple execution threads. |
 |
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
 |
instrument handle out Returns an Instrument Handle that you use to identify the instrument in all subsequent instrument driver VI calls.
Notes: (1) This VI creates a new session each time you invoke it. This is useful if you have multiple physical instances of the same type of instrument. (2) Avoid creating multiple concurrent sessions to the same physical instrument. Although you can create more than one IVI session for the same resource, it is best not to do so. A better approach is to use the same IVI session in multiple execution threads. |
 |
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |