全部产品
Search
文档中心

IoT Platform:Simulasi Perangkat

更新时间:Jul 02, 2025

Fitur simulasi perangkat dari IoT Platform menyediakan simulator untuk mensimulasikan koneksi antara perangkat fisik dan IoT Platform. Anda dapat menggunakan simulator ini beserta data uji untuk memeriksa konektivitas serta menyelesaikan masalah terkait koneksi. Topik ini menjelaskan cara mensimulasikan perangkat dan menghubungkan perangkat yang disimulasikan ke IoT Platform.

Fitur

Simulator perangkat memungkinkan Anda melakukan debugging koneksi antara perangkat dan IoT Platform. Tabel berikut menjelaskan fitur debugging yang tersedia.

Fitur

Deskripsi

Debug Hulu

Perangkat mengirim pesan ke IoT Platform dalam skenario berikut:

  • Gunakan topik kustom untuk mengirimkan pesan dan berlangganan pesan

  • Mengirimkan properti

  • Mengirimkan event

Debug Hilir

IoT Platform mengirim pesan ke perangkat dalam skenario berikut:

  • Gunakan topik kustom untuk mengirim pesan

  • Mengelola properti, seperti menanyakan atau memodifikasi properti

  • Memanggil layanan

Batasan

  • Anda dapat mengonfigurasi kebijakan pengiriman properti dan event secara berkala.

    • Jika Anda memodifikasi pengaturan kebijakan beberapa kali, hanya modifikasi terbaru yang akan diterapkan.

    • Interval minimum antar pesan berturut-turut adalah 1 detik.

    • Periode maksimum untuk pengiriman pesan berturut-turut adalah 3 jam.

  • Simulator perangkat tidak dapat digunakan untuk perangkat dengan parameter Tipe Data diatur ke Kustom.

  • Simulator perangkat tidak dapat digunakan untuk perangkat fisik yang sedang online atau dinonaktifkan.

  • Simulator perangkat akan dinonaktifkan setelah Anda meninggalkan halaman Simulasi Perangkat.

  • Jika Anda menentukan Titik akhir Message Queuing Telemetry Transport (MQTT) dan Sertifikat kustom untuk instance Eksklusif, fitur simulasi perangkat tidak dapat digunakan pada instance tersebut. Untuk informasi lebih lanjut tentang sertifikat kustom, lihat Buat sertifikat kustom untuk titik akhir MQTT dari instance Eksklusif.

