Регистрация  Вход
Ваша корзина пуста
Динамическая библиотека STEP.dll

Динамическая библиотека STEP.dll предназначена разработки собственного программного обеспечения для персонального компьютера, осуществляющего обмен данными c USB-реле серии "КОЛИБРИ" и Ethernet-контроллерами серии КОРТЕКС по протоколу STEP через виртуальный COM-порт.

Она содержит набор функций, реализующих все поддерживаемые устройством команды. Библиотека написана на языке Delphi в среде Embarcadero RAD Studio.

Ниже приведено подробное описание процедур и функций библиотеки. Функции возвращают значение "истина" в случае успешного выполнения операций и "ложь" при ошибке. Тип возвращаемого результата – LongBool (32-битный логический тип).

  function dllVersion : Byte;

Возвращает текущую версию библиотеки (старшая тетрада содержит целую часть версии, младшая – дробную).

  function stCOMPortList : PWideChar;

Возвращает список доступных COM-портов в виде списка текстовой строки с разделителями ":". Каждый элемент имеет структуру "COM", где – номер соответствующего COM-порта. Список отсортирован по возрастанию номеров. Пример возвращаемой строки: COM1:COM2:COM14:COM22

  function stInit(nCOM : Byte) : LongBool;

Открывает COM-порт с номером nCOM.

  procedure stDone;

Закрывает COM-порт, открытый функцией stInit.

  procedure stStart(cmd : Byte) : LongBool;

Создаёт новый пакет данных с командой cmd.

  procedure stAddByte(b : Byte);
  procedure stAddWord(w : Word);
  procedure stAddDWord(dw : LongWord);

Добавляют в пакет данных, созданный функцией stStart, соответственно, байт, 16-битное целое число и 32-битное целое число.

  function stPutPackage : LongBool;

Отправляет сформированный пакет данных в устройство. После отправки функция будет ожидать подтверждения от устройства, а если оно не пришло, то вернёт ошибку.

  function stCntBytesInBuf : Word;

Возвращает текущее количество данных во внутреннем буфере. После выполнения команд stStart и stAddxxx результатом данной функции будет количество данных в формируемом пакете, а после выполнения команды stPutPackage функция вернёт количество данных в ответе от устройства.

  function stReadByte(b : Byte);
  function stReadWord(w : Word);
  function stReadDWord(dw : LongWord);

Считывают из внутреннего буфера, соответственно, байт, 16-битное целое число и 32-битное целое число.

  procedure stSkipByte(n : Word);

Пропускает заданное количество байт во внутреннем буфере. Это функция анало-гична вызову функции stReadByte n-ое количество раз.

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

В общем виде порядок формирования запроса к устройству будет следующий:

  • вызывается функция stStart, в которой указывается код необходимой команды;
  • при помощи функций stAddxxx добавляются необходимые данные в пакет;
  • функцией stPutPackage осуществляется отправка пакета и получение результата доставки;
  • если пакет был доставлен, то при помощи функций stReadxxx осуществляется считывание данных из ответа устройства.

Назначение остальных функций подробно описано в заголовочных файлах для языков Delphi и C#, поставляемых вместе с библиотекой.