Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um das englische Original zu sehen.

aardvark

Total Phase Aardvark Adapterverbindung

Seit R2023a

alle in Seite erweitern

    Beschreibung

    Ein aardvark-Objekt repräsentiert eine Verbindung zu einem Total Phase® Aardvark I2C/SPI™-Hostadapter. An den Aardvark™-Controller können ein oder mehrere I2C-Peripheriegeräte angeschlossen werden. Um ein Peripheriegerät am Aardvark-Controller zu konfigurieren und mit ihm zu kommunizieren, müssen Sie zuerst ein aardvark-Objekt erstellen und dann die device-Funktion verwenden. Sie können mehrere Peripheriegeräte mit einem einzigen aardvark-Objekt verbinden. Das aardvark-Objekt in MATLAB® hat immer die I2C-Controller-Rolle und kann nicht in der Peripherie-Rolle verwendet werden.

    Hinweis

    Um die aardvark-Schnittstelle nutzen zu können, muss das Instrument Control Toolbox™-Supportpaket für die Total Phase Aardvark I2C/SPI-Schnittstelle installiert sein. Weitere Informationen finden Sie unter Install Instrument Control Toolbox Support Package for Total Phase Aardvark I2C/SPI Interface.

    Erstellung

    Syntax

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

    Beschreibung

    controller = aardvark(serialNumber) stellt eine Verbindung zum Total Phase Aardvark I2C/SPI Host-Adapter her, der durch die Seriennummer serialNumber angegeben ist. Die Seriennummer Ihres Aardvark-Controllers finden Sie durch Aufruf der Funktion aardvarklist.

    Der Eingang serialNumber legt die Eigenschaft SerialNumber fest.

    Beispiel

    controller = aardvark(serialNumber,Name=Value) stellt eine Verbindung zur Aardvark-Controllerplatine her und legt Eigenschaften mithilfe eines oder mehrerer Name-Wert-Argumente fest, wobei Name der Eigenschaftsname und Value der entsprechende Wert ist. Setzen Sie die Eigenschaften EnablePullupResistors und EnableTargetPower mithilfe von Name-Wert-Argumenten als Name1=Value1,...,NameN=ValueN, wobei Name der Eigenschaftsname und Value der entsprechende Wert ist. Name-Wert-Argumente müssen nach den anderen Argumenten stehen, die Reihenfolge der Argumente spielt jedoch keine Rolle.

    controller = aardvark versucht ohne Argumente eine Verbindung zum zuletzt erfolgreich verbundenen Aardvark-Controllerboard herzustellen. Falls Sie zuvor noch keine Verbindung zu einem Aardvark-Controller hergestellt haben, wird durch die Verwendung dieser Syntax eine Verbindung zum ersten verfügbaren Controller im aardvarklist-Ausgang hergestellt.

    Beispiel

    Eigenschaften

    alle erweitern

    Diese Eigenschaft ist schreibgeschützt.

    Controller-Board-Modell, angegeben als Total Phase Aardvark.

    Beispiel: controller.Model gibt das Modell Total Phase Aardvark zurück.

    Datentypen: string

    Diese Eigenschaft ist schreibgeschützt.

    Eindeutige numerische Kennung der Total Phase Aardvark-Controllerplatine, angegeben als Zeichenketten-Skalar. Diese Eigenschaft kann nur bei der Objekterstellung festgelegt werden.

    Beispiel: controller.SerialNumber gibt die eindeutige Kennung des Aardvark-Controllers zurück.

    Datentypen: string

    Seit R2024a

    Bezeichnung zur Identifizierung der Verbindung, angegeben als Zeichenkette. Verwenden Sie Tag, um einer Verbindung ein Label zuzuweisen, mit dem Sie später über aardvarkfind auf die Verbindung zugreifen können. Dies kann hilfreich sein, wenn Sie in einer Funktion eine Verbindung öffnen und in einer anderen Funktion Operationen an dieser Verbindung durchführen. Es ist auch nützlich, um Verbindungen in App-Callbacks zu lokalisieren und darauf zuzugreifen.

    Beispiel: controller.Tag = "pSupply"

    Datentypen: string

    Diese Eigenschaft ist schreibgeschützt.

    Digitale Pins, die am Aardvark-Controller verfügbar sind, angegeben als String-Array. Verbinden Sie Ihre I2C-Peripheriegeräte über diese Pins mit dem Controller. Eine Beschreibung der einzelnen Pins finden Sie in der Aardvark-Dokumentation. Konfigurieren und kommunizieren Sie mit diesen Pins über configureDigitalPin, readDigitalPin und writeDigitalPin.

    Beispiel: controller.AvailableDigitalPins gibt die digitalen Pins des Aardvark-Controllers zurück.

    Datentypen: string

    Diese Eigenschaft ist schreibgeschützt.

    Spannungspegel der Pins in Volt, angegeben als 3,3. Dies ist der einzig mögliche Spannungspegel der Pins am Aardvark-Controller.

    Beispiel: controller.VoltageLevel gibt den Spannungspegel der Aardvark Pins zurück.

    Datentypen: double

    Einstellung zum Aktivieren oder Deaktivieren interner Pullup-Widerstände für I2C-Leitungen, angegeben als numerischer oder logischer Wert 1 (true) oder 0 (false). Jede I2C-Leitung (SCL und SDA) verfügt über einen 2,2 kΩ Widerstand. Wenn sie aktiviert sind, werden sie auf 3,3 V hochgezogen, was zu einem Pullup-Strom von ungefähr 1,5 mA führt.

    Beispiel: controller.EnablePullupResistors = false deaktiviert interne Pullup-Widerstände.

    Datentypen: logical

    Einstellung zum Aktivieren der Zielstromversorgung an den Pins 4 und 6 des Aardvark-Controllers, angegeben als numerischer oder logischer Wert 1 (wahr) oder 0 (falsch).

    Beispiel: controller.EnableTargetPower = false deaktiviert die Zielstromversorgung an den Pins 4 und 6.

    Datentypen: logical

    Diese Eigenschaft ist schreibgeschützt.

    Betriebsmodi der digitalen Pins des Aardvark-Controllers, tabellarisch dargestellt. Die Tabelle enthält die Spalten Pin und Mode. Pin listet die durch AvailableDigitalPins spezifizierten digitalen Pins auf, und Mode listet den Pin-Modus jedes dieser Pins als input oder output auf.

    Wenn Sie ein aardvark-Objekt erstellen, sind alle Pins standardmäßig als Eingänge belegt. Ändern Sie die Pin-Modi mit configureDigitalPin. Mit readDigitalPin können Sie Logikwerte von den Eingangspins lesen und mit writeDigitalPin Logikpegelwerte an die Ausgangspins senden.

    Beispiel: controller.DigitalPinModes gibt eine Tabelle mit den Pin-Modi der digitalen Pins des Aardvark-Controllers zurück.

    Datentypen: table

    Objektfunktionen

    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

    Beispiele

    alle reduzieren

    Erkennen und verbinden Sie sich mit einer Total Phase Aardvark I2C/SPI Host-Adapter-Controllerkarte auf Ihrem Rechner.

    Verwenden Sie aardvarklist, um alle verfügbaren Total Phase Aardvark I2C/SPI Host-Adapter-Controllerkarten aufzulisten, die an Ihren Rechner angeschlossen sind.

    list = aardvarklist
    list = 

  1×2 table

                 Model             SerialNumber
         ______________________    ____________

    1    "Total Phase Aardvark"    "2239143731"

    Verwenden Sie den Wert von SerialNumber, um eine Verbindung zu Ihrem Aardvark herzustellen.

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

  Aardvark with properties:

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

    Sie können nun beliebige I2C-Peripheriegeräte am Aardvark-Controller mit der device-Funktion verbinden.

    Verbinden Sie sich mit einem Total Phase Aardvark I2C/SPI Host-Adapter und konfigurieren Sie die Pins daran.

    Stellen Sie eine Verbindung zum Total Phase Aardvark mithilfe seiner Seriennummer her. In diesem Beispiel hat die mit dem Computer verbundene Controllerplatine Aardvark die Seriennummer 2239143731.

    controller = aardvark("2239143731");

    Die verfügbaren digitalen Pins des Controllers und ihre jeweiligen Pin-Modi können Sie mit der Eigenschaft DigitalPinModes anzeigen.

    controller.DigitalPinModes
    ans =

  6×2 table

     Pin       Mode  
    ______    _______

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

    Konfigurieren Sie Pin 5 als Ausgang.

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

    Da Pin 5 ein Ausgangspin ist, können Sie ihm nun mit writeDigitalPin ein logisches High-Signal senden.

    Stellen Sie eine Verbindung zu einem Total Phase Aardvark I2C/SPI Host-Adapter her und suchen Sie nach daran angeschlossenen I2C-Peripheriegeräten.

    Stellen Sie eine Verbindung zum Total Phase Aardvark mithilfe seiner Seriennummer her. In diesem Beispiel hat die mit dem Computer verbundene Controllerplatine Aardvark die Seriennummer 2239143731.

    controller = aardvark("2239143731");

    Stellen Sie sicher, dass Ihre I2C-Peripheriegeräte physisch mit dem Controller verbunden sind. Suche nach angeschlossenen I2C-Peripheriegeräten. Die Funktion scanI2CBus gibt eine Liste der I2C-Adressen dieser Peripheriegeräte zurück.

    i2cAddresses = scanI2CBus(controller)
    i2cAddresses = 

  1×2 string array

    "0x38"    "0x50"

    In diesem Beispiel werden zwei Peripheriegeräte angeschlossen. Sie können nun mit Hilfe der Funktion device und einer der aufgelisteten I2C-Adressen eine Verbindung zu einem oder mehreren dieser Geräte herstellen. Die I2C-Adresse Ihres Peripheriegeräts finden Sie im Datenblatt.

    Wenn Sie aardvark in einem Skript oder in der MATLAB-Befehlszeile verwenden, wird eine Verbindung zu einem Aardvark-Controller hergestellt, der durch ein Objekt im MATLAB-Workspace repräsentiert wird.

    a1 = aardvark("2239143731")
    a1 = 

  Aardvark with properties:

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

    Wenn in anderen Variablen keine Verweise auf dieselbe Verbindung vorhanden sind, können Sie den Controller trennen, indem Sie die Workspace-Variable löschen.

    clear(a1)

    Verwenden Sie aardvarkfind, um zu bestätigen, dass die Verbindung geschlossen ist. 

    aardvarkfind
    ans =

     []

    Wenn Sie eine aardvark-Verbindung haben, die im MATLAB-Workspace existiert oder als Klassen- oder App-Eigenschaft gespeichert ist, ist das ardvark-Objekt möglicherweise in einer anderen Funktion oder einem anderen App-Callback nicht zugänglich. In diesem Fall können Sie aardvarkfind verwenden, um die Verbindung zu finden und zu löschen. 

    A = aardvarkfind
    A = 

  Aardvark with properties:

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

    Um diese Verbindung zu schließen, löschen Sie A.

    delete(A)

    Dieser Befehl löscht das aardvark-Objekt und trennt das Gerät. Wenn Sie die Verbindung zum Gerät wiederherstellen möchten, müssen Sie eine neue Verbindung mit aardvark herstellen.

    Nach dem Löschen bestätigt ein Aufruf von aardvarkfind, dass keine Verbindungen mehr bestehen.

    aardvarkfind
    ans =

     []

    Beachten Sie, dass die Variable A zwar noch im Workspace vorhanden ist, aber nun ein ungültiges Handle darstellt. 

    A
    A = 

  handle to deleted Aardvark

    Die Variable bleibt auch nach dem Löschen der Schnittstelle erhalten, da aardvark ein Handle-Objekt ist. (Weitere Informationen zu diesem Objekttyp finden Sie unter Handle Object Behavior.) Mit clear können Sie das ungültige Handle aus dem Workspace entfernen.

    clear A

    Versionsverlauf

    Eingeführt in R2023a

    alle erweitern

    Siehe auch

    | | | |

    Themen