_viSetAttribute
Set any VISA attribute This function, which is called by _viSetTimeout, can ALSO be used to set the other VISA specific attributes. Read the VISA documentation for more information and a list of VISA attributes and their corresponding values.
#include <Visa.au3>
_viSetAttribute($h_session, $i_attribute, $i_value)
Параметры
$h_session | A VISA descriptor (STRING) OR a VISA session handle (INTEGER). See the Remarks of the _viExecCommand for more info. |
$i_attribute |
The index of the attribute that must be changed. Attributes are defined in the VISA library. This AutoIt library only defines a CONSTANT for the TIMEOUT attribute ($VI_ATTR_TMO_VALUE) and for the Serial Interface attributes and values (see the remarks) but you can pass any other valid index (as an integer) if you want to. |
$i_value |
The value of the attribute. It must be an integer and the possible values depend on the attribute type and are defined in the VISA documentation. |
Возвращаемое значение
Успех: | Returns 0 |
Ошибка: | Returns -1 if the VISA DLL could not be open or a NON ZERO value representing the VISA error code (see the VISA programmer's guide). |
Примечания
This is a list of the currently pre-defined attributes and values. Remember that you can use any other valid attribute/value by passing the corresponding integer index (as defined in the VISA programmer's guide) to this function.См. также
_viSetTimeout, _viExecCommand, _viOpen, _viCloseПример
;- This assumes that you have instrument set to GPIB address 3.
; If you have an instrument in a different address change "GPIB::3::0" to the
; corresponding descriptor. Do the same for the call to _viOpen
; It shows how to use the _viSetAttribute. In this example we use _viSetAttribute
; instead of _viSetTimeout to set the GPIB timeout of a _viExecCommand operation.
#include <Visa.au3>
Local $h_session = 0
; Query the ID of the instrument in GPIB address 3
MsgBox(4096, "Step 1", "Simple GPIB query with explicit TIMEOUT set")
Local $s_answer = _viExecCommand("GPIB::3::0", "*IDN?", 10000) ; 10 secs timeout
MsgBox(4096, "GPIB QUERY result", $s_answer) ; Show the answer
; This is the same as using the _viSetAttribute function first:
MsgBox(4096, "Step 2", "_vOpen + timeout using _viSetAttribute + GPIB query")
Local $h_instr = _viOpen(3)
; NOTE - This is the same as: _viSetTimeout($h_instr, 10000)
_viSetAttribute($h_instr, $VI_ATTR_TMO_VALUE, 10000) ; 10000 ms = 10 secs
$s_answer = _viExecCommand($h_instr, "*IDN?") ; No need to set the timeout now
MsgBox(4096, "GPIB QUERY result", $s_answer) ; Show the answer
MsgBox(4096, "Step 3", "Close the Instrument connection using _viClose")
_viClose($h_instr) ; Close the instrument connection