Aktifkan Perangkat MQTT Anda di Navixy

MQTT adalah protokol pesan ringan yang dirancang untuk komunikasi efisien antar perangkat jarak jauh dengan 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 menghubungkan perangkat GPS ke Navixy menggunakan MQTT.

Cara Kerja MQTT

MQTT beroperasi berdasarkan prinsip ‘klien dan broker’ dan menggunakan arsitektur Publish/Subscribe:

• Klien: Setiap perangkat Internet of Things (IoT) yang menjalankan pustaka MQTT, seperti server khusus, mikrokontroler, aplikasi, atau sensor.

• Broker: Server pasif yang memediasi komunikasi antar klien. Ia menangani otentikasi, 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 banyak digunakan dalam pelacakan GPS dan telematika karena fleksibilitas tinggi dan kemampuannya memenuhi kebutuhan bisnis yang beragam. Namun, mereka memerlukan proses konfigurasi yang berbeda dibandingkan perangkat tradisional.

Poin utama:

• Perangkat MQTT tidak dapat didaftarkan secara otomatis dan harus dikonfigurasi secara manual.

• Perangkat ini beroperasi menggunakan model Publisher/Subscriber, yang berbeda dari model klien-server tradisional.

Model Publisher/Subscriber vs. Model Klien-Server

Dalam model klien-server tradisional, perangkat (klien) 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 mereka dan alamat broker.

Langkah-langkah Konfigurasi Perangkat MQTT

Kami akan mendemonstrasikan 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 topik kecuali Output Control Topic Name disetel ke nilai default.

• Output Control Topic Name: %IMEI%/OUTC

Simpan konfigurasi Anda.

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

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

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. Lanjutkan 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

• Protocol: TCP

1. Verifikasi pengaturan nama topik MQTT.

2. Konfigurasikan pengaturan broker MQTT:

• Domain name / IP: Domain yang dikonfigurasi di Navixy Admin Panel

• Port: 1883

• Protocol: TCP

APN telah disetel

Pengaturan Sesi.

Alamat server konfigurasi.

Pengaturan nama topik 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).

• Lanjutkan ke Langkah Berikutnya: Klik tombol “Next Step”.

• Tentukan IMEI: Masukkan IMEI perangkat.

• Aktifkan Perangkat: Klik tombol “Activate”.