Utilisation d'une fonction ou d'un bloc fonction en langage ST

Informations générales

Cette partie décrit comment mettre en œuvre une fonction ou un bloc fonction en langage ST.

La fonction SetRTCDrift et le bloc fonction TON sont utilisés à titre d'exemple pour illustrer les mises en œuvre.

Utilisation d'une fonction en langage ST

La procédure suivante explique comment insérer une fonction en langage ST :

Étape	Action
1	Ouvrez ou créez une POU en langage ST (Structured Text ou Littéral structuré). NOTE : La procédure de création d'une POU n'est pas détaillée ici. Pour plus d'informations, reportez-vous à la section Ajout et appel de POU.
2	Créez les variables nécessaires à la fonction.
3	Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'une fonction. La syntaxe générale est la suivante : RésultatFonction:= NomFonction(VarEntrée1, VarEntrée2, … VarEntréex);

Étape

Action

Ouvrez ou créez une POU en langage ST (Structured Text ou Littéral structuré).

NOTE : La procédure de création d'une POU n'est pas détaillée ici. Pour plus d'informations, reportez-vous à la section Ajout et appel de POU.

Créez les variables nécessaires à la fonction.

Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'une fonction. La syntaxe générale est la suivante :

RésultatFonction:= NomFonction(VarEntrée1, VarEntrée2, … VarEntréex);

Pour illustrer la procédure, utilisons la fonction SetRTCDrift représentée graphiquement ci-après :

Fonction	Représentation graphique
SetRTCDrift

Fonction

Représentation graphique

SetRTCDrift

La représentation en langage ST de cette fonction est la suivante :

Fonction	Représentation dans l'éditeur ST de POU
SetRTCDrift	PROGRAM MyProgram_ST VAR myDrift: SINT(-29..29) := 5; myDay: DAY_OF_WEEK := SUNDAY; myHour: HOUR := 12; myMinute: MINUTE; myRTCAdjust: RTCDRIFT_ERROR; END_VAR myRTCAdjust:= SetRTCDrift(myDrift, myDay, myHour, myMinute);

Fonction

Représentation dans l'éditeur ST de POU

SetRTCDrift

PROGRAM MyProgram_ST
VAR myDrift: SINT(-29..29) := 5;
myDay: DAY_OF_WEEK := SUNDAY;
myHour: HOUR := 12;
myMinute: MINUTE;
myRTCAdjust: RTCDRIFT_ERROR;
END_VAR

myRTCAdjust:= SetRTCDrift(myDrift, myDay, myHour, myMinute);

Utilisation d'un bloc fonction en langage ST

La procédure suivante explique comment insérer un bloc fonction en langage ST :

Étape	Action
1	Ouvrez ou créez une POU en langage ST (Structured Text ou Littéral structuré). NOTE : La procédure de création d'une POU n'est pas détaillée ici. Pour plus d'informations sur l'ajout, la déclaration et l'appel de POU, reportez-vous à la documentation associée.
2	Créez les variables d'entrée, les variables de sortie et l'instance requises pour le bloc fonction : oLes variables d'entrée sont les paramètres d'entrée requis par le bloc fonction. oLes variables de sortie reçoivent la valeur renvoyée par le bloc fonction.
3	Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'un bloc fonction. La syntaxe générale est la suivante : BlocFonction_NomInstance(Entrée1:=VarEntrée1, Entrée2:=VarEntrée2,… Sortie1=>VarSortie1, Sortie2=>VarSortie2,…);

Étape

Action

Ouvrez ou créez une POU en langage ST (Structured Text ou Littéral structuré).

NOTE : La procédure de création d'une POU n'est pas détaillée ici. Pour plus d'informations sur l'ajout, la déclaration et l'appel de POU, reportez-vous à la documentation associée.

Créez les variables d'entrée, les variables de sortie et l'instance requises pour le bloc fonction :

oLes variables d'entrée sont les paramètres d'entrée requis par le bloc fonction.

oLes variables de sortie reçoivent la valeur renvoyée par le bloc fonction.

Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'un bloc fonction. La syntaxe générale est la suivante :

BlocFonction_NomInstance(Entrée1:=VarEntrée1, Entrée2:=VarEntrée2,… Sortie1=>VarSortie1, Sortie2=>VarSortie2,…);

Pour illustrer la procédure, utilisons le bloc fonction TON représenté graphiquement ci-après :

Bloc fonction	Représentation graphique
TON

Bloc fonction

Représentation graphique

TON

Le tableau suivant montre plusieurs exemples d'appel de bloc fonction en langage ST :

Bloc fonction	Représentation dans l'éditeur ST de POU
TON

Bloc fonction

Représentation dans l'éditeur ST de POU

TON