VK QuickView

• L'audit trail
• La fonction "Pick/Put-to-Light"
• Les machines standards de galvanoplastie
• Licence et clef de protection
• Le serveur HttpWebSocket
• La mesure d'épaisseur
• L'utilisation de VKQVRemoteDB
• La connexion à un broker MQTT
• Le flux de données avec un serveur d'entreprise
• Echanges avec des équipements
• L'interface avec le contrôleur de transporteur CB99A
• L'interface avec le contrôleur de transporteur CB07FPL
• Interface avec le contrôleur de transporteur CB24FPL
• L'interface avec les redresseurs PLCRECTIFIER
• L'interface avec les redresseurs PULSPLCRECTIFIER
• Utilisation d'un liftout sur les machines de type FPL
• Interface avec le contrôleur de transporteur CB07FCL
• Interface avec les transferts
• Procédure de mise en service d'un CB07FPL
• Interface avec le contrôleur de transporteur CB25FPLA
• Cobian backup
• La fonction "RFID Follower"
• Les bases de données
• Les divers types de bases de données
• La structure de la base de données "Reporting"
• La structure de la base de données "Articles"
• La structure de la base de données "CUSTOMER"
• Les paramètres du système prioritaire
• Le mode de fonctionnement OSCILine
• Utilisation de plusieurs langues sur les pages graphiques
• Suivi des produits chimiques
• Les postes de charge
• Le poste de charge n° 52
• Poste de charge n°66
• Poste de charge n°67
• Poste de charge n°69
• Poste de charge n°71
• Poste de charge n°74
• Poste de charge n°77
• Poste de charge n°78
• Poste de charge n°79
• Poste de charge n°80
• Poste de charge n°82
• Trucs et astuces
• Affichage du MTO sur les rapports de suivi
• Demande d'un outillage au poste de charge
• Les redresseurs de polarisation et d'amorçage
• Sauvegarde des courbes de température
• Utilisation du service VKSMSMessaging
• Les statistiques avec la base de données de suivi
• Rapports de suivi
• Statistiques de production
• Historique des mouvements des robots
• Historique des alarmes et messages
• Statistique d'utilisation des pompes doseuses
• MTBF et MTTR
• Courbes des redresseurs
• Les positions d'inspection
• Lecture de codes à barres au travers de MQTT
• Les positions contrôlées par AlarmStop
• Les profils de courant

L'audit trail

Avantages

• traçabilité des actions opérateur

• Conforme aux exigences GMP pour l'industrie pharmaceutique (par ex. de la Food and Drug Administration)

• Réduction des co¹ts d'ingénierie et de validation

• Idéalement adapté aux exigences des constructeurs de machines qui doivent remplir de sévères critères de qualité (par ex. livraison de machines et d'éléments d'installation devant être validées)

Fonctions

L' Audit trail remplit les principales exigences de GMP (Good Manufacturing Practice) ainsi que celles de la FDA (Food and Drug Administration) selon 21 CFR Part 11.

L' Audit facilite la construction de machines pour les branches travaillant avec des applications nécessitant des validations, étant donné que des fonctions indispensables pour remplir ces exigences sont déjà disponibles comme standard. De cette manière, les différentes machines ou éléments d'installation peuvent déjà être qualifiés chez le fournisseur.

En même temps, les audit trails assurent la traçabilité du processus de fabrication, comme l'exige par ex. la directive européenne 178/2002 pour l'industrie agro-alimentaire dans une optique d'amélioration de la qualité des produits.

Enregistrement d'actions opérateur dans les audit trails En exploitation, tous les changements de variables intéressant GMP (Good Manufacturing Practice) et les actions opérateur sont enregistrés comme audit trails dans un fichier CSV. Il peut s'agir par exemple de la saisie de valeurs process, du démarrage de recettes ou d'un acquittement de messages ou encore de messages relatifs à la gestion des utilisateurs, tels que la connexion et la déconnexion d'un utilisateur. Cela permet alors de voir précisément qui a fait quoi - et ce pour un travail de configuration minimal. En plus, un procédé de Checksum vérifie que les données dans l'audit trail sont exemptes de manipulations.

Archivage et journalisation L' Audit Trail permet l'archivage et la journalisation dans le PC localement ou dans un répertoire réseau. Cela facilite ainsi la réalisation de solutions pour l'archivage à long terme et la restauration des données.

Configuration

Pour fonctionner, une configuration minimum est demandée. Dans le répertoire WQVFiles, le fichier "AuditTrail.ini" doit être présent. Dans ce fichier, la session [System] doit contenir le mot clef suivant:

[System]
AuditTrailPath=C:\VK-WinQV\AuditTrail

Afficher l'audit trail

Pour afficher l'audit trail il faut utiliser le programme AuditTrailViewer.exe. Ce programme a été installé lors de l'installation de QuickView sur votre système. Lancer le programme et la page principale de celui-ci s'affichera:

Lors du premier démarrage de l'application il faut définir le répertoire contenant l'Audit Trail. Celui-ci doit correspondre au répertoire défini dans la configuration. l'icône représentant un symbole OK indique que les fichiers de l'audit n'ont pas été altérés ou modifiés. Si l'un des fichiers a été modifié, le symbole OK est remplacé par le symbole X signifiant ce fait.

Fonctionnement

La génération des enregistrements

Répertoire de sauvegarde/Nom du PC/année/mois/jour/ClientAuditTrail.csv pour le client et

Répertoire de sauvegarde/Nom du PC/année/mois/jour/ServerAuditTrail.csv pour le serveur

Un compteur d'enregistrement est maintenu dans un fichier texte séparé :

Répertoire de sauvegarde/Nom du PC/ClientAuditTrailCounter.ini pour le client et

Répertoire de sauvegarde/Nom du PC/ServerAuditTrailCounter.ini pour le serveur.

Le nom du répertoire de sauvegarde est défini dans un mot clef du fichier de configuration de l'audit trail soit, AuditTrail.ini[System]AuditTrailPath=Nom du répertoire de sauvegarde.

Si ce mot clef n'est pas défini, la fonction " AuditTrail " est désactivée.

La visualisation des enregistrements

Le programme de visualisation permet à l'utilisateur de choisir une date ou une période et affiche tous les enregistrements de tous les PC (client et serveur). Les enregistrements dont le checksum n'est pas valide sont affichés en rouge. La discontinuité dans la numérotation des enregistrements est également indiquée en rouge.

Le format des fichiers

Chaque fichier commencera par la description des champs soit :

Calcul de la checksum

Le checksum correspond au CRC32 du string correspondant au record sans le champ checksum mais dernier séparateur inclus.

La procédure de calcul est la suivante :

