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.

'P1P2',...

Имена свойства конкретного устройства.

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 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 с использованием драйвера инструмента 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. Для драйверов интерфейса MATLAB, RsrcName - пустой символьный вектор.

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

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

Примечание

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

Примечание

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

См. также

| | |

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