Você está na página 1de 39

Ver

Software
Fundao Centros de Referncia em Tecnologias Inovadoras
Financiadora de Estudos e Projetos
Servio de Apoio s Micro e Pequenas Empresas
Conselho Nacional de Desenvolvimento Cientfico e Tecnolgico

ScadaBR
Sistema Open-Source para Superviso e Controle

Manual do Software
Agosto de 2010

2
Sommaire

1 Introduction.............................................................................................................4
A propos de ce document ..........................................................................................4
Systeme SCADA....................................................................................................... 4
1.1 ScadaBR............................................................................................................4
2 Installation.............................................................................................................. 5
3 Fonctionnement de ScadaBR .....................................................................................6
3.1 Prsentation...................................................................................................... 6
3.1.1 Menu principal.......................................................................................... 6
3.1.2 . Types de donnes....................................................................................6
3.1.3 . Sources de donnes.................................................................................7
3.1.4 . Points de donnes................................................................................... 7
3.1.5 Monitorage............................................................................................... 8
3.1.6 Contrle...................................................................................................8
3.1.7 vnements..............................................................................................8
3.1.8 Icnes des applications.............................................................................. 9
3.1.9 Sons des alarmes......................................................................................9
3.1.10 Images.................................................................................................10
4 Ajout de sources de donnes et des points de donnes ...............................................10
4.1 Exemple de source de donnes virtuelle..............................................................10
4.2 Exemple Source de Donnes virtuelle Serveur OPC...............................................12
4.3 Affichage des donnes: listes de surveillance et graphiques ..................................13
4.4 Dfinition d' vnements .................................................................................. 15
4.5 Reprsentations graphiques...............................................................................15
5 Utilisateurs............................................................................................................ 19
5.1 Cration d'un utilisateur.................................................................................... 19
5.2 Partages avec un utilisateur...............................................................................21
6 Rapports................................................................................................................22
6.1 Introduction.....................................................................................................22
6.2 Gnration de rapports dans ScadaBR ................................................................22
6.2.1 Cration d'un nouveau modle de rapport...................................................22
6.2.2 Planification des rapports .........................................................................22
6.2.3 Envoi de rapport par mail........................................................................22
6.2.4 Gestion des modles...............................................................................24
6.2.5 Files de rapport.......................................................................................24
7 Scripts...................................................................................................................26
7.1 Introduction.....................................................................................................26
7.2 Cration de la source de donnes et des points....................................................26
7.3 Cration d'une source de donnes Mta et ses points ..........................................31
7.4 Cration de liaisons de point.............................................................................. 36
8 Watchdog.............................................................................................................. 38
8.1 Fonctionnement................................................................................................38
8.2 Configuration...................................................................................................38
8.3 Excution........................................................................................................ 38
9 Conseils.................................................................................................................39
9.1 Changer de base de donnes............................................................................. 39

3
1 Introduction

A propos de ce document

Ce tutoriel est destin aux nouveaux utilisateurs du logiciel ScadaBR. Des informations
supplmentaires sur les fonctionnalits du logiciel se trouvent sur le menu principal en cliquant sur
l'icne .
Des informations plus prcises sur chacune des fonctionnalits sont galement disponibles dans les
crans de configuration en cliquant sur l'icne similaire .

Ce document concerne la version 0.8 de ScadaBr

1.1 ScadaBR

ScadaBR est dvelopp en open source , sous licence libre. Une documentation complte et le
code source du systme sont disponibles, y compris l'autorisation de modifier et redistribuer le
logiciel si ncessaire. ScadaBR est une plate-forme d'application Java pour les PC sous Windows,
Linux et autres systmes d'exploitation peuvent excuter le logiciel partir d'un serveur
d'application (Apache Tomcat est le choix par dfaut). Lorsque vous lancez l'application, ScadaBr
peut tre consult partir d'un navigateur Internet, de prfrence Firefox ou Chrome. L'interface
principale est facile utiliser et offre dj ScadaBR visualisation des variables, des graphiques, des
statistiques, l'tablissement des protocoles, des alarmes, le type de btiment crans IHM et une
foule d'options de configuration. Aprs la mise en place des protocoles de communication avec
l'quipement et la dfinition des variables (entres et sorties, ou "tags") partir d'une application
automatise, vous pouvez construire des interfaces utilisateur l'aide du navigateur Web lui-mme.
Vous pouvez galement crer des applications personnalises en tout langage de programmation
moderne, partir du code source la disposition de son API ou "Web-services. "Sur notre site vous
trouverez une vido de dmonstration, qui dcrit les notions lmentaires de ScadaBr.

