Cara menghubungkan sensor NiuBoL ke platform Thinger IoT melalui protokol MQTT

Halaman ini (https://docs.thinger.io/mqtt) menjelaskan cara menghubungkan perangkat Niubol ke platform Thinger.io melalui protokol MQTT. MQTT adalah protokol pesan publikasi/langganan yang ringan, sangat cocok untuk komunikasi antara perangkat dan platform IoT. Di bawah ini, saya akan merangkum isi halaman dan memberikan panduan langkah demi langkah tentang cara menghubungkan perangkat Anda ke platform Thinger.io menggunakan MQTT . 

Artikel ini akan menjelaskan bagaimana sensor NiuBoL, melalui data logger (gateway/perekam data), menggunakan protokol MQTT untuk terhubung ke platform Thinger.io. Thinger.io mendukung protokol MQTT, memungkinkan perangkat berkomunikasi dengan platform dengan mempublikasikan (Publish) dan berlangganan (Subscribe) pesan. Perangkat perlu menggunakan format topik MQTT tertentu dan mengautentikasi melalui token perangkat. Artikel ini juga akan menjelaskan cara mengonfigurasi klien MQTT, terhubung ke server MQTT Thinger.io, mempublikasikan dan berlangganan data, serta mengelola properti perangkat, sumber daya, dan callback.

 *Prasyarat:

- Kamu sudah punya akun Thinger.io. Jika belum, silakan daftar.

- Perangkat Anda mendukung protokol MQTT. 

 Panduan Langkah demi Langkah 

 Langkah 1: Buat Perangkat di Thinger.io

1. Masuk ke Thinger.io

- Buka browser Anda, kunjungi Thinger.io, dan masuk menggunakan nama pengguna dan kata sandi Anda.

2. Buka Halaman Manajemen Perangkat

- Di menu kiri, klik "Devices."

3. Tambahkan Perangkat Baru

- Klik tombol "Tambah Perangkat".

4. Pilih Jenis Perangkat

- Jenis Perangkat: Pilih "MQTT Perangkat."

- ID Perangkat: Masukkan nama perangkat unik, misalnya, " NiuBoL ."

- Kredensial Perangkat: Ini adalah kata sandi keamanan perangkat, yang dapat dihasilkan secara acak menggunakan tombol di bagian bawah. Salin dan simpan token ini untuk digunakan nanti.

- Deskripsi: Opsional, isi deskripsi seperti "Perangkat MQTT saya," saya menggunakan "Soil sensor NBL-S-TMC."

- Klik "Tambah Perangkat" untuk menyimpan.

Setelah membuat perangkat, Anda dapat klik untuk memasukkan perangkat guna mengatur atau mengubah kata sandinya.

Catatan:

- Jenis Perangkat: "MQTT perangkat" harus dipilih.

- Pengidentifikasi Perangkat: Harus unik di antara perangkat Anda.

- Deskripsi Perangkat: Informasi tambahan untuk membantu mengidentifikasi setiap perangkat.

- Kredensial Perangkat: Ini adalah kata sandi keamanan perangkat, yang dapat dibuat secara acak menggunakan tombol di bagian bawah. 

Setelah semua informasi dimasukkan, menekan tombol "Tambah Perangkat" akan membuat profil perangkat baru di daftar perangkat. Jika semuanya benar, menunjukkan bahwa platform Thinger.io siap menerima data dari perangkat MQTT Anda. 

 Langkah 2: Buat Dashboard

- Buat dashboard baru dan atur informasi yang diperlukan.

Menambahkan Dashboard dan mengatur informasi terkait

- Setelah dashboard dibuat, Anda dapat melanjutkan untuk menampilkan data. 

 Langkah 3: Buat Data Bucket

1. Simpan Data

- Di dasbor perangkat Thinger.io, buat bucket data, seperti "Soildata" atau "Weatherdata," atau sesuaikan sesuai preferensi Anda.

- Di pengaturan perangkat, konfigurasikan untuk menyimpan data MQTT masuk di dalam bucket.

Parameter berikut perlu dikonfigurasi:

- Bucket ID: Pengenal unik untuk bucket, misalnya, "Soildata" atau "Weatherdata."

- Nama Ember: Gunakan nama representatif, seperti "Data Cuaca" atau "Data tanah" atau nama proyek.

- Deskripsi Ember: Berikan detail tambahan, seperti "Data sensor tanah."

- Diaktifkan: Aktifkan atau nonaktifkan rekaman data bucket. Aktifkan untuk mengaktifkannya.

- Sumber Data: Biasanya mendefinisikan perangkat atau sumber daya Thinger.io yang dilanggan oleh server. Dalam kasus ini, Anda harus memilih "Dari MQTT Topik."

- MQTT Topik: Masukkan topik MQTT yang akan dilanggan oleh server. 

Misalnya:

- MQTT Topik: username/perangkat Anda/ NiuBoL /Soildata 

Dengan cara ini, Thinger.io akan mengonfigurasi platform sebagai broker MQTT sekaligus sebagai konsumen topik, sehingga memungkinkan fitur tambahan. Klien harus mengirim data dalam format JSON. 

 Langkah 4: Konfigurasikan aturan dan parameter pengumpulan Modbus pada Data Logger (Gateway)

Pengaturan Dasar: Atur Periode Pengumpulan dan Periode Laporan sesuai kebutuhan Anda.

Pengaturan Antarmuka:

Modbus Pengaturan Aturan: Rujuk pada tabel data sensor tertentu.

Atur Unit Output Sensor dan Presisi.

Langkah 5: Pengaturan Server - Atur Parameter Koneksi MQTT pada Data Logger (Data Recorder/Gateway)

Misalnya:

- Protokol Komunikasi: MQTT

- Jenis Enkapsulasi: JSON

- Alamat Server: backend.thinger.io

- Pelabuhan: 1883

- MQTT Topik Publik: username/perangkat Anda/ NiuBoL /Soildata

- MQTT Subscribe Topic: Bisa kosong

- MQTT Username: username Anda (username Thinger.io Anda)

- MQTT Kata Sandi: Ini adalah kata sandi Kredensial Perangkat.

- Client ID: Pengenal perangkat yang dikonfigurasi dalam formulir perangkat, seperti " NiuBoL "

Catatan:

- Alamat Broker: backend.thinger.io (tanpa bagian http://)

- Port Broker: 1883 untuk koneksi non-aman, atau 8883 untuk SSL/TLS

- Nama pengguna: nama pengguna Anda (bukan alamat email Anda).

- MQTT Topik Publik:/devices//

- MQTT Topik Berlangganan: Bisa kosong

- MQTT Kata Sandi: Harus cocok dengan kata sandi yang Anda tempatkan di kolom "Kredensial Perangkat" pada Thinger.io.

- Client ID: Pengenal perangkat yang Anda atur di formulir perangkat. 

2. Uji Koneksi

- Mulai klien dan periksa apakah koneksi berhasil.

- Jika koneksi gagal, periksa:

- Apakah nama pengguna dan kata sandi benar.

- Apakah jaringan berfungsi (periksa apakah port 1883 diblokir oleh firewall). 

 Langkah 6: Verifikasi dan Debugging

1. Periksa Dashboard Thinger.io

- Kembali ke Thinger.io dan masuk ke dashboard "Soildata".

- Periksa apakah data telah diterima di "Properti Perangkat" atau "Bucket Data."

Setelah perangkat online, itu menandakan koneksi yang berhasil.

 Anda dapat memeriksa Data Bucket untuk melihat apakah data sedang diterima.

Jika Anda perlu mengubah kata sandi, Anda dapat mengaturnya di pengaturan Data Buckets. Tidak diperlukan tindakan jika Anda tidak perlu memodifikasinya. 

 Langkah 7: Konfigurasikan Penyimpanan dan Tampilan Data

- Buat dashboard (Dashboard), tambahkan grafik, dan ikatkan ke Data Buckets untuk melihat data secara real-time.

- Tambahkan tab atau widget.

- Pilih jenis Widget.

- Pilih sumber data untuk Widget.

- Tetapkan satuan pengukuran, nilai maksimum, dan minimum.

Tampilan Data: Setelah diatur, data akan ditampilkan di dashboard.

Debugging Akhir:

- Jika data tidak ditampilkan, periksa:

- Apakah format topik sudah benar.

- Apakah token perangkat valid.

- Apakah format pesan benar (misalnya, JSON).

Cara menghubungkan sensor NiuBoL ke platform Thinger IoT melalui MQTT Protocol.pdf