fgen

Создайте Объект генератора Быстрой Функции управления

Синтаксис

myFGen = fgen()
connect(myFGen);
set(myFGen, 'P1',V1,'P2',V2,...)
enableOutput(myFGen);

Описание

Генератор Быстрой Функции управления может использоваться для любого функционального преобразователя, который использует базовый драйвер IVI-C. Однако вы не должны непосредственно иметь дело с базовым драйвером. Этот объект fgen прост в использовании.

myFGen = fgen() создает экземпляр функционального преобразователя под названием myFGen.

connect(myFGen); подключения к функциональному преобразователю.

set(myFGen, 'P1',V1,'P2',V2,...) присваивает заданные значения свойств.

enableOutput(myFGen); позволяет функциональному преобразователю произвести сигнал, который появляется в выходном разъеме.

Для получения информации о предпосылках для использования fgen смотрите Требования Генератора Быстрой Функции управления.

Генератор Быстрой Функции управления функция fgen может использовать следующие специальные функции, в дополнение к стандартным функциям, таким как connect и disconnect.

ФункцияОписание
selectChannel

Задает название канала, из которого функциональный преобразователь производит форму волны.

Пример:

 selectChannel(myFGen, '1');
drivers

Возвращает список доступных инструментальных драйверов функционального преобразователя.

Пример:

driverlist = drivers(myFGen);
resources

Получает список доступных инструментальных ресурсов. Это возвращает список доступных строк ресурса VISA при использовании функционального преобразователя IVI-C.

Пример:

res = resources(myFGen);
selectWaveform

Задает, какую произвольную форму волны функциональный преобразователь производит.

Пример:

selectWaveform (myFGen, wh);

где wh является указателем формы волны, вы выбираете.

downloadWaveform

Загружает произвольную форму волны на функциональный преобразователь. Если вы обеспечиваете выходную переменную, указатель формы волны возвращен. Это может использоваться в функциях removeWaveform и selectWaveform.

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

Пример:

 % To download the following waveform to fgen
 w = 1:0.001:2;
 downloadWaveform (myFGen, w);
 % To download a waveform to fgen and return a 
    waveform handle
 wh = downloadWaveform (myFGen, w);
removeWaveform

Удаляет ранее созданную произвольную форму волны из памяти функционального преобразователя. Если указатель формы волны обеспечивается, он удаляет форму волны, представленную указателем формы волны.

Пример:

 % Remove a waveform from fgen with waveform 
     handle 10000
  removeWaveform (myFGen, 10000);
enableOutput

Позволяет функциональному преобразователю произвести сигнал, который появляется в выходном разъеме. Эта функция производит форму волны, заданную свойством Waveform. Если свойство Waveform установлено в 'Arb', функция использует последний внутренний указатель формы волны, чтобы вывести форму волны.

enableOutput (myFGen);
disableOutput

Отключает сигнал, который появляется в выходном разъеме. Отключает выбранный канал.

disableOutput (myFGen);
reset

Устанавливает функциональный преобразователь на состояние фабрики.

Аргументы

Генератор Быстрой Функции управления fgen может использовать следующие свойства.

Свойство Описание
AMDepth

Задает степень Амплитудной модуляции, функциональный преобразователь применяется к сигналу поставщика услуг. Модули являются процентом полной модуляции. В 0% глубиной выходная амплитуда равняется амплитуде сигнала поставщика услуг. В 100% глубиной выходная амплитуда равняется дважды амплитуде сигнала поставщика услуг. Это свойство влияет на поведение функционального преобразователя только, когда Mode установлен в 'AM', и ModulationResource установлен в 'internal'.

Amplitude

Задает амплитуду стандартной формы волны. Значение является амплитудой на выходном терминале. Модули являются от пика к пику вольт (Vpp). Например, чтобы произвести форму волны в пределах от-5.0 к +5.0 вольтам, установите это значение к 10,0 вольтам. Не применяется, если Форма волны имеет тип 'Arb'.

ArbWaveformGain

Задает фактор, которым функциональный преобразователь масштабирует произвольные данные о форме волны. Используйте это свойство масштабировать произвольную форму волны к областям значений кроме-1.0 к +1.0. Когда установлено в 2,0, выходной сигнал колеблется от-2.0 до +2.0 вольт. Только применяется, если Форма волны имеет тип 'Arb'.

BurstCount

Задает количество циклов формы волны, которые производит функциональный преобразователь после того, как это получает триггер. Только применяется, если Mode установлен в 'burst'.

ChannelNames

Это свойство только для чтения обеспечивает доступные названия канала в массиве ячеек.

Driver

Это свойство является дополнительным. Используйте, только если необходимый, чтобы задать базовый драйвер раньше связывался с инструментом. Если свойство DriverDetectionMode установлено в 'manual', используйте свойство Driver задать инструментальный драйвер.

DriverDetectionMode

Настраивает критерии связи. Допустимыми значениями является 'auto' и 'manual'. Значением по умолчанию является 'auto', что означает, что вы не должны определять имя драйвера прежде, чем соединиться с инструментом. Если установлено в 'manual', имя драйвера должно быть обеспечено с помощью свойства Driver прежде, чем соединиться с инструментом.

FMDeviation

Задает максимальное отклонение частоты, форма волны модуляции применяется к форме волны поставщика услуг. Это отклонение соответствует максимальному амплитудному уровню сигнала модуляции. Модулями является Герц (Гц). Это свойство влияет на поведение функционального преобразователя только, когда Mode установлен в 'FM', и ModulationSource установлен в 'internal'.

