主要内容

属性

属性:概述

您可以通过设备对象进行仪器的编程更轻松,更加一致,使用属性。属性可用于查询或设置仪器设置或属性。例如,可以使用调用的属性来控制示波器的触发级别Trigerlevel.,您可以用它读或控制得到功能。即使两个不同的范围有不同的触发语法,您也可以使用相同的属性名称,Trigerlevel.,来控制它们,因为每个范围都有自己的仪器驱动程序。

属性的另一个优点是,您可以使用某些可接受的值(枚举)或限制(绑定)来定义它们,或者可以在将相关命令发送到仪器之前检查。

物业组件

属性的行为由以下组件定义。

设置代码

代码定义在配置属性时执行的代码功能。这代码可以定义为将写入仪器的仪器命令,或者它可以定义为matlab®软件代码。

如果是代码是MATLAB代码,它可以包括任意数量的命令或MATLAB软件代码包装仪器命令,以提供额外的处理或分析。

如果是代码被定义为乐器命令,然后写入仪器的命令将是仪器命令,其耦合的空格和呼叫中指定的值.例如,代码DisplayContrast属性定义为仪器命令显示:对比.当。。。的时候评估下面的功能,发送给仪器的仪器命令将是显示:对比度54

集(obj,“DisplayContrast”,54);

获取代码

得到代码定义在查询属性值时执行的代码得到功能。这得到代码可以定义为将写入仪器的仪器命令,或者可以定义为Matlab软件代码。

笔记

用于您的物业的代码得到代码和代码不能包含对此的呼叫fclose.打开外部文件用于访问仪器的接口对象上的函数。

接受财产价值

您可以定义该属性可以设置为使唯一有效的值写入到仪器和前一个无效的值可以被写入仪器将返回错误的值。

  • 属性值可以定义为双重,字符向量或布尔值。

  • 可以限制定义为双倍的属性值仅接受某个范围内的双打或枚举双打列表。例如,可以定义属性以接受在范围内的双倍[0 10]或者可以定义一个属性来接受其中一个值(1、7、8、10)

  • 可以将定义为字符向量的属性值限制为接受枚举字符向量列表。例如,可以定义一个属性来接受字符向量最小值最大限度

此外,可以定义属性以接受多个属性值定义。例如,可以定义一个属性以接受两者之间的双重范围[0 10]或者是字符向量最小值最大限度

属性值的依赖关系

属性值可以取决于另一个属性的值。例如,在控制电源,属性VoltageLevel可以配置为以下值:

  • 当属性的值在0到10之间时的双精度值电压outputrange.

  • 0到5之间的双重范围在物业的价值时电压outputrange.低的

什么时候VoltageLevel配置了,值电压outputrange.查询。如果电压outputrange., 然后VoltageLevel可以配置为0到10之间的双重范围如果值电压outputrange.低的, 然后VoltageLevel可以配置为0到5之间的双重范围。

默认值

属性的默认值是创建对象时属性配置为的值。

只读价值

属性的只读值定义了何时可以配置属性。下面描述有效的选项。

只读价值

描述

从来没有

可以随时配置该物业功能。

而开放

该属性只能配置设备对象未连接到仪器时功能。设备对象与仪器断开连接断开功能。

总是

属性不能配置功能。

帮助文本

帮助文本提供有关该属性的信息。此信息已返回instrhelp功能。

