Publicité
12.3.2 TRAITEMENT D'ERREURS LORS DE LA MODIFICATION DE LA CONFIGURATION
Les valeurs définies dans chacun des desired item de la request ne seront appliquées que si l'exécution peut se faire sans erreurs pour
toutes les paires clé/valeur envoyées dans ce desired item. Le traitement est réalisé de manière indépendante pour chaque desired
item. Il est donc possible qu'il y ait des messages de response différents pour chaque response item.
La valeur d'error est un entier et elle indique la première erreur trouvée lors de l'application de la configuration d'un élément.
Le tableau ci-dessous présente les codes d'erreur :
CODE
0
1
2
Le tableau ci-dessous présente les actions de l'appareil pour chaque condition d'erreur.
CONDITION D'ERREUR
Élément de configuration
Erreur lors de
l'application d'une
configuration
12.3.3 CONSULTER LES PARAMÈTRES DE CONFIGURATION
Les étapes pour consulter la configuration actuelle sont :
ÉTAPE
1
Envoi de la request indiquant l'élément de configuration à consulter sur la rubrique Config.
2
L'appareil, abonné à la rubrique Config, évalue la demande et lit les données de configuration.
3
L'appareil publie la response sur la rubrique Config Ack.
L'application, abonnée à la rubrique Config Ack, met à jour l'état actuel de l'appareil avec les données présentes dans le message de
4
response.
Les données utilisées dans l'envoi et la réponse de la configuration sont en format JSON et sont présentes dans le payload des messages
échangés entre l'application et l'appareil.
La structure des request de paramètres reçus par l'appareil est la suivante :
{
"timestamp":1585819219,
"desired": {
<empty desired item>
}
}
Le timestamp suit le modèle utilisé dans la modification de configuration. Selon le modèle ci-dessus, une request peut n'avoir qu'un élément
à consulter, appelé <empty desired item>.
Un empty desired item est composé d'un élément de configuration sans paires clé/valeur, comme le montre l'exemple ci-dessous :
{
"timestamp":1585819219,
"desired": {
"rtc" : {}
}
}
Dans l'exemple ci-dessus, la response correspondante aura la valeur de RTC actuelle.
La publication de request de configuration peut avoir plusieurs empty desired item, un pour chaque élément qu'on veut consulter. La
structure de données des reported item est la même utilisée dans les response de modification de paramètres. Si l'élément consulté existe,
la valeur d'error indiquera que l'opération a été réalisée avec succès.
NOVUS AUTOMATION
Succès.
La structure est correcte, mais l'appareil a reçu un paramètre hors de la plage.
La structure est correcte, mais l'appareil a reçu un paramètre inconnu.
Tableau 6 – Codes d'erreur
Le reported item ne contiendra que la valeur d'erreur dans
inconnu
error.
Le reported item
configuration et la valeur error indiquera la première erreur
survenue.
Tableau 7 – Actions de l'appareil
Tableau 8 – Étapes pour consulter la configuration
DESCRIPTION
ACTION
contiendra les valeurs actuelles de
ACTION
55/102
Publicité
