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 должен быть инструментальный драйвер VXIplug&play MATLAB или 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 Compiler.

Примеры

Первый пример создает объект устройства для осциллографа 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 с помощью инструментального драйвера VXIplug&play MATLAB.

Этот пример принимает что 'tktds5k' Драйвер VXIplug&play установлен в вашей системе.

Этот первый шаг необходим, только если инструментальный драйвер VXIplug&play MATLAB для 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 логических имен. Для non-IVI драйверов это пусто.

  • Name дан путем конкатенации инструментального типа с именем инструментального драйвера.

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

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

Чтобы связаться с инструментом, объект устройства должен быть соединен с инструментом с connect функция. Когда объект устройства создается, Status объекта свойством является closed. Если объект устройства соединяется с инструментом с connect функция, Status свойство сконфигурировано к open.

Примечание

ICDEVICE не может открыть MDDs с символами неASCII или на их имя или на путь на платформах Mac.

Примечание

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

Смотрите также

| | |

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