Status jaringan perangkat - IoT Platform

Perangkat yang menggunakan Wi-Fi dapat melaporkan status jaringan ke IoT Platform melalui topik tertentu. Artikel ini menjelaskan topik dan format data yang digunakan oleh perangkat untuk melaporkan status jaringan serta kesalahan jaringan yang dapat dilaporkan.

null Jika perangkat Anda menggunakan AliOS Things V3.0 atau versi lebih baru, perangkat secara otomatis memantau dan melaporkan data status jaringan.

Laporan otomatis status jaringan ke IoT Platform

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

Topik permintaan: /sys/${productKey}/${deviceName}/_thing/diag/post

Topik respons: /sys/${productKey}/${deviceName}/_thing/diag/post_reply

Contoh permintaan dalam format Alink JSON:

Data Saat Ini: Data yang dilaporkan segera setelah dikumpulkan oleh perangkat.
Perangkat segera melaporkan data status jaringan dalam dua skenario berikut:
- Ketika kesalahan jaringan terdeteksi, perangkat segera melaporkan kesalahan tersebut ke IoT Platform.
- Jika pengumpulan terjadwal telah diatur, perangkat mengumpulkan data pada waktu yang ditentukan dan segera melaporkannya.
Sebagai contoh, perangkat mendeteksi kesalahan jaringan pada pukul 08:10:29 tanggal 22 Agustus 2019 dan segera melaporkan data tersebut. Contoh permintaan yang melaporkan data ketika perangkat mendeteksi kesalahan jaringan:
```
{
  "id": "123",
  "version": "1.0",
  "params": {
    "p": {
      "wifi": {
        "rssi": 75,
        "snr": 20,
        "per": 10,
        "err_stats":"10,02,01;10,05,01"
      },
      "_time": 1566432629000
    },
    "model": "quantity=single|format=simple|time=now"
  }
}
```
null Jika tidak ada kesalahan yang terdeteksi selama pengumpulan terjadwal, parameter err_stats kosong.
Data Historis: Data yang tidak dilaporkan segera. Dalam banyak kasus, perangkat mungkin menunda pelaporan metrik jaringan yang dikumpulkan. Ketika perangkat melaporkan data historis, beberapa catatan data dapat dilaporkan sekaligus.
Contoh permintaan:
```
{
  "id": "123",
  "version": "1.0",
  "params": {
    "p": [
      {
        "wifi": {
          "rssi": 75,
          "snr": 20,
          "per": 10,
          "err_stats":"10,02,01;10,05,01"
        },
        "_time": 1566432629000
      }
    ],
    "model": "format=simple|quantity=batch|time=history"
  }
}
```
null Jika tidak ada kesalahan yang terdeteksi, parameter err_stats kosong.

Tabel 1. Parameter Permintaan
Parameter	Tipe	Deskripsi
id	String	ID pesan. Nilai valid: 0 hingga 4294967295. Setiap ID pesan harus unik untuk perangkat.
version	String	Versi protokol. Nilai valid: `1.0`.
params	Object	Parameter permintaan.
wifi	Object	Metrik status jaringan. Empat metrik dilaporkan ketika perangkat menggunakan Wi-Fi.
rssi	integer	Kekuatan sinyal nirkabel yang diterima.
snr	integer	Rasio sinyal terhadap kebisingan dari sinyal nirkabel.
per	integer	Tingkat kehilangan paket.
err_stats	String	Pesan kesalahan jaringan. Parameter ini disertakan dalam data yang dilaporkan hanya ketika perangkat mendeteksi kesalahan jaringan. Format: `"type,code,count;type,code,count"`. Contoh: `"10,02,01;10,05,01"`. Bidang dalam pesan kesalahan jaringan: type: tipe kesalahan. code: kode kesalahan. count: jumlah kesalahan. Untuk informasi lebih lanjut tentang kesalahan spesifik, lihat err_stats.
_time	Long	Cap waktu yang menunjukkan kapan status jaringan dikumpulkan. null Cap waktu bisa kosong. Jika kosong, tab Device Network Status di konsol IoT Platform tidak menampilkan waktu pengumpulan data.
model	String	Model badan pesan. Nilai parameter mencakup bidang berikut: format: format data. Hanya format sederhana yang didukung. Ini menunjukkan bahwa data dalam format yang disederhanakan. quantity: jumlah catatan data yang dilaporkan. Nilai valid: single: menunjukkan bahwa satu catatan data dilaporkan. batch: menunjukkan bahwa beberapa catatan data dilaporkan. Opsi ini hanya digunakan untuk melaporkan data historis. time: menunjukkan apakah data saat ini atau historis dilaporkan. Nilai valid: now: menunjukkan bahwa data saat ini dilaporkan. history: menunjukkan bahwa data historis dilaporkan.

Tabel 2. err_stats
Tipe Kesalahan	Deskripsi	Penyebab
0x00	Parameter lingkungan jaringan nirkabel.	Indikator kekuatan sinyal yang diterima (RSSI): 0x01 Rasio sinyal terhadap kebisingan (SNR): 0x02 Tingkat kehilangan paket (drop ratio): 0x03
0x10	Perangkat gagal terhubung ke IoT Platform.	Perangkat gagal terhubung ke router (Wi-Fi fail): 0x01 Perangkat gagal mendapatkan alamat IP (DHCP fail): 0x02 Nama domain IoT Platform gagal diselesaikan (DNS fail): 0x03 Proses jabat tangan TCP gagal (TCP fail): 0x04 Proses jabat tangan TLS gagal (TLS fail): 0x05
0x20	Penyimpangan jaringan terjadi antara perangkat dan IoT Platform.	IoT Platform menutup koneksi dari perangkat (CLOUD_REJECT): 0x01 Kesalahan terjadi selama unggah atau unduhan perangkat (RW_EXCEPTION): 0x02 Kesalahan terjadi selama operasi ping antara perangkat dan IoT Platform (PING_EXCEPTION): 0x03
0x30	Penyimpangan terjadi pada perangkat.	Perangkat di-reboot karena timer watchdog di-reset (WD_RST): 0x01 Perangkat di-reboot karena penyimpangan penyimpanan (PANIC_ERR): 0x02 Perangkat di-reboot karena pemadaman listrik (RE-POWER): 0x03 Perangkat di-reboot karena kesalahan fatal (FATAL_ERR): 0x04
0x40	Informasi memori.	Total memori (tipe total size): 0x01 Total memori idle (tipe free size): 0x02
0x50	Penyimpangan Bluetooth Low Energy (BLE) terjadi.	Penyimpangan BLE.

Contoh respons dalam format Alink JSON:

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

Tabel 3. Parameter Respons
Parameter	Tipe	Deskripsi
id	String	ID pesan. Nilai valid: `0` hingga `4294967295`. Setiap ID pesan harus unik untuk perangkat.
code	Integer	Kode status dalam respons. Nilai 200 menunjukkan bahwa permintaan berhasil.
version	String	Versi protokol. Nilai valid: `1.0`.
data	Object	Nilainya kosong.