4
2 Installation
Consulter le site officiel http://www.scadabr.org.br (en portugais ) pour installer ScadaBr

5
3 Fonctionnement de ScadaBR

3.1 Prsentation

3.1.1 Menu principal

Les fonctionnalits de cette application sont accessibles par des commandes dans l'en-tte. Selon
les autorisations de votre compte d'utilisateur, plusieurs icnes seront affiches en dessous du logo.
Lorsque le curseur de la souris survole une icne, vous verrez une info bulle avec une brve
description de la fonctionnalit de cette icne. Outre le contrle des icnes sur le ct droit de l'en-
tte apparait le nom d'utilisateur enregistr dans le systme. Lorsque votre application dispose
d'une alarme active, l'image d'un drapeau ( ) clignote accompagne d'une description de
l'alarme au centre de l'en-tte. La couleur de drapeau indique la gravit de l'alarme:
Information
Urgent
Critique
Scurit des personnes
Vous pouvez cliquer sur l'icne ou la description pour afficher la liste des alarmes actives.

3.1.2 . Types de donnes

Il en existe 5:
Valeurs Binaire (ou boolen) ne peut avoir que deux tats, fait rfrence au systme avec
des valeurs nulles (0) et un (1). Vous pouvez utiliser des convertisseurs pour afficher des
valeurs binaires dans toutes les tiquettes ncessaires, telles que On / Off , "High /
Low , start / stop , etc.
Les valeurs Etat Multiple ont plusieurs tats distincts. Avec cette approche, le type binaire
est un cas particulier d'un tat multiples. Les valeurs sont l'origine reprsentes par des
entiers (par exemple 0, 1, 2, 7, ...), mais, comme dans les valeurs binaires, vous pouvez
attribuer des tiquettes chaque valeur, par exemple, on / off / off "," chaud / cool / "off, ou
de toute autre
.
Les valeurs numriques sont reprsentes dans un systme dcimal virgule flottante.
Exemples de valeurs numriques: temprature, humidit, altitude et montant. Le formatage
de texte peut tre utilis pour dterminer les caractristiques d'affichage tels que le nombre
de dcimales, des milliers de sparation (avec des points ou des virgules), l'affichage des
suffixes ( F, kW / h, doux, etc) .. Un formatage peut tre utilis pour convertir des valeurs
en tiquettes de texte.

Les valeurs alphanumriques sont de simples chanes, comme la description O / S partir
d'une source SNMP

6
.
Les images sont des reprsentations des valeurs dans les donnes image binaire. Sont
stocks dans le systme de fichiers du serveur hte (pas la base de donnes) et sont stockes
dans la mmoire. Un formatage peut tre utilis pour crer des images l'chelle sous
forme de vignettes afficher

3.1.3 . Sources de donnes

Les sources de donnes sont fondamentales pour le fonctionnement de cette application. Une
source de donnes est un lieuo des donnes sont reues. Presque tout peut tre une source de
donnes, du moment que le protocole de communication peut supporter une requte. Quelques
exemples:

Si vous avez un rseau accessible par Modbus RS232, RS485, TCP / IP ou UDP / IP, vous
pouvez crer une source de donnes Modbus qui interroge le rseau intervalle dfini

Si vous avez du matriel ou des applications qui peuvent envoyer des donnes sur HTTP,
vous pouvez crer une source de donnes HTTP rcepteur qui coutera les connexions
entrantes et transmettra des donnes aux endroits appropris

Pour le matriel supportant le SNMP, dmarrez la source de donnes. Les valeurs peuvent
tre lues intervalles rguliers et les alertes peuvent tre collectes pour des rapports
d'anomalies.
Les donnes peuvent tre lues et mises jour dans un systme de base de donnes SQL
externe
Les donnes peuvent tre gnrs de manire alatoire ou programme en utilisant une
source de donnes virtuelle

3.1.4 . Points de donnes

