Commande Nom de ressource VISA
- Mise à jour2025-07-30
- Temps de lecture : 4 minute(s)
Utilisez la commande Nom de ressource VISA pour indiquer la ressource avec laquelle une session VISA doit être ouverte, ainsi que pour conserver la session et la classe. Une session VISA est un identificateur logique unique utilisé par VISA pour communiquer avec une ressource. La session VISA est maintenue au moyen de la commande Nom de ressource VISA et n'est pas visible par l'utilisateur. Nom de ressource VISA en sortie correspond à une copie du nom de ressource transmis par les fonctions VISA. En transmettant le nom de ressource entre fonctions et VIs, vous pouvez simplifier la programmation par flux de données en câblant les fonctions les unes aux autres. Ceci est semblable aux refnums de fichiers en sortie utilisés par les fonctions d'E/S sur fichiers.
Le tableau suivant affiche la syntaxe de la chaîne Nom de ressource VISA. Les paramètres optionnels sont affichés entre crochets ([ ]).
| Interface | Syntaxe | Classes |
|---|---|---|
| VXI INSTR | VXI[carte]::adresse logique VXI[::INSTR] | |
| VXI INSTR | VXI[carte]::adresse logique VXI[::INSTR] | VXI/GPIB-VXI/VME MemAcc |
| VXI BACKPLANE | VXI[carte][::adresse logique VXI]::BACKPLANE | VXI/GPIB-VXI Backplane |
| VXI SERVANT | VXI[carte]::SERVANT | VXI Servant |
| GPIB-VXI INSTR | GPIB-VXI[carte]::adresse logique VXI[::INSTR] | |
| GPIB-VXI MEMACC | GPIB-VXI[carte]::MEMACC | VXI/GPIB-VXI/VME MemAcc |
| GPIB-VXI BACKPLANE | GPIB-VXI[carte][::adresse logique VXI]::BACKPLANE | VXI/GPIB-VXI Backplane |
| GPIB INSTR | GPIB[carte]::adresse primaire[::adresse secondaire GPIB][::INSTR] | GPIB Instr |
| GPIB INTFC | GPIB[carte]::INTFC | GPIB BoardInterface |
| GPIB SERVANT | GPIB[carte]::SERVANT | N/A |
| PXI INSTR | PXI[bus]::périphérique[::fonction][::INSTR] | PXI Instr |
| PXI INSTR | PXI[interface]::[bus-]périphérique[.function][::INSTR] | PXI Instr |
| PXI MEMACC | PXI[interface]::MEMACC | PXI MemAcc |
| Serial INSTR | ASRL[carte][::INSTR] | Serial Instr |
| TCPIP INSTR | TCPIP[carte]::adresse de l'hôte[::nom du périphérique LAN][::INSTR] | TCP/IP Instr |
| TCPIP SOCKET | TCPIP[carte]::adresse de l'hôte::port::SOCKET | TCP/IP Socket |
| USB INSTR | USB[carte]::ID du fabricant::code du modèle::numéro de série[::numéro de l'interface USB][::INSTR] | USB Instr |
| USB RAW | USB[carte]::ID du fabricant::code du modèle::numéro de série[::numéro de l'interface USB]::RAW | USB Raw |
Le mot-clé VXI est utilisé pour les instruments VXI au moyen de contrôleurs embarqués ou MXIbus. Le mot-clé GPIB est utilisé pour établir la communication avec un périphérique GPIB. Le mot-clé GPIB-VXI est utilisé pour un contrôleur GPIB-VXI. Le mot-clé ASRL est utilisé pour établir la communication avec un périphérique série asynchrone (comme RS232).
Le mot-clé INSTR spécifie une ressource VISA du type INSTR.
Le tableau suivant indique la valeur par défaut des segments de chaîne facultatifs.
| Segment de chaîne facultatif | Valeur par défaut |
|---|---|
| carte | 0 |
| adresse secondaire GPIB | Aucune |
| nom du périphérique LAN | inst0 |
| fonction PXI | 0 |
| numéro de l'interface USB | interface appropriée de numéro le plus bas |
Le tableau suivant affiche des exemples de chaînes d'adresses.
| Chaîne d'adresse | Description |
|---|---|
| VXI0::1::INSTR | Périphérique VXI à l'adresse logique 1 dans l'interface VXI VXI0. |
| GPIB-VXI::9::INSTR | Périphérique VXI à l'adresse logique 9 dans un système contrôlé par GPIB-VXI. |
| GPIB::1::0::INSTR | Périphérique GPIB à l'adresse primale 1 et à l'adresse secondaire 0 dans l'interface GPIB 0. |
| ASRL1::INSTR | Périphérique série connecté à l'interface ASRL1. |
| VXI::MEMACC | Accès à l'interface VXI par les registres au niveau de la carte. |
| GPIB-VXI1::MEMACC | Accès à l'interface GPIB-VXI numéro 1 par les registres au niveau de la carte. |
| GPIB2::INTFC | Interface ou ressource brute pour l'interface GPIB 2. |
| VXI::1::BACKPLANE | Ressource de châssis pour le châssis 1 sur le système VXI par défaut, qui correspond à l'interface 0. |
| GPIB-VXI1::MEMACC | Ressource de châssis pour le châssis par défaut sur l'interface GPIB-VXI 2. |
| GPIB1::SERVANT | Servant/ressources de périphérique auxiliaire pour interface GPIB 1. |
| VXI0::SERVANT | Servant/ressources de périphérique auxiliaire pour interface VXI 0. |
| TCPIP0::1.2.3.4::999::SOCKET | Accès brut TCP/IP au port 999 de l'adresse IP spécifiée. |
| TCPIP::dev.company.com::INSTR | Périphérique TCP/IP utilisant VXI-11 situé à l'adresse spécifiée. Ce dernier utilise le nom du périphérique LAN par défaut de inst0. |
| PXI::15::INSTR | Périphérique PXI numéro 15 sur le bus 0. |
| PXI0::2-12.1::INSTR | Bus PXI numéro 2, périphérique 12 avec fonction 1. |
| PXI0::MEMACC | Session PXI MEMACC. |
| visa://hostname/resource | La ressource sur le système à distance spécifié. Le nom de l'hôte (hostname) peut être représenté par une adresse IP (notation à points) ou par un nom de machine. Ce système à distance n'a pas besoin d'être configuré explicitement sur le système client. |
| USB::0x1234::125::A22-5::INSTR | Un appareil USB de classe Test & Measurement avec l'ID fabricant 0x1234, le code de modèle 125 et le numéro de série A22-5. Cette opération utilise la première interface USBTMC disponible de l'appareil. Il s'agit généralement du numéro 0. |
| USB::0x5678::0x33::SN999::1::RAW | Un périphérique USB raw (sans classe) avec l'ID du fabricant 0x5678, le code de modèle 0x33 et le numéro de série SN999. Ceci utilise l'interface numéro 1 du périphérique. |
Par défaut, la commande Nom de ressource VISA est définie à la classe Instr, qui correspond aussi à la classe de la session qui sera ouverte. Vous pouvez changer le type de classe en cliquant avec le bouton droit sur la commande en mode édition et en sélectionnant une classe différente dans le menu local.
Les fonctions VISA varient dans la classe du Nom de ressource VISA qui peut leur être câblé. Les classes autorisées pour chaque fonction sont listées dans NI-VISA Help. Par exemple, les fonctions des palettes Accès aux registres et Accès de bas niveau aux registres n'acceptent pas les sessions VISA de la classe GPIB Instr ou Serial Instr.
Si vous connectez le contrôle du nom de la ressource VISA à une fonction qui n'accepte pas la classe de la session, ou si vous connectez ensemble deux noms de ressources de classes différentes, le schéma fonctionnel ne s'exécutera pas et une erreur de conflit de classe sera signalée.
Si vous câblez la commande Nom de ressource VISA à une fonction qui n'accepte pas la classe de la session, ou si vous câblez deux noms de ressources VISA de classes différentes ensemble, le diagramme ne fonctionnera pas et une erreur de conflit de classe sera signalée.