6.5
COMMANDES
Suivant le même modèle d'envoi de paramètres, les commandes doivent être publiées sur la Rubrique pour recevoir des commandes. Le type
de donnée est indiqué dans le JSON du message. La réponse de l'exécution des commandes se fait par la Rubrique de confirmation de
commande.
Les commandes disponibles pour le DigiRail OEE sont :
Output : utilisée pour obtenir ou modifier l'état des sorties numériques.
•
Reset counters : utilisée pour remettre à zéro les compteurs numériques.
•
Set counters : utilisée pour modifier la valeur des compteurs des canaux numériques.
•
Get diagnostic : utilisée pour obtenir des données de diagnostic de l'appareil.
•
6.5.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 :
{
"pid": 51387408,
"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.
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 1 – Codes d'erreur
DESCRIPTION
18/102