> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md).
# Активируйте ваше MQTT-устройство на Navixy
MQTT — это легковесный протокол обмена сообщениями, предназначенный для эффективной связи между удаленными устройствами при минимальной пропускной способности сети. Это отличный выбор для связи между машинами (M2M), что делает его идеальным для проектов в области автомобильной телематики. В этом документе описано, как подключить GPS-устройство к Navixy с помощью MQTT.
## Как работает MQTT
MQTT работает по принципу «клиент и брокер» и использует архитектуру Publish/Subscribe:
* **Клиент**: Любое устройство Интернета вещей (IoT), на котором работает библиотека MQTT, например выделенный сервер, микроконтроллер, приложение или датчик.
* **Брокер**: Пассивный сервер, который обеспечивает посредничество в обмене между клиентами. Он выполняет аутентификацию, управляет подключениями, сеансами и подписками.
В этой схеме клиенты подключаются к брокеру, который затем обеспечивает связь между публикующими клиентами (устройствами, отправляющими данные) и подписывающимися клиентами (устройствами или серверами, получающими данные).
## Активация вашего MQTT-устройства в Navixy
MQTT-устройства становятся все более распространенными в GPS-трекинге и телематике благодаря высокой гибкости и способности удовлетворять разнообразные бизнес-потребности. Однако для них требуется уникальный процесс настройки по сравнению с традиционными устройствами.
**Ключевые моменты:**
* MQTT-устройства нельзя зарегистрировать автоматически, их необходимо настраивать вручную.
* Эти устройства работают по модели публикации/подписки, которая отличается от традиционной клиент-серверной модели.
**Модель публикации/подписки против клиент-серверной модели**
В традиционной клиент-серверной модели устройство (клиент) напрямую отправляет пакеты данных на сервер, который затем обрабатывает данные и отправляет ответы обратно устройству. Эта модель проста, но ограничена связью один к одному.
В отличие от этого, модель публикации/подписки, используемая 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 Охрана → Авторизация добавьте пользователя со следующими настройками:
* **Идентификатор клиента**: `%IMEI%`
* **Имя пользователя**: `bce_device`
* **Пароль**: `secretword`
Убедитесь, что конфигурация тем настроена правильно:
* Все темы, кроме имени темы управления выходом, заданы значениями по умолчанию.
* Имя темы управления выходом: `%IMEI%/OUTC`
Сохраните конфигурацию.
Каждая тема, начинающаяся с «BCE», означает, что в этих случаях устройство работает как публикатор. Для телеметрических данных, событий, файлов и данных в реальном времени устройство выступает как публикатор, отправляя эти пакеты брокеру. Затем сервер Navixy может извлекать эти пакеты данных из брокера. Связь между подписчиками и публикаторами осуществляется через темы, причем каждая тема соответствует определенному типу сообщения.
Для команд, которые переключают выход устройства, устройство функционирует как подписчик. Оно ожидает получения команд от сервера Navixy, передаваемых через брокер с использованием IMEI устройства. В этом случае устройство понимает, что должно переключить выход.
При настройке MQTT-совместимого устройства пользователь должен указать имя пользователя и пароль, которые ожидает сервер. Эти параметры показаны на скриншотах выше.
#### Добавьте устройство на платформу Navixy
1. **Войдите в свою учетную запись**: Войдите в свою учетную запись Navixy.
2. **Выберите устройство**: Выберите MQTT-совместимое устройство Xirgo Global (BCE) (помечено как IOTM).
3. **Перейдите к следующему шагу**: Нажмите кнопку **Далее** .
4. **Укажите IMEI**: Введите IMEI устройства.
5. **Активируйте устройство**: Нажмите кнопку **Активировать** .
### Пример 2. Устройства Globalmatix xTCU
#### Настройте устройство
* Укажите следующие настройки:\
Платформа США: `mqtt.us.navixy.com:1883`\
Платформа ЕС: `mqtt.eu.navixy.com:1883`
* **Топик**: `globalmatix/in`
* **Логин/пароль**: `globalmatix_device/secretword`
* Сохраните конфигурацию.
#### Добавьте устройство на платформу Navixy
* Войдите в свою учетную запись.
* Выберите устройство Globalmatix в списке.
* Нажмите кнопку **Далее** .
* Укажите IMEI устройства.
* Нажмите кнопку **Активировать** .
### Пример 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).
* **Перейдите к следующему шагу:** Нажмите кнопку **Далее** .
* **Укажите IMEI:** Введите IMEI устройства.
* **Активируйте устройство:** Нажмите кнопку **Активировать** .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` 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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.