Если объект устройства был создан и соединен, он может использоваться в качестве интерфейса к инструменту. Эта глава показывает вам, как получить доступ и сконфигурировать настройки вашего инструмента, а также как читать и записать данные к инструменту.
Каждый объект устройства содержит свойства, характерные для инструмента, который он представляет. Эти свойства заданы инструментальным драйвером, используемым во время создания объекта устройства. Например, могут быть свойства для осциллографа, которые позволяют вам настраивать триггерные параметры или контраст отображения на экране.
Свойства являются присвоенными значениями по умолчанию при создании объекта устройства. На выполнении connect объект обновляется, чтобы отразить состояние инструмента или наоборот, в зависимости от второго аргумента, данного connect.
Можно получить полный список конфигурируемых свойств путем вызова команды set и передачи объекта устройства.
Этот пример иллюстрирует, как сконфигурировать инструмент с помощью объекта устройства.
Используемым инструментом является Tektronix® TDS 210 двухканальный осциллограф. Прямоугольная волна вводится в канал 1 из осциллографа. Задача состоит в том, чтобы настроить настройки осциллографа так, чтобы инициирование произошло на падающем ребре сигнала:
Создайте объект устройства — Создают объект интерфейса GPIB, и затем объект устройства для осциллографа TDS 210.
g = gpib('ni',0,1);
d = icdevice('tektronix_tds210', g);Соедините объект устройства — Использование функция connect, чтобы соединить объект устройства с инструментом.
connect(d);
Проверяйте, что текущие настройки Slope для свойства Trigger — Создают переменную, чтобы представлять свойство Trigger и затем использовать функцию get, чтобы получить текущее значение для установки Slope осциллографа.
dtrigger = get(d, 'Trigger');
dtrigger.Slope
ans =
rising
Slope в настоящее время установлен в rising.
Измените настройки Slope — Если вы хотите инициировать, чтобы произойти на падающем ребре, необходимо изменить ту установку в объекте устройства. Это может быть выполнено с командой set.
dtrigger.Slope = 'falling');
Это изменяет Slope на falling.
Разъединитесь и вымойтесь — Когда вы больше не будете нуждаться в объекте устройства, будете отключать его от инструмента и удалять его из памяти. Удалите объект устройства и интерфейсный объект из рабочей области MATLAB®.
disconnect(d); delete(d); clear d g dtrigger;
Объекты устройства содержат методы, характерные для инструментов, которые они представляют. Детали реализации скрыты позади одной функции. Специфичные для инструмента функции заданы в инструментальном драйвере MATLAB.
Функция methods отображает все доступные заданные драйвером функции для объекта устройства. Отображение разделено на два раздела:
Функции родового объекта
Специфичные для драйвера объектные функции
Чтобы просмотреть доступные методы, ввести
methods(obj)
Используйте функцию instrhelp, чтобы получить справку на функциях объекта устройства.
instrhelp(obj, methodname);
Чтобы вызвать специфичные для инструмента методы, вы используете функцию invoke. invoke требует объекта устройства и имени функции. Необходимо также обеспечить входные параметры, в надлежащих случаях. Следующий пример демонстрирует, как использовать invoke, чтобы получить данные об измерении из осциллографа.
Этот пример иллюстрирует, как вызвать специфичную для инструмента функцию объекта устройства. Ваша задача состоит в том, чтобы получить измерение частоты формы волны. Инструмент является Tektronix TDS 210 двухканальный осциллограф.
Осциллограф был предварительно сконфигурирован с входом прямоугольной волны в канал 1 из осциллографа. Аппаратные поддержки четыре различных измерения: частота, среднее значение, точка, и от пика к пику. Требуемое измерение показано с использованием индексной переменной от 1 до 4.
В демонстрационных целях осциллограф в этом примере был предварительно сконфигурирован с правильными настройками измерения:
Создайте объект устройства — Создают объект интерфейса GPIB и объект устройства для осциллографа.
g = gpib('ni',0,1);
d = icdevice('tektronix_tds210', g);Соедините объект устройства — Использование команда connect, чтобы открыть объект GPIB и обновить настройки в объекте устройства.
connect(d);
Получите измерение частоты — Использование команда invoke и вызовите measure. Функция measure требует, чтобы индексный параметр был задан. Значение индекса задает, какое измерение осциллограф должен возвратить. Для текущей настройки осциллографа Tektronix TDS 210 индекс 1 указывает, что частота должна быть измерена.
invoke(d, 'measure', 1)
ans =
999.9609Возвращенная частота составляет 999,96 Гц или почти 1 кГц.
Разъединитесь и вымойтесь — Вам больше не нужен объект устройства, таким образом, можно отключить его от инструмента. Необходимо также удалить его из памяти и удалить его из рабочего пространства MATLAB.
disconnect(d); delete(d); clear d g;
Команды управления являются специальными функциями и свойствами, которые существуют для всех объектов устройства. Вы используете команды управления, чтобы идентифицировать инструмент, сбросить аппаратные настройки, выполнить диагностические стандартные программы и получить инструментальные погрешности. Набор команд управления состоит из
Все команды управления заданы в инструментальном драйвере MATLAB для вашего устройства.
InstrumentModel является свойством объекта устройства. Когда запрошено, инструментальная идентификационная команда отправляется в инструмент.
Например, для осциллографа Tektronix TDS 210,
d.InstrumentModel ans = TEKTRONIX,TDS 210,0,CF:91.1CT FV:v2.03 TDS2MM:MMV:v1.04
Чтобы восстановить заводские настройки на вашем инструменте, используйте функцию devicereset. Когда devicereset называется, соответствующая инструкция по сбросу отправляется в ваш инструмент.
Команда принимает объект подключенного устройства и не имеет никаких выходных аргументов.
devicereset(obj);
Эта команда запрашивает, чтобы ваш инструмент выполнил самодиагностику. Фактические выполняемые операции и выходные аргументы характерны для инструмента, с которым соединяется ваш объект устройства. selftest принимает объект подключенного устройства как входной параметр.
result = selftest(obj);
Можно получить сообщения об ошибке, сгенерированные инструментом с функцией geterror. Возвращенные сообщения являются конкретным инструментом. geterror принимает объект подключенного устройства как входной параметр.
msg = geterror(obj);