IoT Platform：Mengelola hubungan topologi

Menambahkan hubungan topologi untuk perangkat bawahan

Anda dapat menggunakan topik untuk mengirim permintaan menambahkan hubungan topologi antara gateway dan perangkat bawahan. Setelah hubungan topologi ditambahkan, informasi tentang perangkat bawahan akan dikembalikan.

Topik-topik berikut digunakan ketika perangkat bawahan mengirim permintaan ke IoT Platform dan IoT Platform mengirim respons:

• Topik Permintaan: /sys/${productKey}/${deviceName}/thing/topo/add
• Topik Respons: /sys/${productKey}/${deviceName}/thing/topo/add_reply

Contoh Permintaan dalam Format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554",
      "sign": "xxxxxx",
      "signmethod": "hmacSha1",
      "timestamp": "1524448722000",
      "clientId": "xxxxxx"
    }
  ],
  "method": "thing.topo.add"
}

Contoh Respons dalam Format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

Parameter Permintaan

sign= hmac_md5(deviceSecret, clientId123deviceNametestproductKey123timestamp1524448722000)

Parameter Respons

Pesan Kesalahan

Menghapus hubungan topologi perangkat bawahan

Anda dapat menggunakan topik untuk mengirim permintaan menghapus hubungan topologi antara gateway dan perangkat bawahan. Setelah hubungan topologi dihapus, informasi tentang perangkat bawahan akan dikembalikan.

Topik-topik berikut digunakan ketika perangkat bawahan mengirim permintaan ke IoT Platform dan IoT Platform mengirim respons:

• Topik Permintaan: /sys/${productKey}/${deviceName}/thing/topo/delete
• Topik Respons: /sys/${productKey}/${deviceName}/thing/topo/delete_reply.

Contoh Permintaan dalam Format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.topo.delete"
}

Contoh Respons dalam Format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

Parameter Permintaan

Parameter Respons

Pesan Kesalahan

Memeriksa hubungan topologi perangkat bawahan

Topik-topik berikut digunakan ketika perangkat bawahan mengirim permintaan ke IoT Platform dan IoT Platform mengirim respons:

• Topik Permintaan: /sys/${productKey}/${deviceName}/thing/topo/get
• Topik Respons: /sys/${productKey}/${deviceName}/thing/topo/get_reply

Anda dapat menggunakan topik untuk mengirim permintaan memeriksa hubungan topologi antara gateway dan perangkat bawahan.

Contoh Permintaan dalam Format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": {},
  "method": "thing.topo.get"
}

Contoh Respons dalam Format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

Parameter Permintaan

Parameter Respons

Pesan Kesalahan

Mengirimkan perangkat bawahan yang baru ditemukan

Topik-topik berikut digunakan ketika perangkat bawahan mengirim permintaan ke IoT Platform dan IoT Platform mengirim respons:

• Topik Permintaan: /sys/${productKey}/${deviceName}/thing/list/found
• Topik Respons: /sys/${productKey}/${deviceName}/thing/list/found_reply

Dalam skenario tertentu, gateway dapat menemukan perangkat bawahan baru. Gateway melaporkan informasi tentang perangkat bawahan baru tersebut ke IoT Platform. IoT Platform kemudian meneruskan informasi ini ke aplikasi pihak ketiga, dan aplikasi pihak ketiga memilih perangkat bawahan untuk terhubung ke gateway.

Contoh Permintaan dalam Format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.list.found"
}

Contoh Respons dalam Format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data":{}
}

Parameter Permintaan

Parameter Respons

Pesan Kesalahan

Memberi tahu gateway untuk menambahkan hubungan topologi untuk perangkat bawahan

Topik berikut digunakan ketika IoT Platform mengirim permintaan ke perangkat bawahan dan perangkat bawahan mengirim respons:

• Topik Permintaan: /sys/${productKey}/${deviceName}/thing/topo/add/notify
• Topik Respons: /sys/${productKey}/${deviceName}/thing/topo/add/notify_reply

IoT Platform dapat menggunakan topik untuk memberi tahu gateway menambahkan hubungan topologi untuk perangkat bawahan. Ini berlaku setelah gateway menemukan perangkat bawahan baru dan melaporkan informasi perangkat bawahan ke IoT Platform. IoT Platform dapat berlangganan topik penerusan data berikut untuk menerima respons dari gateway: /${productKey}/${deviceName}/thing/downlink/reply/message.

Contoh Permintaan dalam Format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.topo.add.notify"
}

Contoh Respons dalam Format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

Parameter Permintaan

Parameter Respons

Memberi tahu gateway tentang perubahan hubungan topologi

IoT Platform memberi tahu gateway tentang perubahan hubungan topologi.

Gateway perlu berlangganan topik berikut: /sys/${productKey}/${deviceName}/thing/topo/change

Contoh Permintaan dalam Format JSON Alink:

{
    "id":"123",
    "version":"1.0",
    "params":{
        "status":0, // 0-tambah 1-hapus 2-aktifkan penonaktifan 8-nonaktifkan
        "subList":[{
            "productKey":"a1hRrzD****",
            "deviceName":"abcd"
        }]
    }, 
  "method":"thing.topo.change"  
}

Parameter Permintaan

Contoh Respons dalam Format JSON Alink:

{
    "id":"123",
    "code":200,
    "message":"success",
    "data":{}
}