IoT Platform：Gunakan fitur penerusan data untuk membangun komunikasi M2M

Buat produk dan perangkat

1. Di konsol IoT Platform, buka halaman detail instance yang ingin Anda kelola dan buat produk serta perangkat untuk aplikasi seluler. Untuk informasi lebih lanjut, lihat Buat Produk dan Buat Perangkat.

   Dalam contoh ini, sebuah product bernama MobileApp dibuat. Parameter Node Type disetel ke Directly Connected Device, dengan nilai default digunakan untuk parameter lainnya.

   Sebuah perangkat dengan nama DeviceName adalah ControlApp juga dibuat.

   Dalam contoh ini, ProductKey dari produk MobileApp adalah al987654321.

   Setelah membuat produk dan perangkat untuk aplikasi seluler, Anda dapat menghubungkan aplikasi tersebut ke IoT Platform sebagai perangkat.

   Ketika pengguna terdaftar masuk ke aplikasi seluler, server bisnis Anda mengirimkan informasi perangkat ke aplikasi tersebut. Dengan cara ini, aplikasi seluler dapat terhubung ke IoT Platform sebagai perangkat.

2. Tambahkan topik kustom tempat aplikasi seluler memiliki izin Publikasi. Aplikasi seluler dapat menggunakan topik tersebut untuk mengirim perintah ke lampu pintar.

   Dalam contoh ini, topik /al987654321/ControlApp/user/command ditambahkan. Untuk informasi lebih lanjut, lihat Gunakan Topik Kustom untuk Komunikasi.

3. Konfigurasikan aplikasi seluler.

   Dalam contoh ini, HTTPS digunakan sebagai protokol komunikasi antara aplikasi seluler dan IoT Platform.

   Format perintah yang dikirim oleh aplikasi seluler ke lampu pintar:

   {
       "TargetDevice": "light", 
       "Switch": 0, 
       "Timestamp": 1557750407000
   }

   Untuk informasi tentang cara mengonfigurasi Link SDK, lihat Link SDK.

4. Di konsol IoT Platform, buka halaman detail instance yang ingin Anda kelola. Buat produk dan perangkat untuk lampu pintar serta definisikan fitur untuk produk tersebut. Untuk informasi lebih lanjut, lihat Buat Produk, Buat Beberapa Perangkat Sekaligus, dan Tambahkan Fitur TSL.

   Dalam contoh ini, sebuah product bernama SmartLamp dibuat. Parameter Node Type disetel ke Directly Connected Device, dengan nilai default digunakan untuk parameter lainnya.

   Sebuah perangkat dengan nama DeviceName adalah light dibuat.

   Dalam contoh ini, ProductKey dari produk SmartLamp adalah al123456789.

   Anda dapat menambahkan fitur Thing Specification Language (TSL) sesuai kebutuhan bisnis Anda. Sebagai contoh, Anda dapat menambahkan properti TSL bernama Switch dan menyetel tipe datanya ke Boolean untuk mengelola sakelar lampu pintar. Nilai 0 menunjukkan mati dan nilai 1 menunjukkan menyala.

5. Tambahkan topik kustom tempat lampu pintar memiliki izin Berlangganan. Lampu pintar dapat menggunakan topik tersebut untuk menerima perintah yang dikirim oleh aplikasi seluler.

   Dalam contoh ini, topik /al123456789/light/user/set ditambahkan. Untuk informasi lebih lanjut, lihat Gunakan Topik Kustom untuk Komunikasi.

6. Gunakan Link SDK untuk menghubungkan lampu pintar ke IoT Platform. Dengan cara ini, lampu pintar dapat menerima dan menjalankan perintah yang dikirim oleh aplikasi seluler.

   Dalam contoh ini, MQTT digunakan sebagai protokol komunikasi antara lampu pintar dan IoT Platform. Untuk menerima perintah, lampu pintar harus berlangganan topik /al123456789/light/user/set. Setelah lampu pintar menerima perintah, kembangkan fungsi untuk menjalankan perintah tersebut.

   Untuk informasi tentang cara mengonfigurasi Link SDK, lihat Link SDK.

Konfigurasikan parser

Konfigurasikan parser untuk meneruskan perintah dari aplikasi seluler ke topik yang dilanggan oleh lampu pintar.

1. Masuk ke konsol IoT Platform.

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

3. Di panel navigasi sisi kiri, pilih Message Forwarding > Data Forwarding. Kemudian, lakukan langkah-langkah berikut untuk mengonfigurasi parser guna meneruskan pesan:

Buat sumber data

Untuk informasi lebih lanjut tentang parameter yang dijelaskan dalam langkah-langkah berikut, lihat Buat Sumber Data.

1. Di tab Data Source, lakukan langkah-langkah berikut untuk membuat sumber data:

   Penting

   Jika versi sebelumnya dari halaman Penerusan Data muncul, klik Go to New Version di pojok kanan atas halaman. Setelah versi baru halaman Penerusan Data muncul, klik Data Source.

   1. Di tab Sumber Data, klik Create Data Source.

   2. Di kotak dialog Create Data Source, masukkan nama untuk sumber data. Contoh: AppData.

   3. Klik OK.

2. Di halaman AppData, klik Add Topic.

