icdevice

创建设备对象

语法

Obj = icdevice('driver'， hwobj) obj = icdevice('driver'， 'RsrcName') Obj = icdevice('driver') Obj = icdevice('driver'， hwobj， 'P1'， v1， 'P2”,V2,…) obj = icdevice('driver'， 'RsrcName'，'P1'， v1， 'P2”,V2,…) Obj = icdevice('driver'，'P1'， v1， 'P2”,V2,…)

参数

`司机`	一个MATLAB^®仪器驱动程序。
`hwobj`	接口对象。
`RsrcName`	VISA资源名称。
`＇P1”、“P2”,……`	特定于设备的属性名。
`V1、V2,…`	属性值所支持的对应金宝app`P1，P2,……`．
`obj`	一个设备对象。

描述

Obj = icdevice('driver'， hwobj)创建设备对象obj．仪器专用信息在MATLAB接口仪器驱动程序中定义，司机．与仪器的通信是通过接口对象完成的，hwobj．接口对象可以是串口、GPIB、VISA、TCPIP或UDP对象。如果司机不存在还是如果hwobj无效，则未创建设备对象。

设备对象也可以与VXI一起使用即插即用可互换虚拟仪器(IVI^®)驱动程序。要使用这些驱动程序，首先必须有底层VXI的MATLAB仪器驱动程序包装即插即用或IVI驱动程序。如果MATLAB仪器驱动程序包装程序还不存在，则可以使用makemid或midedit．请注意,makemid或midedit只需要使用一次来创建MATLAB仪器驱动程序包装。

obj = icdevice('driver'， 'RsrcName')创建一个设备对象obj，使用MATLAB仪器驱动程序，司机．指定的司机必须是MATLAB VXI即插即用仪器驱动或MATLAB IVI仪器驱动。通过指定的资源完成与仪器的通信rsrcname．例如，所有VXI即插即用，许多IVI驱动程序需要VISA资源名rsrcname．

Obj = icdevice('driver')构造一个设备对象obj，使用MATLAB仪器驱动程序，司机．指定的司机必须是MATLAB IVI仪器驱动程序，底层IVI驱动程序必须使用逻辑名引用。

Obj = icdevice('driver'， hwobj， 'P1'， v1， 'P2”,V2,…)，obj = icdevice('driver'， 'RsrcName'，'P1'， v1， 'P2”,V2,…),Obj = icdevice('driver'，'P1'， v1， 'P2”,V2,…)，构造一个设备对象，obj，使用指定的属性值。如果指定了无效的属性名或属性值，则不会创建对象。

类所支持的任何格式都可以是参数-值对金宝app集函数:参数值字符向量对、结构和参数值单元格数组对。

此外，您可以不考虑大小写而指定属性名，并且可以使用属性名补全。例如，以下命令都是有效且等效的:

d = icdevice('tektronix_tds210'，g，'ObjectVisibility'，'on');D = icdevice('tektronix_tds210'，g，'objectvisibility'，'on');d = icdevice('tektronix_tds210'，g，'ObjectVis'，'on');

关于部署代码的说明

当使用IVI-C或VXI即插即用驱动程序时，执行您的代码将在MATLAB提示符下执行以下代码指定的文件夹中生成额外的文件:

fullfile (tempdir ICTDeploymentFiles, sprintf (R % s,版本(“释放”)))

在所有受支持的金宝app平台上，名称为MATLABPrototypeFor < driverName >打烊，其中< driverName >IVI-C或VXI即插即用驱动程序的名称。64位MATLAB在Windows上^®，第二个文件的名称< driverName > _thunk_pcwin64.dll是生成的。在创建部署的应用程序或共享库时，手动包含这些生成的文件。如果使用icdevice函数时，记得还要手动将mdd文件包含在已部署的应用程序或共享库中。有关包含其他文件的更多信息，请参阅MATLAB编译器文档。

例子

第一个示例为Tektronix创建一个设备对象^®将TDS 210示波器连接到MCC的GPIB板上，使用MATLAB接口对象和MATLAB接口仪表驱动程序。

G = gpib('mcc'，0,2);D = icdevice('tektronix_tds210'，g);

连接到仪器。

连接(d);

列出可配置的示波器设置。

道具=集合(d);

获取示波器的当前配置。

值= get(d);

断开仪器并清理。

断开(d);删除(g (d));

第二个示例使用MATLAB VXI为Tektronix TDS 210示波器创建一个设备对象即插即用仪器驱动程序。

这个例子假设“tktds5k”VXI即插即用驱动程序已安装在您的系统上。

这第一步是必要的，只有当MATLAB VXI即插即用系统上不存在tktds5k的仪器驱动程序。

makemid(“tktds5k”、“Tktds5kMATLABDriver”);

构造一个使用VXI的设备对象即插即用司机。仪器被假定位于GPIB主地址2。

d = icdevice('Tktds5kMATLABDriver'， 'GPIB0::2::INSTR');

连接到仪器。

连接(d);

列出可配置的示波器设置。

道具=集合(d);

获取示波器的当前配置。

值= get(d);

断开仪器并清理。

断开(d);删除(d);

提示

在任何时候，你都可以使用instrhelp函数查看与设备对象关联的属性和函数的完整列表。

instrhelp icdevice

当你创建一个设备对象时，这些属性值会被自动配置:

接口指定用于与仪器通信的接口。对于使用接口对象创建的设备对象，它就是接口对象。对VXI即插即用和IVI-C，这是驱动会话的会话句柄。对于MATLAB仪器驱动程序，这是驱动程序默认COM接口的句柄。
LogicalName是IVI逻辑名。对于非ivi驱动程序，它是空的。
的名字通过将仪器类型与仪器驱动程序的名称连接而给出。
RsrcNameVXI的完整VISA资源名称是即插即用和IVI驾驶员。对于MATLAB接口驱动程序，RsrcName是空字符向量。
类型仪器类型，如果已知(例如，范围或万用表）.

要与仪器通信，设备对象必须与仪器连接连接函数。当设备对象被构造时，该对象的状态属性是关闭．一旦设备对象连接到仪器与连接函数,状态属性配置为开放．

请注意

ICDEVICE无法在Mac平台上打开名称或路径中包含非ascii字符的mdd。

请注意

要获取可用于函数的选项列表，请按选项卡在MATLAB命令行中输入函数后的键。列表将展开，您可以滚动以选择属性或值。有关使用此高级选项卡补全功能的信息，请参见为函数使用制表符补全．

版本历史

R2006a之前介绍

另请参阅

连接|断开连接|状态