Un point de donnes est une srie de valeurs historiques associes. Par exemple, un point
particulier peut tre une lecture de la temprature d'une pice, tandis qu'une autre section pourrait
tre la lecture de la humidit de la pice mme. Les points peuvent galement tre des valeurs de
contrle, comme un indicateur pour activer un dispositif
.
De nombreux attributs sont utiliss pour contrler le comportement des points. Au dpart il y a le
concept de localisation de point. Les Localisations sont utilises par les sources de donnes afin
de dterminer comment trouver les donnes pour un point particulier. Par exemple, une source
de donnes SQL a des attributs, savoir o trouver l'instance de la base de donnes, rechercher les
point de la source de donnes, indiquer le nom de la table et les champs o des valeurs spcifiques

7
peuvent tre trouves. La sparation logique de source de donnes et du point de donnes dpend
du protocole de communication en question.

Les attributs de points de donnes peuvent galement dterminer de nombreux autres aspects du
point, comme son nom, comment doit-il tre enregistr (toutes les donnes, uniquement les
modifications de la valeur, ou aucune), la dure de conservation des donnes, comment mettre en
forme les donnes pour l'affichage des tableaux et des graphiques.

Vous pouvez galement configurer des points de donnes avec des dtecteurs d'vnement, qui
sont utiliss pour dtecter les valeurs remarquables des points, par exemple, si la valeur reste trop
leve pendant trop longtemps, si elle est trs faible, si elle change souvent, si il n'y a aucun
changements, etc. Les points peuvent tre organiss dans une hirarchie, ou une arborescence, afin
de simplifier la gestion et la visualisation en utilisant la fonctionnalit Organisation des points dans
le menu.

3.1.5 Monitorage
Vous pouvez surveiller votre systme faons :
Vous pouvez utiliser une liste de surveillance pour crer des listes dynamiques de points qui
afficheront :
Les valeurs, les dates de dernire mise jour, des graphiques de l'historique des donnes (si
l'lment de configuration le permet). Les valeurs, tableaux et graphiques sont mis jour en temps
rel sans avoir rafrachir la fentre du navigateur. Les graphiques de points multiples peuvent
galement tre affiches sur demande

Vous pouvez galement crer des vues graphiques des points en utilisant la fonctionnalit glisser-
dposer pour placer des reprsentations graphiques de points sur un fond arbitraire. Des images
animes peuvent tre utilises pour crer une visualisation trs dynamique du comportement du
systme, et, comme les listes de surveillance, les valeurs sont reprsentes en temps rel sans avoir
besoin de mettre jour le navigateur. Ces vues peuvent tre marques comme "public" afin qu'elles
puissent tre utilises sur les sites Web publics

3.1.6 Contrle

Les contrle des systmes externes peuvent galement tre obtenus pour les points qui peuvent tre
dfinies (criture / lecture). Un point rglable peut tre rgl une valeur dfinie par l'utilisateur,
comme un rglage de thermostat ou un interrupteur de commande d'quipement. Les listes de
surveillance et les vues graphiques fournissent des moyens simples de saisie de valeur dfinir.
.

3.1.7 vnements
Un vnement est l'apparition d'une condition dfinie au sein du systme. Deux types vnements
sont disponibles, ceux dfinis par le systme et ceux dfinis par l'utilisateur. Les vnements
dfinis par le systme comprennent les erreurs de fonctionnement de la source de donnes, les
connexions des utilisateurs, et les dmarrages et arrts du systme. Les vnements dfinis par
l'utilisateur comprennent des dtecteurs dvnement ponctuel (voir dtecteurs vnement ci-

8
dessus), les vnements prvus, et les vnements composs. Il y a aussi des "vnements d'audit",
qui sont dclenchs lorsque les utilisateurs modifient (ajouts, modifications, suppressions) les
sources de donnes, les points de donnes, les dtecteurs vnement ponctuel, les vnements
prvus, les dtecteurs vnements composs, et les gestionnaires d'vnements.

Une fois qu'un vnement a t dtect, il est soumis au gestionnaire. Le gestionnaire d'vnement
permet de dclencher l'action dfinie par l'utilisateur qui doit tre accomplie lors de l'apparition
d'un vnement particulier, comme l'envoi d'un e-mail ou la dfinition de la valeur d'un point
rglable.

3.1.8 Icnes des applications