const
  CRC32Table:  ARRAY[0..255] OF DWORD =
   ($00000000, $77073096, $EE0E612C, $990951BA,
    $076DC419, $706AF48F, $E963A535, $9E6495A3,
    $0EDB8832, $79DCB8A4, $E0D5E91E, $97D2D988,
    $09B64C2B, $7EB17CBD, $E7B82D07, $90BF1D91,
    $1DB71064, $6AB020F2, $F3B97148, $84BE41DE,
    $1ADAD47D, $6DDDE4EB, $F4D4B551, $83D385C7,
    $136C9856, $646BA8C0, $FD62F97A, $8A65C9EC,
    $14015C4F, $63066CD9, $FA0F3D63, $8D080DF5,
    $3B6E20C8, $4C69105E, $D56041E4, $A2677172,
    $3C03E4D1, $4B04D447, $D20D85FD, $A50AB56B,
    $35B5A8FA, $42B2986C, $DBBBC9D6, $ACBCF940,
    $32D86CE3, $45DF5C75, $DCD60DCF, $ABD13D59,
    $26D930AC, $51DE003A, $C8D75180, $BFD06116,
    $21B4F4B5, $56B3C423, $CFBA9599, $B8BDA50F,
    $2802B89E, $5F058808, $C60CD9B2, $B10BE924,
    $2F6F7C87, $58684C11, $C1611DAB, $B6662D3D, 
    $76DC4190, $01DB7106, $98D220BC, $EFD5102A,
    $71B18589, $06B6B51F, $9FBFE4A5, $E8B8D433,
    $7807C9A2, $0F00F934, $9609A88E, $E10E9818,
    $7F6A0DBB, $086D3D2D, $91646C97, $E6635C01,
    $6B6B51F4, $1C6C6162, $856530D8, $F262004E,
    $6C0695ED, $1B01A57B, $8208F4C1, $F50FC457,
    $65B0D9C6, $12B7E950, $8BBEB8EA, $FCB9887C,
    $62DD1DDF, $15DA2D49, $8CD37CF3, $FBD44C65,
    $4DB26158, $3AB551CE, $A3BC0074, $D4BB30E2,
    $4ADFA541, $3DD895D7, $A4D1C46D, $D3D6F4FB,
    $4369E96A, $346ED9FC, $AD678846, $DA60B8D0,
    $44042D73, $33031DE5, $AA0A4C5F, $DD0D7CC9,
    $5005713C, $270241AA, $BE0B1010, $C90C2086,
    $5768B525, $206F85B3, $B966D409, $CE61E49F,
    $5EDEF90E, $29D9C998, $B0D09822, $C7D7A8B4,
    $59B33D17, $2EB40D81, $B7BD5C3B, $C0BA6CAD, 
    $EDB88320, $9ABFB3B6, $03B6E20C, $74B1D29A,
    $EAD54739, $9DD277AF, $04DB2615, $73DC1683,
    $E3630B12, $94643B84, $0D6D6A3E, $7A6A5AA8,
    $E40ECF0B, $9309FF9D, $0A00AE27, $7D079EB1,
    $F00F9344, $8708A3D2, $1E01F268, $6906C2FE,
    $F762575D, $806567CB, $196C3671, $6E6B06E7,
    $FED41B76, $89D32BE0, $10DA7A5A, $67DD4ACC,
    $F9B9DF6F, $8EBEEFF9, $17B7BE43, $60B08ED5,
    $D6D6A3E8, $A1D1937E, $38D8C2C4, $4FDFF252,
    $D1BB67F1, $A6BC5767, $3FB506DD, $48B2364B,
    $D80D2BDA, $AF0A1B4C, $36034AF6, $41047A60,
    $DF60EFC3, $A867DF55, $316E8EEF, $4669BE79,
    $CB61B38C, $BC66831A, $256FD2A0, $5268E236,
    $CC0C7795, $BB0B4703, $220216B9, $5505262F,
    $C5BA3BBE, $B2BD0B28, $2BB45A92, $5CB36A04,
    $C2D7FFA7, $B5D0CF31, $2CD99E8B, $5BDEAE1D, 
    $9B64C2B0, $EC63F226, $756AA39C, $026D930A,
    $9C0906A9, $EB0E363F, $72076785, $05005713,
    $95BF4A82, $E2B87A14, $7BB12BAE, $0CB61B38,
    $92D28E9B, $E5D5BE0D, $7CDCEFB7, $0BDBDF21,
    $86D3D2D4, $F1D4E242, $68DDB3F8, $1FDA836E,
    $81BE16CD, $F6B9265B, $6FB077E1, $18B74777,
    $88085AE6, $FF0F6A70, $66063BCA, $11010B5C,
    $8F659EFF, $F862AE69, $616BFFD3, $166CCF45,
    $A00AE278, $D70DD2EE, $4E048354, $3903B3C2,
    $A7672661, $D06016F7, $4969474D, $3E6E77DB,
    $AED16A4A, $D9D65ADC, $40DF0B66, $37D83BF0,
    $A9BCAE53, $DEBB9EC5, $47B2CF7F, $30B5FFE9,
    $BDBDF21C, $CABAC28A, $53B39330, $24B4A3A6,
    $BAD03605, $CDD70693, $54DE5729, $23D967BF,
    $B3667A2E, $C4614AB8, $5D681B02, $2A6F2B94,
    $B40BBE37, $C30C8EA1, $5A05DF1B, $2D02EF8D);

function _CRC32(AStream : TStream) : Cardinal;
var aMemStream : TMemoryStream;
    aValue     : Byte;
begin
 aMemStream := TMemoryStream.Create;
 try
  Result := $FFFFFFFF;
  while AStream.Position < AStream.Size do
  begin
   // Lecture d'un bloc de données
   aMemStream.Seek(0, soFromBeginning);
   if ((AStream.Size - AStream.Position) >= 1024*1024) then
   begin
    aMemStream.CopyFrom(AStream, 1024*1024);
   end else
   begin
    aMemStream.Clear;
    aMemStream.CopyFrom(AStream, AStream.Size-AStream.Position);
   end;
   //Calcul du CRC du bloc
   aMemStream.Seek(0, soFromBeginning);
   while aMemStream.Position < aMemStream.Size do
   begin
    aMemStream.ReadBuffer(aValue, 1);
    Result := (Result shr 8) xor CRC32Table[aValue xor (Result and $000000FF)];
   end;
  end;
  Result := not Result;
 finally
  aMemStream.Free;
 end;
end;

function CalculateCRC32(AString : String) : Cardinal;
var
 aStringStream : TStringStream;
begin
 aStringStream := TStringStream.Create(AString);
 Result := $FFFFFFFF;
 try
  result:=_CRC32(aStringStream);
 finally
  aStringStream.Free;
 end;
end;

Les types d'objet

Les objets suivants sont possibles:

La fonction "Pick/Put-to-Light"

Lorsque QuickView est utilisé sur une machine manuelle (sans robot), la fonction "Pick/Put-to-Light" est utilisée pour suivre/indiquer les manipulations faites/à faire pas l'opérateur. Jusqu'à la version 10.26, cette fonction était réalisée dans l'automate programmable. A partir de la version 10.27, il sera possible d'utiliser un nouveau driver de communication avec des boutons tactiles Banner. La communication avec ces boutons est effectuée à l'aide du protocole ModBus RTU sur une ligne série RS-485.

Configuration des robots virtuels

Pour pouvoir utiliser la fonction "Pick/Put-to-Light", un ou des robots virtuels doivent être définis. Ceci se fait dans le fichier VKServer.ini dans les sections [Hoist1]..[HoistX]. Ces sections sont utilisées pour définir les robots de la machine. Dans le cas d'une machine manuelle, le type de robot doit être défini comme Type=CBSim2. Ce type de robot demande l'utilisation d'un DB de données ainsi qu'un DB de commande.

Exemple de configuration:

[Hoist1]
Type=CBSim2
DbData=23
RegData=0
DbCommand=24
RegCommand=0

Le DB de données

Dans ce DB, le statut du robot est simulé par le système.

Le DB de données est défini avec les mots clef DBData=N° de DB et RegData=N° de registre. Un DB interne sera utilisé et celui-ci doit contenir 100 words.

Exemple de DB de données:

[DataBank23]
Device=0
Channel=0
Level=0
Regi=0
Regf=100
Pool=-1

Le DB de commandes

Ce DB sert à l'envoie des informations de destination et à la réception des données des boutons sur lesquels l'opérateur a pressé.

Le DB de commande est défini à l'aide des mots clef DBCommand=N° de DB et RegCommand=N° de registre. Un DB de l'automate programmable ou du nouveau device BannerPicktolight sera utilisé.

[DataBank24]
Device=1
Channel=250
Regi=0
Regf=29
Pool=500
RegType=Word

Le premier registre contient le n° de position sur laquelle le bouton a été pressé. Le deuxième registre contient le n° de position sur laquelle la montre connectée a simulé la pression sur le bouton. Le troisième registre correspond dans le Low-byte au n° de position sur laquelle la lampe doit être allumée et dans le High-byte la fonction à exécuter soit 1 pour une montée et 2 pour une descente. Dans le cas où la position ne serait pas équipée d'un bouton lumineux, l'automate (ou le driver) doit simuler la pression sur le bouton jusqu'à ce que le n° de la position de destination soit mis à zéro.

