全部产品
Search

搜索本产品

    IoT Platform：Protokol Alink

    文档中心

    IoT Platform：Protokol Alink

    更新时间：Jul 06, 2025

    IoT Platform menyediakan Link SDK yang mencakup protokol komunikasi antara perangkat dan IoT Platform. Anda dapat menggunakan Link SDK untuk mengembangkan perangkat. Namun, dalam lingkungan embedded yang kompleks, Link SDK mungkin tidak memenuhi kebutuhan bisnis Anda. Dalam hal ini, Anda dapat membangun koneksi antara perangkat dan IoT Platform melalui protokol Alink.

    Ikhtisar

    Protokol Alink adalah standar pertukaran data untuk pengembangan IoT yang memungkinkan perangkat dan IoT Platform bertukar data secara efisien dalam format JSON.

    IoT Platform menyediakan Link SDK spesifik bahasa yang dapat digunakan untuk mengembangkan perangkat. Untuk informasi lebih lanjut tentang fitur setiap Link SDK, lihat Link SDK.

    Tabel berikut menjelaskan fitur protokol Alink untuk IoT Platform.

    Tabel 1. Fitur

    Fitur

    Format pesan

    Koneksi Perangkat

    Pengiriman Pesan

    Manajemen Perangkat

    Pemantauan dan O&M

    Berikut ini menjelaskan cara menghubungkan perangkat ke IoT Platform dan mentransfer data menggunakan protokol Alink.

    Menghubungkan perangkat ke IoT Platform

    Perangkat yang dapat dihubungkan ke IoT Platform dikategorikan menjadi perangkat terhubung langsung dan sub-perangkat. Untuk menghubungkan perangkat ke IoT Platform, Anda harus melakukan autentikasi perangkat, menghubungkan perangkat ke IoT Platform, dan kemudian mengirimkan data ke IoT Platform.

    Perangkat terhubung langsung dapat dihubungkan ke IoT Platform dengan menggunakan salah satu metode berikut:

    • Jika menggunakan sertifikat-unik-per-perangkat, bakar sertifikat perangkat pada perangkat, hubungkan perangkat ke IoT Platform, lalu kirimkan data ke IoT Platform. Sertifikat perangkat mencakup ProductKey, DeviceName, dan DeviceSecret.

    • Jika menggunakan sertifikat-unik-per-produk (pendaftaran dinamis), bakar sertifikat produk pada perangkat, hubungkan perangkat ke IoT Platform, lalu kirimkan data ke IoT Platform. Sertifikat produk mencakup ProductKey dan ProductSecret.

    Sub-perangkat harus dihubungkan ke IoT Platform melalui gateway dengan menggunakan salah satu metode berikut:

    • Jika menggunakan sertifikat-unik-per-perangkat, bakar sertifikat perangkat pada sub-perangkat. Sub-perangkat mengirimkan informasi sertifikat ke gateway. Gateway menambahkan hubungan topologi, lalu sub-perangkat dapat mengirimkan data ke IoT Platform melalui saluran komunikasi gateway.

    • Jika menggunakan pendaftaran dinamis, bakar ProductKey pada sub-perangkat. Sub-perangkat mengirimkan ProductKey dan DeviceName ke gateway. IoT Platform memverifikasi DeviceName, lalu mengirimkan DeviceSecret ke sub-perangkat. Sub-perangkat mengirimkan ProductKey, DeviceName, dan DeviceSecret yang diperoleh ke gateway. Gateway menambahkan hubungan topologi, lalu sub-perangkat dapat mengirimkan data ke IoT Platform melalui saluran komunikasi gateway.

    Submit device data

    Kirimkan properti perangkat atau acara

    • Data passthrough

      Pass-through data

      No.

      Deskripsi

      1

      Perangkat mengirimkan data passthrough ke IoT Platform dengan menggunakan topik yang digunakan untuk mengirim data passthrough. Untuk informasi lebih lanjut tentang topik, lihat Properti perangkat, acara, dan layanan.

      1.1

      IoT Platform menggunakan skrip parsing data untuk mengurai data yang dikirimkan dari perangkat. Fungsi rawDataToProtocol dalam skrip dipanggil untuk mengonversi data yang dikirimkan menjadi data JSON Alink.

      Untuk informasi lebih lanjut, lihat Apa itu parsing data?

      1.2

      IoT Platform memproses data JSON Alink.

      Jika mesin aturan dikonfigurasi, IoT Platform meneruskan data ke tujuan seperti topik atau layanan cloud berdasarkan aturan pengalihan yang ditentukan.

      Penting

      • Data yang diteruskan oleh mesin aturan diuraikan menggunakan skrip parsing data.

      • Saat mengonfigurasi aturan pengalihan data, Anda harus menentukan topik berikut untuk TSL data reporting sebagai sumber data: /${productKey}/${deviceName}/thing/event/property/post dan /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Untuk informasi lebih lanjut, lihat Konfigurasikan aturan pengalihan data atau Buat sumber data.

      1.3

      IoT Platform memanggil fungsi protocolToRawData dalam skrip parsing data untuk mengonversi data hasil menjadi format yang dapat diidentifikasi oleh perangkat.

      1.4

      IoT Platform mengirimkan data yang diuraikan ke perangkat.

      2

      Anda dapat menanyakan data properti yang dikirimkan dengan memanggil operasi QueryDevicePropertyData dan menanyakan data acara historis yang dikirimkan dengan memanggil operasi QueryDeviceEventData.

    • Data JSON Alink

      Alink data

      No.

      Deskripsi

      1

      Perangkat mengirimkan data JSON Alink ke IoT Platform dengan menggunakan topik yang digunakan untuk mengirim data passthrough. Untuk informasi lebih lanjut, lihat Properti perangkat, acara, dan layanan.

      1.1

      IoT Platform memproses data yang dikirimkan.

      Jika mesin aturan dikonfigurasi, IoT Platform meneruskan data ke tujuan seperti topik atau layanan cloud berdasarkan aturan pengalihan yang ditentukan.

      Penting

      Saat mengonfigurasi aturan pengalihan data, Anda harus menentukan topik berikut untuk TSL data reporting sebagai sumber data: /${productKey}/${deviceName}/thing/event/property/post dan /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Untuk informasi lebih lanjut, lihat Konfigurasikan aturan pengalihan data atau Buat sumber data.

      1.2

      IoT Platform mengembalikan respons ke perangkat.

      2

      Anda dapat menanyakan data properti yang dikirimkan dengan memanggil operasi QueryDevicePropertyData dan menanyakan data acara historis yang dikirimkan dengan memanggil operasi QueryDeviceEventData.

    Panggil layanan perangkat atau konfigurasikan properti perangkat

    • Panggil layanan perangkat secara asinkron atau konfigurasikan properti perangkat Transmit Alink data.

      No.

      Deskripsi

      1

      Panggil layanan di konsol IoT Platform.

      • Konfigurasikan properti: Anda dapat memanggil operasi SetDeviceProperty untuk mengkonfigurasi properti untuk perangkat.

      • Panggil layanan: Anda dapat memanggil operasi InvokeThingService untuk memanggil layanan secara asinkron.

        Jika Anda mengatur metode pemanggilan layanan ke asinkron saat mendefinisikan layanan, layanan tersebut dipanggil secara asinkron.

      1.1

      IoT Platform memverifikasi parameter.

      1.2

      IoT Platform mengirimkan pesan secara asinkron ke perangkat dan mengembalikan respons. Jika panggilan berhasil, ID pesan termasuk dalam respons.

      Untuk data passthrough, IoT Platform memanggil fungsi protocolToRawData dalam skrip parsing data untuk mengonversi data sebelum IoT Platform mengirimkan data ke perangkat.

      2

      Perangkat memproses data yang diterima.

      Catatan

      IoT Platform menggunakan topik yang berbeda untuk memproses data passthrough atau data kustom dan data JSON Alink. Untuk informasi lebih lanjut, lihat Ubah properti perangkat dan Panggil layanan perangkat dalam mode asinkron.

      3

      Setelah perangkat memproses data, perangkat mengembalikan respons ke IoT Platform.

      Setelah IoT Platform menerima respons, Anda dapat melakukan operasi berikut:

      • Jika data passthrough diterima, IoT Platform memanggil fungsi rawDataToProtocol dalam skrip parsing data untuk mengonversi data.

      • Jika mesin aturan dikonfigurasi, IoT Platform meneruskan data ke tujuan seperti topik atau layanan cloud berdasarkan aturan pengalihan yang ditentukan.

        Penting

        • Untuk data passthrough, data yang diteruskan oleh mesin aturan diuraikan menggunakan skrip parsing data.

        • Saat mengonfigurasi aturan pengalihan data, Anda dapat menentukan topik berikut untuk TSL data reporting sebagai sumber data: /${productKey}/${deviceName}/thing/downlink/reply/message, Untuk informasi lebih lanjut, lihat Konfigurasikan aturan pengalihan data atau Buat sumber data.

    • Panggil layanan perangkat secara sinkron

      Transmit Alink data

      No.

      Deskripsi

      1

      Panggil operasi InvokeThingService untuk memanggil layanan perangkat secara sinkron. Jika Anda mengatur metode pemanggilan layanan ke sinkron saat mendefinisikan layanan, layanan tersebut dipanggil secara sinkron.

      1.1

      IoT Platform memverifikasi parameter.

      1.2

      IoT Platform secara sinkron menggunakan topik RRPC untuk mengirimkan data ke perangkat.

      Untuk data passthrough, IoT Platform memanggil fungsi protocolToRawData dalam skrip parsing data untuk mengonversi data sebelum IoT Platform mengirimkan data ke perangkat.

      1.3

      IoT Platform secara sinkron menunggu respons dari perangkat.

      2

      Setelah perangkat memproses data, perangkat mengembalikan respons ke IoT Platform. Jika permintaan habis waktu, IoT Platform mengembalikan kesalahan timeout.

      2.1

      IoT Platform mengembalikan respons ke pemanggil.

      Jika data passthrough diterima, IoT Platform memanggil fungsi rawDataToProtocol dalam skrip parsing data untuk mengonversi data.

    Tambahkan hubungan topologi

    Transmit Alink data

    No.

    Deskripsi

    1

    Hubungkan sub-perangkat ke gateway.

    Jika pihak ketiga diperlukan untuk menambahkan hubungan topologi, lakukan langkah-langkah berikut:

    1.1

    Gateway dapat menggunakan topik /sys/${productKey}/${deviceName}/thing/list/found untuk mengirimkan informasi tentang sub-perangkat yang terdeteksi ke IoT Platform.

    Jika mesin aturan dikonfigurasi, IoT Platform meneruskan data yang dikirimkan ke tujuan seperti layanan cloud.

    1.2

    Anda dapat memperoleh data sub-perangkat dari layanan cloud.

    1.3

    Anda dapat menambahkan hubungan topologi antara sub-perangkat dan gateway.

    Jika Anda ingin menambahkan hubungan topologi, Anda dapat memanggil operasi NotifyAddThingTopo untuk memberi tahu gateway untuk menambahkan hubungan topologi dengan sub-perangkat menggunakan topik /sys/${productKey}/${deviceName}/thing/topo/add/notify.

    2

    • Gateway dapat menggunakan topik /sys/${productKey}/${deviceName}/thing/topo/add untuk menambahkan hubungan topologi dengan sub-perangkat. Kemudian, IoT Platform mengembalikan hasilnya.

    • Gateway menerima permintaan, dan kemudian menambahkan hubungan topologi menggunakan topik.

    3

    Anda dapat meminta gateway untuk menghapus hubungan topologi dengan sub-perangkat. Gateway menggunakan topik /sys/${productKey}/${deviceName}/thing/topo/delete untuk menghapus hubungan topologi dengan sub-perangkat.

    4

    Anda dapat memanggil operasi GetThingTopo untuk menanyakan topik /sys/${productKey}/${deviceName}/thing/topo/get untuk memperoleh hubungan topologi antara gateway dan sub-perangkat.