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> имя драйвера VXI Plug&Play или IVI-C. С 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.

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

Этот первый шаг необходим, только если инструментальный драйвер 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

Для просмотра документации необходимо авторизоваться на сайте