Le device BannerPickToLight

Le nouveau device se défini en utilisant un port série du PC. Un convertisseur COM vers RS-485 devra être utilisé pour permettre la connexion sur les boutons Banner.

[Device1]
Protocol=BannerPickToLight
ComPort=3
BaudRate=19200
Parity=Even
DataBits=8
StopBits=1
Timeout=1000
ConfigString=1:1,3:3,4:5..10

Le mot clef ConfigString permet de définir les boutons qui sont connectés sur le Bus. Il se compose d'une série de paires de chiffres X:Y séparées par une virgule. X correspondant au numéro de position et Y correspondant à l'adresse du bouton. Pour définir un suite de boutons consécutifs, il suffit de définir l'adresse par 2 chiffres séparés par deux points. Dans l'exemple ci-dessus, les boutons pour les positions 1,3,4,5,6,7,8 et 9 utilisent les adresses 1,3,5,6,7,8,9 et 10.

Ce device possède 30 registres permettant de définir 3 opérateurs (couleurs) différents.

Diagramme de fonctionnement

Le device PickToLightGateway

Ce device utilise le réseau du PC pour envoyer et recevoir les données des boutons. Un module VK Pick-to-Light Gateway devra être utilisé pour permettre les échanges entre le PC et les boutons Banner.

[Device1]
Protocol=PickToLightGateway
Address=192.168.11.3
Port=80
Timeout=1000
ConfigString=1:1,3:3,4:5..10
IOAlarm=28

Le mot clef ConfigString permet de définir les boutons qui sont connectés sur le Bus. Il se compose d'une série de paires de chiffres X:Y séparées par une virgule. X correspondant au numéro de position et Y correspondant à l'adresse du bouton. Pour définir un suite de boutons consécutifs, il suffit de définir l'adresse par 2 chiffres séparés par deux points. Dans l'exemple ci-dessus, les boutons pour les positions 1,3,4,5,6,7,8 et 9 utilisent les adresses 1,3,5,6,7,8,9 et 10.

Le mot clef IOAlarm=N° d'I/O permet d'activer une alarme lorsqu'une charge doit être déplacer. L'alarme est annulée lorsque l'opérateur presse sur le bouton de la charge à déplacer. Dans l'exemple ci-dessus, l'I/O N° 28 sera activée lors d'une alarme. Cette I/O est du type Word. Chaque bit correspond à un numéro d'opérateur.

Ce device possède 40 registres permettant de définir 6 opérateurs (couleurs) différents.

Registres Modbus des boutons Pick-IQ

Les registres suivants dont utilisés:

Travail avec des lecteurs RFID

En parallèle avec les boutons, il est possible de vérifier que le bon bouclard est déposé dans une position à l'aide de lecteurs RFID. Il faut pour cela ajouter des antennes RFID sur les positions devant être contrôlées. Lorsque le bouclard est déposé dans une position équipée d'une antenne, le système vérifie que le RFID du bouclard correspond au RFID lu par l'antenne. Si le RFID correspond alors la charge est transférée dans la position. S'il ne correspond pas alors une alarme est générée. Sur les postes de charge, la vérification est également effectuée lors de la prise de la charge. Si les RFID ne correspondent pas alors une alarme est générée. Les alarmes possibles sont:

Pour définir les lecteurs RFID dans le système, il faut définir la section suivante:

[RFID]
CheckDB=25
ConfigReaders=1..3,47

Les mots clef ci-dessus permettent de définir les antennes. CheckDB permet de définir le Databank contenant les RFID lu sur les positions. Par exemple DB25. Ce Databank est composé du nombre de registres string correspondant aux positions machine. Le registre 1 correspond à la position 1, le 2 à la position 2, etc... ConfigReaders permet de définir sur quelles positions une antenne est installée. Dans l'exemple ci-dessus, des antennes sont installées sur les positions 1,2,3 et 47. Le registre 48 du Databank de commandes doit être =1 pour que la vérification par RFID soit fonctionnelle.

Les boutons tactiles Banner EZ-Light ou Pick-IQ

La société Banner propose le produit EZ-Light K50 Modbus Series Pick-to-Light Sensors ou Pick-IQ K50 Ces boutons doivent être connectés entre eux par un bus RS-485. Il existe des convertisseurs USB-RS-485 pour pouvoir les connecter sur un PC. La fiche technique peut être téléchargée ici.

Installation typique

A) CÔble "Single-Ended" (RK 4.5T-2/S2501)

B) Tee (Truck RSC 2RKC 57)

C) CÔble "Double-Ended" (Truck RK 4.5T-1-RS 4.5T/S2501)

D) Résistance terminale (Banner EZL-RTM-M or F)

Convertisseur FTDI USB-485

Pour connecter les boutons sur un PC, nous utiliserons le convertisseur USB-RS485-WE-1800-BT.

VK Pick-to-Light Gateway

Cette passerelle fonctionne à l'aide de messages UDP. Ces messages UDP consistent en un enregistrement JSON. A chaque commande, une réponse est attendue. Les messages contiennent tous un numéro de fonction et un numéro d'évènement. La réponse doit contenir le numéro d'événement du message reçu

Liste des commandes

Fonction 1: définition de la liste des boutons

Cette fonction permet de définir la liste des boutons connectés sur la passerelle.

PC->Passerelle

Passerelle -> PC

Exemple:

PC->M5 : {"f":1,"e":12456,"btn":"1;2;3;4"}
M5->PC : {"f":9,"e":12456}

Fonction 2: interface avec un bouton

Cette fonction permet d'allumer, d'éteindre ou de faire clignoter un bouton

PC->Passerelle

Passerelle -> PC

Exemple:

PC->M5 : {"f":2,"e":12459,"btn":2,"clr":1,"blk":2} //Faire clignoter le bouton ID 2 en vert
M5->PC : {"f":9,"e":12459}

Fonction 3: Commandes pour tous les boutons

Cette fonction permet d'allumer, d'éteindre ou de faire clignoter tous les boutons

PC->Passerelle

Passerelle -> PC

Exemple:

PC->M5 : {"f":3,"e":12874,"clr":2,"blk":1} // tous les boutons en rouge fixe
M5->PC : {"f":9,"e":12874}

Fonction 4: définition de l'adresse "remote"

Cette fonction permet d'indiquer à la passerelle l'adresse et le port utilisés par le PC. 

PC->Passerelle

Passerelle -> PC

Exemple:

PC->M5 : {"f":4,"e":32874} 
M5->PC : {"f":9,"e":32874}

Fonction 5: information d'un redémarrage de la passerelle

Cette fonction indique au PC que la passerelle a redémarré.

Passerelle -> PC

Exemple:

M5->PC : {"f":5}

Fonction 6: information d'un bouton pressé

Cette fonction indique que le bouton a été pressé.

Passerelle -> PC

Exemple:

M5->PC : {"f":6,"btn":3} // le bouton 3 a été pressé

Fonction 7: information d'un bouton relÔché

Cette fonction indique que le bouton a été relÔché

Passerelle -> PC

Exemple:

M5->PC : {"f":7,"btn":3} // le bouton 3 a été relÔché

Fonction 8: erreur de communication avec un bouton

Cette fonction indique que le bouton ne répond pas

Passerelle -> PC

Exemple:

M5->PC : {"f":8,"btn":3} // le bouton 3 ne répond pas

Fonction 10: acquittement des erreurs

Cette fonction permet d'acquitter les erreurs de communication avec les boutons:

PC->Passerelle

Passerelle -> PC

Exemple:

PC->M5 : {"f":10,"e":2456}
M5->PC : {"f":9,"e":2456}

Les écrans de la passerelle

Ecran principal

Cet écran est affiché au démarrage de la passerelle. Les ID des boutons définis sont affichés sur cet écran. Si un bouton est allumé, son image est affichée dans la couleur sélectionnée.

Sur l'image précédente, le bouton avec l'ID 1 est affiché en rouge.

