# Протоколы Wialon для приема данных

Navixy поддерживает [интеграцию данных IoT и телематики](https://www.navixy.com/docs/expert-center/ru/faq-and-troubleshooting/gps-devices/add-and-manage-devices/integrate-iot-data-from-servers-and-gateways) с различных платформ и шлюзов с использованием различных протоколов. Эти протоколы обеспечивают бесшовную передачу данных IoT от устройств и датчиков на платформу Navixy, позволяя осуществлять комплексный сбор и анализ данных.

В этом документе приведён обзор набора протоколов Wialon, описывается их работа и настройка для использования с Navixy.

## Wialon Retranslator

Протокол Wialon Retranslator предназначен для ретрансляции данных по TCP в бинарном формате. Этот протокол позволяет передавать информацию о местоположении устройства и значениях датчиков. Его можно расширить для поддержки специфических полей в зависимости от модели устройства, что обеспечивает детальный сбор данных.

**Поддерживаемые входы**:

* AVL IO: #1-100000
* Напряжение аккумулятора
* CAN: нагрузка на ось, уровень жидкости AdBlue, обороты двигателя (RPM), общий расход топлива, температура двигателя, пробег, необработанные данные
* LLS: Уровень
* Температура
* Аналоговый датчик: #1-16
* Напряжение платы
* Внешняя температура: #1-10

**Поддерживаемые события**:

* Отклонение от маршрута
* Расстояние между объектами
* Избыточный холостой ход двигателя
* Вход или выход из геозоны
* Чрезмерное вождение
* Чрезмерная парковка
* Изменение уровня топлива
* Обрезка GPS-антенны
* Потеря/восстановление GPS-сигнала
* GSM-глушение
* Срабатывание входов/выходов
* Параметр в диапазоне
* Определение состояния парковки
* Нажатие SOS-кнопки
* Датчик встряхивания
* Превышение скорости
* Изменение статуса задачи
* Трекер выключен или потеряна связь

**Как подключиться**:\
Чтобы добавить устройство в Navixy с использованием протокола Wialon Retranslator, зарегистрируйте новое устройство с его ID в Navixy и укажите на стороне отправителя следующий IP-адрес и порт сервера трекинга:

* **Платформа EU**: `tracker.navixy.com` или `52.57.1.136`
* **Платформа US**: `tracker.us.navixy.com` или `13.52.37.2`
* **Порт сервера**: `47690`

## Wialon Combine

Протокол Wialon Combine ретранслирует данные по TCP или UDP в бинарном формате. Он поддерживает передачу широкого спектра телематических и телеметрических данных, при этом платформа поддерживает все пользовательские поля из протокола.

**Поддерживаемые входы**:

* Аналоговый датчик: #1-32767
* Счётчик: #1-32767
* Внешняя температура: #1-32767
* CAN-параметр: #1-32767
* Пользовательский параметр: #1-32767
* LLS: Уровень: #1-32767

**Поддерживаемые события**:

* Отклонение от маршрута
* Расстояние между объектами
* Избыточный холостой ход двигателя
* Вход или выход из геозоны
* Чрезмерное вождение
* Чрезмерная парковка
* Изменение уровня топлива
* Срабатывание входов/выходов
* Параметр в диапазоне
* Определение состояния парковки
* Нажатие SOS-кнопки
* Превышение скорости
* Изменение статуса задачи
* Трекер выключен или потеряна связь

**Как подключиться**:\
Чтобы добавить устройство в Navixy с использованием протокола Wialon Combine, зарегистрируйте новое устройство с его ID в Navixy и укажите на стороне отправителя следующий IP-адрес и порт сервера трекинга:

* **Платформа EU**: `tracker.navixy.com` или `52.57.1.136`
* **Платформа US**: `tracker.us.navixy.com` или `13.52.37.2`
* **Порт сервера**: `47645`

## Wialon IPS

Протокол Wialon IPS — текстовый протокол поверх TCP, разработанный для простой расширяемости путём передачи дополнительных параметров в `#D` сообщении.

**Формат сообщения**:

```
#D#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;hdop;inputs;outputs;adc;ibutton;params\r\n
```

**Параметры** — это набор дополнительных параметров, разделённых запятыми, каждый из которых имеет `NAME:TYPE:VALUE` структуру.

**Общие параметры**:

* SOS - сигнал тревоги SOS-кнопки
* INTERVAL\_MODE - обозначение однопроходного маршрута
* BatteryLevel - заряд батареи в процентах
* b - заряд батареи в вольтах
* a или LOC\_RADIUS - точность определения местоположения (радиус) в метрах
* LOC\_SRC - источник навигационных данных: 0 - GPS, 1 - GSM LBS
* pwr\_ext - напряжение платы
* pwr\_int - напряжение встроенного аккумулятора
* fuel level - уровень топлива в литрах
* temperature - температура от встроенного датчика

**Специфические параметры** **для устройств BITREK**:

* ADC0, ADC1 - значения аналоговых датчиков 1 и 2 в милливольтах
* AIN1, AIN2 - значения аналоговых датчиков 1 и 2 в вольтах
* DIN1, DIN2, DIN3, DIN4 - значения дискретных входов
* VBAT - напряжение встроенного аккумулятора
* par1, par2, ... - параметры протокола BITREK, соответствующие кодам элементов IO

**Как подключиться**:\
Чтобы подключить устройство с использованием протокола Wialon IPS, добавьте устройство в Navixy как одну из моделей BITREK или другие поддерживаемые модели, такие как Glonassoft UMKa и NaviTrek. Укажите ID устройства при регистрации.