КАРАТ-ЭКСПРЕСС II. Описание

---

Библиотека Karat.dll предоставляет основные функции для взаимодействия КАРАТа и персональной ЭВМ с использованием контроллера моноканала КМ-01. Применение этой библиотеки для адаптеров А-232-01.2 и А-232-02 невозможно. Все функции библиотеки должны описываться с модификатором stdcall . Если вызывающая программа пишется на Delphi, то в основном файле после ключевого слова uses должна вызываться библиотека ShareMem. Все функции (за исключением GetPort) возвращают 0 при ошибке и 1 в случае удачного выполнения операции. Кроме того, функции, генерируют исключения EwriteExcept при ошибке передачи и EreadExcept при ошибке чтения блока. Библиотека экспортирует следующие функции:

function SetPort(Port: PChar): Boolean; stdcall; - устанавливает текущий порт. При ошибке (порт занят, либо не существует) восстанавливается старое значение. Имя порта задается как строка. Например - "COM1";
function GetPort: PChar; stdcall; - возвращает текущий порт;
procedure SetAddrRdModem(addr: PChar); stdcall; - устанавливает адрес удаленного радиомодема "Невод-2".Если длина строки больше нуля (по умолчанию она равна нулю), то эта стока используется в качестве адреса удаленного модема при передаче любой информации;
function GetAddrRdModem: PChar; stdcall; - возвращает текущий адрес удаленного радиомодема;

Все последующие функции принимают в качестве параметра указатель на массив байт. После успешного запроса в этот массив будет помещен результат запроса.

function GetPrb(var Arrays: TByte): Boolean; stdcall; - возвращает сетевые номера всех приборов, подключенных к контроллеру;
function GetArch(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает перечень архивов, содержащихся в приборе с сетевым адресом Addr;
function GetIndParam(Addr,Arch: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает перечень параметров, архивируемых в архиве Arch, прибора Addr;
function GetParam(Addr,Arch,Param: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает массив значений параметра Param, архива Arch, прибора Addr;
function GetStrParam(Addr,Arch,Param: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает описание параметра Param, архива Arch, прибора Addr;
function GetCurParam(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает массив текущих значений всех параметров прибора Addr;
function GetLineParam(Addr,Arch,Year,Mon,Day,Hour: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает массив значений всех параметров архива Arch, прибора Addr;
function GetSerialNum(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает серийный номер прибора Addr;
function GetVers(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает дату версии программного обеспечения прибора Addr;
function GetCurData(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает текущую дату прибора Addr;
function GetLastChange(Addr: Byte;var Arrays: TByte): Boolean; stdcall; - возвращает дату последнего изменения конфигурации прибора Addr;

Формат, в котором возвращаются данные, описан в "Описание протокола доступа к данным теплорегистратора КАРАТ с использованием контроллера моноканала".

Библиотека распространяется басплатно, пользователям этой библиотеки будет оказываться всесторонняя информационная поддержка.