Типы датчиков

Датчики с аналоговым выходом могут быть следующих типов:

• 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":

Где:

• 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 — вспомогательное описание элемента.

Если какой-то атрибут из указанных в ответе отсутствует - значит значение этого атрибута не определяется в процессе работы и его установка не влияет на работу элемента.

При чтении элемента, также выдается временной лог измеряемой величины, в виде:

<time t="6849" last="6749" period="1">
<d v="9.351" t="6848"/>
<d v="12.109" t="6847"/>
<d v="19.629" t="6846"/>
...

<d v="19.629" t="6749"/>
</time>
<time t="6863" last="804" period="60">
<d v="11.107" t="6803"/>
<d v="30.620" t="5743"/>
<d v="12.451" t="3683"/>
...

<d v="19.629" t="804"/>
</time>
<time t="3624" last="24" period="3600">
<d v="1.096" t="24"/>
</time>
<time t="24" last="24" period="86400">
</time>

Показания датчика разбиты на группы: 100 секунд посекундно, 100 минут поминутно, 100 часов и 100 суток. Показания датчика (поле 'v') указываются с временной меткой (поле 't').

Модификация параметров

• 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.