1-RU-163193-1.1

Руководство пользователя

Цель документа

Библиотека SysLibTime предназначена для считывания системного времени ПЛК.

Данный документ содержит описание алгоритмов работы блоков, входные/выходные параметры и типы данных каждого блока, и предназначен для ознакомления с составом библиотеки.

Для полного понимания принципов работы в среде необходимо ознакомиться с руководством пользователя ALTA IDE.

Установка библиотеки

Чтобы подключить библиотеку к проекту:

Откройте редактор Менеджер библиотек одним из способов:

дважды нажмите ЛКМ на системную папку Менеджер библиотек в дереве проекта;
или нажмите ПКМ на системную папку Менеджер библиотек в дереве проекта и выберите в контекстном меню пункт Открыть:
В редакторе Менеджер библиотек откройте вкладку Магазин.
Выберите библиотеку SysLibTime и нажмите кнопку Подключить на карточке библиотеки.
Библиотека добавится в проект и отобразится на вкладке Мои библиотеки в редакторе Менеджер библиотек.

Описание библиотеки SysLibTime

Библиотека SysLibTime содержит функциональные блоки для считывания времени, прошедшего с момента загрузки ПЛК.

В состав библиотеки входят два идентичных по структуре функциональных блока:

ФБ	Единица измерения времени
CurTime	Миллисекунды (мс)
CurTimeUs	Микросекунды (мкс)

Оба блока содержат структуру SysTime64 и различаются только единицей измерения времени, прошедшего с момента загрузки ПЛК.

CurTime

Функциональный блок CurTime считывает время в миллисекундах, прошедшее с момента загрузки ПЛК. Содержит в себе структуру SysTime типа SysTime64.

Имя переменной	Тип данных	Описание
SysTime	SysTime64	Структура
Содержимое структуры:
ulHigh	DWORD	Зарезервировано (всегда 0)
ulLow	DWORD	Время с момента загрузки ПЛК в миллисекундах

Пример:


VAR
    (* Экземпляр ФБ CurTime из библиотеки SysLibTime *)
    SysTime : SysLibTime.CurTime;
    
    UptimeMs : DWORD;           (* Время работы в миллисекундах *)
END_VAR

(* Вызов ФБ CurTime *)
SysTime();

(* Чтение времени работы ПЛК *)
UptimeMs := SysTime.SysTime.ulLow;

END_PROGRAM

CurTimeUs

Функциональный блок CurTimeUs считывает время в микросекундах, прошедшее с момента загрузки ПЛК. Содержит в себе структуру SysTime типа SysTime64.

Имя переменной	Тип данных	Описание
SysTime	SysTime64	Структура
Содержимое структуры:
ulHigh	DWORD	Зарезервировано (всегда 0)
ulLow	DWORD	Время с момента загрузки ПЛК в микросекундах

Пример:


VAR
    (* Экземпляр ФБ CurTimeUs из библиотеки SysLibTime *)
    SysTime : SysLibTime.CurTimeUs;
    
    UptimeUs : DWORD;           (* Время работы в микросекундах *)
END_VAR

(* Вызов ФБ CurTimeUs *)
SysTime();

(* Чтение времени работы ПЛК *)
UptimeUs := SysTime.SysTime.ulLow;

END_PROGRAM