6.4.1 OUTPUT
Cette commande modifie l'état des sorties de l'appareil.
FORMAT DE LA COMMANDE OUTPUT POUR MODIFIER L'ÉTAT DES SORTIES :
{
"timestamp":1585819219,
"desired": {
"output": {
"out1":1,
"out2":1
}
}
}
Il est important de souligner que les états qui ne seront pas modifiés n'ont pas besoin d'être publiés.
FORMAT DE LA RÉPONSE À LA COMMANDE OUTPUT :
{
"device_id": "device0",
"timestamp":1585819219,
"reported": {
"output": {
"error": 0,
"out1":1,
"out2":1
}
}
}
Remarques :
Le timestamp est le même de la commande reçue (desired).
•
L'état décrit dans l'étape desired n'est appliqué que si l'exécution est réalisée sans erreurs.
•
La valeur présentée dans le champ error est un entier et elle signale la première erreur trouvée lors de l'exécution de la commande, comme
•
indiqué dans le tableau des codes d'erreur ci-dessous :
CODE
Erreur 0
Erreur 1
Erreur 2
Cependant, il existe des cas d'erreur sans réponse de l'appareil, comme indiqué ci-dessous :
o Mauvaise structure JSON.
o Structure correcte, mais il manque un élément (timestamp, desired, item).
En cas d'erreur, aucun paramètre ne sera accepté et l'appareil ne passera pas en mode configuration.
Si la commande a échoué, les états indiqués dans reported seront les états actuels.
•
Cette commande peut être aussi utilisée pour consulter l'état actuel des sorties de l'appareil lorsqu'elle est envoyée avec le format ci-dessous.
FORMAT DE LA COMMANDE OUTPUT POUR OBTENIR L'ÉTAT ACTUEL DES SORTIES :
{
"timestamp":1585819219,
"desired": {
"output": {}
}
}
LE FORMAT DE LA RÉPONSE POUR OBTENIR L'ÉTAT DES SORTIES EST LE MÊME FORMAT DE LA RÉPONSE À LA COMMANDE POUR
LES MODIFIER :
{
"device_id": "device0",
"timestamp":1585819219,
"reported": {
"output": {
"error": 0,
"out1":1,
"out2":1
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 07 – Codes d'erreur
DESCRIPTION