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

read

Leer datos del puerto serie

contraer todo en la página

Sintaxis

data = read(device,count,datatype)

Descripción

data = read(device,count,datatype) lee la cantidad de valores especificados por count en el formato especificado por datatype desde la conexión del puerto serie device. Para todos los tipos numéricos datatype, data es un vector fila de valores double. Para los valores del tipo de texto datatype de "char" o "string", data es del tipo especificado. La función suspende la ejecución de MATLAB® hasta que se lea el número de valores especificado o se produzca un tiempo de espera agotado.

ejemplo

Ejemplos

contraer todo

Cree una conexión a un dispositivo con puerto serie. En este ejemplo, el puerto serie COM3 está conectado a un dispositivo de bucle invertido.

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

Escriba los valores [1,2,3,4,5] en formato uint8.

write(device,1:5,"uint8")

Dado que el puerto está conectado a un dispositivo de bucle invertido, los datos que escriba en el dispositivo se devolverán a MATLAB. Lee todos los datos.

read(device,5,"uint8")
ans = 1×5

     1     2     3     4     5

Argumentos de entrada

contraer todo

Conexión de puerto serie, especificada como un objeto serialport.

Ejemplo: read(device,20,"uint32") lee datos de la conexión del puerto serie device.

Número de valores a leer, especificado como un número entero positivo. Si count es mayor que la propiedad NumBytesAvailable de device, la función suspende la ejecución de MATLAB y espera hasta que se lea la cantidad de datos especificada o se produzca un tiempo de espera.

Ejemplo: read(device,5,"uint32") lee cinco valores de datos uint32. Cada valor uint32 ocupa cuatro bytes, lo que da un total de 20 bytes leídos.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Tamaño y formato de cada valor, especificado como un vector de caracteres o una cadena. datatype determina el número de bytes a leer para cada valor y la interpretación de esos bytes como un tipo de datos MATLAB.

Ejemplo: read(device,5,"uint16") lee cinco valores de datos uint16. Cada valor uint16 ocupa dos bytes, lo que da un total de 10 bytes leídos.

Tipos de datos: char | string

Historial de versiones

Introducido en R2019b

Consulte también

Funciones