> 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 к Navixy, настроив протокол публикации/подписки. Включает примеры настройки для Xirgo, Globalmatix и аналогичных устройств.

MQTT — это легковесный протокол обмена сообщениями, предназначенный для эффективного обмена между удаленными устройствами при минимальном сетевом трафике. Это отличный выбор для межмашинного взаимодействия (M2M), что делает его идеальным для проектов по телематике транспорта. В этом документе описано, как можно подключить GPS-устройство к Navixy с помощью MQTT.

## Как работает MQTT

MQTT работает по принципу «клиент и брокер» и использует архитектуру «издатель/подписчик»:

* **Клиент**: Любое устройство Интернета вещей (IoT), на котором работает библиотека MQTT, например выделенный сервер, микроконтроллер, приложение или датчик.
* **Брокер**: Пассивный сервер, который обеспечивает обмен между клиентами. Он отвечает за аутентификацию и управляет подключениями, сессиями и подписками.

В этой схеме клиенты подключаются к брокеру, который затем обеспечивает обмен между клиентами-издателями (устройствами, отправляющими данные) и клиентами-подписчиками (устройствами или серверами, получающими данные).

## Активация вашего MQTT-устройства в Navixy

MQTT-устройства становятся все более распространенными в GPS-мониторинге и телематике благодаря высокой гибкости и способности удовлетворять разнообразные бизнес-потребности. Однако по сравнению с традиционными устройствами им требуется особый процесс настройки.

**Ключевые моменты:**

* MQTT-устройства нельзя зарегистрировать автоматически — их необходимо настраивать вручную.
* Эти устройства работают по модели издатель/подписчик, которая отличается от традиционной модели клиент-сервер.

**Модель издатель/подписчик против модели клиент-сервер**

В традиционной модели клиент-сервер устройство (клиент) отправляет пакеты данных напрямую на сервер, который затем обрабатывает данные и отправляет ответы обратно на устройство. Эта модель проста, но ограничена связью один к одному.

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-e380430cb6f8b3fd11095dc56d710a310ef014c5%2Fimage-20240717-170644.png?alt=media\&token=3a1a668f-2a6a-4309-b7dc-f6de9d3d6b45)

Напротив, модель издатель/подписчик, используемая MQTT-устройствами, обеспечивает более гибкий и масштабируемый обмен. Вот как это работает:

* **Издатель**: Устройство отправляет пакеты данных MQTT-брокеру.
* **Брокер**: Брокер хранит эти пакеты данных.
* **Подписчик**: Сервер Navixy подписывается на пакеты данных от конкретных устройств, используя их номера IMEI и адрес брокера.

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1752cdba20614e231763035834e9051d79fa8d79%2Fimage-20240717-170707.png?alt=media\&token=988e6363-2e1d-4d47-a2a4-ed22f1c36de0)

## Шаги настройки MQTT-устройства

Следующие примеры показывают, как настроить ваше MQTT-устройство на платформе Navixy.

### Пример 1. Устройства Xirgo Global (ex BCE)

#### Настройте устройство в FMSET

* Войдите в свою учетную запись FMSET.
* Перейдите в Подключение → Сервер телеметрии → Настройки адреса MQTT-брокера.
* Введите следующие параметры:\
  Платформа США: `mqtt.us.navixy.com` порт `1883`\
  Платформа ЕС: `mqtt.eu.navixy.com` порт `1883`

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8ee95de1987bc8e74cc0aa1830b701a75b74b461%2Fimage-20240717-165930.png?alt=media\&token=527fee00-192f-4ed6-a153-f4775067d2c1)

В MQTT Охрана → Авторизация добавьте пользователя со следующими настройками:

* **Идентификатор клиента**: `%IMEI%`
* **Имя пользователя**: `bce_device`
* **Пароль**: `secretword`

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-47b7bf65136dc3e5446ad460f811e958e84a72f3%2Fimage-20240717-170022.png?alt=media\&token=a3e7a084-5313-4389-a059-1467ddfb7576)

Убедитесь, что настройка топиков выполнена правильно:

* Все топики, кроме имени топика управления выходом, установлены со значениями по умолчанию.
* Имя топика управления выходом: `%IMEI%/OUTC`

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-25ef4469acb315efde6d3bad1f55f0b8e9f90222%2Fimage-20240717-170207.png?alt=media\&token=06a40d27-56bc-49cd-92e5-c21d0a50da31)