Lorsqu'une erreur de communication est détectée, une icône d'alarme est affichée à côté de l'image du bouton.

Sur cette image, le bouton avec l'ID 5 est en erreur. Pour acquitter le défaut, il faut presser sur le bouton central.

Le coin en haut à droite indique le mode de fonctionnement du Wifi. Les barres indiquent que le mode Wifi est activé et est connecté. Les lettres AP indique que le Wifi est en mode AccessPoint et est activé.

Tous les écrans précédents indiquent un mode de fonctionnement en mode Marche (fonctionnement normal). Il est possible de changer de mode de fonctionnement en mode DEMO ou en mode TEST. Ce changement se fait en accédant au menu principal en maintenant enfoncé le bouton de gauche. Le menu s'affiche:

Sélection du mode de fonctionnement

Sélectionner le menu "Mode de fonctionnement" à l'aide des boutons gauche et droit en les pressant brièvement. Une fois le menu surligné, presser sur le bouton central. Les modes possibles sont affichés:

Le mode "Arrêt":

Le mode "Arrêt" ne fait rien (pas d'action sur les boutons).

Le mode "Test":

Pour démarrer le mode "Test", pressez sur le bouton central. Le mode "Test" fait clignoter chaque bouton en jaune, il faut ensuite presser sur le bouton pour passer au bouton suivant. Une fois pressé, le bouton s'allume en vert fixe et le prochain bouton clignote en jaune et ainsi de suite jusqu'à tous les boutons on été pressés.

Le mode "DEMO":

Pour démarrer le mode "DEMO", pressez sur le bouton central. Le mode "DEMO" affiche chaque bouton, les uns après les autres, dans toutes les couleurs possibles. Une fois la boucle terminée, celle-ci recommence avec le premier bouton et ceci indéfiniment jusqu'à ce que l'utilisateur arrête le fonctionnement en pressant sur le bouton central encore une fois.

Les écrans de configuration

Configuration de l'adresse Ethernet locale en mode cÔblé:

L'adresse locale est l'adresse Ethernet de la passerelle en mode cÔblé (RJ-45)

Configuration de l'adresse Ethernet distante (PC) en mode cÔblé:

Configuration des boutons:

Le premier menu permet de définir le type de bouton utilisé. Pour l'instant 2 types sont possibles:

Le deuxième menu permet de définir les boutons utilisés:

Pour définir un ID utilisé (adresse du bouton), déplacer le curseur à l'aide des flèches et sélectionner avec le bouton central pour activer/désactiver un ID.

Configuration du WiFi:

Il est possible de désactiver le WiFi, de fonctionner en mode Access Point ou de se connecter à un réseau WiFi existant.

Fonctionnement direct sur Comport sans passer par la passerelle

Le device peut également fonctionner directement sur un comport sans passer par la gateway. Pour cela, il faut définir le device comme suit:

[Device1]
Protocol=PickToLightGateway
ComPort=3
BaudRate=19200
Parity=Even
DataBits=8
StopBits=1
Timeout=500
ConfigString=1:16,2:1..12,14:17,15:13..15,18:19..21,21:22..31,31:18

De cette manière, tout le travail de communication avec les boutons est réalisé par le programme serveur sans passer par une passerelle.

Les machines standards de galvanoplastie

Introduction

Les machines sont représentées de la manière suivante:

Cette machine est composée de 2 branches avec un transfert au milieu. Il peut y avoir un grand nombre de configurations différentes: machine d'une seule branche, de plusieurs branches, machine affichée de gauche à droite ou de droite à gauche. La première branche affichée sur le haut ou en bas, etc... Bref, chaque machine a sa propre configuration. Pour permettre un affichage automatique, il faut prévoir une manière de spécifier la mise en page.

La fenêtre d'affichage

La fenêtre d'affichage peut soit être encrée dans le coin gauche de l'écran, soit flottante ou soit occuper tout le haut de l'écran. Le choix d'affichage est configuré en utilisant des mots clef ou en utilisant la page [Machine] de la boîte de dialogue [Settings].

Dans les premières versions de QuickView la machine était toujours affichée sur une seule rangée de gauche à droite ou l'inverse mais toutes les branches étaient affichées d'un seul tenant. Dans une version récente, les mots clef affichés sur la droite de la boîte ont été ajoutés permettant d'afficher les branches sur des rangées différentes. Cette évolution permet une représentation plus réaliste de la machine mais des problèmes interviennent lorsque plusieurs transferts sont présents. Il n'est pas possible certaines fois d'aligner les cuves pour que tous les transferts soient alignés. Pour corriger ce problème, un nouvelle manière de configurer la machine a été réalisée. Cette manière est décrite dans la section suivante.

Langage de configuration

Un langage de configuration a été créé. Ce langage a été inspiré du langage LOGO (wikipedia). Il permet de décrire comment les positions seront dessinées. Si le string de configuration est vide, l'affichage se ferra de gauche à droite et commencera à la cellule 0:0. Pour afficher la machine comme représentée ci-dessus, le string de configuration sera: 0R1:0,37R0:1

Explication: le string de configuration est composé de groupes de données séparés par des virgules. Dans notre exemple, le premier groupe indique que la position dont l'index est 0 (première position de la machine) est dessinée dans la cellule ayant les coordonnées 1:0. Les positions suivantes sont dessinées à droite de celle-ci. le deuxième groupe indique que la position dont l'index est 37 est dessinée dans la cellule ayant les coordonnées 0:1. Les positions suivantes sont dessinées à droite de celle-ci. A chaque changement de branche ou de direction ou pour indiquer un espacement, un nouveau groupe doit être défini.

Autre exemple de string de configuration 0L27:2,28R0:0,54L25:1,55L18:1

Autre exemple de string de configuration 0L47:0,48R0:1,88R46:1

La grille de la machine

La fenêtre principale de la machine est considérée comme une grille. Chaque cellule de la grille peut correspondre à une position de la machine:

Le contenu d'une cellule de la grille

Chaque cellule (numérotée ci-dessus de 1 à 30) peut comprendre la représentation d'une position ou peut être vide. La représentation d'une position est faite de la manière suivante:

Licence et clef de protection

Pour fonctionner en production, le logiciel VKQuickView a besoin d'une clef de licence. Cette licence peut être soit une clef logicielle ou soit une clef matérielle de type USB Dongle.

La clef logicielle

La clef logicielle est installée lors de l'installation de VK QuickView. Il faut pour cela activer la case à cocher correspondante lors de l'installation:

La clef logicielle est archivée dans le registre de Windows et demande donc des droits d'administration correspondants par conséquence.

La clef logicielle correspond à 3 entrées du registre soit: Key0, Key1 et Key2.

La première entrée (Key0) correspond aux options autorisées du logiciel. Cette clef est cryptée par rapport à la configuration matérielle de votre PC. La deuxième clef (Key1) correspond au numéro de clef de licence. C'est ce numéro qui apparaît dans la boîte About du logiciel. La troisième clef n'est pas utilisée mais doit être présente.

La clef matérielle

La clef matérielle est une clef USB de type Sentinel. Le driver de cette clef est installé lors de la procédure d'installation (la case à cocher est activée par défaut). Le numéro de la clef ainsi que les options autorisées sont mémorisés dans la clef.

Le fichier de licence VK.lic

Pour ajouter une option ou pour étendre la période de mise à jour, il était nécessaire de modifier la Key0 de la clef logicielle ou de modifier le contenu du dongle mais à partir de la version 10.27.0.0 et 9.60.0.0, un fichier crypté de licence a été introduit. Ce fichier se nomme VK.lic et doit se trouver dans le répertoire dans lequel se trouve les exécutables VKClient10.exe et VKServer10.exe.

Organigramme de fonctionnement

Le serveur HttpWebSocket

Il est possible d'activer un serveur Http permettant de publier des pages statiques ainsi qu'un serveur WebSocket permettant de publier les changements des données du serveur. L'activation se fait au niveau du fichier <VKServer.ini> dans la section [Http]. Le mot clef Enabled=1 doit être défini. Il faut également que la licence permette cette option. Le serveur WebSocket transmet les modifications des données du serveur sous la forme de messages JSON. Il peut également recevoir des commandes sous le même format.

Le serveur http utilise http.sys, il faut donc configurer http.sys pour que le serveur puisse fonctionner. La configuration est réalisée avec l'utilitaire TMSHttpConfigTool.exe qui se trouve dans le répertoire Addon de QuickView. Lancer l'application en mode administrateur, l'écran suivant s'affiche:

Ajouter une nouvelle règle en pressant sur le bouton [Add]:

Le port est maintenant autorisé et le serveur peut être lancer.

Les mots clef

Dans la section [http], les mots clef suivants sont disponibles:

Exemple de définition:

[HTTP]
Enabled=1
httpPort=8484

Le protocole de communication

Un protocole de communication spécialement conçu pour QuickView est implémenté. Les messages JSON sont formés comme suit:

Exemple de message:

{ "function":"write", "register":10, "Data": { "programmode": true }} 

Les clients doivent se connecter sur le serveur à l'aide d'un websocket. Avant d'ouvrir le websocket, les clients devront s'identifier sur le serveur Web en effectuant un POST à l'adresse /auth avec comme paramètres "?username=xxx&pass=yyy". Les "userName" et "Password" correspondant aux identifiants de QuickView. Si l'identification est correct, le serveur renvoie un jwt ( JSon Web Token) enregistré dans un Cookie (jwtoken=.....). Lorsque le client ouvre le websocket, le serveur vérifie le contenu du token et accepte ou non son ouverture. Le token est valable 24 heures après quoi il est nécessaire de renouveler son identification si le websocket est fermé.

Il est aussi possible d'utiliser le mode d'authentification basic des websocket pour se connecter. En utilisant ce schéma, le serveur attend le token Authorization: Basic xxxx dans l'entête de la requête de connexion (voir https://developer.mozilla.org/fr/docs/Web/HTTP/Headers/Authorization ).

Les commandes possibles

Pour pouvoir lire, écrire, etc... le protocole demande l'utilisation de commandes. Les commandes possibles sont décrit dans le tableau suivant:

Les registres

Les registres suivants sont disponibles:

Utilisation en tant que API

Il est possible de faire des requêtes API sur le serveur. Pour obtenir les registres ci-dessus dans un GET HTTP, il faut effectuer les requêtes comme l'exemple suivant:

Get http://localhost:8484/API?REGISTER=10

La réponse est un objet JSON comme suit:

{ "function":"write", "register":10, "Data": { "modeprogram": true, "modebuffer": true,..... }}

Utilisation comme serveur Web

Il est possible de fonctionner en tant que serveur web. Les fichiers doivent se trouver dans le répertoire RootPath .

Dashboard

Il est possible de faire fonctionner le site web avec Freeboard.

Pour fonctionner, il faut décompresser le fichier www.zip et le placer dans le répertoire défini dans rootPath.

Pour le lancer, il faut soit taper l'adresse web du site pour avoir l'éditeur de freeboard ou soit http://localhost:8484/index.html#source=dashboard.json pour lancer directement un dashboard prédéfini.

Dans le fichier index.html, le bouton donnant l'accès aux modification du dashboard a été commenté. Pour permettre des modifications, il faut dé-commenter les lignes 48 à 96 et 110 à 111

La mesure d'épaisseur

Activating the measurement function

To activate the thickness measurement function, you must first open the "Settings" dialog box by clicking on the "Setting definition" menu:

The "Settings" dialog box will be displayed:

On the left panel, select "Machine" then check the "ShowMeasurementType" check box.

Defining a sequence with measurement

Once the "Measurement type" is activated, a new column is displayed in the sequence definition table:

In this new column, you can select which position need a measurement. There are 3 measurement possibilities:?

Running program with measurement

When a thickness measurement is requested, the jig requiring the measurement will be displayed in flashing fuchsia in the machine:

In order to open the measurement dialog box, you must right click on the load and select "Thickness measurement" in the popup menu:

By clicking on this command, the following dialog box will be displayed:

If the thickness is too low, you can enter an additional time in the corresponding field. You must also specify if, after this additional time, a new measurement is required or not. Once this 2 fields filled, the "continue" button becomes enabled. Click on "Continue" to add time or click on "Finished" to continue to the next sequence step. The "Cancel" button will only close the box.

L'utilisation de VKQVRemoteDB

Le programme VKQVRemoteDB est un programme fonctionnant en tant que service Windows. Ce programme maintient une connexion avec 2 bases de données MS SQL. Il est utilisé pour faire le lien entre le moteur de bases de données MS SQL et les applications VK QuickView en utilisant une liaison sécurisée https. Ce logiciel est utilisé lorsque la connexion directe sur la base de données ou l'utilisation de OBDC ne sont pas autorisées. Ce programme doit fonctionner sur un PC du réseau du client final (PC virtuel ou directement sur le PC sur lequel le moteur de bases de données est installé) .

Schéma de fonctionnement

La configuration du serveur

La configuration du programme est enregistrée dans un fichier "texte" qui se trouve dans le même répertoire que le programme et se nomme VKQVRemoteDB.ini. Pour modifier la configuration, il faut lancer le programme en mode GUI. Ceci se fait de la manière suivante:?

Le programme utilise http.sys pour son serveur Web. Il faut donc réserver les ports et les chemins d'accès à l'aide de l'utilitaire TMSHttpConfig.exe qui est installé dans le répertoire "Addon" lors de l'installation de VK QuickView. Lancer le programme et la fenêtre suivante s'affiche:

Sur cette fenêtre, il y a deux onglets "Url Acl" et "SSL". Dans la fenêtre "Url Acl" cliquer sur "Add". La fenêtre suivante s'affiche:

Introduire l'url que vous désirez réserver soit http://+:1888/vkqvpart/ pour la connexion à la bibliothèque d'articles et http://+:1888/vkqvreport/ pour le suivi de charge. Il faut sélectionner "Everyone" pour que tous les utilisateurs puissent accéder à cette adresse. Dans le cas de l'utilisation d'une liaison sécurisée, les adresses a réservées doivent commencer par https:// et il faut également attribuer un certificat au port. L'attribution du certificat se fait dans l'onglet "SSL".

Une fois ces réservations effectuées, le service VKQVRemoteDBService peut être lancé.

Sélectionner "Automatique" dans type de démarrage. Puis cliquer sur "Démarrer".

La configuration de QuickView

Les bases de données configurées dans RemoteDB sont utilisées par VKClient10.exe ( bibliothèque d'articles) et VKServer10.exe ( rapport de suivi).

La configuration du client

La configuration du client se fait dans le fichier VKWinQV.ini dans la section "PartLibrary". Les mots clef suivants doivent être définis:

La configuration du serveur

La configuration du serveur se fait dans le fichier VKServer.ini dans la section "RemoteDB". Les mots clef suivants doivent être définis:

Installation de plusieurs instances du programme

Lorsque plusieurs instance du programme sont installées sur un poste, il faut créer un répertoire par instance. Les répertoires doivent contenir le programme .exe ainsi que son fichier de configuration. Il est important de donner un nom de service différent pour chaque instance du programme.  Des chemins d'accès différents doivent également être configurés.

Le serveur OPC-DA

Pour permettre la liaison entre VKQVRemoteDB et un autre programme, VK Vision a développé un serveur OPC-DA. Pour l'instant, ce serveur n'est utilisé que pour visualiser les données de la table TOOLS de la base de données d'articles mais il pourrait être étendu pour accéder à d'autres tables.

Le programme VKQVStripApp4RemoteDB

Ce programme permet d'enregistrer le suivi de la démétallisation sur le serveur de rapports. Il permet également de mettre à zéro les compteurs de passages galvaniques et non galavaniques.

Le programme se présente comme suit:

La commande Options|Configuration permet d'accéder aux paramètres de l'application:

Les programme pouvants être sélectionnés sont définis dans cette page de configuration. 30 noms de programmes peuvent être définis.

Les connexions avec la base de données sont définies dans la page de configuration des connexions:

Pour commencer, l'utilisateur introduit un numéro de référence de l'outillage. Si l'outillage est trouvé dans la base de données, les informations sur l'outillage sont affichées:

Si la référence n'est pas trouvée dans la base de données, un message l'indique:

Une fois les informations de la référence affichées, l'utilisateur doit introduire les données obligatoires:

Le bouton de démarrage s'affiche en vert. L'utilisateur doit cliquer dessus pour démarrer la démétallisation.

Lorsque la démétallisation à débutée, les champs d'informations sont grisés. Le numéro de la charge en cours est affiché en dessus du bouton STOP. Lors du démarrage, les compteurs sont remis à zéro et la date et le nom de l'opérateur sont actualisés.

Lorsque l'utilisateur clique sur le bouton STOP, la date de fin de traitement est actualisée et le statut de la charge passe à "terminé". La forme est effacée et une nouvelle démétallisation peut être démarrée.

La connexion à un broker MQTT

Définition dans le serveur

Dans tous les logiciels modernes, il est possible de publier des données pouvant être utilisées par d'autres applications. Dans QuickView, nous avons opter pour l'utilisation de MQTT. MQTT est une manière de publier des données selon un protocole standard (voir MQTT sur wikipedia ).

Création d'un "UNS" (Unified Name Space)

L'utilisation de MQTT doit se faire d'une manière standardisée en appliquant les standards ISA-95 dans l'architecture d'un UNS:

Exemple d'un Unified Name Space:

Dans l'exemple ci-dessus, ENTREPRISE, SITE et AREA correspondent à "Base Name". PRODUCTION LINE correspond à "Group Name".

La configuration

La configuration de la connexion se fait dans VKServer.ini. Une nouvelle section [MQTT] doit être créée. Il faut auparavant avoir obtenu la licence pour permettre cette connexion. La licence correspond à AMConnector car elle est aussi utilisée par VK A&M pour importer des données depuis QuickView.

Exemple de configuration:

[MQTT]
Enabled=1
Host=192.168.11.31
Port=8883
SSlEnable=1
ClientID=VKQuickView
GroupName=A34002
RefreshRate=30
Hierarchical=1
ForceIOType=0
AutoRestart=1
PublishRectifiers=1
PublishMachine=1
PublishCounters=1
PublishDailyData=1
ValueStyle=1
DecimalCount=2

La section [MQTT]

Les mots clef suivants peuvent être définis:

La définition des variables dans QuickView

Les variables sont définies dans les IO de QuickView. Le flag 'Q' doit être ajouté à toutes les variables devant être publiées vers MQTT. Ceci se fait soit manuellement dans le fichier IO.ini soit en utilisant le navigateur d'équipement de VKClient10.

Exemple de définition dans [IO.INI]:

; Températures
; ============
300=1,Actual Temperature A,W,RQ,15,0,$FFFF,10,100
301=1,Actual Temperature B,W,RQ,15,1,$FFFF,10,100
302=3,Actual Temperature,W,RQ,15,2,$FFFF,10,100
303=4,Actual Temperature,W,RQ,15,3,$FFFF,10,100
304=5,Actual Temperature,W,RQ,15,4,$FFFF,10,100

La publication des variables

Le système publiera les I/O qui sont définies comme pouvant être publiées dans la définition ci-dessus. Il publiera également les valeurs globales de la machine comme par exemple la définition machine ou les redresseurs à condition que le mot clef "PublishMachine" soit activé.

Les variables sont publiées sous forme d'un enregistrement au format JSON. Exemple:

{"V":12.4,"U":"°C","T":"Double","TS":"2019-04-06T13:46:15.145"}

Les topics de publication dépendent du mot clef "ValueStyle". 2 styles sont définis: 0-ISA-95: Style utilisé avec VKAM ayant une version > 3.0.0.2. et 1-Legacy: Style utilisé avec VKAM ayant une version <= 3.0.0.2

VariableStyle=ISA-95

Ce style utilise des topics prédéfinis dont voici la liste:

Pub/Sub

Il est possible de définir des variables en publication ou en souscription indépendamment du système d'I/O de QuickView. Ces variables sont définies dans 2 sections de IO.ini: [MQTTSub] et [MQTTPub].

MQTTSub

Dans cette section il est possible de définir jusqu'à 100 souscriptions à des topics MQTT.

;*************************************************************************
;Souscription à des variables MQTT
;1..100=nom de la variable,Type (IO/DB),N°I/O, Var type,N°DB, N°Reg, N°Bit
;*************************************************************************
[MQTTSub]
1=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_recyclée_20uS,DB,0,F,36,90
2=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_recyclée_20uS,DB,0,F,36,91
3=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/pH_eau_recyclée_20uS,DB,0,F,36,92
4=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Turbidité_eau_recyclée_20uS,DB,0,F,36,93
5=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_recyclée_5uS,DB,0,F,36,94
6=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_recyclée_5uS,DB,0,F,36,95
7=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/pH_eau_recyclée_5uS,DB,0,F,36,96
8=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Turbidité_eau_recyclée_5uS,DB,0,F,36,97
9=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_DI,DB,0,F,36,98
10=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_DI,DB,0,F,36,99

Il est possible de souscrire à des topics MQTT et de les stocker dans des registres de databank. Il est possible de souscrire jusqu'à 100 topics. La définition se fait de la manière suivante:

Section [MQTTSub]

n=Nom du topic, type de donnée, n° de l'I/O, type de variable, n° du DB, n° du registre, n° du bit

n : numéro de souscription(1..100)

Nom du topic: nom du topic dans MQTT

type de donnée: IO => correspond à un numéro d'I/O  DB => correspond à un DB,Reg,Bit

n° d'I/O: si le type de donnée = IO alors indique le numéro d'I/O à utiliser pour stocker les données sinon pas utilisé

type de variable: 'F' => float, 'B' => boolean, 'W' => integer

n° du DB: numéro du databank si le type de donnée = DB sinon pas utilisé

n° du registre: numéro du registre du databank si type de donnée = DB sinon pas utilisé

n° du bit: numéro du bit du registre du databank si type de donnée = DB sinon pas utilisé

MQTTPub

Dans cette section il est possible de définir jusqu'à 100 publications dans des topics MQTT.

;*******************************************************************************************************************************
;Publication de variables vers MQTT
;1..100=nom du topic,Min time between refresh (sec),Force Refresh after (sec),Type (IO/DB),N° d'I/O,Var type, N°DB, N°Reg, N°Bit
;*******************************************************************************************************************************
[MQTTPub]
1=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_recyclée_20uS,5,600,DB,0,F,36,121
2=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_recyclée_20uS,5,600,DB,0,F,36,122
3=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/pH_eau_recyclée_20uS,5,600,DB,0,F,36,123
4=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Turbidité_eau_recyclée_20uS,5,600,DB,0,F,36,124
5=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_recyclée_5uS,5,600,DB,0,F,36,125
6=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_recyclée_5uS,5,600,DB,0,F,36,126
7=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/pH_eau_recyclée_5uS,5,600,DB,0,F,36,127
8=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Turbidité_eau_recyclée_5uS,5,600,DB,0,F,36,128
9=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Conductivité_eau_DI,5,600,DB,0,F,36,129
10=Rolex/Bienne/Galvano_BB/A34003/VKQV/Pub/STEP/Température_eau_DI,5,600,DB,0,F,36,130

Il est possible de publier le contenu de DB ou d'I/O dans des topics MQTT. Il est possible de définir jusqu'à 100 publications. La définition se fait de la manière suivante:

Section [MQTTPub]

n=Nom du topic, Min time between refresh, Force refresh after, n° de l'I/O, type de donnée, type de variable, n° du DB, n° du registre, n° du bit

n : numéro de publication (1..100)

Nom du topic: nom du topic dans MQTT

Min time between refresh: correspond au temps minimum entre chaque publication si la variable à changée. Le temps est exprimé en secondes.

Force refresh after: correspond au temps minimum entre chaque publication quelque soit le valeur de la variable. Le temps est exprimé en secondes.

type de donnée: IO => correspond à un numéro d'I/O  DB => correspond à un DB,Reg,Bit

n° d'I/O: si le type de donnée = IO alors indique le numéro d'I/O à utiliser pour stocker les données sinon pas utilisé

type de variable: 'F' => float, 'B' => boolean, 'W' => integer

n° du DB: numéro du databank si le type de donnée = DB sinon pas utilisé

n° du registre: numéro du registre du databank si type de donnée = DB sinon pas utilisé

n° du bit: numéro du bit du registre du databank si type de donnée = DB sinon pas utilisé

Définition dans le client

Il est possible de définir une connexion MQTT dans le programme client. Cette connexion peut être utilisée pour échanger avec un ERP ou pour l'utilisation d'un lecteur de codes à barres partagé sur plusieurs PC ou pour faire un login/logout sur plusieurs PC en même temps.

La définition se fait dans le fichier VKWinQV.ini dans la section [MQTT]. Par exemple:

[MQTT]
Enabled=1
Host=wss://google.com
Port=xxxx
GroupName=A11191
WatchdogTopic=WatchDog
BaseName=VK_Vision_SA/Villeneuve/Galvano_BA
BarCodeReaderTopic=VK_Vision_SA/Villeneuve/Galvano_BA/A11191/BarcodeReader_PDC1
LoginTopic=
SSLEnable=1
ValueStyle=0
UserName=
Password=
RefreshRate=10
ClientName=PC_Poste_de_charge_1

La section [MQTT]

Les mots clef suivants peuvent être définis:

Login/Logout sur plusieurs PC

Le LoginTopic n'est pas basé sur le BaseName, il est définissable n'importe où dans l'espace MQTT.

Si un LoginTopic est défini, il est utilisé lorsqu'un utilisateur effectue un login ou un logout. Lorsqu'il effectue un login, le topic est rempli avec le json suivant:

{
  "Command": "Login",
  "User": "Crypted user name",
  "Pwd": "Crypted password"
}

Lorsqu'il effectue un logout, le topic est rempli avec le json suivant:

{
  "Command": "Logout",
  "User": "Crypted user name"
}

 Le client s'abonne au LoginTopic. Lorsque ce dernier change, le programme exécute le login ou le logout selon les données reçues. Bien s¹r, le nom d'utilisateur et le mot de passe doivent être définis et correspondre.

Lecteur de barres codes partagé

Le BarcodeReaderTopic n'est pas basé sur le BaseName, il est définissable n'importe où dans l'espace MQTT.

Ce topic possède 2 sous-topics : In et Out. Le topic "In" correspond à la valeur lue par le lecteur de codes à barres. Le topic "Out" permet l'envoi de données à afficher sur le lecteur. Il peut également correspondre à une commande permettant de faire beeper le lecteur.

Lorsque la section [Barcode]ReaderType=MQTT, le programme s'abonne au topic BarcodeReaderTopic et lorsque son contenu change, il prend la valeur contenu dans le sous-topic "In" pour l'utiliser sur le poste de charge.

Echanges entre QuickView et un ERP

Les échanges entre QuickView et un ERP peuvent être réalisés en passant par MQTT. QuickView fait la demande en publiant une demande sur MQTT. Un agent spécialisé s'occupe de l'échange avec l'ERP et retourne la réponse en publiant cette réponse à MQTT. QuickView récupère la réponse et effectue la commande correspondante.

Pour fonctionner avec MQTT, la section [Exchange] doit être défini  doit être définie avec les valeurs suivantes:

[Exchange]
Enabled=1
Mode=8
Timeout=10

Lorsque le mode d'échange est = 8, le client s'abonne au topic suivant: BaseName/GroupName/ERP/Clients/ClientName/Request/#. 

L'agent (VKQV_NCOM ou VKQV_SAPDB ou autre) souscrit au topic  BaseName/GroupName/ERP/Clients/# et répondra aux requêtes des différents clients dans /Request/Result ou /Request/Error ou /Request/File.

Lorsque l'agent démarre, il publie son statut dans le topic BaseName/GroupName/ERP/Status/Connection pour que les clients connectés sachent que l'agent est actif. Il publie également le type d'agent dans BaseName/GroupName/ERP/Status/AgentType pour que les clients puissent modifier l'interprétation des données car tous les ERP ne fonctionnent pas de la même manière.

NCOM

NCOM est un échange entre Flexnet et QuickView. Le nom de l'agent est VKQV-NCOM. Les échanges ci-dessous sont pris en compte:

SAPDM

L'échange entre SAPDM et QuickView est réalisé à l'aide de l'agent VKQV-SAPDM. Les échanges ci-dessous sont pris en compte:

Mosquitto

Eclipse Mosquitto est un courtier de messages open source (sous licence EPL/EDL) qui implémente les versions 5.0, 3.1.1 et 3.1 du protocole MQTT. Mosquitto est léger et convient à une utilisation sur tous les appareils, des ordinateurs monocarte à faible consommation aux serveurs complets.

Le protocole MQTT fournit une méthode légère pour effectuer la messagerie à l'aide d'un modèle de publication/abonnement. Cela le rend adapté à la messagerie de l'Internet des objets, par exemple avec des capteurs de faible puissance ou des appareils mobiles tels que des téléphones, des ordinateurs embarqués ou des microcontrôleurs.

Télécharger le programme ici : https://mosquitto.org/download/ puis l'installer selon les instructions.

Il faut modifier le fichier de configuration de Mosquitto (mosquitto.conf) en y ajoutant les "listener" disponibles:

#Si pas de mot de passe nécessaire
allow_anonymous true

#Web socket ws://
listener 9000
protocol websockets
socket_domain ipv4

#Web socket sécurisé wss://
listener 9001
protocol websockets

cafile C:\Metier\mosquitto\certs\ca_certificat.crt
certfile C:\Metier\mosquitto\certs\certificat.crt
keyfile C:\Metier\mosquitto\certs\certificat.key

#accès standard mqtt://
listener 1883
protocol mqtt
require_certificate false

#accès sécurisé mqtts://
listener 8883
protocol mqtt
cafile C:\Metier\mosquitto\certs\ca_certificat.crt
certfile C:\Metier\mosquitto\certs\certificat.crt
keyfile C:\Metier\mosquitto\certs\certificat.key

Pour permettre l'utilisation depuis une application web, un listener Web socket doit être activé (ws:// ou wss://)

Configuration de l'ACL (Access Control List) dans Mosquitto

Par défaut Mosquitto autorise la connexion sans login / mot de passe. J'ai parlé de ce point dans l'article sur son installation

Une fois connecté chaque utilisateur (ou client) peut écrire ou écouter n'importe quel topic sans aucune restriction. C'est ici que l'ACL intervient !

Dans le fichier de configuration de votre Mosquitto, il est nécessaire de configurer l'emplacement de votre acl_file.

acl_file /etc/mosquitto/acl

"Lexique"

• # û Wildcard, il donne accès à tout le topic de façon récursive.
• + û Wildcard, il donne accès à tout le topic sur le même niveau.
• $SYS û est réservé au broker, il communique ses statistiques,... Vous pouvez laisser l'accès en lecture ou non aux clients via un pattern par exemple.
• user û Permet de définir l'utilisateur concerné.
• topic û Permet de définir le topic concerné.
• pattern û Permet de définir un topic à tous utilisateurs ou clients.
• read û Permet de lire le topic.
• write û Permet d'écrire sur le topic.
• readwrite û Permet de lire et d'écrire sur le topic.
• %c û ID du client.
• %u û Nom de l'utilisateur.

Il est possible de connecter plusieurs clients avec un ID différent avec le même utilisateur. Dans un premier temps limitez-vous à un client = un utilisateur car cela peut vite poser des soucis.

Clients & Users

Dans l'exemple suivant l'utilisateur cuisine à le droit d'écrire et de lire dans tout le topic maison/cuisine et à aussi le droit de lire tout le topic maison.

l'utilisateur toto lui à uniquement le droit de lire maison/cuisine/temperature.

user cuisine
topic readwrite maison/cuisine/#
topic read maison/#

user toto
topic read maison/cuisine/temperature

Patterns

Dans l'exemple suivant tous les utilisateurs peuvent lire les informations du broker $SYS. Chaque client et utilisateur ont le droit d'écrire et de lire dans " leur espace ?. Donc l'utilisateur toto à son topic maison/user/toto de façon récursive, pareil pour l'utilisateur cuisine.

pattern read $SYS/#
pattern readwrite maison/id/%c/#
pattern readwrite maison/user/%u/#

Ressource : https://mosquitto.org/man/mosquitto-conf-5.html

Sources: https://iooner.io/configuration-acl-mosquitto/

SparkPlugB

Sparkplug B est une spécification qui standardise la façon dont les données sont structurées et échangées sur MQTT dans un contexte industriel (IIoT/SCADA), pour éviter que chaque fournisseur ait son propre format.

Points clés :

Topic namespace : les messages suivent une arborescence fixe spBv1.0/group_id/message_type/edge_node_id/device_id, où message_type indique le type de message (NBIRTH, NDEATH, DBIRTH, DDEATH, NDATA, DDATA, etc.).

Payload en Protobuf : contrairement au MQTT classique souvent en JSON, Sparkplug B encode les données en Protocol Buffers, ce qui réduit la taille des messages et impose un schéma strict (métriques avec nom, type, valeur, timestamp, alias).

Gestion d'état (birth/death) : à la connexion, un nœud publie un message NBIRTH (Node Birth) listant toutes ses métriques avec leurs valeurs initiales. Le broker MQTT garde en réserve un message NDEATH (via le mécanisme Last Will and Testament) qui est publié automatiquement si le nœud se déconnecte anormalement. Cela permet aux abonnés de connaître l'état de santé (« online »/« stale ») du réseau à tout instant.

Rapport par exception (RBE) : après le message de naissance complet, seules les valeurs qui changent sont republiées (NDATA/DDATA), ce qui limite la bande passante.

Séquencing : chaque message porte un numéro de séquence (0-255) qui permet de détecter des messages perdus et de déclencher une resynchronisation.

En résumé, Sparkplug B ajoute par-dessus MQTT une convention de topics, un format de payload binaire, et un cycle de vie (birth/death/data) qui garantit un état cohérent et interopérable entre tous les appareils du réseau.

Le flux de données avec un serveur d'entreprise

Ce chapitre décrit les flux de données entre le serveur d'entreprise FlexNet et VK QuickView lors de la recherche d'articles. Il décrit également les flux de données utilisées pour les rapports de suivi.

Echanges avec des équipements

L'interface avec le contrôleur de transporteur CB99A

Dans une installation de traitement de surface, le système VK envoie les commandes de déplacement à l'automate programmable. Ce dernier est responsable de contrôler le déplacement et de positionnement des transporteurs. Le système VK gère l'anticollision avant l'envoi d'une nouvelle commande. Par exemple, si le système doit envoyer le transporteur 1 à la position 10 et que le transporteur 2 se trouve sur la position 9, il ordonnera d'abord au transporteur 2 de se déplacer à une position suffisamment éloignée pour ne pas entrer en collision avec le transporteur 1. La commande de déplacement du transporteur 1 sera envoyée une fois que le transporteur 2 est en dehors de la zone de collision.

Pour gagner du temps lors des déplacements, un mode " unsafe " peut être activé sur le système VK lui permettant d'envoyer les commandes de déplacement en parallèle. Dans notre exemple, le système envoi la commande de déplacement au robot 2 et dès que le système voit que le robot 2 est effectivement en train de se déplacer vers la position de destination, il envoi la commande au robot 1. Ce mode impose les fonctions suivantes :

1) Les transporteurs doivent tous avoir la même vitesse de déplacement.
2) Un système d'anticollision doit être implémenté dans l'automate programmable.