Source de donnes
Point de donnes
Graphe
Rglage du point
Liste de surveillance
Reprsentation graphique
Actualiser
Dtecteur de valeur
vnement compos
vnement programm
Les gestionnaires d'vnements
Alarme
Utilisateurs
Commentaires des utilisateurs
Rapport
Listes de diffusion
Publication
Avis
Dconnexion

3.1.9 Sons des alarmes

ScadaBR peut mettre des sons lorsque les alarmes sont actives. Par dfaut, les sons d'alarme sont
jous pour les alarmes de scurit, urgentes, critiques et scurit des personnes (mais pas pour les
alarmes d'information), mais les sons de chaque type d'alarme peuvent tre contrls
individuellement. Vous pouvez personnaliser vos alarmes en modifiant les fichiers mp3 suivants:

9
<ScadaBR_home>/audio/information.mp3
<ScadaBR_home>/audio/urgent.mp3
<ScadaBR_home>/audio/critical.mp3
<ScadaBR_home>/audio/lifesafety.mp3

Pour dsactiver un son, supprimez le fichier son associ. Une bibliothque de sons est disponible
dans le dossier <ScadaBR_home> / Audio / lib
.

3.1.10 Images
ScadaBR inclut une petite bibliothque d'images stocke dans le dossier <ScadaBR_home> /
graphics. Chaque sous-dossier contient toutes les images du fichier de dfinition d'image et un
document facultatif nomm info.txt. Ce fichier contient les proprits des attributs suivants (tous
optionnels):

name: Le nom qui sera utilis pour dcrire l'image dans l'interface utilisateur. S'il n'est pas
fourni, la valeurs sera le nom du dossier.

width: La largeur de l'image. Par dfaut, toutes les images sont de la mme taille. S'il n'est
pas renseign, la largeur de la premire image sera utilise
.
height: La hauteur de l'image. Par dfaut, toutes les images sont de la mme taille. S'il n'est
pas fourni, la hauteur de la premire image sera utilise .
text.x: La position du texte sur le bord gauche de l'image en pixels. S'il n'est pas fourni, la
valeur par dfaut est de 5 .
text.y: La position du texte sur la limite suprieure de l'image en pixels. S'il n'est pas fourni,
la valeur par dfaut est de 5 .

Une fois les images utilises dans les vues vous ne devrez plus renommer leur dossier!
Le nom du dossier est utilis en interne comme l'identifiant de la dfinition de l'image. Les
fichiers images sont classes par ordre alphabtique de nom et est sensible la casse. Paires
nom / valeur sont spars par des '='. Les lignes commenant par '#' sont considres
comme des commentaires. Archives "thumbs.db" sont ignors. Les fichiers compresss
(zip, gz, tar, etc) ne peuvent pas tre utilis parce que les fichiers images doivent tre
accessibles par le serveur web. Les paramtres de l'image sont chargs au dmarrage, de
sorte que toute modification ncessitera un redmarrage. Pour enrichir les futures versions
de ScadaBR , vous pouvez envoyer vos propres images au projet ScadaBR.

4 Ajout de sources de donnes et des points de donnes

10
4.1 Exemple de source de donnes virtuelle

Ce chapitre rubrique montre un exemple de cration de sources de donnes et des points de


donnes. Pour des fins d'enseignement, il a cr une Source de donnes virtuelle, cela simule donc
une source de donnes. Dans le menu principal, choisissez Source de donnes .
Slectionnez la liste Type de source de donnes virtuelle et cliquez sur le bouton Ajouter .
Remplissez comme ci-dessous et enregistrez vos paramtres.

Les options pour ajouter des points apparaissent aprs l'enregistrement de la base de donnes.
Cliquez sur Ajouter remplissez comme ci-dessous et enregistrez vos paramtres .

11
Cliquez sur chaque icne de la colonne Statut pour activer les points et sur l'icne .
pour activer la source de donnes

4.2 Exemple Source de Donnes virtuelle Serveur OPC


Dans cet exemple nous utilisons un serveur OPC virtuel ICONICS disponible l'adresse suivante
http://www.iconics.com/Home/Products/OPC-Connectivity/Free-OPC-Tools.aspx
Comme dans l'exemple prcdent, dans le menu principal, choisissez Source de donnes .
Slectionnez dans la liste OPC DA et cliquez sur le bouton Ajouter .

Remplissez les champs de la figure suivante

Le nom de domaine n'est pas renseign, mais le serveur hbergeant le serveur OPC doit
obligatoirement appartenir un domaine
Cliquez sur Actualiser pour faire apparaitre la serveur OPC

12
4.3 Affichage des donnes: listes de surveillance et graphiques

Apres avoir enregistr et activ la source de donnes et les points de donnes, vous pouvez les
visualiser. Dans le menu principal, choisissez la liste de surveillance .
Les points de donnes enregistrs sont sur la gauche. Pour visualiser leurs valeurs, cliquez sur
chacun des point pour les ajouter la liste de surveillance actuelle.

Vous pouvez accder aux informations de chaque point de donnes en cliquant sur l'icne dtail du
point . Cliquez sur l'icne cot de la date du point numrique pour accder a l'historique du
point.

13
Vous pouvez modifier les proprits d'affichage du texte. Dans votre liste de surveillance, cliquez
sur Dtails du point de donnes .
Sur la mme page , cliquez sur Editer le point de donnes .
Dans la zone Format du texte, nous avons diffrentes options d'affichage. Par exemple, avec les
paramtres dans l'image ci-dessous:

N'oubliez pas d'enregistrer

14
Rsultat dans la liste de surveillance

Sans formatage de texte

Avec formatage:

4.4 Dfinition d' vnements

Dans votre liste de surveillance, cliquez sur Dtails du point de donnes .


Sur l'cran suivant, cliquez sur Modifier, diter le point de donne .

Dans la liste des dtecteurs d'vnements, slectionnez limite basse et cliquez sur Ajouter.
Remplissez les champs ci-dessous et cliquez sur le bouton Enregistrer en bas droite de l'cran.

15
Chaque fois que la valeur du point de donnes tombera en dessous du seuil minimum (22) pendant
plus de 5 secondes, une alarme se dclenchera (visible dans le menu Alarme en cliquant sur le
drapeau au milieu de l'cran)

4.5 Reprsentations graphiques

Pour crer des visualisations plus labores des donnes, nous pouvons construire des
"Reprsentations graphiques". Dans le menu principal, choisissez Vues graphiques .
Cliquez sur Nouvelle vue .
Entrez le nom de la nouvelle vue, slectionnez l'image de fond l'aide du bouton Parcourir,
puis cliquez sur Charger image.

Dans la liste Composants, slectionnez simple point et cliquez sur Ajouter un composants la vue
.

Le nouveau composant apparait au milieu du cadre de la vue

Sans l'image de fond.


Remarquez bien que chaque nouveau composant est ajout au centre de la vue.

16
Avec l'image de fond.
Vous remarquez au centre de limage le composant

Survolez le composant ajout sur la figure et cliquez sur la deuxime option: Editer les
composants de ce point.

17
Remplissez les champs (seul le champ Point est obligatoire ) et cliquez sur la disquette pour
enregistrer.

Ajouter d'autres composants, associs les aux points de la source donnes et disposez les sur
la vue. Cliquez sur le bouton Enregistrer en bas de l'cran
.

18
5 Utilisateurs

5.1 Cration d'un utilisateur


Dans le menu cliquez sur l'icne utilisateurs

Cas d'un utilisateur en lecture seulement.


L'utilisateur ne pourra consulter uniquement les vues et les listes de surveillance pour
lesquelles on lui aura accord un partage. Il pourra consulter ou recevoir uniquement les
rapports dont il est destinataire.

Dans l'image suivante l'utilisateur n'a accs aucune source de donnes. Mais pourra
consulter les valeurs de la source de donnes Maison.

19
Menu d'un utilisateur avec droits restreints

20
5.2 Partages avec un utilisateur

Partage d'une vue


Cliquez sur Editer la vue

Dans la fentre partage, cliquez sur ajouter

Slectionnez le type d'accs

N'oubliez pas d'enregistrer (bouton en bas de page)

21
6 Rapports

6.1 Introduction

ScadaBR inclut un gnrateur de rapport comparable tous les gnrateurs de rapports de grands
logiciels. Dans cette section, nous allons voir deux faons de gnrer des rapports de ScadaBR.

6.2 Gnration de rapports dans ScadaBR

6.2.1 Cration d'un nouveau modle de rapport

Dans le menu principal, cliquez sur l'icne Rapports .


Les modles de rapport vous assistent dans la faon de crer des nouveaux rapports.

Pour ajouter un nouveau modle de rapport, cliquez sur Nouveau rapport .

Sur cet cran, vous devez dfinir les critres du rapport:

Le nom du modle est utilis comme rfrence visuelle du modle. Il est recommand d'utiliser un
nom unique pour chaque modle.

Utilisez la liste des points de donnes pour slectionner les points inclure dans le rapport. Pour
ajouter des points de donnes, slectionnez le point dsir sur la liste et cliquez sur l'icne Pour
supprimer un point existant, cliquez sur l'icne associe au point.
Dterminez la plage de valeurs de dates.

6.2.2 Planification des rapports

Les rapports peuvent tre gnrs automatiquement. Utilisez la slection Lancer chaque.... Un
dlai d'excution peut tre appliqu si les donnes attendues pour le rapport ont tendance tre
recueillies aprs le dlai d'excution du rapport.

6.2.3 Envoi de rapport par mail

22
Les rapports ne peuvent pas tre partags directement par le systme mais il est possible de crer
une liste de diffusion d'e-mails. Les destinataires recevront alors les rapports gnrs. Le contenu
de ce courriel correspond la fentre du navigateur "reportChart". Pour inclure le fichier
d'exportation des donnes au format CSV dans l'e-mail, cochez la case Inclure la table de
donnes.
Slectionner les destinataires e-mail laquelle envoyer l'e-mail avec le rapport. Les bnficiaires
peuvent tre des listes de diffusion, les utilisateurs ou les adresses e-mail indique. Cliquez sur
l'icne Courrier lectronique test pour envoyer un message de test aux destinataires
slectionns.
Important: Les instances de rapports envoys par e-mail sont automatiquement supprims aprs
avoir t envoys .

23
6.2.4 Gestion des modles

Pour enregistrer un modle de rapport cliquez sur l'icne dans le panneau en haut droite de la
modlisation. Pour supprimer un modle existant, cliquez sur l'icne .Pour gnrer
immdiatement un rapport partir d'un modle, cliquez sur "Excuter maintenant". Notez que
certains modles peuvent comprendre des rapports d'une grande quantit d'informations et parce
qu'il peut prendre un certain temps tre gnr. Ainsi, tous les rapports sont gnrs de manire
asynchrone partir de l'interface utilisateur.

Couleur:C'est la couleur prise en compte dans la gnration des graphiques du rapport vous pouvez
utiliser aussi toute la palette des codes couleur HTML
Exemple: #00F431

6.2.5 Files de rapport

Elle contient tous les rapports , de l'utilisateur connect. Cette liste n'est pas mis jour
automatiquement. Une mise jour peut tre demande en cliquant . Les colonnes de la liste
sont les suivantes:
Nom du rapport: C'est celui du modle de rapport. Une fois le rapport gnr, son nom ne
change plus, mme si vous modifiez le nom du modle.
Date d'excution: Date de demande du rapport .
Dure d'excution: Dure d'excution du rapport en ms.
De: Dbut de la priode concerne par les donnes du rapport.
A: Fin de la priode concerne par les donnes du rapport.
Enregistrement: Nombre total d'enregistrements du rapport.
La case Ne pas purger permet d'viter la destruction de rapports importants (voir la documentation
"Autres paramtres" pour plus d'informations sur le processus d'limination de rapports).
Cette fonction ne doit tre utilise que lorsque cela est strictement ncessaire, puisque le
conservation des rapports peut occuper des quantits considrables de stockage.

24
La dernire colonne du tableau fournit des commandes pour la gestion des instances. L'icne
tlcharge un fichier CSV avec les donnes du rapport pour l'importation dans un tableur. L'icne
ouvre une nouvelle fentre de navigateur comprenant l'affichage des informations de l'instance
de rapport, des statistiques et des graphique des donnes du rapport. En cliquant sur l'icne ,
l'instance du rapport est supprim. A signaler que suivant les cas le temps de suppression peut-tre
particulirement important.

25
7 Scripts

7.1 Introduction

Pour crer des scripts de ScadaBR, nous allons utiliser une source de donnes Meta Data
( mtadonnes). elle tire son nom de sa capacit combiner des donnes existantes pour en crer
des nouvelles. Plus de fonctionnalits des scripts de ScadaBR, sont disponibles dans le menu Aides.
Voici un exemple de cration d'un script de base
.

7.2 Cration de la source de donnes et des points.

Dans cet exemple, nous crons une source de donnes virtuelle: Maison et 9 points de donnes:
pluie, climat, dshumidificateur, humidit, chemine, lumire, soleil, temprature et ventilateur
.

Source de donne Maison

(Voir chapitre 4-1 Exemple de source de donnes virtuelle pour crer la source)

26
Point de donne Pluie

Point de donne Climat

27
Point de donne Dsumidificateur

Point de donne Humidit

28
Point de donne Chemine

Point de donne Lumire

29
Point de donne Soleil

Point de donne Temprature

30
Point de donne Ventilateur

7.3 Cration d'une source de donnes Mta et ses points

Maintenant, nous ajoutons les scripts. Pour cela, ajoutez une source de donnes Mta Scripts et 5
points de donnes: Script_Climat, Script_Dsumidificateur, Script_Chemine, Script_Lumire et
Script_Ventilateur.

31
Script_Climat

Dans le Type de donnes, slectionnez alphanumrique. Dans contexte script, choisissez les points
de donnes de la source Maison - Temprature et Humidit puis cliquez sur l'icne pour les
ajouter au script. Dans la colonne var, vous slectionnez le nom sous lequel le point de donnes
sera rfrenc dans le script. Dans cet exemple, nous avons dfini humi_var temp_var pour
temprature et humidit.

Dans la fentre Script entrez le code de script suivant :


a = "Climat Chaud et humide";
b = "Climat Chaud et Sec";
c = "Climat Froid et humide";
d = "Climat Froid et Sec";
e = "Climat Actuel";
if (temp_var.value > 25 && humi_var.value > 80 )
e = a;
if (temp_var.value > 25 && humi_var.value < 80 )
e = b;
if (temp_var.value < 25 && humi_var.value > 80 )
e = c;
if (temp_var.value < 25 && humi_var.value < 80 )
e = d;
return e;

32
Script_Dshumidificateur

Dans le Type de donnes, slectionnez Binaire. Dans contexte script, choisissez le point de donnes
Humidit de la source maison et cliquez sur l'icne pour l'ajouter au script. La variable
humi_var reprsente la valeur du point de la colonne var.

Dans la fentre Script entrez le code de script suivant :


if(humi_var.value > 80)
return true;
return false;
Script_Chemine

33
Dans le Type de donnes, slectionnez Binaire. Dans contexte script, choisissez le point de donnes
Temprrature de la source Maison et cliquez sur l'icne pour l'ajouter au script. La variable
temp_var reprsente la valeur du point de la colonne var.

Dans la fentre Script entrez le code de script suivant :


if(temp_var.value < 10)
return true;
return false;

34
Script_Lumiere

Dans le Type de donnes, slectionnez Binaire. Dans contexte script choisissez le point de donnes
Soleil de la source Maison et cliquez sur l'icne pour l'ajouter au script. La variable sol_var
reprsente la valeur du point de la colonne var.

Dans la fentre Script entrez le code de script suivant :

if(sol_var.value == false)
return true;
return false;

35
Script_Ventilateur

Dans le Type de donnes, slectionnez Binaire. Dans contexte script , choisissez le point de
donnes Temprrature de la source Maison et cliquez sur l'icne pour l'ajouter au script. La
variable temp_var reprsente la valeur du point de la colonne var.

Dans la fentre Script entrez le code de script suivant :

if(temp_var.value > 25 )
return true;
return false;

7.4 Cration de liaisons de point

Les liaisons de point sont utilises pour mettre jour les points cibles bass sur la valeur des points
sources. Elles veillent "synchroniser" deux points, selon une formule de transformation
optionnelle qui peut tre dfinie. En pratique, une liaison de point peut tre utilis pour lire les
valeurs d'un systme (d'une ou plusieurs sources de donnes) et les affecter immdiatement un
autre systme ( une ou plusieurs sources de donnes).
On a ajout 5 points Liens, un pour chaque script, par exemple, pour Climat et Script_Climat"

