Описание компонента COM_RL (компонента для обеспечения работы с приборами RealLab! всех серий). Сведения по использованию компонента

Описание компонента COM_RL

Компонент предназначен для обеспечения работы с приборами RealLab! всех серий и содержит 3 интерфейса:

1. IRL_Device - общий интерфейс для получения информации о приборе;

2. IR_Device_Control - интерфейс для управления прибором;

3. IRL_Device_Data - интерфейс для доступа к данным.

Каждый интерфейс содержит несколько методов. Ниже приводится полное описание методов всех интерфейсов.

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

______________________Интерфейс IRL_Device.

1. GetNumberOfChannels(short ChannelMode, short * NumberOfChannels, short * EnabledChannels)

Назначение:

возвращает общее число каналов заданного типа и число активных каналов этого же типа в устройстве;

Параметры:

ChannelMode - режим работы интересующих каналов (чтение - 1, запись - 2);

NumberOfChannels - количество каналов заданного типа в устройстве;

EnabledChannels - количество активных каналов заданного типа.

2. IsChannelEnabled(short ChannelMode, short ChannelNumber, short * EnabledFlag)

Назначение:

возвращает состояние указанного канала (активен или нет).

Параметры:

ChannelMode - режим работы интересующего канала;

ChannelNumber - номер интересующего канала;

EnabledFlag - флаг активности канала (активен - 1, неактивен - 0).

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

______________________Интерфейс IRL_Device_Control.

1. Connect(short PortNumber, short ConectionMode)

Назначение:

открывает порт с заданным номером (к которому, если всё нормально, должно быть подключено устройство) в заданном режиме:

-  только для чтения для приборов RL-40AI, RL-8AI, RL-8AC;

-  только для записи для приборов RL-8AO, RL-8AC;

-  чтение/запись для приборов RL-8AC и связки RL-8AO c RL-8AI или RL-40AI.

Параметры:

PortNumber - номер последовательного порта (начинаются с 1)

ConectionMode - режим подключения (только чтение - 1, только запись - 2, чтение/запись - 3)

2. Disconnect()

Назначение:

закрывает порт подключения прибора.

3. CreateChannel(short ChannelMode, short ChannelNumber)

Назначение:

создаёт хранилище данных для одного физического канала (канала устройства) заданного типа

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0).

4. DeleteChannel(short ChannelMode, short ChannelNumber)

Назначение:

удаляет хранилище данных физического канала без сохранения данных.

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0).

5. EnableChannel(short ChannelMode, short ChannelNumber)

Назначение:     помечает канал как активный и помещает его в очередь обрабатываемых потоком порта каналов (с момента этого вызова для каналов ввода данные начинают накапливаться, а для каналов вывода - выводиться в порт).

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0).

6. DisableChannel(short ChannelMode, short ChannelNumber)

Назначение:

помечает канал как неактивный и удаляет его из очереди обрабатываемых потоком порта данных (прекращается приём/передача на этом канале).

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0).

7. GetChannelParams(short ChannelMode, short ChannelNumber, double *TimeInterval, short *DequeLength)

Назначение:

получение текущих настроек канала (канал создаётся с длинной буфера равной 1000 отсчётов,   временной интервал в данной версии не используется).

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0);

TimeInterval - интервал времени между двумя отсчётами (в данной версии не используется);

DequeLength - максимальная длина буфера данных.

8. SetChannelParams(short ChannelMode, short ChannelNumber, double *TimeInterval, short *DequeLength)

Назначение:

устанавливает параметры канала

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0);

TimeInterval - интервал времени между двумя отсчётами (в данной версии не используется);

DequeLength - максимальная длина буфера данных.

9. Start()

Назначение:

запускает поток обработки активных каналов.

10. Stop()

Назначение:

останавливает поток обработки активных каналов.

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

______________________Интерфейс IRL_Device_Control.

1. ClearDeque(short ChannelMode, short ChannelNumber)

Назначение:

очищает буфер заданного канала (рекомендуется использовать для каналов вывода).

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0).

2. GetLastPoint(short ChannelMode, short ChannelNumber, short *Data, double *Time)

Назначение:

возвращает последнюю точку по заданному каналу (рекомендуется использовать для каналов ввода).

Параметры:

ChannelMode - режим работы интересующего канала  (чтение - 1, запись - 2);

ChannelNumber - номер интересующего канала (начинаются с 0);