Сохраните конфигурацию.

Каждый топик, начинающийся с «BCE», указывает на то, что устройство в этих случаях работает как издатель. Для телеметрических данных, событий, файлов и данных в реальном времени устройство выступает как издатель, отправляя эти пакеты брокеру. Затем сервер Navixy может извлекать эти пакеты данных из брокера. Обмен между подписчиками и издателями осуществляется через топики, при этом каждый топик соответствует определенному типу сообщения.

Для команд, переключающих выход устройства, оно работает как подписчик. Оно ожидает получения команд от сервера Navixy, передаваемых через брокер с использованием IMEI устройства. В этом случае устройство понимает, что ему нужно переключить выход.

При настройке MQTT-совместимого устройства пользователь должен указать имя пользователя и пароль, ожидаемые сервером. Эти параметры показаны на приведенных выше снимках экрана.

#### Добавьте устройство на платформу Navixy

1. **Введите данные своей учетной записи**: Войдите в свою учетную запись Navixy.
2. **Выберите устройство**: Выберите MQTT-совместимое устройство Xirgo Global (BCE) (помеченное как IOTM).
3. **Перейдите к следующему шагу**: Нажмите **Следующий шаг** кнопку.
4. **Укажите IMEI**: Введите IMEI устройства.
5. **Активируйте устройство**: Нажмите **Активировать** кнопку.

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-b0a0c92f244c5f17953e78a98db864cb2c5c8691%2Fimage-20240717-170552.png?alt=media\&token=45610265-7809-490b-9fce-ec72759404ec)

### Пример 2. Устройства Globalmatix xTCU

#### Настройте устройство

* Введите следующие настройки:\
  Платформа США: `mqtt.us.navixy.com:1883`\
  Платформа ЕС: `mqtt.eu.navixy.com:1883`
* **Топик**: `globalmatix/in`
* **Логин/пароль**: `globalmatix_device/secretword`
* Сохраните конфигурацию.

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-db01d37cf9e73fbbe98890e07e2cbd6ab196dde5%2Fimage-20240717-170804.png?alt=media\&token=553e865b-f9c8-49a9-969c-4f0bd987f35a)

#### Добавьте устройство на платформу Navixy

* Введите данные своей учетной записи.
* Выберите устройство Globalmatix в списке.
* Нажмите **Следующий шаг** кнопку.
* Укажите IMEI устройства.
* Нажмите **Активировать** кнопку.

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-83d406f918ac4bad13c57b88cf515c6650823d52%2Fimage-20240717-170828.png?alt=media\&token=e47e5ef4-c512-4293-bffd-b3908c85b52f)

### Пример 3. Устройства Xirgo Global XG37/XG40/GX47

#### Настройте устройство

1. **Настройте APN.**
2. **Проверьте настройки сеанса.**
3. **Настройте адрес сервера:**

* Сервер: `devices.xgfleet.eu`
* Порт: `1888`
* Протокол: `TCP`

4. **Проверьте настройки имен MQTT-топиков.**
5. **Настройте параметры MQTT-брокера:**

* Доменное имя / IP: *Домен, настроенный в Панели администратора Navixy*
* Порт: `1883`
* Протокол: `TCP`

**Настроен APN**

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1ad90ec7b8985e900c7dc010d62a1f3168b4cae0%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Настройки сеанса.**

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-16d2c3726c3224ca8db70134d17ec95801864164%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Адрес сервера конфигурации.**

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-58347c2f1145a161969da24837534b2f7a3997df%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Настройки имен MQTT-топиков**

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-ad1ca3b59c925c6e8d89280438e8ecea98018f0e%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

**Настройки адреса MQTT-брокера.**

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-1b11c826464f90e8782bb2c567b10d96818bb66f%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Добавьте устройство на платформу Navixy

* **Введите данные своей учетной записи:** Войдите в свою учетную запись Navixy.
* **Выберите устройство:** Выберите MQTT-совместимое устройство Xirgo XG37/XG40/GX47 (помеченное как IOTM).
* **Перейдите к следующему шагу:** Нажмите **Следующий шаг** кнопку.
* **Укажите IMEI:** Введите IMEI устройства.
* **Активируйте устройство:** Нажмите **Активировать** кнопку.

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-d78df1bca6f03201aa34541e304004b6352aba12%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