36
NOTE: Pour tous les liens entrez le code suivant dans la fentre Script:

Aprs avoir tout ajout la page Liaisons de Point doit ressembler ceci:

Ensuite il suffit d'ajouter les points dans une liste de surveillance et vrifier que les changements
d'tats de certains points affectent les autres points de donnes.

37
8 Watchdog

8.1 Fonctionnement

Watchdog (chien de garde) permet de vrifier priodiquement l'tat de ScadaBR par la mthode
getStatus de l' API SOAP. Si status indique une dfaillance, le systme va redmarrer Tomcat afin
de la corriger.
Watchdog se termine aprs un nombre spcifi de tentatives conscutives de redmarrer Tomcat.
Note: Si le systme d'exploitation de la machine est Microsoft Windows, vous devez dfinir la
variable d'environnement CATALINA_HOME, qui pointe vers le rpertoire de ScadaBR. Par
exemple, si ScadaBR est install dans le dossier C:\\program file\ScadaBR la variable
CATALINA_HOME serait dfinie comme suit:
Set CATALINA_HOME = C:\\program file\ScadaBR

8.2 Configuration

Pour configurer Watchdog, il faut modifier le fichier config.properties. Tous les paramtres ont
des valeurs par dfaut qui seront utilise si le fichier ou les paramtre en question ne sont pas
spcifis.

