Hubungkan perangkat gateway MQTT ke IoT Platform menggunakan MQTT.fx - IoT Platform

Artikel ini menjelaskan cara menghubungkan perangkat gateway Message Queuing Telemetry Transport (MQTT) simulasi ke IoT Platform menggunakan MQTT.fx di Windows. Artikel ini juga mencakup cara mengirimkan data perangkat melalui topik.

Prasyarat

Sebuah instance IoT Platform Enterprise Edition telah dibeli. Dalam contoh ini, sebuah instance Exclusive Enterprise Edition dibeli di wilayah China (Shanghai).
Alat MQTT.fx telah diunduh dan diinstal.
Dalam contoh ini, mqttfx-5.2.0-windows-x64 digunakan. Alat pihak ketiga ini tidak diperbarui secara berkala. Kami menyarankan Anda untuk mengunduh versi terbaru dari situs web pada tautan referensi sebelumnya.
Sertifikat kustom tersedia.
Dalam contoh ini, sertifikat kustom mencakup file sertifikat root bernama root-ca.crt, file kunci privat sisi server bernama server.key, dan file sertifikat sisi server bernama server.crt.
Anda dapat menggunakan OpenSSL untuk menghasilkan sertifikat kustom. Untuk informasi lebih lanjut tentang cara menghasilkan sertifikat, lihat Hasilkan Sertifikat Kustom.

Informasi latar belakang

MQTT.fx adalah klien MQTT berbasis Eclipse Paho yang ditulis dalam Java. MQTT.fx mendukung sistem operasi Windows, macOS, dan Linux. Anda dapat menggunakan MQTT.fx untuk memeriksa apakah perangkat dapat terhubung ke IoT Platform. MQTT.fx juga memungkinkan perangkat untuk berkomunikasi dengan IoT Platform menggunakan topik.

Gateway MQTT memungkinkan perangkat menggunakan verifikasi satu pihak atau pihak ketiga untuk otentikasi. Perangkat dapat menggunakan sertifikat kustom, verifikasi sisi server, atau pengiriman pesan melalui topik kustom untuk melewati verifikasi. Dengan cara ini, perangkat dapat terhubung dan berkomunikasi dengan IoT Platform.

Untuk informasi lebih lanjut tentang verifikasi dan komunikasi antara gateway MQTT dan perangkat, lihat Gateway MQTT.

Gunakan MQTT.fx untuk menghubungkan perangkat (verifikasi satu pihak)

Langkah 1: Buat gateway dan perangkat

Buat gateway MQTT: Tentukan isi file server.key di parameter Private Key of Server Certificate, dan tentukan isi file server.crt di parameter Server Certificate
Di halaman Gateway, temukan gateway yang Anda buat, salin nilai di kolom Gateway URL, dan simpan nilainya.
Tambahkan beberapa perangkat: Dalam contoh ini, sebuah perangkat ditambahkan. Nama Pengguna MQTT adalah device_01 dan Kata Sandi MQTT adalah hello123.

Langkah 2: Gunakan MQTT.fx untuk menghubungkan perangkat

Jalankan MQTT.fx, klik Extras pada bilah menu, lalu pilih Edit Connection Profiles.

Di halaman Edit Connection Profiles, konfigurasikan parameter.

Tentukan informasi dasar dalam tabel berikut. Gunakan nilai default untuk parameter yang tidak ada di tabel.

Parameter	Deskripsi
Nama Profil	Masukkan nama kustom.
Tipe Profil	Tentukan mode koneksi. Pilih MQTT Broker.
Alamat Broker	Masukkan titik akhir MQTT, yaitu nilai parameter Gateway URL yang Anda peroleh saat membuat gateway.
Broker Port	Masukkan nomor port. Nilai defaultnya adalah `1883`.
ID Klien	Opsional. ID perangkat. ID harus memiliki panjang 1 hingga 64 karakter. Kami menyarankan Anda menggunakan alamat MAC atau nomor seri (SN) perangkat sebagai ID.

Klik Kredensial Pengguna. Di tab yang muncul, pilih Gunakan Nama Pengguna/Kata Sandi dan masukkan nama pengguna dan kata sandi.
Dalam contoh ini, parameter Nama Pengguna diatur ke Nama Pengguna MQTT perangkat, dan parameter Kata Sandi diatur ke Kata Sandi MQTT perangkat.
Klik TLS/SSL, pilih Aktifkan SSL/TLS, lalu atur parameter Protokol ke TLSv1.2.
Pilih file sertifikat CA, lalu pilih jalur file root-ca.crt.

Klik OK di pojok kanan bawah.
Klik Hubungkan.
Jika indikator di sisi kanan berubah menjadi hijau, koneksi berhasil. Di konsol IoT Platform, klik instance yang ingin Anda kelola untuk masuk ke halaman Detail Instance. Pilih Perangkat > Perangkat. Di tab Daftar Perangkat, status device_01 adalah Online.

Gunakan MQTT.fx untuk menghubungkan perangkat (verifikasi pihak ketiga)

