Main Content

writebinblock

Write one binblock of data to VISA resource

    Description

    writebinblock(v,data,datatype) writes a binblock of data in the form specified by datatype to the VISA resource v. The function suspends MATLAB® execution until the specified values are written to the remote host.

    example

    writebinblock(v,data,datatype,header) prefixes the ASCII string specified by header to the data that is sent.

    example

    Examples

    collapse all

    Create a connection to a VISA resource. This example shows a connection to a device with the alias COM4 using the VISA-Serial interface.

    v = visadev("COM4");

    Write the values [1,2,3,4,5] as a binblock in double format to the VISA resource v.

    writebinblock(v,1:5,"double")

    Define a VISA connection and header string.

    v = visadev("COM4");
    hdr = "MEMTEST 8-BIT";

    Write the header and data values [1,2,3,4,5] as a binblock in uint8 format to the VISA resource v.

    writebinblock(v,1:5,"uint8",hdr)

    Input Arguments

    collapse all

    VISA resource, specified as a visadev object.

    Example: writebinblock(v,1:5,"uint8") writes a binblock of data to the VISA resource v.

    Numeric or ASCII data, specified as a 1-by-N vector of numeric values, a character vector, or string of text. For all numeric datatype types, data is a row vector of values.

    Example: writebinblock(v,1:5,"uint8") writes the values [1,2,3,4,5].

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

    Size and format of each value, specified as a character vector or string. datatype determines the number of bytes to write for each value and the interpretation of those bytes as a MATLAB data type.

    Example: writebinblock(v,1:5,"double") writes the values [1,2,3,4,5] as double data.

    Data Types: char | string

    ASCII string prefixed to the data, specified as a string or character vector.

    Example: writebinblock(v,1:5,"double","Test 34.1") writes the header string "Test 34.1" followed by the values [1,2,3,4,5] as double data.

    Data Types: char | string

    Version History

    Introduced in R2021a

    expand all