Создание драйверов приборов MATLAB

Компоненты драйвера

Драйвер прибора MATLAB ® содержит информацию о приборе и определяет функциональные возможности, поддерживаемые прибором .

Компонент драйвера	Описание
Сводка драйверов и общие команды	Основная информация о приборе, например, производитель или номер модели.
Инициализация и очистка	Код, который исполняется на различных этапах сеанса управления прибором, например код, который исполняется при подключении к прибору.
Свойства	Свойство обычно используется для конфигурирования или запроса информации о состоянии прибора.
Функции	Функция обычно используется для управления или конфигурирования прибора.
Группы	Группа объединяет общие функциональные возможности прибора в один компонент.

В зависимости от прибора и приложения, для которого используется драйвер, все компоненты драйвера могут быть не определены. Необходимые компоненты драйвера, необходимые для приложения, можно определить с помощью редактора драйверов приборов MATLAB.

Примечание

Редактор драйверов приборов не может открывать MDD с символами, отличными от ascii, в их имени или пути на платформах Mac.

Функции редактора драйверов приборов MATLAB

Редактор драйверов приборов MATLAB - это инструмент, который создает или редактирует драйвер приборов MATLAB. В частности, она позволяет выполнять следующие действия:

Добавление/удаление/изменение свойств.
Добавление/удаление/изменение функций.
Определите код MATLAB для обхода команд, посылаемых прибору.

Откройте редактор драйверов приборов MATLAB с помощью следующей команды.

midedit

В остальной части этого раздела будет описан каждый компонент драйвера, и будут показаны примеры того, как добавить информацию о компоненте драйвера в новый драйвер прибора MATLAB, называемый tektronix_tds210_ex.mdd. tektronix_tds210_ex.mdd драйвер определяет основные функции информации и приборов для осциллографа Tektronix ® TDS 210 .

Сохранение драйверов приборов MATLAB

Драйвер прибора можно сохранить в любой каталог с любым именем. Рекомендуется сохранить драйвер прибора в каталоге по пути MATLAB и указать имя в формате manufacturer_model.mdd. Например, прибор, который используется с осциллографом Tektronix TDS 210, должен быть сохранен с именем tektronix_tds210.mdd.

Сводка драйверов и общие команды

Водителю прибора MATLAB можно присвоить основную информацию о приборе. Сводная информация может использоваться для идентификации драйвера прибора MATLAB и представляемого им прибора. Общие команды могут использоваться для сброса, тестирования и считывания сообщений об ошибках из прибора. Вместе эта информация может использоваться для инициализации и проверки прибора.

Темы этого раздела включают:

Сводка драйверов
Общие команды
Определение сводки драйверов и общих команд
Проверка сводки драйверов и общих команд

Сводка драйверов

Можно назначить основную информацию, описывающую прибор, в драйвере прибора. Эта информация включает производителя прибора, номер модели прибора и тип прибора. Версия также может быть назначена водителю, чтобы помочь в управлении редакциями.

Общие команды

Можно определить основные общие команды, поддерживаемые инструментом. Доступ к общим командам осуществляется через свойства и функции объекта устройства.

Общие команды	Доступ с помощью объекта устройства	Пример команды КИП	Описание
Определить	`InstrumentModel` собственность	`*IDN?`	Возвращает идентификационную строку инструмента
Сброс	`devicereset` функция	`*RST`	Возвращает инструмент в известное состояние
Самопроверка	`selftest` функция	`*TST?`	Тестирование интерфейса прибора
Ошибка	`geterror` функция	`ErrLog:Next?`	Получение следующего сообщения об ошибке прибора

Редактор драйверов КИП MATLAB назначает значения по умолчанию для команд Common. Общие команды должны быть соответствующим образом изменены в соответствии с набором команд прибора.

Определение сводки драйверов и общих команд

В этом примере определяются основные сведения о драйверах и общие команды для осциллографа Tektronix TDS 210 с помощью редактора драйверов приборов MATLAB:

Выберите Summary узел в дереве.
На панели Сводка драйверов:
1. Войти Tektronix в поле Производитель.
2. Войти TDS 210 в поле Модель.
3. Выбрать Oscilloscope в поле Тип прибора.
4. Войти 1.0 в поле Версия драйвера.
На панели Общие команды:
1. Покинуть поле Идентификация с помощью *IDN?.
2. Покинуть поле Сброс с помощью *RST.
3. Выйдите из поля Self test с помощью *TST?
4. Обновить поле Ошибка с помощью ErrLog:Next?
Нажмите кнопку «Сохранить». Укажите имя драйвера прибора как tektronix_tds210_ex.mdd.