Prosedur

  1. Masuk ke Konsol IoT Platform.

  2. Di halaman Overview, klik All environment. Pada tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID atau nama instance tersebut.

  3. Di panel navigasi sebelah kiri, pilih Devices > Device Simulation.

  4. Pilih produk, lalu pilih perangkat yang ingin disimulasikan. Di halaman Simulasi Perangkat, klik Start Device Simulation.

  5. Di kotak dialog MQTT Connection Parameters, pilih MQTT protocol version dan klik OK.

    Untuk informasi lebih lanjut tentang MQTT, lihat Protokol MQTT.

    MQTT协议版本

  6. Pilih fitur dan kirim data untuk melakukan debugging fitur tersebut. Tabel berikut menjelaskan fitur-fiturnya.

    Debug Hulu

    Topik Kustom

    • Message Reporting: Simulator perangkat menggunakan topik kustom untuk mengirim pesan ke IoT Platform.

      1. Pilih Upstream Debug > Topic Category

      2. Pilih topik kustom untuk mengirim pesan dan konfigurasikan parameter Payload Data.

      3. Atur parameter Qos ke 0 atau 1.

      4. Jika Anda mengatur parameter Versi Protokol MQTT ke 5.0, Anda dapat mengonfigurasi parameter Retained Message dan Message Validity Period (Seconds).

        Catatan

        Jika Anda mengatur parameter Qos ke 0, nilai maksimum parameter Message Validity Period (Seconds) adalah 86.400. Jika Anda mengatur parameter Qos ke 1, nilai maksimum parameter Message Validity Period (Seconds) adalah 604.800. Jika Anda tidak mengonfigurasi parameter Message Validity Period (Seconds), nilai maksimum digunakan. Nilai maksimum bervariasi berdasarkan nilai parameter Qos.

      5. Klik Message Reporting.

    • Message Subscription: Simulator perangkat berlangganan topik kustom untuk menerima pesan dari IoT Platform.

      1. Pilih Upstream DebugTopic Category.

      2. Pilih topik untuk langganan pesan.

      3. Jika Anda mengatur parameter Versi Protokol MQTT ke 5.0, Anda dapat mengonfigurasi parameter berikut:

        • Qos. Nilai valid: 0 dan 1.

        • No Local (Receive Device Messages). Nilai valid: true dan false. Nilai true menentukan bahwa perangkat tidak menerima pesan miliknya sendiri. Nilai false menentukan bahwa perangkat menerima pesan miliknya sendiri.

        • Retain Handling (Send Retained Messages to Device During Subscription). Nilai yang valid adalah sebagai berikut:

          • 0: Jika langganan dikonfigurasi antara server dan klien, server mengirim pesan tersimpan.

          • 1: Jika langganan baru dikonfigurasi antara server dan klien, server mengirim pesan tersimpan.

          • 2: Server tidak mengirim pesan tersimpan ke klien terlepas dari apakah langganan dikonfigurasi antara server dan klien.

      4. Klik Subscribe.

    Pengiriman Properti

    Simulator perangkat mengirimkan properti ke IoT Platform.

    1. Pilih Upstream Debug Properties.

    2. Pilih modul Thing Specification Language (TSL) dari daftar drop-down Debugging Device.

    3. Pilih atau masukkan nilai dalam bidang properti. Nilai tersebut harus sesuai dengan tipe data dan rentang nilai properti. Anda dapat mengatur properti tipe numerik ke nilai acak. random(a,b) menentukan nilai acak antara Integer a dan Integer b.

    4. Kirim data. Opsi:

      • Send Command: langsung kirim data.

      • Push Policy: konfigurasikan kebijakan pesan. Nilai valid:

        Penting

        Setelah simulator perangkat dinonaktifkan, kebijakan pesan menjadi tidak valid.

        • Pada Waktu Tertentu: Data hanya dikirim sekali pada waktu tertentu.

        • Pada Interval Tertentu: Data dikirim berulang kali pada interval tetap selama periode waktu tertentu. Interval diukur dalam detik.

    Pengiriman Event

    Fitur simulasi perangkat mengirimkan event ke IoT Platform.

    1. Pilih Upstream Debug > Events

    2. Pilih modul TSL dari daftar drop-down Debugging Features.

    3. Pilih fitur dan masukkan data event dalam format JSON, seperti {"Power": "on"}.

    4. Kirim data. Opsi:

      • Send Command: langsung kirim data.

      • Push Policy: konfigurasikan kebijakan pesan. Nilai valid:

        Penting

        Setelah simulator perangkat dinonaktifkan, kebijakan pesan menjadi tidak valid.

        • Pada Waktu Tertentu: Data hanya dikirim sekali pada waktu tertentu.

        • Pada Interval Tertentu: Data dikirim berulang kali pada interval tetap selama periode waktu tertentu. Interval diukur dalam detik.

    Debug Hilir

    Topik Kustom

    IoT Platform mengirim pesan ke perangkat menggunakan topik kustom.

    1. Pilih Downstream Debug > Topic Category

    2. Pilih topik kustom untuk mengirim pesan dan konfigurasikan parameter Payload Data.

    3. Atur parameter Qos ke 0 atau 1.

    4. Jika Anda mengatur Versi Protokol MQTT ke 5.0, Anda dapat mengonfigurasi parameter Retained Message dan Message Validity Period (Seconds).

      Catatan

      Jika Anda mengatur parameter Qos ke 0, nilai maksimum parameter Message Validity Period (Seconds) adalah 86.400. Jika Anda mengatur parameter Qos ke 1, nilai maksimum parameter Message Validity Period (Seconds) adalah 604.800. Jika Anda tidak mengonfigurasi parameter Message Validity Period (Seconds), nilai maksimum digunakan. Nilai maksimum bervariasi berdasarkan nilai parameter Qos.

    5. Klik Send Command.

    Permintaan dan Konfigurasi Properti

    IoT Platform mengirim perintah ke simulator perangkat untuk mengubah atau menanyakan nilai properti.

    1. Pilih Downstream Debug > Property debugging

    2. Masukkan nilai dalam bidang properti dan klik Debugging. Lalu, klik Set. Anda dapat mengatur properti tipe numerik ke nilai acak. random(a,b) menentukan nilai acak antara Integer a dan Integer b.

      Penting

      Pesan sukses hanya menunjukkan bahwa perangkat menerima perintah untuk mengubah nilai properti dari IoT Platform. Perangkat mungkin tidak menjalankan perintah. Setelah Link SDK yang digunakan untuk mengonfigurasi perangkat merespons permintaan konfigurasi properti, perangkat harus mengirimkan nilai properti terbaru untuk membuktikan bahwa nilai properti telah diubah.

    3. Di sisi kanan bidang properti, klik Debugging. Lalu, klik Get.

      Nilai properti terbaru ditampilkan di bidang tersebut. Jika nilai properti tidak ada di simulator perangkat, tidak ada data yang ditampilkan.

    Pemanggilan Layanan

    1. Pilih Downstream Debug > Invoke Service

    2. Pilih modul TSL dan layanan dari daftar drop-down Debugging Features.

Hasil

Setelah data didorong, Anda dapat melihat log perangkat di bagian Device log di sebelah kanan halaman.

Gambar berikut menunjukkan contohnya.

image.png

Klik View Cloud Logs. Di tab Cloud run log, Anda dapat melihat log IoT Platform terkait.

Untuk informasi lebih lanjut, lihat Log IoT Platform.

云端运行日志