Sie sind auf Seite 1von 70

1.2.

Applicom: Paramtrage de la carte APPLICOM


Paramtrer la carte : Adresse mmoire utilise, ligne IRQ, ...

E. Protocoles

en faisant attention viter tout conflit avec d'autres priphriques dj installs sur votre ordinateur. Se rfrer la documentation APPLICOM.

Dclarer grce au programme PCCONF les paramtres des


ports APPLICOM utiliss.

Ne pas crer de requtes cycliques.

Rvisions 01/09/2006 19/10/2006

Auteur MB MB Document initial version 4.0 Ajout paramtres modem CXR AJ2885P pour SOFREL

1.3. Applicom: Cration d'un port logique


Dans TOPKAPI Vision en mode configuration, crer un "port" comme indiqu ci-aprs. Ce "port" est le support du protocole d'change avec la carte APPLICOM, et non pas le port de la carte APPLICOM utilis pour communiquer avec les quipements. Noter que certaines des manipulations qui suivent ne sont possibles que si la carte APPLICOM est physiquement installe sur votre PC. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port.

1. Pilote APPLICOM
1.1. Applicom: Prsentation gnrale

Le pilote DLL APPLICOM (APLDRV32.DLL) permet TOPKAPI Vision de dialoguer avec une ou plusieurs cartes APPLICOM fournies avec une librairie dynamique d'change de donnes sous Windows. Les cartes APPLICOM possdent leur propre processeur, qui prend en charge la scrutation des quipements pour ne signaler au superviseur que les variations de donnes. Les changes par DLL sont assurs de faon beaucoup plus performante que par la liaison d'un canal DDE. Le pilote TOPKAPI/APPLICOM est le mme quels que soient les protocoles supports par la carte APPLICOM, et les considrations qui suivent sont valables pour tous les protocoles. Se rfrer la notice APPLICOM pour les particularits d'adressage propres chaque pilote.

Modes d'adressage dans TOPKAPI Vision


Deux modes d'adressage sont possibles pour les variables dans TOPKAPI Vision:

Mode adressage physique : dans ce mode, les adresses des


variables dans TOPKAPI Vision (images mmoires des quipements connects) sont les adresses physiques (celle de l'automate) dans les quipements. C'est le mode le plus courant. Numro de port : numro de la carte APPLICOM. Il sera interdit d'utiliser le ou les port(s) correspondant(s) pour la carte modem du module d'astreinte TOPKAPI Vision. Afin de permettre l'utilisation d'une carte en mme temps que le port COM1, par exemple, le numro saisi ici est trait modulo 8, c'est dire que vous pouvez saisir 1 ou 9 pour la carte n1, ou bien 2 ou 10 pour la carte n2, etc. Attention: en mode 16 bits, ou seules 4 cartes pouvaient tre installes, le numro du port dclar ici devait correspondre au numro de la carte modulo 4 et non pas 8. Protocole : APLDRV32: Pilote APPLICOM Sous protocole : PHYSIQUE ou DATABASE selon votre prfrence.

Mode adressage database APPLICOM : dans ce mode,


les adresses des variables dans TOPKAPI Vision sont les adresses de la database APPLICOM. Les deux modes sont extrmement proches dans leur principe, aucun n'impose de paramtrage plus complexe que l'autre, seul importe le choix que vous faites d'adresser les variables TOPKAPI Vision par leur adresse physique ou leur adresse database. Le paramtrage dans TOPKAPI Vision des requtes de lecture d'informations, qui sont transformes en ordres de scrutation cyclique sur les cartes APPLICOM, doivent de toute faon spcifier la fois l'adresse physique (automate) et l'adresse database des informations lues.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-1

1.4.

Applicom: Cration d'un automate

Dans le configurateur de TOPKAPI Vision, crer au moins un automate sur le port, et ventuellement des requtes de lecture / criture sur cet automate. Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Suivant le mode d'adressage choisi, le paramtrage pourra tre diffrent :

Applicom: Organisation de la database APPLICOM


La database est forme par deux zones de mmoire interne la carte APPLICOM (une pour les bits, une pour les mots) dans lesquelles sont stockes les informations lues dans les quipements. Chaque automate se voit attribuer une ou plusieurs zones dans cette database, qui ne doivent pas se chevaucher sous peine de voir les informations de la zone de chevauchement crites une fois par les donnes du premier automate, une autre fois par les donnes du second automate. L'attribution des zones aux automates n'est pas automatique: il faut au niveau de chaque requte spcifier l'adresse de lecture des donnes de l'automate concern, et l'adresse database o ces donnes seront ranges. Deux champs dans le paramtrage d'une requte TOPKAPI Vision permettent la saisie de ces deux informations: les champs Dbut et Adresse physique. Suivant le mode d'adressage slectionn sur le port, leur signification est simplement change, sachant que le champ dbut dterminera toujours l'adresse dans TOPKAPI Vision des informations lues. Exemple: Deux automates sont relis au rseau. Chaque automate possde une table de bits accessibles aux adresses 0 1000 et de mots accessibles aux adresses 200 400. On pourra paramtrer dans TOPKAPI Vision les requtes suivantes:

Paramtrage des automates en mode d'adressage physique


Numro d'esclave Numro d'esclave de l'automate. Ce numro est pris par dfaut, lors de la cration des requtes de lecture / criture vers les quipements. Accs Saisir le caractre % suivi du numro de canal 0 3 pour la carte 1, 4 7 pour la carte 2, etc. Zone mots 1 ou 2 Exprime en adresses physiques des quipements. Zone bits 1 ou 2 Exprime en adresses physiques des quipements.

Paramtrage des automates en mode d'adressage database APPLICOM


Numro d'esclave Numro d'esclave de l'automate. Ce numro est pris par dfaut, lors de la cration des requtes de lecture / criture vers les quipements. Accs Saisir le caractre % suivi du numro de canal 0 3 pour la carte 1, 4 7 pour la carte 2, etc. Zone mots 1 ou 2 Exprime en adresses rserves aux quipements dans la database APPLICOM. Zone bits 1 ou 2 Exprime en adresses rserves aux quipements dans la database APPLICOM.

API 1 : 1000 bits, adresse dbut 0, adresse database


5000

API 1 : 100 mots, adresse dbut 200, adresse database


5000

API 1 : 100 mots, adresse dbut 300, adresse database


5100

API 2 : 1000 bits, adresse dbut 0, adresse database


7000

API 2 : 100 mots, adresse dbut 200, adresse database


6000

API 2 : 100 mots, adresse dbut 300, adresse database


6100 On a rserv pour les bits de l'automate 1 les adresses bits database 5000 et plus, pour les mots les adresses mots database 5000 et plus, pour les bits de l'automate 2 les adresses bits database 7000 et plus, et pour les mots les adresses mots database 6000 et plus. On se donne suffisamment de marge pour viter tout risque de recouvrement entre les diffrentes zones.

1.5.

Applicom: Cration des requtes

La cration des requtes dpend du mode d'adressage utilis: on utilisera le mode d'adressage physique pour accder dans TOPKAPI Vision aux variables par leurs adresses automates, et le mode d'adressage database pour accder dans TOPKAPI Vision aux variables par leurs adresses dans la database APPLICOM. Dans les deux cas, aucun paramtrage des cartes APPLICOM (en dehors de l'installation physique des cartes et de la dclaration des paramtres de communication) n'est faire: toutes les informations concernant le rseau d'automates et l'organisation de la database sont fournies par TOPKAPI Vision. Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte.

Page E-2

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

DATA-BASE API 1
1000 bits 0 400 200 MOTS 5000 5400 6000 6400

Numro de l'esclave (si 0, on prend le numro d'esclave de l'automate, voir 3.4) Actif Oui pour rendre active la requte, non pour l'inhiber temporairement Priode En multiples de 100 ms. Une valeur nulle indique une scrutation aussi rapide que possible.

mots

API 2
1000 bits 0 400 200

BITS 5000 6000 7000 8000

Applicom: Principe de fonctionnement


Il est inutile de configurer des requtes cycliques via APPLICOM. Chaque requte active est utilise :

mots

pour crer une fonction cyclique dans la carte APPLICOM


(fonction CREATECYC)

pour crer une zone de consignation d'vnements (fonction

Applicom: Paramtrage des requtes en mode d'adressage physique


Longueur Longueur de la table lire Dbut Adresse automate du dbut de la table lire, et adresse d'criture dans TOPKAPI Vision Adresse physique Adresse o seront stockes les informations dans la database APPLICOM. Codage Standard Code fonction L'une des fonctions dcrites dans le paragraphe Fonctions de lecture utilisables Origine Numro de l'esclave (si 0, on prend le numro d'esclave de l'automate, voir 1.4) Actif Oui pour rendre active la requte, non pour l'inhiber temporairement Priode En multiples de 100 ms. Une valeur nulle indique une scrutation aussi rapide que possible.

CONFDB) en fonctions des paramtres (adresses automate, adresse database, longueur, type) spcifique la requte. Le mode d'adressage (physique ou database) ne change rien au principe de fonctionnement de la carte, modifiant seulement l'adressage dans TOPKAPI Vision . TOPKAPI Vision effectue des lectures du FIFO d'vnements, et range les valeurs obtenues dans l'image mmoire des quipements, provoquant des recalculs vnementiels du tableur; Sur mise hors / en service d'un "automate" au sens TOPKAPI Vision (case cocher dans la bote de dialogue AUTOMATE, fentre d'acquisition), les fonctions cycliques sont dsactives / actives. Sur mise hors / en service d'un "port" au sens TOPKAPI Vision (case cocher dans la bote de dialogue PORT, fentre d'acquisition), les fonctions cycliques sont supprimes / cres, ce qui revient mettre hors service tous les quipements connects ce port.

Applicom: Fonctions de lectures utilisables


TOPKAPI Vision supporte les fonctions de lectures dcrites cidessous. Consulter la documentation APPLICOM pour vrifier les requtes disponibles en fonction du protocole utilis. Pour chacune des requtes 4099 4104, TOPKAPI Vision cre la fonction cyclique et consigne la zone de la database APPLICOM, afin d'tre automatiquement averti des variations des donnes correspondantes.

4099: 4100:
syntaxe #B)

