readbinblock

Read one binblock of data from serial port

Syntax

data = readbinblock(device)

data = readbinblock(device,precision)

Description

data = readbinblock(device) reads a binblock of data from the serial port as uint8 numeric values and returns a 1-by-N array of doubles.

data = readbinblock(device,precision) reads a binblock of data interpreted as the type specified by precision. For numeric types, the data is returned as a 1-by-N array of doubles. For text types, the data is returned as character vector or string, as specified.

The function blocks MATLAB^® and waits until a binblock is read from the serial port.

The function discards and clears any data in the buffer before the recognized binblock. If no binblock is found the operation times out, returns an empty value, and discards all the data in the buffer. An error in the operation also flushes the data buffer.

Examples

Read Binblock of uint8 Data

Read a binblock of numeric uint8 data from the serial port.

The default precision is uint8.

s = serialport("COM3",9600);
data = readbinblock(s);

Read Binblock of uint16 Data

Read a binblock of numeric uint16 data from the serial port.

s = serialport("COM3",9600);
data = readbinblock(s,"uint16")

Input Arguments

device — Serial port

serialport object

Serial port, specified as a serialport object.

Example: serialport()

precision — Size and format of each value

'uint8' (default) | 'int8' | 'uint16' | 'int16' | 'uint32' | 'int32' | 'uint64' | 'int64' | 'single' | 'double' | 'char' | 'string'

Size and format of binblock data, specified as a character vector or string. precision determines the number of bits to read for each value and the interpretation of those bits as a MATLAB data type.

Example: 'int16'

Data Types: char | string

Output Arguments

data — Numeric or ASCII data

1-by-N double | string | char

Numeric or ASCII data, returned as a 1-by-N vector of doubles or text. For all numeric precision types, data is a row vector of double values. For the text type precision values of 'char' or 'string', data is of the specified type.

Version History

Introduced in R2019b