UDF > Visa >

_viGTL

Passe l'instrument en mode local

#include <Visa.au3>
_viGTL ( $hSession )

Param�tre

$hSession Un descripteur de VISA (string) ou le handle de la session VISA (integer).
Voir les Remarques de la fonction _viExecCommand() pour plus d'info.

Valeur de retour

Succ�s: Retourne 0.
�chec: Retourne -1 si la dll VISA ne peut pas �tre ouverte
ou une valeur non nulle repr�sentant le code d'erreur VISA (voir le guide du programmeur VISA).

Remarques

Comme pour toutes les fonctions VISA les biblioth�ques visa doiventt �tre install�ess (vous pouvez v�rifier si visa32.dll est dans {WINDOWS}\system32) et une carte GPIB doit �tre install�e (comme par exemple une carte PCI-GPIB National Instruments NI ou une carte GPIB Agilent 82350B PCI de haute performance)

* Pour une description d�taill�e des descripteurs VISA les plus courants regarder les Remarques de l'aide de la fonction _viExecCommand().

Les instruments qui acceptent cette commande quittent le mode "Contr�le distant" et passe en "mode local". Si l'instrument est d�j� en mode "local" la commande est tout simplement ignor�e. Normalement, si un instrument ne supporte pas cette commande, il reste tout simplement en mode "Contr�le distant".

En relation

_viClose, _viExecCommand, _viFindGpib, _viGpibBusReset, _viOpen

Exemple

; - Cet exemple suppose que vous avez install� l'instrument � l'adresse GPIB 3
; Si vous avez un instrument � une adresse diff�rente, changez "GPIB::3::0" en un descripteur correspondant. Faites de m�me pour l'appel � _viOpen.
; Il montre comment utiliser la fonction _viExecCommand en mode autonome et combin� avec _viOpen et _viClose.
; Il montre �galement la fonction _viGTL

#include <MsgBoxConstants.au3>
#include <Visa.au3>

Local $h_Session = 0

; Interroge l'ID de l'instrument � l'address GPIB 3
MsgBox($MB_SYSTEMMODAL, "�tape 1", "Simple requ�te GPIB � l'aide d'un descripteur VISA")
Local $s_Answer = _viExecCommand("GPIB::3::0", "*IDN?", 10)
MsgBox($MB_SYSTEMMODAL, "R�sultat de la requ�te GPIB", $s_Answer) ; Affiche la r�ponse

MsgBox($MB_SYSTEMMODAL, "�tape 2", "Va sur l'ordinateur LOCAL � l'aide d'un descripteur VISA")
_viGTL("GPIB::1::0") ; Va sur un local (quitte le mode contr�le distant)

MsgBox($MB_SYSTEMMODAL, "�tape 3", "Ouvre la connexion de l'instrument avec _viOpen")
Local $h_Instr = _viOpen(3)
MsgBox($MB_SYSTEMMODAL, "Handle de l'Instrument obtenu", "$h_Instr = " & $h_Instr) ; Affiche le handle de la session
; Interroge l'instrument

MsgBox($MB_SYSTEMMODAL, "�tape 4", "Interroge l'instrument � l'aide du handle de l'instrument VISA ")
$s_Answer = _viExecCommand($h_Instr, "*IDN?") ; $h_Instr n'est pas une cha�ne!
MsgBox($MB_SYSTEMMODAL, "R�sultats de la requ�te GPIB", $s_Answer) ; Affiche la r�ponse
; Query again. There is no need to OPEN the link again

MsgBox($MB_SYSTEMMODAL, "�tape 5", "Interroge de nouveau. Inutile d'ouvrir le lien de nouveau")
$s_Answer = _viExecCommand($h_Instr, "*IDN?")
MsgBox($MB_SYSTEMMODAL, "R�sultats de la requ�te GPIB", $s_Answer) ; Affiche la r�ponse

MsgBox($MB_SYSTEMMODAL, "�tape 6", "Va sur l'ordinateur LOCAL � l'aide du handle de l'instrument VISA")
_viGTL($h_Instr) ; Va sur le local (ceci est optionnel)

MsgBox($MB_SYSTEMMODAL, "�tape 7", "Ferme la connexion de l'instrument � l'aide de _viClose")
_viClose($h_Instr) ; Ferme la connexion de l'instrument