Примечание

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

Проверка сводки драйверов и общих команд

Эта процедура проверяет сводную информацию, определенную на панелях команд Driver Summary и Common. В этом примере имя драйвера: tektronix_tds210_ex.mdd. Связь с осциллографом Tektronix TDS 210 по основному адресу 2 осуществляется через плату GPIB корпорации Measurement Computing™ с индексом платы 0. В окне команды MATLAB

Создайте объект устройства, obj, с использованием icdevice функция.
```
g = gpib('mcc',0,2);
obj = icdevice('tektronix_tds210_ex.mdd',g);
```

Просмотр определенной информации о драйверах.

obj

   Instrument Device Object Using Driver : tektronix_tds210_ex.mdd
 
   Instrument Information
      Type:               Oscilloscope
      Manufacturer:       Tektronix
      Model:              TDS210
 
   Driver Information
      DriverType:         MATLAB interface object
      DriverName:         tektronix_tds210_ex.mdd
      DriverVersion:      1.0
 
   Communication State
      Status:             closed

instrhwinfo(obj)

ans = 

  struct with fields:

    Manufacturer: 'Tektronix'
           Model: 'TDS210'
            Type: 'Oscilloscope'
      DriverName: 'C:\Program Files\MATLAB\R2019b\toolbox\instrument\instrument\drivers\tektronix_tds210_ex.mdd'

Подсоедините к прибору.
```
connect(obj)
```

Проверьте команды Common.

obj.InstrumentModel

ans =

    TEKTRONIX,TDS 210,0,CF:91.1CT FV:v2.03 TDS2MM:MMV:v1.04

devicereset(obj)

selftest(obj)

ans =

    0

geterror(obj)

ans = 

    ''

Отсоедините от прибора и удалите объекты.
```
disconnect(obj) 
delete([obj g])
```

Инициализация и очистка

В этом разделе описывается, как определить код, который выполняется на различных этапах сеанса управления прибором, так что прибор может быть установлен в требуемое состояние в определенное время. В частности, можно определить код, который выполняется после создания объекта устройства, после подключения объекта устройства к прибору или до отсоединения объекта устройства от прибора. В зависимости от этапа, код может быть определен как список команд прибора, которые будут записаны на прибор, или как код MATLAB.

Темы этого раздела включают:

Определения типов кодов, которые могут быть определены
Примеры кода для каждого поддерживаемого этапа
Шаги, используемые для проверки кода

Создать код

Вы определяете код создания, чтобы убедиться, что объект устройства настроен для поддержки необходимых свойств и функций:

Код создания вычисляется сразу после создания объекта устройства.
Код создания может быть определен только как программный код MATLAB.

Определение кода создания

Этот пример определяет код создания, который гарантирует, что объект устройства может передавать максимальный размер сигнала, 2500 точек данных, поддерживаемых осциллографом Tektronix TDS 210. В редакторе драйверов приборов MATLAB

Выберите Initialization and Cleanup узел в дереве.

Перейдите на вкладку Create и введите программный код MATLAB для выполнения при создании объекта устройства.

% Get the interface object and disconnect from instrument.
g = obj.Interface;
fclose(g);

% Configure the interface object's buffers to handle up to 
% 2500 points (two bytes per point requires 5000 bytes). 
g.InputBufferSize = 5000;
g.OutputBufferSize = 5000;

Нажмите кнопку «Сохранить».

Проверка создания кода

Эта процедура проверяет, определен ли код создания программного обеспечения MATLAB. В этом примере имя драйвера: tektronix_tds210_ex.mdd. Связь с осциллографом Tektronix TDS 210 по основному адресу 2 осуществляется через плату GPIB компании Measurement Computing Corporation с индексом платы 0.

В командной строке MATLAB создайте объект интерфейса, g; и проверьте значения размера входного и выходного буфера по умолчанию.
```
g = gpib('mcc',0,2);
g.InputBufferSize
```
```
ans =

   512
```
```
g.OutputBufferSize
```
```
ans =

   512
```
Создайте объект устройства, obj, с использованием icdevice функция.
```
obj = icdevice('tektronix_tds210_ex.mdd',g);
```
Проверьте код создания, запросив размеры буфера объекта интерфейса.
```
g.InputBufferSize
```
```
ans =

        5000
```
```
g.OutputBufferSize
```
```
ans =

        5000
```
Удалите объекты.
```
delete([obj g])
```

