aardvark

Connexion à un adaptateur Total Phase Aardvark

Depuis R2023a

développer tous les éléments de la page

    Description

    Un objet aardvark représente une connexion à un adaptateur hôte Total Phase® Aardvark I2C/SPI™. Le contrôleur Aardvark™ peut être connecté à un ou plusieurs périphériques I2C. Pour configurer un périphérique sur le contrôleur Aardvark et communiquer avec lui, vous devez d’abord créer un objet aardvark, puis utiliser la fonction device. Vous pouvez vous connecter à plusieurs périphériques avec un seul objet aardvark. L’objet aardvark dans MATLAB® joue toujours le rôle de contrôleur I2C. Il ne peut pas jouer le rôle de périphérique.

    Remarque

    Pour utiliser l’interface aardvark, vous devez avoir installé Instrument Control Toolbox™ Support Package for Total Phase Aardvark I2C/SPI Interface. Pour plus d’informations, consultez Install Instrument Control Toolbox Support Package for Total Phase Aardvark I2C/SPI Interface.

    Création

    Syntaxe

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

    Description

    controller = aardvark(serialNumber) crée une connexion à l’adaptateur hôte Total Phase Aardvark I2C/SPI spécifié par le numéro de série serialNumber. Pour connaître le numéro de série de votre contrôleur Aardvark, vous pouvez appeler la fonction aardvarklist.

    L’entrée serialNumber définit la propriété SerialNumber.

    exemple

    controller = aardvark(serialNumber,Name=Value) permet de créer une connexion à la carte contrôleur Aardvark et de définir les propriétés avec un ou plusieurs arguments nom-valeur, où Name est le nom de la propriété et Value est la valeur correspondante. Définissez les propriétés EnablePullupResistors et EnableTargetPower avec des arguments nom-valeur sous la forme Name1=Value1,...,NameN=ValueN, où Name est le nom de la propriété et Value est la valeur correspondante. Les arguments nom-valeur doivent figurer après les autres arguments, mais leur ordre n’a pas d’importance.

    Utilisé sans arguments, controller = aardvark tente de créer une connexion à la dernière carte contrôleur Aardvark connectée avec succès. Si c’est la première fois que vous vous connectez à un contrôleur Aardvark, cette syntaxe crée une connexion au premier contrôleur disponible dans la sortie de aardvarklist.

    exemple

    Propriétés

    développer tout

    Ce propriété est en lecture seule.

    Modèle de carte contrôleur, spécifié en tant que Total Phase Aardvark.

    Exemple : controller.Model renvoie le modèle Total Phase Aardvark.

    Types de données : string

    Ce propriété est en lecture seule.

    Identifiant numérique unique de la carte contrôleur Total Phase Aardvark, spécifié sous forme de string scalar. Cette propriété ne peut être définie qu’au moment de la création de l’objet.

    Exemple : controller.SerialNumber renvoie l’identifiant unique du contrôleur Aardvark.

    Types de données : string

    Depuis R2024a

    Étiquette permettant d’identifier la connexion, spécifiée sous forme de chaîne de caractères. Utilisez Tag pour appliquer une étiquette à une connexion. Vous pourrez ensuite l’utiliser pour accéder à cette connexion avec aardvarkfind. Une étiquette peut être utile si vous ouvrez une connexion dans une fonction et utilisez une autre fonction pour effectuer des opérations sur cette connexion. Elle est également utile pour localiser les connexions et y accéder dans des callbacks d’application.

    Exemple : controller.Tag = "pSupply"

    Types de données : string

    Ce propriété est en lecture seule.

    Broches numériques disponibles sur le contrôleur Aardvark, spécifiées sous forme de tableau de chaînes de caractères. Utilisez ces broches pour connecter vos périphériques I2C au contrôleur. Pour une description de chaque broche, consultez la documentation Aardvark. Pour configurer ces broches et communiquer avec elles, utilisez configureDigitalPin, readDigitalPin et writeDigitalPin.

    Exemple : controller.AvailableDigitalPins renvoie les broches numériques du contrôleur Aardvark.

    Types de données : string

    Ce propriété est en lecture seule.

    Tension des broches en volts, spécifiée à 3.3. Il s’agit de la seule tension possible pour les broches du contrôleur Aardvark.

    Exemple : controller.VoltageLevel renvoie la tension des broches Aardvark.

    Types de données : double

    Paramètre permettant d’activer ou de désactiver les résistances de tirage internes pour les lignes I2C, spécifié sous forme de 1 (true) ou 0 (false) numérique ou logique. Chaque ligne I2C (SCL et SDA) comporte une résistance de 2,2 kΩ. Lorsque les résistances sont activées, les lignes sont tirées à 3,3 V, donnant ainsi un courant de tirage d’environ 1,5 mA.

    Exemple : controller.EnablePullupResistors = false désactive les résistances de tirage internes.

    Types de données : logical

    Paramètre permettant d’autoriser la puissance cible sur les broches 4 et 6 du contrôleur Aardvark, spécifié sous forme de 1 (true) ou 0 (false) numérique ou logique.

    Exemple : controller.EnableTargetPower = false désactive la puissance cible sur les broches 4 et 6.

    Types de données : logical

    Ce propriété est en lecture seule.

    Modes des broches numériques du contrôleur Aardvark, spécifiés sous forme de table. La table contient les colonnes Pin et Mode. Pin répertorie les broches numériques spécifiées par AvailableDigitalPins. Mode indique le mode de chacune de ces broches comme étant input (entrée) ou output (sortie).

    Lorsque vous créez un objet aardvark, toutes les broches sont des entrées par défaut. Pour modifier les modes des broches, utilisez configureDigitalPin. Vous pouvez lire des valeurs logiques à partir des broches d’entrée avec readDigitalPin et envoyer des valeurs de niveau logique aux broches de sortie avec writeDigitalPin.

    Exemple : controller.DigitalPinModes renvoie une table contenant les modes des broches numériques du contrôleur Aardvark.

    Types de données : table

    Fonctions d'objet

    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

    Exemples

    réduire tout

    Détectez et connectez une carte contrôleur d’adaptateur hôte Total Phase Aardvark I2C/SPI sur votre machine.

    Utilisez aardvarklist pour obtenir la liste de toutes les cartes contrôleurs d’adaptateur hôte Total Phase Aardvark I2C/SPI connectées à votre machine.

    list = aardvarklist
    list = 

  1×2 table

                 Model             SerialNumber
         ______________________    ____________

    1    "Total Phase Aardvark"    "2239143731"

    Utilisez la valeur de SerialNumber pour créer une connexion à votre carte Aardvark.

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

  Aardvark with properties:

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

    Vous pouvez maintenant connecter un ou plusieurs périphériques I2C au contrôleur Aardvark avec la fonction device.

    Connectez-vous à un adaptateur hôte Total Phase Aardvark I2C/SPI et configurez ses broches.

    Connectez-vous à la carte Total Phase Aardvark à l’aide de son numéro de série. Dans cet exemple, la carte contrôleur Aardvark connectée à l’ordinateur a le numéro de série 2239143731.

    controller = aardvark("2239143731");

    Affichez les broches numériques disponibles sur le contrôleur et leurs modes respectifs avec la propriété DigitalPinModes.

    controller.DigitalPinModes
    ans =

  6×2 table

     Pin       Mode  
    ______    _______

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

    Configurez la broche 5 en tant que sortie.

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

    Comme la broche 5 est une broche de sortie, vous pouvez maintenant lui envoyer un niveau logique haut avec writeDigitalPin.

    Connectez-vous à un adaptateur hôte Total Phase Aardvark I2C/SPI et recherchez les périphériques I2C connectés à celui-ci.

    Connectez-vous à la carte Total Phase Aardvark à l’aide de son numéro de série. Dans cet exemple, la carte contrôleur Aardvark connectée à l’ordinateur a le numéro de série 2239143731.

    controller = aardvark("2239143731");

    Assurez-vous que vos périphériques I2C sont physiquement connectés au contrôleur. Recherchez les périphériques I2C connectés. La fonction scanI2CBus renvoie la liste des adresses I2C de ces périphériques.

    i2cAddresses = scanI2CBus(controller)
    i2cAddresses = 

  1×2 string array

    "0x38"    "0x50"

    Dans cet exemple, deux périphériques sont connectés. Vous pouvez maintenant créer une connexion à un ou plusieurs d’entre eux en utilisant la fonction device avec l’une des adresses I2C répertoriées. Consultez la fiche technique de votre périphérique pour déterminer son adresse I2C.

    Lorsque vous utilisez aardvark dans un script ou depuis la ligne de commande MATLAB, vous obtenez une connexion à un contrôleur Aardvark représentée par un objet dans l’espace de travail MATLAB.

    a1 = aardvark("2239143731")
    a1 = 

  Aardvark with properties:

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

    Lorsqu’il n’existe aucune référence à cette même connexion dans les autres variables, vous pouvez déconnecter le contrôleur en effaçant la variable de l’espace de travail.

    clear(a1)

    Utilisez aardvarkfind pour confirmer que la connexion est fermée. 

    aardvarkfind
    ans =

     []

    Lorsqu’une connexion aardvark existe dans l’espace de travail MATLAB ou qu’elle est enregistrée en tant que propriété de classe ou d’application, il se peut que l’objet ardvark ne soit pas accessible dans une autre fonction ou un autre callback d’application. Dans ce cas, vous pouvez utiliser aardvarkfind pour rechercher et supprimer la connexion. 

    A = aardvarkfind
    A = 

  Aardvark with properties:

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

    Pour fermer cette connexion, supprimez A.

    delete(A)

    Cette commande supprime l’objet aardvark et déconnecte le dispositif. Si vous souhaitez vous reconnecter au dispositif, vous devez créer une nouvelle connexion avec aardvark.

    Après la suppression, l’appel de aardvarkfind confirme qu’il n’existe aucune connexion.

    aardvarkfind
    ans =

     []

    Notez que la variable A est toujours présente dans l’espace de travail, mais que c’est désormais un handle non valide. 

    A
    A = 

  handle to deleted Aardvark

    La variable est conservée après la suppression de l’interface, car aardvark est un objet de type handle. (Pour plus d’informations sur ce type d’objet, consultez Handle Object Behavior.) Vous pouvez utiliser clear pour supprimer le handle non valide de l’espace de travail.

    clear A

    Historique des versions

    Introduit dans R2023a

    développer tout

    Voir aussi

    | | | |

    Rubriques