Instrument Control Toolbox

binblockwrite

Write binblock data to the instrument

Syntax

• binblockwrite(obj,A)
  binblockwrite(obj,A,'precision')
  

Arguments

obj	An instrument object.
A	The data to be written using the binblock format.
'precision'	The number of bits written for each value, and the interpretation of the bits as character, integer, or floating-point values.

Description

binblockwrite(obj,A) writes the data specified by A to the instrument connected to obj as a binary-block (binblock). The binblock format is defined as #<N><D><A> where

• N specifies the number of digits D that follow.
• D specifies the number of data bytes A that follow.
• A is the data written to the instrument.

For example, if A is given by [0 5 5 0 5 5 0], the binblock would be defined as [double('#') 1 7 0 5 5 0 5 5 0].

binblockwrite(obj,A,'precision') writes binblock data translating MATLAB values to the precision specified by precision. By default the uchar precision is used. Refer to the fwrite function for a list of supported precisions.

Remarks

Before you can write data to the instrument, it must be connected to obj with the fopen function. A connected instrument object has a Status property value of open. An error is returned if you attempt to perform a write operation while obj is not connected to the instrument.

The ValuesSent property value is increased by the number of values written each time binblockwrite is issued.

An error occurs if the output buffer cannot hold all the data to be written. You can specify the size of the output buffer with the OutputBufferSize property.

Example

Create the GPIB object g associated with a National Instruments GPIB controller with board index 0, and a Tektronix TDS 210 oscilloscope with primary address 2.

• g = gpib('ni',0,2);
  g.OutputBufferSize = 3000;
  

Connect g to the instrument, and write string commands that configure the scope to transfer binary waveform data to memory location A.

• fopen(g)
  fprintf(g,'DATA:DESTINATION REFA');
  fprintf(g,'DATA:ENCDG SRPbinary');
  fprintf(g,'DATA:WIDTH 1');
  fprintf(g,'DATA:START 1');
  

Create the waveform data.

• t = linspace(0,25,2500);
  data = round(sin(t)*90 + 127);
  

Write the binblock data to the scope.

• cmd = double('CURVE #42500');
  binblockwrite(g,[cmd data])
  

See Also

Functions

binblockread, fopen, fwrite, instrhelp

Properties

OutputBufferSize, OutputEmptyFcn, Status, Timeout, TransferStatus, ValuesSent

binblockread

clear