Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

aardvark

Connessione dell'adattatore Total Phase Aardvark

Da R2023a

espandi tutto nella pagina

    Descrizione

    Un oggetto aardvark rappresenta una connessione a un adattatore host Total Phase® Aardvark I2C/SPI™. Il controller Aardvark™ può avere uno o più dispositivi periferici I2C collegati a questo. Per configurare e comunicare con un dispositivo periferico sul controller Aardvark, è necessario prima creare un oggetto aardvark e quindi utilizzare la funzione device. È possibile connettersi a più dispositivi periferici con un singolo oggetto aardvark. L'oggetto aardvark in MATLAB® ha sempre il ruolo di controller I2C e non può essere utilizzato nel ruolo di periferica.

    Nota

    Per utilizzare l'interfaccia aardvark, è necessario che sia installato il Pacchetto di supporto Instrument Control Toolbox™ per l'interfaccia Total Phase Aardvark I2C/SPI. Per ulteriori informazioni, consultare Install Instrument Control Toolbox Support Package for Total Phase Aardvark I2C/SPI Interface.

    Creazione

    Sintassi

    controller = aardvark(serialNumber)
    controller = aardvark(serialNumber,Name=Value)
    controller = aardvark

    Descrizione

    controller = aardvark(serialNumber) crea una connessione all'adattatore host Total Phase Aardvark I2C/SPI specificato dal numero di serie serialNumber. È possibile trovare il numero di serie del controller Aardvark richiamando la funzione aardvarklist.

    L'input serialNumber imposta la proprietà SerialNumber.

    esempio

    controller = aardvark(serialNumber,Name=Value) crea una connessione alla scheda controller Aardvark e imposta le proprietà utilizzando uno o più argomenti nome-valore, dove Name è il nome della proprietà e Value è il valore corrispondente. Imposta le proprietà EnablePullupResistors e EnableTargetPower utilizzando argomenti nome-valore come Name1=Value1,...,NameN=ValueN, dove Name è il nome della proprietà e Value è il valore corrispondente. Gli argomenti nome-valore devono comparire dopo gli altri argomenti, ma l'ordine degli argomenti non è importante.

    controller = aardvark, senza argomenti, tenta di stabilire una connessione con l'ultima scheda controller Aardvark a cui si è connesso con successo. Se non ti sei precedentemente connesso a un controller Aardvark, l'utilizzo di questa sintassi crea una connessione al primo controller disponibile nell'output aardvarklist.

    esempio

    Proprietà

    espandi tutto

    proprietà è di sola lettura.

    Modello della scheda di controllo, specificato come Total Phase Aardvark.

    Esempio controller.Model restituisce il modello Total Phase Aardvark.

    Tipi di dati: string

    proprietà è di sola lettura.

    Identificativo numerico univoco della scheda controller Total Phase Aardvark, specificato come stringa scalare. Questa proprietà può essere impostata solo al momento della creazione dell'oggetto.

    Esempio controller.SerialNumber restituisce l'identificativo univoco del controller Aardvark.

    Tipi di dati: string

    Da R2024a

    Etichetta per identificare la connessione, specificata come stringa. Utilizza Tag per applicare un'etichetta a una connessione, che potrai poi usare per accedere alla connessione tramite aardvarkfind. Questo può essere utile quando si apre una connessione in una funzione e si utilizza un'altra funzione per eseguire operazioni su tale connessione. È utile anche per individuare e accedere alle connessioni nei callback dell’applicazione.

    Esempio controller.Tag = "pSupply"

    Tipi di dati: string

    proprietà è di sola lettura.

    Pin digitali disponibili sul controller Aardvark, specificati come array di stringhe. Collega i tuoi dispositivi periferici I2C al controller utilizzando questi pin. Per una descrizione di ciascun pin, fare riferimento alla documentazione Aardvark. Configura e comunica con questi pin utilizzando configureDigitalPin, readDigitalPin e writeDigitalPin.

    Esempio controller.AvailableDigitalPins restituisce i pin digitali del controller Aardvark.

    Tipi di dati: string

    proprietà è di sola lettura.

    Livello di tensione dei pin in volt, specificato come 3.3. Questo è l'unico livello di tensione possibile per i pin del controller Aardvark.

    Esempio controller.VoltageLevel restituisce il livello di tensione dei pin Aardvark.

    Tipi di dati: double

    Impostazione per abilitare o disabilitare le resistenze di pull-up interne per le linee I2C, specificata come valore numerico o logico 1 (true) o 0 (false). Ciascuna linea I2C (SCL e SDA) ha una resistenza da 2,2 kΩ. Quando abilitati, vengono portati a 3,3 V, generando una corrente di pull-up di circa 1,5 mA.

    Esempio controller.EnablePullupResistors = false disabilita le resistenze di pull-up interne.

    Tipi di dati: logical

    Impostazione per consentire l'alimentazione del target sui pin 4 e 6 del controller Aardvark, specificata come valore numerico o logico 1 (vero) o 0 (falso).

    Esempio controller.EnableTargetPower = false disabilita l'alimentazione del target sui pin 4 e 6.

    Tipi di dati: logical

    proprietà è di sola lettura.

    Modalità dei pin digitali del controller Aardvark, specificate in una tabella. La tabella contiene le colonne Pin e Mode. Pin elenca i pin digitali specificati da AvailableDigitalPins e Mode elenca la modalità di ciascuno di questi pin come input o output.

    Quando si crea un oggetto aardvark, tutti i pin sono impostati come input per impostazione predefinita. Modifica le modalità dei pin utilizzando configureDigitalPin. È possibile leggere i valori logici dai pin di input utilizzando readDigitalPin e inviare valori di livello logico ai pin di output utilizzando writeDigitalPin.

    Esempio controller.DigitalPinModes restituisce una tabella con le modalità dei pin digitali sul controller Aardvark.

    Tipi di dati: table

    Funzioni oggetto

    configureDigitalPinSet digital pin mode on controller
    readDigitalPinRead logic level value of digital pin on controller
    writeDigitalPinWrite logic level value to digital pin on controller
    scanI2CBusScan for I2C peripheral devices connected to controller board

    Esempi

    comprimi tutto

    Individua e connettiti a una scheda controller dell’adattatore host Total Phase Aardvark I2C/SPI sulla tua macchina.

    Utilizzare aardvarklist per elencare tutte le schede controller dell'adattatore host Total Phase Aardvark I2C/SPI disponibili collegate alla macchina.

    list = aardvarklist
    list = 

  1×2 table

                 Model             SerialNumber
         ______________________    ____________

    1    "Total Phase Aardvark"    "2239143731"

    Utilizza il valore di SerialNumber per creare una connessione al tuo Aardvark.

    controller = aardvark(list.SerialNumber(1))
    controller = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

    Ora è possibile connettersi a qualsiasi dispositivo periferico I2C sul controller Aardvark utilizzando la funzione device.

    Collegati a un adattatore host Total Phase Aardvark I2C/SPI e configuraci i pin.

    Collegati al dispositivo Total Phase Aardvark utilizzando il suo numero di serie. In questo esempio, la scheda di controllo Aardvark collegata al computer ha il numero di serie 2239143731.

    controller = aardvark("2239143731");

    Visualizza i pin digitali disponibili sul controller e le rispettive modalità dei pin utilizzando la proprietà DigitalPinModes.

    controller.DigitalPinModes
    ans =

  6×2 table

     Pin       Mode  
    ______    _______

    "Pin1"    "input"
    "Pin3"    "input"
    "Pin5"    "input"
    "Pin7"    "input"
    "Pin8"    "input"
    "Pin9"    "input"

    Configurare il pin 5 come output.

    configureDigitalPin(controller,"Pin5","output")

    Poiché il pin 5 è un pin di output, ora è possibile inviargli un livello logico alto utilizzando writeDigitalPin.

    Collegati a un adattatore host Total Phase Aardvark I2C/SPI ed esegui una scansione per rilevare i dispositivi periferici I2C collegati.

    Collegati al dispositivo Total Phase Aardvark utilizzando il suo numero di serie. In questo esempio, la scheda di controllo Aardvark collegata al computer ha il numero di serie 2239143731.

    controller = aardvark("2239143731");

    Assicurati che i tuoi dispositivi periferici I2C siano fisicamente collegati al controller. Ricerca dispositivi periferici I2C connessi. La funzione scanI2CBus restituisce un elenco degli indirizzi I2C di questi dispositivi periferici.

    i2cAddresses = scanI2CBus(controller)
    i2cAddresses = 

  1×2 string array

    "0x38"    "0x50"

    In questo esempio, sono collegati due dispositivi periferici. Ora è possibile creare una connessione a uno o più di essi utilizzando la funzione device con uno degli indirizzi I2C elencati. Consulta la scheda tecnica del tuo dispositivo periferico per determinarne l'indirizzo I2C.

    Quando si utilizza aardvark in uno script o nella riga di comando MATLAB, il risultato è una connessione a un controller Aardvark, rappresentato da un oggetto nell'area di lavoro MATLAB.

    a1 = aardvark("2239143731")
    a1 = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
                     Tag: "" 
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

    Quando non esistono riferimenti alla stessa connessione in altre variabili, è possibile disconnettere il controller cancellando la variabile dell'area di lavoro.

    clear(a1)

    Utilizzare aardvarkfind per confermare la chiusura della connessione. 

    aardvarkfind
    ans =

     []

    Quando si dispone di una connessione aardvark che esiste nell'area di lavoro MATLAB o è salvata come proprietà di classe o proprietà applicazione , l'oggetto ardvark potrebbe non essere accessibile in una funzione diversa o in una callback applicazione . In questo caso, puoi usare aardvarkfind per trovare ed eliminare la connessione. 

    A = aardvarkfind
    A = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
                     Tag: ""
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

    Per chiudere questa connessione, elimina A.

    delete(A)

    Questo comando elimina l'oggetto aardvark e disconnette il dispositivo. Se desideri riconnetterti al dispositivo, devi creare una nuova connessione con aardvark.

    Dopo l’eliminazione, la chiamata a aardvarkfind conferma che non sono presenti connessioni esistenti.

    aardvarkfind
    ans =

     []

    Si noti che la variabile A è ancora presente nell'area di lavoro, ma ora è un handle non valido. 

    A
    A = 

  handle to deleted Aardvark

    La variabile persiste dopo l'eliminazione dell'interfaccia perché aardvark è un oggetto handle. (Per ulteriori informazioni su questo tipo di oggetto, vedere Handle Object Behavior.) È possibile utilizzare clear per rimuovere l'handle non valido dall'area di lavoro.

    clear A

    Cronologia versioni

    Introdotto in R2023a

    espandi tutto

    Vedi anche

    | | | |

    Argomenti