Ce mode est activé dans l'onglet [Hoist] de la page des paramètres du serveur:

Les registres d'échange

Les registres de commande et de statut sont définis comme suit:

L'interface avec le contrôleur de transporteur CB07FPL

Les registres d'échange

Les registres de commande et de statut sont définis comme suit:

Commands to hoist

Check <Ready state>

Sending a new command

VKQV writes a new command in the register #0. In this new command, the Bit15 will be inverted from its last value, telling to the PLC that a new command has been written.

When the PLC see that Reg0 Bit15 is different than Reg2 Bit15, it knows that a new command is pending. The Reg2 Bit4 should go Off telling to VKQV that the command is being executed. When the command is terminated (hoist is in destination), Reg2 Bit4 should go ON again and Reg2 Bit15 must be set with the content of Reg0 Bit15.

Move horizontal command

A move horizontal command is specified by writting the value 1 in the Reg0 HoistCommand bits. The Reg0 Bit4 is set to ON if the next movement is a vertical lift. This is used by the PLC to activate some equipement command ( open tank cover, or turn on spray, or etc.). The Reg0 Bit5 is set to ON when the horizontal movement is done without rack holder (jig) on the hoist. This is also an information used by the PLC to not activate some equipement command because the hoist is empty. The destination logical position is written in Reg0 Bit7-14. This is corresponding to the horizontal destination of the hoist. The Reg0 Bit15 is inverted from its previous state. And the Reg0 Bit 17 is set to ON telling to the PLC that VKQV program mode is in AUTO (set to OFF if the program mode is in STOP. This is corresponding in a command done by the remote control of the hoist).