Frequency

Задает уровень, на котором функциональный преобразователь выводит целую произвольную форму волны, когда Форма волны установлена в 'Arb'. Это задает частоту стандартной формы волны, когда Форма волны установлена в стандартные типы формы волны. Модулями является Герц (Гц).

Mode

Задает режим выполнения. Допустимыми значениями является 'continuous', 'burst', 'AM' или 'FM'. Задает, как функциональный преобразователь производит формы волны. Это конфигурирует инструмент, чтобы генерировать вывод постоянно или генерировать дискретное количество циклов формы волны на основе триггерного события. Это может также быть установлено в AM и FM.

ModulationFrequency

Задает частоту стандартной формы волны что использование функционального преобразователя, чтобы модулировать выходной сигнал. Модулями является Герц (Гц). Этот атрибут влияет на поведение функционального преобразователя только, когда Mode установлен в 'AM' или 'FM', и атрибут ModulationSource установлен в 'internal'.

ModulationSource

Задает сигнал что использование функционального преобразователя, чтобы модулировать выходной сигнал. Допустимыми значениями является 'internal' и 'external'. Этот атрибут влияет на поведение функционального преобразователя только, когда Mode установлен в 'AM' или 'FM'.

ModulationWaveform

Задает стандартный тип формы волны что использование функционального преобразователя, чтобы модулировать выходной сигнал. Это влияет на поведение функционального преобразователя только, когда Mode установлен в 'AM' или 'FM', и ModulationSource установлен в 'internal'. Допустимыми значениями является 'sine', 'square', 'triangle', 'RampUp', 'RampDown' и 'DC'.

Offset

Использует стандартное смещение DC формы волны в качестве входных параметров, если форма волны не имеет типа 'Arb'. Используйте Смещение Формы волны Arb в качестве входных параметров, если форма волны имеет тип 'Arb'.

Задает смещение DC стандартной формы волны, когда Форма волны установлена в стандартную форму волны. Например, стандартная форма волны в пределах от +5.0 вольт к 0,0 вольтам имеет смещение DC 2,5 вольт. Когда Форма волны установлена в 'Arb', это свойство переключает область значений произвольной формы волны. Например, когда это установлено в 1,0, диапазоны выходного сигнала от 2,0 вольт до 0,0 вольт.

OutputImpedance

Задает выходной импеданс функционального преобразователя в выходном разъеме.

Resource

Установите это прежде, чем соединиться с инструментом. Это - строка ресурса VISA для вашего инструмента.

SelectedChannelВозвращает выбранное название канала, которое было установлено с помощью функции selectChannel.
StartPhase

Задает горизонтальное смещение в градусах стандартной формы волны, которую производит функциональный преобразователь. Модули являются степенями одного цикла формы волны. Например, фаза на 180 градусов сместила средние значения, которые выходная генерация начинает на полпути через форму волны.

Status

Это свойство только для чтения указывает на коммуникационное состояние вашего инструментального сеанса. Это - или 'open' или 'closed'.

TriggerRate

Задает уровень, на котором внутренний триггерный источник функционального преобразователя производит триггер в триггерах в секунду. Это свойство влияет на поведение функционального преобразователя только, когда TriggerSource установлен в 'internal'. Только применяется, если Mode установлен в 'burst'.

TriggerSource

Задает триггерный источник. После того, как функциональный преобразователь получает триггер, он генерирует выходной сигнал, если Mode установлен в 'burst'. Допустимыми значениями является 'internal' или 'external'.

Waveform

Использует тип формы волны в качестве входного параметра. Допустимыми значениями является 'Arb', для произвольной формы волны или этих стандартных типов формы волны – 'Sine', 'Square', 'Triangle', 'RampUp', 'RampDown' и 'DC'.

Примечание

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

Примеры

Создайте экземпляр функционального преобразователя под названием myFGen.

myFGen = fgen()

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

availableResources = resources(myFGen)

Установите ресурс. В этом примере мы управляем инструментом, который соединяется через GPIB с параметром плат 0 и первичным адресом 10.

myFGen.Resource = 'GPIB0::10::INSTR';

Соединитесь с функциональным преобразователем.

connect(myFGen);

Задайте название канала, из которого функциональный преобразователь производит форму волны.

selectChannel(myFGen, '1');

Сконфигурируйте стандартную форму волны, чтобы быть непрерывной синусоидой.

set(myFGen, 'Waveform', 'sine');
set(myFGen, 'Mode', 'continuous');

Сконфигурируйте функциональный преобразователь.

% Set the load impedance to 50 Ohms. 
set(myFGen, 'OutputImpedance', 50);

% Set the frequency to 2500 Hz. 
set(myFGen, 'Frequency', 2500);

% Set the amplitude to 1.2 volts. 
set(myFGen, 'Amplitude', 1.2);

% Set the offset to 0.4 volts. 
set(myFGen, 'Offset', 0.4);

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

% Enable the output of signals. 
enableOutput(myFGen);

По окончании, отключаете вывод.

% Disable the output of signals. 
disableOutput(myFGen);

Закройте сеанс и удалите его из рабочей области.

disconnect(myFGen);
delete myFGen;
clear myFGen;

Эти примеры использовали стандартный тип формы волны. Для примеров с помощью произвольной формы волны смотрите, Генерируют Стандартные Формы волны Используя Генератор Быстрой Функции управления.

Представленный в R2012a