instrhelp (obj,'propertyname'

属性的例子

本节包括几个创建、设置和读取属性的示例,以及验证这些属性行为的步骤。

创建双有界属性

此示例创建一个配置Tektronix的属性®TDS 210示波器的LCD显示屏对比度。示波器显示器可以配置为范围内的值[1 100].在MATLAB仪器驱动程序编辑器中,

  1. 选择属性树中的节点。

  2. 输入属性名称,DisplayContrast,在的名字文本字段,然后单击添加按钮。新物业的名称,DisplayContrast,出现在属性名桌子。

  3. 展开属性节点,以显示所有已定义的属性。

  4. 选择DisplayContrast从树中显示的属性中的节点。

  5. 选择代码选项卡来定义得到命令的命令DisplayContrast财产。

    • 选择仪器命令在里面物业风格字段。

    • 输入显示:对比?在里面获取命令文本域。

    • 输入显示:对比在里面设置命令文本域。

  6. 选择财产价值选项卡以定义允许的属性值。

    • 选择在里面数据类型字段。

    • 选择有限的在里面约束字段。

    • 输入1.0在里面最低限度字段。

    • 输入100.0在里面最大值字段。

  7. 选择帮助选项卡要完成定义属性行为。

    • 输入50在里面默认值文本域。

    • 选择绝不在里面只读字段。

    • 帮助文本字段,进入设置或查询LCD显示屏的对比度

  8. 点击保存按钮。

验证属性的行为。此过程验证属性的行为。在此示例中,驱动程序名称是tektronix_tds210_ex.mdd..在主地址2中与Tektronix TDS 210示波器通信是通过电路板索引0的测量计算™公司GPIB板完成的。从MATLAB命令行完成,

  1. 创建设备对象,obj.,使用Icdevice.功能。

    g = gpib(“世纪挑战集团”,0,2);obj = ICDevice(“tektronix_tds210_ex.mdd”,G);
  2. 看法DisplayContrast属性及其当前值。

    obj.displayContrast.
    ans = 50
  3. 调用在这一点DisplayContrast属性列出您可以设置属性的值。

    集(obj,“DisplayContrast”
    [1.0到100.0]
  4. 尝试将属性设置为指定范围内和范围外的值。

    obj.displayContrast = 17;obj.displayContrast.
    ans = 17.
    obj.displayContrast.= 120
    displayContrast有效值的值无效:1.0和100.0之间的值。
  5. 查看您编写的帮助。

    instrhelp (obj,“DisplayContrast”
    displayContrast [1.0到100.0]设置或查询LCD显示的对比度。
  6. 列出DisplayContrast你在财产价值帮助标签。

    info = propinfo(obj,“DisplayContrast”
    info = struct with fields: Type: 'double' Constraint: 'bounded' ConstraintValue: [1 100] DefaultValue: 50 ReadOnly: 'never' InterfaceSpecific: 1
  7. 连接到您的仪器以验证得到代码。

    连接(obj)

    当你发布时得到函数在MATLAB软件中实现tektronix_tds210_ex.mdd.司机实际发送了显示:对比?命令仪器。

    obj.displayContrast.
    ans = 17.

    当你发布时函数在MATLAB软件中实现tektronix_tds210_ex.mdd.司机实际发送了对比显示:34命令仪器。

    obj.displayContrast.= 34;
  8. 最后,断开乐器并删除对象。

    断开(obj)删除([obj g])

创建枚举属性

此示例创建一个将选择并显示Tektronix TDS 210示波器的光标的属性。示波器允许两种类型的光标。它支持金宝app水平光标,可测量伏特,部门或分贝中的垂直单位,以及垂直光标,其在时间或频率上测量水平单位。在MATLAB仪器驱动程序编辑器中,

  1. 选择属性树中的节点。

  2. 输入属性名称,CursorType,在的名字文本字段,然后单击添加按钮。新物业的名称CursorType出现在属性名桌子。

  3. 展开属性节点以显示所有已定义属性。

  4. 选择CursorType从树中显示的属性中的节点。

  5. 选择代码选项卡来定义得到命令的命令CursorType财产。

    • 选择仪器命令在里面物业风格字段。

    • 输入光标:功能?在里面获取命令文本域。

    • 输入光标:功能在里面设置命令文本域。

  6. 选择财产价值选项卡以定义允许的属性值。

    • 选择细绳在里面数据类型字段。

    • 选择枚举在里面约束字段。

    • 输入没有任何在里面新物业价值文本字段,然后单击添加按钮。然后输入离开在里面仪器价值表字段。

    • 同样地,添加属性值电压,具有仪器值HBARS.

    • 同样地,添加属性值时间,具有仪器值vbars.

  7. 选择帮助选项卡要完成定义属性行为。

    • 输入没有任何在里面默认值文本域。

    • 选择绝不在里面只读字段。

    • 帮助文本字段,进入指定游标类型

  8. 点击保存按钮。

验证属性的行为。此过程验证属性的行为。在此示例中,驱动程序名称是tektronix_tds210_ex.mdd..在主地址2中与Tektronix TDS 210示波器通信是通过电路板索引0的测量计算公司GPIB板完成的。来自Matlab命令行,

  1. 创建设备对象,obj.,使用Icdevice.功能。

    g = gpib(“世纪挑战集团”,0,2);obj = ICDevice(“tektronix_tds210_ex.mdd”,G);
  2. 观看CursorType财产的当前价值。调用得到在对象上列出了所有属性。

    get (obj)
    ConfirmationFcn = DriverName = tektronix_tds210_ex。mdd DriverType = MATLAB接口对象InstrumentModel =界面= [1 x1 gpib] LogicalName = GPIB0-2 Name = scope-tektronix_tds210_ex ObjectVisibility = RsrcName =状态= =超时关闭标签= 10类型=用户数据范围=[]范围特定属性:CursorType =没有DisplayContrast = 50

    调用得到在这一点CursorType属性列出其当前值。

    obj.curursortype.
    ans = '没有'
  3. 的可接受值CursorType财产。调用在对象上列出它的所有可设置属性。

    集(obj)
    ConfirmationFCN:String-or-函数句柄 - 或 - 单元格数组名称:ObjectVisibility:[{ON} |关闭]标签:超时:userData:scope特定属性:cursortype:[{none} |电压|时间] displayContrast:[1.0到100.0]

    调用在这一点CursorType属性列出您可以设置属性的值。

    集(obj,“CursorType”
    [{none} |电压|时间 ]
  4. 尝试将属性设置为有效和无效的值。

    obj.curursortype =.'电压';obj.curursortype.
    ANS ='电压'
    obj.curursortype =.“水平”
    没有名为“horizontal”的枚举值。
  5. 查看您编写的帮助。

    instrhelp (obj,“CursorType”
    cursortype [{none} |电压|Time]指定光标的类型。
  6. 列出CursorType你在财产价值帮助标签。

    info = propinfo(obj,“CursorType”
    info = struct with fields: Type: 'string' Constraint: 'enum' ConstraintValue: {3×1 cell} DefaultValue: 'none' ReadOnly: 'never' InterfaceSpecific: 1
    info.ConstraintValue.
    ans = 3×1个单元阵列{'none'} {'电压'} {'time'}
  7. 连接到您的仪器以验证得到代码。

    连接(obj)

    当你发布时函数在MATLAB软件中实现tektronix_tds210_ex.mdd.司机实际发送了光标:功能vbars命令仪器。

    obj.curursortype =.“时间”

    当你发布时得到函数在MATLAB软件中实现tektronix_tds210_ex.mdd.司机实际发送了光标:功能?命令仪器。

    obj.curursortype.
    ans = '时间'
  8. 最后断开与仪器的连接并删除对象。

    断开(obj)删除([obj g])

一种马铃薯代码样式属性

此示例创建一个属性,该属性将返回Tektronix TDS 210示波器的两个光标之间的差异。示波器允许两种类型的光标。它支持金宝app水平光标,可测量伏特,部门或分贝中的垂直单位,以及垂直光标,其在时间或频率上测量水平单位。前面的示例创建了一个属性,CursorType,选择并显示示波器的光标。在MATLAB仪器驱动程序编辑器中,

  1. 选择属性树中的节点。

  2. 输入属性名称,CursorDelta,在新物业文本框,然后单击添加.新物业的名称,CursorDelta,出现在属性名桌子。

  3. 展开属性节点以显示所有已定义属性。

  4. 选择CursorDelta从树中显示的属性中的节点。

  5. 选择代码标签要定义集合并获取命令CursorDelta财产。

    • 选择m在里面物业风格字段。

    • 自从此以来CursorDelta属性是只读的,没有MATLAB软件代码将被添加到设置代码文本域。

    • 下面的MATLAB软件代码被添加到获取代码文本域。

      %提取接口对象。interface = obj.interface;%确定正在显示的光标类型。type = obj.curursorType.%根据光标类型查询仪器。开关(类型)案件'没有任何'PropertyValue = 0;案件'电压'propertyvalue =查询(接口,“光标:百巴:δ?”);propertyValue = str2double (propertyValue);案件“时间”propertyvalue =查询(接口,“光标:VBArs:δ?”);propertyValue = str2double (propertyValue);结尾

  6. 选择财产价值选项卡以定义允许的属性值。

    • 选择在里面数据类型字段。

    • 选择没有任何在里面约束字段。

  7. 选择帮助选项卡要完成定义属性行为。

    • 输入0.在里面默认值文本域。

    • 选择总是在里面只读字段。

    • 帮助文本字段,进入返回两个游标之间的差异

  8. 点击保存按钮。

验证属性的行为。此过程验证属性的行为。在此示例中,驱动程序名称是tektronix_tds210_ex.mdd..在主地址2中与Tektronix TDS 210示波器通信是通过电路板索引0的测量计算公司GPIB板完成的。来自Matlab命令行,

  1. 创建设备对象,obj.,使用Icdevice.功能。

    g = gpib(“世纪挑战集团”,0,2);obj = ICDevice(“tektronix_tds210_ex.mdd”,G);
  2. 观看CursorDelta财产的当前价值。调用得到在对象上列出了所有属性。

    get (obj)
    ConfirmationFcn = DriverName = tektronix_tds210_ex。mdd DriverType = MATLAB接口对象InstrumentModel =界面= [1 x1 gpib] LogicalName = GPIB0-2 Name = scope-tektronix_tds210_ex ObjectVisibility = RsrcName =状态= =超时关闭标签= 10类型=用户数据范围=[]范围特定属性:CursorDelta = 0 CursorType = DisplayContrast = 50
  3. 观看CursorDelta财产的当前价值。

    obj.cursordelta
    ans = 0
  4. 调用在对象上列出它的所有可设置属性。请注意,作为只读属性,CursorDelta未列出输出。

    集(obj)
    ConfirmationFCN:String-or-函数句柄 - 或 - 单元格数组名称:ObjectVisibility:[{ON} |关闭]标签:超时:userData:scope特定属性:cursortype:[{none} |电压|时间] displayContrast:[1.0到100.0]
  5. 将属性设置为某个值将导致一条错误消息。

    obj.cursordelta= 4;
    不允许更改设备对象的'CursorDelta'属性。
  6. 查看您编写的帮助。

    instrhelp (obj,'cursordelta'
    Cursordelta(双)(只读)返回两个光标之间的差异。
  7. 列出CursorDelta你在财产价值帮助标签。

    info = propinfo(obj,'cursordelta'
    info = struct with字段:类型:'double'约束:'none'contramevalue:[] defaultvalue:0 readonly:'始终'interfacepecific:1
  8. 连接到您的仪器以验证得到代码。

    连接(obj)

    当你发布时得到函数在MATLAB软件中实现tektronix_tds210_ex.mdd.驱动程序实际执行指定的MATLAB软件代码。

    obj.cursordelta
    ans = 1.6000
  9. 最后,断开乐器并删除对象。

    断开(obj)删除([obj g])