protocoles.pdf

TOPKAPI Vision 32 V4.0 Protocoles 01/10/2006 Page E-1

E. Protocoles

Rvisions Auteur 01/09/2006 MB Document initial version 4.0 19/10/2006 MB Ajout paramtres modem CXR AJ2885P

pour SOFREL

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.

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.

1.2. Applicom: Paramtrage de la carte APPLICOM

Paramtrer la carte : Adresse mmoire utilise, ligne IRQ, ... 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.

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.

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.

Page E-2 19/10/2006 Protocoles TOPKAPI Vision 32 V4.0

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 :

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.

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.

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:

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

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


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



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.


1000

400 200

0 bits

mots

API 1

1000

400 200

0 bits

mots

API 2

5000 5400 6000 6400

5000 6000

7000 8000

MOTS

BITS

DATA-BASE

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.

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

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.

Applicom: Principe de fonctionnement Il est inutile de configurer des requtes cycliques via APPLICOM.

Chaque requte active est utilise : pour crer une fonction cyclique dans la carte APPLICOM

(fonction CREATECYC) pour crer une zone de consignation d'vnements (fonction

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 ci-dessous. 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: Lecture de bits (adressables par la syntaxe #B) 4100: Lecture de bits d'entre (adressables par la

syntaxe #B) 4101: Lecture de mots (adressables par la syntaxe

#M ou #W) 4102: Lecture de mots d'entre (adressables par la

syntaxe #M ou #W) 4103: Lecture de mots doubles (adressables par la

syntaxe #E) 4104: Lecture de flottants (adressables par la syntaxe

#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


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

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.

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]

TEMPS_AV_INIT=

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.

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.


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:

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.

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:

Windows NT/2000/XP

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:

Fipway/Ethway: Configuration FIPWAY / ETHWAY Cette bote de dialogue permet de configurer les informations spcifiques au protocole FIPWAY ou ETHWAY:

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 intra-station

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


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.

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.

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:

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.

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

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 ci-dessus. 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 dans TOPKAPI Vision des informations lues.

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

Codage Standard.

Code fonction Type de lecture, parmi

2: Lecture 16 bits E/S 4: Lecture d'un mot 54: Lecture de n mots 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.


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 long ou de rels.

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.


3. Pilote JBUS/MODBUS

3.1. Modbus: Prsentation 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

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

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


chercher scruter un quipement momentanment indisponible.

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.3. Modbus: 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:

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

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

3.4. Modbus: Requtes de lecture Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares ci-dessus. 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

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

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.

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.


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


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.

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:

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.


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.


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:

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

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.

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.


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.

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:

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.

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

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

4.4. Modbus IP: Requtes de lecture Il faut paramtrer pour un automate les requtes de lecture ncessaires au rafrachissement des images mmoires dclares ci-dessus. 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



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:


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






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().

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.


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.


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

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:

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.

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.

En tout, 9 requtes auront t remplaces par 4, le temps de cycle d'acquisition sera divis par un peu plus que 2.

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)

Ecriture d'un mot double Utiliser la syntaxe TELEC( , ,#Exxx) dans une cellule de type entier long.


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

02 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

03 ILLEGAL DATA VALUE La valeur contenue dans une requte est incorrecte

04 SLAVE DEVICE FAILURE Une erreur inattendue s'est produite dans l'quipement

05 ACKNOWLEDGE Le traitement de la requte va prendre beaucoup de


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

08 MEMORY PARITY ERROR Erreur de contrle de parit (CRC) dans l'quipement. Concerne des codes fonction non implments dans TOPKAPI

0A 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

0B 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)


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.

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.

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.

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.

Slectionner l'automate s'il existe dj, ou slectionner Nouveau pour le crer, et faire 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.


Si par contre vous obtenez la bote suivante, c'est que votre serveur est bien paramtr et disponible. Vous pouvez alors cliquer sur Suivant.

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

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.

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 "!".


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.

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

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:

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


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 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 , le choix propos par l'assistant sera

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.

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


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

ce qui ouvre la bote suivante

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

5.6. OPC: Modification des variables importes 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).

Un double clic sur un item ouvre la bote suivante:


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.

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 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.

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:


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.

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

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.

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.


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 chacun des boutons Modifier les limites et Modifier, ajouter l'oprateur Tout le monde et activer l'accs distant:

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.


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.


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.

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


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

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:

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.

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 certains paramtres lis au protocole, puis de configurer la liste des ports physiques (liaisons RS232, LS ou RTC) utiliss pour communiquer avec les stations.

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


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


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

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 ci-aprs plusieurs exemples de paramtrage, pour des stations V23 seules et des stations V23 et V22 et V32 mlanges.

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@.

Modem GENER GE934 en V23, V22-V22bis et GSM

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 V22-V22bis 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


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:

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

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

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)

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 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.


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



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:







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.


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 Type Description

0001-0003 500-5C7 600-627 700-88E

3 mots 200 bits 40 mots 400 mots

Date / Heure Etat voies TOR Etat voies ANA Etat voies COMPTEUR et CHRONO (1 double mot par voie)

Adresses JBUS pour un P200X Adresse Type Description

0001-0003 1000-118F 1400-158F 1800-1B1F

2000-207F 2800-2B1F 3800-3B1F

3 mots 400 bits 400 mots 800 mots

128 mots 800 mots 800 mots

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. 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), soit une prsentation sous forme de libell invers pour afficher correctement dans TOPKAPI Vision les valeurs lues

Les entres analogiques seront adresses par la syntaxe #M. 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))*/(pleine chelle*4/5), 0)

Les compteurs seront adresss par la syntaxe #D.

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.


Mise l'heure La date et l'heure d'un PERAX sont organises de la faon suivante:

Jour #O3 Mois #O2

Anne #O5+2000 Heure #O4

Minutes #O7 Secondes #O6

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.

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 Valeur Action 1 0 Appel simple : excuter une seule fois

chaque requte puis raccrocher. Les donnes horodates ne sont pas rcupres

1 >0 Appel continu pendant minutes puis raccrocher

1 -1 Appel avec rcupration des donnes horodates et raccrochage le plus rapidement possible

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

Contrle des connexions Fonction COUPURE(")

Cette fonction est tendue la notion d'tat de connexion

Valeur tat de la connexion 0 En connexion, possibilit de passer des

tlrglages, tlcommandes 1 Dconnect (position repos) 2 Demande de connexion en cours de traitement 3 En connexion simple (rafrachissement initial), pas

de tlcommande possible 4 Non utilis 5 Non utilis 6 Non utilis 7 Temps de connexion dpass, fin de lecture des

donnes horodates

Diagramme temporel d'une connexion

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 tat de la connexion 0 La dernire connexion sortante s'est bien passe.

Tout est correct.

1 La dernire connexion sortante a chou, mais il y aura au moins une autre tentative d'appel.

2 Inutilis 3 Inutilis 4 La dernire connexion entrante s'est bien passe.

Tout est correct.

5 La dernire connexion entrante a chou. 6 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.


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.


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

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:

Protocole: SOFREL32 : Pilote SOFREL

Sous protocole: CS100

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

Retard l'

protocoles.pdf

Documents