Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Both sides previous revision Предыдущая версия
Следущая версия
Предыдущая версия
ru:sidebar:remoteapi:apiref:unit:update_sensor [07/12/2018 11:34]
pash [Параметры]
ru:sidebar:remoteapi:apiref:unit:update_sensor [12/06/2023 08:37] (текущий)
pash [Конфигурация датчиков]
Строка 43: Строка 43:
 | tbl | таблица расчета | | tbl | таблица расчета |
  
-Флаги датчика:+**Типы датчиков:**
  
-^ Флаг ^ Описание ^ 
-| 0x01 | Тип счетчика:​ мгновенный | 
-| 0x02 | Тип счетчика:​ дифференциальный | 
-| 0x03 | Тип счетчика:​ дифференциальный с переполнением (2 байта) | 
-| 0x04 | Тип счетчика:​ переключатель из ВЫКЛ в ВКЛ | 
-| 0x05 | Тип счетчика:​ Переключатель из ВКЛ в ВЫКЛ | 
-| 0x20 | включить опцию "С переполнением"​ (см. ниже) | 
-| 0x40 | Применять нижнюю/​верхнюю границы ПОСЛЕ расчета (см. ниже) | 
- 
-:!: **Уточнение для 0x20**: ​ 
-- актуально для следующих датчиков:​ 
-  * **mileage**;​ 
-  * **absolute fuel consumption**;​ 
-  * **engine hours**. 
- 
-Если флаг 0x20 не задан, то датчик работает так: дельта изменения будет равна abs(V2 - V1), где V2 -- новое сообщение,​ V1 -- предыдущее,​ abs() -- модуль числа; если флаг задан, то при V2 < V1 дельтой будет считаться V2 (т.е. V1 = 0). 
- 
-:!: ** Уточнение для 0x40**:​\\ ​ 
-  - если флаг не указан:​ граница применяется к сырым данным (в случае с ДУТ могут быть проблемы с указанием границ к сырым данным);​ 
-  - если флаг указан:​ граница будет применена к данным,​ полученным после преобразования. 
- 
- 
-Типы датчиков:​ 
   * **absolute fuel consumption** - датчик абсолютного расхода топлива;​   * **absolute fuel consumption** - датчик абсолютного расхода топлива;​
   * **accelerometer** - акселерометр;​   * **accelerometer** - акселерометр;​
Строка 91: Строка 68:
   * **trailer** - привязка прицепа;​   * **trailer** - привязка прицепа;​
   * **voltage** - датчик напряжения;​   * **voltage** - датчик напряжения;​
