> 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/id/faq-and-troubleshooting/gps-devices/add-and-manage-devices/activate-your-mqtt-device-on-navixy.md).

# Aktifkan perangkat MQTT Anda di Navixy

Hubungkan perangkat MQTT ke Navixy dengan mengonfigurasi protokol publish/subscribe. Mencakup contoh penyiapan untuk Xirgo, Globalmatix, dan perangkat serupa.

MQTT adalah protokol perpesanan ringan yang dirancang untuk komunikasi efisien antara perangkat jarak jauh dengan penggunaan bandwidth jaringan minimal. Ini merupakan pilihan yang sangat baik untuk komunikasi Machine-to-Machine (M2M), sehingga ideal untuk proyek telematika kendaraan. Dokumen ini menjelaskan cara Anda dapat menghubungkan perangkat GPS ke Navixy menggunakan MQTT.

## Cara kerja MQTT

MQTT beroperasi berdasarkan prinsip “klien dan broker” dan menggunakan arsitektur publikasi/langganan:

* **Klien**: Perangkat Internet of Things (IoT) apa pun yang menjalankan pustaka MQTT, seperti server khusus, mikrokontroler, aplikasi, atau sensor.
* **Broker**: Server pasif yang memediasi komunikasi antarklien. Server ini menangani autentikasi, mengelola koneksi, sesi, dan langganan.

Dalam pengaturan ini, klien terhubung ke broker, yang kemudian memfasilitasi komunikasi antara klien penerbit (perangkat yang mengirim data) dan klien pelanggan (perangkat atau server yang menerima data).

## Mengaktifkan perangkat MQTT Anda di Navixy

Perangkat MQTT semakin umum dalam pelacakan GPS dan telematika karena fleksibilitasnya yang tinggi dan kemampuannya memenuhi berbagai kebutuhan bisnis. Namun, perangkat ini memerlukan proses konfigurasi yang berbeda dibandingkan perangkat tradisional.

**Poin penting:**

* Perangkat MQTT tidak dapat didaftarkan secara otomatis dan harus dikonfigurasi secara manual.
* Perangkat ini beroperasi menggunakan model publikasi/langganan, yang berbeda dari model klien-server tradisional.

**Model publikasi/langganan vs. model klien-server**

Dalam model klien-server tradisional, perangkat (klien) mengirim paket data langsung ke server, yang kemudian memproses data dan mengirim respons kembali ke perangkat. Model ini sederhana namun terbatas pada komunikasi satu-ke-satu.

