Библиотека RshUniDriver
SDK 2.1
Документация по программированию
|
Константы возможностей CAPS для Rsh SDK. Подробнее...
Константы возможностей CAPS для Rsh SDK.
enum RSH_CAPS |
Список возможностей устройства и программного обеспечения
Позволяет узнать, какие возможности поддерживаются устройством и библиотекой абстракции, используя метод IRshDevice::Get() с параметром RSH_GET_DEVICE_IS_CAPABLE.
Элементы перечислений | |
---|---|
RSH_CAPS_DEVICE_PCI |
Устройство с интерфейсом PCI. |
RSH_CAPS_DEVICE_PCI_EXPRESS |
Устройство с интерфейсом PCI Express. |
RSH_CAPS_DEVICE_USB1_1 |
Устройство с интерфейсом USB 1.1. |
RSH_CAPS_DEVICE_USB2_0 |
Устройство с интерфейсом USB 2.0. |
RSH_CAPS_DEVICE_USB3_0 |
Устройство с интерфейсом USB 3.0. |
RSH_CAPS_DEVICE_ETHERNET |
Устройство с интерфейсом Ethernet. |
RSH_CAPS_DEVICE_FREQUENCY_SYNTHESIZER |
Устройство имеет синтезатор частоты. Синтезатор частоты позволяет плавно изменять частоту дискретизации, в отличие от устройств с делителем частоты, у которых есть некая максимальная частота дискретизации Fmax и кратные ей частоты Fmax/2, Fmax/4 и т.д.
|
RSH_CAPS_DEVICE_TIMER_8254 |
В устройстве установлен программируемый счетчик-таймер Intel 8254. Используя структуру инициализации RshInitTimer можно задать нестандартный режим сбора данных.
|
RSH_CAPS_DEVICE_MEMORY_PER_CHANNEL |
Устройство поддерживает возможность задать произвольный размер блока для каждого измерительного канала. |
RSH_CAPS_DEVICE_FREQUENCY_LIST |
Устройство имеет таблицу фиксированных частот квантования. Список частот дискретизации может быть получен с помощью метода IRshDevice::Get() с параметром RSH_GET_DEVICE_FREQUENCY_LIST.
|
RSH_CAPS_DEVICE_SIZE_LIST |
Устройство имеет таблицу фиксированных размеров. Список частот дискретизации может быть получен с помощью метода IRshDevice::Get() с параметром RSH_GET_DEVICE_SIZE_LIST.
Если у устройства нет таблицы размеров, можно получить минимальный и максимальный допустимый размер в отсчетах на канал, используя метод IRshDevice::Get() с параметрами RSH_GET_DEVICE_MIN_SAMPLES_PER_CHANNEL и RSH_GET_DEVICE_MAX_SAMPLES_PER_CHANNEL соответственно. |
RSH_CAPS_DEVICE_HAS_DIGITAL_PORT |
Устройство имеет цифровые линии для ввода (вывода) данных Дополнительную информацию о цифровых портах устройства можно получить, используя метод IRshDevice::Get() с параметром RSH_GET_DEVICE_PORT_INFO. Полученная структура RshBoardPortInfo содержит все необходимые данные для организации управления цифровыми вводом/выводом.
|
RSH_CAPS_DEVICE_GAIN_LIST |
Устройство имеет таблицу коэффициентов усиления. Получить список коэффициентов усиления можно с помощью метода IRshDevice::Get() с параметром RSH_GET_DEVICE_GAIN_LIST.
|
RSH_CAPS_DEVICE_GAINS_PER_CHANNEL |
Поддерживается установка коэффициента усиления индивидуально для каждого канала. Список коэффициентов усиления может быть получен с помощью метода IRshDevice::Get() с параметром RSH_GET_DEVICE_GAIN_LIST.
|
RSH_CAPS_DEVICE_PREHISTORY |
Доступна возможность записи предыстории измерения. Используя поле RshInitMemory::preHistory структуры инициализации, можно задать, какая часть буфера данных будет использована для записи данных "предыстории" (до события синхронизации) и "истории" (после события синхронизации).
|
RSH_CAPS_DEVICE_DOUBLE_FREQUENCY_MODE |
Устройство поддерживает режим сбора данных с удвоенной частотой дискретизации. Некоторые из высокочастотных устройств с собственной памятью могут работать в так называемом режиме удвоения частоты. Как правило, на таких устройствах установлено отдельное АЦП для оцифровки каждого канала. Когда устройство работает в обычном режиме, все АЦП работают параллельно, каждое цифрует данные со своего аналогового канала.
|
RSH_CAPS_DEVICE_QUADRO_FREQUENCY_MODE |
Устройство поддерживает режим режим сбора данных с учетверенной частотой дискретизации. Данный режим аналогичен удвоению частоты (RSH_CAPS_DEVICE_DOUBLE_FREQUENCY_MODE), единственное отличие - частота умножается на 4, а не на 2. Число каналов, соответственно, тоже делится на 4. |
RSH_CAPS_DEVICE_AUTO_CALIBRATION |
Устройство поддерживает режим автокалибровки. Автоматическая внутренняя калибровка. Процедура калибровки индивидуальна для каждого устройства. Например, плата Леонардо II настраивает уровни смещения нуля при вызове метода IRshDevice::Get() с параметром RSH_GET_DEVICE_AUTO_CALIBRATION_SET.
|
RSH_CAPS_DEVICE_SYNCHRO_INTERNAL |
Аналоговые каналы устройства могут быть использованы в качестве источника синхронизации. Используя структуру инициализации RshInitMemory можно задать порог срабатывания, условие перехода (фронт или спад), а также некоторые другие параметры и выбрать один из аналоговых входных каналов устройства в качестве источника синхронизации. После запуска процесса сбора данных с помощью метода IRshDevice::Start(), устройство будет ожидать прихода события синхронизации в соотвествии с заданными параметрами.
|
RSH_CAPS_DEVICE_SYNCHRO_EXTERNAL |
Устройство имеет дополнительный вход, который может быть использован в качестве источника синхронизации. Параметры синхронизации (порог, условие перехода, использование фильтра и др.) могут быть заданы в структуре RshInitMemory. После запуска сбора данных с помощью метода IRshDevice::Start(), устройство будет ожидать прихода события синхронизаци в соотвествии с заданными параметрами.
|
RSH_CAPS_DEVICE_EXTERNAL_START |
Устройство поддерживает возможность внешнего запуска преобразования. Процесс сбора данных может быть запущен подачей TTL сигнала на определенный цифровой вход устройства. Информация о подключении, уровне сигнала и условиях срабатывания содержится в руководстве пользователя для конкретного устройства.
|
RSH_CAPS_DEVICE_HYSTERESIS |
Устройство имеет возможность задания уровня гистерезиса для синхронизации. Некоторые устройства с аппаратной цифровой синхронизацией имеют возможность программно задавать уровень гистерезиса.
|
RSH_CAPS_DEVICE_EXT_SYNC_GAIN_LIST |
Устройство имеет отдельный список коэффициентов усиления для входа внешней синхронизации. Вход внешней синхронизации часто отличается от обычных аналоговых входов, и может иметь свой собственный список коэффициентов усиления. Получить этот список можно используя метод IRshDevice::Get() с параметром RSH_GET_DEVICE_EXT_SYNC_GAINLIST.
|
RSH_CAPS_DEVICE_EXT_SYNC_FILTER_LOW |
Фильтр низких частот может быть включен для входа внешней синхронизации. Полоса пропускания, подавление и другие характеристики фильтра зависят от типа устройства, более подробная информация содержится в руководстве пользователя.
|
RSH_CAPS_DEVICE_EXT_SYNC_FILTER_HIGH |
Фильтр высоких частот может быть включен для входа внешней синхронизации. Полоса пропускания, подавление и другие характеристики фильтра зависят от типа устройства, более подробная информация содержится в руководстве пользователя.
|
RSH_CAPS_DEVICE_EXT_SYNC_INPUT_RESIST_50_OHM |
Доступен режим входного сопротивления 50Ом для входа внешней синхронизации. Если, кроме того, активен режим RSH_CAPS_DEVICE_EXT_SYNC_INPUT_RESIST_1_MOHM, можно программно переключать входное сопротивление входа, используя поле RshInitMemory::channelSynchro структуры RshInitMemory.
|
RSH_CAPS_DEVICE_EXT_SYNC_INPUT_RESIST_1_MOHM |
Доступен режим входного сопротивления 1МОм для входа внешней синхронизации. Если, кроме того, активен режим RSH_CAPS_DEVICE_EXT_SYNC_INPUT_RESIST_50_OHM, можно программно переключать входное сопротивление входа, используя поле RshInitMemory::channelSynchro структуры RshInitMemory.
|
RSH_CAPS_DEVICE_EXT_SYNC_COUPLING_AC_DC |
Доступна возможность переключения состояния входа внешней синхронизации "Открытый"/"Закрытый". Если синхровход работает в режиме входного сопротивления 1МОм, есть возможность задать состояние входа: открытый (постоянная составляющая сигнала учитывается) или закрытый (постоянная составляющая сигнала отбрасывается). Для установки параметра используется поле RshInitMemory::channelSynchro структуры RshInitMemory.
|
RSH_CAPS_DEVICE_HAS_DAC_INSTALLED |
Устройство имеет один или несколько ЦАПов. Управлять ЦАПами можно с помощью метода IRshDevice::Init(), используя структуру инициализации RshInitDAC.
|
RSH_CAPS_DEVICE_INPUT_LEVEL_ADJUSTMENT |
Устройство имеет возможность подстройки уровня входного напряжения аналоговых каналов. Обычно, диапазон подстройки уровня входного напряжения совпадает со входным диапазоном канала. Управлять этим параметром можно отдельно для каждого канала в списке RshInitADC::channels, используя поле RshChannel::adjustment.
|
RSH_CAPS_DEVICE_INPUT_COUPLING_AC_DC |
Доступна возможность переключения состояния аналоговых входов "открытый/закрытый". Если аналоговый канал поддерживает входное сопротивление 1МОм, в этом режиме можно переключать состояние канала между "открытый вход" и "закрытый вход", устанавливая один из флагов (RshChannel::AC или RshChannel::DC) в поле RshChannel::control для выбранного канала в списке RshInitMemory::channels в структуре инициализации RshInitMemory.
|
RSH_CAPS_DEVICE_INPUT_RESIST_50_OHM |
Доступен режим входного сопротивления 50Ом для аналоговых каналов. Если, кроме того, активен режим RSH_CAPS_DEVICE_INPUT_RESIST_1_MOHM, можно программно переключать входное сопротивление входа, используя поле RshChannel::control для выбранного канала в списке RshInitMemory::channels структуры RshInitMemory.
|
RSH_CAPS_DEVICE_INPUT_RESIST_1_MOHM |
Доступен режим входного сопротивления 1МОм для аналоговых каналов. Если, кроме того, активен режим RSH_CAPS_DEVICE_INPUT_RESIST_50_OHM, можно программно переключать входное сопротивление входа, используя поле RshChannel::control для выбранного канала в списке RshInitMemory::channels структуры RshInitMemory.
|
RSH_CAPS_DEVICE_FRAME_FREQUENCY_MODE |
Устройство поддерживает режим кадрового сбора. В этом режиме задаются две частоты:
|
RSH_CAPS_DEVICE_PACKET_MODE |
Устройство поддерживает пакетный режим сбора данных. Этот режим используется для устройств сбора данных с установленной собственной памятью. Такие устройства собирают данные во внутренний буфер (размер которого может составлять несколько мегабайт), а затем передают эти данные в компьютер по относительном медленным интерфейсам (USB, PCI). Если задан небольшой размер буфера для сбора, основное время уходит не на сбор данных, а на инициализацию сбора и передачу их в компьютер. Пакетный режим, таким образом, может быть очень полезен: в этом режиме можно задать размер блока данных( поле RshInitMemory::bufferSize) и количество этих блоков (поле RshInitMemory::packetNumber). Очевидно, что итоговый размер, равный bufferSize*packetNumber, должен быть меньше, чем максимальный объем доступной внутренней памяти MaximumMemory (его можно узнать с помощью метода IRshDevice::Get() с параметром RSH_GET_DEVICE_MEMORY_SIZE).
|
RSH_CAPS_DEVICE_START_DELAY |
Сбор данных может быть начат с задержкой (относительно события синхронизации) Если устройство работает в режиме ожидания события синхронизации, можно задать интервал времени (поле RshInitMemory::startDelay), определяющий задержку старта. Когда будет получено событие синхронизации, запись данных в буфер начнется не мгновенно, а через заданное в поле startDelay время.
|
RSH_CAPS_DEVICE_SLAVE_MASTER_SWITCH |
Сбор данных может быть запущен от ведущего устройства. Задав RshInitADC::Master в качестве источника запуска в поле RshInitADC::startType, можно сделать устройство "ведомым" (slave). После вызова метода IRshDevice::Start(), устройство будет находиться в режиме ожидания (как при использовании синхронизации), и сбор данных начнется только при получении специального сигнала от ведущего (Master) устройства
|
RSH_CAPS_DEVICE_SYNCHRO_CHANNELS |
Аналоговые каналы устройства - синхронные. Если данный флаг активен, устройство имеет свой собственный АЦП на каждом из аналоговых каналов, все эти АЦП тактируются из одного источника, и данные со всех каналов собираются синхронно.
|
RSH_CAPS_DEVICE_EXTERNAL_FREQUENCY |
АЦП может тактироваться из внешнего источника. Чтобы включить эту возможность, нужно установить бит RshInitADC::FrequencyExternal в поле RshInitADC::startType структуры инициализации. Можно комбинировать этот режим (используя логическое ИЛИ) с другими флагами, например RshInitADC::Timer, RshInitADC::Internal.
|
RSH_CAPS_DEVICE_FREQUENCY_SWITCH_PREHISTORY |
Доступна возможность переключения частоты дискретизации после получения события синхронизации. Если доступна данная возможность, можно использовать две разные частоты для "предыстории" и "истории" данных в буфере. Частота предыстории задается как обычно (поле frequency структуры инициализации), а частота истории может быть переключена либо на максимальную для данного устройства частоту (Fmax), либо на частоту Fmax/8.
|
RSH_CAPS_DEVICE_FREE_CHANNEL_SELECT_IN_EXT_MODE |
Можно выбрать канал (каналы), который будут использоваться в режиме удвоения (учетверения) частоты. Если доступна данная возможность, можно указать, какой канал (или каналы) будет использоваться в режиме удвоения частоты. По умолчанию, всегда используется нулевой канал (или четные каналы, если их количество больше двух). Выбор каналов осуществляется с помощью стандартного флага RshChannel::Used в списке RshInitMemory::channels структуры инициализации.
|
RSH_CAPS_DEVICE_DIFFERENTIAL_INPUT_MODE |
Доступна возможность программно переключаться между однополюсным/дифференциальным режимом. По умолчанию, устроства работают в однополюсном режиме. Чтобы задействовать дифференциальный режим работы, нужно установить флаг RshInitDMA::DiffMode в поле RshInitDMA::control структуры инициализации.
|
RSH_CAPS_DEVICE_FLASH_INFO_ONBOARD |
Устройство имеет энергонезависимую память (флэш), которая содержит дополнительную информацию. Наличие данного флага означает, что устройство располагает дополнительной памятью, в которую может быть записан заводской номер платы, различные настроечные коэффициенты и другая информация. Как правило, информация записывается на этапе настройки и в процессе эксплуатации доступна только для чтения. |
RSH_CAPS_DEVICE_GPS_MODULE_INSTALLED |
Устройство имеет GPS-модуль Получить данные GPS можно, вызвав метод IRshDevice::Get() с параметром RSH_GET_DEVICE_GPS_DATA или RSH_GET_DEVICE_GPS_DATA_UTF16.
|
RSH_CAPS_DEVICE_AUTO_START_MODE |
Устройство поддерживает режим автоматического запуска Устройство может быть запрограммировано таким образом, что сбор данных будет запускаться автоматически, с заданным интервалом. Интервал запуска можно задать, используя метод IRshDevice::Get() с параметром RSH_GET_DEVICE_AUTO_START_INTERVAL_SET.
|
RSH_CAPS_DEVICE_DIGITAL_PORT_DATA_WITH_ANALOG_DATA |
Цифровые данные могут передаваться вместе с аналоговыми. Устройство имеет возможность получать данные со своего цифрового порта или входных цифровых линий вместе с аналоговыми данными. Цифровые данные помещаются в несколько младших битов каждого слова данных.
|
RSH_CAPS_SOFT_CALIBRATION_IS_AVAILABLE |
Библиотека абстракции содержит методы для проведения автоматической настройки и калибровки устройства. Наличие данного флага означает, что устройство может быть откалибровано (настройка внутренних коэффициентов) программно, с использованием внешнего источника сигнала и эталонного измерительного прибора. |
RSH_CAPS_SOFT_GATHERING_IS_AVAILABLE |
Библиотека абстракции содержит методы для осуществления сбора данных в режиме "старт-стоп". Устройство может быть запрограммировано для сбора данных в режиме "Старт-Стоп". В этом режиме происходит одиночный запуск устройства, сбор одного блока данных с заданными параметрами (частота дискретизации, размер и т.д.) и остановка устройства. Этот сценарий работы является наибоелее распространенным.
|
RSH_CAPS_SOFT_PGATHERING_IS_AVAILABLE |
Библиотека абстракции содержит методы для осуществления сбора данных в непрерывном режиме В этом режиме АЦП запускается один раз, и затем оцифровывает входные сигналы непрерывно, генерируя прерывание каждый раз, когда готова очередная порция данных. Этот процесс может продолжаться долгое время (теоретически, бесконечно) и будет остановлен только при вызове метода IRshDevice::Stop().
|
RSH_CAPS_SOFT_DIGITAL_PORT_IS_AVAILABLE |
Библиотека абстракции содержит методы для управления цифровым портом. Используя метод IRshDevice::Init() и структуру инициализации RshInitPort можно читать и записывать данные в цифровой порт устройства. Получить информацию о цифровом порте можно, используя метод IRshDevice::Get() с параметром RSH_GET_DEVICE_PORT_INFO.
|
RSH_CAPS_SOFT_GENERATION_IS_AVAILABLE |
Библиотека абстракции содержит методы для генерации сигнала. Используя структуру инициализации RshInitGSPF можно задать параметры генерации сигнала, и затем отправить сформированный буфер данных с сигналом в устройство, используя метод IRshDevice::GetData().
|
RSH_CAPS_SOFT_INIT_MEMORY |
Структура инициализации RshInitMemory поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_INIT_DMA |
Структура инициализации RshInitDMA поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_INIT_GSPF |
Структура инициализации RshInitGSPF поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_INIT_VOLTMETER |
Структура инициализации RshInitVoltmeter поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_INIT_TIMER |
Структура инициализации RshInitTimer поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_STROBOSCOPE |
Библиотека абстракции содержит методы для реализация программного стробоскопа. Стробоскопирование работает только для периодических сигналов, и при включенной синхронизации. Получая информацию о точном моменте срабатывания синхронизации, можно из нескольких реализации периодического сигнала построить одну, но с более высоким временным разрешением. |
RSH_CAPS_SOFT_INIT_DAC |
Структура инициализации RshInitDAC поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_INIT_PORT |
Структура инициализации RshInitPort поддерживается библиотекой абстракции. Использовать эту структуру для передачи параметров можно в методе IRshDevice::Init().
|
RSH_CAPS_SOFT_TUNER_MODE_IS_AVAILABLE |
Внутренние настройки устройства могут быть изменены с использованием данной библиотеки абстракции. Для изменения значений внутренних настроечных коэффициентов устройства используется специальный набор методов и структур, которые являются закрытыми. Тюнер используется только при первоначальной настройке и предпродажной подготовке устройства. |
RSH_CAPS_MAX |
Максимальное количество значений в перечислении RSH_CAPS. |