fgen

Создайте объект Quick-Control Function Generator

Синтаксис

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

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

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

Пример:

 % 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 вольт. Не применяется, если Waveform имеет тип 'Arb'.

ArbWaveformGain

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

BurstCount

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

ChannelNames

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

Driver

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

DriverDetectionMode

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

FMDeviation

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

Frequency

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

Mode

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

ModulationFrequency

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

ModulationSource

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

ModulationWaveform

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

Offset

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

Задает смещение постоянного тока стандартной формы волны, если для параметра «Форма волны» задана стандартная форма волны. Например, стандартная форма волны в диапазоне от + 5,0 вольт до 0,0 вольт имеет смещение постоянного тока 2,5 вольт. Когда значение Waveform установлено в '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, смотрите Использование заполнения клавишей 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