Здесь показаны различия между двумя версиями данной страницы.
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|датчики двигателя]]) | ||
===== Возвращаемый результат ===== | ===== Возвращаемый результат ===== |
|