api.address: Adresse API ScadaBR .


catalina.home:Dossier d'installation de Tomcat pour ScadaBR. S'il n'est pas renseign,
Watchdog va utiliser la variable d'environnement CATALINA_HOME (si dfinie).
watchdog.period: Frquence d'activit de Watchdog pour vrifier l'tat de ScadaBR. Sa
valeur minimale est de 30 secondes et sa valeur par dfaut est 60 secondes.
watchdog.retries: Nombre maximum de tentatives conscutives de Watchdog pour
redmarrer Tomcat afin de relancer ScadaBR .
watchdog.fileLogging: paramtre d'activation du fichier log.txt.

8.3 Excution

Avec l'installateur de ScadaBr :


Le fichier se trouve dans le rpertoire C:\Program Files\ScadaBR, pour le lancer excutez la
commande :
java jar watchdog.jar
Sans l'installateur de ScadaBr :
Suivez les tapes dans le manuel d'installation ScadaBR (dtailles au paragraphe 2.2. ScadaBR
Installation manuelle) et dfinissez la variable d'environnement CATALINA_HOME. Dans le
dossier d'installation de ScadaBR se trouve le fichier watchdog.jar le fichier. Pour le lancer,
excutez:

java jar watchdog.jar

38
9 Conseils
9.1 Changer de base de donnes

