Tous les produits
Search
Centre de documentation

IoT Platform:État du réseau des appareils

Dernière mise à jour :Aug 09, 2026

Les appareils connectés en Wi-Fi peuvent signaler leur état réseau et leurs données d'erreur au cloud via une rubrique spécifique. Cette rubrique décrit la rubrique de signalement, le format des données et les codes d'erreur réseau.

Remarque

Les appareils exécutant AliOS Things 3.0 ou une version ultérieure détectent et signalent automatiquement les données d'état du réseau.

Signalements d'état du réseau initiés par l'appareil

Les données sont envoyées de l'appareil vers le cloud (communication montante).

Rubrique de requête : /sys/${productKey}/${deviceName}/_thing/diag/post

Rubrique de réponse : /sys/${productKey}/${deviceName}/_thing/diag/post_reply

Format des données de requête Alink :

  • Données actuelles : données signalées immédiatement après la collecte.

    L'appareil signale les données d'état du réseau immédiatement dans les cas suivants :

    • Une erreur réseau se produit. L'appareil collecte les métriques pertinentes et signale les données immédiatement.

    • La collecte planifiée est configurée. L'appareil collecte et signale les données à l'heure spécifiée.

    Par exemple, si un appareil détecte un problème réseau le 22/08/2019 à 08:10:29, il signale les données immédiatement. Format des données pour une erreur réseau :

    {
      "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"
      }
    }
    Remarque

    Pour les rapports planifiés de données réseau normales, le paramètre

    err_stats

    est vide.

  • Données historiques : données non signalées immédiatement. Lors des diagnostics de routine, l'appareil peut différer le signalement des métriques réseau normales et transmettre les données historiques par lots.

    Format des données :

    {
      "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"
      }
    }
    Remarque

    S'il n'y a pas d'erreurs réseau, le paramètre

    err_stats

    est vide.

Tableau 1. Paramètres de requête
Paramètre Type Description
id String ID du message. Nombre sous forme de chaîne. La valeur doit être unique pour l'appareil et comprise entre 0 et 4294967295.
version String Numéro de version du protocole. La seule valeur valide est 1.0.
params Object Paramètres de la requête.
wifi Object Paramètres d'état du réseau Wi-Fi. Ce paramètre contient quatre métriques d'état du réseau.
rssi integer Puissance du signal reçu.
snr integer Rapport signal sur bruit.
per integer Taux de perte de paquets.
err_stats String Données d'erreur. Inclus uniquement lorsque l'appareil détecte une erreur réseau.

Format : "type,code,count;type,code,count", par exemple, "10,02,01;10,05,01".

Descriptions des paramètres :

  • type : type d'erreur.
  • code : cause de l'erreur.
  • count : nombre d'erreurs.

Pour plus de détails sur les erreurs, consultez le Tableau err_stats.

_time Long Horodatage.
Remarque L'horodatage peut être vide. S'il est vide, l'heure de collecte n'est pas affichée sur la page Device Network Status de la console.
model String Modèle du corps du message. Contient les champs suivants :
  • format : format des données. Seule l'option simple est prise en charge, ce qui indique que les données sont dans un format simplifié.
  • quantity : quantité de données. Valeurs valides :
    • single : signale une seule entrée de données.
    • batch : signale plusieurs entrées de données. Utilisé uniquement pour les données historiques.
  • time : type d'heure des données. Valeurs valides :
    • now : signale les données actuelles.
    • history : signale les données historiques.
Tableau 2. err_stats
Type d'erreur Signification Cause
0x00 Paramètres de l'environnement sans fil.
  • Puissance du signal (RSSI) : 0x01
  • Rapport signal sur bruit (SNR) : 0x02
  • Taux de perte de paquets : 0x03
0x10 Échec de l'établissement d'une connexion avec le cloud par l'appareil.
  • Échec de la connexion au routeur (échec Wi-Fi) : 0x01
  • Échec DHCP. Impossible d'obtenir une adresse IP (échec DHCP) : 0x02
  • Échec DNS. Impossible de résoudre le nom de domaine du cloud (échec DNS) : 0x03
  • Échec de la négociation TCP (échec TCP) : 0x04
  • Échec de la négociation TLS (échec TLS) : 0x05
0x20 Erreur réseau entre l'appareil et le cloud.
  • Le cloud a activement déconnecté l'appareil (CLOUD_REJECT) : 0x01
  • Échec de la transmission montante ou descendante des données de l'appareil (RW_EXCEPTION) : 0x02
  • Échec de l'opération PING entre l'appareil et le cloud (PING_EXCEPTION) : 0x03
0x30 Erreur d'exécution de l'appareil.
  • Appareil redémarré par le minuteur de surveillance (WD_RST) : 0x01
  • Appareil redémarré en raison d'une erreur critique (PANIC_ERR) : 0x02
  • Appareil redémarré après un cycle d'alimentation (RE-POWER) : 0x03
  • Appareil redémarré en raison d'une erreur fatale (FATAL_ERR) : 0x04
0x40 Surveillance dynamique de la mémoire de l'appareil.
  • Taille totale de la mémoire : 0x01
  • Taille totale de la mémoire libre : 0x02
0x50 Erreur BLE. Erreur BLE

Format des données de réponse Alink :

{
  "id": "123",
  "version": "1.0",
  "code": 200,
  "data": {}
}
Tableau 3. Paramètres de réponse
Paramètre Type Description
id String ID du message. Nombre sous forme de chaîne. La valeur doit être unique pour l'appareil et comprise entre 0 et 4294967295.
code Integer Code de résultat. Une valeur de 200 indique un succès.
version String Numéro de version du protocole. La seule valeur valide est 1.0.
data Object La valeur est vide.