Lecture de bits (adressables par la syntaxe #B) Lecture de bits d'entre (adressables par la Lecture de mots (adressables par la syntaxe

Applicom: Paramtrage des requtes en mode d'adressage database APPLICOM


Longueur Longueur de la table lire Dbut Adresse o seront stockes les informations dans la database APPLICOM., et adresse d'criture dans TOPKAPI Vision Adresse physique : Adresse automate du dbut de la table lire Codage Standard Code fonction L'une des fonctions dcrites dans le paragraphe Fonctions de lecture utilisables Origine TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

4101:
#M ou #W)

4102: 4103:

Lecture de mots d'entre (adressables par la syntaxe #M ou #W) Lecture de mots doubles (adressables par la Lecture de flottants (adressables par la syntaxe syntaxe #E)

4104:
#F)

Pour les trois fonctions ci-dessous, TOPKAPI Vision consigne simplement certaines zones de la database APPLICOM, sans crer de requte cyclique. Le rafrachissement des informations des zones consignes doit donc tre assur soit par un paramtrage de la carte APPLICOM (fonctions cycliques, calculs spciaux), soit Page E-3

par un autre systme qui viendrait crire les zones correspondantes (routage, carte esclave).

TEMPS_AV_INIT= <dure en millisecondes> du fichier TOPKAPI.INI. Ce dlai doit tre suffisant pour que la carte puisse avoir effectu un rafrachissement complet de sa database, et dpend donc du nombre d'informations lues, du nombre d'automates connects, de la vitesse de transmission etc. Une valeur trop courte peut entraner l'existence dans TOPKAPI Vision de valeurs initiales incorrectes. Une valeur trop grande ne peut a priori pas poser de problme autre que de retarder inutilement l'affichage des valeurs courantes au lancement de TOPKAPI Vision.

Lecture de bits database (adressables par la syntaxe #B) Lecture de mots database (adressables par la syntaxe #M ou
#W)

Lecture de mots doubles database (adressables par la


syntaxe #E)

Applicom: Fonctions d'criture


Les critures dans TOPKAPI Vision sont gnres automatiquement par les fonctions TELEC(). Le pilote APLDRV transcrit ces fonction en ordres WRITEBIT ou WRITEWORD donnes la carte APPLICOM. Pour crire des valeurs entires, on utilisera une fonction TELEC(,,XX#Madresse). Pour crire des valeurs relles, on utilisera une fonction TELEC(,,XX#Fadresse), le type de la cellule tant obligatoirement rel.

1.6.

Applicom: Fonction COUPURE()

TOPKAPI Vision rcupre les comptes rendus des changes effectus par la carte APPLICOM pour grer la fonction COUPURE(), qui passe 1 ds qu'un statut d'erreur est rendu pour une requte, et 0 sur retour la normale de la communication.

Adresse utiliser en mode d'adressage physique


En mode d'adressage physique, l'adresse utilise dans le dernier terme de la fonction TELEC() devra tre l'adresse physique d'criture dans l'automate.

Adresse utiliser en mode d'adressage database


En mode d'adressage database, l'adresse utilise dans le dernier terme de la fonction TELEC() devra tre l'adresse database de l'information crire. Comme la carte APPLICOM utilise obligatoirement une adresse physique lors d'une criture dans l'automate, TOPKAPI Vision doit tablir la correspondance entre l'adresse database spcifie dans la fonction TELEC() et l'adresse physique utilise par la carte APPLICOM. Pour cela, TOPKAPI Vision va rechercher parmi les requtes de lecture configures une requte recouvrant l'adresse database crire. Si une telle requte est trouv, TOPKAPI Vision va en dduire l'adresse physique correspondante. Si une telle requte n'existe pas, la fonction d'criture va chouer. Exemple Une requte de lecture comporte les paramtres suivants:

Adresse dbut 5000 Adresse physique 123500 Longueur 100


Si l'on veut effectuer une tlcommande vers l'adresse automate 123510, il faudra utiliser une fonction TELEC() vers l'adresse database 5010. En effet, l'adresse physique 123500 correspond l'adresse database 5000, en fonction de la requte de lecture dfinie ci-dessus. Donc l'adresse physique 123510 correspond l'adresse database 5010.

Applicom: Rafrachissement initial des valeurs dans TOPKAPI Vision


Lorsque TOPKAPI Vision a termin de crer les requtes de scrutation cyclique et de consignation dans la carte APPLICOM, il positionne un temps d'attente au bout duquel il effectue une lecture complte de la database afin d'initialiser correctement ses images mmoire. Le dlai au bout duquel cette lecture est effectue est de 2 secondes par dfaut, et est rglable par la ligne [APLDRV] Page E-4 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Windows NT/2000/XP

2. Pilote FIPWAY / ETHWAY


2.1. Fipway/Ethway: Prsentation

Windows NT/2000/XP
Il est impratif d'utiliser la librairie SCHNEIDER rfrence YCCFPWPCV1 (pour FIPWAY) ou YCCETHPCV1 (pour ETHWAY) et de slectionner dans TOPKAPI le pilote LIBWAY32. L'utilisation de FIPWAY ncessite l'installation dans le PC de la carte coupleur TSXFPC10M et son driver. L'utilisation d'ETHWAY ncessite l'installation dans le PC de la carte coupleur TSXETHPC10M et de son driver. Dans la suite de cette notice, nous ferons systmatiquement rfrence au pilote TOPKAPI Vision sous le nom XWAY.

Limitations
Le protocole XWAY de TOPKAPI Vision ne supporte pas:

Protocole Pilote LIBWAY32 Sous protocole FIPWAY, ETHWAY Retard l'mission Dlai en millisecondes respecter entre chaque requte. Traitement automate Une valeur de l'ordre de 1000 2000 millisecondes est raisonnable, mais peut tre augmente si besoin. En service Si cette case n'est pas coche, TOPKAPI Vision ne dialoguera pas. Configuration Accde la bote suivante:

Les donnes non sollicites Les requtes de lecture ou d'criture de la part d'une autre
station

2.2. Fipway/Ethway: Installation de la carte et du pilote Tlmcanique


Windows NT/2000/XP
Procder l'installation de la carte coupleur TSXFPC10M pour FIPWAY, ou de la carte coupleur TSXETHPC10M pour ETHWAY, et installer le driver correspondant. Procder ensuite l'installation de la librairie rf. YCCFPWPCV1 ou YCCETHPCV1.

Fipway/Ethway: Configuration FIPWAY / ETHWAY


Cette bote de dialogue permet de configurer les informations spcifiques au protocole FIPWAY ou ETHWAY:

2.3.

Fipway/Ethway: Cration d'un port

Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Crer un port sur lequel seront rattachs les automates dclars dans TOPKAPI Vision. Utiliser de prfrence un numro de port inexistant sur votre machine, avec les paramtres suivants:

Mode d'adressage (XWAY ou FIPIO) Pour chaque automate du rseau, adresse rseau: n de rseau: Numro du rseau auquel appartient
l'automate

n de station: Numro de l'quipement sur le rseau n de porte: Identification des entits logiques de la
station. Utiliser gnralement la valeur 0, ou 5 si vous voulez utiliser l'automate comme une passerelle vers un rseau Unitelway. Pour un adressage XWAY

n de module: Si le numro de porte est 5, emplacement


gographique du coupleur dans l'automate

n de voie: Numro d'une entit logique du coupleur ou


adresse d'un esclave UNITELWAY + 100 Pour FIPWAY Pour un adressage FIPIO

Slecteur: Slecteur de voie de communication intrastation

Rf. interne: Si la porte est gale 9, il s'agit d'une


adresse logique TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-5

Rf. logique: Nombre de canaux par API: le pilote de protocole XWAY


offre la possibilit de communiquer simultanment sur plusieurs canaux (1 4) vers le mme automate, ce qui acclre les changes. Choisir une valeur 1 pour dbuter. Augmenter ensuite tant que l'automate arrive traiter les demandes du superviseur dans un mme cycle programme. Le rglage optimal dpend principalement du type d'automate connect, de sa charge processeur, et de la longueur des requtes utilises.

Le bouton Spcifique permet de paramtrer l'adresse complte de l'automate:

L'option Mettre jour l'image mmoire aprs une


tlcommande, coche par dfaut, indique si l'information tlcommande doit tre mise jour dans TOPKAPI Vision ds que la tlcommande a t accepte, ou bien s'il faut attendre une requte de lecture de la zone correspondante pour mettre jour l'image mmoire TOPKAPI Vision. Ceci est indispensable si l'adresse de lecture d'une information est diffrente de son adresse d'criture.

L'option Gnrer fichier XWAY.LOG permet de gnrer


dans le rpertoire de l'application un fichier XWAY.LOG contenant les informations changes entre TOPKAPI Vision et les autres automates. Les adresses XWAY Rseau et Station de la carte TSXFPC10 ou TSXETHPC10 sont dfinies lors de l'installation du driver FIPWAY ou ETHWAY.

Les informations d'adressages sont dcrites au niveau du paramtrage des options du port.

2.5. Fipway/Ethway: Requtes de lecture


Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte. Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares cidessus. Les paramtres de chaque requte sont: Repre Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire. Il est impratif de respecter les contraintes lies aux quipements relis (lecture de mots limite 60 mots, ou 496 bits). Dbut Adresse de rangement informations lues. dans TOPKAPI Vision des

2.4. Fipway/Ethway: Cration d'un automate


Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Crer un automate sur le port ci-dessus. Utiliser les paramtres suivants:

Adr. physique Adresse physique de dbut de lecture dans l'automate. Codage Standard. Code fonction Type de lecture, parmi

Numro d'esclave Numro d'esclave paramtr dans l'automate. L'adresse rseau complte devra tre paramtre depuis la bote accessible par le bouton Spcifique ou depuis la bote de Configuration... du port sur lequel est rattach l'automate Type automate Utiliser de prfrence un type STANDARD, les types prdfinis correspondants aux espaces adressables de versions anciennes des TSX et tant de ce fait gnralement trop restrictifs. Ces types ne sont conservs que par compatibilit ascendante. Page E-6

54: Lecture de n bits Active Slectionner Non pour invalider temporairement la requte. Priode Priode d'excution de la requte, en secondes. Heure action Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM.

2: Lecture 16 bits E/S 4: Lecture d'un mot 54: Lecture de n mots

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Fipway/Ethway: Lecture de valeurs relles IEEE


En plus des requtes spcifies, la fonction 54 (lecture de n mots) peut recevoir comme type de codage le type rel auquel cas la requte interprte les valeurs reues comme des rels au format IEEE. Les rels tant stocks sur 32 bits le nombre de mots lus devra tre pair. Les rels sont accessibles dans une formule TOPKAPI Vision par la syntaxe #Fxxx (exemple: #F100 pour le rel d'adresse 100).

2.6.

Fipway/Ethway: Requtes d'criture

Les requtes d'criture sont gnres automatiquement par TOPKAPI Vision lors d'une tlcommande. Les fonctions employes sont:

16: Ecriture d'un bit. 20: Ecriture d'un mot 55: Ecriture de n mots, uniquement pour l'option recettes
de TOPKAPI Vision, les tlcommandes de ou de rels. long

Ecriture d'un mot double


Utiliser la syntaxe TELEC( , ,#Exxx) dans une cellule de type entier long.

Ecriture d'un rel IEEE


Utiliser la syntaxe TELEC( , ,#Fxxx) dans une cellule de type rel.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-7

3. Pilote JBUS/MODBUS
3.1. Modbus: Prsentation

Indique le temps pendant lequel TOPKAPI Vision attend la rponse une requte, en plus du temps ncessaire la transmission des informations. Une valeur de l'ordre de 1000 millisecondes est raisonnable, mais peut tre augmente si ncessaire. Une valeur trop grande n'a aucune incidence sur la rapidit d'acquisition. En service Cocher cette case pour valider l'acquisition sur le port, sinon aucun dialogue n'aura lieu. Format des donnes A choisir en fonction de ce qui a t paramtr dans les automates Configuration ... Ce bouton permet de paramtrer certaines informations complmentaires

Le protocole Jbus/Modbus implment dans TOPKAPI Vision permet de dialoguer en tant que matre sur un rseau Jbus / Modbus en tant connect directement sur un port du PC superviseur, au besoin via une interface RS232 - RS 485. Le protocole Jbus/Modbus esclave n'est pas support, et ncessite l'utilisation d'une carte APPLICOM, par exemple. Modbus est une marque dpose de MODICON. Jbus est une marque dpose d'APRIL.

3.2.

Modbus: Cration d'un port

Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port.

Numro du port Le numro de port logique devra tre celui du port COM utilis pour la communication Protocole JBUS/MODBUS 32 Sous protocole Matre Retard l'mission Certains protocoles ncessitent un temps de retournement non nul entre l'mission d'une trame et la rception de la trame suivante. On observe sinon des coupures intermittentes de liaison. Indiquer ici une valeur en nombre de caractres ( calculer en fonction de la vitesse et du format des donnes). La formule donnant la correspondance entre le nombre de caractres et un temps en secondes sera Temps = (Nb car)*(1+bits donnes+bits parit+bits stop) Vitesse Traitement automate Gnrer fichier JBUS.LOG Permet de gnrer dans le rpertoire de l'application un fichier nomm JBUS.LOG contenant les trames changes Mettre hors service l'quipement Permet de mettre hors service l'quipement en cas de coupure de liaison. Il faut prvoir dans ce cas une fonction systme qui remettra l'quipement en service, sous peine de dfinitivement couper la scrutation de ce dernier. Suspendre l'quipement Permet d'indiquer un dlai en secondes pendant lequel l'quipement ne sera plus scrut suite une coupure de liaison. Ceci permet d'viter de perdre trop de temps

Page E-8

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

chercher scruter indisponible.

un

quipement

momentanment

gnralement trop restrictifs. Ces types ne sont conservs que par compatibilit ascendante.

Relire l'tat d'un automate aprs une tlcommande Cette option permet de rendre prioritaire les requtes d'un automate aprs chaque tlcommande, et est utile principalement dans le cas d'un rseau basse vitesse sur lequel sont connects beaucoup d'automates (rseau radio par exemple). Inverser poids fort faible des valeurs IEEE Les valeurs relles IEEE sont codes sur deux mots conscutifs de 16 bits. Selon l'quipement, l'ordre de ces deux mots peut tre invers. Cette option permet de grer cette inversion. Cette case doit a priori tre coche pour les automates type TSX. Grer l'offset (+1) d'adressage MODICON Selon les quipements, un offset +1 existera entre les adresses automate et les adresses Modbus IP (le mot automate 0 aura l'adresse Modbus IP 1). Cette option permet de prendre en compte cette singularit. Jbus horodat uniquement Les paramtres correspondant au Jbus horodat sont dcrits dans le paragraphe Jbus horodat plus loin dans ce chapitre. Gestion modem Permettent, lorsque la case Gestion modem de la bote de configuration du port est coche, de dfinir le comportement du signal RTS lors d'une mission. Le paramtre Avance minimale RTS sur mission permet de dfinir le dlai en millisecondes pendant lequel le signal RTS doit tre mont avant une mission. Le paramtre Retard signal RTS sur mission permet de dfinir le dlai en millisecondes pendant lequel le signal RTS doit tre laiss mont aprs une mission.

3.4.

Modbus: Requtes de lecture

Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares cidessus. Les requtes d'criture n'ont pas tre prdfinies, tant automatiquement gnres par la fonction TELEC() du tableur. Les paramtres de chaque requte sont: Repre: Mnmonique libre sur 6 caractres. Longueur: Longueur de la table lire (125 mots ou 2000 bits au maximum). Dbut: Adresse de rangement des informations dans TOPKAPI Vision. Permet de ranger des informations n'importe quelle adresse dans les images mmoire de TOPKAPI Vision. Adresse physique: Adresse MODBUS de lecture dans l'automate. C'est l'adresse qui sera utilise dans la trame. Codage: Dcrit la faon de dcoder les informations contenues dans la trame:

Standard: Codage standard Modbus (PF-pf, bit 0 =


poids faible)

Invers: Codage invers Modbus (pf-PF, bit 15 = poids


faible)

Doctet std: idem codage standard pour les mots, interdit


pour les bits

3.3.

Modbus: Cration d'un automate

Doctet inv.: idem codage invers pour les mots, interdit


pour les bits

Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Crer un automate sur le port ci-dessus. Utiliser les paramtres suivants:

rel: lecture de rel IEEE sur 32 bits, accessibles par la


syntaxe #F dans le tableur Code fonction: Type de lecture, parmi

1: Lecture de n (= champ longueur) bits internes ou de


sortie

2: Lecture de n (= champ longueur) bits d'entre 3: Lecture de n (= champ longueur) mots internes ou de
sortie (mots de 16 bits)

4: Lecture de n (= champ longueur) mots d'entre (mots


de 16 bits)

5 et 6: Ecriture de 1 bit ou de 1 mot. La valeur inscrite


dans le champ Longueur est utilise pour dterminer la valeur crire. L'unique intrt de cette fonction est de permettre l'criture priodique d'une valeur constante dans un bit ou un mot, pour raliser un chien de garde dans un automate. Les requtes de tlcommande ou tlrglage sont gnres automatiquement depuis le tableur par la fonction TELEC().

Les autres codes de fonctions (7, 8, 11, 12) sont


supports, mais trs gnralement inutiles. Numro d'esclave Numro d'esclave paramtr dans l'automate, de 1 255. Type automate Utiliser de prfrence un type STANDARD, les types prdfinis correspondants aux espaces adressables de versions anciennes des TSX et PB, et tant de ce fait TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Les codes 254 et 255 sont rservs au protocole Jbus


horodat, dcrit plus loin. Origine: Numro d'esclave utiliser dans la trame MODBUS. Une valeur nulle indique de prendre le numro d'esclave indiqu dans l'automate TOPKAPI Vision.

Page E-9

Actif: Choisir Oui pour que la requte soit mise, non pour invalider la requte. Ce champ est modifiable uniquement en configuration, mais permet d'invalider certaines requtes sans avoir l'effacer. Priode: Priode d'excution de la requte, en secondes. Heure action: Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM. Spcifique: Affiche la trame MODBUS correspondant aux paramtres couramment slectionns.

Modbus: Paramtrage du port


Le paramtrage du port est strictement identique celui utilis pour le protocole Modbus/Jbus temps rel. La seule option complmentaire est accessible par le bouton Configuration, qui donne accs la bote suivante:

Modbus: Lecture de valeurs relles IEEE


Il est possible de lire des valeurs codes au format rel IEEE sur 4 octets (32 bits) dans un quipement. Il suffit de paramtrer une requte de lecture de n mots (code fonction 3 ou 4), de longueur gale deux fois le nombre de rels lire (puisqu'un rel est cod sur 2 mots de 16 bits), et avec un champ codage rel. Les valeurs lues seront accessibles grce la syntaxe #F dans le tableur ou les synoptiques. Selon l'automate utilis, il faudra cocher ou non l'option Inverser poids fort faible des valeurs IEEE dans la configuration des options du port.

3.5.

Modbus: Requtes d'criture

Les requtes d'criture sont gnres automatiquement par TOPKAPI Vision lors d'une tlcommande. Les fonctions employes sont:

5: Ecriture d'un bit. 6: Ecriture d'un mot de 16 bits 16: Ecriture de n mots, uniquement pour l'option recettes
de TOPKAPI Vision ou pour l'criture de valeurs relles IEEE ou d'entiers longs 32 bits (Fonction TELEC() avec une syntaxe #F ou #E dans le troisime terme)

Ecriture d'un mot double


Utiliser la syntaxe TELEC( , ,#Exxx) dans une cellule de type entier long. Le troisime terme peut tre remplac par #D ou #L selon l'ordre des mots crire.

La case Tester chevauchement de zone est cocher lorsque l'automate utilise un dcoupage de sa mmoire, et ne permet pas de faire de lecture de mots cheval sur deux zones. Le champ Taille d'une zone permet de spcifier la taille d'une zone. Exemple: Un automate dcoupe sa mmoire en zones de 128 mots. Pour lire 50 mots partir de l'adresse 100, il est interdit de procder une seule lecture, qui serait cheval sur les zones 0-127 et 128-255. Il faut dcouper la demande en deux requtes de lecture de 28 mots l'adresse 100, et de 22 mots l'adresse 128 Le champ Taille maxi d'une requte permet de prciser que l'automate utilis n'autorise pas de requte de lecture de n mots d'une longueur suprieure la valeur spcifie dans le champ. La valeur standard en Modbus est de 128. Les paramtres de cette bote sont utiliss uniquement pour les requtes gnres par TOPKAPI Vision lors de la lecture des tables de donnes horodates. Les requtes Temps Rel doivent tre paramtres par l'utilisateur de faon respecter les contraintes lies aux automates utiliss.

Ecriture d'un rel IEEE


Utiliser la syntaxe TELEC( , ,#Fxxx) dans une cellule de type rel.

3.6.

Modbus: Modbus/Jbus horodat

Le protocole Jbus horodat permet de lire des tables de donnes horodates dans un esclave Modbus/Jbus, condition que

TOPKAPI Vision possde l'option de traitement de donnes


horodates

Les tables de donnes dans les automates dans un format


comprhensible par TOPKAPI Vision. AREAL se tient votre disposition pour vous fournir toutes les informations sur les formats utiliss si vous dsirez intgrer dans vos automates de telles tables de donnes horodates.

Page E-10

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Modbus: Lecture des donnes horodates


Pour gnrer la lecture des donnes horodates, il suffit de paramtrer une requte de code fonction 255 afin de permettre la lecture priodique de la table de gestion de l'automate. Pour cette requte, 2 champs sont trs importants :

Code Fonction: 255: table de gestion Dbut: Adresse de dpart de la table de gestion
Les autres paramtres (Longueur, adresse physique, codage, etc.) de la requte sont renseigns automatiquement par TOPKAPI Vision. Garder les valeurs proposes par dfaut.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-11

4. Pilote MODBUS IP
4.1. Modbus IP: Prsentation

Le protocole MODBUS-IP implment dans TOPKAPI Vision permet de dialoguer avec des automates sur un rseau TCP-IP en tant connect directement sur un rseau Ethernet (ex : TSX Premium avec coupleur ETY110)

4.2.

Modbus IP: Cration d'un port

Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Crer un port correspondant au port srie utilis pour le dialogue. Utiliser les paramtres suivants:

Gnrer fichier MODIP_XX.LOG Permet de gnrer dans le rpertoire de l'application un fichier nomm MODIP_xx.LOG contenant les trames changes vers l'automate xx Mettre hors service l'quipement Non utilis. Suspendre l'quipement Permet d'indiquer un dlai en secondes pendant lequel l'quipement ne sera plus scrut suite une coupure de liaison. Ceci permet d'viter de perdre trop de temps chercher scruter un quipement momentanment indisponible. Protocole MODBUSIP Retard l'mission Indiquer ici une valeur de temporisation, en ms, entre deux missions conscutives vers le mme automate Traitement automate Timeout du protocole IP. Une valeur de l'ordre de 1000 millisecondes est raisonnable, mais peut tre augmente si ncessaire. En service Cocher cette case pour valider l'acquisition sur le port, sinon aucun dialogue n'aura lieu. Configuration ... Ce bouton permet de paramtrer certaines informations complmentaires Ajouter le numro d'esclave Lorsque l'on utilise Modbus IP avec des brigdes pour accder un rseau Modbus en RS485, il faut ajouter dans les trames Modbus IP le numro d'esclave paramtre dans chaque automate, et cocher cette option. Redondance adresses IP Le pilote ModbusIP est capable de grer les units centrales redondantes, qui utilisent deux cartes de communication donc deux adresses IP. En cas de coupure de liaison sur une adresse, TOPKAPI bascule automatiquement sur la seconde adresse. Pour viter de consommer trop de bande passante, mais pour surveiller l'tat de la liaison vers chaque UC, TOPKAPI communique vers parallle vers les deux adresses, en ralentissant la communication sur le canal secondaire. Ce dlai, en millisecondes, est le temps de silence respecter entre chaque requte sur le canal secondaire. La valeur spcifie ici se voit ajoute au retard l'mission paramtr au niveau du port. Inverser poids fort faible des valeurs IEEE Les valeurs relles IEEE sont codes sur deux mots conscutifs de 16 bits. Selon l'quipement, l'ordre de ces deux mots peut tre invers. Cette option permet de grer cette inversion. Cette case doit a priori tre coche pour les automates type TSX. Page E-12 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Grer l'offset (+1) d'adressage MODICON Encore une fois, selon les quipements, un offset +1 existera entre les adresses automate et les adresses Modbus IP (le mot automate 0 aura l'adresse Modbus IP 1). Cette option permet de prendre en compte cette singularit.

d'optimiser l'organisation de ces requtes, pour en avoir le minimum.

4.4.

Modbus IP: Requtes de lecture

4.3.

Modbus IP: Cration d'un automate

Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Crer un automate sur le port ci-dessus. Utiliser les paramtres suivants:

Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares cidessus. Les requtes d'criture n'ont pas tre prdfinies, tant automatiquement gnres par la fonction TELEC() du tableur. Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte. Les paramtres de chaque requte sont: Repre Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire (125 mots ou 2000 bits au maximum). Dbut Adresse de rangement des informations dans TOPKAPI Vision. Permet de ranger des informations n'importe quelle adresse dans les images mmoire de TOPKAPI Vision. Adresse physique Adresse MODBUS de lecture dans l'automate. C'est l'adresse qui sera utilise dans la trame. Codage Dcrit la faon de dcoder les informations contenues dans la trame:

Numro d'esclave Si l'automate en question est un automate Modbus sur un rseau RS485 derrire un bridge, saisir ici le numro d'esclave de l'automate Type automate STANDARD Accs Adresse IP de l'automate (ex: 100.100.1.2). En cas d'unit centrale automate redondante, on dclarera les deux adresses IP spares par une virgule (ex: 100.100.1.2, 100.100.1.3). TOPKAPI assurera un basculement automatique d'une adresse sur l'autre en cas de problme de communication. Spcifique Ouvre la bote suivante, dans laquelle il est possible de spcifier le nombre de canaux de communication ouvrir simultanment vers l'automate, pour acclrer la communication.

Standard: Codage standard Modbus (PF-pf, bit 0 =


poids faible)

Invers: Codage invers Modbus (pf-PF, bit 15 = poids


faible)

Doctet std: idem codage standard pour les mots, interdit


pour les bits

Doctet inv.: idem codage invers pour les mots, interdit


pour les bits lecture de rel IEEE sur 32 bits, accessibles par la syntaxe #F dans le tableur Code fonction Type de lecture, parmi

rel:

1: Lecture de n (= champ longueur) bits internes ou de


sortie

2: Lecture de n (= champ longueur) bits d'entre 3: Lecture de n (= champ longueur) mots internes ou de
sortie (mots de 16 bits)

4: Lecture de n (= champ longueur) mots d'entre (mots


de 16 bits)

5 et 6: Ecriture de 1 bit ou de 1 mot. La valeur inscrite


dans le champ Longueur est utilise pour dterminer la valeur crire. L'unique intrt de cette fonction est de permettre l'criture priodique d'une valeur constante dans un bit ou un mot, pour raliser un chien de garde dans un automate. Les requtes de tlcommande ou tlrglage sont gnres automatiquement depuis le tableur par la fonction TELEC(). Tous les automates ne supportent pas le mme nombre de canaux simultans. La valeur par dfaut est de 1. Il est inutile de paramtrer plus de canaux qu'il n'est paramtr de requtes, et pour optimiser la communication, il est conseill TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006 Origine Numro d'esclave utiliser dans la trame MODBUS. Une valeur nulle indique de prendre le numro d'esclave indiqu dans l'automate TOPKAPI Vision.

Page E-13

Actif Choisir Oui pour que la requte soit mise, non pour invalider la requte. Ce champ est modifiable uniquement en configuration, mais permet d'invalider certaines requtes sans avoir l'effacer. Priode Priode d'excution de la requte, en secondes. Heure action Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM. En tout, 9 requtes auront t remplaces par 4, le temps de cycle d'acquisition sera divis par un peu plus que 2.

Optimisation des requtes


Les requtes de lecture sont automatiquement cres en fonction des variables paramtres dans le tableur. Ces requtes gnres automatiquement se reconnaissent leur repre de type Mxxxx ou Bxxxx, o xxxx sont quatre chiffres. Cependant, ces requtes gnres automatiquement peuvent tre extrmement fragmentes. Les meilleures performances en ModbusIP tant obtenues en minimisant le nombre global de requtes par automate, il est conseill de crer manuellement des requtes plus longues (dans la limite de 125 mots ou 2000 bits par requtes) qui permettront de regrouper les "petites" requtes gnres par TOPKAPI. Exemple: Voici un exemple de requtes gnres automatiquement en fonction d'informations prsentes dans le tableur TOPKAPI:

Lecture de valeurs relles IEEE


Il est possible de lire des valeurs codes au format rel IEEE sur 4 octets (32 bits) dans un quipement. Il suffit de paramtrer une requte de lecture de n mots (code fonction 3 ou 4), de longueur gale deux fois le nombre de rels lire (puisqu'un rel est cod sur 2 mots de 16 bits), et avec un champ codage rel. Les valeurs lues seront accessibles grce la syntaxe #F dans le tableur ou les synoptiques. Une option d'inversion au niveau du port permet de tenir compte des particularits des quipements concernant l'ordre des deux mots composant une valeur relle.

4.5.

Modbus IP: Requtes d'criture

Les requtes d'criture sont gnres automatiquement par TOPKAPI Vision lors d'une tlcommande. Les fonctions employes sont:

5: Ecriture d'un bit. 6: Ecriture d'un mot de 16 bits 16: Ecriture de n mots, uniquement pour l'option recettes
de TOPKAPI Vision ou pour l'criture de valeurs relles IEEE ou d'entiers longs 32 bits (Fonction TELEC() avec une syntaxe #F ou #E dans le troisime terme)

On voit en particulier que 4 requtes de lecture de bits sont gnres pour lire des bits des adresses trs proches. Il est possible ici de regrouper les requtes M0000 et M0001, M0002 et M0003, et enfin B0000 B0003. On ajoute donc 3 requtes manuellement, grce au bouton Ajouter.

Ecriture d'un mot double


Utiliser la syntaxe TELEC( , ,#Exxx) dans une cellule de type entier long.

Ecriture d'un rel IEEE


Utiliser la syntaxe TELEC( , ,#Fxxx) dans une cellule de type rel.

4.6.

Modbus IP: Codes d'erreurs

Les codes d'erreur suivants peuvent tre renvoys par l'quipement interrog: 01 ILLEGAL FUNCTION Le code fonction utilis dans la requte n'est pas support par l'quipement ILLEGAL DATA ADDRESS L'adresse utilise dans la requte n'est pas supporte par l'quipement, ou plus prcisment la combinaison adresse / longueur n'est pas supporte ILLEGAL DATA VALUE La valeur contenue dans une requte est incorrecte SLAVE DEVICE FAILURE Une erreur inattendue s'est produite dans l'quipement ACKNOWLEDGE Le traitement de la requte va prendre beaucoup de 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

02 Il est inutile de supprimer les requtes Mxxxx et Bxxxx, elles seront automatiquement effaces lors de l'enregistrement de l'application. Cliquer sur Enregistrer, Fermer puis enregistrer l'application. Si vous revenez consulter les requtes, vous verrez que les requtes M0001 M0004 et B0000 B0003 auront disparu.

03 04 05

Page E-14

temps. Ce message concerne gnralement les commandes de programmation ou de tlchargement, sans objet pour TOPKAPI 06 SLAVE DEVICE BUSY Comme dans le cas ci-dessus, l'quipement est occup par une tche trs longue, et ne peut donc rpondre. Ce message concerne gnralement les commandes de programmation ou de tlchargement, sans objet pour TOPKAPI MEMORY PARITY ERROR Erreur de contrle de parit (CRC) dans l'quipement. Concerne des codes fonction non implments dans TOPKAPI GATEWAY PATH UNAVAILABLE Indique que la passerelle utilise pour la communication n'a pas trouv de moyen de traiter la requte. Ceci signifie gnralement que la passerelle est surcharge ou mal configure GATEWAY TARGET DEVICE FAILED TO RESPOND Signifie que l'quipement derrire une passerelle n'a pas rpondu la requte. Cela signifie gnralement que cet quipement est hors service ou que la passerelle est mal configure (problme de time out)

08

0A

0B

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-15

5. Pilote OPC
L'interface OPC est une interface standardise qui permet l'accs depuis un client OPC aux donnes d'un serveur OPC, lequel est reli un rseau d'quipements. Le dveloppement de serveurs OPC est gnralement la tche des constructeurs de solutions d'automatisme, qui permet depuis tout client OPC l'accs transparent aux donnes d'automatisme, indpendamment de toute considration de support physique et de protocole de communication utilis pour la communication avec les automates. Le pilote OPC (OLE for Process Control) permet l'interfaage en tant que client sur tout serveur OPC respectant les spcifications OPC 1 & 2. TOPKAPI Vision n'est pas serveur OPC.

S'il est possible de visualiser dans la fentre acquisition le paramtrage du port ou de l'automate, il est totalement dconseill de le modifier manuellement. Il est de plus formellement interdit de modifier le paramtrage des requtes.

5.3. OPC: Paramtrage de TOPKAPI l'aide de SoftLink


Le paramtrage du protocole OPC se fait exclusivement l'aide de l'assistant SOFTLINK. Depuis TOPKAPI en configuration, lancer SOFTLINK (Outils / SoftLink). Aprs un premier cran d'accueil, on arrive sur l'cran de choix de l'automate paramtrer.

5.1.

OPC: Installation du serveur OPC

Pour fonctionner, le pilote OPC ncessite l'installation d'un serveur OPC. Ce serveur peut tre fourni soit par le constructeur des automates utiliss, soit par un diteur ayant dvelopp le serveur en accord avec le constructeur. En aucun cas ce serveur ne pourra faire partie de la fourniture TOPKAPI. Ce serveur pourra tre install soit directement sur l'ordinateur sur lequel tourne TOPKAPI, soit sur un autre ordinateur reli en rseau local.

Systme d'exploitation ncessaire


Pour fonctionner correctement, il est ncessaire que les services COM (Component Object Model) et DCOM (Distributed Component Object Model) soient disponibles sur les ordinateurs sur lesquels fonctionneront tant le serveur que le client. C'est le cas lorsque le systme d'exploitation utilis est Windows NT4 ou Windows 2000. Pour Windows 95 et 98, il peut tre ncessaire d'ajouter les composants optionnels DCOM95 et DCOM98, lesquels sont couramment rpandus en tlchargement sur Internet, mais peuvent aussi tre trouvs sur le CDROM d'installation de TOPKAPI. Indpendamment des spcifications du fournisseur du serveur OPC utilis, il est trs fortement conseill d'utiliser pour TOPKAPI Windows 2000 ou XP. Slectionner l'automate s'il existe dj, ou slectionner Nouveau pour le crer, et faire Suivant.

Utilisation de deux ordinateurs diffrents pour le client et le serveur


Aprs avoir install et paramtr le serveur OPC, il faut paramtrer DCOM sur l'ordinateur serveur. Soit ce paramtrage est accessible directement depuis le serveur OPC, soit il faut lancer manuellement le programme standard DCOMCNFG.EXE permettant d'effectuer ce paramtrage. Sur l'ordinateur client, il faut d'abord installer la partie cliente correspondant au serveur OPC utilis. Cette partie cliente doit avoir t livre par le fournisseur du serveur, et correspond simplement l'enregistrement dans la base de registre de l'ordinateur client des informations telles que le nom du serveur OPC utilis et de quelques informations annexes. Lorsque cette partie client est installe, il est possible de passer au paramtrage de TOPKAPI.

5.2. OPC: Paramtrage via la fentre acquisition


Le paramtrage du protocole OPC ne se fait pas de manire classique en crant un port, un automate et des requtes, mais en utilisant l'assistant de paramtrage SoftLink. Consulter pour cela le paragraphe suivant.

Renseigner l'intitul de l'automate, valider ou modifier le code correspondant. Slectionner le profil automate standard, et slectionner le protocole de communication OPC. La notion de page synoptique associe est dcrite dans la documentation gnrale de SoftLink. La notion de fichier d'importation n'existe pas pour OPC. Par contre, un serveur OPC possde systmatiquement une fonction de parcours permettant de lister les lments OPC disponibles. Ces lments sont gnralement accessibles via une structure arborescente. Le bouton droite du nom du fichier d'import permet d'ouvrir une bote permettant de parcourir cette liste d'lments. La description de cette fonction de parcours est dcrite plus loin. On utilisera ce bouton ici uniquement pour vrifier que la connexion au serveur OPC se passe bien. Si vous obtenez le message suivant en cliquant sur ce bouton, vrifiez le paramtrage de votre serveur ou de DCOM si ncessaire. 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Page E-16

cette liste, c'est que l'installation du serveur en question n'a pas t correctement ralise. En particulier, si votre serveur est install sur un autre ordinateur, il est impratif d'enregistrer ce serveur sur l'ordinateur client. Cet enregistrement se fait obligatoirement l'aide d'outils fournis et documents par le fournisseur du serveur OPC. Si par contre vous obtenez la bote suivante, c'est que votre serveur est bien paramtr et disponible. Vous pouvez alors cliquer sur Suivant. Poste Lorsque le serveur OPC est situ sur un autre ordinateur, entrer ici le nom de cet ordinateur. Workgroup Lorsque le serveur OPC est situ sur un autre ordinateur, entrer ici le nom de groupe de travail ou de domaine auquel appartient cet ordinateur. Oprateur Lorsque le serveur OPC est situ sur un autre ordinateur, entrer ici le nom d'un oprateur autoris se connecter via DCOM sur cet ordinateur. Mot de passe Mot de passe correspondant l'oprateur ci-dessus. Lecture synchrone Ecriture synchrone En gnral, ces cases ne doivent pas tre coches. Dans le cas d'un accs synchrone, le pilote client OPC attend pour chaque lment demand la rponse du serveur avant de demander l'lment suivant. L'accs asynchrone permet gnralement de bien meilleures performances, mais tous les serveurs ne l'acceptent pas. Ne cocher ces cases que si la documentation du serveur le spcifie explicitement, ou si aprs quelques essais d'accs asynchrone, votre liaison OPC ne fonctionne pas ou mal. Caractre sparateur entre "Access path" et "Alias" L'alias est le nom utilis par un serveur OPC pour caractriser un lment (item). L'access path est un complment d'information indiquant au serveur comment acqurir un item dfini par un alias. Ce champ access path est optionnel, et n'est donc pas ncessaire pour tous les serveurs OPC. Lorsque l'on parcourt un serveur OPC pour importer des items, seul l'alias est import, pas l'access path. S'il s'avre que son usage est impratif pour un serveur donn, il faudra alors modifier manuellement les items OPC dans TOPKAPI via la fentre de configuration des mnmoniques automate, en ajoutant en prfixe l'access path suivi du caractre sparateur spcifi ici, par exemple "!". Faire attention utiliser comme sparateur un caractre qui ne peut pas tre utilis dans la dfinition d'un alias. Eviter le point "." ou le trait bas "_", par exemple. Dans l'exemple ci-dessous, l'accs path est COM1, l'alias est Random.Int1 et le sparateur est le point d'exclamation "!".

Configuration OPC
Le bouton Configuration accessible depuis la page Protocole de l'assistant SoftLink ou la bote de paramtrage du port dans la fentre acquisition ouvre la bote suivante

Nom du serveur Slectionner dans la liste droulante le serveur utiliser. C'est la documentation fournie avec ce serveur qui permet de savoir quel serveur utiliser lorsque plusieurs serveurs sont disponibles. Si le serveur que vous cherchez utiliser n'apparat pas dans

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-17

Utiliser le champ accs comme "Access path" par dfaut Si tous les items OPC imports doivent utiliser le mme access path, il est possible en cochant cette case de renseigner cet access path dans le champ Accs de l'automate.

l'outil standard de Windows DCOMCNFG.EXE. Des explications sont donnes plus loin.

5.4. OPC: Paramtrage des lments importer


Lorsque le paramtrage du port OPC a t effectu, vous arrivez dans l'assistant SoftLink sur la page suivante:

Dans l'exemple ci-dessus, l'acces path est COM1. Il reste possible en utilisant le caractre sparateur dcrit juste au dessus d'utiliser un autre access path que celui dfini pour l'automate pour un item donn. La dfinition d'un access path pour un item est prioritaire par rapport celle dfinie globalement pour l'automate. Utiliser la qualit des items OPC pour dtecter les coupures Cette case permet de surveiller dans TOPKAPI les problmes de communication entre le serveur OPC et les quipements superviss en utilisant la fonction COUPURE(). Toute erreur de communication doit selon la norme OPC provoquer la remonte depuis le serveur OPC vers le client (ici TOPKAPI) d'items comportant un attribut de mauvaise qualit. Si cette case est coche, toute information reue indiquant un item ayant une qualit autre que bonne provoque aprs une courte temporisation de 3 secondes le passage l'tat dconnect de l'automate. Tout item de bonne qualit provoque le retour l'tat connect. Gnrer fichier OPCxx.log Permet de gnrer un fichier OPCxx.LOG contenant la trace des informations changes avec le serveur, ainsi le cas chant que certains codes d'erreurs. En mode de fonctionnement normal, ne pas laisser cette case coche. Inscrire dans le LOG les informations d'import selon un filtre Permet d'enregistrer dans le fichier LOG les informations changes avec le serveur OPC lors de l'important des items en configuration. Ne pas afficher d'erreur lors de l'import des items OPC Lorsque plusieurs items doivent tre imports (si un importe selon un filtre, par exemple), les items de type non support par TOPKAPI (chanes de caractres, par exemple) vont provoquer l'affichage d'un message d'erreur d'import. Cocher cette case permet d'viter ce message d'avertissement. Seuls les items valides sont alors imports, les autres sont ignors. Configurer DCOM Donne l'accs au paramtrage de DCOM lorsque le serveur est situ sur un autre ordinateur. Ceci lance tout simplement

La liste de gauche contient les lments dj imports depuis le serveur OPC, et la liste de droite la liste des lments dj intgrs dans TOPKAPI. Le principe de fonctionnement de cette bote est dcrit dans la documentation gnrale de SoftLink. La particularit propre OPC est la prsence du bouton Importer en haut de cette fentre, qui ouvre la bote permettant de se connecter au serveur OPC de faon parcourir la liste des lments disponibles. Le parcours des lments disponibles est gnralement arborescent. La fentre qui s'ouvre affiche la liste des branches disponibles.

La liste de gauche permet de se dplacer dans la liste des branches et lments disponibles, organiss comme le sont les dossiers et fichiers d'un disque dur. La liste de droite contient la liste des lments dj slectionns pour tre ventuellement imports dans TOPKAPI (ventuellement car ces lments se retrouveront dans la liste de droite de l'assistant SoftLink, et devront tre explicitement choisis pour tre imports dans TOPKAPI).

Ajout d'lments dans la liste


En fonction de la branche slectionne, le champ Filtre contient le chemin complet correspondant cette branche. Le bouton Importer selon le filtre permet de copier dans la liste des lments slectionns tous les lments dont le nom et l'arborescence correspond au filtre affich. Il est possible de modifier 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Page E-18

manuellement ce filtre, en utilisant si besoin des caractres "?" et "*", qui remplacent respectivement un caractre et un nombre quelconque de caractres, y-compris une chane vide. Les sous branches de la branche courante sont automatiquement parcourues. Si l'lment slectionn dans la liste de gauche n'est pas une branche mais un lment final (une feuille), un double clic sur cet lment le recopie dans la liste de droite. Son nom est automatiquement recopi dans le champ Item, dans lequel il peut alors tre modifi. Le bouton Importer item tente alors d'ajouter dans la liste de droite l'item de la branche courante dont le nom est spcifi dans le champ de saisie Item. Il est ici interdit d'utiliser les caractres joker "?" et "*". Il est possible que certains items apparaissant dans la liste de gauche ne puissent tre imports. On obtient alors un message tel que

Une option du port permet d'viter l'apparition de ce message.

Suppression d'lments de la liste


Si l'on vient d'importer dans la liste de droite un item dont on s'aperoit qu'il est finalement inutile, il suffit de slectionner l'lment en question et d'utiliser la touche Suppr.

Validation de l'import
Cliquer enfin sur le bouton Importer pour transfrer les items slectionns dans la liste de droite de l'assistant SoftLink.

Le mnmonique est dduit du nom de l'item OPC, les caractres spciaux tant remplacs par des "_". Si le serveur OPC propose un libell pour l'lment, celui-ci sera repris. Sinon, on proposera par dfaut le nom exact de l'lment fourni par le serveur OPC. L'adresse n'a pas de signification pour OPC. Elle est par contre indispensable dans TOPKAPI, qui va ranger chaque lment une adresse particulire. La correspondance entre les adresses utilises dans TOPKAPI et les noms d'lments OPC est entirement transparente. Il ne faut cependant pas modifier les choix proposs par dfaut par l'assistant. Le format et le type de profil sont dduits des informations donnes par le serveur OPC. Ici, l'information est accessible en lecture / criture et est de type entier, l'assistant propose donc une fonction de tlcommande analogique. L'cran de validation de l'assistant SoftLink est propos ds que l'on a termin d'incorporer les lments OPC et que l'on clique sur le bouton Suivant.

Le serveur OPC peut, selon les cas, fournir un certain nombre d'informations sur les variables importes, savoir un mnmonique (critre fondamental de reconnaissance des variables, et ce titre non modifiable), un libell, un type et un type d'accs en lecture et/ou criture. En fonction de ces informations, l'assistant SoftLink va proposer lorsque l'on bascule une variable dans la liste de droite un profil de traitement. Par exemple, si l'on slectionne la variable .5.2.2 <2>, le choix propos par l'assistant sera

Les options disponibles dans cette bote sont conformes ce qui est dcrit dans la documentation gnrale de l'assistant SoftLink.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-19

5.5. OPC: Surcharge des informations de configuration fournies par le serveur OPC
L'exemple prcdent montre que les informations fournies par le serveur OPC peuvent parfois tre trop succinctes. Plutt que de modifier la cellule rsultant de l'import dans TOPKAPI, il peut tre judicieux de surcharger les informations du serveur OPC. Pour cela, dans l'assistant SoftLink, cocher la case Surcharge .CSV, et faire un double clic sur la variable dont on veut surcharger les informations

5.6. OPC: Modification des variables importes


ce qui ouvre la bote suivante Il est possible de modifier les variables importes via l'assistant SoftLink soit en retournant dans l'assistant par le menu Outils / SoftLink, soit en se plaant dans le tableur et en appelant la page d'import des variables de l'assistant par le menu Outils / Importer pour cet automate, soit enfin de modifier les variables directement depuis le tableur. Par contre, du fait de la gestion cache de la correspondance entre les lments OPC imports et les adresses utilises en interne par TOPKAPI, il est impossible de crer directement une cellule dans le tableur, sauf bien entendu si cette cellule est une cellule interne de gestion, indpendante de tout lment OPC. Il est aussi interdit de transformer une variable importe en cellule, sous peine de perdre le lien interne adresse lment OPC, et d'introduire des incohrences graves dans votre application. Le menu Edition / Configuration mnmoniques automates permet de visualiser et contrler les items ayant t imports, et il est possible de retoucher les libells utiliss, sous rserve de ne pas introduire d'incohrence (utilisation d'un mme nom d'alias pour deux adresses, par exemple).

On surcharge ici le libell, non fourni par le serveur OPC, le choix d'chantillonnage est le fait que la variable est accessible en commande. Aprs validation, on renvoie la variable dans la liste de droite, ce qui donne comme rsultat Un double clic sur un item ouvre la bote suivante:

Page E-20

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Mnmonique Mnmonique dduit de l'alias renvoy par le serveur OPC en remplaant les caractres non supports par TOPKAPI par des caractres "_". Dans le cas d'OPC, cet identificateur ne doit pas tre modifi. Type Type de l'information (bit, octet, mot, mot double, rel) tel que renvoy par le serveur OPC lors de l'import de l'item. Ce type ne doit pas tre modifi. Adresse Adresse affecte automatiquement par TOPKAPI pour ranger l'item. Cette adresse ne doit pas tre modifie. Adresse physique Chane dcrivant exactement l'item OPC, telle que donne par le serveur OPC lors de l'import et rutilise par TOPKAPI pour acqurir la donne. Cette chane peut tre modifie, par exemple pour ajouter en prfixe un access path. Il s'agit de la valeur prsente dans le champ F4, exprime en millisecondes, 1000 tant la valeur par dfaut. Il est possible de surcharger cette valeur pour modifier la frquence d'acquisition de l'item. Lors de la validation de Softlink, TOPKAPI rassemble tous les items ayant la mme frquence d'acquisition au sein d'une mme requte. La priodicit de cette requte est l'arrondi en secondes le plus proche de la valeur en millisecondes de chaque item. Les autres champs de la requte n'ont pas d'importance et ne doivent pas tre modifis.

5.7. OPC: rglage de la frquence d'acquisition des items


Lors de l'import d'un item OPC, l'un de ses attributs est une frquence de rafrachissement (update rate). Cette valeur peut tre consulte dans Softlink dans la fentre de surcharge des informations de configuration fournies par le serveur OPC:

Il est simplement possible de modifier le champ Priode d'une requte pour acclrer ou ralentir la frquence de rafrachissement des items. Selon le serveur OPC utilis, ceci permettra par exemple d'viter une saturation d'un rseau d'acquisition ou de diminuer la charge processeur utilise par le serveur OPC. Dans l'exemple ci-dessus, l'acquisition des items OPC se fait avec une frquence d'une seconde, tous les items tant acquis la mme frquence. Si on surcharge le temps de rafrachissement de certains items, par exemple en remplaant la valeur 100ms par 5000ms dans le champ F4:

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-21

tablir la connexion entre les deux ordinateurs configurer tant sur le serveur que sur le client la couche DCOM grant la communication entre les deux ordinateurs. L'accs sur le serveur se fait en lanant par le menu Dmarrer / Excuter et en entrant DCOMCNFG.EXE comme nom de programme. Sur le client, la mme mthode peut tre utilise, mais l'accs cet outil est rendu plus simple en cliquant sur le bouton Configurer DCOM de la bote de paramtrage du pilote OPC TOPKAPI.

On note que maintenant (aprs avoir valid Softlink et enregistr l'application), deux requtes sont gnres, l'une avec une priode d'une seconde et l'autre avec une priode de cinq secondes:

Les items sont maintenant rpartis en deux groupes, dont on peut modifier la frquence d'acquisition indpendamment.

Dans la console de gestion qui apparat, slectionner la branche Services de composants / Ordinateur / Poste de travail. Faire un clic droit sur le poste de travail et slectionnez le menu Proprits, ou utiliser le menu Actions / Proprits.

5.8. OPC: Contrle de la liaison au serveur


Comme pour tout autre protocole, la fonction COUPURE() permet de contrler le bon fonctionnement de la liaison au serveur OPC. Il est cependant important de noter qu'en mode de fonctionnement asynchrone, il est impossible de vrifier si tous les lments OPC demands sont bien renvoys par le serveur. Si en particulier de serveur ne renvoie que certains des items demands, la fonction COUPURE ne sera d'aucun secours pour le dtecter. Il est conseill, en phase de mise au point, d'activer le fichier OPC.LOG et d'y scruter d'ventuels messages d'erreur. L'option du port Utiliser la qualit des items OPC pour dtecter les coupures permet de lier l'tat de connexion renvoy par la fonction COUPURE() la qualit des items OPC reus. La rception d'items de mauvaise qualit provoque l'affichage dans TOPKAPI d'une rupture de liaison. La rception d'items de bonne qualit provoque le retour une liaison correcte. Pour viter les basculements rapides d'tat, une temporisation de trois secondes est active avant chaque changement d'tat.

5.9.

OPC: Paramtrage de DCOM

Si le serveur OPC que vous utilisez fonctionne sur un autre ordinateur que celui sur lequel fonctionne TOPKAPI, il faut pour Page E-22 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Les onglets Gnral, Options, MSDTC et Protocoles par dfaut n'ont pas tre modifis. Sur le serveur, l'onglet Scurit COM doit tre modifi comme suit:

Sur l'ordinateur serveur


Ouvrir la branche Services de composants / Ordinateur / Poste de travail / configuration DCOM.

Slectionner votre serveur OPC dans la liste des applications disponibles, et cliquer sur Action / Proprits.

Sur chacun des boutons Modifier les limites et Modifier, ajouter l'oprateur Tout le monde et activer l'accs distant:

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-23

Cliquer successivement sur les trois boutons Modifier de faon affecter des droits particuliers aux oprateurs. Dans les trois cas, utiliser les paramtres suivants:

Il va de soi que les paramtres proposs vont dans le sens d'une simplicit totale de fonctionnement, au dtriment de la scurit. Des paramtres plus restrictifs peuvent tre mis en place ds lors que votre liaison OPC fonctionne correctement. Il est en effet prfrable d'viter l'utilisation de droits trop restrictifs en phase de mise au point.

Page E-24

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Dans la bote de paramtrage du pilote OPC TOPKAPI, renseigner les paramtres permettant l'accs au serveur OPC.

Sur l'ordinateur client


Utiliser les mmes paramtres que sur l'ordinateur serveur, avec comme seule diffrence les valeurs de l'onglet Emplacement des proprits du serveur OPC.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-25

La formule donnant la correspondance entre le nombre de caractres et un temps en secondes sera

6. Pilote PERAX
Le pilote PERAX permet de dialoguer avec des stations PERAX de type P200 (V2.xx V4.xx), P200X ou P16XT directement l'aide d'un ou plusieurs modems, d'une liaison srie ou d'une LS. Il permet aussi le dialogue avec un frontal ARLEQUIN. Le paramtrage passe par les tapes suivantes: Cration du port "logique" et des modems auxquels seront rattaches les stations PERAX Dclaration de chaque station Dclaration des requtes de lecture d'informations dans les stations Paramtrage des cellules tableur de gestion des stations

Temps = (Nb car)*(1+bits donnes+bits parit+bits stop) Vitesse En service Coche (sinon les messages sur le port ne seront pas traits) Le bouton Configuration... permet d'accder certains paramtres lis au protocole, puis de configurer la liste des ports physiques (liaisons RS232, LS ou RTC) utiliss pour communiquer avec les stations.

6.1.

Perax: Cration d'un "port logique"

Toutes les stations P200 ou P200X doivent tre rattaches un port "logique" dans TOPKAPI Vision. Ce port n'existe pas forcement physiquement sur l'ordinateur (d'o la dnomination de port logique), mais il se voit attribuer une liste de ports physiques auxquels seront rattachs les modems grer pour assurer la communication avec les stations. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Ouvrir la fentre Acquisition en configuration, et crer un port (menu Edition / Ajouter un port). Le numro attribu au port n'a pas d'importance, utiliser de prfrence un numro de port correspondant l'un de ceux que vous utiliserez pour communiquer. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

Longueur maximum des trames Permet de limiter la longueur maximale des trames utilises pour rcuprer les informations horodates de la station PERAX. Ceci peut permet d'amliorer la communication avec les stations lorsque les liaisons tlphoniques sont de mauvaise qualit. Le fichier ARLEQUIN.LOG permet de diagnostiquer aisment de tels problmes. La valeur doit tre comprise entre 30 et 120. Utiliser d'abord 120, puis 60, et enfin 30 si les problmes de communication subsistent. Nombre de tentatives d'mission avant erreur Ce paramtre permet de modifier le nombre de tentatives d'mission d'une trame avant de gnrer une erreur de communication et donc d'abandonner de terminer la connexion en cours. Ceci peut permet d'amliorer la communication avec les stations lorsque les liaisons tlphoniques sont de mauvaise qualit (GSM particulirement). Les fichiers PERAXxxx.LOG permettent de diagnostiquer aisment de tels problmes. La valeur doit tre comprise entre 1 et 20. Utiliser d'abord 3, puis 5, et enfin 10 si les problmes de communication subsistent. Mettre jour l'image mmoire sur tlcommande Indique si l'information tlcommande doit tre mise jour dans TOPKAPI Vision ds que la tlcommande a t accepte, ou bien s'il faut attendre une requte de lecture de la zone correspondante pour mettre jour l'image mmoire TOPKAPI Vision. Gnrer fichiers PERAXxxx.LOG

Protocole PERAX 32 Traitement automate Time-out en 1/10mes de seconde Retard l'mission Dlai entre la fin de rception d'une trame et l'mission de la suivante, exprim en nombre de caractres.

Page E-26

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Les fichiers PERAXxxx.LOG, placs dans le rpertoire de l'application, contiennent la description des trames reues et mises par TOPKAPI Vision, et permettent de diagnostiquer d'ventuels problmes de communication. Ports physiques Accde la bote suivante, dans laquelle on paramtre les ports utiliss pour communiquer avec les stations

RS232 Permet de dialoguer en direct avec un frontal ARLEQUIN, un P200 ou un P200X. LS (+RTC) Sans objet, ne pas utiliser. RTC Dclarer dans la liste des ports utiliss tous les ports sur lesquels seront connects les modems RTC grer pour communiquer avec les stations P200 ou P200X. TOPKAPI Vision utilisera pour une connexion sortante le premier modem disponible, et acceptera des connexions entrantes n'importe quel modem. Pour changer le type de port, il faut au pralable supprimer le ou les ports physiques dj utiliss. Les champs Nombre de tentatives, et Dlai entre tentatives permettent de rgler le comportement de TOPKAPI lorsqu'un appel sortant choue. Le bouton central (sigles >> ou << suivant la liste slectionne) permet de dplacer un port physique d'une liste l'autre. En slectionnant l'onglet Physique, on accde la bote de configuration du port physique slectionn dans la liste des ports utiliss.

Dans cette bote, renseigner les divers paramtres de communication. Le format de donnes utiliser est 2400 bauds, 8 bits de donnes, sans parit, un bit de stop. Une vitesse suprieure peut tre slectionne si ncessaire (P400 XI ou liaison GSM). La case Contrle de flux doit tre laisse sur Sans. La zone Mode d'utilisation du port permet, lorsque plusieurs modems sont disponibles, de rserver l'utilisation du port aux appels entrants, sortants ou les deux. Faire attention ne pas rserver tous les modems aux appels entrants, sous peine de ne plus pouvoir dclencher d'appel l'initiative de TOPKAPI, ou tous les modems aux appels sortants, sous peine de ne plus pouvoir recevoir d'alarmes. L'onglet Modem permet de slectionner le modem que vous utilisez.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-27

Modem GENER GE425 en V23 et V22-V22bis

La chane d'initialisation est V1S7=60S46=1&I1. On fera prcder le numro de tlphone des stations en V23 du prfixe 1@ , et celui des stations en V22 ou V22bis du prfixe 2@.

Le bouton Nouveau permet de crer un nouveau type de modem, le bouton Configurer permet de modifier les paramtres du modem slectionn.

Modem GENER GE934 en V23, V22-V22bis et GSM

6.2.

Perax: Paramtres modem

La connexion aux stations P200 ou P200X peut se faire en V23 (P200 V2.xx et V3.xx), V22 (P200 V4.XX, P200X, P16XT), V22bis (P200X, P16XT) ou V32 (P200X ou P16XT GSM). Il est possible d'utiliser tout modem HAYES standard pour communiquer en V22 ou V22bis, mais il est fortement conseill d'utiliser le modem GENER GE425 ou GE934, qui ont t valids par AREAL, et qui donne des connexions trs fiables avec les stations PERAX. La connexion en V23 avec les stations P200 V2.xx et V3.xx impose l'utilisation du modem GENER GE425, pour lequel une adaptation a t effectue par GENER (se renseigner auprs d'AREAL ou de PERAX) pour supporter le retournement dynamique en V23. Il est possible de faire coexister des stations de toute nature, au prix d'une lgre complexit de paramtrage. Nous donnerons ciaprs plusieurs exemples de paramtrage, pour des stations V23 seules et des stations V23 et V22 et V32 mlanges.

La chane d'initialisation est X4 V1 &I1 %C0 N3 \N0 %S1 S7=60 S13=1 S46=1 S91=10 La chane 3@ est ATB6N1%C1\N3 On fera prcder le numro de tlphone des stations en V22V22bis du prfixe 1@ , celui des stations en V23 du prfixe 2@ et celui des stations en GSM du prefixe 3@.

Choix du type de modulation dans les stations PERAX


Il est important de spcifier dans la station P200 ou P200X quelle modulation doit tre utilise pour appeler TOPKAPI Vision. V2 et V3 : Aucune configuration possible V4 : Menu gnral - Divers utilitaires - Paramtrage - Port srie Appel sortant PC : V23 ou V22 V5 (C'est le P200X) : Menu gnral - Configuration - Transfert LS/RTC - Modulation CCITT - PC : V23R ou V22 ou V22bis Page E-28 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

6.3.

Perax: Cration d'un automate

Pour chaque station P200 ou P200X doit tre cr dans TOPKAPI Vision un automate. Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Ouvrir la fentre Acquisition, slectionner le port logique cr auparavant, puis utiliser la commande menu Edition / Ajouter un automate un port. Dans la bote de dialogue de configuration de l'automate, renseigner les diffrentes zones de la manire suivante:

En service Coche (sinon pas communication possible) Horodat Coche (sinon pas d'archivage des donnes horodates) Zones mmoire Modifier les valeurs proposes par dfaut (voir ci-dessous)

Station P200
Type d'automate PERAX P200 Numro d'esclave Numro d'esclave de la station Accs Numro de tlphone o joindre l'automate En service Coche (sinon pas communication possible) Horodat Coche (sinon pas d'archivage des donnes horodates) Zones mmoires Automatiquement configures; modifications possibles Zone Mots 1 Heure de la station, adresses de 0 54 (0 4 en lecture, 50 54 en criture) Zone Mots 2 Entres analogiques, adresses de $1400 $15FF, Compteurs, de $1800 $1B1F Consignes automate de $2000 $207F Minima compteurs de $2800 $2B1F Maxima compteurs de $3800 $3B1F Zone Bits 1 Bits de gestion si un frontal ARLEQUIN est utilis, de $400 $5FF Zone Bits 2 Entres et sorties logiques, adresses de $1000 $118F

6.4. Perax: Cration des requtes de lecture


Zone Mots 1 Heure de la station, adresses de 0 4 Zone Mots 2 Entres analogiques, adresses de $0600 $06FF, suivies des compteurs, partir de $0700 Zone Bits 1 Entres et sorties logiques, adresses de $0400 $05FF Zone Bits 2 Sans objet, laisser 0 Il faut paramtrer pour chaque station les requtes de lecture des informations grer dans le tableur (entres et sorties logiques et analogiques, compteurs). Ces requtes seront adresses la station lors de chaque connexion, pour rafrachir l'image temps rel de celle-ci Les requtes de lecture peuvent tre automatiquement gnres par TOPKAPI. Cependant, cette fonctionnalit est invalide par dfaut, par compatibilit ascendante avec les anciennes applications. Pour valider nouveau la gnration automatique des requtes, ouvrir avec le bloc-notes de Windows le fichier PROTOMAP.DAT prsent dans le dossier des excutables TOPKAPI (C:\Program Files\Vision32 par dfaut). Dans la section [REQUETES], vrifier la prsence et ajouter si besoin le protocole PERAX32 dans la liste des protocoles pour lesquels la gnration automatique des requtes est valide.

Station P200X ou P16XT


Type d'automate PERAX P200 Numro d'esclave Numro d'esclave de la station Accs Numro de tlphone o joindre l'automate TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-29

configuration, mais permet d'invalider certaines requtes sans avoir l'effacer. Priode Priode d'excution de la requte, en secondes. Heure action: Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM. Spcifique: Affiche la trame JBUS correspondant aux paramtres couramment slectionns.

Adresses JBUS pour un P200


Adresse 0001-0003 500-5C7 600-627 700-88E Type 3 mots 200 bits 40 mots 400 mots Description Date / Heure Etat voies TOR Etat voies ANA Etat voies COMPTEUR et CHRONO (1 double mot par voie)

Arrter et relancer TOPKAPI pour que la modification soit prise en compte.

Paramtrage manuel des requtes


Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte. Les paramtres des requtes sont les suivants: Repre Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire (125 mots ou 2000 bits au maximum). Dbut Adresse de rangement des informations dans TOPKAPI Vision. Permet de ranger des informations n'importe quelle adresse dans les images mmoire de TOPKAPI Vision. Adresse physique Adresse MODBUS de lecture dans le P200(X). C'est l'adresse qui sera utilise dans la trame. Codage Dcrit la faon de dcoder les informations contenues dans la trame: Adresse 0001-0003 1000-118F 1400-158F 1800-1B1F 2000-207F 2800-2B1F 3800-3B1F Type 3 mots 400 bits 400 mots 800 mots 128 mots 800 mots 800 mots

Adresses JBUS pour un P200X


Description Date / Heure Etat voies TOR Etat voies ANA Etat voies COMPTEUR et CHRONO (1 double mot par voie) Consignes automate Minima compteurs Maxima compteurs

Les informations ci-dessus ne sont donnes qu' titre d'exemple, et ne sauraient donc remplacer les informations fournies dans la documentation PERAX

6.5.

Perax: Fonctions tableur

Adressage des variables


Les entres logiques sont adresses par la syntaxe
#B<adresse>. Sur les P200, La valeur des bits est inverse, c'est dire qu'une entre active rend un bit 0. Il faut donc utiliser soit la fonction NON(#B<Adresse>), soit une prsentation sous forme de libell invers pour afficher correctement dans TOPKAPI Vision les valeurs lues

Standard: Codage standard Modbus (PF-pf, bit 0 =


poids faible)

rel: lecture de rel IEEE sur 32 bits, accessibles par la


syntaxe #F dans le tableur Code fonction Type de lecture, parmi

1: Lecture de n (= champ longueur) bits internes ou de


sortie

Les entres analogiques seront adresses par la syntaxe


#M<adresse>. Les valeurs lues sont codes sur 8, 10, 12, 14 ou 16 bits (0 255, jusqu' 0 65535), les valeurs de 0 (pleine chelle/5) correspondent un dfaut de l'entre, les valeurs correctes sont donc code de (pleine chelle/5+1) (pleine chelle). La formule permettant de rcuprer une valeur l'chelle sera donc (pour la premire entre): SI(#M$600>(pleine chelle/5), #M$600-(pleine chelle/5+1.0))*<Echelle maxi>/(pleine chelle*4/5), 0)

2: Lecture de n (= champ longueur) bits d'entre 3: Lecture de n (= champ longueur) mots internes ou de
sortie (mots de 16 bits)

4: Lecture de n (= champ longueur) mots d'entre (mots


de 16 bits)

5 et 6: Ecriture de 1 bit ou de 1 mot. Sans intrt ici.


Origine Numro d'esclave utiliser dans la trame. Une valeur nulle indique de prendre le numro d'esclave indiqu dans l'automate TOPKAPI Vision. Actif Choisir Oui pour que la requte soit mise, non pour invalider la requte. Ce champ est modifiable uniquement en Page E-30

Les compteurs seront adresss par la syntaxe #D<adresse>.

Tlcommandes
Pour tlcommander une valeur dans une station, il faut au pralable demander une connexion vers la station concerne. Seules les voies de type AUTOMATE (cf. documentation PERAX) pourront tre commandes depuis TOPKAPI.

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Mise l'heure
La date et l'heure d'un PERAX sont organises de la faon suivante: Jour Mois Anne Heure Minutes Secondes #O3 #O2 #O5+2000 #O4 #O7 #O6

Cette fonction est tendue la notion d'tat de connexion Valeur 0 1 2 3 4 5 6 7 tat de la connexion En connexion, possibilit tlrglages, tlcommandes Dconnect (position repos) Demande de connexion en cours de traitement En connexion simple (rafrachissement initial), pas de tlcommande possible Non utilis Non utilis Non utilis Temps de connexion dpass, fin de lecture des donnes horodates de passer des

L'criture de la date et de l'heure peut tre faite en utilisant la forme de tlcommande suivante: TELEC(condition, [AUJ(2)*256 + AUJ(1), (AUJ(0):100)*256 + AUJ(4), AUJ(5)*256 + AUJ(6), AUJ(3)],A1#W1) Condition est une expression logique d'envoi automatique de l'heure. A1 dans le troisime terme doit tre remplac par le code de votre automate. Des espace ont t ajouts ci-dessus pour une meilleure lisibilit, mais ne doivent pas tre saisis. Une erreur d'valuation en configuration peut ventuellement tre dtecte au niveau de la seconde parenthse, mais elle doit tre ignore.

Diagramme temporel d'une connexion

Demande de connexion
La demande de connexion une station se fait grce la fonction DEMCX(). Les appels sur dfaut sont l'initiative de la station. Fonction DEMCX(Condition,Valeur,Chane1) Sur variation de Condition ou variation de Valeur (Condition tant 1), dclenche une demande de connexion (Condition=1) ou de dconnexion (Condition=0, si l'option Ignorer les fronts descendants de la fonction DEMCX n'est pas coche dans les paramtres gnraux de l'application) vers la station repre par chane1 (repre automate suivi du caractre ", exemple T1"). Valeur exprime en minutes spcifie la dure maximum de la communication. Une demande de connexion avec une dure 0 provoque juste un rafrachissement des valeurs temps rel. Une demande de connexion avec dure -1 entrane une dure de communication minimale (un rafrachissement des valeurs temps rel, suivi d'une lecture des donnes horodates). Fonctionnement: Condition 1 Valeur 0 Action Appel simple : excuter une seule fois chaque requte puis raccrocher. Les donnes horodates ne sont pas rcupres 1 1 >0 -1 Appel continu pendant <vmot> minutes puis raccrocher Appel avec rcupration des donnes horodates et raccrochage le plus rapidement possible Dconnexion si communication en cours ou dpilage de la liste des appels en attente, uniquement si la case "Ignorer les fronts descendants de la fonction DEMCX" n'est pas coche 1 2 3 4 5 6

Etat de la dernire connexion


La fonction SYS(XX",5) permet de rcuprer dans le tableur l'tat de la dernire connexion la station repre par le code XX". Les diffrentes valeurs rendues par cette fonction sont: Valeur 0 tat de la connexion La dernire connexion sortante s'est bien passe. Tout est correct. La dernire connexion sortante a chou, mais il y aura au moins une autre tentative d'appel. Inutilis Inutilis La dernire connexion entrante s'est bien passe. Tout est correct. La dernire connexion entrante a chou. La dernire connexion sortante a chou, et il n'y aura plus d'autre tentative d'appel

Acquittement d'un appel en cas d'alarme


En fin de connexion simple, le pilote cherche dans la liste des requtes de l'automate connect la requte ayant pour repre la chane ACQUIT, puis l'met une fois; au cas ou elle n'existe pas, la librairie pilote cre et met une requte de tlcommande d'un bit l'adresse $40A (en hexadcimal) avec la valeur 1. Dans le cas d'une liaison RS232 cette requte n'est pas mise.

Remarque: Pas de connexion / dconnexion possible pour les ports type RS232

Contrle des connexions


Fonction COUPURE(<refAPI>") TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006 Page E-31

Lecture des donnes horodates


La lecture des donnes horodates de la station est faite automatiquement lors de tout appel sortant de dure non nulle ou lors de tout appel entrant. Si vous avez demand une connexion de dure assez longue, une nouvelle demande de lecture des donnes horodates peut tre faire en cours de connexion grce la fonction LECDH(). Fonction LECDH(Condition, valeur) Sur front montant de Condition ou variation de Valeur (Condition tant 1), dclenche le mcanisme d'acquisition des donnes horodates. Si la liaison est de type RTC, ceci ne provoque pas la connexion; dans ce cas, si la liaison n'est pas dj tablie, la fonction choue avec un message d'erreur (ex: T1 : Refus lecture donnes horodates). La lecture de donnes horodates ne bloque pas l'acquisition temps-rel. Cette fonction doit tre implante dans la feuille principale de la station.

6.6.

Perax: Messages d'erreur possibles

TOPKAPI Vision peut signaler des messages d'erreurs propres au protocole: Port 5 T1: chec connexion sortante: Echec phase de reconnaissance de l'automate distant. Port 5 chec connexion entrante esclave 2: Connexion entrante avec un numro d'esclave non configur sur le port logique. Port 5 cx sortante : STATION P200-1: Connexion sortante avec la station reprsente par le libell. Port 5 cx entrante : STATION P200-1: Connexion entrante avec la station reprsente par le libell.

Page E-32

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

7. Pilote SOFREL avec frontal


Le protocole SOFREL avec frontal permet de dialoguer avec des stations de type S10, S15 et S50 travers un frontal de type CS100. Le paramtrage passe par les tapes suivantes: Paramtrage du frontal et des satellites Cration du port de communication sur lequel est reli le frontal Dclaration du frontal Dclaration de chaque station Dclaration des requtes de lecture d'informations dans le frontal et les stations Paramtrage des cellules tableur de gestion des stations

7.1. Sofrel avec frontal: Paramtrage du frontal et des satellites


Quelques prcautions sont prendre lors du paramtrage du frontal et des satellites, sous peine de ne pouvoir rcuprer les informations horodates prsentes dans les stations

Protocole: SOFREL32 : Pilote SOFREL Sous protocole: CS100 Traitement automate: Time-out en 1/10mes de seconde Retard l'mission: 0 En service: Coche pour valider le dialogue avec le CS100 Le bouton Configuration... permet d'accder la bote suivante:

Satellites
Les informations de type Historiques et Bilans doivent tre
retransmises vers le frontal.

La priodicit d'chantillonnage pour poste central doit tre


non nulle

Le protocole de retransmission des informations vers le


poste central doit tre SOFBUS PL Esclave

Frontal
Le protocole de communication avec les stations doit tre
SOFBUS PL Matre

Le protocole de communication avec le superviseur doit tre


SOFBUS PC Esclave

Les informations de type Etats courants, Historiques et


Bilans doivent tre rcupres pour chaque station.

Les informations de type Historiques et Bilans doivent tre


retransmises vers le port sur lequel est connect le superviseur

7.2. Sofrel avec frontal: Cration d'un port


Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Ouvrir la fentre Acquisition en configuration, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port doit correspondre au port srie sur lequel sera connect le frontal. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

La case Gnrer fichier SOFRELxx.LOG permet de gnrer un fichier de mise au point dans lequel seront consignes les trames changes avec le frontal. Ce fichier atteint une taille maximale de 10 Mo, puis ne grossit plus. Laisser le paramtre Nombre de tentatives d'mission avant erreur 3. TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006 Page E-33

Le bouton Port(s) physique(s) permet de configurer le port physique (liaison RS232 obligatoirement) utilis pour communiquer avec le frontal CS100.

7.3. Sofrel avec frontal: Cration d'une station ou du frontal


Pour le frontal CS100 et chaque station S10, S15 ou S50, un automate doit tre cr dans TOPKAPI Vision. Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Ouvrir la fentre Acquisition, slectionner le port cr ci-dessus, puis utiliser la commande menu Edition / Ajouter un automate un port. Dans la bote de dialogue de configuration de l'automate, renseigner les diffrentes zones de la manire suivante: Libell station Texte descriptif libre Type d'automate STANDARD ou CS 100 Numro d'esclave Numro de station (de 1 235), ou 254 pour le frontal CS100 Accs Sans objet En service Indique si la station doit tre scrute Horodat Coche Zones mmoire Saisir des zones mots et bits ncessaires la rcupration des informations du satellite

Le bouton central (sigles >> ou << suivant la liste slectionne) permet de dplacer un port physique d'une liste l'autre. En slectionnant l'onglet Physique, on accde la bote de configuration du port physique slectionn dans la liste des ports utiliss.

Zones mmoire d'une station


Zone Mots 1 Entres analogiques TM, adresses de 1 500, suivies des compteurs TL, partir de 501, et des TR partir de 1001 Zone Mots 2 Informations de bilans, de 2001 15000 Zone Bits 1 Entres logiques TS, adresses de 1 500 et TC, partir de 1001 Zone Bits 2 0 Dans cette bote, communication. renseigner les divers paramtres de

Zones mmoire du frontal


Zone Mots 1

Page E-34

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Table de contrle, de $7D0 $7D1 (2000 - 2001 en dcimal) Zone Mots 2 Sans objet, laisser 0 Zones Bits 1 et 2 Sans objet, laisser 0 Actif

Numro d'esclave utiliser dans la trame. Une valeur nulle indique de prendre le numro d'esclave indiqu dans l'automate TOPKAPI Vision. Choisir Oui pour que la requte soit mise, non pour invalider la requte. Ce champ est modifiable uniquement en configuration, mais permet d'invalider certaines requtes sans avoir l'effacer. Priode Priode d'excution de la requte, en secondes. Saisir ici une valeur entre 15 et 60 secondes, pour laisser prioritaire la requte qui lit les donnes horodates dans le CS100, sous peine de voir ce dernier saturer en cas d'afflux de donnes. Heure action Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM. Spcifique Sans objet.

Base de donnes rseau


Il est possible de lire des informations dans la base de donnes rseau du CS100 SOFREL. Pour cela, il faut ajouter un automate TOPKAPI Vision auquel on donnera le numro d'esclave de la BD rseau paramtr dans le CS100 (de 236 255), et des zones mmoire correspondant aux informations que l'on cherche lire.

7.4. Sofrel avec frontal: Cration des requtes de lectures


Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte.

Adresses JBUS pour une station SOFREL


Adresse 1-500 1001 1-500 501 1001 Type Bits Bits Mots mots doubles mots Description TS (entes logiques) TC (sorties logiques) TM (entres analogiques) TL (compteurs, 1 double mot par voie) TR (sorties analogiques)

Stations
TOPKAPI Vision 32 rcupre automatiquement les informations d'tats courants lorsque celles-ci sont renvoyes par le CS100. Il n'est pas ncessaire dans ce cas de paramtrer de requtes de lectures. Il est nanmoins possible de paramtrer pour chaque station les requtes de lecture des informations grer dans le tableur (entres et sorties logiques et analogiques, compteurs). Ces requtes sont adresses en permanence au frontal, qui rpondra avec les valeurs lues lors de la dernire connexion, ou bien un code d'erreur API non prt si la date de validit des donnes du CS100 est dpasse, auquel cas une tentative de connexion sera automatiquement dclenche. Repre Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire (125 mots ou 2000 bits au maximum). Il ne faut pas lire plus d'informations que n'en sont paramtres dans chaque station. Dbut Adresse de rangement des informations dans TOPKAPI Vision. Permet de ranger des informations n'importe quelle adresse dans les images mmoire de TOPKAPI Vision. Adresse physique Adresse MODBUS de lecture dans la station. C'est l'adresse qui sera utilise dans la trame. Codage Dcrit la faon de dcoder les informations contenues dans la trame. Toujours utiliser le codage standard. Code fonction Type de lecture, parmi

Frontal
Pour le frontal, il faut paramtrer une requte de lecture de la table de contrle. Cette requte dclenchera automatiquement la lecture des donnes horodates prsentes dans le CS100. Cette requte de lecture devra tre associe au Frontal ayant comme numro d'esclave 254 et devra tre compose des lments suivants:

Type de requte: 3 (lecture de n mots) Adresse: $07D0 (valeur hexadcimale = 2000 dcimal ) Nombre: 2 (longueur de la requte ) Priode: 0 (Priodicit de la requte, qui doit tre effectue
le plus souvent possible) Cette table se dcompose de la manire suivante :

Mot 1 (adresse 2000) contient l'adresse o sont stockes les


informations horodates.

Mot 2 (adresse 2001) contient la longueur de ces


informations. Si aucune donne horodate n'est prsente, cette table contiendra la valeur 0. Ds que cette table est diffrente de 0, TOPKAPI Vision dclenche la lecture des donnes horodates disponibles. Les donnes sont rcupres sous forme de blocs structurs appels Units d'Information ( UI ).

1: Lecture de n (= champ longueur) bits internes ou de


sortie

2: Lecture de n (= champ longueur) bits d'entre 3: Lecture de n (= champ longueur) mots internes ou de
sortie (mots de 16 bits)

Mise en garde
La priodicit de scrutation des stations doit tre assez grande, de l'ordre de 15 60 secondes en fonction du nombre de stations scruter, pour laisser prioritaire la requte de lecture des donnes horodates dans le frontal. On risque sinon d'observer une saturation de ce dernier, avec perte Page E-35

4:

ecture de n (= champ longueur) mots d'entre (mots de 16 bits)

5 et 6: Ecriture de 1 bit ou de 1 mot. Sans intrt ici.


Origine TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

d'informations. Il ne faut pas lire dans une station plus d'informations (TS, TM ou TL) que n'en sont rellement configures, sous peine d'observer des erreurs de communication. Il ne faut pas paramtrer de requte de lecture des informations de bilans. Celles ci remontent dans TOPKAPI Vision l'initiative des stations, parmi les blocs de donnes horodates.

dsire et d'un bit de validation dans la base de donnes rseau du CS100

Automatiquement lors de l'envoi d'une tlcommande Automatiquement lorsque la dure de validit des
informations du frontal est dpasse Les appels priodiques sont paramtrs dans le frontal CS100. Les appels sur alarme sont l'initiative des stations.

7.5. Sofrel avec frontal: Fonctions tableur


Adressage des variables
Les entres logiques sont adresses par la syntaxe
#B<adresse>.

Date et heure de dernire connexion


Les informations de date et heure de dernire connexion d'une station sont accessibles dans la base de donnes rseau du CS100, des adresses dpendant du numro de la station (cf. notice SOFREL CS100).

Les entres analogiques seront adresses par la syntaxe


#W<adresse>. Les valeurs lues sont codes sur les 8 bits de poids fort du mot (stations S10 et certains S15), ou sur 16 bits (S50). La formule permettant de rcuprer une valeur l'chelle sera donc (pour la premire entre): #W1*<Echelle maxi>/$FF00 ou #W1*<Echelle maxi>/$FFFF

Statut de connexion
Il n'y a aucun moyen de savoir si une station est couramment connecte au CS100. La seule astuce est de dtecter dans TOPKAPI une variation de la date et heure de dernire connexion. Cette information permet simplement de savoir qu'une station a t connecte, mais on ne peut pas savoir si la connexion est toujours en cours ou non.

Fonction LECDH() de demande de connexion


La fonction LECDH permet de demander une connexion vers la station laquelle est associe la feuille tableur dans laquelle est place la fonction. Lorsqu'une demande de connexion est en cours vers une station, d'autres demandes de connexion vers d'autres stations peuvent tre mmorises. Une seule demande par station peut par contre tre mmorise. LECDH(<BIT>,<VALEUR>) BIT : Ce paramtre permet de dclencher la fonction LECDH. Plusieurs valeurs sont possibles :

Les compteurs seront adresss par la syntaxe #D<adresse>.

Tlcommandes vers un satellite


L'mission d'une tlcommande vers une station par TOPKAPI Vision dclenche automatiquement une tentative de connexion par le frontal CS100, suivie de l'mission par le frontal de la tlcommande vers la station. En cas d'chec de la connexion, la tlcommande est perdue.

Tlcommande vers une station JBUS connecte au CS100


Par dfaut, en protocole SOFBUS, les critures sont faites par des blocs d'informations structures nommes unit d'information de type "C" (consigne), qui permettent sur les postes locaux de tenir compte des informations de forage. Malheureusement, si est connect au CS100 un automate JBUS et non SOFBUS, ces informations de type consigne sont acceptes par le CS100, mais pas retransmises vers le destinataire JBUS. Il faut alors forcer l'utilisation de requtes d'criture simples (fonctions 5/6). Pour ce faire, il faut forcer la valeur d'un mot systme, accessible par la fonction ESYS(condition,valeur,PORTx,-5). La valeur 0 indique l'utilisation de d'U.I. de type C, la valeur 1 indique l'utilisation de fonction simples. Une mthode simple consiste forcer au lancement de TOPKAPI Vision la valeur 1 dans ce paramtre systme, si la notion de forage n'est pas utilise dans les postes locaux. Pour ce faire, entrer dans une cellule quelconque de l'application une cellule contenant comme formule ESYS(NON(LAN(10)),1,PORTx,-5), type entier long. NON(LAN(10)) est une fonction qui passe de 0 1 dix secondes aprs le lancement de TOPKAPI. A ce moment, la valeur 1 est envoye dans le mot systme 5 pour port "x".

0 : La fonction n'est excute que sur demande de


l'oprateur

1 : La fonction est excute sur changement de valeur du


deuxime terme

Variable : La fonction est excute sur passage de 0 1


de cette variable VALEUR : Ce paramtre est sans objet, et peut tre laiss 0. Durant l'excution de TOPKAPI Vision, la fonction LECDH rend la valeur 1 lors du dclenchement de la demande, et 0 sinon.

Fonction COUPURE()
Le frontal CS100 rpond en permanence aux requtes adresses par TOPKAPI Vision chaque station. La fonction COUPURE permet donc simplement de savoir si la connexion avec le frontal CS100 est correcte ou non.

7.6. Sofrel avec frontal: Rcuprations des bilans SOFREL


Principe
Les stations SOFREL (S10, S15, S50) permettent de calculer certaines informations de bilans sur les variables contrles.

Demande de connexion
Une demande de connexion peut tre faite:

Manuellement grce une fonction LECDH() ou DEMCX() Manuellement par tlcommande de la dure de connexion
Page E-36

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Tlmesures:

Moyenne Minimum Maximum


Tlcomptages:

Relev index compteur Comptage sur tranche 1 (heures pointe, bloc type E) Comptage sur tranche 2 (heures creuses, bloc type F) Comptage sur tranche 3 (heures pleines, bloc type G)
Tlsignalisations:

501 + 2*(nTL-1). Les TL tant codes sur des mots doubles, les adresses sont incrmentes de 2 en 2 partir de l'adresse 501. Une moyenne, mini, maxi de TM est accessible par la mme syntaxe que la TM elle mme, seule l'adresse est dcale de 2000 (moyenne), 2500 (minimum), 3000 (maximum). Les autres valeurs de bilan (TS,TL) sont accessibles par la syntaxe #Dxxx (o xxx est gal "Adresse de base" + 2*(nTL-1). Ces valeurs tant codes sur des mots doubles, les adresses sont incrmentes de 2 en 2 partir de l'adresse de base. Exemples: Le nombre d'impulsions de la TS n1 est accessible l'adresse 8001, TS n2 l'adresse 8003, TS n3 l'adresse 8005, TS nn l'adresse 8001+2*(n-1). Le compteur heures de pointes (tranche 1) de la TL n 1 est l'adresse 5001, TL n2 l'adresse 5003, TL n3 l'adresse 8005, TL nn l'adresse 5001+2*(n-1). La valeur moyenne de la TM n1 est accessible l'adresse 2001, TM n2 l'adresse 2002, TS n3 l'adresse 2003, TS nn l'adresse 2000+n.

Comptage nombre de passages l'actif Comptage dure l'tat actif


TOPKAPI Vision permet de rcuprer ces informations horodates de bilans (units d'informations de type 'B'), de les afficher dans le tableur et de les archiver, permettant ainsi toutes sortes de calculs.

Adressage des informations de bilan


Les informations de base (TS,TL,TM) sont accessibles partir des adresses

TS: adresse bit n1 (syntaxe #B1) TM: adresse mot n1 (syntaxe #W1) TL: adresse mot n501 (syntaxe #D501)
Les informations de bilan peuvent tre rcupres partir des adresses TOPKAPI Vision suivantes: Tlmesures:

Valeurs affiches pour les variables bilans


La valeur affiche dans TOPKAPI Vision est la dernire valeur reue lors d'une lecture de donnes horodates.

Archivage des informations de bilan


Rcupration dans les historiques: Pour rcuprer une information dans les historiques, il suffit de cocher dans la cellule de paramtrage de l'information la case historique sur message horodat. Rcupration dans une courbe: Pour rcuprer une information dans une courbe, il suffit de slectionner dans la cellule de paramtrage de l'information la condition d'archivage donnes horodates, de cocher la case Gnrer courbe et d'indiquer le nombre maximum d'enregistrements dsir.

Moyenne: adresse mot n2001 (mots simples) Minimum: adresse mot n2501 (mots simples) Maximum: adresse mot n3001 (mots simples)
Tlcomptages:

Relev index compteur: adresse mot n4001 (mots


doubles)

Comptage sur tranche 1: adresse mot n5001 (mots


doubles)

Comptage sur tranche 2: adresse mot n6001 (mots


doubles)

Rglages optionnels
Les adressages utiliss dans TOPKAPI Vision sont paramtrables, en prvision d'ventuels conflits avec les volutions des matriels SOFREL. Les adresses de base pour chaque type d'information du bilan sont dfinies dans la section SOFREL du fichier TOPKAPI.INI [SOFREL] IndexMoyenneTM= IndexMiniTM= IndexMaxiTM= IndexValeurTL= IndexTranche1TL= IndexTrnache2TL= IndexTranche3TL= IndexCompteurTS= IndexDureeTS=

Comptage sur tranche 3: adresse mot n7001 (mots


doubles) Tlsignalisations:

Comptage nombre de passages l'tat actif: adresse mot


n8001 (mots doubles)

Comptage dure l'tat actif: adresse mot n9001 (mots


doubles) L'adressage dans le tableur devra donc respecter le principe suivant: Une TS est accessible par la syntaxe #Bxxx (o xxx est le numro de la TS). Une TM est accessible par la syntaxe #Wxxx/65280.0*Echelle (o xxx est le numro de la TM, et Echelle l'chelle maximum de celle-ci). Les TM SOFREL en en effet codes sur les 8 bits de poids fort d'un mot de 16 bits. Une TL est accessible par la syntaxe #Dxxx (o xxx est gal TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

2000 2500 3000 4000 5000 6000 7000 8000 9000 Page E-37

Traitement automate Time-out en 1/10mes de seconde

8. Pilote SOFREL Direct


Le pilote SOFREL Direct permet de communiquer avec des stations SOFREL S10, S15, S50 via une liaison RTC ou RS232 ou bien avec des S550 sur un rseau en TCPIP. Une liaison TCPIP (rseau local ou ADSL, par exemple) peut tre secourue par une ou plusieurs liaisons RTC. Le paramtrage passe par les tapes suivantes: Cration du port "logique" et des modems auxquels seront rattaches les stations SOFREL Dclaration de chaque station Dclaration des requtes de lecture d'informations dans les stations Paramtrage des cellules tableur de gestion des stations

Retard l'mission Dlai entre la fin de rception d'une trame et l'mission de la suivante exprim en nombre de caractres. La formule donnant la correspondance entre le nombre de caractres et un temps en secondes sera Temps = (Nb car)*(1+bits donnes+bits parit+bits stop) Vitesse En service Coche (sinon les messages sur le port ne seront pas traits) Le bouton Configuration... permet d'accder la configuration du port logique permettant de spcifier le numro de poste central affect TOPKAPI Vision et le type d'acquittement en fin de communication.

8.1. Sofrel direct: Cration d'un "port logique"


Toutes les stations SOFREL doivent tre rattaches un port "logique" dans TOPKAPI Vision. Ce port n'existe pas forcement physiquement sur l'ordinateur (d'o la dnomination de port logique), mais il se voit attribuer une liste de ports physiques auxquels seront rattachs les modems grer pour assurer la communication avec les stations. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Ouvrir la fentre Acquisition en configuration, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port n'a pas d'importance, utiliser de prfrence un numro de port correspondant l'un de ceux que vous utiliserez pour communiquer. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

Protocole Pilote SOFREL32 Sous protocole DIRECT pour une liaison srie ou par modem RTC TCPIP pour une liaison TCPIP, laquelle ventuellement tre secourue par une liaison RTC

Numro de poste central Cocher la case correspondant au numro de poste central affect TOPKAPI Vision (cette fonctionnalit permet plusieurs postes centraux d'interroger un mme station). peut Acquitter les alarmes Si cette case est coche, les alarmes sont acquittes lors d'un appel en provenance d'une station, et le poste local cesse son report d'astreinte vers quelque destinataire que ce soit. 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Page E-38

Si aucune des deux cases Acquitter les alarmes ou Prendre en comptes les alarmes ne sont coches, le poste local continue son cycle d'astreinte quel que soit le type de destinataire. Prendre en compte les alarmes Si cette case est coche, les alarmes ne sont pas acquittes, mais simplement prises en compte par le poste central. Le poste local cesse alors son report vers les destinataires de type PC ou CS100 , mais continue son report vers les autres destinations de type Minitel ou Radiomessagerie. Si aucune des deux cases Acquitter les alarmes ou Prendre en comptes les alarmes ne sont coches, le poste local continue son cycle d'astreinte quel que soit le type de destinataire. Ignorer le journal des alarmes Cette case permet comme son nom l'indique de ne pas lire les informations du journal des alarmes, qui forment un doublon avec le journal des TS dans la station. Interrogation cyclique des stations Lorsque la liaison avec les stations est de type permanente (liaison srie, LS ou TCPIP), le fait de cocher cette case permet d'interroger cycliquement les stations dclares sur le port. Si elle n'est pas coche, il faudra paramtrer des fonctions DEMCX(), LECDH() ou des tlcommandes pour provoquer une session de communication avec une station, la liaison sera au repos le reste du temps. Pause entre l'interrogation de deux stations Lorsque la liaison avec les stations est de type permanente et que l'interrogation cyclique est coche, ce dlai est un temps de silence respecter entre la fin d'une session de communication avec une station et la session de communication avec la station suivante. Pause entre deux cycles d'interrogation des stations Lorsque la liaison avec les stations est de type permanente et que l'interrogation cyclique est coche, ce dlai est un temps de silence respecter lorsque toutes les stations dclares sur le port ont t interroges, avant de reprendre la premire station de la liste. Gnrer fichiers SOFRELxxx.LOG Les fichiers SOFRELxxx.LOG, placs dans le rpertoire de l'application, contiennent la description des trames reues et mises par TOPKAPI Vision, et permettent de diagnostiquer d'ventuels problmes de communication. Nombre de tentatives d'mission avant erreur Ce paramtre permet de modifier le nombre de tentatives d'mission d'une trame avant de gnrer une erreur de communication et donc d'abandonner de terminer la connexion en cours. Ceci peut permet d'amliorer la communication avec les stations lorsque les liaisons tlphoniques sont de mauvaise qualit (GSM particulirement). Les fichiers SOFRELxxx.LOG permettent de diagnostiquer aisment de tels problmes. La valeur doit tre comprise entre 1 et 20. Utiliser d'abord 3, puis 5, et enfin 10 si les problmes de communication subsistent. Ports physiques Accde la bote suivante, dans laquelle on paramtre les ports utiliss pour communiquer avec les stations

RS232 Permet de dialoguer en direct avec un S10, S15 ou S50. LS (+RTC) Sans objet, ne pas utiliser. RTC Dclarer dans la liste des ports utiliss tous les ports sur lequel seront connects les modems RTC grer pour communiquer avec les stations S10, S15 ou S50. TOPKAPI Vision utilisera pour une connexion sortante le premier modem disponible, et acceptera des connexions entrantes n'importe quel modem. RAS Sans objet, ne pas utiliser. Pour changer le type de port, il faut au pralable supprimer le ou les ports physiques dj utiliss. Dans le cas d'une liaison TCPIP, il n'est pas ncessaire de dclarer de port (la liste de gauche des ports utiliss doit donc tre vide), sauf dans le cas o un secours RTC est prvu. Dclarer dans ce cas le ou les ports correspondants aux modems utiliss pour le secours. Les champs Nombre de tentatives, et Dlai entre tentatives permettent de rgler le comportement de TOPKAPI lorsqu'un appel sortant choue. Le bouton central (sigles >> ou << suivant la liste slectionne) permet de dplacer un port physique d'une liste l'autre. En slectionnant l'onglet Physiques, on accde la bote de configuration du port physique slectionn dans la liste des ports utiliss.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-39

Dans cette bote, renseigner les divers paramtres de communication. Le format de donnes utiliser est 9600 bauds, 8 bits de donnes, sans parit, un bit de stop. La case Contrle de flux doit tre laisse sur Sans. La zone Mode d'utilisation du port permet, lorsque plusieurs modems sont disponibles, de rserver l'utilisation du port aux appels entrants, sortants ou les deux. Faire attention ne pas rserver tous les modems aux appels entrants, sous peine de ne plus pouvoir dclencher d'appel l'initiative de TOPKAPI, ou tous les modems aux appels sortants, sous peine de ne plus pouvoir recevoir d'alarmes. L'onglet Modem permet de slectionner le modem que vous utilisez.

Le bouton Nouveau permet de crer un nouveau type de modem, le bouton Configurer permet de modifier les paramtres du modem slectionn.

8.2.

Sofrel direct: Paramtres modem

La connexion aux stations S10 se fait en V21 (300 bps), la connexion aux stations S15, S50 et S500 se fait en V22 (1200 bps) jusque V34 bis (33600 bps, S50 ou S500), et enfin la connexion aux stations GSM se fait en V32 (9600 bps). Il est possible d'utiliser tout modem HAYES standard pour communiquer en V22. Par contre le mode V21 n'est pas support par tous les modems. Il est donc fortement conseill d'utiliser le modem GENER GE425 ou GENER GE934, qui ont t valids par AREAL. Il est possible de faire coexister des stations de toute nature (S10, S15, S50, GSM), au prix d'une lgre complexit de paramtrage. Nous donnerons ci-aprs un exemple de paramtrage pour des stations V21 et V22, V23 et GSM mlanges. Seul le modem GENER GE934 permet de se connecter aux stations GSM.

Page E-40

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Modem GENER GE425 en V21, V22 ou V23 (S10, S15 ou S50, Telbox)

Modem CXR AJ2885P

On fera prcder le numro de tlphone des stations en V21 (S10) du prfixe 1@ , celui des stations en V22 (S15 ou S50) du prfixe 2@ et enfin celui des stations TELBOX du prfixe 3@.

Modem GENER GE934 en V21, V22, V23 ou V32 (S10, S15 S50 ou S500, Telbox, Celbox GSM)

La chane d'initialisation complte est X4 %H3 %B1 S7=60 S95=60 *E0. La chane 2@ est AT%H1@A2@M0*M1. La chane 3@ est AT%H1@A2@M1*M1. On fera prcder le numro de tlphone des stations en V22 (S15 ou S50 modem R2 1200) du prfixe 3@, celui des stations en V21 (S10) du prfixe 2@, celui des stations TELBOX, S50 (modem R2 33600 ou R3) du prfixe 1@. On n'utilisera pas de prfixe pour les stations CELLBOX (GSM) ou S500 (GSM ou RTC).

Choix du type de modulation dans les stations


Il faut veiller paramtrer dans les stations le bon type d'appel: il faut slectionner Poste central ou CS100 comme type d'agent d'astreinte, et choisir la modulation V21 (S10), V22 (S15 ou S50), V32 (GSM). Ne jamais utiliser la modulation V23R, rserve pour la communication avec un CS100, et que ne supporte pas TOPKAPI Vision.

8.3. Sofrel direct: Cration d'un automate


Pour chaque station S10, S15, S50 ou S500 doit tre cr dans TOPKAPI Vision un automate. Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Ouvrir la fentre Acquisition, slectionner le port logique cr auparavant, puis utiliser la commande menu Edition / Ajouter un automate un port. Dans la bote de dialogue de configuration de l'automate, renseigner les diffrentes zones de la manire suivante: Type d'automate STANDARD Numro d'esclave Numro d'esclave de la station Accs RTC: Numro de tlphone o joindre la station TCPIP: Adresse IP ou nom de d'hte de la station. Dans le cas d'un secours RTC pour une station TCPIP, le numro de tlphone est directement renseign dans la fonction DEMCX() permettant d'appeler la station. TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

La chane d'initialisation complte est X4 V1 &I1 %C0 N3 !J0 #R5=25 \N3 W1. On fera prcder le numro de tlphone des stations en V22 (S15 ou S50) du prfixe 1@, celui des stations en V21 (S10) du prfixe 2@, celui des stations TELBOX du prfixe 3@ et enfin celui des stations CELBOX (GSM) ou des S500 du prefixe 4@.

Page E-41

En service Coche (sinon pas communication possible) Horodat Coche (sinon pas d'archivage des donnes horodates) Zones mmoires Saisir des zones mots et bits ncessaires la rcupration des informations du satellite

Utilisation de requtes
Vous pouvez ventuellement (voir ci-dessus) paramtrer pour chaque station les requtes de lecture des informations grer dans le tableur (entres et sorties logiques et analogiques, compteurs). Ces requtes seront adresses la station lors de chaque connexion, pour rafrachir l'image temps rel de celle-ci Repre: Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire (125 mots ou 2000 bits au maximum). Il ne faut pas lire plus d'informations que n'en sont paramtres dans chaque station. Dbut Adresse de rangement des informations dans TOPKAPI Vision. Permet de ranger des informations n'importe quelle adresse dans les images mmoire de TOPKAPI Vision. Adresse physique Adresse MODBUS de lecture dans la station. C'est l'adresse qui sera utilise dans la trame. Codage Dcrit la faon de dcoder les informations contenues dans la trame. Toujours utiliser le codage standard.

Zones mmoire d'une station


Zone Mots 1 Entres analogiques TM, adresses de 1 1500, suivies des compteurs TL, partir de 501, et des TR partir de 1001 Zone Mots 2 Informations de bilans, de 2001 1000 suivies des TM et TL issues de S500 Zone Bits 1 Entres logiques TS, adresses de 1 1000 suivies des sorties logiques TC, partir de 1001 Zone Bits 2 0

Code fonction Type de lecture, parmi

1: Lecture de n (= champ longueur) bits internes ou de


sortie

2: Lecture de n (= champ longueur) bits d'entre 3: Lecture de n (= champ longueur) mots internes ou de
sortie (mots de 16 bits)

4: Lecture de n (= champ longueur) mots d'entre (mots


de 16 bits)

5 et 6: Ecriture de 1 bit ou de 1 mot. Sans intrt ici. Origine Numro d'esclave utiliser dans la trame. Une valeur nulle indique de prendre le numro d'esclave indiqu dans l'automate TOPKAPI Vision.
Actif Choisir Oui pour que la requte soit mise, non pour invalider la requte. Ce champ est modifiable uniquement en configuration, mais permet d'invalider certaines requtes sans avoir l'effacer. Priode Priode d'excution de la requte, Gnralement, saisir une valeur nulle. en secondes.

8.4. Sofrel direct: Cration des requtes de lecture


Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte.

Rcupration des tats courants


Par dfaut, si aucune requte n'est paramtre, le pilote TOPKAPI Vision 32 rcupre automatiquement les tats courants de la station. C'est le mode le plus simple. Cependant, si vous voulez lire certaines informations comme les valeurs des TC/TR, ou l'heure d'un S50, qui ne sont pas inclues dans les tats courants, vous devrez obligatoirement paramtrer des requtes de lecture. Vous pouvez ne paramtrer que les requtes ncessaires pour lire les informations autres que les tats courants (heure, TC, calendriers etc.). Le mcanisme de rcupration automatique des tats courant se charge de rcuprer ces derniers. Par contre, pour des raisons de compatibilit ascendante, la prsence de requtes concernant les TS, TM ou TL invalide le traitement des tats courants.

Heure action Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM. Spcifique Sans objet.

Page E-42

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Adresses JBUS pour une station SOFREL S10, S15 ou S50


Adresse 1-500 1001 1-500 501 1001 Type Bits Bits Mots mots doubles mots Description TS (entes logiques) TC (sorties logiques) TM (entres analogiques) TL (compteurs, 1 double mot par voie) TR (sorties analogiques)

8.5. Sofrel direct: Autoparamtrage avec Softlink


L'assistant Softlink peut tre utilis pour importer dans TOPKAPI des fichiers de configuration crs avec Softools de Sofrel (utiliser la commande d'export de configuration au format texte). Lors du choix du fichier importer, trois formats propres SOFREL sont proposs:

Sofrel files Sofrel Cellbox (sms) files Sofrel S500 files


Le premier choix correspond des stations de type BOX, S10, S15 ou S50. Le second choix correspond ces stations de type CELBOX transmettant leurs informations par SMS, et ne doit pas tre utilis ici. Le troisime choix correspond des stations de type S500, dans lequel les informations de type bilan n'existent pas et comportant potentiellement des TM de numro suprieur 500 et des TL de numro suprieur 250, pour lesquelles un offset est ajout dans l'adresse TOPKAPI pour viter les chevauchements avec les TR. Les informations importes se voient affecter un mnmonique sous la forme TS_xxx, TM_xxx, TL_xxx, TC_xxx ou TR_xxx o xxx est le numro de l'information. Il est indispensable de cocher la case Ajouter code automate aux mnmoniques pour viter de crer des doublons lorsqu'au moins deux stations sont importes. Note importante concernant les alarmes Rien dans le fichier gnr par Softools ne permet de distinguer les alarmes des simples TS. Il faut donc surcharger manuellement type propos par Softlink pour transfert une information en alarme.

Adresses JBUS pour une station SOFREL S500


Adresse 1-1000 1001 1-500 501-999 42001 Type Bits Bits Mots mots doubles Mots Description TS (entes logiques) TC (sorties logiques) TM (entres analogiques) TL (compteurs, 1 double mot par voie) TR (sorties analogiques)

Le S500 peut contenir plus de 500 TR et plus de 250 TL mais ces informations ne peuvent tre lues par une requte JBUS. Seul le mode sans requtes permet d'acqurir ces informations aux adresses dfinies ci-dessous. Les TR peuvent tre lus l'adresse 42001 et non 1001, comme dans les versions antrieures. Il faut pour des raisons de cohrence crer une requte de lectures de ces TR en utilisant 1001 comme adresse dbut et 42001 comme adresse physique.

Adresses TOPKAPI pour une station SOFREL S500


Adresse 1-1000 1001 1-500 1050111000 501-999 1100113499 1001 Mots Type Bits Bits Mots Description TS (entes logiques) TC (sorties logiques) TM1 TM500 (entres analogiques) TM501 TM1000 TL1 TL250 (compteurs, 1 double mot par voie) TL251 TL1000 TR (sorties analogiques)

8.6. Sofrel direct: Paramtrage de la station


Pour que TOPKAPI puisse rcuprer les informations historises dans une station SOFREL, il est obligatoire de vrifier que dans cette dernire, les informations d'historiques doivent tre retransmises vers TOPKAPI. Ces paramtres sont accessibles dans la station par le menu Paramtrage / Archivages / Paramtres complmentaires pour archivage PC / Transmission des journaux vers le poste central. Placer Oui la transmission du journal des TS et Non la retransmission du journal des alarmes.

Mots doubles

Mise en garde
Limiter la longueur des requtes de lecture au nombre d'informations rellement disponibles dans la station, sous peine de ne pouvoir communiquer avec la station (raccrochage intempestif).

Rcupration des informations de bilans


Les adresses utilises pour stocker les informations de bilans SOFREL sont propres TOPKAPI Vision. Il n'y a ce titre aucune requte paramtrer pour rcuprer ces informations. Le S500 fonctionne diffremment des modles antrieurs, car les informations de bilans sont rcupres dans des TL standard, pas les adresses spciales utilises par TOPKAPI.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-43

dforc. -4 -5 Dure au bout de laquelle une tlcommande envoy dans le mode 1 ci-dessus repassera en mode dforc 0: 1: Utilisation de bloc structurs (valeur + forage) Utilisation de requtes simples (fonctions 5/6)

Demande de connexion
Cas d'une liaison par RTC: la demande de connexion une station se fait grce la fonction DEMCX(). Les appels sur dfaut sont l'initiative des stations. Cas d'une liaison TCPIP (rseau local ou ADSL): Il n'est pas ncessaire de paramtrer de fonction DEMCX, sauf si un secours RTC est prvu. Dans ce cas, Les appels RTC entrants seront automatiquement pris en compte, et il sera possible de demander une connexion RTC sortante par activation de cette fonction. Fonction DEMCX(Condition,Valeur,Chane1) Sur variation de Condition ou variation de Valeur (Condition tant 1), dclenche une demande de connexion (Condition=1) ou de dconnexion(Condition=0, si l'option Ignorer les fronts descendants de la fonction DEMCX n'est pas coche dans les paramtres gnraux de l'application), chane tant le repre automate de la station appeler suivi du caractre " (exemple T1") ou bien le numro de tlphone de la station appeler (cas du secours RTC). Valeur exprime en minutes spcifie la dure maximum de la communication. Une demande de connexion avec une dure 0 provoque juste un rafrachissement des valeurs temps rel. Une demande de connexion avec dure -1 entrane une dure de communication minimale (un rafrachissement des valeurs temps rel, suivi d'une lecture des donnes horodates). Fonctionnement: Condition 1 Valeur 0 Action Appel simple : excuter une seule fois chaque requte puis raccrocher. Les donnes horodates ne sont pas rcupres 1 1 >0 -1 Appel continu pendant <vmot> minutes puis raccrocher Appel avec rcupration des donnes horodates et raccrochage le plus rapidement possible Dconnexion si communication en cours ou dpilage de la liste des appels en attente, uniquement si la case "Ignorer les fronts descendants de la fonction DEMCX" n'est pas coche

8.7.

Sofrel direct: Fonctions tableur

Adressage des variables


Les entres logiques sont adresses par la syntaxe
#B<adresse>.

Les entres analogiques seront adresses par la syntaxe


#W<adresse>. Les valeurs lues sont codes sur les 8 bits de poids fort du mot (stations S10 et certains S15), ou sur 16 bits (S50). La formule permettant de rcuprer une valeur l'chelle sera donc (pour la premire entre): #W1*<Echelle maxi>/$FF00 ou #W1*<Echelle maxi>/$FFFF

Les compteurs seront adresss par la syntaxe #D<adresse>.

Modification dynamique du fonctionnement des tlcommandes


Pour tlcommander une valeur dans une station, il faut au pralable demander une connexion vers la station concerne. Une tlcommande consiste en l'envoi d'un bloc d'informations comportant la fois la valeur crire, et une informations de forage. Il est possible de modifier le fonctionnement des tlcommandes par utilisation de la fonction ESYS(vbit,vmot,PORTx, <code>) PORTx tant le port logique sur lequel le protocole est utilis. On peut par exemple, pour une station donne, utiliser la formule ESYS(COUPURE(XX")=0,valeur,PORTx,code) qui forcera une valeur de paramtre chaque connexion la station XX. Code -3 Valeur 0: La tlcommande est envoye en mode forc (mode par dfaut) 1: La tlcommande est envoye en mode forc, et repassera en mode dforc au bout d'un temps paramtr grce au code 4 (voir cidessous) 2: La tlcommande est envoye en mode

Remarque: Pas de connexion / dconnexion possible pour les ports type RS232

Contrle des connexions


Fonction COUPURE(<refAPI>") Cette fonction est tendue la notion d'tat de connexion Valeur tat de la connexion

Page E-44

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

0 1 2 3 4 5 6 7

En connexion, possibilit tlrglages, tlcommandes Dconnect (position repos)

de

passer

des

Demande de connexion en cours de traitement En connexion simple (rafrachissement initial), pas de tlcommande possible Non utilis Non utilis Non utilis Temps de connexion dpass, fin de lecture des donnes horodates

alarmes). Toutefois il est possible pour une connexion donne de forcer le mode d'acquittement grce la fonction ESYS(vbit,vmot,PORTx,-2) qui gre le mot n 2 spcifique au protocole SOFREL. Ce mot peut prendre les valeurs suivantes:

0: Alarmes prises en compte mais non acquittes 1: Alarmes acquittes 2: Alarmes non prises en compte ni acquittes
L'criture l'une valeur 0, 1 ou 2 dans ce mot change le mode paramtr par dfaut. L'intrt de cette fonction est de pouvoir choisir un mode d'acquittement diffrent pour chaque station. On modifiera alors la valeur du mot en fonction de la station connecte: ESYS(COUPURE(XX")=0,1,PORT1,-2) force par exemple l'acquittement des alarmes sur passage en connexion complte de la station XX relie au port logique numro 1.

Diagramme temporel d'une connexion

Lecture des donnes horodates


La lecture des donnes horodates est :

automatique pour les liaisons RTC automatique pour les liaisons RS232 / TCPIP o aucune
requte n'est configure

via la fonction LECDH() pour les liaisons RS232 / TCPIP


o des requtes sont configures Lecture de la table de contrle Connexion simple: mission une fois de chaque requte temps rel configure Connexion complte: lecture des donnes horodates si disponibles, et lecture des tats temps rels. Des tlcommandes peuvent tre envoyes vers la station Acquittement des alarmes et mise a l'heure de la station Poursuite de l'acquisition temps rel s'il reste du temps Raccrochage

8.8. Sofrel direct: Rcuprations des bilans SOFREL


Principe
Les stations de marque SOFREL (S10, S15, S50) permettent de calculer certaines informations de bilans sur les variables contrles. Le S500 fonctionne diffremment des modles antrieurs, car les informations de bilans sont rcupres dans des TL standard, pas les adresses spciales utilises par TOPKAPI. Tout le chapitre ciaprs peut donc dans ce cas tre ignor. Tlmesures:

Etat de la dernire connexion


La fonction SYS(XX",5) permet de rcuprer dans le tableur l'tat de la dernire connexion la station repre par le code XX". Les diffrentes valeurs rendues par cette fonction sont: Valeur 0 1 2 3 4 5 6 tat de la connexion La dernire connexion sortante s'est bien passe. Tout est correct. La dernire connexion sortante a chou, mais il y aura au moins une autre tentative d'appel. Inutilis Inutilis La dernire connexion entrante s'est bien passe. Tout est correct. La dernire connexion entrante a chou. La dernire connexion sortante a chou, et il n'y aura plus d'autre tentative d'appel

Moyenne Minimum Maximum


Tlcomptages:

Relev index compteur Comptage sur tranche 1 (heures pointe, bloc type E) Comptage sur tranche 2 (heures creuses, bloc type F) Comptage sur tranche 3 (heures pleines, bloc type G)
Tlsignalisations:

Comptage nombre de passages l'actif Comptage dure l'tat actif


TOPKAPI Vision permet de rcuprer ces informations horodates de bilans (units d'informations de type 'B'), de les afficher dans le tableur et de les archiver, permettant ainsi toutes sortes de calculs.

Modification dynamique du mode d'acquittement


Le mode d'acquittement est dtermin par la configuration du port logique (cases Acquitter les alarmes et Prendre en compte les TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-45

Restriction importante
TOPKAPI ne sait traiter avec cohrence qu'un seul niveau de bilan issu calcul dans la station. Il faut donc veiller dans celle-ci ne paramtrer que des bilans journaliers, par exemple, et ne pas valider les bilans hebdomadaires, mensuels et priodiques. Le compteur heures de pointes (tranche 1) de la TL n 1 est l'adresse 5001, TL n2 l'adresse 5003, TL n3 l'adresse 8005, TL nn l'adresse 5001+2*(n-1). La valeur moyenne de la TM n1 est accessible l'adresse 2001, TM n2 l'adresse 2002, TS n3 l'adresse 2003, TS nn l'adresse 2000+n.

Adressage des informations de bilan


Les informations de base (TS, TL, TM) sont accessibles partir des adresses

TS: adresse bit n1 (syntaxe #B1) TM: adresse mot n1 (syntaxe #W1) TL: adresse mot n501 (syntaxe #D501)
Les informations de bilan peuvent tre rcupres partir des adresses TOPKAPI Vision suivantes: Tlmesures

Valeurs affiches pour les variables bilans


La valeur affiche dans TOPKAPI Vision est la dernire valeur reue lors d'une lecture de donnes horodates.

Archivage des informations de bilan


Rcupration dans les historiques Pour rcuprer une information dans les historiques, il suffit de cocher dans la cellule de paramtrage de l'information la case historique sur message horodat. Rcupration dans une courbe Pour rcuprer une information dans une courbe, il suffit de slectionner dans la cellule de paramtrage de l'information la condition d'archivage donnes horodates, de cocher la case Gnrer courbe et d'indiquer le nombre maximum d'enregistrements dsir.

Moyenne: adresse mot n2001 (mots simples) Minimum: adresse mot n2501 (mots simples) Maximum: adresse mot n3001 (mots simples)
Tlcomptages

Relev index compteur: adresse mot n4001 (mots


doubles)

Comptage sur tranche 1: adresse mot n5001 (mots


doubles)

Rglages optionnels
Les adressages utiliss dans TOPKAPI Vision sont paramtrables, en prvision d'ventuels conflits avec les volutions des matriels SOFREL. Les adresses de base pour chaque type d'information du bilan sont dfinies dans la section SOFREL du fichier TOPKAPI.INI [SOFREL] IndexMoyenneTM= IndexMiniTM= IndexMaxiTM= IndexValeurTL= IndexTranche1TL= IndexTrnache2TL= IndexTranche3TL= IndexCompteurTS= IndexDureeTS=

Comptage sur tranche 2: adresse mot n6001 (mots


doubles)

Comptage sur tranche 3: adresse mot n7001 (mots


doubles) Tlsignalisations

Comptage nombre de passages l'tat actif: adresse mot


n8001 (mots doubles)

Comptage dure l'tat actif: adresse mot n9001 (mots


doubles) L'adressage dans le tableur devra donc respecter le principe suivant: Une TS est accessible par la syntaxe #Bxxx (o xxx est le numro de la TS). Une TM est accessible par la syntaxe #Wxxx/65280.0*Echelle (o xxx est le numro de la TM, et Echelle l'chelle maximum de celle-ci). Les TM SOFREL en en effet codes sur les 8 bits de poids fort d'un mot de 16 bits. Une TL est accessible par la syntaxe #Dxxx (o xxx est gal 501 + 2*(nTL-1). Les TL tant codes sur des mots doubles, les adresses sont incrmentes de 2 en 2 partir de l'adresse 501. Une moyenne, mini, maxi de TM est accessible par la mme syntaxe que la TM elle mme, seule l'adresse est dcale de 2000 (moyenne), 2500 (minimum), 3000 (maximum). Les autres valeurs de bilan (TS,TL) sont accessibles par la syntaxe #Dxxx (o xxx est gal "Adresse de base" + 2*(nTL-1). Ces valeurs tant codes sur des mots doubles, les adresses sont incrmentes de 2 en 2 partir de l'adresse de base. Exemples: Le nombre d'impulsions de la TS n1 est accessible l'adresse 8001, TS n2 l'adresse 8003, TS n3 l'adresse 8005, TS nn l'adresse 8001+2*(n-1). Page E-46

2000 2500 3000 4000 5000 6000 7000 8000 9000

8.9.

Sofrel direct: Messages possibles

TOPKAPI Vision peut signaler des messages propres au protocole: Echec appel sortant : XX : Echec phase de reconnaissance de l'automate distant XX. Echec appel entrant ! : Tentative de connexion entrante d'une station inconnue Appel sortant : XX : Connexion sortante avec la station XX Appel entrant : XX : Connexion entrante avec la station XX

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

9. Pilote TBOX
9.1. TBox: Prsentation

Le protocole TBOX TOPKAPI permet de dialoguer avec un automate de type TBOX en mode local (liaison srie ou TCPIP), ou par liaison RTC.

9.2.

TBox: Cration d'un port

Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Crer un port correspondant au port srie utilis pour le dialogue. Utiliser les paramtres suivants:

Tester prsence porteuse (RTC) Doit tre coche lorsque la liaison avec la station est faite par RTC. Permet de tester l'tat de la connexion, et donc de dtecter plus rapidement une perte de liaison. Gnrer fichiers TBOXxxx.LOG Gnre dans le rpertoire de l'application des fichiers nomms TBOXxxx.LOG (un par port) dans lesquels sont inscrites les trames changes avec les automates. Chaque fichier peut atteindre une taille maximale de 10 Mo. Ensuite, les informations les plus anciennes sont effaces Configuration des ports Accde la bote suivante, dans laquelle on paramtre les ports utiliss pour communiquer avec les automates

Protocole: TBOX32 Sous protocole RS232 pour une liaison srie ou par modem TCPIP pour une liaison par rseau local ou ADSL Retard l'mission Dlai en ms entre deux missions Traitement automate Indique le temps pendant lequel TOPKAPI Vision attend la rponse une requte, en plus du temps ncessaire la transmission des informations. Une valeur de l'ordre de 40 10mes de seconde est raisonnable, mais peut tre augmente si ncessaire. Une valeur trop grande n'a aucune incidence sur la rapidit d'acquisition. En service Cocher cette case pour valider l'acquisition sur le port, sinon aucun dialogue n'aura lieu. Configuration Permet d'accder la configuration des paramtres spcifiques au protocole TBOX

RS232 Permet de dialoguer en direct avec un automate. LS (+RTC) Sans objet, ne pas utiliser. RTC

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-47

Dclarer dans la liste des ports utiliss tous les ports sur lesquels seront connects les modems RTC grer pour communiquer avec les stations P200 ou P200X. TOPKAPI Vision utilisera pour une connexion sortante le premier modem disponible, et acceptera des connexions entrantes n'importe quel modem. RAS Sans objet, ne pas utiliser. Pour changer le type de port, il faut au pralable supprimer le ou les ports physiques dj utiliss. Dans le cas d'une liaison TCPIP, il n'est pas ncessaire de dclarer de port (la liste de gauche des ports utiliss doit donc tre vide). Les champs Nombre de tentatives, et Dlai entre tentatives permettent de rgler le comportement de TOPKAPI lorsqu'un appel sortant choue. Le bouton central (sigles >> ou << suivant la liste slectionne) permet de dplacer un port physique d'une liste l'autre. En slectionnant l'onglet Physique, on accde la bote de configuration du port physique slectionn dans la liste des ports utiliss.

L'onglet Modem permet de slectionner le modem que vous utilisez.

Le bouton Nouveau permet de crer un nouveau type de modem, le bouton Configurer permet de modifier les paramtres du modem slectionn. Il est possible d'utiliser quasiment tout modem. Les paramtres suivants seront valides dans la majorit des cas.

Dans cette bote, renseigner les divers paramtres de communication. Le format de donnes utiliser est 9600 bauds, 8 bits de donnes, sans parit, un bit de stop. Une vitesse suprieure peut tre slectionne si ncessaire. La case Contrle de flux doit tre laisse sur Sans. La zone Mode d'utilisation du port permet, lorsque plusieurs modems sont disponibles, de rserver l'utilisation du port aux appels entrants, sortants ou les deux. Faire attention ne pas rserver tous les modems aux appels entrants, sous peine de ne plus pouvoir dclencher d'appel l'initiative de TOPKAPI, ou tous les modems aux appels sortants, sous peine de ne plus pouvoir recevoir d'alarmes. Page E-48

9.3.

TBox: Cration d'un automate

Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Dans le configurateur, crer un automate sur le port ci-dessus. Utiliser les paramtres suivants:

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

IOW I4M AIR ATP ACP ATV ACV ECH SPE STB TOT FLT STO Numro d'esclave Numro d'esclave Type automate STANDARD Zones mots 1 et 2 0 03FF, et 5000 - 6978. La zone 0-03FF recevra les I/O de type analogique (#E / #F) et la zone partir de 5000 recevra les registres spciaux Zone bit 1 0 - 2710. La zone recevra les I/O de type digitale (#B) Zone bit 2 5000 -7148. La zone recevra les registres spciaux de type digitaux (#B) Accs Numro de tlphone pour les stations RTC ou adresse IP pour les stations TCPIP suivie optionnellement du nom de l'utilisateur et du code accs, chacun spar par :' Horodat Cocher si vous souhaiter rapatrier les donnes horodates de la station Les autres champs sont dcrits dans le chapitre C, et n'ont aucun rapport avec le protocole utilis.

8192 + n du canal 16384 + n du canal 20480 + n du registre 20736 + n du timer 20992 + n du compteur 21248 + n du timer 21504 + n du compteur 21760 + n de la table -1 22016 + n de la variable SPE 22272 + n registre 22764 + n du totalisateur 23040 + (n registre * 2) 26624 + n du registre de stockage

9.5.

TBox: Requtes de lecture

Les requtes de lecture doivent normalement tre automatiquement gnres par TOPKAPI. Cependant, lors de l'ajout de stations TBOX sur une application dveloppe initialement sur une version de TOPKAPI antrieure la version 4.0, il est possible que le mcanisme de gnration automatique des requtes soit invalid pour le protocole TBOX32. Pour le valider nouveau, ouvrir avec le bloc-notes de Windows le fichier PROTOMAP.DAT prsent dans le dossier des excutables TOPKAPI (C:\Program Files\Vision32 par dfaut). Dans la section [REQUETES], vrifier la prsence et ajouter si besoin le protocole TBOX32 dans la liste des protocoles pour lesquels la gnration automatique des requtes est valide.

9.4.

TBox: Table des adresses Modbus

Portes digitales
Types IOD 4mA DIR DTI DCN SPE STD Adresse ModBus (n bloc * 256)+(n module * 32) + n du canal 8192 + n du canal 20480 + n du registre 22528 + n du timer 22784 + n du compteur 28160 + n de la variable SPE 28672 + n de registre Arrter et relancer TOPKAPI pour que la modification soit prise en compte. Il n'est pas ncessaire de modifier les requtes gnres automatiquement, sauf optimiser celles-ci en regroupant au sein d'une mme "grosse" requte plusieurs "petites" requtes. Les codes fonctions utilisables dans les requtes sont de deux natures: Un code fonction "gnrique", qui utilise l'adresse d'une information pour connatre sa nature Un code fonction "spcialis", un par nature d'information, qui utilise comme adresse le rang de l'information parmi les informations de mme type.

Portes analogiques
Types IOB Adresse ModBus (n bloc * 256)+(n module * 32) + n du canal

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-49

En mode RTC
La lecture des donnes horodates de la station est dclenche automatiquement la connexion de la station.

TBox: Acquisition des tables d'chantillons de la TBOX


Topkapi Vision ne fait pas de distinction de type d'chantillonnage (min, max, instantan, etc), donc pour une variable donne, toutes les tables d'chantillonnage sont stockes la mme adresse. Dans les conditions d'archivage il faudra donc choisir le bon type parmi :

Donnes Horodates (valeur instantane) Donnes Horodates Min (valeur mini) Donnes Horodates Max (valeur maxi) Donnes Horodates Moy (valeur moyenne) (cf. notice constructeur pour plus de dtails)

TBox: Etat de la lecture des donnes horodates


Chaque information peut donc tre lue de deux faon: par la fonction gnrique ou la fonction spcialise. Par exemple, le premier registre analogique STO peut tre lu par la fonction Lecture STO l'adresse 0, ou par la fonction Lecture n valeurs ana (16 bits) l'adresse 26624. Les requtes gnres automatiquement par TOPKAPI utilisent les fonctions gnriques. La fonction SYS(PortX, -2*numesc) o X est le numro du port sur lequel est connect la station TBOX et numesc son numro d'esclave, permet d'indiquer l'tat de la lecture des donnes horodates lors d'une connexion une station. Le rsultat vaut 1 si la lecture des donnes horodates est en cours et 0 sinon. Cette fonction permet principalement de signaler l'oprateur si le passage de tl-rglages ou de tlcommandes est possible. Noter que si des tlcommandes automatiques sont gnres au cours d'une connexion, elles seront empiles et automatiquement mises avant raccrochage.

9.6.

TBox: Requtes d'criture

Les requtes d'criture sont gnres automatiquement par TOPKAPI lors d'une tlcommande (cf. fonction TELEC()). TOPKAPI dterminera la fonction d'criture utiliser en fonction de l'adresse destination : Il faut utiliser comme adresse de destination l'adresse ModBus dans la TBOX (voir la table d'adressage plus tt dans cette notice).

TBox: Demande de connexion


La demande de connexion une station se fait grce la fonction DEMCX(). Les appels sur dfaut sont l'initiative de la station. Fonction DEMCX(Condition,Valeur,Chane1) Sur variation de Condition ou variation de Valeur (Condition tant 1), dclenche une demande de connexion (Condition=1) ou de dconnexion (Condition=0) vers la station repre par chane1 (repre automate suivi du caractre ", exemple T1"). Valeur exprime en minutes spcifie la dure maximum de la communication. Une demande de connexion avec une dure nulle entrane une dure de communication minimale (juste un rafrachissement des valeurs temps rel, suivi ventuellement d'une lecture des donnes horodates). Fonctionnement Condition 1 1 Valeur 0 <>0 Action Appel simple : excuter une seule fois chaque requte puis raccrocher Appel continu pendant <vmot> minutes puis raccrocher Si dj connect : <vmot> = nouveau temps de connexion

9.7.

TBox: Fonctions tableur

Adressage des informations


Les valeurs digitales sont adresses par la syntaxe #B. Les valeurs analogiques entires sont adresses par la syntaxe #E. Les valeurs analogiques rels sont adresses par la syntaxe #F.

TBox: Lecture des donnes horodates En mode local


La lecture des donnes horodates de la station doit tre dclenche explicitement grce la fonction LECDH(). Fonction LECDH(Condition, valeur) Sur front montant de Condition ou variation de Valeur (Condition tant 1), dclenche le mcanisme d'acquisition des donnes horodates. Si la liaison n'est pas tablie lors de la demande, la fonction choue avec un message d'erreur (ex: T1 : Refus lecture donnes horodates). La lecture de donnes horodates bloque l'acquisition temps rel et l'mission de tlcommande.

Page E-50

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Dconnexion si communication en cours ou dpilage de la liste des appels en attente, uniquement si la case "Ignorer les fronts descendants de la fonction DEMCX" n'est pas coche

Remarque: Pas de connexion / dconnexion possible pour les ports type RS232

Diagramme temporel d'une connexion

TBox: Etat de la dernire connexion


La fonction SYS(XX",5) permet de rcuprer dans le tableur l'tat de la dernire connexion la station repre par le code XX". Les diffrentes valeurs rendues par cette fonction sont: Valeur 0 1 2 3 4 5 6 tat de la connexion La dernire connexion sortante s'est bien passe. Tout est correct. La dernire connexion sortante a chou, mais il y aura au moins une autre tentative d'appel. Inutilis Inutilis La dernire connexion entrante s'est bien passe. Tout est correct. La dernire connexion entrante a chou. La dernire connexion sortante a chou, et il n'y aura plus d'autre tentative d'appel

TBox: Temps de connexion restant


La fonction SYS(PortX, -(1+2*numesc)) o X est le numro du port sur lequel est connect la station TBOX et numesc son numro d'esclave, permet d'obtenir le temps de connexion restant avec la station en secondes.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-51

Trsii: Cration d'un "port physique"

10.

Pilote TRSII

Le protocole TRSII permet de dialoguer avec des stations de type AQUAVEIL 1 / FORCE directement l'aide d'un ou plusieurs modems, un frontal AQUAVEIL 2 / MONET, ou le frontal de communication PILOTE. Le paramtrage passe par les tapes suivantes: Cration du port "logique" et des modems auxquels seront rattaches les stations ou le frontal Dclaration de chaque station Paramtrage des cellules tableur de gestion des stations

On accde la bote de configuration des ports physiques en slectionnant le bouton Configuration... dans la bote ci-dessus. Dans la bote de dialogue qui s'ouvre, renseigner les diffrentes zones de la manire suivante:

10.1. Trsii: Configuration pour fonctionnement avec un frontal type MONET / AQUAVEIL II
Dans TOPKAPI Vision en mode configuration, il vous faudra dclarer le port sur lequel sera connect le frontal.

Trsii: Cration d'un port


Ouvrir la fentre Acquisition, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port n'a pas d'importance, mais utiliser de prfrence le numro du port sur lequel est connect le frontal. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante: Dure par dfaut d'une communication: Dure maximale d'une connexion lors d'un appel entrant. TOPKAPI Vision maintiendra cependant la communication pour le temps ncessaire la lecture de l'tat de la station et des traces. Forcer utilisation de valeurs relles: Force TOPKAPI Vision utiliser un codage rel pour toutes les ressources analogiques (syntaxe #F dans le tableur). Cette option doit obligatoirement tre coche pour pouvoir utiliser l'option FORCE META (WIT). Code accs Aquaveil 2 / Monet: Mot de passe niveau 4 ncessaire si l'option de mise l'heure automatique est slectionne pour l'une des stations connectes. Gnrer fichier TRSII32.LOG: Gnre dans le rpertoire de l'application un fichier nomm TRSII32.LOG dans lequel sont inscrites les trames changes avec le frontal. Ce fichier peut atteindre une taille maximale de 10 Mo. Ensuite, les informations les plus anciennes sont effaces En slectionnant le bouton Configuration des ports, on accde la configuration des ports physiques associs ce port logique.

Protocole TRSII32 Sous protocole FRONTAL Traitement automate Time-out en 1/10mes de seconde En service Coche (sinon messages non traits)

Page E-52

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Trsii: Cration d'un port


Ouvrir la fentre Acquisition, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port n'a pas d'importance, mais utiliser de prfrence le numro du port sur lequel est connect le frontal. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

Alors que la liste des ports utiliss est vide, choisir un type de voie RS232, puis slectionner le port srie sur lequel est connect le frontal AQUAVEIL II / MONET. L'onglet Physique permet de prciser les paramtres de configuration d'un port physique: Protocole TRSII32: Pilote TRSII32. Sous protocole TRANSVEIL Traitement automate Time-out en 1/10mes de seconde En service Coche (sinon messages non traits)

Trsii: Cration d'un "port physique"


On accde la bote de configuration des ports physiques en slectionnant le bouton Configuration... dans la bote ci-dessus. Dans la bote de dialogue qui s'ouvre, renseigner les diffrentes zones de la manire suivante:

10.2. Trsii: Configuration pour fonctionnement avec un frontal PILOTE


Dans TOPKAPI Vision en mode configuration, il vous faudra dclarer le port sur lequel sera connect le frontal.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-53

Alors que la liste des ports utiliss est vide, choisir un type de voie RS232, puis slectionner le port srie sur lequel est connect le frontal PILOTE. L'onglet Physique permet de prciser les paramtres de configuration d'un port physique:

Interface Choisir si la liaison avec le frontal doit se faire en TCP/IP ou par une liaison srie. Si la liaison TCP/IP est choisie, il faudra indiquer dans le champ Accs de chaque automate l'adresse IP du frontal pilote. Forcer utilisation de valeurs relles TOPKAPI Vision utilise systmatiquement le codage rel des valeurs analogiques lorsque l'on utilise le frontal PILOTE. L'tat de cette case est donc sans objet. Gnrer fichier TRSII32.LOG Gnre dans le rpertoire de l'application un fichier nomm TRSII32.LOG dans lequel sont inscrites les trames changes avec le frontal. Ce fichier peut atteindre une taille maximale de 10 Mo. Ensuite, les informations les plus anciennes sont effaces Si une liaison de type RS232 a t slectionne, le bouton Configuration des ports permet d'accder la configuration des ports physiques associs ce port logique.

10.3. Trsii: Configuration pour fonctionnement sans frontal


Toutes les stations doivent tre rattaches un port "logique" dans TOPKAPI Vision. Ce port n'existe pas forcement physiquement sur l'ordinateur (d'o la dnomination de port logique), mais il se voit attribuer une liste de ports physiques

Page E-54

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

auxquels seront rattachs les modems grer pour assurer la communication avec les stations.

Trsii: Cration d'un "port logique"


Ouvrir la fentre Acquisition, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port n'a pas d'importance, utiliser de prfrence un numro de port correspondant l'un de ceux que vous utiliserez pour communiquer. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

Protocole TRSII32 Sous protocole DIRECT Traitement automate Time-out en 1/10mes de seconde En service Coche (sinon messages non traits)

Interface Choisir RS232, modem. Dure par dfaut d'une communication Dure maximale d'une connexion lors d'un appel entrant. TOPKAPI Vision maintiendra cependant la communication pour le temps ncessaire la lecture de l'tat de la station et des traces. Forcer utilisation de valeurs relles Force TOPKAPI Vision utiliser un codage rel pour toutes les ressources analogiques (syntaxe #F dans le tableur). Cette option doit obligatoirement tre coche pour pouvoir utiliser l'option FORCE META (WIT). Lire le journal sur appel par TOPKAPI Force TOPKAPI Vision lire lors d'un appel sortant dans le journal d'une station les vnements non acquitts. Gnralement, cette option n'a pas tre coche, puisque les seuls vnements que l'on puisse rcuprer dans ce cas doivent tre en diffusion, c'est dire gnrer un appel par la station. Rcupration des traces sur demande station Cocher cette case si, lors d'un appel entrant, vous dsirez faire l'acquisition des traces lorsqu'un vnement comporte dans son libell la chane TRACE. Ce mode de fonctionnement ralentit lgrement le dialogue avec le satellite lors d'une connexion, et ne doit donc tre utilis que si l'initiative de la rcupration des traces est laisse aux stations et non la fonction TRACES() de TOPKAPI Vision (cf. 9.5). Retourner le modem sur appel entrant Permet, sur appel entrant, de procder un retournement dynamique du modem. Cette option est indispensable pour

Trsii: Cration d'un "port physique"


On accde a la bote de configuration des ports physiques en slectionnant le bouton Configurer port logique dans la bote de cration d'un port. Dans la bote de dialogue qui s'ouvre, renseigner les diffrentes zones de la manire suivante:

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-55

supporter les versions CLIP de WIT, mais peut aussi tre utilise avec toutes les autres versions de satellites. Consulter plus loin les paramtres modem conseills. Direction acquitter par dfaut Indique, en cas d'appel d'alarme d'une station, quelle direction tlphonique doit tre acquitte si cette information ne peut pas tre lue dans la station (dpend de la version du satellite). COUPURE() compatible version 32 La seule diffrence selon que cette case est coche ou non est la valeur 4, correspondant un appel en cours, qui est renvoye si la case est coche, et qui est indispensable pour permettre un fonctionnement correct lorsque la redondance est utilise. Les autres valeurs rendues par la fonction sont identiques. Voir plus loin le paragraphe traitant de cette fonction. Gnrer fichier TRSII32.LOG Gnre dans le rpertoire de l'application un fichier nomm TRSII32.LOG dans lequel sont inscrites les trames changes avec la station. Ce fichier peut atteindre une taille maximale de 10 Mo. Ensuite, les informations les plus anciennes sont effaces Configuration des stations Ce bouton permet d'accder la bote suivante, dans laquelle on pourra spcifier les informations lire dans chaque station, ainsi que les options spcifiques chaque station.

Cocher le type de voie RTC, puis slectionner le ou les ports sur lesquels seront connects les modems utiliss pour la connexion aux stations. Lors de l'utilisation de plusieurs modems, TOPKAPI Vision slectionnera pour un appel sortant le premier modem disponible, et acceptera les appels entrants sur chaque modem. Les champs Nombre de tentatives, et Dlai entre tentatives permettent de rgler le comportement de TOPKAPI Vision lorsqu'un appel sortant choue. L'onglet Physique permet de paramtrer le port couramment slectionn:

On peut rgler les mmes paramtres depuis la bote de paramtrage des stations via le bouton Spcifique. Les informations correspondantes sont dcrites plus loin, dans le chapitre traitant des requtes de lecture. En slectionnant le bouton Configuration des ports, on accde la configuration des ports physiques associs ce port logique.

Rgler les paramtres du port physique slectionn dans l'onglet Gnral et rappel en haut droite. Le format doit obligatoirement tre de 7 bits de donnes, parit paire. Page E-56 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

La case Contrle de flux doit gnralement tre laisse sur Sans. La zone Mode d'utilisation du port permet de rserver l'utilisation du port aux appels entrants, sortants ou les deux. Cette fonctionnalit n'est pas supporte par tous les pilotes de protocole: il convient donc de se renseigner auprs du support technique pour connatre les modes supports par un pilote un instant donn. L'onglet Modem permet de slectionner le modem que vous utilisez.

Modem GENER GE425 en V23 (AQUAVEIL / FORCE) et V22 (CLIP)

Il faudra faire prcder le numro de tlphone des station AQUAVEIL / FORCE du prfixe 1@, et le numro de tlphone des station CLIP du prfixe 2@. La case cocher Retourner le modem sur appel entrant doit tre coche.

Modem GENER GE934 en V23 (FORCE) / V22 (CLIP) / GSM


La chane d'initialisation complte est X4 V1 &I1 W1 N3 %C0 \N0 Il faudra faire prcder le numro de tlphone des station AQUAVEIL / FORCE du prfixe 1@, et le numro de tlphone des station CLIP du prfixe 2@. la case cocher Retourner le modem sur appel entrant doit tre coche.

Le bouton Nouveau permet de crer un nouveau type de modem, le bouton Configurer permet de modifier les paramtres du modem slectionn.

Trsii: Paramtres modem


La connexion aux stations FORCE ou AQUAVEIL se fait en V23 (1200/75 bps) ou V22/V22Bis (pour les modles Modulo) et la connexion aux stations CLIP se fait en V23 ou V22 (1200 bps). Il est possible d'utiliser tout modem HAYES standard pour communiquer en V22. Par contre le mode V23 avec retournement n'est support que par trs peu de modems. Seul le modem GENER GE425 a t valid ce jour par AREAL pour communiquer en V23 avec les AQUAVEIL / FORCE. Il est possible de faire coexister des stations de toute nature (AQUAVEIL, FORCE et CLIP), au prix d'une lgre complexit de paramtrage. Nous donnerons ci-aprs deux exemples de paramtrage, pour des stations V23 seules et des stations V23 et V22 mlanges.

10.4. Trsii: Configuration pour fonctionnement en direct (RS232 ou TCP/IP)


Trsii: Cration d'un "port logique"
Ouvrir la fentre Acquisition, et crer un port (menu Edition/ Ajouter un port). Le numro attribu au port n'a pas d'importance, utiliser de prfrence un numro de port correspondant l'un de ceux que vous utiliserez pour communiquer. Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Dans la bote de dialogue de configuration du port, renseigner les diffrentes zones de la manire suivante:

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-57

Interface Choisir RS232, modem pour utiliser une liaison srie pour communiquer avec les quipements, ou TCP/IP si la liaison est un rseau local ou une liaison ADSL. Les autres paramtres sont identiques ceux utiliss dans le cas d'une liaison par modem, vue au paragraphe prcdent. L'interrogation des quipements est faite squentiellement, mme dans le cas d'une liaison par rseau local. Si dans ce cas vous dsirez interroger plusieurs stations en parallle, il suffit de crer dans TOPKAPI plusieurs ports logiques et de rattacher chaque station un port logique diffrent.

10.5. Trsii: Cration d'un automate


Pour chaque station AQUAVEIL 1 / FORCE doit tre cr dans TOPKAPI Vision un automate. Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Ouvrir la fentre Acquisition, slectionner le port logique cr auparavant, puis utiliser la commande menu Edition / Ajouter un automate un port. Dans la bote de dialogue de configuration de l'automate, renseigner les diffrentes zones de la manire suivante: Libell station Entrer le libell de la station, qui doit correspondre exactement au libell ayant t paramtr dans la station. Faire en particulier aux espaces et caractres "." la fin du libell. Type d'automate AQUAVEIL 1 / FORCE Accs Numro de tlphone ou adresse IP de l'automate (sous la forme adresse IP-port TCP, ex. 192.168.0.25-2001), suivi ventuellement d'un double point : et du code d'accs de niveau 4 la station (obligatoire pour les stations WIT, et pour AQUAVEIL afin de pouvoir effectuer la mise l'heure des stations). Enfin, pour les versions antrieures la version 7.50, terminer en indiquant aprs un : la direction tlphonique utilise dans la station pour appeler le superviseur afin que le pilote puisse acquitter un appel en cas d'alarme En service Coche (sinon pas communication possible) Horodat Coche (sinon pas d'archivage des donnes horodates) Mise l'heure automatique Si cette case est coche, la station sera mise l'heure automatiquement lors de chaque connexion partir de l'heure du superviseur. En cas de discordance trop importante, un message systme est gnr par TOPKAPI Vision. Zones mmoires Saisir des zones mot 1 et Bit 1 ncessaires la rcupration des ressources du satellite

Protocole TRSII32 Sous protocole MULTI-POINTS Traitement automate Time-out en 1/10mes de seconde En service Coche (sinon messages non traits) Cliquer ensuite sur le bouton Configuration pour accder la bote suivante:

Page E-58

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Ces six valeurs sont stockes en dcimal. Zone Bits 1 Ressources logiques, adresses de 0 755 Ces ressources reprsentent des valeurs de type logique ( 0 ou 1 ). La zone de 400 655 contient les variables internes de type Bx. Zone Bits 2 Valeurs conseilles de 1000 1255 Cette zone, non fixe par TOPKAPI Vision, ne devra en aucun cas chevaucher la Zone Bits 1. Elle permet de stocker l'tat de chaque ressource. L'tat d'une ressource logique correspond la valeur de la ressource elle-mme. L'tat d'une ressource analogique correspond l'information de dpassement de seuil (minimum ou maximum) de la ressource.

Zones mmoire
Les stations AQUAVEIL 1 / FORCE disposent de 256 ressources, chaque ressource pouvant tre de type soit logique, soit analogique. On utilisera de prfrence les valeurs suivantes: Zone Mots 1 Ressources linaires, adresses de 0 255 Ces ressources reprsentent des valeurs de type analogique entires ou relles. La zone de 256 500 contient des informations propres l'utilisation du frontal TRANSVEIL PILOTE. La zone de 500 955 contient les variables internes de type Wx et Fx. Zone Mots 2 Cette zone n'est pas modifiable, elle est fixe par TOPKAPI Vision ( 1000 1300 ) avec : 1000 1255: Etat (seuil bas ou haut) des ressources linaires. Chaque mot reprsente l'tat d'une ressource et peut prendre 3 valeurs :

Mise l'heure des stations


Lorsque la case Mise l'heure automatique est coche dans la dclaration d'une station, cette dernire sera mise l'heure avec l'heure de l'ordinateur chaque connexion. Des prcautions particulires sont prises pour tenir compte de la gestion des plages horaires propre au matriel WIT et DEGREMONT. En cas de remise l'heure impliquant l'obligation d'avancer l'heure du satellite de plus de 40 secondes, un message d'avertissement est gnr.

Acquittement des alarmes dans les stations


Chaque fois qu'une station appelle le superviseur pour retransmettre une alarme, ce dernier doit acquitter l'appel de la station afin d'viter que cette dernire rappelle indfiniment. Au niveau de chaque station, 5 directions tlphoniques sont disponibles, et chaque alarme se voit affecter l'une de ces directions. l'acquittement d'un appel par le superviseur impose de connatre la direction tlphonique dans laquelle l'alarme a t transmise. Or, les versions antrieures la version 7.5 des stations AQUAVEIL 1 ou les stations FORCE ne permettent pas, sur rception d'une alarme, de connatre cette direction tlphonique. Il faut donc paramtrer dans TOPKAPI Vision le numro de la direction tlphonique correspondant au superviseur. Ce paramtrage se fait dans les paramtres du port logique. Il est possible de choisir soit l'une des 5 directions, soit toutes les directions. Ce paramtre est global.

0 : pas de dpassement de seuil 1 : seuil bas atteint 2 : seuil haut atteint


Cette zone est mise jour en mme temps que la valeur d'une ressource analogique. Les mots qui suivent ne sont pas mis jour par les donnes acquises par le protocole, mais par TOPKAPI Vision, qui y place certaines informations ncessaires l'exploitation. 1256: Temps de connexion restant en secondes. 1257 1258: Valeur dcimale du Temps de connexion cumul en secondes, accessible dans le Tableur l'aide de la formule d'accs suivante : #L1257 1259 1261: Date et heure de dernire connexion codes de la manire suivante 1259 = 1260 = 1261 = Mois Heure #O2518 #O2520 Anne Jour #O2519 #O2521

Spcifique
Permet d'accder la bote de paramtrage des informations lire dans la station (voir paragraphe suivant).

10.6. Trsii: Cration des requtes


Il n'y a pas en TRSII de requtes de lecture paramtrer. On peut par contre dfinir le nombre maximum d'informations lire dans chaque station en utilisation soit le bouton de paramtrage des stations accessible depuis le port, soit le bouton spcifique accessible depuis l'automate.

Secondes #O2522

Minutes #O2523 Page E-59

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

10.7. Trsii: Fonctions tableur


Adressage des ressources
Les ressources logiques sont adresses par la syntaxe #B<n
de ressource>

Les ressources analogiques entires (ne comportant aucune


dcimale) seront adresses par la syntaxe #E<n de ressource>, sauf si la case Forcer utilisation de valeurs relles est coche, auquel cas on utilisera la syntaxe #F<n de ressource>

Les ressources analogiques relles (comportant au moins


une dcimale) seront adresses par la syntaxe #F<n de ressource>

Les mots d'tat (des seuils) des ressources analogiques


seront adresss par la syntaxe #M<n de ressource + 1000> Lire les donnes par paquets de Permet lorsque la liaison tlphonique n'est pas de bonne qualit de limiter la taille des trames changes. La valeur par dfaut est de 255, la rduire 100 puis 50 en cas de problmes de communication rcurrents. Nombre maxi de ressources lire Par dfaut, TOPKAPI tente de lire 256 ressources. Nombre maxi de variables Bx lire Les variables Bx sont dans les CLIP des variables internes de type Bit, que TOPKAPI permettra d'adresser l'adresse #B400+n variable. Nombre maxi de variables Wx lire Les variables Wx sont dans les CLIP des variables internes de type Mot, que TOPKAPI permettra d'adresser l'adresse #W400+n variable. Nombre maxi de variables Fx lire Les variables Fx sont dans les CLIP des variables internes de type Rel, que TOPKAPI permettra d'adresser l'adresse #F700+n variable. Lecture TRACES diffrentielle Indique pour la station d'utiliser la commande de lecture diffrentielle des traces (commande T?), qui permet aussi de lire les traces de type command, non accessibles par la commande classique (TRACE?). Cette commande n'est supporte que sur les CLIP, mais aucune information de version disponible dans le protocole ne permet d'automatiser dans TOPKAPI le choix de la fonction utiliser. Station CLIPNET par RTC Indique que la station est relie un CLIP passerelle sur un rseau CLIPNET, la passerelle tant la seule disposer d'une liaison RTC. Dans ce cas, seul le CLIP passerelle pourra mettre des appels vers TOPKAPI. Chaque station derrire cette passerelle pourra par contre tre appele, mais il faudra autant d'appels diffrents qu'il y a de CLIP derrire la passerelle. Lire le journal de la station Indique que lors de chaque session de communication avec la station, il faut lire le journal de cette dernire. La commande J? permettant de raliser cette lecture n'est pas implmente dans toutes les versions de station. Elle est prsente dans les CLIP, pas forcment dans les anciennes versions de FORCE ou d'AQUAVEIL 1.

Demande de connexion
La demande de connexion une station se fait grce la fonction DEMCX(). Les appels sur dfaut sont l'initiative des stations.

Fonction DEMCX(Condition,Valeur,Chane)
Sur variation de Condition ou variation de Valeur (Condition tant 1), dclenche une demande de connexion (Condition=1) ou de dconnexion (Condition=0), chane le repre automate de la station appeler suivi du caractre " (exemple T1"). Valeur exprime en minutes spcifie la dure maximum de la communication. Une valeur trop petite de ce paramtre n'a pas d'importance, la dure minimale d'une communication tant dfinie automatiquement par le temps ncessaire la lecture du journal de la station, suivie de l'ventuelle rcupration des traces, et enfin d'un rafrachissement de l'tat temps rel des ressources de la station. Condition 1 1 0 Valeur 0 <>0 Action Appel simple : excuter une seule fois chaque requte puis raccrocher Appel continu pendant <vmot> minutes puis raccrocher Dconnexion si communication en cours ou dpilage de la liste des appels en attente, uniquement si la case "Ignorer les fronts descendants de la fonction DEMCX" n'est pas coche

Par compatibilit avec le protocole TRSII implment dans les versions antrieures de TOPKAPI, la fonction LECDH(Condition,Dure) permet aussi de dclencher un appel lorsqu'un frontal est utilis. Sur variation de Condition ou variation de Dure (Condition tant 1), dclenche une demande de connexion (Condition=1) vers la station dans laquelle est place la fonction (feuille tableur principale uniquement). Dure est exprime en secondes, mais est arrondi la minutes suprieure par le pilote. La fonction ne permet par contre pas de dclencher de dconnexion.

Fonction COUPURE()
La fonction COUPURE() permet de connatre l'tat de la liaison avec une station. Les diffrentes valeurs rendues dpendent le l'tat de la case COUPURE() compatible version 32 de la bote de rglage des paramtres du port TRSII: Fonction COUPURE(<refAPI>")

Page E-60

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Valeurs par dfaut


Valeur 0 1 2 3 Etat de la connexion En connexion, possibilit de passer des tlrglages, tlcommandes Erreur de communication (pas de rponse ou erreur checksum) Dconnect (position repos) Impossible d'tablir la communication

TRACE. Par exemple, Traceur Ractifs ne va pas provoquer de lecture de traces, alors que Trace 1,3 d'effluents va provoquer une lecture des traces 1 et 3.

Rcupration l'initiative de TOPKAPI Vision


La fonction TRACES() permet de demander la rcupration des traces l'initiative de TOPKAPI Vision. TRACES(Condition, Liste traces) Condition: Expression logique. Sur passage vrai, TOPKAPI Vision mmorise que les traces indiques droite doivent tre rcupres. Cette rcupration a lieu instantanment si une connexion est en cours, ou ds la prochaine connexion, quelle que soit l'origine de celle-ci. Il est aussi possible d'utiliser la cellule contenant cette fonction comme condition de dclenchement d'une fonction LECDH, afin de provoquer immdiatement une demande de connexion lors d'une demande de rcupration de traces. Liste traces: liste de numros de traces rcuprer, spars par des virgules: "n1,n2,n3", ou bien deux points: "n1..n2" pour indiquer "toutes les traces de n1 n2" Exemples: TRACES(AUJ(4)=23,1,3,7) pour rcuprer les traces 1, 3 et 7 partir de 23 heures TRACES((COUPURE(XX")=0),1,3,7..12) pour rcuprer les traces 1, 3, et 7 12 ds qu'une connexion est en cours

Valeurs compatibles version 32


Valeur 0 1 2 3 4 tat de la connexion En connexion, possibilit de passer des tlrglages, tlcommandes Erreur de communication (pas de rponse ou erreur checksum) Dconnect (position repos) Impossible d'tablir la communication Demande de connexion

Statut de la dernire connexion


La fonction SYS(API",5) o API" est le code attribu dans TOPKAPI Vision la station, permet de dterminer le rsultat de la dernire connexion: Valeur 0 1 2 3 4 5 6 tat de la connexion La dernire connexion sortante s'est bien passe. Tout est correct. La dernire connexion sortante a chou, mais il y aura au moins une autre tentative d'appel. Inutilis Inutilis La dernire connexion entrante s'est bien passe. Tout est correct. La dernire connexion entrante a chou. La dernire connexion sortante a chou, et il n'y aura plus d'autre tentative d'appel

IMPORTANT
Avant de demander la rcupration d'une trace, TOPKAPI
Vision recherche dans la liste des feuilles associes la station pour laquelle a eu lieu la demande si au moins une cellule tableur fait rfrence la trace en question. Si ce n'est pas le cas, le demande de lecture est ignore

10.8. Trsii: Rcupration des traces


Rcupration l'initiative du satellite
Pour rcuprer des traces l'initiative d'un satellite, il faut d'abord cocher la case Rcupration des traces sur demande station dans la bote de configuration du port logique TRSII, puis il faut configurer, sur le site, un vnement en diffusion dont le libell contient "TRACE" suivi d'un ou plusieurs numros de traces rcuprer: Exemples: "TRACE 1,3,7" pour rcuprer les Traces 1, 3 et 7 "TRACE 1,3,7..12" pour rcuprer les Traces 1, 3, et 7 12 Lorsque TOPKAPI Vision verra un vnement de ce type, il gnrera les requtes de lecture appropries. NB: si incidemment une chane "TRACE" se trouve dans un libell d'vnement, il n'y a pas d'action si TOPKAPI Vision ne peut reconnatre la syntaxe des paramtres qui suivent la chane TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

La fonction TRACES() doit imprativement tre place dans


la feuille tableur correspondant au satellite concern.

10.9. Trsii: Fonctionnement avec le frontal Transveil PILOTE


Le frontal Transveil PILOTE permet de communiquer avec les stations CLIP via Transveil, ce qui permet une communication en temps rel avec les stations. TOPKAPI Vision rcupre les informations des stations via une pile FIFO gre par le frontal. Le paramtrage des stations est identique dans son principe au cas d'une liaison via un frontal MONET / AQUAVAIL 2. Le principe de communication tant par contre totalement diffrent, il convient de respecter dans le paramtrage du frontal PILOTE quelques rgles afin de permettre TOPKAPI Vision de comprendre les informations transmises.

Page E-61

Paramtrage du frontal PILOTE

ou non des certaines chanes type, qui sont paramtrables dans le fichier .APP de l'application, section [TRSII]. PREFIXE_SITE=:BD.SITES. La chane droite de ce prfixe sera interprte comme un nom de site. TOPKAPI Vision cherchera dans sa liste de stations si l'une d'entre elle possde un libell correspondant PREFIXE_RESSOURCE=.VAR.R TOPKAPI Vision rechercher le nombre qui suit ce prfixe, pour en dduire une adresse qui sera utilise dans le tableur pour rcuprer l'information. SUFFIXE_STATUT=.STATUS Indique que l'information est un statut, et non pas une valeur, et donc doit tre interprt en tant que tel par TOPKAPI Vision SUFFIXE_ERROR=.ERROR Indique que l'information est un statut d'erreur SUFFIXE_SYNCHRO=.CMDSYNCHRO Indique que l'information est un statut de synchronisation de tlcommande PREFIXE_RTC=.CNXRTC Indique que l'information concerne l'tat d'une connexion RTC. TOPKAPI Vision vrifie si la chane contient un nom de site (repr par le PREFIXE_SITE), et soit un SUFFIXE_STATUT, soit un SUFFIXE_ERROR PREFIXE_X25=.CNXTRANSVEIL Indique que l'information concerne l'tat d'une connexion TRANSVEIL (voir ci-dessus) SUFFIXE_COMMANDE=.CMDVALUE Utilise par TOPKAPI Vision pour construire une chane lors de l'criture d'une variable. SUFFIXE_INDATE=.INDATE Indique que la chane concerne la date de dernier rafrachissement d'une variable. Utilis pour mettre jour la date de dernier rafrachissement d'un site dans TOPKAPI Vision INIT_FIFO=:BD.SITES.TOPKAPI.UPDATE Variable crite TRUE par TOPKAPI Vision pour forcer l'criture par le frontal de l'tat courant de toutes les variables publiques lors d'un dmarrage, ou aprs une coupure de liaison NbGetFIFO=1 Nombre d'informations lues chaque interrogation du FIFO du frontal. La valeur 1 permet une analyse simple du fichier de mise au point TRSII2.LOG. Utiliser par la suite une valeur 5 ou 10 pour obtenir de meilleures performances

La base de donnes du frontal PILOTE se prsente comme une structure arborescente.

La racine se nomme toujours BD, et doit contenir un dossier


SITES dans lequel seront placs tous les sites.

Chaque site est plac dans le dossier SITES, sous un nom


qui devra correspondre celui utilis dans le titre ed la station dclare dans TOPKAPI

Les informations de chaque station sont de deux sortes: les


variables rcupres par abonnement, et les variables lues ou crites individuellement. Pour tre reconnues par TOPKAPI Vision, ces variables doivent tre ranges dans un dossier ".VAR.", et porter des nom du type ".Rxxx" o xxx est un nombre sur trois chiffres obligatoirement, qui sera utilis comme adresse dans TOPKAPI dans une formule de type #Fxxx

Pour tre accessible en criture par TOPKAPI Vision, une


variable doit imprativement tre nomme sous la forme ".Rxxx" et tre place dans le dossier ".VAR" situ directement sous le dossier portant le nom du site.

La configuration de pilote doit inclure un objet diffuseur (ici


"BD.SITES.TOPKAPI") qui grera le FIFO dans lequel TOPKAPI Vision vient lire les donnes du frontal Dans l'exemple ci-dessus, on trouve un site nomm "AQUATEST". Ce dernier contient 6 informations accessibles par TOPKAPI: R001, R002, R006, R013, R004, R005. Les variables R001, R004, R006 peuvent sont accessible en lecture / criture par TOPKAPI. Les variables R002, R006, R013 sont issues d'un abonnement (ici nomm AB1), et sont accessibles en lecture (elles sont dans un dossier ".VAR"), mais pas en criture (le dossier ".VAR" les contenant n'est pas directement plac sous le dossier du site).

Format des informations lues


Toute information de type numrique (le sparateur dcimal est la virgule) est rcuprable dans TOPKAPI Vision sous la forme relle #Fxxx. Toute information de type logique FALSE / TRUE est rcupre dans TOPKAPI Vision sous la forme #Bxxx Il est impossible de rcuprer une information logique de type 0/1, qui sera interprte par TOPKAPI Vision comme une valeur numrique.

Rgles de reconnaissance des variables par TOPKAPI Vision


TOPKAPI Vision lit rgulirement le FIFO du frontal, et analyse les chanes lues. L'interprtation qui a lieu dpend de la prsence

Statut des connexions


Il est possible de rcuprer dans TOPKAPI Vision le statut de la connexion chaque station, ainsi que le statut de la communication avec le frontal. Dans chaque station TOPKAPI, on utilise pour cela les mots

Page E-62

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Adresse
1259 1260 1261 1263 1264 1265 1266 1267

Description
Dernier rafrachissement ,faible= Anne) (poids fort= Mois

Dernier rafrachissement (poids fort= Heure, faible= Jour) Dernier rafrachissement (poids fort= Secondes, faible= Minutes) Coupure de liaison avec la frontal Statut liaison RTC du site Statut liaison X25 du site Statut erreur RTC du site Statut erreur X25 du site

Commande par TOPKAPI Vision


On utilise dans TOPKAPI Vision la fonction TELEC() pour crire une variable dans le frontal. On rcupre partir de cette fonction TELEC() l'adresse, le type et la station de destination de l'information crire, pour une dduire la chane de la forme PREFIXE_SITE<titre de la station>PREFIXE_RESSOURCE<adresse variable><SUFFIXE_COMMANDE> L'adresse de la variable est code sur 3 chiffres exactement. Si le frontal renvoie un statut d'erreur, TOPKAPI renvoie la mme chane sans le SUFFIXE_COMMANDE. Ceci permet de traiter de faon transparente l'criture de variables CLIP (le SUFFIXE_COMMANDE est indispensable) et de variables internes du frontal (le SUFFIXE_COMMANDE doit tre omis).

Demande de connexion par RTC (rcupration des traces)


La fonction DEMCX() permet de dclencher une connexion RTC vers un site, par criture 1 (RUN) de la chane PREFIXE_SITE<titre de la station>PREFIXE_RTC Il est bien sr possible de paramtrer dans le frontal une variable interne qui se chargera de la connexion, et que l'on crira 1 via une fonction TELEC() dans TOPKAPI. Cette variable interne du frontal devra respecter la rgle d'accessibilit en criture par TOPKAPI Vision (voir ci-dessus le paragraphe "Commande par TOPKAPI Vision")

Horodatage des informations


Toutes les informations lues dans le frontal sont horodats soit la source (l'information provient d'une trace ou du journal d'un CLIP, suite une connexion RTC), soit par le frontal lorsque ce dernier place l'information dans le FIFO. Toute information horodate la source est prise en compte par TOPKAPI Vision. Toute information horodate par le frontal n'est prise en compte qu'en cas de variation, et si la date de l'information est plus rcente que ce que connat dj TOPKAPI Vision. La date d'acquisition d'une information est stocke par TOPKAPI Vision au format type "Temps" dans l'image mmoire de la station, l'adresse gale celle de l'information + 256. Cette date peut tre affiche sous la forme #E<adresse+256>, format "Temps", prsentation "Temps long" M40001). Sinon, il faudra utiliser dans la requte l'adresse MODBUS Plus.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-63

La broche 7 cot cordon PCU1030 doit tre imprativement relie la broche 3, et pas au 7 (DB9) ou 4 (DB25) ct PC.

11.

Pilote UNITELWAY esclave

Utilisation du cble PCU1031 avec un TSX 37


Ce nouveau cordon, qui remplace le PCU1030, ne fonctionne pas avec TOPKAPI (il n'est pas compatible avec les routines standard de gestion d'un port srie). Il faut donc soit vous procurer un cordon PCU1030, soit utiliser un convertisseur RS232/RS485 tel le SCA72, par exemple.

11.1. Unitelway: Prsentation


Le protocole Unitelway dcrit dans ce chapitre permet de dialoguer en tant qu'esclave sur un rseau UNITELWAY en tant connect sur un coupleur d'un automate type TSX, au besoin travers un convertisseur RS232/RS485 de type SCA72. Le protocole Unitelway matre est dcrit dans le chapitre prcdent. Pour plus de renseignements, consulter le manuel TELEMECANIQUE "Bus UNI-TELWAY Manuel de rfrence TX D24 004F"

Utilisation du cble TSXPCX1031 (en position 2 TER DIRECT)


Ce nouveau cordon fonctionne comme le PCU1030 sans avoir besoin du strap 3-7 ct automate.

11.3. Unitelway: Cration d'un port


Toutes les gnralits sur la cration d'un port peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un port. Crer un port correspondant au port srie utilis pour le dialogue. Utiliser les paramtres suivants:

Limitation
Le protocole UNITELWAY esclave de TOPKAPI Vision ne supporte pas:

Les donnes non sollicites Les requtes de lecture ou d'criture de la part d'une autre
station TOPKAPI Vision attend une interrogation du matre du rseau pour transmettre des demandes de lecture ou d'criture aux autres automates du rseau (y compris au matre). Les rponses reviennent selon le mme principe de messagerie inter - esclaves.

Paramtrage du time-out sur le matre du rseau


Il faut rgler le time-out du matre du rseau au moins 250 ms pour obtenir un dialogue correct, la valeur par dfaut de 30 ms est trop petite pour garantir un fonctionnement correct.

11.2. Unitelway: Cblage


Utilisation d'un convertisseur SCA72
RS232 raccordement cot TOPKAPI (UNITELWAY)
Utilisation obligatoire du botier SCA72 du fabricant. Mettre un strap entre les bornes 2 et 4 de l'adaptateur.
Cot micro-ordinateur Prise 9 points Prise 25 points (Femelle) (mle) 2 3 5 1 4 6 7 8 RX DATA TX DATA GND CD DTR DSR RTS CTS 3 2 7 8 20 6 4 5 rception mission masse NC=non connect NC NC NC NC Adaptateur SCA72 25 points

Numro du port Le numro de port logique devra tre celui du port COM utilis pour la communication Protocole UNITEL32 Esclave. Retard l'mission 0. Traitement automate Une valeur de l'ordre de 3000 5000 millisecondes est raisonnable, mais peut tre augmente si besoin. En service Si cette case n'est pas coche, TOPKAPI Vision ne dialoguera pas. Gestion modem Sans objet. Paramtres de communication Gnralement 9600 bauds, 8 bits de donnes, 1 bit de d'arrt, parit impaire. Configuration Accde la bote suivante:

3 2 7

Utilisation du cble PCU1030 avec un TSX 37


Insrer entre le cordon et le PC un cordon suivant le cblage suivant:
Cot micro-ordinateur Prise 9 points Prise 25 points (Femelle) (mle) 2 3 5 1 4 6 7 8 RX DATA TX DATA GND CD DTR DSR RTS CTS 3 2 7 8 20 6 4 5 rception mission masse NC=non connect NC NC NC NC Cable PCU1030 9 points (mle)

2 3 5

RX TX GND

CTS

Page E-64

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Configuration UNITELWAY
Cette bote de dialogue permet de configurer les informations spcifiques au protocole UNITELWAY esclave:

Dans l'exemple ci-dessus, TOPKAPI Vision rpondra au polling du matre sur les numros de station 11 et 12, mais n'utilisera pour la communication inter - esclaves que le numro de station 11.

Exemple d'adressage 5 niveaux


Sur un rseau de 3 TSX 37, dont l'un est le matre, et les deux autres comportant comme AD0 les valeurs 4 et 7, utiliser les adresses 5 niveaux suivantes: Matre Station numro 4 Station numro 7 0.254.0.0.0 0.254.5.254.4 0.254.5.254.7

11.4. Unitelway: Cration d'un automate


Toutes les gnralits sur la cration d'un automate peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'un automate. Dans le configurateur, crer un automate sur le port ci-dessus. Utiliser les paramtres suivants: Numro d'esclave Adresse de liaison AD0 paramtre dans l'automate, ou 0 pour l'automate matre. L'adresse rseau complte (5 niveaux) devra tre paramtre depuis la bote Configuration du port sur lequel est rattach l'automate Type automate Soit un type TSX (17, 47, 67) prdfini, pour lequel vous pouvez dfinir une zone mots supplmentaires, soit un type STANDARD pour lequel vous dfinissez deux zones de mots et deux zones de bits. Vous prfrerez en gnral un type STANDARD, les types prdfinis correspondants aux espaces adressables de versions anciennes des TSX et tant de ce fait gnralement trop restrictifs. En fonction du type d'automate choisi, se rfrer au mode d'adressage des donnes dans TOPKAPI Vision, chapitre C Les autres champs sont dcrits dans le chapitre C, et n'ont aucun rapport avec le protocole utilis.

Pour chaque automate du rseau, adresse rseau 5 niveaux: n de rseau: Numro de rseau. Gnralement 0
lorsqu'un seul rseau est utilis.

n de station: Gnralement 254 pour une station du


rseau local sur lequel est connect TOPKAPI. Si la station distante est connecte un autre rseau Telway/Mapway, numro de la station sur cet autre rseau.

n de porte:
0 : Accs au matre du rseau, ou accs une station distante sur un autre rseau Telway, Mapway 5 : Accs aux esclaves connects au rseau local sur lequel est TOPKAPI, ou coupleur intelligent sur l'automate matre

11.5. Unitelway: Requtes de lecture


Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares cidessus. Toutes les gnralits sur la cration d'une requte peuvent tre trouves dans la documentation gnrale, sous la rubrique Paramtres d'une requte. Les paramtres de chaque requte sont: Repre Mnmonique libre sur 6 caractres. Longueur Longueur de la table lire. Il est impratif de respecter les contraintes lies aux quipements relis (lecture de mots limite 60 mots, ou 496 bits). Pour la lecture de bits, la longueur totale d'une requte doit tre facteur de 8. Dbut Adresse de rangement informations lues. dans TOPKAPI Vision des

n de module:
254 : Accs un esclave du rseau local 0: Accs au matre Autre: emplacement gographique du coupleur intelligent dans le bac

n de voie:
0 : Accs au matre Adresse liaison d'un esclave (TOPKAPI ajoute automatiquement la valeur 100, conformment aux spcifications UNITELWAY)

Type station: Matre ou Esclave Numro d'esclave de TOPKAPI Vision Nombre d'adresses conscutives attribues TOPKAPI
Vision

Gnration ventuelle du fichier UNITEL.LOG dans le


rpertoire de l'application, qui permettra de visualiser les trames reues et mises par TOPKAPI Vision

Adr. physique Adresse physique de dbut de lecture dans l'automate. Codage Standard.

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Page E-65

Code fonction Type de lecture, parmi

54: Lecture de n bits Active Slectionner Non pour invalider temporairement la requte. Priode Priode d'excution de la requte, en secondes. Heure action Heure de rfrence pour l'excution priodique de la requte, sous la forme HHMM.

2: Lecture 16 bits E/S 4: Lecture d'un mot 54: Lecture de n mots

11.6. Unitelway: Requtes d'criture


Les requtes d'criture sont gnres automatiquement par TOPKAPI Vision lors d'une tlcommande. Les fonctions employes sont:

16: Ecriture d'un bit. 20: Ecriture d'un mot 55: Ecriture de n mots, uniquement pour l'option recettes
de TOPKAPI Vision

Page E-66

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

Paramtres d'un modem

12.

Paramtrage d'un modem

Pour chaque protocole permettant une interrogation directe des stations via RTC, il faut paramtrer le modem qui sera utilis pour le dialogue:

NB Les commandes marques d'un astrisque ci-dessous correspondent des commandes standard, et n'ont gnralement pas tre modifies. Modem Nom associ au profil de modem en cours de dfinition Prfixe commande HAYES* Gnralement AT Rinitialisation du modem Par dfaut Z, mais peut tre remplac par &F, qui rappelle la configuration usine du modem, alors que Z rappelle la configuration sauvegarde en EEPROM, laquelle peut avoir t modifie Numrotation par impulsions: Slectionne une numrotation par impulsions. Si votre standard le permet, ne pas cocher cette case afin de numroter plus rapidement Dlai de numrotation ... Dlai maximum au del duquel une tentative de numrotation non aboutie est abandonne. Dlai de dconnexion ... Dlai en secondes au bout duquel aura lieu le raccrochage lorsque aucune communication n'a lieu sur la liaison RTC. Voir dans la liste Type modem si le modem que vous utilisez apparat, ou bien cliquer sur Nouveau pour crer un nouveau profil de modem. Chane d'initialisation La chane d'initialisation du modem doit souvent tre adapte pour y intgrer la commande de forage du modem dans le type de modulation support par les satellites:

V21: V22: V23 :

300 bauds 1200 bauds 1200/75 bauds

V22 bis: 2400 bauds Il faudra ventuellement inclure dans cette chane les commandes d'invalidation des modes de correction automatique d'erreurs (LAPM V42 ou NMP10) et de compression de donnes (V42 bis ou NMP5) La documentation de votre modem donnera les commandes correspondantes, qui ne sont pas standardises.

Mise en garde
Mme si le modem que vous cherchez utiliser apparat dans la liste des modems disponibles, il faut imprativement vrifier voire modifier les paramtres de ce dernier car, selon le type d'quipement avec lequel aura lieu le dialogue, les paramtres d'un mme modem devront tre adapts, en particulier en fonction du type de modulation V21, V22, V23, V22 bis support par l'quipement distant. Numrotation par impulsion* Gnralement DP Numrotation par frqu. vocales* Gnralement DT Activation cho* Gnralement E1 Dsactivation cho* Gnralement E0 Rponse automatique* Gnralement S0=2 Invalidation rponse automatique* Gnralement S0=0 TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006 Page E-67

Prise de ligne* Gnralement H1 Raccrochage de la ligne* Gnralement H0 Squence de raccrochage Gnralement vide Chane de dtection de connexion Gnralement CONNECT Chane d'erreur de connexion Gnralement NO CARRIER Commande d'effacement des numros brls Permet d'inclure une commande spciale d'effacement de numros brls. Comme cette commande n'est pas forcement une commande HAYES, c'est dire prcde du prfixe AT, il faudra ventuellement inclure ce prfixe si ncessaire. Un retour chariot est par contre automatiquement ajout la fin de cette commande. On rappelle que l'agrment P&T impose un modem de brler (c'est dire d'interdire totalement) un numro de tlphone au bout d'un certain nombre de tentatives infructueuses de connexion, par exemple en cas de ligne occupe. Il faut thoriquement teindre puis rallumer le modem pour remettre en service un numro brl, ce qui bien entendu n'est pas compatible avec les impratifs d'une supervision. La plupart des modems possdent une commande permettant d'invalider cette gestion de numros brls, mais cette commande n'est pas documente, pour des raisons d'agrment P&T. Contacter AREAL ou votre revendeur pour connatre la commande adapte votre matriel. chane d'initialisation spciale (non HAYES) Permet d'inclure une commande d'initialisation ne dbutant pas par le prfixe standard AT. Elle aussi est par contre termine automatiquement par un retour chariot. Les quatre chanes d'initialisation en appel permettent d'initialiser diffremment le modem selon la station appeler. Il suffit d'inclure avant le numro de tlphone de la station le prfixe 1@<n tlphone>, 2@<n tlphone> ou 3@<n tlphone> pour que TOPKAPI Vision envoie la chane d'initialisation n1, 2 ou 3, aprs avoir envoy la chane n'initialisation gnrale et ventuellement la chane d'initialisation spciale. Gestion du signal DTR Le raccrochage du modem est pilot par TOPKAPI Vision partir du signal DTR: la mise zro de ce signal provoque le raccrochage du modem. Pendant une phase de numrotation, et afin d'viter un conflit avec un appel entrant, TOPKAPI Vision force temporairement le signal DTR 0. Si votre modem ne supporte pas ce mode de fonctionnement, il est possible de l'invalider en ne cochant pas l'option Faire tomber le signal DTR 0 lors d'une numrotation. Exemple : Les stations SOFREL sont de deux types, qui ncessitent pour l'un uniquement le mode V21 (300 bauds), et pour l'autre uniquement le mode V22 (1200 bauds).

Le modem GENER GE 425 doit avant d'appeler l'une de ces stations tre positionn dans le bon mode, par la commande non standard MODEM7 (V21) ou MODEM2 (V22) La commande MODEM0 bascule quant elle le modem en autodtection, pour les appels entrants. On paramtrera le modem de la faon suivante:

Il suffira de placer la chane 1@ devant le numro de tlphone des stations de type S10, et 2@ devant celui des stations de type S15.

Page E-68

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

13.3. Erreurs d'ouverture d'un port

13. Codes d'erreurs communs aux pilotes TOPKAPI Vision


13.1. Erreurs de chargement d'un driver
Ce message d'erreur se produit au lancement de TOPKAPI Vision, dans une bote de dialogue indiquant une erreur de chargement du driver suivie du numro de l'erreur:

Ce message d'erreur se produit au lancement de TOPKAPI Vision, dans une bote de dialogue indiquant une erreur d'ouverture d'un port, suivie du numro de l'erreur: Les erreurs infrieures entre -1 et -99 sont rendues directement par Windows, les autres sont rendues par le driver TOPKAPI Vision.

0: 2:

3: 5: 8: 10: 11: 12: 13: 14: 15: 16: 19: 20: 21:

Manque de mmoire, fichier driver dtrior, systme instable. Fichier driver ou une librairie annexe (PCDLL.DLL pour APPLICOM, FPCWIN_L.DLL pour FIPWAY par exemple) introuvable. Vrifier le nom du driver saisi dans le port TOPKAPI Vision (la prsence de l'extension .DLL est obligatoire), la prsence sur disque des fichiers DLL requis, ou la commande PATH dans le fichier AUTOEXEC.BAT. Chemin (commande PATH) introuvable. Fichier driver bloqu (erreur suite un blocage du fichier par une autre application ou un rseau). Mmoire insuffisante. Version de Windows incorrecte. Version de fichier driver incorrecte. Systme d'exploitation incorrect. Version MS-DOS incorrecte (4.0 requise). Type de fichier driver inconnu. Version de Windows incorrecte. Fichier driver dtrior. Fichier driver encore compress. Fichier driver dtrior. Win32s doit tre install.

-1: -2: -3: -4: -5: -10: -11: -12: -100: -101: -102: -103: -104: -105: -106:

Identificateur de port invalide Port dj ouvert Port non ouvert Allocation buffer I/O impossible Paramtres par dfaut errons Port non disponible ou dj utilis Format de donnes non support Vitesse non supporte Sous Protocole inconnu. Clef incompatible. Votre version de TOPKAPI Vision ne permet pas d'utiliser le driver. Echec chargement d'une autre DLL locale. Trop de ports logiques. librairie dj utilise. Relancer Windows. Autre erreur. Erreur allocation mmoire.

13.4. Erreurs de chargement des requtes


Ces messages d'erreur sont gnrs au lancement de TOPKAPI Vision, dans les messages systme concernant l'acquisition. La requte correspondante n'est pas charge, et n'apparat donc pas en excution dans la liste des requtes actives. Mauvaise configuration requte XXXX: Le driver a refus de charger la requte (code fonction incorrect, mauvaise adresse ou longueur, codage non support etc.). Mauvaise conf. requte XXXX (Adr/Lg): TOPKAPI Vision refuse la requte car elle dborde des images-mmoire dclares pour l'automate qui appartient la requte.

Seule l'erreur n 2 risque de se produire. Les autres cas rsultent gnralement d'une erreur dans le fichier driver ou l'une des DLL appeles par ce dernier.

13.2. Erreur de chargement d'une routine d'un driver


Le message Problme chargement de la routine <nom> de la DLL indique que vous cherchez utiliser une version trop ancienne d'un driver de communication. Contacter votre revendeur pour obtenir une version jour de ce dernier.

13.5. Erreurs de communication


Ces messages d'erreur sont gnrs chaque fois qu'une erreur se produit lors de l'excution d'une requte, dans les messages systme concernant l'acquisition. TOPKAPI Vision tente en tout trois missions d'une requte avant de dclarer une coupure de liaison. 1: Code fonction incorrect. Page E-69

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006

Vrifier le paramtrage correct de la requte. Si ce message persiste, c'est probablement que l'quipement scrut ne reconnat pas la requte qui lui est adresse. Consulter la notice de fabriquant de cet quipement. 2: Adresse incorrecte. Vrifier le paramtrage correct de la requte. Si ce message persiste, c'est probablement que l'quipement scrut ne reconnat pas l'adresse dans la requte qui lui est adresse. Consulter la notice de fabriquant de cet quipement. 3: Donnes incorrectes. Peut tre gnr si une trame est dforme lors de la transmission, ou bien si la demande de lecture ou d'criture est refuse par l'quipement. 4: Automate non prt. L'quipement a rejet la requte. Vrifier le paramtrage de cette dernire, puis le paramtrage de l'quipement. 8: Dfaut d'criture. Une demande d'criture a t rejete. 9: Dfaut chevauchement de zones. La requte de lecture recouvre deux zones distinctes dans l'quipement. Consulter la documentation de ce dernier pour plus de dtails sur les zones accessibles. 100: Dfaut acquisition donnes HD. Une erreur s'est produite pendant une lecture de donnes horodates. Cette dernire est abandonne. 251: Erreur de ligne : parit.., interruption du message... La trame de rponse une requte est errone, suite un problme de transmission (erreur de ligne, de parit etc. sur une liaison srie). Vrifier le format des donnes (vitesse, parit, nombre de bits) puis la qualit du cblage. 252: Code fonction ou esclave <> attendu. La rponse fournie par l'automate ne correspond pas la dernire question ayant t pose par TOPKAPI Vision. Voir s'il ne faut pas allonger le temps de traitement automate ou le retard l'mission dans la dclaration du port. 253: Longueur IMM<Longueur rponse. La rponse une requte dborde d'une image mmoire dclare dans TOPKAPI Vision. Augmenter la taille de cette dernire. 254: CheckSum incorrect. Une erreur s'est produite pendant la transmission d'une trame. Vrifier les paramtres de communication employs puis le cblage. Essayer si le problme se poursuit d'augmenter le retard l'mission (temps de silence respecter entre une rception et l'mission suivante), puis de baisser la vitesse de transmission. 255: Time Out en rception. On n'a pas eu de rponse une requte dans le temps maximum autoris. Le temps de traitement automate ne doit gnralement pas tre infrieur 1000 ms. L'augmenter au besoin. Vrifier si le problme persiste les paramtres de communication, le bon fonctionnement du port srie et le cble utilis.

Page E-70

19/10/2006 Protocoles TOPKAPI Vision 32 V4.0