Типы датчиков
Датчики с аналоговым выходом могут быть следующих типов:
temperature - датчик температуры (VT500 Temperature sensor и др.);
- humidity - датчик относительной влажности (VT510 Humidity sensor);
- voltage - датчик напряжения (VT520 AC voltage monitor и др.);
- fvoltage - датчик напряжения преобразовательный (VT410 DC voltage monitor);
- current - датчик тока;
- fcurrent - датчик тока преобразовательный (VT420 Converter и др.);
- vibration - датчик вибрации;
- power - мощность, используется в устройствах с функцией измерения энергетических параметров нагрузки;
- frequency - частота, используется в устройствах с функцией измерения энергетических параметров нагрузки;
- factor - прочие энергопараметры, используется в устройствах с функцией измерения энергетических параметров нагрузки;
- dewpoint - виртуальный датчик точки росы.
Чтение параметров
Чтение осуществляется командой getelement, с параметрами:
- k - идентификатор сессии пользователя;
id - идентификатор элемента;
- period - временной интервал накопленных данных, возможны следующие значения: "100seconds", "100minutes", "100hours", "100days",
- mode - режим вывода данных, должен быть "xml".
Примеры ответов на запрос элемента класса "analog":
<element id="201001" index="1" module="2005" clas="analog" type="temperature" name="Onboard Temperature" state="normal" value="37.5" vmax="110.0" vmin="-50.0" low_alarm="0.0" low_warning="5.0" high_warning="45.0" high_alarm="50.0" at0="1.000" at75="0.000" um="°C"></element> <element id="208001" index="16" module="2014" clas="analog" type="power" name="Outlets bank A-Psum" state="low alarm" value="0.0" vmax="20000.0" vmin="0.0" low_alarm="0.0" low_warning="0.0" high_warning="3000.0" high_alarm="3600.0" um="W" descr="Power"></element> |
Где:
id — уникальный идентификатор элемента;
- index — для внутреннего использования;
- module — идентификатор модуля которому принадлежит элемент;
- clas — класс элемента;
- type — описывает тип элемента внутри класса;
name — имя элемента;
- state — состояние элемента;
- hwport — аппаратный порт, определяет расположение разъема на корпусе устройства;
value — числовое значение соответствующее измеряемой величине;
utype — тип определяемый пользователем;
vmin — максимальное значение для диапазона измерений;
- vmax — минимальное значение для диапазона измерений;
- low_alarm — нижний порог тревоги;
- low_warning — нижний порог нормального диапазона;
- high_warning — верхний порог нормального диапазона;
- high_alarm — верхний порог тревоги;
- at0 — коэффициент калибровки в формуле at0*x+at75;
- at75 — коэффициент калибровки в формуле at0*x+at75;
- expr — выражение для вычисления выходной величины (для преобразовательных датчиков);
- um — еденица измерения данного элемента;
- descr — вспомогательное описание элемента.
Если какой-то атрибут из указанных в ответе отсутствует - значит значение этого атрибута не определяется в процессе работы и его установка не влияет на работу элемента.
При чтении элемента, также выдается временной лог измеряемой величины, в виде:
|
Показания датчика разбиты на группы: 100 секунд посекундно, 100 минут поминутно, 100 часов и 100 суток. Показания датчика (поле 'v') указываются с временной меткой (поле 't').
Модификация параметров
- k - идентификатор сессии пользователя;
id - идентификатор элемента;
С дополнительными параметрами доступными для модификации:
name — имя элемента;
- low_alarm — нижний порог тревоги;
- low_warning — нижний порог нормального диапазона;
- high_warning — верхний порог нормального диапазона;
- high_alarm — верхний порог тревоги;
- at0 — коэффициент калибровки в формуле at0*x+at75;
- at75 — коэффициент калибровки в формуле at0*x+at75;
- expr — выражение для вычисления выходной величины (для преобразовательных датчиков);
- utype — тип определяемый пользователем.
Сброс лога измеряемой величины
Осуществляется командой resetelementdata:
- k - идентификатор сессии пользователя;
id - идентификатор элемента;
- period - временной интервал накопленных данных который нужно удалить, возможны следующие значения: "100seconds", "100minutes", "100hours", "100days",
Параметры гистерезиса
Дополнительные параметры для управления гистерезисом, читаются командой getelement, устанавливаются командой updateelement, вместе с остальными параметрами датчика.
hyst_type - тип алгоритма, используемого для расчета гистерезиса:
- disable - гистерезис отключен;
- value - гистерезис по значению измеряемой датчиком величины;
- time - гистерезис по времени (используется по умолчанию).
- hyst_value - величина отклонения значения датчика при расчете гистерезиса по величине, значение с плавающей точкой (минимум 0, максимум 10000, по умолчанию 0.3);
- hyst_low_alarm - время в секундах, в течение которого датчик должен сохранять свое значение в данном диапазоне, для перехода датчика в данное состояние (минимум 0, максимум 1000, по умолчанию 1);
- hyst_low_warning - тоже (по умолчанию 1);
- hyst_normal - тоже (по умолчанию 0);
- hyst_high_warning - тоже (по умолчанию 1);
- hyst_high_alarm - тоже (по умолчанию 1).
При запросе getelement в ответе выдаются все параметры, независимо от типа алгоритма. При updateelement можно указывать все парамеры, или только те что необходимо изменить.
Эти параметры также актуальны для датчиков виртуального типа, например dewpoint.