3. Di kotak dialog Add Topic, pilih topik yang pesannya ingin Anda proses dan klik OK.

   Dalam contoh ini, topik /al987654321/ControlApp/user/command dari perangkat ControlApp dan nilai-nilai dari bidang TargetDevice, Timestamp, dan Switch perlu diperoleh dari pesan.

Buat tujuan data

Untuk informasi lebih lanjut tentang parameter yang dijelaskan dalam langkah-langkah berikut, lihat Buat Tujuan Data.

1. Pergi ke halaman Data Forwarding dan klik Data Destination.

2. Di tab Tujuan Data, klik Create Data Destination.

3. Di kotak dialog Buat Tujuan Data, masukkan nama untuk tujuan data. Contoh: OtherTopic. Lalu, setel parameter Produk ke SmartLamp.

4. Klik OK.

Konfigurasikan dan mulai parser.

Untuk informasi lebih lanjut tentang parameter yang dijelaskan dalam langkah-langkah berikut, lihat Konfigurasikan Parser.

1. Klik Parser. Di tab Parser, lakukan langkah-langkah berikut untuk membuat parser:

   1. Klik Create Parser.

   2. Di kotak dialog Buat Parser, masukkan nama untuk parser. Contoh: DataParser.

   3. Klik OK.

2. Di halaman DataParser, asosiasikan sumber data.

   1. Di langkah Data Source wizard, klik Associate Data Source.

   2. Di kotak dialog Asosiasikan Sumber Data, pilih AppData dari daftar drop-down Sumber Data.

   3. Klik OK.

3. Di halaman DataParser, klik Data Destination di wizard untuk mengasosiasikan tujuan data.

   1. Di pojok kanan atas bagian Data Destination, klik Associate Data Destination.

   2. Di kotak dialog Asosiasikan Tujuan Data, pilih OtherTopic dari daftar drop-down Tujuan Data.

   3. Klik OK.

   4. Di bagian Tujuan Data, lihat dan simpan data destination ID. Dalam contoh ini, ID-nya adalah 1000.

      Ketika Anda menulis skrip parser, data destination ID diperlukan.

4. Di halaman DataParser, klik Parser Script di wizard untuk mengonfigurasi skrip parser.

   1. Di bagian Edit Skrip langkah Skrip Parser, tentukan topik /al123456789/light/user/set tempat lampu pintar memiliki izin Berlangganan untuk menerima perintah dari aplikasi seluler.

      Untuk informasi lebih lanjut tentang cara mengonfigurasi skrip parser, lihat Sintaks Skrip. Untuk informasi lebih lanjut tentang fungsi penerusan data, lihat Fungsi.

      // Gunakan fungsi payload() untuk mendapatkan data yang dikirimkan oleh perangkat dan mengubah data menjadi format JSON.
      var data = payload("json");
      // Tentukan DeviceName. Dalam contoh ini, parameter TargetDevice disetel ke light.
      var dn = data.TargetDevice;
      // Tentukan topik yang digunakan oleh lampu pintar untuk menerima perintah dari aplikasi seluler.
      var topic_set = "/al123456789/"+dn+"/user/set";
      // Tentukan data yang ingin lampu pintar terima dari aplikasi seluler.
      writeIotTopic(1000, topic_set, data)

   2. Klik Save di bawah bagian Edit Skrip.

   3. Klik Debugging. Di panel Debugging, pilih produk dan perangkat, tentukan topik, lalu masukkan data payload untuk memeriksa apakah skrip berjalan sesuai harapan.

      Hasil berikut menunjukkan bahwa skrip telah dieksekusi.

      action: 
          transmit to republish[destinationId=1000], data:{"Switch":0,"Timestamp":1557750407000,"TargetDevice":"light"}
      variables: 
          data : {"Switch":0,"Timestamp":1557750407000,"TargetDevice":"light"}
          topic_set : /al123456789/light/user/set
          dn : light

   4. Klik Close.

   5. KlikPublish di bawah bagian Edit Skrip.

5. Pergi ke halaman Data Forwarding dan klik Parser. Di tab Parser, klik Mulai di kolom Actions dari parser DataParser.

6. Di pesan yang muncul, klik OK untuk memulai parser.

Transmisikan data antar perangkat

1. Pindai kode QR untuk mengikat aplikasi seluler ke lampu pintar.

   Setelah aplikasi seluler mengirim permintaan pengikatan, server mengikat aplikasi tersebut ke lampu pintar dan mengembalikan DeviceName dari lampu pintar. DeviceName yang dikembalikan ditentukan oleh parameter deviceName. Dalam contoh ini, DeviceName adalah light.

2. Kirim perintah dari aplikasi seluler.

   1. Aplikasi seluler mengirim perintah ke topik kustom. Dalam contoh ini, perintah dikirim ke topik /al987654321/ControlApp/user/command.

   2. Lalu, IoT Platform mengirim perintah ke topik yang digunakan oleh lampu pintar untuk menerima perintah berdasarkan parser penerusan pesan yang Anda konfigurasikan. Dalam contoh ini, topiknya adalah /al123456789/light/user/set.

   3. Lampu pintar menerima perintah dan melakukan operasi yang diminta.

   Catatan

   Aplikasi seluler juga dapat mengirim permintaan ke server Anda untuk melepas ikatan lampu pintar. Setelah lampu pintar dilepas ikatannya, Anda tidak dapat menggunakan aplikasi seluler untuk mengelola lampu pintar.