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 perpesanan publikasi/langganan yang ringan, sangat cocok untuk komunikasi antara perangkat dan platform IoT. Di bawah ini, saya akan merangkum konten halaman dan memberikan panduan langkah demi langkah tentang cara menghubungkan perangkat Anda ke platform Thinger.io menggunakan MQTT.

Artikel ini akan merinci bagaimana sensor NiuBoL, melalui pencatat data (gateway/perekam data), menggunakan protokol MQTT untuk terhubung ke platform Thinger.io. Thinger.io mendukung protokol MQTT, memungkinkan perangkat untuk berkomunikasi dengan platform dengan menerbitkan (Publikasikan) dan berlangganan (Berlangganan) ke pesan. Perangkat perlu menggunakan format topik MQTT tertentu dan mengautentikasi melalui token perangkat. Artikel ini juga akan menjelaskan cara mengonfigurasi klien MQTT, menyambungkan ke server MQTT Thinger.io, menerbitkan dan berlangganan data, serta mengelola properti perangkat, sumber daya, dan panggilan balik.

*Prasyarat:

- Anda sudah memiliki akun Thinger.io. Jika tidak, 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 "Perangkat".

3. Tambahkan Perangkat Baru

- Klik tombol "Tambah Perangkat".

4. Pilih Jenis Perangkat

- Jenis Perangkat: Pilih "MQTT Perangkat."

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

- Kredensial Perangkat: Ini adalah kata sandi keamanan perangkat, yang dapat dibuat 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 "Sensor tanahNBL-S-TMC."

- Klik "Add Device" untuk menyimpan.

Setelah membuat perangkat, Anda dapat mengklik untuk masuk ke perangkat untuk mengatur atau mengubah kata sandinya.

Catatan:

- Jenis Perangkat: "Perangkat MQTT" harus dipilih.

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

Ketika 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 Dasbor

- Buat dasbor baru dan siapkan informasi yang diperlukan.

Menambahkan Dasbor dan menyiapkan informasi terkait

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

Langkah 3: Buat Bucket Data

1. Simpan Data

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

- Di setelan perangkat, konfigurasikan untuk menyimpan data MQTT yang masuk dalam bucket.

Parameter berikut perlu dikonfigurasi:

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

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

- Deskripsi Bucket: Berikan detail tambahan apa pun, seperti "Data sensor tanah".

- Diaktifkan: Mengaktifkan atau menonaktifkan perekaman bucket data. Nyalakan untuk mengaktifkannya.

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

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

Sebagai contoh:

-MQTT Topik: nama pengguna/perangkat/NiuBoL/Soildata

Dengan cara ini, Thinger.io akan mengonfigurasi platform sebagai broker MQTT tetapi juga sebagai konsumen topik, 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 Kumpulkan dan Periode Laporan sesuai dengan kebutuhan Anda.

Pengaturan Antarmuka:

Modbus Pengaturan Aturan: Lihat tabel data sensor tertentu.

Atur unit output sensor dan presisi.

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

Sebagai contoh:

- Protokol Komunikasi:MQTT

- Jenis Enkapsulasi: JSON

- Alamat Server: backend.thinger.io

- Pelabuhan: 1883

-MQTT Topik Publik: nama pengguna/perangkat/NiuBoL Anda /Soildata

-MQTT Topik Berlangganan: Bisa kosong

-MQTT Nama pengguna: nama pengguna Anda (nama pengguna Thinger.io Anda)

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

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

Catatan:

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

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

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

- MQTT Topik Publik: /perangkat//

- MQTT Topik Berlangganan: Bisa kosong

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

- ID Klien: ID perangkat yang Anda siapkan di formulir perangkat.

2. Uji Koneksi

- Mulai klien dan periksa apakah koneksi berhasil.

- Jika koneksi gagal, periksa:

- Apakah nama pengguna dan kata sandi sudah benar.

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

Langkah 6: Verifikasi dan Debugging

1. Periksa Dasbor Thinger.io

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

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

Setelah perangkat online, ini menunjukkan koneksi berhasil.

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

Jika Anda perlu mengubah kata sandi, Anda dapat mengaturnya di pengaturan Bucket Data. Tidak ada tindakan yang diperlukan jika Andadotidak perlu memodifikasinya.

Langkah 7: Konfigurasikan Penyimpanan dan Tampilan Data

- Buat dasbor (Dasbor), tambahkan bagan, dan ikat ke Data Bucket untuk melihat data secara real-time.

- Tambahkan tab atau widget.

- Pilih jenis Widget.

- Pilih sumber data untuk Widget.

- Atur satuan pengukuran, nilai maksimum, dan minimum.

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

Debugging Akhir:

- Jika data tidak ditampilkan, periksa:

- Apakah format topik sudah benar.

- Apakah token perangkat valid.

- Apakah format pesan sudah benar (misalnya, JSON).

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