Example of horizontal command:

Hoist is located in logical position #16 in lower vertical position:

Move to logical position #3, program mode = STOP, there is no rack holder on the hoist:

Command is accepted by the PLC:

Hoist is moving horizontally and is actually in logical position #9:

Hoist is in the logicial position 3 and is ready to accept a new command:

Move vertical command

A move vertical command is specified by writting 2 in the Reg0 HoistCommand bits. The Reg0 Bit5 is set to ON when the movement is done without rack holder (jig) on the hoist. The type of vertical movement is specified in the Reg0 Bit8-11 (1=go up to top, 2=go down to bottom, 3=go up to intermediate high, 4= go up to top from the intermediate high, 5=go down to bottom from the intermediate high, 6=go down from top to intermediate high, 7=go up to HLiftout, 8=go up from HLiftout to top, 9= go down from top to HLiftout, 10= do down from HLiftout to bottom). The speed to be use is specified in the Reg0 Bit12-14 (0..7).

Example of vertical command:

Hoist is in the logicial position #3 in lower vertical position:

Move to top:

Command is accepted by the PLC:

Hoist is moving vertically. It is in logical position #3 and is clipped:

Hoist is in logical position #3 in upper vertical position and is ready to accept a new command:

Hoist agitation command

Interface avec le contrôleur de transporteur CB24FPL

Ce nouveau type de contrôleur permet le contrôle d'un transporteur permettant l'inclinaison latérale des charges ainsi que l'inclinaison radiale de celles-ci. Ces inclinaisons permettent un meilleur égouttage des charges. L'inclinaison se fait en haut mais peut également se faire en bas pour remplir et évacuer les bulles dans les pièces traitées.

Les registres d'échange

Il y a 6 registres d'échange par transporteur:

Le détail des registres de commande et de statut sont définis comme suit:

Les types de mouvements verticaux

Les mouvements verticaux sont définis dans une table de l'automate. Cette table est composée de 50 types de mouvements. Chaque type est composé de 20 enregistrements. Chaque enregistrement est composé de:

Structure du DB interne d'échange

Tous les types de transporteur utilisent une zone mémoire commune définie dans DBData et RegData. Cette zone doit comprendre 100 registres et doit être associé à un Databank interne. Les registres de cette zone correspondent à la définition suivante:

Le DB Interne d'échange a la structure suivante: