Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

icdevice

Créer un objet périphérique

Description

Utilisez icdevice pour créer un objet périphérique MATLAB^®.

Création

Syntaxe

obj = icdevice(driver,hwobj)

obj = icdevice(driver,rsrcname)

obj = icdevice(driver)

obj = icdevice(___,Name,Value)

Description

obj = icdevice(driver,hwobj) crée l'objet périphérique obj . Les informations spécifiques à l'instrument sont définies dans le pilote d'instrument d'interface MATLAB, driver, qui est spécifié sous forme de chaîne. La communication avec l'instrument se fait via l'objet d'interface hwobj . L'objet d'interface peut être un objet port série, GPIB, VISA, TCPIP ou UDP. Si driver n'existe pas ou si hwobj n'est pas valide, l'objet périphérique n'est pas créé.

Les objets de périphérique peuvent également être utilisés avec les pilotes VXIplug&play et Interchangeable Virtual Instrument (IVI^®). Pour utiliser ces pilotes, vous devez d'abord disposer d'un wrapper de pilote d'instrument MATLAB pour le pilote VXIplug&play ou IVI sous-jacent. Si le wrapper du pilote d'instrument MATLAB n'existe pas déjà, il peut être créé à l'aide de makemid ou midedit. Notez que makemid ou midedit ne doit être utilisé qu'une seule fois pour créer le wrapper du pilote d'instrument MATLAB.

obj = icdevice(driver,rsrcname) crée un objet périphérique obj, en utilisant le pilote d'instrument MATLAB, driver . Le driver spécifié doit être un pilote d'instrument MATLAB VXIplug&play ou un pilote d'instrument MATLAB IVI et est spécifié sous forme de chaîne. La communication avec l'instrument se fait via la ressource spécifiée par rsrcname sous forme de chaîne. Par exemple, tous les pilotes VXIplug&play et de nombreux pilotes IVI nécessitent des noms de ressources VISA pour rsrcname.

obj = icdevice(driver) construit un objet périphérique obj, en utilisant le pilote d'instrument MATLAB, driver . Le driver spécifié doit être un pilote d'instrument MATLAB IVI et le pilote IVI sous-jacent doit être référencé à l'aide d'un nom logique.

obj = icdevice(___,Name,Value) construit un objet périphérique obj en utilisant un ou plusieurs arguments nom-valeur en plus des arguments d'entrée dans les syntaxes précédentes. Les arguments nom-valeur peuvent être dans n'importe quel format pris en charge par la fonction set: paires de vecteurs de caractères nom-valeur, structures et paires nom-valeur de cell array. Vous pouvez également spécifier des noms de propriété sans tenir compte de la casse et utiliser la saisie semi-automatique des noms de propriété. Par exemple, ces commandes sont toutes valides et équivalentes:

d = icdevice('tektronix_tds210',g,'ObjectVisibility','on');
d = icdevice('tektronix_tds210',g,'objectvisibility','on');
d = icdevice('tektronix_tds210',g,'ObjectVis','on');

Remarque

Lors du déploiement de code à l'aide des pilotes IVI-C ou VXIplug&play, l'exécution de votre code générera des fichiers supplémentaires dans le dossier spécifié en exécutant le code suivant à l'invite MATLAB:

fullfile(tempdir,'ICTDeploymentFiles',sprintf('R%s',version('-release')))

Sur toutes les plateformes prises en charge, un fichier avec le nom MATLABPrototypeFor<driverName>.m est généré, où <driverName> est le nom du pilote IVI-C ou VXIplug&play. Avec MATLAB 64 bits sur Windows^®, un deuxième fichier du nom <driverName>_thunk_pcwin64.dll est généré. Lors de la création de votre application déployée ou de votre bibliothèque partagée, incluez manuellement ces fichiers générés. Si vous utilisez la fonction icdevice, n'oubliez pas d'inclure également manuellement le fichier MDD dans l'application déployée ou la bibliothèque partagée. Pour plus d'informations sur l'inclusion de fichiers supplémentaires, reportez-vous à la documentation MATLAB Compiler™.