![](https://3546701789-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)

Sebaliknya, model publikasi/langganan yang digunakan oleh perangkat MQTT memungkinkan komunikasi yang lebih fleksibel dan dapat diskalakan. Berikut cara kerjanya:

* **Penerbit**: Perangkat mengirim paket data ke broker MQTT.
* **Broker**: Broker menyimpan paket data ini.
* **Pelanggan**: Server Navixy berlangganan pada paket data dari perangkat tertentu menggunakan nomor IMEI dan alamat broker.

![](https://3546701789-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)

## Langkah konfigurasi perangkat MQTT

Contoh berikut menunjukkan cara mengonfigurasi perangkat MQTT Anda di platform Navixy.

### Contoh 1. Perangkat Xirgo Global (eks BCE)

#### Konfigurasikan perangkat di FMSET

* Masuk ke akun FMSET Anda.
* Buka Konektivitas → Server telemetri → Pengaturan alamat broker MQTT.
* Masukkan parameter berikut:\
  Platform AS: `mqtt.us.navixy.com` Port `1883`\
  Platform UE: `mqtt.eu.navixy.com` Port `1883`

![](https://3546701789-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)

Di MQTT Keamanan → Otorisasi, tambahkan pengguna dengan pengaturan berikut:

* **ID klien**: `%IMEI%`
* **Nama pengguna**: `bce_device`
* **Kata sandi**: `secretword`

![](https://3546701789-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)

Pastikan konfigurasi topik Anda benar:

* Semua topik, kecuali Nama topik kontrol keluaran, disetel ke nilai bawaan.
* Nama topik kontrol keluaran: `%IMEI%/OUTC`

![](https://3546701789-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)

Simpan konfigurasi Anda.

Setiap topik yang diawali dengan “BCE” menunjukkan bahwa perangkat beroperasi sebagai penerbit dalam kasus ini. Untuk data telemetri, peristiwa, berkas, dan data waktu nyata, perangkat bertindak sebagai penerbit, mengirim paket-paket ini ke broker. Server Navixy kemudian dapat mengambil paket data ini dari broker. Komunikasi antara pelanggan dan penerbit dikelola melalui topik, dengan setiap topik mewakili jenis pesan tertentu.

Untuk perintah yang mengalihkan keluaran perangkat, perangkat berfungsi sebagai pelanggan. Perangkat mengharapkan menerima perintah dari server Navixy, yang dikirim melalui broker menggunakan IMEI perangkat. Dalam kasus ini, perangkat memahami bahwa perangkat harus mengalihkan keluarannya.

Saat mengonfigurasi perangkat yang kompatibel dengan MQTT, pengguna harus menentukan nama pengguna dan kata sandi yang diharapkan oleh server. Pengaturan ini ditampilkan dalam tangkapan layar yang disediakan di atas.

#### Tambahkan perangkat ke platform Navixy

1. **Masukkan akun pengguna Anda**: Masuk ke akun pengguna Navixy Anda.
2. **Pilih perangkat**: Pilih perangkat Xirgo Global (BCE) yang kompatibel dengan MQTT (ditandai sebagai IOTM).
3. **Lanjut ke langkah berikutnya**: Klik **Langkah berikutnya** tombol.
4. **Tentukan IMEI**: Masukkan IMEI perangkat.
5. **Aktifkan perangkat**: Klik **Aktifkan** tombol.

![](https://3546701789-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)

### Contoh 2. Perangkat Globalmatix xTCU

#### Konfigurasikan perangkat

* Masukkan pengaturan berikut:\
  Platform AS: `mqtt.us.navixy.com:1883`\
  Platform UE: `mqtt.eu.navixy.com:1883`
* **Topik**: `globalmatix/in`
* **Login/Kata sandi**: `globalmatix_device/secretword`
* Simpan konfigurasi.

![](https://3546701789-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)

#### Tambahkan perangkat di platform Navixy

* Masukkan akun pengguna Anda.
* Pilih perangkat Globalmatix dalam daftar.
* Klik **Langkah berikutnya** tombol.
* Tentukan IMEI perangkat.
* Klik **Aktifkan** tombol.

![](https://3546701789-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)

### Contoh 3. Perangkat Xirgo Global XG37/XG40/GX47

#### Konfigurasikan perangkat

1. **Atur APN.**
2. **Periksa pengaturan sesi.**
3. **Konfigurasikan alamat server:**

* Server: `devices.xgfleet.eu`
* Port: `1888`
* Protokol: `TCP`

4. **Periksa pengaturan nama topik MQTT.**
5. **Konfigurasikan pengaturan broker MQTT:**

* Nama domain / IP: *Domain yang dikonfigurasi di Panel Admin Navixy*
* Port: `1883`
* Protokol: `TCP`

**APN yang diatur**

<figure><img src="https://3546701789-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>

**Pengaturan sesi.**

<figure><img src="https://3546701789-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>

**Alamat server konfigurasi.**

<figure><img src="https://3546701789-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>

**Pengaturan nama topik MQTT**

<figure><img src="https://3546701789-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>

**Pengaturan alamat broker MQTT.**

<figure><img src="https://3546701789-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>

#### Tambahkan perangkat ke platform Navixy

* **Masukkan akun pengguna Anda:** Masuk ke akun pengguna Navixy Anda.
* **Pilih perangkat:** Pilih perangkat Xirgo XG37/XG40/GX47 yang kompatibel dengan MQTT (ditandai sebagai IOTM).
* **Lanjut ke langkah berikutnya:** Klik **Langkah berikutnya** tombol.
* **Tentukan IMEI:** Masukkan IMEI perangkat.
* **Aktifkan perangkat:** Klik **Aktifkan** tombol.

<figure><img src="https://3546701789-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/id/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.
