# Aktifkan perangkat MQTT Anda di Navixy
MQTT adalah protokol pesan ringan yang dirancang untuk komunikasi yang efisien antara perangkat jarak jauh dengan penggunaan bandwidth jaringan yang minimal. Ini merupakan pilihan yang sangat baik untuk komunikasi Machine-to-Machine (M2M), sehingga ideal untuk proyek telematika kendaraan. Dokumen ini menjelaskan cara menghubungkan perangkat GPS ke Navixy menggunakan MQTT.
## Cara Kerja MQTT
MQTT beroperasi berdasarkan prinsip ‘client and broker’ dan menggunakan arsitektur Publish/Subscribe:
* **Client**: Perangkat Internet of Thing (IoT) apa pun yang menjalankan library MQTT, seperti server khusus, mikrokontroler, aplikasi, atau sensor.
* **Broker**: Server pasif yang menjadi perantara komunikasi antara client. Server ini menangani autentikasi, mengelola koneksi, sesi, dan langganan.
Dalam pengaturan ini, client terhubung ke broker, yang kemudian memfasilitasi komunikasi antara client penerbit (perangkat yang mengirim data) dan client pelanggan (perangkat atau server yang menerima data).
## Mengaktifkan Perangkat MQTT Anda di Navixy
Perangkat MQTT semakin umum digunakan dalam pelacakan GPS dan telematika karena fleksibilitasnya yang tinggi dan kemampuannya memenuhi berbagai kebutuhan bisnis. Namun, perangkat ini memerlukan proses konfigurasi yang unik dibandingkan perangkat tradisional.
**Poin-poin penting:**
* Perangkat MQTT tidak dapat didaftarkan secara otomatis dan harus dikonfigurasi secara manual.
* Perangkat ini beroperasi menggunakan model Publisher/Subscriber, yang berbeda dari model client-server tradisional.
**Model Publisher/Subscriber vs. Model Client-Server**
Dalam model client-server tradisional, perangkat (client) mengirim paket data langsung ke server, yang kemudian memproses data dan mengirimkan respons kembali ke perangkat. Model ini sederhana tetapi terbatas pada komunikasi satu-ke-satu.
Sebaliknya, model Publisher/Subscriber yang digunakan oleh perangkat MQTT memungkinkan komunikasi yang lebih fleksibel dan skalabel. Berikut cara kerjanya:
* **Publisher**: Perangkat mengirim paket data ke broker MQTT.
* **Broker**: Broker menyimpan paket data tersebut.
* **Subscriber**: Server Navixy berlangganan paket data dari perangkat tertentu menggunakan nomor IMEI dan alamat broker.
## Langkah Konfigurasi Perangkat MQTT
Kami akan menunjukkan cara mengonfigurasi perangkat MQTT Anda di platform Navixy melalui beberapa contoh.
### Contoh 1. Perangkat Xirgo Global (ex BCE)
#### Konfigurasikan Perangkat di FMSET
* Masuk ke akun FMSET Anda.
* Buka Connectivity → Telemetry Server → MQTT Broker Address Settings.
* Masukkan parameter berikut:\
platform AS: `mqtt.us.navixy.com` port `1883`\
platform UE: `mqtt.eu.navixy.com` port `1883`
Di MQTT Security → Authorization, tambahkan pengguna dengan pengaturan berikut:
* **Client ID**: `%IMEI%`
* **Username**: `bce_device`
* **Password**: `secretword`
Pastikan konfigurasi topic Anda benar:
* Semua topic kecuali Output Control Topic Name diatur ke nilai default.
* Output Control Topic Name: `%IMEI%/OUTC`
Simpan konfigurasi Anda.
Setiap topic yang diawali dengan “BCE” menunjukkan bahwa perangkat beroperasi sebagai publisher dalam kasus ini. Untuk data telemetri, event, file, dan data real-time, perangkat bertindak sebagai publisher, mengirim paket-paket ini ke broker. Server Navixy kemudian dapat mengekstrak paket data ini dari broker. Komunikasi antara subscriber dan publisher dikelola melalui topic, dengan setiap topic mewakili jenis pesan tertentu.
Untuk perintah yang mengalihkan output perangkat, perangkat berfungsi sebagai subscriber. Perangkat mengharapkan menerima perintah dari server Navixy, yang dikirim melalui broker menggunakan IMEI perangkat. Dalam kasus ini, perangkat memahami bahwa output harus dialihkan.
Saat mengonfigurasi perangkat yang kompatibel dengan MQTT, pengguna harus menentukan username dan password yang diharapkan oleh server. Pengaturan ini ditampilkan dalam tangkapan layar yang disediakan di atas.
#### Tambahkan Perangkat ke platform Navixy
1. **Masuk ke 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 tombol “Next Step”.
4. **Tentukan IMEI**: Masukkan IMEI perangkat.
5. **Aktifkan Perangkat**: Klik tombol “Activate”.
### Contoh 2. Perangkat Globalmatix xTCU
#### Konfigurasikan Perangkat
* Masukkan pengaturan berikut:\
platform AS: `mqtt.us.navixy.com:1883`\
platform UE: `mqtt.eu.navixy.com:1883`
* **Topic**: `globalmatix/in`
* **Login/Password**: `globalmatix_device/secretword`
* Simpan konfigurasi.
#### Tambahkan Perangkat di Platform Navixy
* **Masuk ke akun pengguna Anda.**
* **Pilih perangkat Globalmatix dalam daftar.**
* **Klik tombol “Next Step”.**
* **Tentukan IMEI perangkat.**
* **Klik tombol “Activate”.**
### 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. **Verifikasi pengaturan nama topic MQTT.**
5. **Konfigurasikan pengaturan broker MQTT:**
* Nama domain / IP: *Domain yang dikonfigurasi di Navixy Admin Panel*
* Port: `1883`
* Protokol: `TCP`
**APN diatur**
**Pengaturan Sesi.**
**Alamat server konfigurasi.**
**Pengaturan nama topic MQTT**
**Pengaturan alamat broker MQTT.**
#### **Tambahkan Perangkat ke platform Navixy**
* **Masuk ke 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 tombol “Next Step”.
* **Tentukan IMEI:** Masukkan IMEI perangkat.
* **Aktifkan Perangkat:** Klik tombol “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/id/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.