update_sensor

Для создания, редактирования или удаления датчиков используйте метод unit/update_sensor.

svc=unit/update_sensor&params={
    "itemId": <long>,
    "id": <long>,
    "callMode": <text>,
    "unlink": <uint>,
    "n": <text>,
    "t": <text>,
    "d": <text>,
    "m": <text>,
    "p": <text>,
    "f": <uint>,
    "c": <text>,
    "vt": <uint>,
    "vs": <long>,
    "tbl": [
        {
            "x": <double>,
            "a": <double>,
            "b": <double>
        }
    ]
}

Запрос должен содержать следующие параметры:

Для создания или обновления датчика также требуются следующие параметры:

Для получения дополнительной информации о типах датчиков см. Типы датчиков.

Следующие параметры используются для настройки датчика:

"{
  \"act\": <bool>,
  \"appear_in_popup\": <bool>,
  \"battery_capacity\": <double>,
  \"ci\": <object>,
  \"calc_fuel\": <uint>,
  \"engine_efficiency\": <array>,
  \"engine_sensors\": <array>,
  \"filter\": <long>,
  \"fuel_params\": <object>,
  \"mu\": <uint>,
  \"pos\": <uint>,
  \"show_time\": <bool>,
  \"unbound_code\": <text>,
  \"validate_driver_unbound\": <bool>,
  \"do_not_show\": <bool>,
  \"timeout\": <uint>,
  \"uct\": <bool>,
  \"lower_bound\": <double>,
  \"upper_bound\": <double>,
  \"overflow_limit\": <double>,
  \"text_params\": <uint>,
  \"show_as_percentage\": <uint>
}"

Параметр c передается как строка, содержащая JSON-объект. Заключите объект в двойные кавычки и экранируйте двойные кавычки в его ключах и значениях ("). См. примеры конфигурации ниже.

Устанавливайте флаги датчика в параметре верхнего уровня f. Не устанавливайте c.flags напрямую.

В параметре ci каждый ключ является нижней границей интервала, а каждое значение описывает, как значение датчика отображается в этом интервале:

"c":"{\"ci\":{\"0\":{\"t\":\"Off\",\"c\":16711680},\"50\":{\"t\":\"On\"}}}"

Чтобы установить интервал без нижней границы, используйте ключ "-Infinity".

Пример передачи fuel_params датчика уровня топлива:

"c":"{\"fuel_params\":{\"flags\":1728,\"ignoreStayTimeout\":20,\"minFillingVolume\":21,\"minTheftTimeout\":0,\"minTheftVolume\":15,\"filterQuality\":0,\"fillingsJoinInterval\":300,\"theftsJoinInterval\":300,\"extraFillingTimeout\":0}}"

Пример передачи fuel_params импульсного датчика расхода топлива:

"c":"{\"fuel_params\":{\"maxImpulses\":10,\"skipZero\":0}}"

Пример передачи fuel_params датчика уровня заряда батареи:

"c":"{\"fuel_params\":{\"flags\":16387,\"filterQuality\":0,\"minFillingVolume\":10,\"fillingsJoinInterval\":300}}"

Для датчика уровня заряда батареи система использует настройки, перечисленные ниже. Если вы вообще не передаете объект fuel_params, система использует топливные настройки объекта. Если вы передаете объект без некоторых ключей, система использует значения из таблицы.

Система использует эти настройки только тогда, когда расчет данных датчиком включен в calc_fuel. Эта настройка соответствует опции Рассчитывать данные по датчику. Рассчитанные значения возвращаются детекторами battery_level, charge и ev. Подробности см. в разделе Типы детекторов событий.

Ключ show_as_percentage влияет только на отображение. Всегда указывайте battery_capacity и настройки обнаружения зарядки в кВт⋅ч.

Пример строки c для датчика уровня заряда батареи, где одновременно заданы настройки обнаружения зарядки и отображение в процентах:

"c":"{\"fuel_params\":{\"flags\":16387,\"filterQuality\":0,\"minFillingVolume\":10,\"fillingsJoinInterval\":300},\"show_as_percentage\":1,\"battery_capacity\":64.5,\"calc_fuel\":2,\"act\":1,\"mu\":0,\"appear_in_popup\":true}"

Передавайте show_as_percentage и battery_capacity внутри строки c, рядом с fuel_params, и оставляйте параметр m датчика равным kWh.

Тип фильтрации устанавливается в flags: используйте 0x02 для включения фильтрации и добавьте 0x4000 для адаптивной медианной фильтрации. Если вы устанавливаете флаг 0x2000, система использует только флаги фильтрации и значение filterQuality датчика.

Для датчиков уровня заряда батареи флаг 0x2000 работает противоположным образом по отношению к его описанию на странице unit/get_fuel_settings: он не применяет топливные настройки объекта по умолчанию.

Система всегда добавляет режим расчета по времени (0x10) для датчиков уровня заряда батареи. Вы не можете отключить его с помощью этого метода.

Для датчиков уровня заряда батареи система сбрасывает ключи ignoreStayTimeout, minTheftVolume и extraFillingTimeout в 0, даже если вы указываете другие значения. Ключи minTheftTimeout и theftsJoinInterval не имеют эффекта, поскольку обнаружение слива недоступно для этих датчиков.

Если запрос на создание или обновление датчика выполнен успешно, возвращается ответ в следующем формате:

[
  <long>,  /* ID датчика */
  {
    "id": <long>,       /* ID датчика */
    "n": "<text>",      /* Имя */
    "t": "<text>",      /* Тип */
    "d": "<text>",      /* Описание */
    "m": "<text>",      /* Единица измерения */
    "p": "<text>",      /* Параметр */
    "f": <uint>,        /* Флаги датчика */
    "c": <text>,        /* Конфигурация, отправляется и возвращается как JSON-строка */
    "vt": <int>,        /* Тип валидации */
    "vs": <long>,       /* ID валидирующего датчика */
    "tbl": [            /* Таблица расчета */
      {
        "x": <double>,
        "a": <double>,
        "b": <double>
      }
    ]
  }
]

Если запрос на удаление датчика выполнен успешно, возвращается ответ в следующем формате:

[
  <long>,   /* ID датчика */
  null
]

Если запрос не выполнен, возвращается код ошибки.