ADD : addition

Description de la fonction

La fonction ajoute les valeurs d'entrée et affecte le résultat à la sortie.

Les types de données de l'ensemble des valeurs d'entrée et des valeurs de sortie doivent être identiques.

Pour toutes les fonctions, le nombre d'entrées peut atteindre 32.

Dans le cas d'une addition incluant le type de données , il existe le bloc ADD_TIME

et peuvent être configurés en tant que paramètres supplémentaires.

Formule

INT, DINT, UINT, UDINT, REAL :

OUT = IN1 + IN2 + ... + INn

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

LD Value1
ADD Value2
ST Sum

Représentation en ST

Représentation :

Sum := ADD (Value1, Value2) ;

Description des paramètres

Description du paramètre d'entrée :

Paramètre	Type de données	Signification
Value1	INT, DINT, UINT, UDINT, REAL	Somme
Value2	INT, DINT, UINT, UDINT, REAL	Somme
Valuen	INT, DINT, UINT, UDINT, REAL	Somme n = max 32

Description du paramètre de sortie :

Paramètre	Type de données	Signification
Sum	INT, DINT, UINT, UDINT, REAL	Somme

Erreur d'exécution

Le bit système %S18 est défini sur 1, si

la plage des valeurs de sortie est dépassée (tous les types de données disponibles)

ou

%S18

TIME

Le type TIME exprime une durée en millisecondes. Codé sur 32 bits, ce type permet d'obtenir des durées de 0 à 2 32-1 millisecondes.

Le type TIME présente les unités suivantes : jours (d), heures (h), minutes (m), secondes (s) et millisecondes (ms). Une valeur littérale de type TIME est représentée par une combinaison des types précédents associés au préfixe T#, t#, TIME# ou time#.

Exemples : T#25h15m, t#14,7S, TIME#5d10h23m45s3ms

EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie.

Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0.

Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0.

Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1.

ENO

ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN.

Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) :

les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ;
la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0.

REAL

Le type REAL (réel) est codé sur 32 bits.

Les plages de valeurs possibles sont indiquées dans la figure suivante :

Lorsqu'un résultat est :

compris entre -1,175494e-38 et 1,175494e-38, il est considéré comme étant un DEN ;
inférieur à -3,402824e+38, le symbole -INF (pour - infini) s'affiche ;
supérieur à +3,402824e+38, le symbole INF (pour + infini) s'affiche ;
indéfini (racine carrée d'un nombre négatif), le symbole NAN s'affiche.

NOTE : La norme CEI 559 définit deux catégories de NAN : le NAN silencieux (QNAN) et le NAN de signalement (SNAN). Un QNAN est un NAN (Not a Number) avec un bit de fraction de poids fort tandis qu'un SNAN est un NAN sans bit de fraction de poids fort (bit numéro 22). Les QNAN peuvent être propagés par la plupart des opérations arithmétiques, sans générer d'exception. Quant aux SNAN, ils signalent en général une opération non valide lorsqu'ils sont utilisés en tant qu'opérandes dans des opérations arithmétiques (voir %SW17 et %S18).

NOTE : Lorsqu'un DEN (nombre non normalisé) est utilisé en tant qu'opérande, le résultat n'est pas significatif.