Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

icdevice

Crea oggetto dispositivo

espandi tutto nella pagina

    Descrizione

    Utilizzare icdevice per creare un oggetto dispositivo MATLAB®.

    Creazione

    Sintassi

    obj = icdevice(driver,hwobj)
    obj = icdevice(driver,rsrcname)
    obj = icdevice(driver)
    obj = icdevice(___,Name,Value)

    Descrizione

    obj = icdevice(driver,hwobj) crea l'oggetto dispositivo 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.

    esempio

    obj = icdevice(driver,rsrcname) crea un oggetto dispositivo 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.

    esempio

    obj = icdevice(driver) costruisce un oggetto dispositivo 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(___,Name,Value) costruisce un oggetto dispositivo 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

    comprimi tutto

    Creare un oggetto dispositivo per un oscilloscopio TDS 210 Tektronix® collegato a una scheda MCC GPIB, utilizzando un oggetto interfaccia MATLAB e un driver strumento interfaccia MATLAB.

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

    Connettersi allo strumento.

    connect(d);

    Elenca le impostazioni dell'oscilloscopio che possono essere configurate.

    props = set(d);

    Ottieni la configurazione corrente dell'oscilloscopio.

    values = get(d);

    Scollegare dallo strumento e pulire.

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

    Crea un oggetto dispositivo per un oscilloscopio Tektronix TDS 210 utilizzando un driver di strumento MATLAB VXIplug&play.

    Questo esempio presuppone che sul sistema sia installato il driver 'tktds5k' VXIplug&play.

    Questo primo passaggio è necessario solo se sul sistema non è presente un driver dello strumento MATLAB VXIplug&play per tktds5k.

    makemid('tktds5k','Tktds5kMATLABDriver');

    Costruisci un oggetto dispositivo che utilizzi il driver VXIplug&play. Si suppone che lo strumento sia posizionato all'indirizzo primario GPIB 2.

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

    Connettersi allo strumento.

    connect(d);

    Elenca le impostazioni dell'oscilloscopio che possono essere configurate.

    props = set(d);

    Ottieni la configurazione corrente dell'oscilloscopio.

    values = get(d);

    Scollegare dallo strumento e pulire.

    disconnect(d);
delete(d);

    Suggerimenti

    In qualsiasi momento è possibile utilizzare la funzione instrhelp per visualizzare un elenco completo delle proprietà e delle funzioni associate agli oggetti dispositivo.

    instrhelp icdevice

    Quando si crea un oggetto dispositivo, i seguenti valori delle proprietà vengono configurati automaticamente:

    • Interface specifica 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.

    • Name viene 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, scope o multimeter).

    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

    Vedi anche

    |