DIGIMETRIE 30 A,Rue Ernest Renan 66000 PERPIGNAN - FRANCE
Tél:(33) 04-68-66-54-48 FAX:(33) 04-68-50-27-85
Digitools Librairies d'acquisition de données
Télécharger Digitool .pdf (Document format Acrobat)
Caractéristiques
* Fonctions Reset et Initialisation des périphériques.
* Fonctions d'acquisition de signaux analogiques et logiques.
* Fonctions de restitution de signaux analogiques et logiques.
* Fonctions de comptage d'impulsions.
* Fonctions de génération de signaux.
* Fonctions de gestion d'interruptions.
* Renvoi d'une erreur sur chaque fonction.
Applications
* Acquisition et traitement de données.
* Commande et régulation de dispositifs analogiques ou logiques.
* Comptage d'évènements
* Toute application interfacée par des cartes Digimétrie
ntroduction
Description
DigiTools est un ensemble de routines réalisant une interface standard d'application
indépendante de l'interface matérielle utilisée. Il s'agit d'une boite à outils
logicielle d'acquisition et de contrôle de processus à la disposition du programmeur
sous DOS ou Windows (DLL).
Ces outils logiciels permettent l'accés à la majorité des cartes Digimétrie qu'elles
aient des fonctions analogiques ou logiques.
Les routines sont développées en C, les sources sont fournies afin de pouvoir recompiler
dans une version ou modèle différent.
Digitools I/O s'adresse au programmeur qui doit réaliser une application spécifique sans
entrer dans la programmation des registres de la carte.
Le DigiTools I/O de chaque carte est livré avec celle-ci (fichiers .OBJ, .C, .H) ainsi
que la .DLL correspondante pour Windows.
Si l'utilisateur désire plus d'informations que ce qui est indiqué dans le .H pour
utiliser la DLL sous windows, il peut alors commander la documentation complète.
FONCTION RESET:
Reset_carte (mode,ext,carte,adresse) Fonction: Permet le test des
différents modules de la carte AD-DA-TOR-TIM et une remise à l'état initialisation de
tous les registres.
FONCTIONS ENTREES/SORTIES Tout Ou Rien:
Dinit (portx, mode, no_composant, carte, adresse) Fonction:Initialiser
le sens des lignes logiques .
Din ( *resultat, portx, no_composant, carte, adresse ) Fonction: Lire un
port (8bits) d'entrées/sorties logiques.
Dout (data, portx, no_composant, carte, adresse) Fonction: Ecrire un
port (8bits) d'entrées/sorties logiques .
Dinscan (port_tampon, port, n_ports_max, n_ports, n_composant, n_val, *fréquence, mode,
*tampon, exts, carte, adresse)
Fonction: Remplir un tampon à partir d'un port
logique en programmant
le fréquence d'acquisition et le nombre de
ports.
Doutscan(port_tampon, port, n_ports_max, n_ports, n_composant, n_val, *fréquence, mode,
*tampon, exts, carte, adresse)
Fonction: Restituer un tampon sur un port
logique en programmant
le fréquence d'acquisition et le nombre de
ports.
Description:
port_tampon, n_ports_max numéro du premier port et nombre de
port max du tampon
port, n_ports correspondent aux ports A, B ou C (0, 1, 2) et au nombre.
mode sert à définir le sens de transfert des données.
Un bit à 1 signifie voie en sortie, un bit à 0 = voie en entrée
no_composant correspond au numero (De 0 à N-1) du composant
sur la carte quand il y a plusieurs composants par carte
(ex: 2 groupes de 24 lignes (ports A, B, C) pour une carte
PC_TOR48 (équivalent à 2 PIO 8255)==>no_composant= 0 ou 1)
FONCTIONS ENTREES/SORTIES ANALOGIQUES
Ain (*data, voie, gain, mode, exts, carte, adresse)
Fonction: Lire un port
d'entrée analogique.
Ainf (*data, voie, gain, mode, exts, carte, adresse)
Fonction: Lire un port
d'entrée analogique pour écriture
dans un tableur..
Ainscan (voie_tampon, voie, n_voies_max, n_voies, *gain, n_val, *fréquence, mode,
*tampon, exts, carte, adresse)
Fonction: Remplir un tampon à partir d'un port d' entrée
analogique en programmant la fréquence
d'acquisition
et le nombre de voies.
Aout (data, voie, mode, ext, carte, adresse)
Fonction: Ecrire sur un port de sortie analogique.
Aoutf (data, voie, mode, ext, carte, adresse)
Fonction: Ecrire sur un port de sortie analogique à partir
d'un tableur.
Aoutscan (voie_tampon, voie, nvoies_max, n_voies, n_val, *fréquence, tint, mode, *tampon,
ext, carte, adresse)
Fonction: Restituer un tampon sur un port analogique.
Description:
voie_tampon, n_voies_max sont la première voie et le nombre de voie max sur le tampon.
voie, n_voies sont la première voie et le nombre sélectionnées
sur la carte.
gain est la gain programmé pour les cartes
possédant un amplificateur à gain programmable.
mode détermine les différents modes disponibles
sur les cartes (monopolaire/bipolaire-simple différentiel......).
tampon pointeur de départ pour le stockage des données.
fréquence est la fréquence d'échantillonnage.
/* demo program ain */
#include <stdio.h>
#include <digitool.h>
main ()
{
WORD data;
WORD voie=0; /* voie choisie */
WORD gain=0; /* tableau des gains par voie */
WORD mode=0;
WORD carte= AT_LAB12B; /* nom de la carte */
WORD adresse=0x320; /* Adresse de la carte */
mode=mode | DT_AD_SIMP;
do
{ erreur=
Ain(&data,voie,gain,mode,0,carte,adresse);
printf(" Data=%i
\n",data);
}while(!kbhit());
}
FONCTIONS Gestion d'interruption sous DOS
install_dos_irq (irq, source, interrup, carte, adresse)
Fonction: Initialiser sous DOS un nouveau vecteur
d'interruption et valide son déclenchement.
desinstall_dos_irq (irq, carte, adresse)
Fonction: dévalide et restaure sous DOS une gestion
d'interruption initialisée par la fonction install_dos_irq().
test_valid_eoi (irq)
Fonction: permet d'acquiter sous DOS une interruption
matérielle déclenchée.
Description:
source: définie la source matérielle de l'interruption.
FONCTIONS GENERATEUR et COMPTEUR
GENERATEUR:
Ginit (*fréquence, no_composant, mode, carte, adresse)
Fonction: Initialiser un générateur 16 ou 32 bits
sur un timer (ex:8254 intel).
Gstart (no_composant, mode, carte, adresse)
Fonction: Démarrer un générateur 16 ou 32 bits.
Gstop (no_composant, mode, carte, adresse)
Fonction: Arrêter un générateur 16 ou 32 bits.
Description:
fréquence est la fréquence du générateur en Hz.
no_composant donne le n° compteur et le n° timer pour le générateur.
mode donne le type de générateur 16bits ou 32bits.
COMPTEUR:
Cinit (valeur,no_composant, mode, carte, adresse)
Fonction: Initialiser un compteur 16 bits.
Cstart (no_composant, carte, adresse)
Fonction: Démarrer un compteur 16 bits.
Cstop (no_composant, carte, adresse)
Fonction: arrêter un compteur 16 bits.
Cread (*result, no_composant, carte, adresse)
Description:
valeur est le nombre de clocks à compter.
no_composant donne le n° compteur (0,1,2 pour un 8254) et le n° timer pour le compteur.
mode donne le type de compteur 16bits et le mode de comptage.
Informations pour commander
Les fichiers : .H, DLL et sources en C pour DOS (avec détails des
fonctions et paramètres dans le fichier .H) sont livrés gratuitement avec la carte
commandée sur demande.
Pour obtenir la documentation détaillée des fonctions et un exemple
pour chacune d'elle, l'utilisateur peut commander les références suivantes:
Fonctionne en 16Bits et 32Bits ,Windows 3.0,95,98,NT
DigiTools I/O-C (C,C++ : Microsoft Visual C 1.0,3.0,.4.0 Borland)
DigiTools I/O-VB (Visual Basic 3,4)
DigiTools I/O-DELPHI (Delphi 3,4)
DigiTools I/O-VBX/OCX