readbinblock

Read one binblock of data from serial port

Since R2019b

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.

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