IoT Platform:Komunikasi M2M menggunakan Penerusan Pesan

Buat produk dan perangkat

1. Di Konsol IoT Platform, buat produk dan perangkat untuk aplikasi seluler di instans Anda. Untuk informasi lebih lanjut, lihat Buat produk dan Buat perangkat.

   Dalam contoh ini, atur parameter berikut untuk membuat produk: atur Product Name menjadi MobileApp, node type menjadi directly connected device. Gunakan nilai default untuk parameter lainnya.

   Atur DeviceName untuk perangkat menjadi ControlApp.

   Dalam contoh ini, ProductKey dari produk MobileApp adalah al987654321.

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

   Saat pengguna aplikasi seluler mendaftar dan masuk, server Anda mengirimkan informasi perangkat ke aplikasi seluler, sehingga aplikasi tersebut dapat terhubung ke IoT Platform sebagai perangkat.

2. Tambahkan topik kustom dengan izin publish untuk mengirim perintah kontrol.

   Dalam contoh ini, tambahkan topik berikut: /al987654321/ControlApp/user/command. Untuk informasi lebih lanjut, lihat Gunakan topik kustom untuk komunikasi.

3. Kembangkan aplikasi seluler.

   Dalam contoh ini, aplikasi seluler menggunakan HTTPS untuk berkomunikasi dengan IoT Platform.

   Kode berikut menunjukkan format data muatan untuk perintah kontrol yang dikirim aplikasi seluler ke lampu pintar melalui topik kustom:

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

   Untuk detail pengembangan SDK sisi perangkat, lihat Hubungkan perangkat menggunakan Link SDK.

4. Di Konsol IoT Platform, di instans Anda, buat produk dan perangkat untuk lampu pintar serta definisikan fiturnya. Untuk informasi lebih lanjut, lihat Buat produk, Buat beberapa perangkat sekaligus, dan Tambahkan fitur Thing Specification Language (TSL).

   Dalam contoh ini, atur parameter berikut untuk membuat produk: atur Product Name menjadi SmartLamp, node type menjadi directly connected device. Gunakan nilai default untuk parameter lainnya.

   Untuk perangkat yang Anda buat, atur DeviceName menjadi light.

   Dalam contoh ini, ProductKey dari produk SmartLamp adalah al123456789.

   Anda dapat menambahkan fitur Thing Specification Language (TSL) sesuai kebutuhan bisnis Anda. Misalnya, tambahkan properti TSL bernama Switch. Atur tipe data menjadi Boolean (0 untuk mati dan 1 untuk hidup) untuk mengontrol sakelar lampu pintar.

5. Tambahkan topik kustom dengan izin subscribe untuk menerima perintah kontrol dari aplikasi seluler.

   Dalam contoh ini, tambahkan topik berikut: /al123456789/light/user/set. Untuk informasi lebih lanjut, lihat Gunakan topik kustom untuk komunikasi.

6. Kembangkan perangkat lampu pintar agar terhubung ke IoT Platform, dan implementasikan logika untuk menerima serta mengeksekusi perintah.

   Dalam contoh ini, perangkat menggunakan MQTT untuk berkomunikasi dengan IoT Platform. Perangkat lampu pintar harus berlangganan topik /al123456789/light/user/set untuk menerima perintah. Setelah perangkat menerima perintah, Anda harus mengembangkan logika untuk mengeksekusinya.

   Untuk detail pengembangan SDK sisi perangkat, lihat Hubungkan perangkat menggunakan Link SDK.

Konfigurasikan parser Penerusan Pesan

Konfigurasikan parser Penerusan Pesan untuk meneruskan perintah yang dipublikasikan oleh aplikasi seluler ke topik lampu pintar.

1. Masuk ke Konsol IoT Platform.

2. Pada halaman Overview, klik All environment. Di tab All environment, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

3. Di panel navigasi sebelah kiri, pilih Message Forwarding > Data Forwarding.

Tambahkan sumber data

Untuk informasi lebih lanjut tentang parameter pada langkah-langkah berikut, lihat Tambahkan sumber data yang akan diteruskan.

1. Klik tab Data Source dan lakukan langkah-langkah berikut untuk menambahkan sumber data.

   Penting

   Jika halaman versi sebelumnya ditampilkan, klik Go to New Version di pojok kanan atas. Di halaman baru, klik tab Data Source.

   1. Klik Create Data Source.

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

   3. Klik OK.

2. Di halaman AppData, klik Add Topic.

