Nouveau point d'arrêt... / Nouveau point d'arrêt des données...

Présentation

Les commandes Débogage Nouveau point d'arrêt... / Débogage Nouveau point d'arrêt des données... sont disponibles dans les modes hors ligne et en ligne, dans le contexte de débogage ainsi que dans la vue des points d'arrêt.

La boîte de dialogue Nouveau point d'arrêt / Nouveau point d'arrêt des données s'ouvre. Elle permet de définir la position et les conditions d'un nouveau point d'arrêt ou d’un nouveau point d'arrêt des données dans l'application active. En mode en ligne, vous pouvez en outre définir des points d'exécution.

Pour pouvoir utiliser des points d'arrêt des données, il faut que le fichier de description d'équipement comprenne des entrées cibles qui correspondent à votre contrôleur.

Consultez également les fonctions correspondantes dans la boîte de dialogue Points d'arrêt.

Pour définir un point d'arrêt à l'emplacement du curseur, reportez-vous à la commande Basculer le point d'arrêt.

Onglet Emplacement de la boîte de dialogue Nouveau point d'arrêt

Elément	Description
POU :	La liste propose les POU disponibles dans l'application active. Sélectionnez celui où vous souhaitez définir un point d'arrêt.
Position :	La liste propose les positions de point d'arrêt possibles pour les POU sélectionnés. En fonction du type d'éditeur, ces positions sont définies par numéros de ligne et colonne (éditeurs de texte) ou en tant que numéro de réseau ou d'élément (éditeurs graphiques). En cas de bloc fonction, (Impl) est ajouté en plus. Vous devez décider si le point d'arrêt doit être défini dans l'implémentation ou dans une instance. Si une définition pendant l'implémentation est nécessaire, laissez l'option Chemin d'instance désactivé. Si une définition dans une instance est nécessaire, activez l'option Chemin d'instance pour sélectionner l'instance.
Instances :	Si le POU sélectionné est un bloc fonction et que cette option est désactivée, le point d'arrêt est défini dans le corps d'implémentation du POU (voir l'élément Position). Si vous voulez définir le point d'arrêt dans une instance, activez l'option et sélectionnez l'instance souhaitée.

Onglet Condition de la boîte de dialogue Nouveau point d'arrêt

L'onglet Condition permet de définir des conditions qui entraînent l'arrêt de l'exécution du programme au niveau du point d'arrêt :

Elément	Description
Tâches :
S’arrêter uniquement lorsque le point d’arrêt est atteint dans l’une des tâches suivantes :	Activez cette option si le point d'accès ne doit être effectif que si le POU où il se trouve est traité par des tâches particulières. Vous pouvez ainsi décider que le point d'arrêt va s'appliquer à une tâche spécifique, à l'exception des autres tâches utilisant le même POU. Consultez la rubrique Points d'arrêt et procédures pas à pas dans les applications contenant plusieurs tâches. La liste de sélection inclut toutes les tâches définies dans le projet.
Nombre d'accès :
Toujours s'arrêter :	Le programme s'arrêtera au point d'arrêt.
Autre :	Le programme ne s'arrêtera pas au point d'arrêt tant que ce dernier n'a pas été atteint le nombre de fois défini (à saisir ou à sélectionner dans le champ numérique) : S’arrêter lorsque le nombre d’accès équivaut à S’arrêter lorsque le nombre d'accès est un multiple de S’arrêter lorsque le nombre d’accès est supérieur ou égal à
Condition
S’arrêter si TRUE	Vous pouvez utiliser des points d'arrêt conditionnels si le système d'exécution les prend en charge. Veuillez consulter le Guide de programmation spécifique à votre contrôleur pour savoir si les points d'arrêt conditionnels sont pris en charge. La condition ne peut être spécifiée qu'en mode en ligne. La condition spécifiée est évaluée. Le programme s'arrêtera à ce point d'arrêt uniquement si le résultat est TRUE, le code du point d'exécution sera exécuté. Vous pouvez entrer comme condition des expressions booléennes valides. Exemple : `x>100, x[y]=z, a AND b, boolVar` NOTE : L'utilisation de points d'arrêt conditionnels ralentit l'exécution du code même si la condition n'est pas TRUE.

Onglet Données de la boîte de dialogue Nouveau point d'arrêt des données

L'onglet Données permet de modifier la variable pour laquelle un point d'arrêt des données est défini :

Elément	Description
Arrêter l'exécution si la valeur de la variable ou l'adresse change	Entrez un nom de variable valide. Sélectionnez une variable dans la boîte de dialogue Aide à la saisie (catégorie Variables à surveiller).
Taille	Nombre d'octets de la variable ou de l'adresse mémoire à surveiller spécifiée. Lorsqu'une nouvelle variable ou adresse mémoire est spécifiée, une valeur correspondant au type de données est affectée. La taille maximale et le nombre de points d'arrêt de données dépendent du système cible : Exemple 1 : `4` pour le type de données DWORD Exemple 2 : `2` pour le type de données DWORD Les deux premiers octets de la variable sont surveillés.

Elément

Description

Arrêter l'exécution si la valeur de la variable ou l'adresse change

Entrez un nom de variable valide.
Sélectionnez une variable dans la boîte de dialogue Aide à la saisie (catégorie Variables à surveiller).

Taille

Nombre d'octets de la variable ou de l'adresse mémoire à surveiller spécifiée.

Lorsqu'une nouvelle variable ou adresse mémoire est spécifiée, une valeur correspondant au type de données est affectée.

La taille maximale et le nombre de points d'arrêt de données dépendent du système cible :

Exemple 1 : 4 pour le type de données DWORD

Exemple 2 : 2 pour le type de données DWORD Les deux premiers octets de la variable sont surveillés.

Onglet Paramètres de point d'exécution de la boîte de dialogue Nouveau point d'arrêt

Elément	Description
Point d'exécution (l'exécution ne s'arrête pas au point d'arrêt)	Le point d'arrêt devient un point d'exécution. Cela veut dire que le traitement ne s'arrête pas à ce point et que le code concerné est exécuté. Point d'exécution activé : Point d'exécution désactivé : Point d'exécution d'un point d'arrêt des données activé : Point d'exécution d'un point d'arrêt des données désactivé :
Exécuter le code suivant	Entrez le code à exécuter. Les restrictions suivantes s'appliquent : Taille du code < 1200 octets Pas d'instructions conditionnelles, de constructions de boucle (`IF, CASE, FOR, WHILE`) Pas d'appels de bloc fonction Pas d'appels de méthode Pas d'opérations sur les bits avec opérateurs `AND, OR, NOT` Pas de multiplication ni de division avec des types de données autres que INT Pas d'appel de propriétés dans les instances d'un type d'interface En outre, cette restriction s'applique : Les fonctions et propriétés appelées doivent remplir au moins une des deux conditions suivantes : 1. Dans la boîte de dialogue Affichage > Propriétés > Compiler, l'option Activer les appels système est activée. 2. L'attribut suivant est ajouté au-dessus de la déclaration de la fonction/propriété : `{attribute 'monitoring' := 'call'}`.
Imprimer un message dans le journal d'appareil	Cette option est disponible si l'option Activer la journalisation dans les points d'arrêt est activée dans la boîte de dialogue Paramètres du projet > Options de compilation. Si le message doit contenir la valeur présente d'une variable, insérez le nom de la variable entre accolades. Exemple : La valeur présente de la variable `iCount` est : `{iCount}`.
Activer le point d'arrêt immédiatement	Sélectionnez l'option Activer le point d'arrêt immédiatement pour activer le point d'arrêt. Désélectionnez l'option Activer le point d'arrêt immédiatement pour désactiver le point d'arrêt. Pour activer le point d'arrêt ultérieurement, cliquez sur le bouton dans la vue Points d'arrêt.