icdevice
Crea oggetto dispositivo
Descrizione
Utilizzare icdevice per creare un oggetto dispositivo MATLAB®.
Creazione
Sintassi
Descrizione
obj = icdevice( crea l'oggetto dispositivo driver,hwobj)obj . Le informazioni specifiche dello strumento sono definite nel driver dello strumento dell'interfaccia MATLAB, driver, specificato come stringa. La comunicazione con lo strumento avviene tramite l'oggetto interfaccia hwobj . L'oggetto interfaccia può essere una porta seriale, un oggetto GPIB, VISA, TCPIP o UDP. Se driver non esiste o se hwobj non è valido, l'oggetto dispositivo non viene creato.
Gli oggetti dispositivo possono essere utilizzati anche con i driver VXIplug&play e Interchangeable Virtual Instrument (IVI®). Per utilizzare questi driver, è necessario innanzitutto disporre di un wrapper del driver dello strumento MATLAB per il driver VXIplug&play o IVI sottostante. Se il wrapper del driver dello strumento MATLAB non esiste già, può essere creato utilizzando makemid o midedit. Si noti che makemid o midedit devono essere utilizzati solo una volta per creare il wrapper del driver dello strumento MATLAB.
obj = icdevice( crea un oggetto dispositivo driver,rsrcname)obj, utilizzando il driver dello strumento MATLAB, driver. Il valore driver specificato deve essere un driver di strumento MATLAB VXIplug&play o un driver di strumento MATLAB IVI e viene specificato come stringa. La comunicazione con lo strumento avviene tramite la risorsa specificata da rsrcname come stringa. Ad esempio, tutti i driver VXIplug&play e molti driver IVI richiedono nomi di risorse VISA per rsrcname.
obj = icdevice( costruisce un oggetto dispositivo driver)obj, utilizzando il driver dello strumento MATLAB, driver. Il driver driver specificato deve essere un driver di strumento MATLAB IVI e il driver IVI sottostante deve essere referenziato utilizzando un nome logico.
obj = icdevice(___, costruisce un oggetto dispositivo Name,Value)obj utilizzando uno o più argomenti nome-valore oltre agli argomenti di input nelle sintassi precedenti. Gli argomenti nome-valore possono essere in qualsiasi formato supportato dalla funzione set: coppie di vettori di caratteri nome-valore, strutture e coppie di array di celle nome-valore. È anche possibile specificare i nomi delle proprietà senza fare distinzione tra maiuscole e minuscole e utilizzare il completamento del nome delle proprietà. Ad esempio, questi comandi sono tutti validi ed equivalenti:
d = icdevice('tektronix_tds210',g,'ObjectVisibility','on'); d = icdevice('tektronix_tds210',g,'objectvisibility','on'); d = icdevice('tektronix_tds210',g,'ObjectVis','on');
Nota
Quando si distribuisce codice utilizzando driver IVI-C o VXIplug&play, l'esecuzione del codice genererà file aggiuntivi nella cartella specificata eseguendo il seguente codice al prompt MATLAB:
fullfile(tempdir,'ICTDeploymentFiles',sprintf('R%s',version('-release')))
Su tutte le piattaforme supportate viene generato un file con il nome MATLABPrototypeFor<driverName>.m, dove <driverName> è il nome del driver IVI-C o VXIplug&play. Con MATLAB a 64 bit su Windows®, viene generato un secondo file con il nome <driverName>_thunk_pcwin64.dll. Quando crei l'applicazione distribuita o la libreria condivisa, includi manualmente questi file generati. Se si utilizza la funzione icdevice, ricordarsi di includere manualmente anche il file MDD nell'applicazione distribuita o nella libreria condivisa. Per ulteriori informazioni sull'inclusione di file aggiuntivi, fare riferimento alla documentazione MATLAB Compiler™.
Esempi
Suggerimenti
In qualsiasi momento è possibile utilizzare la funzione instrhelp per visualizzare un elenco completo delle proprietà e delle funzioni associate agli oggetti dispositivo.
instrhelp icdeviceQuando si crea un oggetto dispositivo, i seguenti valori delle proprietà vengono configurati automaticamente:
Interfacespecifica l'interfaccia utilizzata per comunicare con lo strumento. Per gli oggetti dispositivo creati utilizzando oggetti interfaccia, si tratta di quell'oggetto interfaccia. Per VXIplug&play e IVI-C, questo è l'handle di sessione per la sessione del driver. Per i driver dello strumento MATLAB, questo è l'handle all'interfaccia COM predefinita del driver.LogicalNameè un nome logico IVI. Per i conducenti non IVI è vuoto.Nameviene fornito concatenando il tipo di strumento con il nome del driver dello strumento.RsrcNameè il nome completo della risorsa VISA per i driver VXIplug&play e IVI. Per i driver dell'interfaccia MATLAB,RsrcNameè un vettore di caratteri vuoto.Typeè il tipo di strumento, se noto (ad esempio,scopeomultimeter).
Per comunicare con lo strumento, l'oggetto dispositivo deve essere connesso allo strumento tramite la funzione connect. Quando viene costruito l'oggetto dispositivo, la proprietà Status dell'oggetto è closed . Una volta che l'oggetto dispositivo è collegato allo strumento con la funzione connect, la proprietà Status viene configurata su open.
Nota
ICDEVICE non è in grado di aprire MDD con caratteri non ASCII nel nome o nel percorso sulle piattaforme Mac.
Nota
Per ottenere un elenco delle opzioni che è possibile utilizzare in una funzione, premere il tasto Tab dopo aver immesso una funzione sulla riga di comando MATLAB. L'elenco si espande ed è possibile scorrere per scegliere una proprietà o un valore. Per informazioni sull'utilizzo di questa funzionalità avanzata di completamento della scheda, vedere Using Tab Completion for Functions .
Cronologia versioni
Introduzione prima di R2006a