Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la versión original en inglés.

aardvark

Conexión del adaptador Total Phase Aardvark

Desde R2023a

expandir todo en la página

    Descripción

    Un objeto aardvark representa una conexión a un adaptador de host Total Phase® Aardvark I2C/SPI™. El controlador Aardvark™ puede tener uno o más dispositivos periféricos I2C conectados. Para configurar y comunicarse con un dispositivo periférico en el controlador Aardvark, primero debe crear un objeto aardvark y luego usar la función device. Puede conectar varios dispositivos periféricos con un único objeto aardvark. El objeto aardvark en MATLAB® siempre tiene el rol de controlador I2C y no se puede utilizar en el rol de periférico.

    Nota

    Para utilizar la interfaz aardvark, debe tener instalado el paquete de soporte Instrument Control Toolbox™ para la interfaz de Total Phase Aardvark I2C/SPI. Para obtener más información, consulte la documentación Install Instrument Control Toolbox Support Package for Total Phase Aardvark I2C/SPI Interface.

    Creación

    Sintaxis

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

    Descripción

    controller = aardvark(serialNumber) crea una conexión con el adaptador de host Total Phase Aardvark I2C/SPI especificado por el número de serie serialNumber. Puede encontrar el número de serie de su controlador Aardvark llamando a la función aardvarklist.

    La entrada serialNumber establece la propiedad SerialNumber.

    ejemplo

    controller = aardvark(serialNumber,Name=Value) crea una conexión con la placa controladora Aardvark y establece propiedades utilizando uno o más argumentos nombre-valor, donde Name es el nombre de la propiedad y Value es el valor correspondiente. Establezca las propiedades EnablePullupResistors y EnableTargetPower utilizando argumentos nombre-valor como Name1=Value1,...,NameN=ValueN, donde Name es el nombre de la propiedad y Value es el valor correspondiente. Los argumentos de tipo nombre-valor deben aparecer después de los demás argumentos, pero el orden de los argumentos no importa.

    controller = aardvark, sin argumentos, intenta crear una conexión con la última placa controladora Aardvark que se conectó con éxito. Si no se ha conectado previamente a un controlador Aardvark, el uso de esta sintaxis crea una conexión con el primer controlador disponible en la salida aardvarklist.

    ejemplo

    Propiedades

    expandir todo

    Esta propiedad o parámetro es de solo lectura.

    Modelo de placa controladora, especificado como Total Phase Aardvark.

    Ejemplo: controller.Model devuelve el modelo Total Phase Aardvark.

    Tipos de datos: string

    Esta propiedad o parámetro es de solo lectura.

    Identificador numérico único de la placa controladora Total Phase Aardvark, especificado como un escalar de cadena. Esta propiedad solo se puede configurar cuando se crea el objeto.

    Ejemplo: controller.SerialNumber devuelve el identificador único del controlador Aardvark.

    Tipos de datos: string

    Desde R2024a

    Etiqueta para identificar la conexión, especificada como una cadena de caracteres. Utilice Tag para aplicar una etiqueta a una conexión que podrá usar posteriormente para acceder a la conexión mediante aardvarkfind. Esto puede resultar útil cuando se abre una conexión en una función y se utiliza otra función diferente para realizar operaciones en dicha conexión. También resulta útil para localizar y acceder a las conexiones en las funciones de callbacks de la app.

    Ejemplo: controller.Tag = "pSupply"

    Tipos de datos: string

    Esta propiedad o parámetro es de solo lectura.

    Pines digitales disponibles en el controlador Aardvark, especificados como un arreglo de cadenas. Conecte sus dispositivos periféricos I2C al controlador utilizando estos pines. Consulte la documentación de Aardvark para obtener una descripción de cada pin. Configure y comuníquese con estos pines usando configureDigitalPin, readDigitalPin y writeDigitalPin.

    Ejemplo: controller.AvailableDigitalPins devuelve los pines digitales del controlador Aardvark.

    Tipos de datos: string

    Esta propiedad o parámetro es de solo lectura.

    Nivel de tensión de los pines en voltios, especificado como 3.3. Este es el único nivel de tensión posible de los pines del controlador Aardvark.

    Ejemplo: controller.VoltageLevel devuelve el nivel de tensión de los pines Aardvark.

    Tipos de datos: double

    Configuración para habilitar o deshabilitar las resistencias pull-up internas para las líneas I2C, especificadas como un 1 numérico o lógico (true) o 0 (false). Cada línea I2C (SCL y SDA) tiene una resistencia de 2,2 kΩ. Cuando están habilitadas, se elevan a 3,3 V, lo que resulta en una corriente de subida de aproximadamente 1,5 mA.

    Ejemplo: controller.EnablePullupResistors = false desactiva las resistencias pull-up internas.

    Tipos de datos: logical

    Configuración para permitir la alimentación del objetivo en los pines 4 y 6 del controlador Aardvark, especificada como un 1 numérico o lógico (verdadero) o 0 (falso).

    Ejemplo: controller.EnableTargetPower = false desactiva la alimentación del dispositivo en los pines 4 y 6.

    Tipos de datos: logical

    Esta propiedad o parámetro es de solo lectura.

    Modos de los pines digitales del controlador Aardvark, especificados en una tabla. La tabla tiene las columnas Pin y Mode. Pin enumera los pines digitales especificados por AvailableDigitalPins y Mode enumera el modo de pin de cada uno de estos pines como input o output.

    Cuando cree un objeto aardvark, todos los pines son de entrada por defecto. Cambia los modos de los pines usando configureDigitalPin. Puede leer valores lógicos de los pines de entrada usando readDigitalPin y enviar valores de nivel lógico a los pines de salida usando writeDigitalPin.

    Ejemplo: controller.DigitalPinModes devuelve una tabla con los modos de los pines digitales del controlador Aardvark.

    Tipos de datos: table

    Funciones del objeto

    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

    Ejemplos

    contraer todo

    Descubra y conecte una placa controladora de adaptador de host Total Phase Aardvark I2C/SPI en su máquina.

    Utilice aardvarklist para listar todas las placas controladoras del adaptador de host Total Phase Aardvark I2C/SPI disponibles conectadas a su máquina.

    list = aardvarklist
    list = 

  1×2 table

                 Model             SerialNumber
         ______________________    ____________

    1    "Total Phase Aardvark"    "2239143731"

    Utilice el valor de SerialNumber para crear una conexión con su Aardvark.

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

  Aardvark with properties:

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

    Ahora puede conectarse a cualquier dispositivo periférico I2C en el controlador Aardvark utilizando la función device.

    Conéctese a un adaptador host Total Phase Aardvark I2C/SPI y configura los pines del mismo.

    Conéctese al Total Phase Aardvark utilizando su número de serie. En este ejemplo, la placa controladora Aardvark que está conectada al equipo tiene un número de serie 2239143731.

    controller = aardvark("2239143731");

    Visualice los pines digitales disponibles en el controlador y sus respectivos modos de pin utilizando la propiedad DigitalPinModes.

    controller.DigitalPinModes
    ans =

  6×2 table

     Pin       Mode  
    ______    _______

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

    Configure el pin 5 como salida.

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

    Dado que el pin 5 es un pin de salida, ahora puede enviarle un nivel lógico alto usando writeDigitalPin.

    Conéctese a un adaptador de host Total Phase Aardvark I2C/SPI y busque dispositivos periféricos I2C conectados al mismo.

    Conéctese al Total Phase Aardvark utilizando su número de serie. En este ejemplo, la placa controladora Aardvark que está conectada al equipo tiene un número de serie 2239143731.

    controller = aardvark("2239143731");

    Asegúrese de que sus dispositivos periféricos I2C estén conectados físicamente al controlador. Escanee en busca de dispositivos periféricos I2C conectados. La función scanI2CBus devuelve una lista de las direcciones I2C de estos dispositivos periféricos.

    i2cAddresses = scanI2CBus(controller)
    i2cAddresses = 

  1×2 string array

    "0x38"    "0x50"

    En este ejemplo, se conectan dos dispositivos periféricos. Ahora puede crear una conexión con uno o más de ellos utilizando la función device con una de las direcciones I2C listadas. Consulte la hoja de datos de su dispositivo periférico para determinar su dirección I2C.

    Cuando se utiliza aardvark en un script o en la línea de comandos de MATLAB, el resultado es una conexión a un controlador Aardvark, representado por un objeto en el área de trabajo MATLAB.

    a1 = aardvark("2239143731")
    a1 = 

  Aardvark with properties:

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

    Cuando no existan referencias a la misma conexión en otras variables, puede desconectar el controlador borrando la variable del área de trabajo.

    clear(a1)

    Utilice aardvarkfind para confirmar que la conexión está cerrada. 

    aardvarkfind
    ans =

     []

    Si tiene una conexión aardvark que existe en el área de trabajo MATLAB o se guarda como una propiedad de clase o propiedad de la app, es posible que el objeto ardvark no sea accesible en una función diferente o callback de la app. En este caso, puede usar aardvarkfind para encontrar y eliminar la conexión. 

    A = aardvarkfind
    A = 

  Aardvark with properties:

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

    Para cerrar esta conexión, elimine A.

    delete(A)

    Este comando elimina el objeto aardvark y desconecta el dispositivo. Si desea volver a conectarse al dispositivo, debe crear una nueva conexión con aardvark.

    Después de la eliminación, al llamar a aardvarkfind se confirma que no existen conexiones.

    aardvarkfind
    ans =

     []

    Tenga en cuenta que la variable A todavía está presente en el área de trabajo, pero ahora es un identificador no válido. 

    A
    A = 

  handle to deleted Aardvark

    La variable persiste después de la eliminación de la interfaz porque aardvark es un objeto manejador. (Para obtener más información sobre este tipo de objeto, consulte Comportamiento de los objetos de identificadores.) Puede usar clear para eliminar el identificador no válido del área de trabajo.

    clear A

    Historial de versiones

    Introducido en R2023a

    expandir todo

    Consulte también

    | | | |

    Temas