Return to Function List

pi620_init


      ViStatus pi620_init (ViRsrc resourceName, ViBoolean IDQuery,

                           ViBoolean resetDevice,

                           ViPSession instrumentHandle);


  Purpose


      This function opens a session to the instrument, specified by the

      rsrcName parameter, and returns the handle to that session.  It must be

      called prior to using any other functions in this driver.  It will return

      a unique session handle each time it is called, however it is not

      recommended to open more than one handle at a time.

     

      If the id_query parameter is set to VI_TRUE, this function will verify

      that the instrument is supported by this driver.

     

      Reset isn't supported by this device.


  Parameter List


      resourceName


          Variable Type       ViRsrc


          Pass the resource name of the device to initialize.

         

          Refer to the following table below for the exact grammar to use for

          this parameter.  Optional fields are shown in square brackets ([]).

         

          Syntax

          ------------------------------------------------------

          PXI[bus]::<device number>::INSTR

         

          If you do not specify a value for an optional field, the following

          values are used:

         

          Optional Field - Value

          ------------------------------------------------------

          bus - 0

         

          The following table contains example valid values for this parameter.

         

          "Valid Value" - Description

          ------------------------------------------------------

          "PXI1::16::INSTR" - PXI bus 1, device 16

         

          Default Value:  ""

         

         


      IDQuery


          Variable Type       ViBoolean


          Specify whether you want the instrument driver to perform an ID

          Query.

         

          Valid Range:

          VI_TRUE  (1) - Perform ID Query (Default Value)

          VI_FALSE (0) - Skip ID Query

         

          When you set this parameter to VI_TRUE, the driver verifies that the

          instrument you initialize is a 41-620

         

          Circumstances can arise where it is undesirable to perform an ID

          Query.  When you set this parameter to VI_FALSE, the function

          initializes the instrument without performing an ID Query.


      resetDevice


          Variable Type       ViBoolean


          initialization procedure.

         

          Valid Range:

          VI_TRUE  (1) - Reset Device

          VI_FALSE (0) - Don't Reset (Default Value)

         


      instrumentHandle


          Variable Type       ViSession (passed by reference)


          Returns a ViSession handle that you use to identify the instrument in

          all subsequent instrument driver function calls.

         

          Notes:

         

          (1) This function 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 session for the

          same resource, it is best not to do so.



  Return Value


      Refer to Function Return Value page.