| **Topics** | **Description** |
| BaseName/GroupName/VKQV/Datas | Topic dans lequel les changements des variables sont envoyés. Le format du topic sera le suivant:
{
"Type": int,
"Items": Array \[
{
"LB": string,
"V": object,
"U": string,
"T": string,
"S": string
},
{
....
}
\],
"TS" : string
}
Type: Type de message. Toujours 1 pour l'instant
LB : Label de la variable
V : valeur de la variable
U : unité de la variable
T: type de la variable
S: source de la variable
TS: Timestamp
Exemple:
{ "Type":1, "Items":\[{ "LB": "A34001/23/Température actuelle", "V": 12.4, "U":"°C", "T":"Double"},{"LB":"A34001/78/Conductivité", "V":2.44, "U":"mS", "T":"Double"}\], "TS": "2019-04-06T13:46:15.145"}
|
| BaseName/GroupName/VKQV/Apps | Topic dans lequel les clients se connectent à QuickView |
| BaseName/GroupName/VKQV/Apps/ClientID | Topic dans lequel le client ClientID publie ses commandes. |
| BaseName/GroupName/VKQV/Apps/ClientID/Status | Statut de la connexion avec le client ClientID. |
| BaseName/GroupName/VKQV/Apps/ClientID/Status/Connection | Topic dans lequel le client ClientID publie le statut de sa connexion.
Exemple:
{"TS":"2023-12-27T10:54:40.646125Z","T":"String","V":"Connected"}
Ce topic est également désigné comme Last Will Topic lors de la connexion du client.
|
| BaseName/GroupName/VKQV/Apps/ClientID/Status/Watchdog | Topic dans lequel ClientID va écrire de temps en temps pour indiquer que la connexion est valide.
Exemple:
{"Id":"Server\_92881d83-d3a0-4edf-8720-e8e700340346","Date":"2023-12-28T12:40:45.6958696+01:00"}
|
| BaseName/GroupName/VKQV/Apps/ClientID/Login | Topic dans lequel ClientID va s'authentifier.
Exemple:
{"Id":"Server\_92881d83-d3a0-4edf-8720-e8e700340346", "UserName":"MyUserName","Password":"MyPassword"}
Lorsque VKQV constate qu'un client s'authentifie, il remplace le contenu par les informations de connexion:
Exemple:
{"jwtoken":"MyToken"}
Si le login n'aboutit pas alors la réponse sera:
{"Error":"Login fail !"}
Si le login aboutit alors il contient un jwt de connexion qui devra être utilisé à chaque commande vers VKQV.
Le client lit la réponse, l'enregistre puis efface le contenu du topic.
|
| BaseName/GroupName/VKQV/Apps/ClientID/Commands | Topic dans lequel ClientID envoie des commandes à VKQV.
Exemple:
{"jwtoken":"MyToken", "Commands": \[{"Cmd":"WriteBit", "Addr":"20,4,2", "Value": true}\] }
Lorsque VKQV accepte la commande, il l'execute si le jwtoken est valide puis efface le contenu.
|
| BaseName/GroupName/VKQV/Status/Watchdog | Topic dans lequel VKQV va écrire à chaque rafraîchissement des variables. VKQV s'abonne à ce topic pour vérifier que le broker soit bien fonctionnel. Si celui-ci fonctionne correctement, il devrait renvoyer ce que VKQV a écrit. La liaison est déclarée comme dégradée si ce topic n'est pas envoyé par le broker après 5 fois le temps de rafraichissement. Dans ce cas, la liaison est interrompue et une nouvelle connexion est tentée.
Exemple du contenu envoyé par VKQV:
{"V":269,"T":"Int","TS":"2022-06-03T10:28:01.936"}
|
| BaseName/GroupName/VKQV/Status/Machine | Statut de la machine. Pour chaque position de la machine, un statut est envoyé dans un json array:
"V": {
"positions": \[
{
"pos": 1,
"jn": 3,
"js": 0,
"jp": 0,
"rdy": 1,
"ala": false
},
{
"pos": 2,
"rdy": 1,
"ala": false
},
{
"pos": 3,
"jn": 1,
"js": 0,
"jp": 0,
"ena": true,
"rdy": 1,
"ala": false
},
...
\],
"hoists": \[
{
"hoist": 1,
"rdy": true,
"blockingala": 0,
"ala": 0,
"height": 0,
"destheight": 0,
"position": 0,
"destpos": 0,
"origin": 0,
"destination": 0,
"mode": 0,
"moveHforward": false,
"moveHbackward": false,
"moveVup": false,
"moveVdown": false
},
{
"hoist": 2,
"rdy": true,
"blockingala": 0,
"ala": 0,
"height": 0,
"destheight": 0,
"position": 0,
"destpos": 0,
"origin": 0,
"destination": 0,
"mode": 0,
"moveHforward": false,
"moveHbackward": false,
"moveVup": false,
"moveVdown": false
}
\]
},
"T": "MachineStatus",
"TS": "2024-04-26T06:55:30.333"
}
Les positions sont composées des topics suivants:
pos : int -> numéro de position
jn : int -> numéro du rack dans la position
js : int -> Statut du rack dans la position
jp: int -> numéro de programme du rack
ena: boolean -> position en/hors service
rdy: boolean -> position prête (mode machine)
ala: boolean -> position en alarme
Les robots sont composés des topics suivants:
hoist:int -> numéro du robot
rdy:boolean -> indique si le robot est prêt
blockingala:int -> mot de statut des alarmes bloquantes
ala:int -> mot de statut des alarmes non bloquantes
height:int -> hauteur actuelle du robot
destheight:int -> hauteur de destination
position:int -> position actuelle
destpos:int -> position de destination
origin:int -> position d'origine lors d'un mouvement complet
destination:int -> position de destination lors d'un mouvement
mode:int -> mode de fonctionnement du robot
moveHforward:boolean -> le robot se déplace horizontalement en avant
moveHbackward:boolean -> le robot se déplace horizontalement en arrière
moveVup:boolean -> le robot se déplace verticalement vers le haut
moveVdown:boolean -> le robot se déplace verticalement vers le bas.
|
| BaseName/GroupName/VKQV/Status/Alarms | Statut des alarmes:
{
"V": {
"alarms": \[
{
"evt": 2,
"num": 50,
"time": "07:16:19",
"type": "Programme",
"group": "Général",
"mess": "Programme en mode STOP",
"tnum": 1,
"gnum": 150,
"mnum": 2
},
{
"evt": 2,
"num": 897,
"time": "07:16:19",
"type": "Communication",
"group": "M5Stack",
"mess": "Erreur de communication avec l'automate",
"tnum": 14,
"gnum": 148,
"mnum": 35
},
{
"evt": 3,
"num": 2,
"time": "07:16:20",
"type": "Système",
"group": "HMI",
"mess": "Watchdog communication avec automate",
"tnum": 2,
"gnum": 140,
"mnum": 37
}
\]
},
"T": "AlarmStatus",
"TS": "2024-04-26T07:16:46.639"
}
Les alarmes contiennent les topics suivants:
evt:int -> événement ALA/ACK/RTN
num:int -> numéro de l'alarme.
time:Time -> heure/minute/seconde de l'alarme
type:string -> type de l'alarme
mess:string -> message de l'alarme
group:string -> groupe de l'alarme
tnum:int -> numéro du type de l'alarme
gnum:int -> numéro du groupe de l'alarme
mnum:int -> numéro du message de l'alarme
val:num -> valeur associée à l'alarme.
|
| BaseName/GroupName/VKQV/Status/Messages | Même chose que ci-dessus pour les messages |
| BaseName/GroupName/VKQV/Status/DailyData | Données de production et d'efficacité:
{ "V": {
"DateOfData": "20240426",
"Date": "26.04.2024",
"BatchesIn": 0,
"BatchesOut": 0,
"IdleTime": 0,
"ErrorStopTime": 0,
"ErrorWarningTime": 28,
"ManuModeTime": 28,
"SafetyDoorTime": 0,
"PowerOnTime": 28,
"Utilization": 100,
"Reliability": 100,
"24hours": \[
{
"Hour": 9,
"BachesIn": 0,
"BachesOut": 0,
"Reliability": 0,
"Utilization": 0
},
{
"Hour": 10,
"BachesIn": 0,
"BachesOut": 0,
"Reliability": 0,
"Utilization": 0
},
{
...
},
"T": "DailyData",
"TS": "2024-04-26T07:23:31.594"
}
|
| BaseName/GroupName/VKQV/Status/Rectifiers | Statut des redresseurs:
{
"V": {
"rectifiers": \[
{
"rectifier": 1,
"position": 13,
"name": "",
"status": 128,
"step": 0,
"ahamn": 1,
"surface": 0,
"density": 0,
"current": 0,
"voltage": 0,
"Q": 0,
"QTheo": 0,
"QTheoAct": 0,
"QTotal": 1406.11250237337,
"setpoint": 0,
"reverse": 0,
"maxU": 15,
"maxI": 100,
"minU": 0,
"minI": 100,
"pcsetpoint": 100,
"alternation": 0,
"flag0": 0,
"flag1": 1,
"flag2": 0,
"surfaceflag": 7,
"currentform": 0
},
{
...
}
\]
},
"T": "RectifiersStatus",
"TS": "2024-04-26T06:55:30.353"
}
|
| BaseName/GroupName/VKQV/Status/PositionsStat | Statut d'utilisation des positions de la machine et des barres:
{
"V": {
"positions": \[
{
"pos": 1,
"time": 13,
"load": "",
"surftotal": 128,
"surfmetal": 0,
"entrainment": 1
},
{
...
}
\]
"jigs":\[
{
"jig": 1,
"loaded": 45,
"total": 234
},
{
...
}
\] },
"T": "RectifiersStatus",
"TS": "2024-04-26T06:55:30.353"
}
|
| BaseName/GroupName/VKQV/Status/Connection | Statut de la connexion VKQV. Lorsque VKQV démarre, il écrit le statut de la connexion soit: {"V":"Connected","T":"String","TS":"2022-06-02T09:20:00.642"}.
Avant de se déconnecter, il écrit: {"V":"Disconnected","T":"String","TS":"2022-06-02T10:24:35.123"}. Ce topic est également désigné comme Last Will Topic lors de la connexion.
|
| BaseName/GroupName/VKQV/Status/Databanks/{#} | Liste des databanks de l'application. Le contenu de chaque databank est contenu dans le topic ayant comme nom le numéro du databank.
Exemple:
{"DB":1,"Device":1,"Channel":1,"Regi":0,"Regf":13,"Registers":\[{"R":0,"T":"Int","V":0},{"R":1,"T":"Int","V":0},{"R":2,"T":"Int","V":0},{"R":3,"T":"Int","V":0},{"R":4,"T":"Int","V":0},{"R":5,"T":"Int","V":0},{"R":6,"T":"Int","V":0},{"R":7,"T":"Int","V":0},{"R":8,"T":"Int","V":0},{"R":9,"T":"Int","V":0},{"R":10,"T":"Int","V":0},{"R":11,"T":"Int","V":0},{"R":12,"T":"Int","V":0},{"R":13,"T":"Int","V":0}\],"TS":"2023-12-28T11:22:22.923"}
|
| BaseName/Messaging/ | Service d'envoi de message
|
| BaseName/Messaging/Status/Connection/ | Statut de la connexion de VKSMSMessaging. Lorsque ce programme démarre, il écrit le statut de la connexion soit: {"V":"Connected","T":"String","TS":"2022-06-02T09:20:00.642"}.
Avant de se déconnecter, il écrit: {"V":"Disconnected","T":"String","TS":"2022-06-02T10:24:35.123"}. Ce topic est également désigné comme Last Will Topic lors de la connexion.
|
| BaseName/Messaging/Status/Watchdog/ | Topic dans lequel VKSMSMessaging va écrire à chaque rafraîchissement des variables. VKSMSMessaging s'abonne à ce topic pour vérifier que le broker soit bien fonctionnel. Si celui-ci fonctionne correctement, il devrait renvoyer ce que VKSMSMessaging a écrit. La liaison est déclarée comme dégradée si ce topic n'est pas envoyé par le broker après 5 fois le temps de rafraichissement. Dans ce cas, la liaison est interrompue et une nouvelle connexion est tentée.
Exemple du contenu envoyé par VKSMSMessaging:
{"V":269,"T":"Int","TS":"2022-06-03T10:28:01.936"}
|
| BaseName/Messaging/SMS/{messages} | Topic contenant les messages à envoyer par SMS. Ce topic contiendra des sous-topic nommer par un GUID. Chaque sous-topic correspondra à un message à envoyer. L'application qui s'occupera de l'envoi des SMS devra s'abonner au topic .../SMS/#. Chaque fois que l'application recevra un topic, il l'analysera, enverra le SMS correspondant puis effacera le topic. Le contenu du topic sera composé d'un json.
Exemple:
{"Recipient":"+41219683128", "Sender":"VKVision", "Message" : "Température max. chaudière", "TS":"2023-12-28T11:22:22.923"}
Si le temps entre le TS et l'heure de réception du topic est plus grand qu'un temps pré-défini, le message est effacé sans être envoyé.
|
| BaseName/GroupName/VKQV/Datas/ | Changement des I/O de la machine:
{"Type":1,"Items":\[{"LB":"A44003/3/Température actuelle","V":38.1,"T":"Double","U":"°C"}\],"TS":"2024-04-26T07:32:31.852"}
Toutes les I/O qui ont changées d'état depuis la dernière analyse sont transmit dans cet array.
|
| BaseName/GroupName/VKQV/Datas/{#position} | Liste des I/O par position. Le nom des I/O est modifié pour ne pas interférer dans les noms de topics: les espaces, /, \\,# sont remplacés par \_
Par exemple, l'I/O "Compteur d'Amin" de la cuve 33:
Topic: 33
Topic: Compteur\_Amin
{"V":135.44,"TS":"2024-04-16T08:48:16.256","T":"Double","U":"Amin"}
|
| BaseName/GroupName/VKQV/Configuration/Machine | Définition de la machine:
{
"V": {
"positioncount": 65,
"hoistcount": 4,
"positions": \[
{
"pos": 1,
"name": "01 - Charge",
"flag": 2,
"addr": 1,
"group": 0,
"tank": 1,
"disable": false,
"width": 0,
"process": 1,
"dist": 200,
"branch": 0,
"num": 1,
"layout": 0
},
{
"pos": 2,
"name": "02 - Transfert 1",
"flag": 10,
"addr": 2,
"group": 0,
"tank": 2,
"disable": false,
"width": 0,
"process": 2,
"dist": 200,
"branch": 0,
"num": 2,
"layout": 0
},
{
..
}
\],
"hoists": \[
{
"hoist": 1,
"type": 13,
"driptray": true,
"halfup": true,
"pmin": 1,
"pmax": 26
},
{
"hoist": 2,
"type": 13,
"driptray": true,
"halfup": true,
"pmin": 12,
"pmax": 36
},
{
"hoist": 3,
"type": 13,
"driptray": true,
"halfup": true,
"pmin": 37,
"pmax": 56
},
{
"hoist": 4,
"type": 13,
"driptray": true,
"halfup": true,
"pmin": 45,
"pmax": 65
}
\]
},
"T": "MachineDefinition",
"TS": "2024-04-26T06:54:58.864"
}
|
| BaseName/GroupName/VKQV/Configuration/Graphics/{#NomduSynoptique} | Pages graphiques de l'application publiées sous forme de winjson
|