All Products
Search
Document Center

IoT Platform:Status jaringan perangkat

Last Updated:Jun 17, 2026

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.

Catatan Perangkat yang menjalankan AliOS Things 3.0 atau versi lebih baru secara otomatis mendeteksi dan melaporkan data status 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.
Tabel 1. Parameter Permintaan
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: "type,code,count;type,code,count", misalnya, "10,02,01;10,05,01".

Deskripsi parameter:

  • type: Jenis kesalahan.
  • code: Penyebab kesalahan.
  • count: Jumlah kesalahan.

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:
  • format: Format data. Hanya simple yang didukung, yang menunjukkan bahwa data berada dalam format sederhana.
  • quantity: Kuantitas data. Nilai yang valid:
    • single: Melaporkan satu entri data.
    • batch: Melaporkan beberapa entri data. Ini hanya digunakan untuk data historis.
  • time: Jenis waktu data. Nilai yang valid:
    • now: Melaporkan data saat ini.
    • history: Melaporkan data historis.
Tabel 2. err_stats
Jenis Kesalahan Makna Penyebab
0x00 Parameter lingkungan nirkabel.
  • Kekuatan sinyal (RSSI): 0x01
  • Rasio sinyal terhadap noise (SNR): 0x02
  • Tingkat kehilangan paket: 0x03
0x10 Perangkat gagal membuat koneksi dengan cloud.
  • Gagal terhubung ke router (Wi-Fi fail): 0x01
  • DHCP gagal. Gagal memperoleh alamat IP (DHCP fail): 0x02
  • DNS gagal. Gagal mengurai nama domain cloud (DNS fail): 0x03
  • Proses jabat tangan TCP gagal (TCP fail): 0x04
  • Proses jabat tangan TLS gagal (TLS fail): 0x05
0x20 Kesalahan jaringan antara perangkat dan cloud.
  • Cloud secara aktif memutus koneksi dari perangkat (CLOUD_REJECT): 0x01
  • Uplink atau downlink data perangkat gagal (RW_EXCEPTION): 0x02
  • Operasi PING antara perangkat dan cloud gagal (PING_EXCEPTION): 0x03
0x30 Kesalahan waktu proses perangkat.
  • Perangkat di-restart oleh timer watchdog (WD_RST): 0x01
  • Perangkat di-restart karena kesalahan panic (PANIC_ERR): 0x02
  • Perangkat di-restart setelah siklus daya (RE-POWER): 0x03
  • Perangkat di-restart karena kesalahan fatal (FATAL_ERR): 0x04
0x40 Pemantauan dinamis memori perangkat.
  • Ukuran total memori: 0x01
  • Ukuran total memori bebas: 0x02
0x50 Kesalahan BLE. Kesalahan BLE

Format data respons Alink:

{
  "id": "123",
  "version": "1.0",
  "code": 200,
  "data": {}
}
Tabel 3. Parameter Respons
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.