Langkah 1: Buat fungsi di Function Compute untuk memverifikasi perangkat

Masuk ke konsol Function Compute. Di panel navigasi di sebelah kiri, klik Services & Functions.
Di bilah navigasi atas, pilih wilayah. Di halaman Services, klik Create Service.
Di panel Create Service, masukkan service name. Contoh: IoT_Service. Lalu, klik OK.
Di halaman Functions, klik Create Function.
Di halaman Create Function, konfigurasikan parameter dan klik Create, seperti yang ditunjukkan pada gambar berikut.

Di halaman Detail Fungsi, ganti kode sampel yang ada dengan kode berikut lalu klik Deploy.

Fungsi verifikasi mengembalikan nilai parameter MQTT UserName sebagai nilai parameter deviceName.

# -*- coding: utf-8 -*-
import logging
import json
import time
import enum
import random
import string

class Request:
    def __init__(self, json_str):
        self.clientId = None
        self.username = None
        self.password = None
        self.certificateCommonName = None

        for key, value in json.loads(json_str).items():
            setattr(self, key, value)

class Response:
    def __init__(self):
        self.deviceName = None
        self.result = 'true'
        self.message = 'success'

    def handler(self, request):
        # Verifikasi validitas parameter MQTT UserName dan MQTT Password berdasarkan persyaratan bisnis Anda.
    
        self.deviceName = request.username
        
        
        return json.dumps(self.__dict__)

def handler(event, context):
    request = Request(event)
    return Response().handler(request)

Langkah 2: Buat gateway

Buat gateway MQTT: Tentukan isi file server.key di parameter Private Key of Server Certificate, dan tentukan isi file server.crt di parameter Server Certificate. Pilih IoT_Service untuk parameter Device-verified FC Service, dan pilih three_part_auth untuk parameter Device-verified FC Function.
Di halaman Gateway, temukan gateway yang Anda buat, salin URL di kolom Gateway URL, dan simpan URL tersebut.

Langkah 3: Gunakan MQTT.fx untuk menghubungkan perangkat

Jalankan MQTT.fx, klik Extras di bilah menu, lalu pilih Edit Connection Profiles.

Di halaman Edit Connection Profiles, konfigurasikan parameter. Tabel berikut menjelaskan parameter tersebut.

Tentukan informasi dasar dalam tabel berikut. Gunakan nilai default untuk parameter yang tidak ada di tabel.

Parameter	Deskripsi
Nama Profil	Masukkan nama kustom.
Tipe Profil	Tentukan mode koneksi. Pilih MQTT Broker.
Alamat Broker	Masukkan titik akhir MQTT, yaitu nilai parameter Gateway URL yang Anda peroleh saat membuat gateway.
Port Broker	Masukkan nomor port. Nilai defaultnya adalah `1883`.
ID Klien	Opsional. ID perangkat. ID harus memiliki panjang 1 hingga 64 karakter. Kami menyarankan Anda menggunakan alamat MAC atau SN perangkat sebagai ID.

Klik Kredensial Pengguna. Di tab yang muncul, pilih Gunakan Nama Pengguna/Kata Sandi dan konfigurasikan parameter Nama Pengguna dan Kata Sandi. Dalam contoh ini, parameter Nama Pengguna diatur ke threeParty_device_001.
Catatan
- Nilai parameter Nama Pengguna harus memiliki panjang 4 hingga 32 karakter, dan dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), tanda @, titik (.), dan titik dua (:). Nilai parameter Nama Pengguna harus unik di antara semua perangkat suatu produk.
- Nilai parameter Kata Sandi harus memiliki panjang 1 hingga 32 karakter, dan dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), tanda @, titik (.), dan titik dua (:).
Klik TLS/SSL, pilih Aktifkan SSL/TLS, lalu atur parameter Protokol ke TLSv1.2.
Pilih File sertifikat CA, lalu pilih jalur file root-ca.crt.

Klik OK di pojok kanan bawah.
Klik Hubungkan.
Jika indikator di sisi kanan berubah menjadi hijau, koneksi berhasil. Fungsi verifikasi di Function Compute mengembalikan threeParty_device_001 sebagai nilai parameter deviceName. threeParty_device_001 digunakan sebagai DeviceName perangkat yang dibuat secara otomatis di konsol IoT Platform. Anda dapat memilih Perangkat > Perangkat untuk melihat status perangkat. Dalam contoh ini, status perangkat adalah Online.

Gunakan topik kustom untuk mengirimkan data perangkat

Di MQTT.fx, klik Publish. Di bidang Publish, masukkan jalur topik kustom. Dalam contoh ini, jalurnya adalah /home/garden/fountain.
Di editor teks, masukkan pesan yang ingin Anda publikasikan dan klik Publish.
Masuk ke konsol IoT Platform. Temukan instance yang ingin Anda kelola, masuk ke halaman Detail Instance, dan pilih Maintenance > Device Log. Di halaman Log Perangkat, lihat log yang bertipe Pesan Perangkat-ke-Awan. Untuk informasi lebih lanjut, lihat Kueri Log IoT Platform.