Exemples

Créer un objet de périphérique à l'aide d'un objet GPIB

Créez un objet de périphérique pour un oscilloscope Tektronix^® TDS 210 connecté à une carte GPIB MCC, à l'aide d'un objet d'interface MATLAB et d'un pilote d'instrument d'interface MATLAB.

g = gpib('mcc',0,2);
d = icdevice('tektronix_tds210',g);

Connectez-vous à l'instrument.

connect(d);

Répertoriez les paramètres de l’oscilloscope qui peuvent être configurés.

props = set(d);

Obtenez la configuration actuelle de l'oscilloscope.

values = get(d);

Débranchez l'instrument et nettoyez.

disconnect(d);
delete([d g]);

Créer un objet périphérique à l'aide du pilote VXIplug&play

Créez un objet périphérique pour un oscilloscope Tektronix TDS 210 à l'aide d'un pilote d'instrument MATLAB VXIplug&play.

Cet exemple suppose que le pilote 'tktds5k' VXIplug&play est installé sur votre système.

Cette première étape n'est nécessaire que si un pilote d'instrument MATLAB VXIplug&play pour le tktds5k n'existe pas sur votre système.

makemid('tktds5k','Tktds5kMATLABDriver');

Construisez un objet périphérique qui utilise le pilote VXIplug&play. L'instrument est supposé être situé à l'adresse principale GPIB 2.

d = icdevice('Tktds5kMATLABDriver','GPIB0::2::INSTR');

Connectez-vous à l'instrument.

connect(d);

Répertoriez les paramètres de l’oscilloscope qui peuvent être configurés.

props = set(d);

Obtenez la configuration actuelle de l'oscilloscope.

values = get(d);

Débranchez l'instrument et nettoyez.

disconnect(d);
delete(d);

Conseils

À tout moment, vous pouvez utiliser la fonction instrhelp pour afficher une liste complète des propriétés et des fonctions associées aux objets de périphérique.

instrhelp icdevice

Lorsque vous créez un objet périphérique, ces valeurs de propriété sont automatiquement configurées:

• Interface spécifie l'interface utilisée pour communiquer avec l'instrument. Pour les objets de périphérique créés à l’aide d’objets d’interface, il s’agit de cet objet d’interface. Pour VXIplug&play et IVI-C, il s'agit du handle de session vers la session du pilote. Pour les pilotes d'instrument MATLAB, il s'agit du handle de l'interface COM par défaut du pilote.

• LogicalName est un nom logique IVI. Pour les pilotes non IVI, il est vide.

• Name est donné en concaténant le type d'instrument avec le nom du pilote de l'instrument.

• RsrcName est le nom complet de la ressource VISA pour les pilotes VXIplug&play et IVI. Pour les pilotes d'interface MATLAB, RsrcName est un vecteur de caractères vide.

• Type est le type d'instrument, s'il est connu (par exemple, scope ou multimeter).

Pour communiquer avec l'instrument, l'objet périphérique doit être connecté à l'instrument avec la fonction connect. Lorsque l'objet périphérique est construit, la propriété Status de l'objet est closed . Une fois l'objet périphérique connecté à l'instrument avec la fonction connect, la propriété Status est configurée sur open.

Remarque

ICDEVICE ne peut pas ouvrir les MDD contenant des caractères non ASCII dans leur nom ou leur chemin sur les plates-formes Mac.

Remarque

Pour obtenir une liste des options que vous pouvez utiliser sur une fonction, appuyez sur la touche Tab après avoir entré une fonction sur la ligne de commande MATLAB. La liste s'agrandit et vous pouvez faire défiler pour choisir une propriété ou une valeur. Pour plus d'informations sur l'utilisation de cette fonctionnalité avancée de saisie semi-automatique des tabulations, voir Using Tab Completion for Functions .

Historique des versions

Introduit avant R2006a

Voir aussi

connect | disconnect