All Products
Search

This Product

    IoT Platform:Protokol Alink

    Document Center

    IoT Platform:Protokol Alink

    Last Updated:Jun 03, 2026

    Platform IoT menyediakan Link SDK untuk pengembangan perangkat yang mencakup Protokol Alink guna memfasilitasi komunikasi antara perangkat dan cloud. Jika Link SDK tidak sesuai dengan kebutuhan lingkungan embedded Anda, Anda dapat mengenkapsulasi data Protokol Alink untuk berkomunikasi langsung dengan Platform IoT.

    Ikhtisar

    Protokol Alink adalah spesifikasi pertukaran data berbasis JSON untuk komunikasi dua arah antara perangkat dan Platform IoT, yang menyederhanakan serta menstandarkan interaksi data bisnis.

    Link SDK yang tersedia beserta bahasa yang didukung tercantum dalam Link SDK sisi Perangkat.

    Tabel berikut mencantumkan topik Protokol Alink berdasarkan fitur Platform IoT.

    Tabel 1. Deskripsi Protokol Alink
    Fitur Deskripsi format data
    Koneksi perangkat
    Komunikasi pesan
    Manajemen perangkat
    Pemantauan dan O&M

    Bagian berikut menjelaskan alur koneksi perangkat serta aliran data upstream dan downstream.

    Pendaftaran perangkat

    Koneksi perangkat ke Platform IoT berbeda antara perangkat yang terhubung langsung dan Perangkat sub, namun keduanya mengikuti tiga langkah: pendaftaran, aktivasi dan koneksi, serta pelaporan data.

    Perangkat yang terhubung langsung dapat dihubungkan dengan dua cara:

    • Gunakan sertifikat khusus perangkat: Sertifikat perangkat (ProductKey, NamaPerangkat, dan RahasiaPerangkat) telah diprogram sebelumnya ke perangkat. Perangkat kemudian mendaftar, terhubung, dan melaporkan data.
    • Gunakan sertifikat khusus produk untuk registrasi dinamis: Sertifikat produk (ProductKey dan RahasiaProduk) telah diprogram sebelumnya ke perangkat. Perangkat kemudian mendaftar, terhubung, dan melaporkan data.

    Perangkat sub terhubung melalui gerbang menggunakan salah satu dari dua metode berikut:

    • Gunakan sertifikat khusus perangkat: Sertifikat perangkat (ProductKey, NamaPerangkat, dan RahasiaPerangkat) telah diprogram sebelumnya ke Perangkat sub. Perangkat sub melaporkan sertifikat tersebut ke gerbang. Gerbang menambahkan hubungan topologis dan menggunakan kembali salurannya untuk melaporkan data.
    • Gunakan registrasi dinamis: ProductKey telah diprogram sebelumnya ke Perangkat sub. Perangkat sub melaporkan ProductKey dan NamaPerangkat ke gerbang. Platform IoT memverifikasi NamaPerangkat dan menerbitkan RahasiaPerangkat. Perangkat sub kemudian melaporkan sertifikat tersebut ke gerbang, yang menambahkan hubungan topologis dan meneruskan data melalui salurannya.
    Device data reporting flow

    Laporkan properti atau event perangkat

    • Format data transmisi langsung (custom) Pass-through data flow
      No. Deskripsi
      1 Perangkat melaporkan data transmisi langsung ke topik tertentu. Untuk informasi lebih lanjut tentang topik, lihat Properti, event, dan layanan perangkat.
      1.1 Platform IoT menggunakan skrip penguraian data untuk mengurai data yang dilaporkan oleh perangkat. Platform memanggil metode rawDataToProtocol dalam skrip untuk mengonversi data yang dilaporkan menjadi format data standar Platform IoT (format JSON Alink).

      Topik Penguraian data menjelaskan cara menulis skrip penguraian.
      1.2 Platform IoT memproses logika bisnis menggunakan data JSON Alink yang telah dikonversi.

      Jika mesin aturan dikonfigurasi, data diteruskan ke tujuan, seperti topik lain atau layanan cloud, berdasarkan aturan penerusan data.

      Penting
      • Mesin aturan menerima data yang telah diurai oleh skrip.
      • Saat mengonfigurasi penerusan data, atur topik sumber ke topik TSL model data reporting, seperti /${productKey}/${deviceName}/thing/event/property/post atau /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Untuk informasi lebih lanjut, lihat Konfigurasi aturan penerusan data atau Tambahkan sumber data.
      1.3 Platform IoT memanggil metode protocolToRawData dalam skrip penguraian data untuk mengonversi data hasil menjadi format yang dapat diterima perangkat.
      1.4 Platform IoT mendorong data yang telah diurai ke perangkat.
      2 Anda dapat memanggil operasi API QueryDevicePropertyData untuk mengkueri data properti historis yang dilaporkan perangkat. Anda juga dapat memanggil operasi API QueryDeviceEventData untuk mengkueri data event historis yang dilaporkan perangkat.
    • Format data non-transmisi langsung (JSON Alink) Alink JSON data flow
      No. Deskripsi
      1 Perangkat melaporkan data ke topik tertentu untuk data non-transmisi langsung. Untuk informasi lebih lanjut tentang topik, lihat Properti, event, dan layanan perangkat.
      1.1 Platform IoT memproses logika bisnis.

      Jika mesin aturan dikonfigurasi, data diteruskan ke tujuan, seperti topik lain atau layanan cloud, berdasarkan aturan penerusan data.

      Penting Saat mengonfigurasi penerusan data, atur topik sumber ke topik TSL model data reporting, seperti /${productKey}/${deviceName}/thing/event/property/post atau /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Untuk informasi lebih lanjut, lihat Konfigurasi aturan penerusan data atau Tambahkan sumber data.
      1.2 Platform IoT mengembalikan hasil pemrosesan ke perangkat.
      2 Anda dapat memanggil operasi API QueryDevicePropertyData untuk mengkueri data properti historis yang dilaporkan perangkat. Anda juga dapat memanggil operasi API QueryDeviceEventData untuk mengkueri data event historis yang dilaporkan perangkat.

    Panggil layanan perangkat atau atur properti

    • Pemanggilan layanan asinkron atau pengaturan properti Alink data transmission
      No. Deskripsi
      1 Panggil layanan di Platform IoT.
      • Atur properti: Panggil operasi API SetDeviceProperty untuk mengatur properti tertentu pada perangkat.
      • Panggil layanan: Panggil operasi API InvokeThingService untuk memanggil layanan secara asinkron.

        Layanan dipanggil secara asinkron jika metode pemanggilannya diatur ke asinkron.
      1.1 Platform IoT memverifikasi parameter yang Anda kirimkan.
      1.2 Platform IoT mengirim data ke perangkat secara asinkron dan mengembalikan hasilnya. Jika berhasil, hasilnya berisi ID pesan.

      Untuk data transmisi langsung (transmisi langsung/custom), Platform IoT terlebih dahulu memanggil metode protocolToRawData dalam skrip penguraian data untuk mengonversi format data. Kemudian, data yang telah dikonversi dikirim ke perangkat.
      2 Setelah perangkat menerima data, perangkat memproses logika bisnis.
      Catatan Topik pemrosesan pesan berbeda antara data transmisi langsung (custom) dan data non-transmisi langsung (JSON Alink). Atur properti perangkat dan Pemanggilan layanan perangkat (panggilan asinkron).
      3 Setelah perangkat memproses logika bisnis, perangkat mengembalikan hasilnya ke Platform IoT.

      Setelah Platform IoT menerima hasilnya, platform melakukan operasi berikut:

      • Jika data dalam format transmisi langsung, Platform IoT memanggil metode rawDataToProtocol dalam skrip penguraian data untuk mengonversi format data hasil yang dikembalikan perangkat.
      • Jika mesin aturan dikonfigurasi, data diteruskan ke tujuan, seperti topik lain atau layanan cloud, berdasarkan aturan penerusan data.
        Penting
        • Untuk data transmisi langsung, mesin aturan menerima data yang telah diurai oleh skrip.
        • Saat mengonfigurasi penerusan data, atur topik sumber ke topik TSL model data reporting, seperti /${productKey}/${deviceName}/thing/downlink/reply/message. Untuk informasi lebih lanjut, lihat Konfigurasi aturan penerusan data atau Tambahkan sumber data.
    • Pemanggilan layanan sinkron Alink data transmission
      No. Deskripsi
      1 Panggil operasi API InvokeThingService untuk memanggil layanan sinkron. Layanan dipanggil secara sinkron jika metode pemanggilannya diatur ke sinkron.
      1.1 Platform IoT memverifikasi parameter yang Anda kirimkan.
      1.2 Platform IoT menggunakan panggilan sinkron untuk memanggil topik revert-RPC (RRPC) dan mengirim data ke perangkat.

      Untuk data transmisi langsung (transmisi langsung/custom), Platform IoT terlebih dahulu memanggil metode protocolToRawData dalam skrip penguraian data untuk mengonversi format data. Kemudian, data yang telah dikonversi dikirim ke perangkat.
      1.3 Platform IoT menunggu secara sinkron hingga perangkat mengembalikan hasilnya.
      2 Setelah perangkat memproses logika bisnis, perangkat mengembalikan hasilnya ke Platform IoT. Jika terjadi timeout, pesan error timeout dikembalikan.
      2.1 Setelah Platform IoT menerima hasil dari perangkat, platform mengembalikan hasil tersebut ke pemanggil.

      Jika data dalam format transmisi langsung, Platform IoT memanggil metode rawDataToProtocol dalam skrip penguraian data untuk mengonversi format data hasil yang dikembalikan perangkat.

    Hubungan topologis

    Alink data transmission
    No. Deskripsi
    1 Perangkat sub terhubung ke gerbang.

    Jika pihak ketiga harus menambahkan hubungan topologis, beri tahu gerbang sebagai berikut.
    1.1 Gerbang melaporkan informasi tentang Perangkat sub yang ditemukan ke topik daftar penemuan perangkat: /sys/${productKey}/${deviceName}/thing/list/found.

    Setelah Platform IoT menerima data tersebut, jika mesin aturan dikonfigurasi, data diteruskan ke tujuan, seperti layanan cloud, berdasarkan aturan penerusan data.
    1.2 Anda dapat memperoleh data Perangkat sub dari layanan cloud.
    1.3 Anda dapat memutuskan apakah akan menambahkan hubungan topologis antara gerbang dan Perangkat sub.

    Untuk menambahkannya, panggil operasi API NotifyAddThingTopo untuk memberi tahu gerbang melalui topik: /sys/${productKey}/${deviceName}/thing/topo/add/notify.
    2
    • Gerbang langsung menambahkan hubungan topologis melalui topik: /sys/${productKey}/${deviceName}/thing/topo/add. Platform IoT mengembalikan hasilnya.
    • Setelah menerima instruksi, gerbang menambahkan hubungan tersebut melalui topik yang sama.
    3 Untuk menghapus hubungan topologis, gerbang menggunakan topik: /sys/${productKey}/${deviceName}/thing/topo/delete.
    4 Panggil operasi API GetThingTopo untuk mengkueri hubungan topologis antara gerbang dan Perangkat sub melalui topik: /sys/${productKey}/${deviceName}/thing/topo/get.