3. Di kotak dialog Add Topic, pilih topik yang akan diproses lalu klik OK.

   Dalam contoh ini, pilih topik /al987654321/ControlApp/user/command dari perangkat aplikasi seluler ControlApp. Hal ini memungkinkan Anda mengambil nilai bidang TargetDevice, Timestamp, dan Switch dari pesan.

Konfigurasikan tujuan data

Untuk informasi lebih lanjut tentang parameter pada langkah-langkah berikut, lihat Tambahkan tujuan data.

1. Kembali ke halaman Data Forwarding lalu klik tab Data Destination.

2. Klik Create Data Destination.

3. Di kotak dialog, masukkan nama untuk tujuan data, misalnya OtherTopic, dan pilih produk SmartLamp.

   Untuk Select Action, pilih republish to another topic.

4. Klik OK.

Konfigurasikan dan mulai parser

Untuk informasi lebih lanjut tentang parameter pada langkah-langkah berikut, lihat Konfigurasikan parser.

1. Klik tab Parser dan lakukan langkah-langkah berikut untuk menambahkan parser.

   1. Klik Create Parser.

   2. Di kotak dialog, masukkan nama untuk parser, misalnya DataParser.

   3. Klik OK.

2. Di halaman DataParser, asosiasikan sumber data.

   1. Pada langkah Data Source di wizard konfigurasi, klik Associate Data Source.

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

   3. Klik OK.

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

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

   2. Di kotak dialog yang muncul, pilih OtherTopic dari daftar drop-down Data Destination.

   3. Klik OK.

   4. Di daftar tujuan data, lihat dan simpan data destination ID. Dalam contoh ini, ID-nya adalah 1000.

      Anda harus menggunakan data destination ID ini dalam skrip parser.

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

   1. Di editor skrip, masukkan skrip parser. Atur topik tujuan menjadi /al123456789/light/user/set, yang digunakan perangkat lampu pintar untuk menerima perintah.

      Untuk informasi lebih lanjut tentang sintaksis skrip, lihat Sintaksis skrip. Untuk informasi lebih lanjut tentang fungsi penerusan data, lihat fungsi writeIotTopic().

      // Gunakan fungsi payload() untuk mendapatkan konten pesan yang dilaporkan oleh perangkat dan uraikan sebagai JSON.
      var data = payload("json");
      // Dapatkan nama perangkat. Dalam contoh ini, nilai TargetDevice adalah perangkat lampu pintar, yaitu light.
      var dn = data.TargetDevice;
      // Definisikan topik tujuan yang berlangganan oleh lampu pintar.
      var topic_set = "/al123456789/"+dn+"/user/set";
      // Panggil writeIotTopic() untuk meneruskan muatan asli ke topik tujuan (ID 1000).
      writeIotTopic(1000, topic_set, data)

   2. Di bawah editor skrip, klik Save.

   3. Klik Debugging. Di panel yang muncul di sebelah kanan, pilih produk dan perangkat, lalu masukkan topik dan muatan untuk menguji skrip.

      Untuk Product, pilih MobileApp. Untuk Device, pilih ControlApp. Untuk Topic, masukkan /productKey/ControlApp/user/command. Untuk Payload Data, masukkan {"TargetDevice": "light", "Switch": 0, "Timestamp": 1557750407000}.

      Pengujian yang berhasil menghasilkan output berikut.

      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. Di pojok kiri bawah panel, klik Close.

   5. Di bawah editor skrip, klik Publish.

5. Kembali ke tab Parser di halaman Data Forwarding. Di kolom Actions untuk parser DataParser, klik Start.

6. Klik OK untuk memulai parser.

Berkomunikasi antar perangkat

1. Pengguna aplikasi seluler memindai kode QR untuk mengikat aplikasi ke lampu pintar.

   Saat aplikasi mengirim permintaan pengikatan ke server Anda, server mengembalikan DeviceName dari lampu pintar yang berhasil diikat. Dalam contoh ini, nama perangkatnya adalah light.

2. Pengguna mengirim perintah kontrol dari aplikasi seluler.

   1. Aplikasi seluler mengirim perintah melalui topik kustom. Dalam contoh ini, topiknya adalah /al987654321/ControlApp/user/command.

   2. IoT Platform menggunakan parser Penerusan Pesan untuk meneruskan perintah ke topik lampu pintar. Dalam contoh ini, topiknya adalah /al123456789/light/user/set.

   3. Setelah lampu pintar menerima perintah, perangkat tersebut menjalankan aksi yang sesuai.

   Catatan

   Setelah dibatalkan pengikatannya, aplikasi tidak dapat lagi mengontrol lampu pintar.