Инструкция по настройке и работе с топливом в платформе RIC

Данный раздел описывает эталонную схему работы топлива в платформе:
от данных с датчика → через обработку → до отображения в админке и мобильном приложении.

Инструкция рассчитана на project-менеджеров и техническую поддержку.

1. Общая логика работы топлива

В платформе Rightech топливо никогда не берётся “само по себе”.
Источник топлива — датчик, который передаёт числовые значения.

Платформа:

• принимает показания датчика,

• обрабатывает их,

• преобразует в объём топлива и процент топлива,

• передаёт результат в Админку,

⚠️ Важно

Если нет корректного датчика или обработки — топлива в системе не будет, даже если всё «визуально включено».

2. Требования к датчику топлива

2.1. Идентификатор датчика

Датчик, который передаёт уровень топлива, обязательно должен иметь идентификатор:

fuel

Тип датчика не критичен:

• аналоговый,

• CAN,

• виртуальный,

• кастомный.

Ключевое требование — значение должно быть числовым и стабильно приходить от устройства.

3. Модель объекта: расширение «Топливо»

3.1. Включение расширения

В модели объекта необходимо включить расширение:

• «Топливо»

  

После включения:

• Необходимо создать папку Топливо (API),

• в ней появляются параметры:

  • процент топлива,

  • объём топлива.

  • Код для модели:

                {

                  "id": "fuel_api",

                  "name": "Топливо (API)",

                  "active": true,

                  "type": "subsystem",

                  "factor": 1,

                  "children": [

                    {

                      "id": "calculatedFuelLevel",

                      "active": true,

                      "name": "Объём топлива",

                      "type": "argument",

                      "dataType": "number",

                      "unit": "volume-liter",

                      "reference": "",

                      "factor": 1,

                      "display": {

                        "svg": null

                      },

                      "linear": true,

                      "children": [],

                      "levels": {

                        "type": "range",

                        "value": [

                          {

                            "color": "#f16059",

                            "name": "-Infinity",

                            "value": {

                              "a": "-Infinity",

                              "b": 0

                            }

                          },

                          {

                            "color": "#f16059",

                            "name": "Min",

                            "value": {

                              "a": 0,

                              "b": 1

                            }

                          },

                          {

                            "color": "#ffae62",

                            "name": "Mid",

                            "value": {

                              "a": 1,

                              "b": 3

                            }

                          },

                          {

                            "color": "#a2ce4b",

                            "name": "Max",

                            "value": {

                              "a": 3,

                              "b": "Infinity"

                            }

                          }

                        ],

                        "svg": null

                      }

                    },

                    {

                      "id": "calculatedFuel.0.percent",

                      "active": true,

                      "name": "Процент от объёма бака",

                      "type": "argument",

                      "dataType": "number",

                      "reference": "",

                      "factor": 1,

                      "unit": "percent",

                      "linear": false,

                      "decimalPlaces": 0,

                      "usage": "fuel_level_percent"

                    }

                  ]

                }

Если расширение не включено — обработка топлива работать не будет.

4. Настройка обработки топлива в объекте

Переходим в объект в режиме редактирования → вкладка «Топливо».

4.1. Основные настройки

1. Включить чекбокс «Включить обработку топлива»

2. Указать количество топливных баков
   (чаще всего — 1)

4.2. Настройка бака

Для каждого бака необходимо заполнить:

1. Объём топливного бака
   Указывается в числах (например, 100)

2. Датчик уровня топлива
   Выбирается датчик с идентификатором fuel

3. Результат обработки топлива, л
   → параметр из папки Топливо (API)
   (Объём топлива)

4. Результат обработки топлива, %
   → параметр из папки Топливо (API)
   (Процент топлива)

5. Тарировочная таблица (калибровка)

5.1. Зачем нужна тарировка

Датчик топлива не знает объём бака.
Он передаёт только свои условные значения (напряжение, уровень, CAN-показатель).

Тарировочная таблица связывает:

• показания датчика

• с реальным объёмом топлива в баке

5.2. Заполнение таблицы

Принцип заполнения:

Пример:

Если датчик показывает 57, значит в баке 0 литров
Если датчик показывает 66, значит бак полный — 100 литров

Таблица может:

• заполняться вручную,

• импортироваться через CSV,

• экспортироваться для правок.

5.3. Дополнительная фильтрация

При необходимости можно включить дополнительную фильтрацию:

• для сглаживания скачков,

• при шумных датчиках.

Использовать аккуратно — неправильные настройки могут «залипать» показания.

6. Сохранение и синхронизация

После завершения настройки:

1. Сохранить объект

2. Перейти в админку

3. Открыть объект

4. Нажать «Синхронизировать»

⚠️ Важно

Без синхронизации данные могут не обновиться в админке и приложении.

7. Проверка результата

После корректной настройки:

• данные датчика fuel
  → проходят обработку
  → попадают в Топливо (API):

  • объём топлива,

  • процент топлива

Эти значения:

• отображаются в админке,

• используются в мобильном приложении,

• участвуют в расчётах (пробег, ограничения, логика).

8. Дополнительные параметры в модели (обязательно)

В модели объекта, в дополнительных характеристиках, необходимо указать:

• средний расход топлива,

• параметры топлива,

• параметры пробега.

Без этого:

• пробег будет считаться некорректно,

• в приложении могут отображаться неверные значения.

9. Как рассчитывается пробег

Формула логики

Пробег рассчитывается на основе:

• объёма бака,

• текущего уровня топлива,

• среднего расхода.

Пример

• Объём бака: 100 л

• Средний расход: 100 л / 100 км

➡️ Полный бак = 100 км пробега

Если:

• топлива 50% → пробег ≈ 50 км

⚠️ Важно

Средний расход всегда указывается в литрах на 100 км.