exponenta event banner

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,...)

Аргументы

driver

Драйвер прибора MATLAB ®.

hwobj

Объект интерфейса.

RsrcName

Имя ресурса VISA.

'P1', 'P2',...

Имена свойств, специфичных для устройства.

V1, V2,...

Значения свойств, поддерживаемые соответствующими P1, P2,....

obj

Объект устройства.

Описание

obj = icdevice('driver', hwobj) создает объект устройства obj. Специфичная для прибора информация определяется в драйвере прибора интерфейса MATLAB, driver. Связь с прибором осуществляется через объект интерфейса, hwobj. Объектом интерфейса может быть последовательный порт, GPIB, VISA, TCPIP или объект UDP. Если driver не существует или если hwobj недопустим, объект устройства не создан.

Объекты устройства могут также использоваться с драйверами VXIplug & play и взаимозаменяемых виртуальных приборов (IVI ®). Для использования этих драйверов сначала необходимо иметь оболочку драйвера прибора MATLAB для базового драйвера VXIplug & play или IVI. Если обертка драйвера прибора MATLAB еще не существует, ее можно создать с помощьюmakemid или midedit. Обратите внимание, что makemid или midedit необходимо использовать только один раз для создания обертки драйвера прибора MATLAB.

obj = icdevice('driver', 'RsrcName') создает объект устройства obj, используя драйвер прибора MATLAB, driver. Указанное driver должен быть драйвером прибора MATLAB VXIplug & play или драйвером прибора MATLAB IVI. Связь с прибором осуществляется через ресурс, указанный rsrcname. Например, для всех VXIplug & play и многих драйверов IVI требуются имена ресурсов VISA дляrsrcname.

obj = icdevice('driver') создает объект устройства obj, используя драйвер прибора MATLAB, driver. Указанное driver должен быть драйвером прибора 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, с указанными значениями свойств. Если указано недопустимое имя или значение свойства, объект не будет создан.

Обратите внимание, что пары параметр-значение могут быть в любом формате, поддерживаемом set функция: пары векторов символов «параметр-значение», структуры и пары массивов ячеек «параметр-значение».

Кроме того, можно указать имена свойств без учета регистра, а также воспользоваться заполнением имен свойств. Например, все эти команды являются допустимыми и эквивалентными:

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

Примечание о развертывании кода

При использовании драйверов IVI-C или VXI Plug & Play выполнение кода приведет к созданию дополнительных файлов в указанной папке путем выполнения следующего кода в подсказке MATLAB:

fullfile(tempdir,'ICTDeploymentFiles',sprintf('R%s',version('-release')))

На всех поддерживаемых платформах файл с именем MATLABPrototypeFor<driverName>.m генерируется, где <driverName> имя драйвера IVI-C или VXI Plug & Play. С 64-разрядным MATLAB в Windows ®, второй файл по имени<driverName>_thunk_pcwin64.dll генерируется. При создании развернутого приложения или общей библиотеки вручную включите эти созданные файлы. При использовании icdevice не забудьте также вручную включить MDD-файл в развернутое приложение или общую библиотеку. Дополнительные сведения о включении дополнительных файлов см. в документации по компилятору MATLAB.

Примеры

В первом примере создается объект устройства для осциллографа Tektronix ® TDS 210, подключенного к плате GPIB MCC, с использованием объекта интерфейса MATLAB и драйвера прибора интерфейса MATLAB.

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

Подсоедините к прибору.

connect(d);

Перечислите настройки осциллографа, которые можно настроить.

props = set(d);

Получить текущую конфигурацию осциллографа.

values = get(d);

Отсоедините от прибора и очистите.

disconnect(d);
delete([d g]);

Во втором примере создается объект устройства для осциллографа Tektronix TDS 210 с использованием драйвера инструмента MATLAB VXIplug & play.

В этом примере предполагается, что 'tktds5k' В системе установлен драйвер VXIplug & play.

Этот первый шаг необходим только в том случае, если в системе отсутствует драйвер прибора MATLAB VXIplug & play для tktds5k.

makemid('tktds5k', 'Tktds5kMATLABDriver');

Создайте объект устройства, использующий драйвер VXIplug & play. Предполагается, что прибор расположен по основному адресу GPIB 2.

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

Подсоедините к прибору.

connect(d);

Перечислите настройки осциллографа, которые можно настроить.

props = set(d);

Получить текущую конфигурацию осциллографа.

values = get(d);

Отсоедините от прибора и очистите.

disconnect(d);
delete(d);

Совет

В любое время вы можете использовать instrhelp для просмотра полного списка свойств и функций, связанных с объектами устройства.

instrhelp icdevice

При создании объекта устройства автоматически настраиваются следующие значения свойств:

  • Interface определяет интерфейс, используемый для связи с прибором. Для объектов устройства, созданных с помощью объектов интерфейса, это объект интерфейса. Для VXIplug & play и IVI-C это дескриптор сеанса для сеанса драйвера. Для драйверов приборов MATLAB это дескриптор COM-интерфейса драйвера по умолчанию.

  • LogicalName - логическое имя IVI. Для драйверов, не относящихся к IVI, он пуст.

  • Name задается путем объединения типа прибора с именем драйвера прибора.

  • RsrcName полное имя ресурса VISA для драйверов VXIplug & play и IVI. Для драйверов интерфейса MATLABRsrcName - пустой символьный вектор.

  • Type - тип инструмента, если он известен (например, scope или multimeter).

Для связи с прибором объект устройства должен быть соединен с прибором с помощью connect функция. Когда объект устройства создан, объект Status свойство - closed. После подключения объекта устройства к прибору с помощью connect функция, Status свойство настроено на open.

Примечание

ICDEVICE не может открывать MDD с символами, не являющимися ascii, в их имени или пути на платформах Mac.

Примечание

Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции в командной строке MATLAB. Список расширяется, и можно выполнить прокрутку для выбора свойства или значения. Сведения об использовании этой расширенной функции завершения вкладки см. в разделе Использование функции завершения вкладки для функций.

См. также

| | |

Представлен до R2006a