Les Messages _MSG

Un message est un bit interne de la mémoire d'information, de classe _MSG.

Chaque message peut etre positionné dans une ACTION. Il n'est cependant pas possible de l'utiliser avec le complément /.

Déclarer un Message

Dans la zone d'ALIAS, déclarez un Message de la manière suivante:

#define ACRONYME <-> _MSG(parametre=valeur);

La définition commence par le mot clé #define, puis une chaine de caractères représentant l'ACRONYME du message, puis une double flèche (un inférieur « < », un tiret « - », un supérieur « > »), la classe _MSG, une liste d'option (sous la forme parametre=valeur) entourée de parenthèses, et enfin un point virgule terminal.

Les types des Messages

Dans sa définition, un message permet de spécifier sa typologie. Il existe plusieurs typologies de messages qui peuvent etre précisées au travers de l'option type:

Périmètre procédé	Typologie	Représentation	Description
Activité	etat		Le message a pour vocation d'informer l'utilisateur d'une situation ou d'un évènement sur le procédé. Si la situation ne se présente plus, le message disparait.
Activité	defaut		Une situation de dérive potentiellement momentanée sur le procédé est rencontrée sur le procédé.
Activité	alarme		Une situation de dérive persistante sur le procédé necessitant une intervention de l'utilisateur est rencontrée.
Activité	notification		Le message a pour vocation d'informer d'un évènement lié au procédé. Le message reste apparent jusqu'au nouvel évènement du même type.
Sécurité des biens	veille		Les biens associés au procédé sont sous surveillance.
Sécurité des biens	alerte		Un évènement particulier met à mal la sécurité des biens associés au procédé.
Sécurité des personnes	derangement		La surveillance de la sécurité des personnes à proximité du procédé n'est que partielle ou inexistante.
Sécurité des personnes	danger		Un évènement met en péril la sécurité des personnes à proximité du procédé.

Si non renseignée, la typologie par défaut d'un message est etat.

Exemple:

/* Nous sommes dans le DLS "PORTE" */
/* Définition d'un message */
#define MON_MSG <-> _MSG(type=etat, libelle="la porte est ouverte")

/* Le message 'la porte est ouverte', de typologie info, sera diffusé */
/* quand la condition 'PORTE_OUVERTE' sera vraie. */
- PORTE_OUVERTE -> MON_MSG;

L'option de debug

L'option debug peut etre ajoutée à la liste des options d'un message, lors de sa définition. Cette option permet de ne diffuser le message qu'à la condition que le module D.L.S associé soit dans une situation de debug activée.

Exemple:

/* Nous sommes dans le DLS "PORTE" */
/* Définition d'un message, ajout de l'option `debug` en fin de liste d'option */
#define MON_MSG_DE_DEBUG <-> _MSG(type=etat, libelle="test", debug)

/* Meme si 'MA_CONDITION' est vraie, le message */
/* ne sera diffusé que si le DLS est en debug. */
- MA_CONDITION -> MON_MSG_DE_DEBUG;

L'option freeze

L'option freeze peut etre ajoutée à la liste des options d'un message, lors de sa définition. Quand le libellé d'un message contient une référence vers un bit interne, le message est dit dynamique. Ces libellés sont mis à jour à chaque modification de la valeur du bit interne référencé.

L'option freeze permet d'empécher la mise à jour du libellé pendant un temps défini

Exemple:

/* Nous sommes dans le DLS "TEMPERATURE" */
/* Définition d'un message, ajout de l'option `freeze` en fin de liste d'option */
/* avec une valeur de 36000 soit 1 heure */
#define MON_MSG_TEMP <-> _MSG(type=etat, libelle="Dehors il fait $TEMP:EXTERIEURE", freeze=36000)

/* Meme si 'MA_CONDITION' est vraie, le libellé */
/* du message ne sera mis à jour qu'au mieux toutes les heures (36000 1/10s = 1h). */
- MA_CONDITION -> MON_MSG_TEMP;

Tip

L'option freeze=-1, ou tout autre valeur négative, interdit la mise à jour du libellé dans le temps.

L'option groupe

L'option groupe peut etre ajoutée à la liste des options d'un message, lors de sa définition. Cette option permet de creer un groupe de message dans lequel la mise à un d'un message met à zero tous les autres messages du meme groupe.

Le groupe est représenté par un entier, dont la portée est limitée au DLS propriétaire du message.

Exemple:

/* Nous sommes dans le DLS "PORTE" */
/* Définition d'un message, ajout de l'option `groupe` en fin de liste d'option */
#define MSG_VENT_NORD  <-> _MSG(type=etat, libelle="vent du nord", groupe=1)
#define MSG_VENT_SUD   <-> _MSG(type=etat, libelle="vent du sud", groupe=1)
#define MSG_VENT_EST   <-> _MSG(type=etat, libelle="vent d'est", groupe=1)
#define MSG_VENT_OUEST <-> _MSG(type=etat, libelle="vent d'ouest", groupe=1)

/* le passage d'un vent du nord à un vent d'est diffusera le message */
/* 'vent d'est' tout en désactivant le message 'vent du nord' */
- VENT_DU_NORD  -> MSG_VENT_NORD;
- VENT_DU_SUD   -> MSG_VENT_SUD;
- VENT_DE_EST   -> MSG_VENT_EST;
- VENT_DE_OUEST -> MSG_VENT_OUEST;

Warning

Un message actif d'un groupe de message ne peut etre désactivé que si un autre message du même groupe est activé.

Exemples d'usages

/* Nous sommes dans le DLS "PORTE" */
/* Définition des messages */
#define MSG_OUVERTE    <-> _MSG(type=etat,   libelle="la porte est ouverte")
#define MSG_COINCEE    <-> _MSG(type=defaut, libelle="la porte est coincée")
#define MSG_EN_VEILLE  <-> _MSG(type=veille, libelle="la porte est sous surveillance")
#define MSG_EFFRACTION <-> _MSG(type=alerte, libelle="la porte est fracturée")