Actuellement ScadaBR supporte deux systmes de gestion de base de donnes: MySQL et Derby.

Le fichier ScadaBR.war livr en standard est configur pour Derby, base de donne plus faciles
pour l'utilisateur, car intgre d'origine, elle ne ncessite pas l'installation du SGBD ou la
configuration des paramtres tels que login et mot de passe.

Le changement de base de donne est prvu au cours de l'installation, cependant, si ncessaire,


vous pouvez les modifier d'une manire diffrente partir du fichier war disponibles:

Dcompressez le fichier ScadaBR.war dans un rpertoire <scadabr>. (Vous pouvez renommer le


fichier en ScadaBR.zip puis l'extraire, si dsir). Ouvrez avec un diteur de texte le fichier:

<scadabr>/WEB-INF/classes/env.properties et le modifier comme vous le souhaitez:

MySQL*:
db.type=mysql
db.url=jdbc:mysql://localhost/scadabr
db.username=root
db.password=
db.pool.maxActive=10
db.pool.maxIdle=10

* Attention: Pour utiliser MySQL, une base de donnes nomme "scadabr" doit tre cre avant
de lancer ScadaBR. (Seules les tables sont cres automatiquement par le systme)

Derby (standard):
db.type=derby
db.url=<rpertoire de la base de donnes>**
db.username=
db.password=

** Le dossier dans lequel la base de donnes sera installe. Cela peut tre un chemin relatif,
comme:
../scadabrDB/.

Enregistrez le fichier, compresser l'intgralit du dossier dans un fichier nouveau <scadabr>


ScadaBR.war et effectuer l'installation

39