Sensor NiuBoL berinteraksi dengan platform akenza.io melalui protokol MQTT

Proses integrasi dengan platform akenza.io melalui protokol MQTT memerlukan penyelesaian langkah-langkah seperti konfigurasi perangkat, pembuatan aliran data, registrasi perangkat, dan implementasi kode. Di bawah ini adalah panduan terperinci, berdasarkan dokumentasi resmi akenza dan fitur protokol MQTT, yang menjelaskan cara mencapai integrasi langkah demi langkah.

Langkah 1: Buat Akun akenza.io

1. Daftarkan Akun:

- Kunjungi halaman pendaftaran di https://akenza.io dan buat akun. Jika Anda sudah memiliki akun, langsung login.

- Setelah login, Anda akan diarahkan ke dashboard platform akenza.

2. Memahami Platform:

- Platform akenza mendukung protokol MQTT dan menggunakan Eclipse Mosquitto sebagai broker MQTT. Platform bertindak sebagai broker, dan perangkat bertindak sebagai klien MQTT.

Langkah 2: Membuat Aliran Data MQTT

Aliran data menentukan cara perangkat berkomunikasi dengan platform akenza melalui MQTT .

1. Navigasikan ke Aliran Data:

- Di dasbor akenza, klik "Aliran Data" di menu sebelah kiri.

- Klik tombol "Buat Aliran Data".

2. Pilih Koneksi MQTT:

- Pada jenis koneksi, pilih "Hubungkan perangkat melalui MQTT ".

- Jenis Perangkat: Pilih "Passthrough" untuk menerima format data mentah (disarankan format JSON).

- Konektor Output: Pilih tujuan penyimpanan data, seperti akenza DB (database default) atau konektor lain yang didukung seperti InfluxDB atau Webhook.

3. Hasilkan Rahasia (Kunci):

- Setelah membuat aliran data, sistem akan secara otomatis membuat rahasia (kunci) untuk otentikasi perangkat.

- Catat rahasia ini, karena akan digunakan dalam struktur topik MQTT dan koneksi perangkat.

4. Simpan Aliran Data:

- Setelah mengonfirmasi pengaturan Anda, klik "Buat" untuk menyimpan aliran data.

Langkah 3: Daftarkan Perangkat

1. Navigasikan ke Ruang Kerja:

- Di menu sebelah kiri, klik "Ruang Kerja".

- Klik tombol "Buat Perangkat".

2. Isi Informasi Perangkat:

- Nama Perangkat: Beri nama perangkat Anda, misalnya, "Sensor cuaca" atau "Sensor tanah".

- Deskripsi (opsional): Tambahkan deskripsi untuk perangkat.

- Tag/Bidang Khusus (opsional): Tambahkan tag atau bidang khusus untuk kategorisasi.

- Aliran Data: Pilih aliran data MQTT yang dibuat pada langkah sebelumnya.

3. Buat ID Perangkat:

- Klik "Buat ID" untuk membuat ID unik untuk perangkat tersebut.

4. Selesaikan Registrasi:

- Klik "Buat Perangkat" untuk menyelesaikan registrasi perangkat.

- Setelah registrasi, temukan perangkat di menu Perangkat dan klik untuk masuk ke halaman detail perangkat.

5. Dapatkan Konfigurasi API:

- Di halaman detail perangkat di bawah tab " API-Configuration ", dapatkan informasi berikut:

- Host Broker MQTT: Biasanya mqtt.akenza.io.

- MQTT Nama Pengguna: Nama Pengguna.

- Kata Sandi MQTT: Kata Sandi.

- Topik Uplink: /up/{secret}/id/{deviceId}.

- Topik Downlink (opsional): /down/{secret}/id/{deviceId}.

Langkah 4: Konfigurasikan Perangkat untuk Terhubung ke MQTT

Menggunakan perangkat seperti sensor Niubol atau perangkat berkemampuan MQTT lainnya, konfigurasikan untuk terhubung ke broker akenza MQTT. Petunjuk berikut mengasumsikan Anda menggunakan pengumpul data Niubol.

Langkah 5: Verifikasi Data

1. Lihat Log Pesan:

- Di Ruang Kerja platform akenza, temukan perangkat Anda dan buka halaman detail perangkatnya.

- Pada tab "Log Pesan", lihat data uplink yang dikirim oleh perangkat.

- Data akan muncul dalam format JSON, misalnya, {"sensor":"temperature","value":25.5}.

2. Visualisasi Data:

- Di tab Pembuat Dasbor, lihat KPI perangkat dan diagram data historis.

- Jika topik downlink dikonfigurasi, Anda dapat menguji pengiriman perintah ke perangkat.

Langkah 6: Aktifkan TLS (Opsional)

Untuk meningkatkan keamanan, disarankan untuk menggunakan enkripsi TLS:

1. Gunakan port 8883 bukannya 1883 untuk komunikasi terenkripsi.

Catatan:

1. Metode Otentikasi:

- akenza mendukung dua metode autentikasi:

- Rahasia Uplink: Gunakan kunci bersama sebagai kata sandi MQTT.

- JWT: Gunakan kunci pribadi perangkat untuk menghasilkan JWT sebagai kata sandi (lebih aman, memerlukan konfigurasi tambahan).

- Pilih jenis autentikasi saat membuat aliran data.

2. Struktur Topik:

- Format Topik Uplink: /up/{secret}/id/{deviceId}.

- Format Topik Downlink: /down/{secret}/id/{deviceId}.

- Pastikan topik sesuai dengan konfigurasi perangkat.

3. Pemecahan masalah:

- Jika koneksi gagal, periksa:

- Pastikan nama pengguna, kata sandi, dan topik MQTT sudah benar.

- Pastikan koneksi jaringan stabil (Wi-Fi atau jaringan seluler).

- Pastikan port tidak diblokir oleh firewall (1883 atau 8883).

- Gunakan monitor serial atau log untuk melihat kode kesalahan.

4. Format yang Didukung:

- akenza menerima pesan MQTT berformat JSON, jadi pastikan data yang dikirim oleh perangkat dalam format yang benar.

Sumber Referensi:

- akenza Dokumentasi Resmi: MQTT Konektivitas:

https://docs.akenza.io/akenza.io/get-started/your-data-flow/device-connector/mqtt

- Tutorial: Cara mengintegrasikan perangkat Arduino melalui MQTT di akenza:

https://docs.akenza.io/akenza.io/tutorials/add-devices/how-to-integrate-an-arduino-device-via-mqtt-on-akenza