Описание библиотеки виртуальных инструментов для системы LabView 4.1

Описание библиотеки виртуальных инструментов  для системы LabView 4.1.

ВВЕДЕНИЕ

Для удобства использования DLL-библиотеки UniDriver.dll совместно с системой LabView вместе с DLL-библиотекой поставляется  библиотека виртуальных инструментов, представляющая собой интерфейс с функциями DLL в формате LabView. Библиотека представлена в виде файла Library.LLB.

Импортированные в LabView функции оформлены в виде Виртуальных Инструментов (далее - ВИ) системы LabView.

Перед использованием ВИ необходимо обязательно сконфигурировать библиотеку с помощью утилиты (LA_Name).EXE (см. выше), т.к. средствами предлагаемой библиотеки нельзя выполнить полную настройку библиотеки.

Библиотека ВИ написана для LabVIEW версии 4.1, однако может использоваться и в версии 5.0. Следует помнить, что программы, спасенные в версии 5.0 уже не могут использоваться в версии 4.1.

ФУНКЦИИ ИНТЕРФЕЙСА

Посмотреть имена плат, для которых установлены драйверы (GetBoardNames.vi)

Array of Board Names - Возвращает массив строк, представляющих собой имена плат, драйверы которых установлены. Максимальный размер массива - 15.

Получение интерфейса (Create.vi)

BoardName - название драйвера, соответствующее названию платы:

Device - возвращаемый указатель на объект (плату). Он используется в других функциях в качестве первого параметра как идентификатор платы. При каждом обращении к этой функции указатель увеличивается на 16 единиц.

При неверном задании имени возвращает 0.

Уничтожение интерфейса (Close.vi)

Device Inp and Device Out - вход и выход указателя.

Примечание: Перед выходом из программы выполнение этой функции обязательно.

ФУНКЦИИ РАБОТЫ С ПЛАТОЙ

Везде нижеDevice Inp and Device Out - вход и выход указателя.

Задать основные параметры платы (Setup.vi)

Base Address - базовый адрес.

DRQ - номер канала DMA (если DMA не используется, то 0). В некоторых случаях используются два канала DMA. Тогда DRQ - двухбайтовое число: младший байт - первый канал DMA, старший байт - второй канал DMA.

IRQ - номер прерывания (если прерывания не используются, то 0).

Setup - возвращает 1; при ошибке возвращает отрицательный код ошибки (см. файл ADC_CONST.h).

Проверка на наличие платы (Test.vi)

Test - возвращает >= 1; при отсутствии платы возвращает 0.

Старт драйвера (Start.vi)

Start - возвращает 1; при ошибке возвращает отрицательный код ошибки (см. файл ADC_CONST.h).

Стоп драйвера (Stop.vi)

Запрещение прерываний (ClearInterrupt.vi)

Ожидание аппаратного прерывания (WaitEvent.vi)

TimeOut - Допустимое время ожидания (ms).

Получить блок данных (GetData.vi)

Mode - режим передачи данных. Может быть комбинацией из следующих значений:

0                  - читает данные из DMA 0,

0x80000000 - читает данные из DMA 1,

1                  - конвертирует данные в целочисленный формат, удаляя информацию о номере канала,

2                  - конвертирует данные в целочисленный формат, удаляя информацию о номере канала и нормируя данные в диапазоне -32768:32767.

Dimension Size - размер блока данных.

Offset - смещение относительно начала блока.

Data Array - выходной массив данных.

Получить блок данных (PortIO.vi)

Mode - режим передачи данных. Может принимать одно из следующих значений:

1 - читает байт из порта,

-1 - посылает байт в порт,

2 - читает слово из порта,

-2 - посылает слово в порт,

3 - читает Double из порта,

-3 - посылает Double в порт,

size - размер блока данных.

data - выходной массив данных.

IO - возвращает 1; при ошибке возвращает отрицательный код ошибки (см. файл ADC_CONST.h).

Получить сведения о плате и драйвере (Get.vi)

Mode - значение этого параметра определяет характер сведений, копируемых в переменную Par:

0 - возвращает 1 при готовности данных в случае одиночного преобразования,

1 - результат преобразования в случае одиночного преобразования,

2 - значение счетчика DMA или DMA 0,

3 - значение счетчика DMA 1,

4 - значение бита готовности,

5 - значение бита сигнала ТС,

6 - значение бита внешнего прерывания,

7 - значение бита режима АЦП,

8 - значение статусного регистра «как есть»,

10 - базовый адрес порта,

11 - номер используемого прерывания,

12 - номер используемого канала DMA или DMA 0,

13 - номер используемого канала DMA 1,

14 - частота кварцевого генератора

(следует изменить переменную Par на 4 byte single), 

15 - имя драйвера (следует изменить переменную Par, на String),

16 - производит автоматическую калибровку для тех плат, где это возможно,

18 - адрес таблицы возможных значений базового адреса,

19 - адрес таблицы возможных значений IRQ,

20 - адрес таблицы возможных значений DRQ,

22 - индекс в таблице базовых адресов для адреса порта по умолчанию,

23 - индекс в таблице IRQ для прерывания по умолчанию,

24 - индекс в таблице DRQ для канала DMA по умолчанию,

25 - минимально возможная частота, генерируемая таймером,

26 - максимально возможная частота, генерируемая таймером,

27 - минимальное значение амплитуды,

28 - максимальное значение амплитуды,

30 - размер в байтах, необходимый для записи одного значения,

31 - разрядность АЦП,

32 - маска для выделения кода АЦП,