Код подключения

В большинстве случаев необходимо знать состояние или конфигурацию прибора при подключении к нему объекта устройства. Можно определить код подключения, чтобы убедиться, что прибор правильно настроен для поддержки свойств и функций объекта устройства.

Код подключения вычисляется сразу после подключения объекта устройства к прибору с помощью connect функция. Код подключения может быть определен как последовательность команд прибора, которые будут записаны на прибор, или как программный код MATLAB.

Определение кода соединения

В этом примере определяется код подключения, который обеспечивает конфигурацию осциллографа Tektronix TDS 210 для поддержки свойств и функций объекта устройства. В частности, прибор возвращается к известному набору настроек прибора (сброс прибора), и прибор конфигурируется так, чтобы пропускать заголовки в ответах на запросы.

В редакторе драйверов приборов MATLAB выберите Initialization and Cleanup узел в дереве.
Перейдите на вкладку Connect и введите команды для выполнения при подключении объекта устройства к прибору.
- Выбрать Instrument Commands в меню Стиль функции.
- Введите *RST в текстовом поле Команда и нажмите кнопку Добавить.
- Введите HEADER OFF в текстовом поле Команда и нажмите кнопку Добавить.
Нажмите кнопку «Сохранить».

Проверка кода подключения

Эта процедура используется для проверки команд КИП, определенных в коде подключения. В этом примере имя драйвера: tektronix_tds210_ex.mdd. Связь с осциллографом Tektronix TDS 210 по основному адресу 2 осуществляется через плату GPIB компании Measurement Computing Corporation с индексом платы 0.

В командной строке MATLAB создайте объект устройства, obj, с использованием icdevice функция.
```
g = gpib('mcc',0,2); 
obj = icdevice('tektronix_tds210_ex.mdd',g);
```
Подсоедините к прибору.
```
connect(obj)
```
Проверьте код подключения, запросив состояние заголовка прибора.
```
query(g,'Header?')
```
```
ans =

        0
```
Отсоедините от прибора и удалите объекты.
```
disconnect(obj) 
delete([obj g])
```

Код отключения

Определяя код разъединения, можно убедиться, что прибор и объект устройства возвращены в известное состояние после завершения связи с прибором.

Код разъединения оценивается перед отсоединением объекта устройства от прибора с помощью disconnect функция. Это позволяет коду разъединения взаимодействовать с прибором. Код разъединения может быть определен как последовательность команд прибора, которые будут записаны на прибор, или как программный код MATLAB.

Определение кода отключения

Этот пример определяет код разъединения, который гарантирует, что осциллограф Tektronix TDS 210 возвращается в известное состояние после связи с прибором с использованием объекта устройства.

В редакторе драйверов приборов MATLAB выберите Initialization and Cleanup узел в дереве.
Перейдите на вкладку Disconnect и введите программный код MATLAB для выполнения при отключении объекта устройства от прибора.
- Выбрать M-Code в меню Стиль функции.
- Определите программный код MATLAB, который сбросит прибор и настроит буферы объекта интерфейса на значения по умолчанию.
  % Get the interface object. g = obj.Interface; % Reset the instrument to a known state. fprintf(g, '*RST');
Нажмите кнопку «Сохранить».

Проверка кода отключения

Эта процедура используется для проверки программного кода MATLAB, определенного в коде разъединения. В этом примере имя драйвера: tektronix_tds210_ex.mdd. Связь с осциллографом Tektronix TDS 210 по основному адресу 2 осуществляется через плату GPIB компании Measurement Computing Corporation с индексом платы 0. В командной строке MATLAB

Создайте объект устройства, obj, с использованием icdevice функция.
```
g = gpib('mcc',0,2);
obj = icdevice('tektronix_tds210_ex.mdd',g);
```
Подсоедините к прибору.
```
connect(obj)
```
Измените некоторые настройки на приборе, чтобы при отключении можно было наблюдать изменения. Например, контрастность осциллографа можно изменить, нажав кнопку отображения на передней панели, а затем кнопку уменьшения контрастности.
Отключитесь от прибора и убедитесь, что его дисплей сброшен.
```
disconnect(obj)
```
Удалите объекты.
```
delete([obj g])
```

Документация