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 et 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, consultez la documentation 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 : `FunctionResult:= FunctionName(VarInput1, VarInput2,.. VarInputx);`

É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, consultez la documentation 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 :

FunctionResult:= FunctionName(VarInput1, VarInput2,.. VarInputx);

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

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 (-36..+73) := 5; myDay: sec.DAY_OF_WEEK := SUNDAY; myHour: sec.HOUR := 12; myMinute: sec.MINUTE; myRTCAdjust: sec.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 (-36..+73) := 5;
myDay: sec.DAY_OF_WEEK := SUNDAY;
myHour: sec.HOUR := 12;
myMinute: sec.MINUTE;
myRTCAdjust: sec.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 : Les variables d'entrée sont les paramètres d'entrée requis par le bloc fonction. Les 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 : `FunctionBlock_InstanceName(Input1:=VarInput1, Input2:=VarInput2,... Ouput1=>VarOutput1, Ouput2=>VarOutput2,...);`

É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 :

Les variables d'entrée sont les paramètres d'entrée requis par le bloc fonction.
Les 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 :

FunctionBlock_InstanceName(Input1:=VarInput1, Input2:=VarInput2,... Ouput1=>VarOutput1, Ouput2=>VarOutput2,...);

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

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`