FB_GetDiagnosticData - Description fonctionnelle

Présentation

Type :

Bloc fonction

Disponible à partir de la version :

V1.0.0.0

G-SE-0078147.1.gif-high.gif

 

 

Description fonctionnelle

Le bloc fonction FB_GetDiagnosticData permet de fournir des diagnostics système dédiés d'une application M262.

Les fonctions suivantes sont prises en charge :

oRécupération des messages du journaliseur envoyés par le composant MotionKernel du contrôleur sur le journaliseur par défaut du contrôleur.

oRécupération des informations de diagnostic fournies par le contrôleur.

oCréation d'un fichier avec les messages de diagnostic récupérés.

oEffacement de la table de données.

Une seule instance du bloc fonction est autorisée dans une application. Si plusieurs instances existent, les dernières instances initialisées indiquent le résultat AnotherInstanceOfFbEx­istsInApp à q_etResult.

Récupération des messages du journaliseur de MotionKernel

Dès que le bloc fonction est instancié dans l'application, la récupération des messages du journaliseur depuis MotionKernel est exécutée. Chaque message envoyé au journaliseur par défaut du contrôleur par le composant MotionKernel est détecté et stocké dans la table de données GVL.G_astDiagTable. La source de ces messages est définie sous la forme MotionKernel.

Les messages du journaliseur du MotionKernel sont récupérés et stockés dans GVL.G_astDiagTable, même si le bloc fonction n'est pas appelé dans l'application.

Récupération d'informations de diagnostic du système du contrôleur

L'exécution du bloc fonction avec la commande GetDiagData démarre le système de diagnostic du contrôleur. Les messages de diagnostic récoltés sont stockés dans la table de données GVL.G_astDiagTable. La source de ces messages est définie sous la forme FbGetDiag. A chaque exécution, les messages de diagnostic avec source FbGetDiag sont supprimés de la table de données. L'horodatage des nouveaux messages de diagnostic est défini à la date d'exécution du bloc fonction.

Création du fichier de messages de diagnostic sur le contrôleur

L'exécution du bloc fonction avec la commande CreateFileFromDiagTable permet de créer un fichier sur le système de fichiers du contrôleur.

Le chemin d'accès au fichier créé sur le contrôleur est usr/Syslog/M262Diagnostic.txt.

Le fichier contient les messages de diagnostic de la table de données GVL.G_astDiagTable. Les colonnes sont séparées par une virgule.

Table de données

Les messages de diagnostic sont écrits dans la table de données GVL.G_astDiagTable, accessible via l'application pour permettre les analyses.

Le message le plus récent correspond à l'index le plus bas du tableau.

Si le tableau est plein, chaque nouveau message entraîne la suppression du plus ancien (mémoire tampon circulaire).

Interface

Entrée

Type de données

Description

i_xExecute

BOOL

Sur un front montant, la commande définie est exécutée par le bloc fonction.

i_etCommand

STRING(255)

Définit la commande à exécuter.

i_stParamters

ST_ParamFbGetDiag

Paramètres d'exécution du bloc fonction.

Les éléments de ST_ParamFbGetDiag sont initialisés comme suit :

otimTimeoutGetDiagData := T#10S, la limite inférieure de la valeur est T#1s

otimTimeoutCreateFile := T#10S, la limite inférieure de la valeur est T#1s

obyPlcDiagOptEthItfToCheck := 2#11

Sortie

Type de données

Description

q_xDone

BOOL

Si cette sortie est TRUE, l'exécution s'est effectuée correctement.

q_xBusy

BOOL

Si cette sortie est TRUE, le bloc fonction est en cours d'exécution.

q_xError

BOOL

Si cette sortie est TRUE, une erreur a été détectée. Pour plus d'informations, reportez-vous à q_etResult et q_etResultMsg.

q_etResult

ET_Result

Fournit des informations de diagnostic et d'état sous la forme d'une valeur numérique.

q_sResultMsg 

STRING (80)

Fournit des informations de diagnostic et d'état sous la forme d'un message textuel.

q_uiNumOfDiagEntries

UINT

Indique le nombre de messages de diagnostic ajoutés à GVL.G_astDiagTable.

q_stInfoEthernetDevices

ST_InfoEthernetDevices

Fournit des informations sur les équipements Ethernet configurés dans le projet.