Perangkat yang terhubung Wi-Fi dapat melaporkan status jaringan dan data kesalahan ke cloud melalui topik tertentu. Topik ini menjelaskan topik pelaporan, format data, dan kode kesalahan jaringan.
Laporan status jaringan yang diinisiasi perangkat
Data dikirim dari perangkat ke cloud (komunikasi uplink).
Topik permintaan: /sys/${productKey}/${deviceName}/_thing/diag/post
Topik respons: /sys/${productKey}/${deviceName}/_thing/diag/post_reply
Format data permintaan Alink:
- Data saat ini: Data yang dilaporkan segera setelah dikumpulkan.
Perangkat melaporkan data status jaringan segera dalam kondisi berikut:
- Terjadi kesalahan jaringan. Perangkat mengumpulkan metrik terkait dan segera melaporkan datanya.
- Pengumpulan terjadwal telah dikonfigurasi. Perangkat mengumpulkan dan melaporkan data pada waktu yang ditentukan.
Sebagai contoh, jika perangkat mendeteksi masalah jaringan pada 2019-08-22 08:10:29, data tersebut dilaporkan segera. Format data untuk 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" } }Catatan Untuk laporan terjadwal data jaringan normal, parameter err_stats kosong. - Data historis: Data yang tidak dilaporkan segera. Selama diagnostik rutin, perangkat dapat menunda pelaporan metrik jaringan normal dan melaporkan data historis secara batch.
Format data:
{ "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" } }Catatan Jika tidak ada kesalahan jaringan, parameter err_stats kosong.
| Parameter | Type | Deskripsi |
| id | String | ID pesan. Angka bertipe string. Nilainya harus unik untuk perangkat dan berkisar antara 0 hingga 4294967295. |
| version | String | Nomor versi protokol. Satu-satunya nilai yang valid adalah 1.0. |
| params | Object | Parameter permintaan. |
| wifi | Object | Parameter status jaringan Wi-Fi. Parameter ini berisi empat metrik status jaringan. |
| rssi | integer | Kekuatan sinyal yang diterima. |
| snr | integer | Rasio sinyal terhadap noise. |
| per | integer | Tingkat kehilangan paket. |
| err_stats | String | Data kesalahan. Hanya disertakan ketika perangkat mendeteksi kesalahan jaringan. Format: Deskripsi parameter:
Untuk detail mengenai kesalahan tersebut, lihat Tabel err_stats. |
| _time | Long | Timestamp. Catatan Timestamp dapat kosong. Jika kosong, waktu pengumpulan tidak ditampilkan pada halaman Device Network Status di Konsol. |
| model | String | Pola isi pesan. Berisi bidang-bidang berikut:
|
| Jenis Kesalahan | Makna | Penyebab |
| 0x00 | Parameter lingkungan nirkabel. |
|
| 0x10 | Perangkat gagal membuat koneksi dengan cloud. |
|
| 0x20 | Kesalahan jaringan antara perangkat dan cloud. |
|
| 0x30 | Kesalahan waktu proses perangkat. |
|
| 0x40 | Pemantauan dinamis memori perangkat. |
|
| 0x50 | Kesalahan BLE. | Kesalahan BLE |
Format data respons Alink:
{
"id": "123",
"version": "1.0",
"code": 200,
"data": {}
}
| Parameter | Tipe | Deskripsi |
| id | String | ID pesan. Angka bertipe string. Nilainya harus unik untuk perangkat dan berkisar antara 0 hingga 4294967295. |
| code | Integer | Kode hasil. Nilai 200 menunjukkan keberhasilan. |
| version | String | Nomor versi protokol. Satu-satunya nilai yang valid adalah 1.0. |
| data | Object | Nilainya kosong. |