# Активируйте Ваше устройство MQTT в Navixy
MQTT — это легковесный протокол обмена сообщениями, разработанный для эффективной связи между удалёнными устройствами при минимальном использовании сетевой пропускной способности. Он является отличным выбором для Machine-to-Machine (M2M) коммуникаций и идеально подходит для проектов в области телематики транспортных средств. В этом документе описывается, как подключить GPS-устройство к Navixy с использованием MQTT.
## Как работает MQTT
MQTT работает по принципу «клиент — брокер» и использует архитектуру Publish/Subscribe:
* **Клиент**: Любое устройство Интернета вещей (IoT), на котором запущена библиотека MQTT, например выделенный сервер, микроконтроллер, приложение или датчик.
* **Брокер**: Пассивный сервер, который осуществляет посредничество в коммуникации между клиентами. Он обрабатывает аутентификацию, управляет подключениями, сессиями и подписками.
В этой схеме клиенты подключаются к брокеру, который затем облегчает обмен данными между публикующими клиентами (устройствами, отправляющими данные) и подписывающимися клиентами (устройствами или серверами, получающими данные).
## Активация вашего MQTT-устройства в Navixy
MQTT-устройства становятся всё более распространёнными в GPS-треккинге и телематике благодаря своей высокой гибкости и способности удовлетворять различные бизнес-требования. Однако они требуют уникального процесса настройки по сравнению с традиционными устройствами.
**Ключевые моменты:**
* MQTT-устройства не могут регистрироваться автоматически и должны настраиваться вручную.
* Эти устройства работают по модели Publisher/Subscriber, которая отличается от традиционной клиент-серверной модели.
**Модель Publisher/Subscriber vs. клиент-серверная модель**
В традиционной клиент-серверной модели устройство (клиент) отправляет пакеты данных непосредственно на сервер, который затем обрабатывает данные и отправляет ответы обратно устройству. Эта модель проста, но ограничена связью «один‑к‑одному».
В отличие от этого, модель Publisher/Subscriber, используемая MQTT-устройствами, обеспечивает более гибкую и масштабируемую коммуникацию. Вот как она работает:
* **Публикатор**: Устройство отправляет пакеты данных на MQTT-брокер.
* **Брокер**: Брокер хранит эти пакеты данных.
* **Подписчик**: Сервер Navixy подписывается на пакеты данных от конкретных устройств, используя их IMEI и адрес брокера.
## Шаги настройки MQTT-устройства
Мы покажем, как настроить ваше MQTT-устройство на платформе Navixy на нескольких примерах.
### Пример 1. Устройства Xirgo Global (бывш. BCE)
#### Настройка устройства в FMSET
* Войдите в свой аккаунт FMSET.
* Перейдите в Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Введите следующие параметры:\
Платформа США: `mqtt.us.navixy.com` порт `1883`\
Платформа ЕС: `mqtt.eu.navixy.com` порт `1883`
В MQTT Security → Authorization добавьте пользователя со следующими настройками:
* **Client ID**: `%IMEI%`
* **Username**: `bce_device`
* **Password**: `secretword`
Убедитесь, что ваша конфигурация топиков корректна:
* Все топики, за исключением Output Control Topic Name, установлены по умолчанию.
* Output Control Topic Name: `%IMEI%/OUTC`
Сохраните вашу конфигурацию.
Каждый топик, начинающийся с «BCE», указывает на то, что в этих случаях устройство действует как публикатор. Для телеметрических данных, событий, файлов и данных в реальном времени устройство выступает в роли публикации, отправляя эти пакеты брокеру. Сервер Navixy затем может извлечь эти пакеты данных из брокера. Взаимодействие между подписчиками и публикаторами управляется через топики, причём каждый топик соответствует определённому типу сообщения.
Для команд, переключающих выходы устройства, устройство функционирует как подписчик. Оно ожидает получения команд от сервера Navixy, отправляемых через брокера с использованием IMEI устройства. В этом случае устройство понимает, что ему необходимо переключить выход.
При настройке MQTT-совместимого устройства пользователь должен указать имя пользователя и пароль, которые ожидает сервер. Эти настройки показаны на приведённых выше скриншотах.
#### Добавление устройства на платформу Navixy
1. **Войдите в свою учётную запись пользователя**: Войдите в свою учётную запись Navixy.
2. **Выберите устройство**: Выберите совместимое с MQTT устройство Xirgo Global (BCE) (обозначено как IOTM).
3. **Перейдите к следующему шагу**: Нажмите кнопку «Next Step».
4. **Укажите IMEI**: Введите IMEI устройства.
5. **Активируйте устройство**: Нажмите кнопку «Activate».
### Пример 2. Устройства Globalmatix xTCU
#### Настройка устройства
* Введите следующие настройки:\
Платформа США: `mqtt.us.navixy.com:1883`\
Платформа ЕС: `mqtt.eu.navixy.com:1883`
* **Топик**: `globalmatix/in`
* **Логин/Пароль**: `globalmatix_device/secretword`
* Сохраните конфигурацию.
#### Добавление устройства на платформу Navixy
* **Войдите в свою учётную запись пользователя.**
* **Выберите устройство Globalmatix в списке.**
* **Нажмите кнопку «Next Step».**
* **Укажите IMEI устройства.**
* **Нажмите кнопку «Activate».**
### Пример №3 Устройства Xirgo Global XG37/XG40/GX47
#### #Настройка устройства
1. **Настройте APN.**
2. **Проверьте настройки сессии.**
3. **Настройте адрес сервера:**
* Сервер: `devices.xgfleet.eu`
* Порт: `1888`
* Протокол: `TCP`
4. **Проверьте настройки имени MQTT-топика.**
5. **Настройте параметры MQTT-брокера:**
* Доменное имя / IP: *Домен, настроенный в Navixy Admin Panel*
* Порт: `1883`
* Протокол: `TCP`
**APN настроен**
**Настройки сессии.**
**Адрес сервера конфигурации.**
**Настройки имён MQTT-топиков**
**Настройки адреса MQTT-брокера.**
#### **Добавление устройства на платформу Navixy**
* **Войдите в свою учётную запись:** Войдите в свою учётную запись Navixy.
* **Выберите устройство:** Выберите совместимое с MQTT устройство Xirgo XG37/XG40/GX47 (обозначено как IOTM).
* **Перейдите к следующему шагу:** Нажмите кнопку «Next Step».
* **Укажите IMEI:** Введите IMEI устройства.
* **Активируйте устройство:** Нажмите кнопку «Activate».
