Manuel du programme STANTOR-XP avec base de données Access pour les cartes K8055 ou VM110 (version 2_3). SOMMAIRE 1 Introduction... 2 2 Installation... 3 3 Configuration... 4 3.1 Entrées digitales Digital Inputs... 6 3.2 Sorties digitales Digital Outputs... 7 3.3 Entrées analogiques(numériques) Analog Inputs... 8 3.4 Sorties analogiques (Réglages) Analog Outputs... 9 3.5 Compteurs impulsionnels - Counters... 10 3.6 Dimensionnement de l'enregistrement des entrées digitales et analogiques... 11 3.7 Gestion du scheduler de la carte K8055...12 3.8 Paramétrage de la base Access...14 4 Utilisation du système... 15 4.1 Consultation et commande... 15 4.2 Consultation de l'état de fonctionnement du scheduler... 16 4.3 Affichage des entrées analogiques enregistrées... 17 4.4 Affichage des entrées digitales enregistrées... 20 5 Arrêt du scheduler de la carte K8055 et de la base de données... 22 6 Migration MSDE...23 7 Base de données de visualisation/commande fournie en exemple... 24 8 Visualisation/commande au travers de pages WEB fournies en exemple... 26 8.1 Page WEB d'accueil... 28 8.2 Entrées digitales Digital Inputs... 29 8.3 Sorties digitales Digital Outputs... 30 8.4 Entrées analogiques(numériques) Analog Inputs... 31 8.5 Sorties analogiques (Réglages) Analog Outputs... 32 8.6 Compteurs impulsionnels - Counters... 33 8.7 Affichage des entrées digitales enregistrées... 34 8.8 Affichage des entrées analogiques enregistrées... 35 Page 1 / 35
1 Introduction Cette version de Stantor permet de gérer une carte d'entrées / sorties K8055 de Velleman par un micro-ordinateur fonctionnant avec le système d'exploitation Windows XP/2000 et possédant le progiciel de base de données Access 2002 ou ultérieure. Elle est construite avec le langage VBA (Visual Basic for Application) fourni en standard dans la suite bureautique «Office» et ne nécessite aucun produit complémentaire hormis un serveur WEB le cas échéant. L'objectif étant de fournir un produit simple d'installation et d'emploi. Ce programme permet de: Lire les entrées digitales (Digital Inputs) de la carte K8055 avec mise à jour simultanée de la base de données Access et filtrage anti-rebond optionnel. Lire les entrées analogiques (Analog Inputs) de la carte K8055 avec mise à jour simultanée de la base de données Access avec suppression optionnelle des valeurs aberrantes. Lire la base de données relatives aux sorties digitales (Digital Outputs) et analogiques (Analog Outputs) avec transmission des valeurs modifiées à la carte K8055. Lire la base de données relative aux compteurs impulsionnels sur les deux premières entrées digitales de la carte (cf. notice constructeur). Rafraîchir cycliquement la base de données suivant une période paramétrable par dialogue. Convertir les entrées analogiques comprises entre 0 et 255 en valeurs réelles suivant l'unité choisie par segments d'interpolation linéaire. Inverser (ou non) le sens des entrées digitales. Visualiser les entrées analogiques enregistrées dans la base de données suivant une période paramétrable sous forme de liste et sous forme de graphique. Visualiser les changements d'états des entrées digitales enregistrés dans la base de données sous forme de liste. Visualiser et commander les informations digitales et analogiques au travers d'écran interactif. Ci dessous un exemple de schéma général de visualisation/commande réalisé avec un formulaire Access. Les champs étant modifiable par le dialogue de création de formulaire. Page 2 / 35
Stantor-XP fonctionne sous Access avec le "moteur Jet" en standard ou le "moteur MSDE" (MicroSoft Data Engine). MSDE étant une version bridée mais "free" de SQL server (cf. le site de l'éditeur et explications dans le chapitre 6). 2 Installation Le fichier Zip comprend plusieurs fichiers: La présente documentation. Le fichier "stantor_xp_access_k8055d_vxxx.mde" de l'application Stantor-XP (NOTA: la version mdb est disponible sur demande à l'adresse stantor@free.fr ou stantor@ifrance.com, site WEB :http://www.stantor.com) Le fichier "stantor_xp_vision_base_vxxx.mdb étant un exemple d'utilisation de l'application Stantor-XP. Ce programme utilise le mécanisme de tables liées à la base de données Access précédente. Le fichier contenant la DLL version 2.0.1. Les fichiers relatifs aux pages WEB. L'installation standard comprend: Page 3 / 35
la mise en place de la DLL "K8055D.dll" suivant la procédure indiquée par le constructeur de la carte K8055. En standard copier fichier DLL dans le répertoire "C:\WINDOWS\system32". La sélection du numéro de la carte (0, 1, 2 ou 3) par des cavaliers sur la carte électronique K8055. Le raccordement de la carte K8055 sur le micro-ordinateur par un câble USB. La copie des fichiers téléchargés dans un répertoire au choix de l'utilisateur. L'installation complète d'access 2002 ou ultérieure suivant les recommandations de l'éditeur (En particulier la bibliothèque "DAO" permettant aux modules écrit en langage VBA d'accéder aux tables de la base de données). L'installation de pages WEB nécessite : L'installation d'un serveur WEB au choix de l'utilisateur (Apache, IIS, etc..) ainsi que sa protection (firewall, antivirus,...). L'installation des pages WEB dynamiques de Stantor sur ce serveur WEB. Cette installation s'effectue par la procédure d'exportation standard de pages d'accès aux données d'access (cf le chapitre "vision et commande par pages WEB"). Cette distribution est prévue pour fonctionner dans : - Le répertoire " C:\stantor-xp-k8055-v2_3 " pour la base de données. - Le répertoire "stantor" sous la racine des pages html dans le serveur WEB (exemple sous Apache : "htdocs\stantor\p_entreedigik8k.htm"). Le fichier texte "stantor_xp.odc" permet de connecter la base de données aux pages WEB. Il comprend le chemin d'accès à la base de données et peut être modifié sous la balise <odc:connectionstring>. 3 Configuration La configuration s'effectue au travers de formulaires spécifiques une fois la base de données lancée. Le lancement de la base de données "stantor_xp_access_k8055d_vxxx.mde" est accompli par un double clic sur le fichier en question. Un menu général s'affiche permettant alors d'accéder à des sous menus. Le formulaire de configuration permet de sélectionner un type de données parmi les cinq. Page 4 / 35
NOTA : L'accès direct aux informations par modifications dans les tables est déconseillé. les Zones colorées en jaune sont modifiables par saisies au clavier ou à la souris. Page 5 / 35
Les zones ident_xxxx permettent d'identifier de façon unique l'information et sont figées par construction. 3 boutons permettent de : o fermer le formulaire (bouton Stop). o Annuler la saisie (bouton avec flèche de retour). o Enregistrer les modifications (bouton avec image disquette). 3.1 Entrées digitales Digital Inputs Les champs "nom_état, libellé_valeur à 0 et libellé_valeur à 1" sont des textes libres au choix de l'utilisateur. Le champ "sens" peut prendre 2 valeurs : normal ou inverse en fonction du fonctionnement du capteur raccordé à l'entrée digitale en question. Le champ "anti rebond" peut prendre les valeurs 0,1,2 ou 3 avec : 0 = pas de filtrage anti rebond. 1= 1 cycle de scrutation entre 2 états successifs identiques. 2 = 2 cycles de scrutation entre 3 états successifs identiques. 3 = 3 cycles de scrutation entre 4 états successifs identiques. Ce filtrage permet d'éliminer les impulsions de durée inférieure à "n" cycles de scrutation mais retarde la prise en compte des changements d'états dans la base de données. Page 6 / 35
3.2 Sorties digitales Digital Outputs Les champs "nom_commande, libellé_valeur à 0 et libellé_valeur à 1" sont des textes libres au choix de l'utilisateur. Le champ "valeur_init" peut prendre deux valeurs : 0 ou 1 suivant la valeur désirée à transmettre à la carte K8055 lors du démarrage du scheduler. Page 7 / 35
3.3 Entrées analogiques(numériques) Analog Inputs Les champs "nom" et "unité" sont des textes libres au choix de l'utilisateur. Les champs "points d'inflexion" sont des valeurs comprises entre 0 et 256. Le champ "coef médiane" peut prendre les valeurs 0,1,2 ou 3 avec : 0= pas de filtrage, 1 =médiane des 3 dernières valeurs, 2=médiane des 5 dernières valeurs, 3 = médiane des 7 dernières valeurs. Ce filtrage des mesures aberrantes agit par sélection de la valeur médiane des "n" dernières valeurs acquises lors des scrutations. Page 8 / 35
Les coefficients sont des valeurs réelles. Ce programme effectue la conversion par segments de droite suivant la valeur de X mesurée par la carte (champ "valeur_carte"): Y= a*x + b Y= c*x + d Y= e*x + f Y = g*x + h. Les coefficients de pente sont :a, c, e, g Les coefficients de décalage sont respectivement b, d, f, h. Les points d'inflexion dans la BDD servent de séparateur pour le changement de segment. La conversion est effectuée avec : les coefs a & b pour les valeurs comprises entre 0 et le point d'inflexion ab_cd, les coefs c & d pour les valeurs comprises entre le point d'inflexion ab_cd et le point d'inflexion cd_ef, les coefs e & f pour les valeurs comprises entre le point d'inflexion cd_ef et le point d'inflexion ef_gh les coefs g & h pour les valeurs comprises entre le point d'inflexion ef_gh et la valeur max (255 pour cette carte K8055). 3.4 Sorties analogiques (Réglages) Analog Outputs Le champ "nom" est en texte libre au choix de l'utilisateur. Le champ "valeur_init" doit être compris entre 0 et 255 suivant la valeur désirée à transmettre à la carte K8055 lorsque le scheduler démarre. Page 9 / 35
3.5 Compteurs impulsionnels - Counters Le champ "nom du compteur" est en texte libre au choix de l'utilisateur. Les champs "délai" et "délai à l'initialisation" doivent être compris entre 0 et 5000 millisecondes conformément aux prescriptions du constructeur. Le champ "status" permet de relancer le comptage des impulsions (le scheduler de la carte K8055 repositionne automatiquement cette valeur à "normal" dès que ce reset a été effectué). Page 10 / 35
3.6 Dimensionnement de l'enregistrement des entrées digitales et analogiques Chaque champ "nombre maximum d'enregistrements" précise la quantité d'enregistrements stockés dans la base de données. L'enregistrement le plus récent remplaçant l'enregistrement le plus ancien en cas de dépassement de cette quantité. Page 11 / 35
3.7 Gestion du scheduler de la carte K8055 Le champ "période en millisecondes" est la période entre 2 cycles successifs du scheduler de la carte K8055. Afin de ne pas surcharger le processeur du micro-ordinateur la valeur doit être de quelques centaines de millisecondes. Le champ "numéro de carte" doit être identique au positionnement des cavaliers sur la carte K8055. Le champ "cycle d'enregistrement des entrées analogiques" correspond à la période entre deux enregistrements successifs dans la base de données. Le champ "enregistrement des changements d'états des entrées digitales" permet d'effectuer ou non cet enregistrement. Le champ "compteur" s'incrémente de 1 à chaque cycle du scheduler. Il permet de s'assurer du bon fonctionnement du programme. Page 12 / 35
Le lancement du scheduler s'effectue par un appui sur le bouton de "lancement du scheduler K8055". Le champ "status de la carte" fournit le numéro de la carte lorsque la connexion avec la carte K8055 est correcte à l'initialisation du programme. Il est important de ne pas relancer le scheduler quand il fonctionne sous peine de saturer le processeur et d'obtenir des informations incohérentes. Pour faire fonctionner plusieurs cartes K8055 il faut mettre en service autant d'instances de la base de données Access (avec des nom de fichiers "xxx1.mde" ou "xxxx.mdb" différents). Page 13 / 35
3.8 Paramétrage de la base Access Afin d'obtenir une vitesse de rafraîchissement satisfaisante des formulaires il faut paramétrer les éléments de la façon suivante: Page 14 / 35
4 Utilisation du système 4.1 Consultation et commande Les fenêtres des entrées digitales et des entrées analogiques permettent de consulter en temps réel les dernières informations issues de la base de données. Les fenêtres sorties digitales et sorties analogiques permettent de consulter en temps réel les dernières informations issues de la base de données mais aussi de saisir de nouvelles informations à destinations de la carte K8055. Le champ "commande" permet de basculer le fonctionnement d'une sortie digitale. Le champ "valeur" permet de fournir un nouveau réglage à la sortie analogique (valeur comprise entre 0 et 255). L'appui sur le bouton enregistrement (image de disquette) déclanche la mise à jour en base de données et sur la carte K8055. La fenêtre des compteurs impulsionnels permet de consulter en temps-réel les dernières informations issues de la carte K8055 mais aussi de remettre à zéro les compteurs. Page 15 / 35
4.2 Consultation de l'état de fonctionnement du scheduler La surveillance du scheduler de la carte K8055 s'effectue en consultant la fenêtre ci-dessous. Page 16 / 35
4.3 Affichage des entrées analogiques enregistrées Une fois la saisie la période de visualisation effectuée, l'utilisateur a le choix entre une liste sous forme d'état et un graphique. Page 17 / 35
Page 18 / 35
Page 19 / 35
4.4 Affichage des entrées digitales enregistrées Une fois la saisie la période de visualisation effectuée, l'utilisateur peut visualiser la liste des changements d'état. Page 20 / 35
Page 21 / 35
5 Arrêt du scheduler de la carte K8055 et de la base de données L'appui sur le bouton entraîne la fermeture de la base de données et des programmes associés. Page 22 / 35
6 Migration MSDE La migration du fichier de la base de donnée s'effectue par l'utilitaire incorporé dans Access. Le dialogue de migration s'effectue par : Outils Utilitaire de bases de données Assistant de migration SQL Server Le dialogue se poursuit en fonction des configurations souhaitées par l'utilisateur sous réserve d'une installation préalable de MSDE. Page 23 / 35
7 Base de données de visualisation/commande fournie en exemple Le fichier "stantor_xp_vision_base_vxxx.mdb est un exemple d'utilisation de l'application Stantor-XP au travers d'un lien sur la base de données partagée (ou base de données réelle). Le dialogue de création d'un lien s'effectue par : Outils Utilitaire de bases de données gestionnaire de tables liées. Le dialogue se poursuit de façon nominale. Ce programme exemple permet de consulter et commander la base de données en parallèle du programme précédent. Il possède les mêmes dialogues hormis ceux de configuration mais possède une image animée, à titre d'exemple(cf. introduction), modifiable en fonction de l'installation de l'utilisateur. Le formulaire du menu général se présente de façon équivalente. Page 24 / 35
L'accès à la base de données peut aussi s'effectuer au travers de liens ODBC. Cette solution permet alors d'utiliser une méthode d'accès à distance standardisée (utilisation d'excel,...). Page 25 / 35
8 Visualisation/commande au travers de pages WEB fournies en exemple L'utilisation de Stantor XP peut s'effectuer éventuellement au travers de pages WEB dynamiques sous réserve de la mise en oeuvre préalable d'un serveur WEB sur le microordinateur (Apache, IIS, OmniHttp, etc,...). Attention: le navigateur Internet Explorer est indispensable pour visualiser ces pages WEB. La base de données Access fournit un outil d'exportation des pages WEB à destination du répertoire d'accueil du serveur WEB. Pour chaque page cette procédure doit être appliquée : - Sélectionner l'une après l'autre les pages à exporter dans la base de données. -> clic droit -> exporter -> enregistrer dans... répertoire des pages WEB dans le serveur WEB. Avec type de fichier = Pages d'accès aux données Microsoft Access (*.htm;*.html). Page 26 / 35
Page 27 / 35
8.1 Page WEB d'accueil Page 28 / 35
8.2 Entrées digitales Digital Inputs Page 29 / 35
8.3 Sorties digitales Digital Outputs Page 30 / 35
8.4 Entrées analogiques(numériques) Analog Inputs Page 31 / 35
8.5 Sorties analogiques (Réglages) Analog Outputs Page 32 / 35
8.6 Compteurs impulsionnels - Counters Page 33 / 35
8.7 Affichage des entrées digitales enregistrées Page 34 / 35
8.8 Affichage des entrées analogiques enregistrées Page 35 / 35