Main Content

invoke

Execute driver-specific function on device object

Syntax

out = invoke(obj,'name')
out = invoke(obj,'name',arg1,arg2,...)

Arguments

obj

A device object.

name

The function to execute.

arg1,arg2,...

Arguments passed to name.

out

The function output.

Description

out = invoke(obj,'name') executes the function specified by name on the device object specified by obj. The function's output is returned to out.

out = invoke(obj,'name',arg1,arg2,...) passes the arguments arg1,arg2,... to the function specified by name.

Examples

Create a device object for a Tektronix® TDS 210 oscilloscope that is connected to a National Instruments™ GPIB board.

g = gpib('ni',0,2);
d = icdevice('tektronix_tds210',g);

Perform a self-calibration for the oscilloscope by invoking the calibrate function.

out = invoke(d,'calibrate')
out = 
    '0'

0 indicates that the self-calibration completed without any errors.

Tips

To list the driver-specific functions supported by obj, type

methods(obj)

To display help for a specific function, type

instrhelp(obj,'name')

Version History

Introduced before R2006a

See Also