-  * **weight sensor** - датчик веса.+  * **weight sensor** - датчик веса
 +  * **tag** - датчик пассажира;​ 
 +  * **real-time motion sensor** - датчик мгновенного определения движения. 
  
 Здесь можно прочитать о [[http://​docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/​types|типах датчиков]] подробно. Здесь можно прочитать о [[http://​docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/​types|типах датчиков]] подробно.
 +
 +
 +**Флаги датчика:​**
 +
 +^ Флаг ^ Описание ^
 +| 0x01 | Тип счетчика:​ мгновенный |
 +| 0x02 | Тип счетчика:​ дифференциальный |
 +| 0x03 | Тип счетчика:​ дифференциальный с переполнением (2 байта) |
 +| 0x04 | Тип счетчика:​ переключатель из ВЫКЛ в ВКЛ |
 +| 0x05 | Тип счетчика:​ Переключатель из ВКЛ в ВЫКЛ |
 +| 0x20 | включить опцию "С переполнением"​ (см. ниже) |
 +| 0x40 | Применять нижнюю/​верхнюю границы ПОСЛЕ расчета (см. ниже) |
 +
 +:!: **Уточнение для 0x20**: ​
 +- актуально для следующих датчиков:​
 +  * **mileage**;​
 +  * **absolute fuel consumption**;​
 +  * **engine hours**.
 +
 +Если флаг 0x20 не задан, то датчик работает так: дельта изменения будет равна abs(V2 - V1), где V2 -- новое сообщение,​ V1 -- предыдущее,​ abs() -- модуль числа; если флаг задан, то при V2 < V1 дельтой будет считаться V2 (т.е. V1 = 0).
 +
 +:!: ** Уточнение для 0x40**:​\\ ​
 +  - если флаг не указан:​ граница применяется к сырым данным (в случае с ДУТ могут быть проблемы с указанием границ к сырым данным);​
 +  - если флаг указан:​ граница будет применена к данным,​ полученным после преобразования.
 +
 +**Типы валидации:​**
 +
 +^ Тип ^ Описание ^
 +| 0x01 | Логическое И |
 +| 0x02 | Логическое ИЛИ |
 +| 0x03 | Математическое И |
 +| 0x04 | Математическое ИЛИ |
 +| 0x05 | Суммировать |
 +| 0x06 | Вычесть валидатор из датчика |
 +| 0x07 | Вычесть датчик из валидатора |
 +| 0x08 | Перемножить |
 +| 0x09 | Делить датчик на валидатор |
 +| 0x0A | Делить валидатор на датчик |
 +| 0x0B | Проверка на неравенство нулю |
 +| 0x0C | Заменять датчик валидатором в случае ошибки |
 +
 +
 +===== Конфигурация датчиков =====
  
 Параметры конфигурации датчика:​ Параметры конфигурации датчика:​
Строка 106: Строка 129:
  \"​mu\":<​uint>,​  \"​mu\":<​uint>,​
  \"​pos\":<​uint>,​  \"​pos\":<​uint>,​
- \"​show_time\":<​text>,+ \"​show_time\":<​bool>,
  \"​unbound_code\":<​text>,​  \"​unbound_code\":<​text>,​
  \"​validate_driver_unbound\":<​bool>,​  \"​validate_driver_unbound\":<​bool>,​
Строка 112: Строка 135:
  \"​uct\":<​bool>,​  \"​uct\":<​bool>,​
  \"​lower_bound\":<​double>,​  \"​lower_bound\":<​double>,​
- \"​upper_bound\":<​double>​+ \"​upper_bound\":<​double>, 
 + \"​text_params\":<​uint>
       ​}" ​       ​}" ​
 </​code>​ </​code>​
 ^ Параметр ^ Описание ^ ^ Параметр ^ Описание ^
-| act | [[http://docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/props|опция "​Последнее сообщение"​]]:​ 0 - опция **включена**,​ 1 - опция **выключена**\\ (см. дополнительную информацию ниже)| +| act | [[https://wialon-help.link/09656835|опция "​Последнее сообщение"​]]:​ 0 - опция **включена**,​ 1 - опция **выключена**\\ (см. дополнительную информацию ниже)| 
-| appear_in_popup | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/sensors|галочка "​Видимость"​]]:​ false - снять, true - поставить|+| appear_in_popup | [[https://wialon-help.link/f348c327|галочка "​Видимость"​]]:​ false - снять, true - поставить|
 | ci | пользовательские интервалы| | ci | пользовательские интервалы|
-| filter | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/props?#​dopolnitelnye_svojstva|переопределить степень фильтрации]] | +| filter | [[https://wialon-help.link/97ec79f8|переопределить степень фильтрации]] | 
-| mu | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/props|единицы измерения]]:​ 0 - si, 1 - us, 2 - имперская,​ 3 - метрическая с галлонами ​ |+| mu | [[https://wialon-help.link/09656835|единицы измерения]]:​ 0 - si, 1 - us, 2 - имперская,​ 3 - метрическая с галлонами ​ |
 | pos | положение в списке Датчиков,​ счет от 1 | | pos | положение в списке Датчиков,​ счет от 1 |
-| show_time | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/sensors|галочка "​Время"​]]:​ false - снять, true - поставить | +| show_time | [[https://wialon-help.link/f348c327|галочка "​Время"​]]:​ false - снять, true - поставить | 
-| unbound_code | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/props?#​dopolnitelnye_svojstva|код снятия]] | +| unbound_code | [[https://wialon-help.link/48a7b622|код снятия]] | 
-| validate_driver_unbound | [[http://docs.gurtam.com/​ru/​hosting/​cms/​units/​sensors/props?#​dopolnitelnye_svojstva|валидировать снятие]],​ 0 - нет, 1 - да | +| validate_driver_unbound | [[https://wialon-help.link/ee3a75e1|валидировать снятие]],​ 0 - нет, 1 - да | 
-| timeout | [[http://docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/props#​dopolnitelnye_svojstva|таймаут]],​ секунды | +| timeout | [[https://wialon-help.link/d6f54dc6|таймаут]],​ секунды | 
-| uct | [[http://docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/props#​dopolnitelnye_svojstva|опция "​Переполнение по сырым данным"​]]:​ 0 - выкл, 1 - вкл| +| uct | [[https://wialon-help.link/e44fbda0|опция "​Переполнение по сырым данным"​]]:​ 0 - выкл, 1 - вкл| 
-| lower_bound | [[http://docs.wialon.com/​ru/​hosting/​cms/​units/​sensors/calc|опция "​Нижняя граница"​]]| +| lower_bound | [[https://wialon-help.link/eb944ffc|опция "​Нижняя граница"​]]| 
-| upper_bound | [[http://docs.wialon.com/ru/hosting/​cms/​units/​sensors/​calc|опция "​Верхняя граница"​]]| +| upper_bound | [[https://wialon-help.link/eb944ffc|опция "​Верхняя граница"​]]| 
 +| text_params | [[https://​wialon-help.link/​9a0afd55|опция "​Текстовый параметр"​]] , 0 - выкл, 1 - вкл| 
 +|fuel_params| настройки расхода топлива по ДУТ - см ниже | 
 +|engine_sensors|для датчика типа ДУТ можно указать id Датчика зажигания (моточасов)-используется для расчета расхода топлива(сливов)| 
 +|engine_efficiency| для датчика зажигания(моточасов) можно указать id ДПРД |
  
 :!: **Уточнение для "​act"​**:​ для этой опции использована инверсивная логика:​ выбранная галочка (значение 0) -- это исторически старая логика,​ а выключенная опция (значение 1) -- это более новая логика (данные используются во всплывающих подсказках,​ удобны в ситуациях,​ когда некоторые важные параметры редко приходят). Старая логика всё так же активна по умолчанию. :!: **Уточнение для "​act"​**:​ для этой опции использована инверсивная логика:​ выбранная галочка (значение 0) -- это исторически старая логика,​ а выключенная опция (значение 1) -- это более новая логика (данные используются во всплывающих подсказках,​ удобны в ситуациях,​ когда некоторые важные параметры редко приходят). Старая логика всё так же активна по умолчанию.
Строка 148: Строка 175:
 </​code>​ </​code>​
  
-Типы валидации: +===== Параметры конфигурации топливных датчиков ===== 
-^ Тип ^ Описание ^ + 
-0x01 Логическое И +:!: **Уточнение по "​calc_fuel",​ "​fuel_params",​ engine_sensors,​ engine_efficiency**:​ новые опции могут быть использованы опционально (если работать только через api), и старые запросы и логика по прежнему актуальны (но до тех пор пока не были выполнены изменения в конфигурации ​датчиков) 
-| 0x02 | Логическое ИЛИ ​+ 
-0x03 Математическое И +Параметр "​calc_fuel"​ устанавливает флаг расчета расхода топлива для каждого типа датчика соответственно : 
-0x04 Математическое ​ИЛИ ​+ 
-0x05 Суммировать ​+^ Флаг ​^ Описание ^ 
-| 0x06 | Вычесть валидатор из датчика ​| +0x0 не использовать расчет топлива в отчетах | 
-| 0x07 | Вычесть датчик из валидатора | +| 0x01 | расход по расчету 
-0x08 Перемножить +| 0x02 | датчики уровня топлива ​
-0x09 Делить датчик на валидатор | +0x04 заменять ошибочные значения датчиков уровня топлива рассчитанными математически 
-0x0A Делить валидатор на датчик | +0x08 датчики абсолютного расхода топлива | 
-| 0x0B | Проверка на неравенство нулю | +| 0x10 | импульсные датчики | 
-| 0x0C | Заменять датчик валидатором в случае ошибки |+| 0x20 | датчики мгновенного расхода топлива ​
 +0x40 расход по нормам 
 + 
 +==== Параметры "fuel params"​ для ДУТ ==== 
 +  * "​ignoreStayTimeout":<​uint>,​ /​* игнорировать ​сообщения после начала движения, ​секунд */ 
 +  * "​minFillingVolume":<​double>,​ /​* минимальный объем заправки,​ литров */ 
 +  * "​minTheftTimeout":<​uint>,​ /​* минимальное ​время остановки для определения слива, секунд */ 
 +  * "​minTheftVolume":<​double>,​ /​* минимальный объем слива, литров */ 
 +  * "​filterQuality":<​ubyte>,​ /​* степень фильтрации (0..255) */ 
 +  * "​fillingsJoinInterval":<​uint>,​ /​* таймаут для разделения заправок,​ секунд */ 
 +  * "​theftsJoinInterval":<​uint>,​ /​* ​таймаут для разделения сливов,​ секунд */ 
 +  * "​extraFillingTimeout":<​uint>​ /​* таймаут для определения полного объема заправки,​ секунд */ 
 + 
 +**"​flags"​** - флаги устанавливают остальные настройки [[https://​wialon-help.link/​e3df3b4a|расхода топлива по ДУТ]] : 
 +^ Значение ^ Опция ^ 
 +| 2 | фильтрация включена, ​значение ​в "​filterQuality"​ | 
 +| 8 | поиск заправок только при остановке, ​таймаут в "​extraFillingTimeout"​ | 
 +| 64 | рассчитывать ​объем заправки без учета фильтрации ​
 +512 расчет заправки по времени | 
 +128 рассчитывать объем слива без учета фильтрации | 
 +| 256 | поиск сливов в движении | 
 +| 1024| расчет сливов по времени ​
 +2048 расчет расхода топлива ​по времени
 +| 4069 | заменять ошибочные значения ​рассчитанными математически 
 + 
 + 
 +Пример новых параметров в конфигурации:  
 +ДУТ "​fuel_params"​ 
 +<​code=javascript>​ 
 +"​fuel_params":​{\"​flags\":​1728,​\"​ignoreStayTimeout\":​20,​\"​minFillingVolume\":​21,​\"​minTheftTimeout\":​0,​\"​minTheftVolume\":​15,​\"​filterQuality\":​0,​\"​fillingsJoinInterval\":​300,​\"​theftsJoinInterval\":​300,​\"​extraFillingTimeout\":​0}. 
 +</​code>​ 
 + 
 +==== Параметры "fuel params"​ для ДИРТ ==== 
 + 
 +ДМРТ "​fuel_params"​ 
 +<​code=javascript>​ 
 + "​fuel_params":​{\"​maxImpulses\":​10,​ \"​skipZero\":​0} 
 +</​code>​ 
 + 
 +  * "​maxImpulses":<​uint> ​ - максимум импульсов 
 +  * "​skipZero":<​bool>​ - пропускать ​начальные нулевые значения 
 +==== Параметры конфигурации для ДАРТ и ДМРТ ==== 
 +Специальных настроек нет, "​calc_fuel"​ - флаг для включения (нулевое значение - опция выключена) опции [[https://​wialon-help.link/​6dee7d4e|ассчитывать расход топлива по датчику"​]]:​ 
 +  *  "​calc_fuel":​8 для ДАРТ 
 +  *  "​calc_fuel":​32 для ДМРТ 
 + 
 +**Пример конфигурации ДМРТ** 
 +<​code=javascript>​ 
 +c: "​{"​act":​1,"​appear_in_popup":​false,"​calc_fuel":​8,"​ci":​{},"​cm":​1,"​fuel_params":​{"​flags":​0},"​mu":​0,"​pos":​24,"​show_time":​false,"​timeout":​0}"​ 
 +</​code>​ 
 + 
 +===== Параметры конфигурации ​датчиков моточасов (для расчета топлива) ===== 
 + 
 +Расход [[https://​wialon-help.link/​48aa53f0|топлива по расчету]] ([[ru:​sidebar:​remoteapi:​apiref:​unit:​update_fuel_math_params]] - старый ​метод) использует настройки датчиков моточасов (датчик зажигания и [[https://​wialon-help.link/​a2666fb3|датчики двигателя]])
  
 ===== Возвращаемый результат =====  ===== Возвращаемый результат ===== 
Follow us on Facebook Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2025 Gurtam