> 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
MQTT adalah protokol perpesanan ringan yang dirancang untuk komunikasi yang efisien antara perangkat jarak jauh dengan lebar pita jaringan minimal. Ini adalah pilihan yang sangat baik untuk komunikasi antarmesin (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 perantara” dan menggunakan arsitektur penerbitan/langganan:
* **Klien**: Setiap perangkat IoT yang menjalankan pustaka MQTT, seperti server khusus, mikrokontroler, aplikasi, atau sensor.
* **Perantara**: Server pasif yang memediasi komunikasi antara klien. Server ini menangani autentikasi, mengelola koneksi, sesi, dan langganan.
Dalam pengaturan ini, klien terhubung ke perantara, 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 khas dibandingkan perangkat tradisional.
**Poin penting:**
* Perangkat MQTT tidak dapat didaftarkan secara otomatis dan harus dikonfigurasikan secara manual.
* Perangkat ini beroperasi menggunakan model penerbit/pelanggan, yang berbeda dari model klien-server tradisional.
**Model penerbit/pelanggan vs. model klien-server**
Dalam model klien-server tradisional, perangkat (klien) mengirim paket data langsung ke server, yang kemudian memproses data dan mengirimkan balasan kembali ke perangkat. Model ini sederhana tetapi terbatas pada komunikasi satu-ke-satu.
Sebaliknya, model penerbit/pelanggan yang digunakan oleh perangkat MQTT memungkinkan komunikasi yang lebih fleksibel dan mudah diskalakan. Berikut cara kerjanya:
* **Penerbit**: Perangkat mengirim paket data ke perantara MQTT.
* **Perantara**: Perantara menyimpan paket-paket data ini.
* **Pelanggan**: Server Navixy berlangganan paket data dari perangkat tertentu menggunakan nomor IMEI dan alamat perantara.
## 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 perantara MQTT.
* Masukkan parameter berikut:\
Platform AS: `mqtt.us.navixy.com` Port `1883`\
Platform UE: `mqtt.eu.navixy.com` Port `1883`
Di MQTT Keamanan → Otorisasi, tambahkan pengguna dengan pengaturan berikut:
* **ID klien**: `%IMEI%`
* **Nama pengguna**: `bce_device`
* **Kata sandi**: `secretword`
Pastikan konfigurasi topik Anda benar:
* Semua topik, kecuali Nama topik kontrol keluaran, diatur ke nilai bawaan.
* Nama topik kontrol keluaran: `%IMEI%/OUTC`
Simpan konfigurasi Anda.
Setiap topik yang diawali dengan “BCE” menunjukkan bahwa perangkat beroperasi sebagai penerbit dalam kasus-kasus ini. Untuk data telemetri, peristiwa, berkas, dan data waktu nyata, perangkat bertindak sebagai penerbit, mengirim paket-paket ini ke perantara. Server Navixy kemudian dapat mengambil paket data ini dari perantara. Komunikasi antara pelanggan dan penerbit dikelola melalui topik, dan setiap topik sesuai dengan jenis pesan tertentu.
Untuk perintah yang mengalihkan keluaran perangkat, perangkat berfungsi sebagai pelanggan. Perangkat ini mengharapkan menerima perintah dari server Navixy, yang dikirim melalui perantara menggunakan IMEI perangkat. Dalam kasus ini, perangkat memahami bahwa keluaran harus dialihkan.
Saat mengonfigurasi perangkat yang kompatibel dengan MQTT, pengguna harus menentukan nama pengguna dan kata sandi yang diharapkan oleh server. Pengaturan ini ditampilkan pada tangkapan layar di atas.
#### Tambahkan perangkat ke platform Navixy
1. **Masuk ke akun pengguna Anda**: Masuk ke akun pengguna Navixy Anda.
2. **Pilih perangkat**: Pilih perangkat yang kompatibel dengan MQTT Xirgo Global (BCE) (ditandai sebagai IOTM).
3. **Lanjutkan ke langkah berikutnya**: Klik **Langkah berikutnya** tombol.
4. **Tentukan IMEI**: Masukkan IMEI perangkat.
5. **Aktifkan perangkat**: Klik **Aktifkan** tombol.
### 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`
* **Nama pengguna/Kata sandi**: `globalmatix_device/secretword`
* Simpan konfigurasi.
#### Tambahkan perangkat di platform Navixy
* Masuk ke akun pengguna Anda.
* Pilih perangkat Globalmatix dalam daftar.
* Klik **Langkah berikutnya** tombol.
* Tentukan IMEI perangkat.
* Klik **Aktifkan** tombol.
### Contoh 3. Perangkat Xirgo Global XG37/XG40/GX47
#### Konfigurasikan perangkat
1. **Atur APN.**
2. **Verifikasi pengaturan sesi.**
3. **Konfigurasikan alamat server:**
* Server: `devices.xgfleet.eu`
* Port: `1888`
* Protokol: `TCP`
4. **Periksa pengaturan nama topik MQTT.**
5. **Konfigurasikan pengaturan perantara MQTT:**
* Nama domain / IP: *Domain yang dikonfigurasikan di Panel Admin Navixy*
* Port: `1883`
* Protokol: `TCP`
**APN yang diatur**
**Pengaturan sesi.**
**Alamat server konfigurasi.**
**Pengaturan nama topik MQTT**
**Pengaturan alamat perantara MQTT.**
#### Tambahkan perangkat ke platform Navixy
* **Masukkan akun pengguna Anda:** Masuk ke akun pengguna Navixy Anda.
* **Pilih perangkat:** Pilih perangkat yang kompatibel dengan MQTT Xirgo XG37/XG40/GX47 (ditandai sebagai IOTM).
* **Lanjutkan ke langkah berikutnya:** Klik **Langkah berikutnya** tombol.
* **Tentukan IMEI:** Masukkan IMEI perangkat.
* **Aktifkan perangkat:** Klik **Aktifkan** tombol.
---
# 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/id/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.