×
Меню
Поиск
 
   
   
   
 
 

1.3.1.1.10.10. Формулы в датчиках

 
Для вычисления значений параметров могут быть использованы формулы.
Формула может начинаться с любого арифметического операнда или знака "=".
 
Если формула начинается с арифметического операнда, то значение параметра вычисляется.
На рисунке 1  формула применяется для настройки параметра IN1.
Финальное значение параметра будет вычислено по формуле IN1 * 0,5.
 
Рисунок 1.
 
На рисунке 2 при получении параметра IN1, описанному датчику будет присвоено значение вычисленное по формуле IN2 *+ 20.
 
Рисунок 2.
 
 
Формулы в обработчиках данных строятся на базе синтаксиса языка PHP и исполняются на сервере при обработке данных для конвертации их в нужный формат.
Формула может быть простой и начинаться непосредственно со знака арифметической операции. Поддерживаются операции прибавить ( + ), отнять ( - ), умножить ( * ), разделить ( / )  , так же поддерживаются круглые скобки для обеспечения правильной последовательности выполнения операции.
Например:
*10 - исходное значение будет умножено на 10
/1000 - исходное значение будет разделено на 1000 
/100+7 - исходное значение будет разделено на 100 и к получившемуся результату будет прибавлено 7
/100+(7*3-2)*4 
В формулу могут подставляться данные из других полей данных , скорость и количество спутников.
Для подстановки значений в формулу их нужно поместить в экранирующие символы %%.
Для скорости используется переменная %S% 
Для количества спутников %P%  или %satsinview%
Для unixtimestamp текущего пакета используйте переменную %ts% 
Для unixtimestamp предыдущего пакета переменную %ts1%. Значение текущего датчика может быть подставлено переменной %value% .
Чтобы получить разницу в секундах относительно предыдущего пакета нужно вычислить  %ts1%-%ts%
Для всех остальных значений из пакета устройства берутся названия так как они присылаются драйвером.
Например: %DIN1%     %DIN2%      %HDOP%
 
 
Пример формулы с переменными:
*%DIN1% - умножить исходное значение на значение присылаемое в поле DIN1
/%HDOP% - разделить исходное значение на значение из поля HDOP
 
Более сложные формулы начинаются со знака = и не используют исходное значение. Но его можно подставить в саму формулу с помощью переменной %value% либо переменной с именем поля. 
Например:
=(1+2) - конечное значение будет равно 3
=(7/%value%) -конечное значение будет равно 7 деленному  на исходное значение 
 
Условные операторы
В формулах могут использоваться условия которые обеспечивают ветвление логики расчета зависящей от значений каких либо параметров или результатов операций.
Нотация условных операторов выглядит так: условие ? значение_если_да  :  значение_если_нет 
 Обычно такую запись называют — тернарный оператор.
Логически это выражение идентично выражению: 
 если условие вернуть значение_если_да иначе вернуть значение_если_нет
В условиях могут использоваться  операторы сравнения равно ( == ), больше ( > ), меньше ( < ), больше или равно ( >= ), меньше или равно (  <= ), не равно ( != )  
Например:
 
  - если значение поля DIN1 равно 1 то конечное значение будет 22 иначе конечное значение будет равно 33
=(%temp%>30)? %temp%*10 : %temp%*20 - если значение поля temp больше 30 то конечное значение будет равно значению поля temp умноженному на 10 иначе конечное значение будет равно значению поля temp умноженному на 20
 
Функции
В формулах могут использоваться некоторые PHP функции для преобразования данных.
Это функции unpack, pack, array_sum, substr, round, hex2bin, dechex, hexdec, decbin, number_format, max, min, abs, str_replace, time, strrev, bytesrev, explode, sqrt, acos, asin, cos, sin, pow.
 
Передаваемые этим функциям значения и возвращаемые значения можно прочитать в документации PHP https://www.php.net/manual/ru/function.acos.php
 
Например:
=substr("%FIELD%", 1, 2) - конечное значение будет равно 2 символам из строки передаваемой в поле FIELD начиная с позиции 1
=round(%AIN1%/1000) - конечное значение будет равно округленному значению частного от деления значения поля AIN1 на 1000
 
Деление на 0 
Чтобы избежать непредсказуемых разультатов при обработке значений датчиков следует избегать переменных в роли делителя или использовать условные операторы для проверки их на 0
Например:
=1000/%DIN1% - может породить ошибку вычисления в случае если значение поля DIN1 не определено или равно 0. В таком случае формулу нужно переписать так:
=(%DIN1%==0) ? 0 : 1000/%DIN1% - если значение поля DIN1 равно 0 то конечное значение равно 0 иначе конечное значение равно частному от деления 1000 на значение поля DIN1 
 
Если температурный блютуз датчик подключенный к Телтоники (Teltonika EYE Sensor) присылает отрицательную температуру,
то ее можно преобразовать следующей формулой.
 
=((%BLE_T1%>3000)?((%BLE_T1%-65535)/100):(%BLE_T1%/100))
 
Пример датчика температуры с формулой
 
 
 
 Пример:
 PAram1=0A, в этом случае функция вернет значение 10.
 
substr('%Data%',x,y) - поиск подстроки длиной в "y" в строке "Data" начиная с позиции "x"
Примеры:
Param1=A6B1
substr(decbin(hexdec('%Param1%')),9,1), формула вернет значение 0.
 
explode — Разбивает строку с помощью разделителя и возвращает массив строк.
=explode('delimiter','%value%')[2]
delimiter - разделитель
value - строка, которую необходимо разделить.