# Активируйте ваше 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 (ex 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`
Убедитесь, что настройки ваших topics заданы корректно:
* Все topics, кроме Output Control Topic Name, установлены со значениями по умолчанию.
* Output Control Topic Name: `%IMEI%/OUTC`
Сохраните конфигурацию.
Каждая тема, начинающаяся с «BCE», указывает на то, что в этих случаях устройство работает как издатель. Для телеметрических данных, событий, файлов и данных в реальном времени устройство выступает как издатель, отправляя эти пакеты брокеру. Затем сервер Navixy может извлекать эти пакеты данных из брокера. Обмен между подписчиками и издателями управляется через topics, причём каждое topic соответствует определённому типу сообщения.
Для команд, которые переключают выход устройства, устройство функционирует как подписчик. Оно ожидает получения команд от сервера 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*
* Порт: `1883`
* Протокол: `TCP`
**Настройка APN**
**Настройки сеанса.**
**Адрес сервера конфигурации.**
**Настройки имён MQTT-тем**
**Настройки адреса MQTT-брокера.**
#### **Добавление устройства на платформу Navixy**
* **Войдите в свою учётную запись пользователя:** Войдите в свою учётную запись Navixy.
* **Выберите устройство:** Выберите MQTT-совместимое устройство Xirgo XG37/XG40/GX47 (помеченное как IOTM).
* **Перейдите к следующему шагу:** Нажмите кнопку «Next Step».
* **Укажите IMEI:** Введите IMEI устройства.
* **Активируйте устройство:** Нажмите кнопку «Activate».
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.