Instrument Control Toolbox 2.9

Device Object Groups

Contents

Group Objects

Device objects may contain properties defined as group objects. Group objects are similar to device objects in that they have properties and functions. A group object typically represents a specific area of functionality for the instrument, such as triggering. A device object property may also contain an array of group objects, representing, for example, a set of channels on an oscilloscope.

Using Group Objects

Group objects are referenced in the same manner as other properties. First, create a device object.

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

Next, use the GET function. In this example, the device object has a property 'Trigger' that contains the trigger group.

t = get(d, 'Trigger')

   HwIndex:    HwName:     Type:            Name:
   1           Trigger1    scope-trigger    Trigger1

get(t)

    HwIndex = 1
    HwName = Trigger1
    Name = Trigger1
    Parent = [1x1 icdevice]
    Type = scope-trigger

    SCOPE-TRIGGER specific properties:
    Coupling = dc
    Holdoff = 5e-007
    Level = 0
    Mode = normal
    Slope = rising
    Source = channel1
    State = armed
    TriggerType = edge
    VideoPolarity = normal
    VideoSource = channel1
    VideoSync = field

Group object functions can be invoked in the same manner as device object functions. See Invoking Device Objects Functions for information on invoking functions.