Если объект устройства был создан и соединен, он может использоваться в качестве интерфейса к инструменту. Эта глава показывает вам, как получить доступ и сконфигурировать настройки вашего инструмента, а также как читать и записать данные к инструменту.
Каждый объект устройства содержит свойства, характерные для инструмента, который он представляет. Эти свойства заданы инструментальным драйвером, используемым во время создания объекта устройства. Например, могут быть свойства для осциллографа, которые позволяют вам настраивать триггерные параметры или контраст отображения на экране.
Свойства являются присвоенными значениями по умолчанию при создании объекта устройства. На выполнении 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);