ETAS INCA-MIP Manuel utilisateur

Ajouter à Mes manuels
77 Des pages
ETAS INCA-MIP est un outil puissant qui vous permet de contrôler les fonctionnalités de INCA à partir de MATLAB. Il offre une interface de programmation permettant d'automatiser des tâches telles que la lecture et la modification des valeurs de calibration, le lancement et l'arrêt des mesures, et la gestion des pages mémoire.
ETAS INCA-MIP V7.5
Guide de l'utilisateur
Copyright
Les informations contenues dans le pr&eacute;sent document ne doivent pas &ecirc;tre modifi&eacute;es ou amend&eacute;es sans l'accord sp&eacute;cifique de ETAS GmbH. ETAS GmbH n'est
tenue que des obligations contenues dans le pr&eacute;sent document. Le logiciel
d&eacute;crit dans le pr&eacute;sent document est fourni sur la base d'un accord de licence
g&eacute;n&eacute;ral ou individuel. L'exploitation et la copie du pr&eacute;sent document sont autoris&eacute;es uniquement selon les conditions indiqu&eacute;es sur ce contrat.
En aucun cas, tout ou partie du pr&eacute;sent document ne peut &ecirc;tre copi&eacute;, reproduit
ou conserv&eacute; dans un syst&egrave;me de collecte des donn&eacute;es ou traduit dans d'autres
langues sans l'accord express &eacute;crit de ETAS GmbH.
&copy; Copyright 2024 ETAS GmbH, Stuttgart
Les noms et les d&eacute;signations utilis&eacute;s dans ce document sont des marques d&eacute;pos&eacute;es appartenant &agrave; leurs propri&eacute;taires respectifs.
MATLAB et Simulink sont des marques d&eacute;pos&eacute;es de The MathWorks, Inc. Consultez le site mathworks.com/trademarks pour obtenir une liste de marques suppl&eacute;mentaires.
INCA-MIP V7.5 | Guide de l'utilisateur R01 FR | 03.2024
Sommaire | 3
Sommaire
1
Introduction
6
1.1
Utilisation pr&eacute;vue
6
1.2
Groupe cible
6
1.3
Classification des messages de s&eacute;curit&eacute;
6
1.4
Informations de s&eacute;curit&eacute;
7
1.5
Protection des donn&eacute;es
8
1.6
S&eacute;curit&eacute; des donn&eacute;es et de l'information
8
2
&Agrave; propos de INCA-MIP
9
2.1
INCA D&eacute;finitions
10
3
Installation
12
3.1
Minimum requis
12
3.2
Installation
12
3.3
Mettre &agrave; jour les &laquo; liens Cache &raquo; de la bo&icirc;te &agrave; outils MATLAB&reg;
14
3.4
D&eacute;sactiver les liens Caches des r&eacute;pertoires des r&eacute;pertoires de bo&icirc;te &agrave; outils
MATLAB&reg;
14
3.5
Licences
15
4
Fonctions API
16
4.1
Conna&icirc;tre l’AddOn INCA-MIP gr&acirc;ce &agrave; des exemples:
19
4.2
Fonctions G&eacute;n&eacute;rales
20
4.2.1
Listes les messages de l’AddOn INCA-MIP
20
4.2.2
Activer l'affichage d'information durant l’ex&eacute;cution des scripts
23
4.2.3
Afficher l’&eacute;tat de la licence INCA-MIP (INCA-MIP Evolu&eacute;e)
23
4.2.4
Lire informations sur toutes les versions INCA install&eacute;es
23
4.2.5
Lire Information sur tous les add-ons install&eacute;s
24
4.2.6
Conna&icirc;tre la version de INCA
25
4.2.7
Lire les propri&eacute;t&eacute;s de INCA (INCA-MIP Evolu&eacute;e)
25
4.3
Initialisation
26
4.3.1
Ouvrir INCA
26
4.3.2
Fermer INCA (INCA-MIP Evolu&eacute;e)
27
4.3.3
Ouvrir une base de donn&eacute;es
27
4.3.4
Importer une base de donn&eacute;es (INCA-MIP Evolu&eacute;e)
28
4.3.5
Lire les &eacute;l&eacute;ments de la base de donn&eacute;es (INCA-MIP Evolu&eacute;e)
29
4.3.6
Assigner un projet et un jeu de donn&eacute;es &agrave; un dispositif (INCA-MIP Evolu&eacute;e)
31
INCA-MIP V7.5 | Guide de l'utilisateur
Sommaire | 4
4.4
4.5
4.6
4.3.7
Ouvrir une exp&eacute;rimentation
31
4.3.8
R&eacute;initialiser une exp&eacute;rimentation
32
4.3.9
Lire les dispositifs (INCA-MIP Evolu&eacute;e)
33
4.3.10
Lire les propri&eacute;t&eacute;s du dispositif (INCA-MIP Evolu&eacute;e)
33
Mesure et Enregistrement
34
4.4.1
Lire les &eacute;l&eacute;ments de mesure (INCA-MIP Evolu&eacute;e)
35
4.4.2
Lecture des fr&eacute;quences d’&eacute;chantillonnage (INCA-MIP Evolu&eacute;e)
36
4.4.3
Ajouter une variable de mesure &agrave; une fr&eacute;quence d’&eacute;chantillonnage
36
4.4.4
D&eacute;marrer la mesure
38
4.4.5
Arr&ecirc;ter la mesure
39
4.4.6
Lire les propri&eacute;t&eacute;s de l’enregistrement (INCA-MIP Evolu&eacute;e)
39
4.4.7
R&eacute;gler les propri&eacute;t&eacute;s de l’enregistrement (INCA-MIP Evolu&eacute;e)
41
4.4.8
Mode Lecture Enregistrement (INCA-MIP Evolu&eacute;e)
44
4.4.9
Set Recording Mode (INCA-MIP Evolu&eacute;e)
45
4.4.10
D&eacute;marre l’enregistrement
46
4.4.11
Arr&ecirc;ter un enregistrement
46
4.4.12
R&eacute;gler le mode de lecture des donn&eacute;es (Donn&eacute;es Online / Offline)
47
4.4.13
Lecture des donn&eacute;es de mesure
48
4.4.14
R&eacute;initialiser les buffers tournant
51
4.4.15
Lecture de l’&eacute;tat du mat&eacute;riel (INCA-MIP Evolu&eacute;e)
52
4.4.16
D&eacute;finir les triggers (INCA-MIP Evolu&eacute;e)
52
4.4.17
Execution du trigger manuel (INCA-MIP Evolu&eacute;e)
56
4.4.18
Lire l’&eacute;tat d’un enregistrement (INCA-MIP Evolu&eacute;e)
56
4.4.19
Lire la liste des variables de mesure (INCA-MIP Evolu&eacute;e)
57
Calibration
57
4.5.1
Lire les &eacute;l&eacute;ments de calibration (INCA-MIP Evolu&eacute;e)
58
4.5.2
Ajouter un &eacute;l&eacute;ment de calibration
59
4.5.3
Lire la valeur de calibration
60
4.5.4
Modifier une valeur de calibration
62
4.5.5
Assigner un jeu de donn&eacute;es au dispositif (INCA-MIP Evolu&eacute;e)
66
4.5.6
Lister les jeux de donn&eacute;es d’un dispositif (INCA-MIP Evolu&eacute;e)
66
4.5.7
Etablir le mode de calibration (INCA-MIP Evolu&eacute;e)
67
4.5.8
Groupement des dispositifs (INCA-MIP Evolu&eacute;e)
68
4.5.9
Ecrire un fichier DCM (INCA-MIP Evolu&eacute;e)
68
Gestion des pages m&eacute;moires
69
4.6.1
Activer une page m&eacute;moire
69
4.6.2
Get Current Page (INCA-MIP Evolu&eacute;e)
69
4.6.3
V&eacute;rifier la protection en &eacute;criture
70
4.6.4
T&eacute;l&eacute;charger vers l’ECU la page m&eacute;moire
70
INCA-MIP V7.5 | Guide de l'utilisateur
Sommaire | 5
4.7
5
4.6.5
Copier la page m&eacute;moire
71
4.6.6
T&eacute;l&eacute;charger les diff&eacute;rences
71
4.6.7
T&eacute;l&eacute;charger depuis l’ECU les pages m&eacute;moires (INCA-MIP Evolu&eacute;e)
72
Exemples
72
Cr&eacute;ation et distribution de fichiers ex&eacute;cutables autonomes &agrave; l'aide du compilateur MATLAB&reg;
74
5.1
Compilation des fichiers m
74
5.2
Distribution des fichiers ex&eacute;cutables autonome
75
6
Informations des Contacts
76
Index
77
INCA-MIP V7.5 | Guide de l'utilisateur
1 Introduction | 6
1
Introduction
1.1
Utilisation pr&eacute;vue
INCA et les add-ons INCA ont &eacute;t&eacute; d&eacute;velopp&eacute;s et approuv&eacute;s pour les applications
et proc&eacute;dures automobiles telles que d&eacute;crites dans la documentation utilisateur
pour INCA et add-ons INCA.
&reg;
L'AddOn INCA-MIP (INCA MATLAB Integration Package) est une interface de pro&reg;
grammation qui permet de contr&ocirc;ler les fonctionnalit&eacute;s de INCA depuis MATLAB .
INCA et les add-ons INCA sont destin&eacute;s &agrave; &ecirc;tre utilis&eacute;s dans des laboratoires
industriels et des v&eacute;hicules d'essai.
ETAS GmbH ne peut &ecirc;tre tenue responsable des dommages caus&eacute;s par une utilisation incorrecte et le non-respect des .
1.2
Groupe cible
Ce produit logiciel et ce guide utilisateur s'adressent au personnel qualifi&eacute; travaillant dans les domaines du d&eacute;veloppement et de la calibration des ECU automobiles, ainsi qu'aux administrateurs syst&egrave;me et aux utilisateurs disposant de
privil&egrave;ges d'administrateur qui installent, entretiennent ou d&eacute;sinstallent le logiciel. Des connaissances sp&eacute;cialis&eacute;es dans les domaines de la mesure et de la
technologie des ECU sont requises.
&reg;
Pour utiliser les APIs d’INCA-MIP, vous devrez &ecirc;tre familier avec INCA et MATLAB .
&reg;
Et &eacute;galement avec les scripts dans MATLAB .
1.3
Classification des messages de s&eacute;curit&eacute;
Les messages de s&eacute;curit&eacute; signalent les dangers susceptibles d'entra&icirc;ner des
blessures ou des dommages mat&eacute;riels :
DANGER
DANGER indique une situation dangereuse avec un risque &eacute;lev&eacute; de mort ou de
blessure grave si elle n'est pas &eacute;vit&eacute;e.
AVERTISSEMENT
AVERTISSEMENT indique une situation dangereuse &agrave; moyen risque, susceptible d'entra&icirc;ner la mort ou des blessures graves si elle n'est pas &eacute;vit&eacute;e.
INCA-MIP V7.5 | Guide de l'utilisateur
1 Introduction | 7
ATTENTION
ATTENTION indique une situation dangereuse &agrave; faible risque, susceptible
d'entra&icirc;ner des blessures l&eacute;g&egrave;res ou mod&eacute;r&eacute;es si elle n'est pas &eacute;vit&eacute;e.
AVIS
AVIS indique une situation susceptible d'entra&icirc;ner des dommages mat&eacute;riels si
elle n'est pas &eacute;vit&eacute;e.
1.4
Informations de s&eacute;curit&eacute;
Observer les informations de s&eacute;curit&eacute; suivantes en travaillant avec INCA et les
add-ons INCA :
AVERTISSEMENT
Risque de comportement inattendu du v&eacute;hicule
Les op&eacute;rations de calibration influencent le comportement de l'ECU et des syst&egrave;mes connect&eacute;s &agrave; l'ECU.
Ceci peut entra&icirc;ner un comportement inattendu du v&eacute;hicule, notamment l'arr&ecirc;t
du moteur, un freinage, une acc&eacute;l&eacute;ration ou une embard&eacute;e du v&eacute;hicule.
N'effectuer des op&eacute;rations de calibration que si vous &ecirc;tes form&eacute; &agrave; l'utilisation
du produit et capable d'&eacute;valuer les r&eacute;actions possibles des syst&egrave;mes connect&eacute;s.
AVERTISSEMENT
Risque de comportement inattendu du v&eacute;hicule
La transmission de messages via des syst&egrave;mes de bus, tels que CAN, LIN,
FlexRay ou Ethernet, influence le comportement des syst&egrave;mes qui y sont
connect&eacute;s.
Ceci peut entra&icirc;ner un comportement inattendu du v&eacute;hicule, notamment l'arr&ecirc;t
du moteur, un freinage, une acc&eacute;l&eacute;ration ou une embard&eacute;e du v&eacute;hicule.
Ne proc&eacute;der &agrave; la transmission de messages via un syst&egrave;me de bus que si vous
disposez de connaissances suffisantes sur l'utilisation du syst&egrave;me de bus
concern&eacute; et &ecirc;tes capable d'&eacute;valuer les r&eacute;actions possibles des syst&egrave;mes
connect&eacute;s.
INCA-MIP V7.5 | Guide de l'utilisateur
1 Introduction | 8
Respecter les instructions des Consignes de s&eacute;curit&eacute; ETAS et les informations
de s&eacute;curit&eacute; fournies dans l'aide en ligne et les guides utilisateur.Ouvrir les Consignes de s&eacute;curit&eacute; ETAS dans le menu Aide d'INCA ? &gt; Consignes de s&eacute;curit&eacute;.
1.5
Protection des donn&eacute;es
Si le produit contient des fonctions qui traitent des donn&eacute;es personnelles, les exigences l&eacute;gales en mati&egrave;re de protection des donn&eacute;es et les lois sur la confidentialit&eacute; des donn&eacute;es doivent &ecirc;tre respect&eacute;es par le client. En tant que
contr&ocirc;leur des donn&eacute;es, le client con&ccedil;oit g&eacute;n&eacute;ralement le traitement ult&eacute;rieur. Il
doit donc v&eacute;rifier si les mesures de protection sont suffisantes.
1.6
S&eacute;curit&eacute; des donn&eacute;es et de l'information
Pour traiter les donn&eacute;es en toute s&eacute;curit&eacute; dans le contexte de ce produit, voir la
section &laquo; S&eacute;curit&eacute; des donn&eacute;es et de l'information &raquo; de l'Aide INCA.
INCA-MIP V7.5 | Guide de l'utilisateur
2 &Agrave; propos de INCA-MIP | 9
2
&Agrave; propos de INCA-MIP
L'AddOn INCA-MIP (INCA INCA Integration Package) est une interface de pro&reg;
grammation qui permet de contr&ocirc;ler les fonctionnalit&eacute;s de MATLAB depuis
&reg;
MATLAB . Dans ce cas, INCAse comporte comme un client acc&eacute;dant aux res&reg;
sources de MATLAB , qui est donc le serveur.
Le tableau suivant illustre une application typique de l'API INCA-MIP, utilisant
INCA pour adresser un ETK.
MATLAB
client
Lecture des donn&eacute;es de mesure
INCA
ETK
serveur
sur ECU
&Eacute;criture des donn&eacute;es de calibration
L'aper&ccedil;u suivant pr&eacute;sente les fonctionnalit&eacute;s de INCA auxquelles il est possible
&reg;
d'acc&eacute;der &agrave; partir de MATLAB .
gestionnaire de pages de m&eacute;moire
Le passage d'une page de m&eacute;moire &agrave; l'autre et le t&eacute;l&eacute;chargement de pages de
m&eacute;moire vers l'unit&eacute; de commande sont pris en charge.
Calibration
Toutes les variables d'&eacute;talonnage d'une exp&eacute;rience INCA peuvent &ecirc;tre modifi&eacute;es. Les valeurs peuvent &ecirc;tre lues et mises &agrave; jour pour chaque &eacute;l&eacute;ment et
pour les distributions de points de rupture associ&eacute;es, le cas &eacute;ch&eacute;ant.
Measuring
Toutes les variables de mesure d'une exp&eacute;rience INCA peuvent &ecirc;tre lues. En
&reg;
outre, les mesures peuvent &ecirc;tre lanc&eacute;es et arr&ecirc;t&eacute;es depuis le site MATLAB .
Toutes les donn&eacute;es de performance qui sont disponibles sur INCA sont &eacute;ga&reg;
lement accessibles sur MATLAB . Le d&eacute;bit des donn&eacute;es de performance &agrave;
l'interface INCA-MIP a &eacute;t&eacute; optimis&eacute;.
Comme INCA g&eacute;n&egrave;re les variables de mesure et d'&eacute;talonnage sous forme de
&reg;
doubles, les formules de conversion pour le retraitement dans MATLAB ne sont
pas n&eacute;cessaires.
Les fonctions API de INCA d&eacute;crites dans ce document sont appel&eacute;es &agrave; partir des
scripts de INCA (fichiers M), et peuvent &ecirc;tre utilis&eacute;s pour d&eacute;finir l'ensemble du
&reg;
flux de contr&ocirc;le des exp&eacute;rimentations MATLAB .
Les chapitres suivants d&eacute;crivent l'architecture sous-jacente de l'API INCA-MIP et
les fonctions API disponibles, ainsi que les proc&eacute;dures d'installation. Les op&eacute;&reg;
rations sous INCA ou sous MATLAB ne font pas partie de ce manuel.
INCA-MIP V7.5 | Guide de l'utilisateur
2 &Agrave; propos de INCA-MIP | 10
2.1
INCA D&eacute;finitions
La description des APIs utilise certains termes qu’un utilisateur exp&eacute;riment&eacute; de
INCA conna&icirc;t. Ci-dessous se trouve une br&egrave;ve d&eacute;finition de ces termes.
Variable de calibration
Une variable de calibration est un &eacute;l&eacute;ment qui peut &ecirc;tre lu et modifi&eacute;. Les
variables de calibration peuvent &ecirc;tre des scalaires, des vecteurs, des
matrices, des courbes ou des cartographies. Les distributions associ&eacute;es de
points d’appui sont &eacute;galement lisibles et modifiables.
Enregistrement des donn&eacute;es
Un enregistrement est compos&eacute; d’une base de temps et de toutes les valeurs
de mesure d’une fr&eacute;quence d’&eacute;chantillonnage pour une acquisition simple.
Les donn&eacute;es d’enregistrement pour une fr&eacute;quence d’&eacute;chantillonnage est compos&eacute; de plusieurs enregistrements qui sont g&eacute;n&eacute;r&eacute;s durant la proc&eacute;dure
d’enregistrement globale.
Module
Un module de mesure utilis&eacute; pour extraire les variables de mesure d'une grille
de mesure particuli&egrave;re. Certains modules de mesure supporte &eacute;galement la
calibration de variables. Par exemple, les modules SMB sont utilisables pour
les mesures uniquement, alors que les ETK conviennent &agrave; la fois aux mesures
et aux calibrations.
Donn&eacute;es de mesure
Tous les enregistrements captur&eacute;s d’une mesure pour diff&eacute;rentes fr&eacute;quences
d’&eacute;chantillonnage.
Raster de mesure
Taux d'acquisition (fr&eacute;quence de mesure) utilis&eacute; pour mesurer un ou plusieurs
signaux dans un groupe de signaux.
Il est possible de combiner deux rasters ou plus dans un soi-distant raster multiple. Il suffit de combiner les noms de raster au moyen d'un caract&egrave;re &laquo; + &raquo;, p.
ex. ’10 ms+100 ms’. L'utilisation d'un tel raster multiple cr&eacute;e un nouveau raster virtuel. Chaque signal peut uniquement &ecirc;tre mesur&eacute; dans exactement un
raster ou un raster multiple.
Buffer tournant
&reg;
Pour assurer un transfert fiable des donn&eacute;es de mesure d’INCA vers MATLAB ,
un buffer tournant d&eacute;di&eacute; est utilis&eacute; pour chaque fr&eacute;quence d’&eacute;chantillonnage
(groupe de signaux). Pendant une visualisation online d'INCA ou un enregistrement, les variables de mesure acquises sont automatiquement sauvegard&eacute;es dans le buffer tournant.
INCA-MIP V7.5 | Guide de l'utilisateur
2 &Agrave; propos de INCA-MIP | 11
La commande IncaGetRecords peut &ecirc;tre utilis&eacute;e pour lire les &eacute;chantillons
&reg;
de temps et les donn&eacute;es du buffer tournant vers MATLAB :
INCA Data
Acquisition
INCA Data
Acquisition
MATLAB Interface
IncaGetRecords
Le buffer tournant est limit&eacute; &agrave; 1 Mo par signal et peut enregistrer les donn&eacute;es
de mesure pendant environ 8 secondes en fonction de la fr&eacute;quence de
mesure. Apr&egrave;s ce temps de conservation les informations seront &eacute;cras&eacute;es.
Pour &eacute;viter de perdre des donn&eacute;es la commande IncaGetRecords doit &ecirc;tre
ex&eacute;cut&eacute;e r&eacute;guli&egrave;rement. Typiquement cela doit &ecirc;tre fait toutes les secondes.
Avec la commande IncaResetRecords la base de temps et les donn&eacute;es
contenues dans le buffer tournant pour toutes les fr&eacute;quences
d’&eacute;chantillonnage peuvent &ecirc;tre effac&eacute;es. Toutes les donn&eacute;es d&eacute;j&agrave; sauvegard&eacute;es dans le buffer tournant seront perdues:
INCA Data
Acquisition
INCA Data
Acquisition
MATLAB Interface
IncaResetRecords
Signal
Un signal est un &eacute;l&eacute;ment dont la valeur est mesur&eacute;e dans INCA. Chaque signal
est caract&eacute;ris&eacute; par son type de donn&eacute;es (bool&eacute;en, entier, flottant), sa longueur (1, 2, 4 ou 8 octets) et sa formule de conversion. La conversion &agrave; partir
de la valeur de mesure physique sur le niveau d'impl&eacute;mentation est sp&eacute;cifi&eacute;e
dans la formule de conversion.
Fr&eacute;quence d’&eacute;chantillonnage
Groupe de signaux; une fr&eacute;quence d’&eacute;chantillonnage est compos&eacute;e de plusieurs signaux individuels. Elle est caract&eacute;ris&eacute;e par sa fr&eacute;quence d’acquisition
(fr&eacute;quence de mesure) qui est la m&ecirc;me pour tous les signaux du groupe.
Chaque groupe de signaux a un nom unique.
INCA-MIP V7.5 | Guide de l'utilisateur
3 Installation | 12
3
Installation
INCA-MIP est une extension fonctionnelle de INCA.
&reg;
MATLAB utilise des appels de fonctions li&eacute;s dynamiquement, appel&eacute;s fichiers
MEX, pour communiquer avec d’autres applications. INCA-MIP est un ensemble
de fichiers MEX qui sont copi&eacute;s dans les sous-r&eacute;pertoires associ&eacute;s au r&eacute;pertoire
&reg;
du programme MATLAB lors de l’installation.
INCA-MIP est disponible en deux versions. L’AddOn de base : &laquo; INCA-MIP Base API
&raquo; est disponible directement apr&egrave;s l’installation. Pour utiliser la version &eacute;volu&eacute;e &laquo;
INCA-MIP Extended API set &raquo; une licence sous forme de clef est requise. Une liste
des APIs et des descriptions respectives peut &ecirc;tre trouv&eacute; dans &quot;Fonctions API&quot; &agrave;
la page 16.
3.1
Minimum requis
Pour utiliser l’AddOn INCA-MIP, INCA doit &ecirc;tre install&eacute; sur votre ordinateur. Pour
plus d'informations sur les exigences du syst&egrave;me INCA, consultez le guide
d'installation INCA.
Si vous souhaitez d&eacute;velopper vous-m&ecirc;me des scripts INCA pour acc&eacute;der &agrave;
&reg;
&reg;
MATLAB , vous aurez besoin d’une licence compl&egrave;te de MATLAB .
INCA-MIP pour INCA V7.5 n&eacute;cessite les versions de programme suivantes :
INCA V7.5 SPx
Note
INCA V7.5 est n&eacute;cessaire pour l'installation de cette version INCA-MIP.
Assurez-vous que le num&eacute;ro de version INCA de l'installation INCA est
compatible avec le num&eacute;ro de version du module compl&eacute;mentaire INCAMIP.
Apr&egrave;s l'installation, vous pouvez utiliser cette version INCA-MIP pour travailler avec toute version INCAV7.x .&quot;Ouvrir INCA&quot; &agrave; la page 26
&reg;
MATLAB 64 bit version 2016a ou sup&eacute;rieure (pour l'installation int&eacute;gr&eacute;e de
&reg;
MATLAB )
Pour plus d'informations sur les versions de INCA prises en charge, contactez
&reg;
votre support MATLAB .
3.2
Installation
Avant d’installer l’AddOn il est n&eacute;cessaire de conna&icirc;tre le type de l’installation.
Les types suivants sont possible :
&reg;
Installation en mode MATLAB int&eacute;gr&eacute; (MATLAB integrated installation)
&reg;
S&eacute;lectionnez cette option si vous utilisez une version de MATLAB pour
INCA-MIP V7.5 | Guide de l'utilisateur
3 Installation | 13
d&eacute;velopper des scripts .MATLAB
&reg;
Installation dans ETASData
S&eacute;lectionnez l’option runtime si vous souhaitez uniquement lancer des
&reg;
scripts compil&eacute; de INCA-MIP ou si vous souhaitez utiliser MATLAB avec dif&reg;
f&eacute;rentes versions de MATLAB sur votre PC. Pour plus de d&eacute;tails, voir cidessous.
Pour installer INCA-MIP :
V&eacute;rifiez que INCA est install&eacute; sur votre PC et que la version d’INCA est compatible
avec la version de l’AddOn INCA-MIP.
&reg;
Si vous souhaitez d&eacute;velopper vos propres scripts MATLAB pour acc&eacute;der &agrave; INCA,
&reg;
v&eacute;rifier que MATLAB est install&eacute; sur votre ordinateur et que la version de
&reg;
MATLAB est compatible avec celle de l’AddOn INCA-MIP.
1. Fermez tous les programmes actifs.
2. Selon la r&eacute;glementation propre &agrave; votre entreprise, les fichiers d'installation
sont fournis sur un lecteur r&eacute;seau ou sur un DVD.
En utilisant le DVD, la routine d'installation d&eacute;marre automatiquement. Si ce
n'est pas le cas, ex&eacute;cutez manuellement le fichier Autostart.exe sur le
DVD, cliquez sur Installation, puis s&eacute;lectionnez l'installation INCA-MIP.
Si vous installez le programme depuis un lecteur r&eacute;seau, ex&eacute;cutez le fichier
setup.exe.
3. Suivez les instructions de la routine d'installation pour installer INCA-MIP
sur votre ordinateur.
4. Dans le programme d’installation, vous &ecirc;tes pri&eacute; de pr&eacute;ciser le type
d’installation souhait&eacute;e :
&reg;
5. Si vous souhaitez d&eacute;velopper des scripts MATLAB avec une seule version
&reg;
MATLAB install&eacute;e sur votre ordinateur, s&eacute;lectionnez l’option MATLAB
&reg;
Integrated installation.
INCA-MIP V7.5 | Guide de l'utilisateur
3 Installation | 14
ou
S&eacute;lectionnez l’option Installation into ETASData pour les cas suivant :
l
&reg;
Vous souhaitez utiliser INCA-MIP avec diff&eacute;rentes versions de MATLAB .
Dans ce cas vous devez ajouter le sous-r&eacute;pertoire d’INCA-MIP dans le
&reg;
r&eacute;pertoire toolbox INCA-MIP pour chaque installation MATLAB avant de
&reg;
pouvoir utiliser les commandes .MATLAB Consulter votre docu&reg;
mentation utilisateur de MATLAB pour savoir comment ajouter des chemins d’acc&egrave;s suppl&eacute;mentaires &agrave; MATLAB.MATLAB
l
&reg;
Vous ne voulez ex&eacute;cuter que des ex&eacute;cutables autonomes facilement
&reg;
&reg;
disponibles MATLAB cr&eacute;&eacute;s avec MATLAB .
Note
L’installation dans ETASData est n&eacute;cessaire si vous utilisez des fichiers
programme qui contiennent des instructions INCA pour la commande
&reg;
&reg;
d’MATLAB . Dans ce cas vous n’avez pas besoin de licence MATLAB . Les
fichiers ex&eacute;cutables doivent &ecirc;tre mise &agrave; disposition par les d&eacute;veloppeurs
&reg;
avec une installation MATLAB (voir &quot;Cr&eacute;ation et distribution de fichiers
ex&eacute;cutables autonomes &agrave; l'aide du compilateur MATLAB&reg; &quot; &agrave; la page 74).
6. Continuez l’installation.
Obtenir la licence pour INCA-MIP :
Si vous projetez d’utiliser la version &eacute;volu&eacute;e des fonctions APIs &laquo; INCA MATLAB
Extended API set &raquo;, un fichier de licence sera requis.
Pour plus d'informations sur les licences, voir &quot;Licences&quot; &agrave; la page suivante.
3.3
Mettre &agrave; jour les &laquo; liens Cache &raquo; de la bo&icirc;te &agrave; outils
&reg;
MATLAB
Apr&egrave;s installation de l’API INCA-MIP, vous devez d’abord mettre &agrave; jour le cache
&reg;
pour les r&eacute;pertoires de la bo&icirc;te &agrave; outils MATLAB au cas o&ugrave; ce cache a &eacute;t&eacute; activ&eacute;
&reg;
&reg;
lors de votre installation de .MATLAB C’est le cas avec la version MATLAB V6 ou
plus si vous utilisez les param&egrave;tres par d&eacute;faut ; les liens sont d&eacute;sactiv&eacute;s dans les
versions ant&eacute;rieures &agrave; la V6. Les liens Cache doivent &ecirc;tre mis &agrave; jour pour que les
&reg;
fichiers utilis&eacute;s dans l’AddOn INCA-MIP API soient enregistr&eacute;s dans MATLAB .
&reg;
Veuillez consulter la documentation utilisateur de MATLAB pour mettre &agrave; jour les
liens Cache des r&eacute;pertoires de la bo&icirc;te &agrave; outils .MATLAB
3.4
&reg;
D&eacute;sactiver les liens Caches des r&eacute;pertoires des r&eacute;per&reg;
toires de bo&icirc;te &agrave; outils MATLAB
Si vous travaillez avec l’AddOn INCA-MIP, il est recommand&eacute; de d&eacute;sactiver les &laquo;
&reg;
liens Cache &raquo; des r&eacute;pertoires de la bo&icirc;te &agrave; outils MATLAB . Sinon, des dysfonctionnements peuvent survenir si l’AddOn INCA-MIP ou des scripts
INCA-MIP V7.5 | Guide de l'utilisateur
3 Installation | 15
ind&eacute;pendant nouvellement int&eacute;gr&eacute;s se peuvent pas &ecirc;tre trouv&eacute;s.
Une autre solution que la d&eacute;sactivation des &laquo; liens Caches &raquo; consiste &agrave; forcer la
mise &agrave; jour des liens Cache s’ils sont activ&eacute;s comme indiqu&eacute; pr&eacute;c&eacute;demment.
Cependant pour &eacute;viter toute mauvaise manipulation nous vous recommandons
de d&eacute;sactiver les &laquo; liens Caches &raquo; lors de l’utilisation de l’AddOn INCA-MIP.
&reg;
Veuillez consulter la documentation utilisateur de MATLAB pour activer ou
d&eacute;sactiver les liens Cache des r&eacute;pertoires de la bo&icirc;te &agrave; outils .MATLAB
3.5
&reg;
Licences
Une licence valide est n&eacute;cessaire pour utiliser le logiciel. Vous pouvez obtenir une
licence de l'une des mani&egrave;res suivantes :
de votre coordinateur d'outils
via le portail en libre-service sur le site web d'ETAS &agrave; l'adresse www.etas.com/support/licensing
via le gestionnaire de licences ETAS
Pour activer la licence, vous devez saisir l'ID d'activation que vous avez re&ccedil;u
d'ETAS lors de la proc&eacute;dure de commande.
Pour plus d'informations sur la gestion des licences ETAS, consultez la FAQ sur la
gestion des licences ETAS ou l'aide du gestionnaire de licences ETAS.
Pour ouvrir l'aide du gestionnaire de licences ETAS
Le gestionnaire de licences ETAS est disponible sur votre ordinateur apr&egrave;s
l'installation de tout logiciel ETAS.
1. Dans le menu D&eacute;marrer de Windows, s&eacute;lectionnez E &gt; ETAS &gt; ETAS
License Manager.
via le gestionnaire de licences ETAS
2. Cliquez dans la fen&ecirc;tre du gestionnaire de licences ETAS et appuyez sur la
touche F1.
L'aide du gestionnaire de licence ETAS s'ouvre.
Utilisation distante d'INCA
Il n'est pas permis d'utiliser une licence de poste de travail INCA (LICENCE BAS&Eacute;E
SUR MACHINE) via des applications Internet ou r&eacute;seau, par exemple Microsoft
Remote Desktop, ou d'autres services de terminaux ou de dispositifs. Cela ne
s'applique pas pour le fonctionnement d'INCA par le biais de protocoles de banc
d'essai (ASAP 3, MCD-3 MC, iLinkRT).
L'utilisation d'une licence de type UTILISATEUR NOMM&Eacute; ou d'une licence
FLOTTANTE permet d'acc&eacute;der &agrave; INCA via Microsoft Remote Desktop dans la
mesure o&ugrave; il est garanti qu'un seul utilisateur utilise une licence en m&ecirc;me temps.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 16
4
Fonctions API
L’AddOn INCA-MIP fourni une liste de fonctions pour automatiser le fonctionnement de INCA. Quelques fonctions sont disponibles dans la version de
base de l’AddOn INCA-MIP, d’autres ne sont disponibles qu’en achetant la version
&eacute;volu&eacute;e de cet AddOn INCA-MIP.
Note
Les commandes qui ne sont disponibles qu’avec la version &eacute;volu&eacute; de
INCA-MIP sont prot&eacute;g&eacute;es par une licence. Vous ne pourrez pas utiliser les
fonctions de la version &eacute;volu&eacute;e sans licence valide, l’ex&eacute;cution de ces
&reg;
scripts MATLAB g&eacute;n&eacute;rera une exception.
Nous vous recommandons, avant d’utiliser les commandes de la version
&eacute;volu&eacute;e de l’AddOn INCA-MIP, de v&eacute;rifier la validit&eacute; de la licence &agrave; l’aide de
la commande IncaIsLicenseValid.
Le tableau suivant r&eacute;pertorie toutes les fonctions de l'API INCA-MIP qui sont disponibles dans le module compl&eacute;mentaire pour INCA V7.5. Il indique
Si la fonction est disponible dans la version de base de l’AddOn (INCA-MIP
Base Package) ou uniquement dans sa version &eacute;volu&eacute;e (INCA-MIP Extended package);
Si la fonction est utilis&eacute;e pour l’initialisation, la mesure, la calibration, la gestion des pages m&eacute;moire ou s’il s’agit d’une fonction plus g&eacute;n&eacute;rale;
L’endroit dans le document o&ugrave; vous pourrez trouver plus d’informations
concernant la fonction.
Fonction
Basea
Evo.b
Cat&eacute;gorie
Voir
IncaAddCalibrationElement
x
x
Calibration
&agrave; la page 59
IncaAddMeasureElement
x
x
Mesure
&agrave; la page 36
IncaBrowseCalibrationElements
x
Calibration
&agrave; la page 58
IncaBrowseItemsInFolder
x
Initialisation
&agrave; la page 29
IncaBrowseMeasureElements
x
Mesure
&agrave; la page 35
IncaClose
x
Initialisation
&agrave; la page 27
x
Gestion Page
&agrave; la page 71
IncaCopyPageFromTo
x
M&eacute;moire
IncaDatabaseImport
IncaDownloadDifferences
x
x
Initialisation
&agrave; la page 28
x
Gestion Page
&agrave; la page 71
M&eacute;moire
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 17
Fonction
Basea
Evo.b
Cat&eacute;gorie
Voir
IncaDownloadPage
x
x
Gestion Page
&agrave; la page 70
M&eacute;moire
IncaExecuteManualTrigger
IncaGetCalibrationValue
x
IncaGetCurrentPage
x
Mesure
&agrave; la page 56
x
Calibration
&agrave; la page 60
x
Gestion Page
&agrave; la page 69
M&eacute;moire
IncaGetDatasetsForDevice
x
Calibration
&agrave; la page 66
IncaGetDeviceProperties
x
Initialisation
&agrave; la page 33
IncaGetDevices
x
Initialisation
&agrave; la page 33
IncaGetHardwareStatus
x
Mesure
&agrave; la page 52
IncaGetInstalledAddOnInfo
x
x
General
&agrave; la page 24
IncaGetInstalledProductInfo
x
x
General
&agrave; la page 23
IncaGetMeasureRatesForDevice
x
Mesure
&agrave; la page 36
IncaGetProperties
x
General
&agrave; la page 25
IncaGetRecordingMode
x
Mesure
&agrave; la page 44
IncaGetRecordingProperties
x
Mesure
&agrave; la page 39
IncaGetRecordingState
x
Mesure
&agrave; la page 56
x
Mesure
&agrave; la page 48
x
Mesure
&agrave; la page 57
x
General
&agrave; la page 25
IncaGroupDevices
x
Calibration
&agrave; la page 68
IncaIsLicenseValid
x
General
&agrave; la page 23
IncaGetRecords
x
IncaGetRecordStruct
IncaGetVersion
x
IncaMessageIds
x
x
General
&agrave; la page 20
IncaIsPageWriteProtected
x
x
Gestion Page
&agrave; la page 70
M&eacute;moire
IncaOpen
x
x
Initialisation
&agrave; la page 26
IncaOpenDatabase
x
x
Initialisation
&agrave; la page 27
IncaOpenExperiment
x
x
Initialisation
&agrave; la page 31
IncaResetExperiment
x
x
Initialisation
&agrave; la page 32
IncaResetRecords
x
x
Mesure
&agrave; la page 51
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 18
Basea
Evo.b
Cat&eacute;gorie
Voir
x
Calibration
&agrave; la page 67
x
Calibration
&agrave; la page 62
x
Calibration
&agrave; la page 66
x
Mesure
&agrave; la page 47
IncaSetProjectAndDatasetInDevice
x
Initialisation
&agrave; la page 31
IncaSetRecordingMode
x
Mesure
&agrave; la page 45
IncaSetRecordingProperties
x
Mesure
&agrave; la page 41
IncaSetTrigger
x
Mesure
&agrave; la page 52
Fonction
IncaSetCalibrationMode
IncaSetCalibrationValue
x
IncaSetDatasetInDevice
IncaSetMeasureReadMode
x
IncaShowMessages
x
x
General
&agrave; la page 23
IncaStartMeasurement
x
x
Mesure
&agrave; la page 38
IncaStartRecording
x
x
Mesure
&agrave; la page 46
IncaStopMeasurement
x
x
Mesure
&agrave; la page 39
IncaStopRecording
x
x
Mesure
&agrave; la page 46
IncaSwitchPage
x
x
Gestion Page
&agrave; la page 69
M&eacute;moire
IncaUploadPages
x
Gestion Page
&agrave; la page 72
M&eacute;moire
IncaWriteToFile
x
Calibration
&agrave; la page 68
a Fonctions support&eacute;es par la version de base de l’AddOn (&quot;INCA-MIP Base Package&quot;)
b Fonctions support&eacute;e par la version &eacute;volu&eacute;e de l’AddOn (&quot;INCA-MIP Extended Package&quot;)
Par la suite, la description des fonctions est organis&eacute;e en fonction de leurs
champs d’application:
&quot;Fonctions G&eacute;n&eacute;rales&quot; &agrave; la page 20
&quot;Initialisation&quot; &agrave; la page 26
&quot;Mesure et Enregistrement&quot; &agrave; la page 34
&quot;Calibration&quot; &agrave; la page 57
&quot;Gestion des pages m&eacute;moires&quot; &agrave; la page 69
De plus, un certain nombre de fichiers d’exemples fournis avec la version de d&eacute;veloppement de l’AddOn INCA-MIP sont d&eacute;cris au &quot;Conna&icirc;tre l’AddOn INCA-MIP
gr&acirc;ce &agrave; des exemples:&quot; &agrave; la page suivante.
Des exemples sont donn&eacute;s dans &quot;Exemples&quot; &agrave; la page 72.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 19
Note
L’interface INCA-MIP fonctionne toujours &agrave; partir des param&egrave;tres globaux
des Options Utilisateur de .INCA Pour plus d’information sur les Options
Utilisateur de INCA veuillez consulter la documentation INCA.
4.1
Conna&icirc;tre l’AddOn INCA-MIP gr&acirc;ce &agrave; des exemples:
L’AddOn INCA-MIP est livr&eacute; avec des exemples. Dans le cas o&ugrave; vous s&eacute;lectionnez
l’installation de la version &eacute;volu&eacute;, ces fichiers d’exemples types sont automatiquement install&eacute;s sur votre ordinateur en compl&eacute;mant des fichiers MEX. Les
fichiers types utilise plusieurs exemples pour expliquer l’utilisation de l’AddOn
INCA-MIP.
Les exemples incluent certains fichiers M qui utilsent l’AddOn INCA-MIP, ainsi
qu’une base de donn&eacute;es INCA o&ugrave; les &eacute;l&eacute;ments utilis&eacute;s dans les fichiers scripts
ont d&eacute;j&agrave; &eacute;t&eacute; cr&eacute;es.
Les exemples sont copi&eacute;s pendant l’installation dans les r&eacute;pertoires suivants
(voir &quot;Installation&quot; &agrave; la page 12) :
&reg;
Pour une installation en mode Installation into MATLAB :
Fichiers M: %MatlabDir%\toolbox\matlab\demos
Pour une installation en mode Installation into ETASData:
Fichiers M : %EtasDataDir%\INCA-MIPx64
Base de donn&eacute;es d&eacute;mo INCA: %EtasDataDir%\Database\db_matlabtest
Pour utiliser les fichiers exemples, vous devez d’abord lancer INCA et ouvrir la
base de donn&eacute;es fournie. Il n’est pas n&eacute;cessaire d’avoir du mat&eacute;riel.
Les fonctions des fichiers M sont d&eacute;crites ci-dessous.
&reg;
tOpen.m – &eacute;tablit une connexion entre INCA et MATLAB . Cette fonction
doit &ecirc;tre utilis&eacute;e au d&eacute;marrage de chaque session INCA-MIP avant
&reg;
l'utilisation d'une autre fonction de l'API MATLAB .
tDummy.m – ouvre une exp&eacute;rimentation INCA vide en utilisant une configuration mat&eacute;rielle ayant un module de test VADI. Le script cr&eacute;e plusieurs
variables de mesure dans l'environnement INCA.
tEtkDummy.m – ouvre une exp&eacute;rimentation INCA vide en utilisant une
configuration mat&eacute;rielle ayant un module de test ETK. Le script cr&eacute;e plusieurs variables de mesure et de calibration dans l'environnement INCA. Il
re&ccedil;oit &eacute;galement les pages de travail et de r&eacute;f&eacute;rence, il lit les variables de
mesure et de calibration et modifie les valeurs des variables de calibration
ind&eacute;pendantes.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 20
tGetRecords(aGroupName).m – rassemble les donn&eacute;es de mesure du
&reg;
groupe aGroupName pendant 20 secondes puis les transmet &agrave; MATLAB .
Cette fonction est utilisable avec les exemples VADI et ETK. (pour les “fr&eacute;quences d’&eacute;chantillonnage,” voir &quot;INCA D&eacute;finitions&quot; &agrave; la page 10.)
tPrintDB ({aFolder{, aFileId}}).m – Ecrit tout le contenu de la
base de donn&eacute;es commen&ccedil;ant par le r&eacute;pertoire aFolder vers un fichier
aFileId. Si cette fonction est utilis&eacute;e sans param&egrave;tre, toute
l’arborescence de la base de donn&eacute;es est imprim&eacute;e par la sortie standard.
tHWStatus.m – Exemple de l’utilisation de la fonction API IncaGetHard&reg;
wareStatus. MATLAB se connecte &agrave; une exp&eacute;rimentation d&eacute;j&agrave; ouverte
et choisit le premier &eacute;l&eacute;ment de mesure trouv&eacute; dans le premier dispositif
de mesure trouv&eacute;. Il continue une mesure de 5 minutes. S'il y a un avertissement ou une erreur pendant la mesure le cycle de mesure est abandonn&eacute; puis remis en marche apr&egrave;s un d&eacute;lais de 5 secondes.
4.2
Fonctions G&eacute;n&eacute;rales
Les fonctions API g&eacute;n&eacute;rales suivantes sont disponibles:
4.2.1
Listes les messages de l’AddOn INCA-MIP
Les commandes de l’AddOn INCA-MIP peuvent retourner des erreurs.
En utilisant les blocs try/catch, une information d&eacute;taill&eacute;e de l’erreur est retourn&eacute;e.
Exemple
avec:
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 21
msgstr
Une phrase de description
msgid
L’identificateur de message. Les identificateurs de message suivant sont disponibles:
INCA:ParameterError
INCA:ReturnParameterError
INCA:WrongParameterValue
INCA:WrongParameterType
INCA:NaN
INCA:ExecutionError
INCA:ResourceError
INCA:RasterFull
INCA:ObjectIsWriteProtected
INCA:CallSeqenceError
INCA:LicenseError
INCA:RecordingInProcess
INCA:NotInstalled
INCA:WrongVersion
Description des identificateurs de message:
INCA:ParameterError
Mauvais nombre de param&egrave;tres
d’entr&eacute;e pass&eacute; dans la fonction
(Param&egrave;tres de droite)
INCA:Re-
Mauvais nombre de param&egrave;tre de
turnParameterError
sortie renvoy&eacute; par la fonction
(param&egrave;tre de gauche)
INCA:WrongParameterValue
Une des valeurs des param&egrave;tres
d’entr&eacute;e de la fonction est en dehors
de sa plage valide ou de sa sp&eacute;cification
INCA:WrongParameterType
Un des param&egrave;tre d’entr&eacute;e de la fonction n’est pas du bon type
INCA:NaN
Un des param&egrave;tre contient une
valeur du type ’not a number’ (pas un
nombre)
INCA:ExecutionError
Durant l’ex&eacute;cution de la commande
une erreur a eu lieu. Essayer
d’ex&eacute;cuter la fonctionnalit&eacute; &agrave; partir
de INCA peut donner plus
d’informations sur l’erreur. Red&eacute;marrer INCA ou l’ordinateur peut
aussi aider.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 22
INCA:ResourceError
Impossible d’obtenir des ressources
du syst&egrave;me d’exploitation. Red&eacute;marrer INCA ou l’ordinateur peut
aider.
INCA:RasterFull
La liste d’acquisition est pleine pour
cette fr&eacute;quence d’&eacute;chantillonnage
lors de l’ajout d’une mesure
INCA:Ob-
Impossible de calibrer &agrave; cause d’une
jectIsWriteProtected
protection en &eacute;criture de l’&eacute;l&eacute;ment
INCA:CallSeqenceError
Avant d’ex&eacute;cuter cette commande
d’autres commandes doivent &ecirc;tre
ex&eacute;cut&eacute;es en premier. Par Exemple
IncaOpenExperiment est n&eacute;cessaire avant IncaAddMeasureElement.
INCA:LicenseError
Pour ex&eacute;cuter la commande avec les
param&egrave;tres donn&eacute;s, une licence est
requise.
INCA:RecordingInProcess
Impossible d'ex&eacute;cuter la commande
demand&eacute;e (p. ex. activer ou d&eacute;sactiver les signaux pour
l'enregistrement avec SetRecordingMode) parce qu'un enregistrement est en cours.
INCA:NotInstalled
Impossible d'ouvrir la version INCA
sp&eacute;cifi&eacute;e avec la commande IncaOpen parce que la version INCA correspondante n'est pas install&eacute;e.
INCA:WrongVersion
Impossible d'ouvrir la version INCA
sp&eacute;cifi&eacute;e avec la commande IncaOpen pour l'une des raisons suivantes
:
INCA est d&eacute;j&agrave; d&eacute;marr&eacute; et une commande IncaOpen est ex&eacute;cut&eacute;e
avec un param&egrave;tres de version diff&eacute;rent de la version INCA d&eacute;j&agrave;
ouverte
Une commande IncaOpen est
ex&eacute;cut&eacute;e depuis INCA-MIP pour
INCA Vx.y avec un param&egrave;tre de
version avec version majeure != x
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 23
4.2.2
Activer l'affichage d'information durant l’ex&eacute;cution des
scripts
Nom
IncaShowMessages
Description
Active ou d&eacute;sactive l'affichage d'information dans la
&reg;
fen&ecirc;tre MATLAB pendant l'ex&eacute;cution du script.
Syntaxe
IncaShowMessages(VraiOuFaux)
Arguments
none
de sortie
Arguments
VraiOuFaux
d’entr&eacute;e
Param&egrave;tre num&eacute;rique qui est soit
&eacute;gal &agrave; z&eacute;ro soit diff&eacute;rent de z&eacute;ro. Si
le param&egrave;tre est z&eacute;ro, l’affichage de
l’information est d&eacute;sactiv&eacute;, autrement l’affichage est activ&eacute; (d&eacute;faut).
Exemples
IncaShowMessages(0);
IncaShowMessages;
4.2.3
Afficher l’&eacute;tat de la licence INCA-MIP (INCA-MIP Evolu&eacute;e)
Nom
IncaIsLicenseValid
Description
Renvoi un statut indiquant si la licence INCA-MIP est
valide ou non
Syntaxe
s = IncaIsLicenseValid
Arguments
s
de sortie
Statut de la licence
0 : Pas de licence valide
1 : Licence valide
Arguments
none
d’entr&eacute;e
Exemples
4.2.4
statut = IncaIsLicenseValid
Lire informations sur toutes les versions INCA install&eacute;es
Nom
IncaGetInstalledProductInfo
Description
Lire informations sur toutes les versions INCA install&eacute;es.
Cette commande peut &ecirc;tre ex&eacute;cut&eacute;e avant IncaOpen.
Syntaxe
info = IncaGetInstalledProductInfo
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 24
Arguments
information sur les ver-
info
de sortie
sions INCA install&eacute;es en
tant que struct. MATLAB
&reg;
pour chaque installation
et comprenant les
entr&eacute;es suivantes :
info.name
le nom du produit
info.version
la cha&icirc;ne de version du
produit
info.hotfixVersion
le hotfix install&eacute; sous
forme de cha&icirc;ne ou une
cha&icirc;ne vide si aucun hotfix
n'est install&eacute;
Arguments
none
d’entr&eacute;e
Exemples
4.2.5
i = IncaGetInstalledProductInfo;
Lire Information sur tous les add-ons install&eacute;s
Nom
IncaGetInstalledAddOnInfo
Description
Fournit des informations sur tous les add-ons install&eacute;s
pour un produit donn&eacute;.
Cette commande peut &ecirc;tre ex&eacute;cut&eacute;e avant IncaOpen.
Syntaxe
info = IncaGetInstalledAddOnInfo(productName, productVersion)
Arguments
info
de sortie
information sur les add-ons install&eacute;s en tant que struct.
&reg;
MATLAB pour chaque installation et comprenant les
entr&eacute;es suivantes :
info.name
le nom de l'add-on install&eacute;
info.version
la cha&icirc;ne de version de l'add-on
install&eacute;
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 25
Arguments
productName
le nom du produit
productVersion
la version du produit sous
d’entr&eacute;e
forme de cha&icirc;ne.
La cha&icirc;ne de version compl&egrave;te
est pertinente.
Exemples
i = IncaGetInstalledAddOnInfo('INCA',
'V7.5.0');
i = IncaGetInstalledAddOnInfo('INCA',
'V7.5.1 Beta 100');
Note
Assurez-vous de bien utiliser pour les arguments d'entr&eacute;e productName
et productVersion exactement le nom et la version d'un produit tel que
retourn&eacute; par IncaGetInstalledProductInfo.
4.2.6
Conna&icirc;tre la version de INCA
Nom
IncaGetVersion
Description
Cette fonction permet de conna&icirc;tre la version de INCA.
Syntaxe
IncaGetVersion
Arguments
version
la version INCA comme une cha&icirc;ne
de sortie
Arguments
none
d’entr&eacute;e
Exemples
4.2.7
IncaGetVersion;
Lire les propri&eacute;t&eacute;s de INCA (INCA-MIP Evolu&eacute;e)
Nom
IncaGetProperties
Description
Lit les propri&eacute;t&eacute;s de INCA
Syntaxe
p = IncaGetProperties
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 26
Arguments
Propri&eacute;t&eacute;s de INCA affich&eacute;es en tant
p
&reg;
de sortie
que structure MATLAB , constitu&eacute;e
des entr&eacute;es suivantes:
p.databasePath - Chemin
d’acc&egrave;s de la base de donn&eacute;es
INCA ouverte. S’il n’y a pas de
base de donn&eacute;es INCA ouverte
une cha&icirc;ne de caract&egrave;re vide est
renvoy&eacute;e.
p.dataPath - Chemin d’acc&egrave;s du
r&eacute;pertoire des donn&eacute;es de INCA.
p.installationPath - Chemin
d’acc&egrave;s du r&eacute;pertoire
d’installation de INCA.
p.tempPath - Chemin d’acc&egrave;s du
r&eacute;pertoire utilis&eacute; par les outils
ETAS pour les fichiers temporaires.
Arguments
none
d’entr&eacute;e
Exemples
4.3
p = INCAGetProperties;
Initialisation
Toutes les op&eacute;rations de mesure et de calibration dans INCA sont effectu&eacute;es
dans le cadre d'une exp&eacute;rimentation. Avant d’ouvrir une exp&eacute;rimentation, un
espace de travail valide et une configuration mat&eacute;riel valide doivent &ecirc;tre cr&eacute;&eacute;s et
assign&eacute;.
Pour travailler avec l'AddOn INCA-MIP, une exp&eacute;rimentation vide doit exister dans
la base de donn&eacute;es INCA pour laquelle un espace de travail valide et une configuration mat&eacute;rielle doivent d'abord &ecirc;tre cr&eacute;&eacute;s et attribu&eacute;s. Puis l'exp&eacute;rimentation
&reg;
peut &ecirc;tre ouverte &agrave; partir de MATLAB .
Les fonctions API suivantes sont disponibles pour l’initialisation:
4.3.1
Ouvrir INCA
Nom
IncaOpen
Description
Ouvre INCA et initialise la communication entre INCA et
&reg;
MATLAB .
Syntaxe
IncaOpen
IncaOpen( version )
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 27
Arguments
none
de sortie
Arguments
version
d’entr&eacute;e
Version INCA &agrave; ouvrir (facultatif).
Syntaxe :
&lt;
MajorVersion&gt;.&lt;MinorVersion&gt;.
INCA-MIP pour INCA x.y peut uniquement se connecter aux installations INCA de la m&ecirc;me version
majeure x.INCA
Exemples
IncaOpen;
IncaOpen('7.3');
4.3.2
Fermer INCA (INCA-MIP Evolu&eacute;e)
Nom
IncaClose
Description
Se d&eacute;connecte par INCA et ferme INCA (optionnel)
apr&egrave;s s'&ecirc;tre connect&eacute; avec succ&egrave;s &agrave; INCA avec IncaOpen.
Syntaxe
IncaClose
IncaClose( isDisconnectOnly )
Arguments
none
de sortie
Arguments
isDisconnect
Sp&eacute;cifie si INCA seulement d&eacute;con-
d’entr&eacute;e
Only
necte par INCA ou si en plus il
&reg;
ferme MATLAB (optionnel).
Valeurs disponibles:
0 : D&eacute;connecte par INCA et
ferme INCA (d&eacute;fault).
1 : D&eacute;connecte par INCA et
laisse INCA ouvert.
Exemples
INCAClose ;
INCAIncClose(1);
4.3.3
Ouvrir une base de donn&eacute;es
Nom
IncaOpenDatabase
Description
Cette fonction ouvre une base de donn&eacute;es dans le
r&eacute;pertoire sp&eacute;cifi&eacute;.
Syntaxe
IncaOpenDatabase({pathName})
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 28
Arguments
none
de sortie
Arguments
Le r&eacute;pertoire dans lequel la base
pathName
d’entr&eacute;e
de donn&eacute;es est ouverte et enregistr&eacute;e. Si aucun r&eacute;pertoire n'est
sp&eacute;cifi&eacute;, la base de donn&eacute;es
actuelle est ouverte.
Exemples
IncaOpenDatabase; % ouvrir la base de donn&eacute;es actuelle
IncaOpenDatabase
(’c:\etasdata\madatabase’);
4.3.4
Importer une base de donn&eacute;es (INCA-MIP Evolu&eacute;e)
Nom
IncaDatabaseImport
Description
Cette fonction importe le fichier export d’une base de
donn&eacute;es (*.exp) dans INCA. Les &eacute;l&eacute;ments de la base de
donn&eacute;es d&eacute;j&agrave; existant seront toujours &eacute;cras&eacute;s.
Syntaxe
IncaDatabaseImport(path)
nom = IncaDatabaseImport(path)
[nom, type] = IncaDatabaseImport(path)
Arguments
de sortie
nom
Tableau de tous les chemins des
&eacute;l&eacute;ments import&eacute;s
Utilisez la fonction deblank()
lorsque vous acc&eacute;der &agrave; un tableau:
name2 = deblank(nom(2,:))
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 29
type
Tableau de tous les types des &eacute;l&eacute;ments import&eacute;s
Les valeurs possibles sont:
Folder: Un r&eacute;pertoire de base
de donn&eacute;es
Experiment: Une exp&eacute;rimentation
Workspace: Un espace de travail
Asap2Project: Un projet A2L
MeasurementCatalog: Un
catalogue de mesure ASAP2
CanDB: Une base de donn&eacute;es
CAN ASAP2
Utilisez la fonction deblank()
lorsque vous acc&eacute;der &agrave; un tableau:
type2 = deblank(type(2,:))
Arguments
path
d’entr&eacute;e
Exemples
Le chemin complet du fichier *.exp
&agrave; importer
noms = IncaDatabaseImport('D:\
ETASData\INCA7.5\export\Project0815.exp')
4.3.5
Lire les &eacute;l&eacute;ments de la base de donn&eacute;es (INCA-MIP Evolu&eacute;e)
Nom
IncaBrowseItemsInFolder
Description
Cette fonction permet de lister les &eacute;l&eacute;ments de la base
de donn&eacute;es avec un filtre de recherche
Syntaxe
[nom, type] = IncaBrowseItemsInFolder(pattern, folderName)
Arguments
de sortie
nom
Liste des noms des &eacute;l&eacute;ments de la base de donne&eacute;s
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 30
type
Liste des types des &eacute;l&eacute;ments de la base de donn&eacute;es:
Folder: R&eacute;pertoire
Experiment: Exp&eacute;rimentation
Workspace: Espace de
travail
Asap2Project: Projet
A2L ASAP2
Arguments
pattern
d’entr&eacute;e
Filtre de recherche &agrave; appliquer. Un ’*’ correspond &agrave;
z&eacute;ro, un ou plusieurs caract&egrave;res suppl&eacute;mentaires. Un
’#’ correspond uniquement
&agrave; un caract&egrave;re. Tous les
autres caract&egrave;res doivent
correspondre avec les &eacute;l&eacute;ments de la base de donn&eacute;es. Il n’y a pas de
diff&eacute;rence entre les majuscules et les minuscules.
folderName
R&eacute;pertoire de la base de donn&eacute;es o&ugrave; les &eacute;l&eacute;ment seront
lus. L’arborescence des
r&eacute;pertoire est s&eacute;par&eacute;e par
un ’\’. Un argument vide correspond &agrave; l’arborescence la
plus haute.
Exemples
[n,t]=IncaBrowseItemsInFolder(’*’,
’DEFAULT\MyProject’);
[nom,type]=IncaBrowseItemsInFolder(’Prj*_
##’, ’’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 31
4.3.6
Assigner un projet et un jeu de donn&eacute;es &agrave; un dispositif
(INCA-MIP Evolu&eacute;e)
Nom
IncaSetProjectAndDatasetInDevice
Des-
Cette fonction permet d’assigner un projet et un jeu de don-
cription
n&eacute;es &agrave; un dispositif dans un espace de travail pr&eacute;cis. Cela
ne peut pas &ecirc;tre fait si une exp&eacute;rimentation est ouverte.
Syntaxe
IncaSetProjectAndDatasetInDevice(workspace,
dispositif,projet,dataset)
Argu-
none
ments
de sortie
Argu-
workspace
ments
Chemin d’acc&egrave;s de l’espace
de travail
d’entr&eacute;e
dispositif
Nom du dispositif
projet
Chemin d’acc&egrave;s du projet
dataset
Chemin d’acc&egrave;s du jeu de
donn&eacute;e
Exemple- IncaSetProjectAndDatasetInDevice('DEFAULT\workss
pace','ETK:1','DEFAULT\Prj0815','Ds4711\Ds4711_3')
4.3.7
Ouvrir une exp&eacute;rimentation
Nom
IncaOpenExperiment
Description
Cette fonction permet d’ouvrir l’exp&eacute;rimentation sp&eacute;cif&eacute;e. Apr&egrave;s l’ouverture de l’exp&eacute;rimentation, vous pouvez utiliser I’AddOn INCA-MIP pour ajouter les variables
de mesure et de calibration d&eacute;sir&eacute;es.
Syntaxe
IncaOpenExperiment({closeAllViewsFlag})
ou
IncaOpenExperiment(expFolderName, experimentName, workspaceFolderName, workspaceName {, closeAllViewsFlag})
Arguments
none
de sortie
Arguments
d’entr&eacute;e
expFolderName
R&eacute;pertoire dans lequel
l’exp&eacute;rimentation est enregistr&eacute;e
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 32
experimentName
Nom de l’exp&eacute;rimentation
workspaceFolderName
R&eacute;pertoire dans lequel
l’espace de travail est enregistr&eacute;
workspaceName
Nom de l’espace de travail
closeAllViewsFlag
Ferme toutes les fen&ecirc;tres
des variables de mesure et
de calibration dans
l’exp&eacute;rimentation s&eacute;lectionn&eacute;e. Param&egrave;tre possible :
1 : Ferme toute les
fen&ecirc;tres (par d&eacute;faut)
0 : Laisse les fen&ecirc;tres
inchang&eacute;es
Exemples
IncaOpenExperiment(’ExpFolder’,
’MyExperiment’, ’WorkspaceFolder’,
’MyWorkspace’);
Note
Si l’exp&eacute;rimentation est d&eacute;j&agrave; ouverte lors de l’appel &agrave; la fonction IncaOpenExperiment, les arguments d’entr&eacute;e sp&eacute;cifiant l’environnement
sont optionnels.
Si l’exp&eacute;rimentation n’est pas encore ouverte, vous devez utiliser la fonction IncaOpenDatabase avant IncaOpenExperiment.
4.3.8
R&eacute;initialiser une exp&eacute;rimentation
Nom
IncaResetExperiment
Description
R&eacute;initialise et ferme l’exp&eacute;rimentation actuelle. Vous
pouvez utiliser cette fonction pour retirer toutes les
variables d’une exp&eacute;rimentation. Retirer des variables
individuellement n’est actuellement pas possible.
Syntaxe
IncaResetExperiment
Arguments
none
de sortie
Arguments
none
d’entr&eacute;e
Exemples
IncaResetExperiment;
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 33
Note
Si l’exp&eacute;rimentation a &eacute;t&eacute; ouverte manuellement et non une commande
&reg;
MATLAB , IncaResetExperiment lib&egrave;re l’exp&eacute;rimentation sans la fermer. Dans ce cas vous devez utiliser la command IncaOpenExperiment
avant de pouvoir acc&egrave;der de nouveau &agrave; l’exp&eacute;rimentation.
4.3.9
Lire les dispositifs (INCA-MIP Evolu&eacute;e)
Nom
IncaGetDevices
Description
Cette fonction permet de lire tous les dispositifs de
l’exp&eacute;rimentation
Syntaxe
[nom, type] = IncaGetDevices
Arguments
nom
Liste des noms des dispositifs
type
Liste des types des dispositifs:
WorkbaseDevice: Dispositif
de sortie
avec jeu de donn&eacute;es
MeasurementDevice: Dispositif
de mesure
Arguments
none
d’entr&eacute;e
Exemples
4.3.10
[nom,type]=IncaGetDevices;
Lire les propri&eacute;t&eacute;s du dispositif (INCA-MIP Evolu&eacute;e)
Nom
IncaGetDeviceProperties
Description
Cette fonction permet de lire les propri&eacute;t&eacute;s d’un dispositif
Syntaxe
p = IncaGetDeviceProperties(deviceName)
Arguments
p
de sortie
Propri&eacute;t&eacute;s du dispositif
sous la forme d’une struc&reg;
ture MATLAB , avec les
entr&eacute;es suivantes:
p.nom
Nom du disposif
p.descriptionFile
Chemin d’acc&egrave;s du fichier
de description du projet
assign&eacute; au dispositif. Un
texte vide est renvoy&eacute; s’il
n’y a pas de projet assign&eacute; au dispositif.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 34
p.binaryFile
Chemin d’acc&egrave;s du fichier
de donn&eacute;es assign&eacute; au
dispositif. Un texte vide
est renvoy&eacute; s’il n’y a pas
de projet assign&eacute; au dispositif.
p.projectDBPath
Chemin d’acc&egrave;s dans la
base de donn&eacute;es INCA du
projet assign&eacute; au dispositif. Un texte vide est
renvoy&eacute; s’il n’y a pas de
projet assign&eacute; au dispositif.
p.isWriteProtected
0 : Dispositif n’ayant
pas de page m&eacute;moire
ou utilisant une page
non prot&eacute;g&eacute;e en &eacute;criture
1 : Page actuelle prot&eacute;g&eacute;e en &eacute;criture
p.isActive
0 : Dispositif non
connect&eacute; ou inactif
1 : Dispositif connect&eacute;
et actif
p.isWorkbaseDevice
0 : Dispositif sans jeu
de donn&eacute;es
1 : Dispositif avec jeu
de donn&eacute;es
Arguments
deviceName
Nom du dispositif
d’entr&eacute;e
Exemples
4.4
p = IncaGetDeviceProperties(’Device’);
Mesure et Enregistrement
Un signal ou une variable de mesure est toujours extrait/e comme faisant partie
d'une fr&eacute;quence d’&eacute;chantillonnage de ce module de mesure uniquement.
Chaque variable ne peut &ecirc;tre affect&eacute;e qu’&agrave; une fr&eacute;quence d’&eacute;chantillonnage.
Pour configurer une exp&eacute;rimentation, attribuez d'abord les variables de mesure &agrave;
une fr&eacute;quence d’&eacute;chantillonnage s&eacute;par&eacute;e.
Note
Les noms des &eacute;l&eacute;ments, des dispositifs, des signaux et des trames de
mesure sont sensibles &agrave; la casse.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 35
4.4.1
Lire les &eacute;l&eacute;ments de mesure (INCA-MIP Evolu&eacute;e)
Nom
IncaBrowseMeasureElements
Description
Cette fonction permet d’obtenir les &eacute;l&eacute;ments de
mesure d’une exp&eacute;rimentation avec un filtre de
recherche et &eacute;ventuellement d’un dispositif
Syntaxe
[nom, type] = IncaBrowseMeasureElements
(pattern, {deviceName})
[nom] = IncaBrowseMeasureElements(pattern, {deviceName})
Arguments
nom
de sortie
Liste des noms des &eacute;l&eacute;ments de mesure
type
Liste des types des &eacute;l&eacute;ments de mesure:
Scalar: Scalaire
Array: Vecteur
Matrix: Matrice
Arguments
pattern
d’entr&eacute;e
Filtre de recherche &agrave; appliquer sur les &eacute;l&eacute;ments de
mesure. Un ’*’ correspond
&agrave; z&eacute;ro, un ou plusieurs
caract&egrave;res suppl&eacute;mentaires. Un ’#’ correspond uniquement &agrave; un
caract&egrave;re. Tous les autres
caract&egrave;res doivent correspondre avec les &eacute;l&eacute;ments de mesure. Il n’y a
pas de diff&eacute;rence entre les
majuscules et les minuscules.
deviceName
Exemples
Nom du dispositif
[n,t]=IncaBrowseMeasureElements(’ign*’,
’Device’);
[nom,type]=IncaBrowseMeasureElements
(’*’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 36
4.4.2
Lecture des fr&eacute;quences d’&eacute;chantillonnage (INCA-MIP Evolu&eacute;e)
Nom
IncaGetMeasureRatesForDevice
Description
Cette fonction permet d’obtenir toutes les fr&eacute;quences
d’&eacute;chantillonnage d’un dispositif
Syntaxe
[nom] = IncaGetMeasureRatesForDevice(deviceName)
Arguments
nom
de sortie
Arguments
Liste des noms des fr&eacute;quences d’&eacute;chantillonnage
deviceName
Nom du dispositif
d’entr&eacute;e
Exemples
n=IncaGetMeasureRatesForDevice(’Device’);
nom=IncaGetMeasureRatesForDevice(’Dev’);
4.4.3
Ajouter une variable de mesure &agrave; une fr&eacute;quence
d’&eacute;chantillonnage
Nom
IncaAddMeasureElement
Description
Ajoute une variable de mesure &agrave; une exp&eacute;rimentation
avec ou sans raster de mesure donn&eacute;.
Syntaxe
IncaAddMeasureElement(deviceName,
groupName, signalName {, displayMode})
groupName = IncaAddMeasureElement( deviceName, [], signalName{, displayMode})
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
d’entr&eacute;e
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 37
groupName
nom du raster de mesure
Il est possible d'utiliser plusieurs
rasters en combinant tout simplement les noms de raster au
moyen d'un caract&egrave;re &laquo; + &raquo;, p. ex.
’10 ms+100 ms’. L'utilisation d'un
tel raster multiple cr&eacute;e un nouveau
raster virtuel.
Chaque signal peut uniquement
&ecirc;tre mesur&eacute; dans exactement un
raster ou un raster multiple.
Le nom de groupe peut &ecirc;tre [] (voir
remarque ci-dessous).
signalName
Nom du signal de mesure. Pour les
scalaires, le nom est suffisant. Pour
les vecteurs et matrices, l’index au
format [n] ou [n,m] doit &ecirc;tre
accol&eacute; au nom. Le premier &eacute;l&eacute;ment
a l’index &quot;z&eacute;ro&quot;.
displayMode
Mode d’affichage de l’&eacute;l&eacute;ment:
1 : la variable de mesure est affich&eacute;e (par d&eacute;faut)
0 : pas d’affichage
Exemples
IncaAddMeasureElement('MyDevice', '10ms',
'Channel01', 0);
IncaAddMeasureElement('ETK:1', '1.0ms',
'Matrix[2,1]');
group = IncaAddMeasureElement('CalcDev',
[], 'MyCalcSig1');
Note
Si la fr&eacute;quence d’&eacute;chantillonnage est pleine, la variable de mesure n’est
pas ajout&eacute;e &agrave; cette fr&eacute;quence.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 38
Note
Si l'argument d'entr&eacute;e groupName est [] (c’est-&agrave;-dire vide), le groupe de
signaux sera d&eacute;termin&eacute; de la mani&egrave;re suivante :
- Si le signal fait d&eacute;j&agrave; partie de l'exp&eacute;rimentation, c'est son nom de
groupe de signaux existant qui est utilis&eacute;.
- Si le signal ne fait pas partie de l'exp&eacute;rimentation, un groupe de signaux
disponible est utilis&eacute; de mani&egrave;re arbitraire. Dans le cas du dispositif Calcul&eacute; (DispCalc, utilis&eacute; pour les signaux calcul&eacute;s) ou de CAN Monitoring,
c'est le groupe de signaux d&eacute;fini pour ce signal qui est utilis&eacute;.
Comme le nom du groupe de signaux est requis pour IncaGetRecords,
IncaGetRecordStruct ou IncaGetRecordCount, il est retourn&eacute; en
tant que param&egrave;tre de gauche en option.
Exemples :
groupName = IncaAddMeasureElement( 'DispCalc', [],
'MonSigCalc')
groupName = IncaAddMeasureElement( 'CAN-Monitoring:1',
[], 'nmot', 1)
Note
Le nombre total de signaux qui peuvent &ecirc;tre ajout&eacute;s est sp&eacute;cifique &agrave;
l'appareil ainsi qu'au protocole. Le nombre de signaux est limit&eacute; par la
quantit&eacute; de m&eacute;moire tampon libre allou&eacute;e par le processus du serveur
cible. La taille totale de la m&eacute;moire tampon d&eacute;pend de la fr&eacute;quence
d'&eacute;chantillonnage utilis&eacute;e.
Exemple :
Un signal avec une fr&eacute;quence d'&eacute;chantillonnage de 0,1 ms n&eacute;cessite &gt; 3
Mo de donn&eacute;es. Par cons&eacute;quent, le nombre total de signaux qui peuvent
&ecirc;tre ajout&eacute;s se situe entre 400 et 600 signaux. Des fr&eacute;quences
d'&eacute;chantillonnage plus lentes permettent d'ajouter plus de signaux.
4.4.4
D&eacute;marrer la mesure
Nom
IncaStartMeasurement
Description
D&eacute;marre la mesure sous INCA
Syntaxe
IncaStartMeasurement
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 39
Arguments
none
de sortie
Arguments
none
d’entr&eacute;e
Exemples
4.4.5
IncaStartMeasurement;
Arr&ecirc;ter la mesure
Nom
IncaStopMeasurement
Description
Cette fonction arr&ecirc;te la mesure en court et
l’enregistrement (s’il y a lieu) sous INCA
Syntaxe
IncaStopMeasurement{(mdfFileName)}
Arguments
none
de sortie
Arguments
mdfFileName
d’entr&eacute;e
Nom du fichier MDF dans lequel les
donn&eacute;es enregistr&eacute;es sont sauvegard&eacute;es si l'enregistrement
s'arr&ecirc;te en m&ecirc;me temps que la
mesure en cours. Il faut toujours
sp&eacute;cifier en entier le chemin
d'acc&egrave;s au fichier (ex.’c:\mydata\store1.dat’).
Exemples
IncaStopMeasurement
(’c:\mydata\store1.dat’)
Note
Pour &eacute;viter de perdre des donn&eacute;es du fait des mesures en cours, il faut
s'assurer d'arr&ecirc;ter l'enregistrement en cours avec la commande IncaStopMeasurement(mdfFileName) si le volume de donn&eacute;es est &eacute;lev&eacute;.
Ensuite il faut utiliser la commande IncaGetRecords pour transf&eacute;rer &agrave;
&reg;
MATLAB les donn&eacute;es restantes.
4.4.6
Lire les propri&eacute;t&eacute;s de l’enregistrement (INCA-MIP Evolu&eacute;e)
Nom
IncaGetRecordingProperties
Description
Lit les propri&eacute;t&eacute;s du fichier de sortie primaire de
l'enregistreur par d&eacute;faut ainsi que l'extension de fichier
pour le format d'enregistrement primaire s&eacute;lectionn&eacute;.
Syntaxe
properties = IncaGetRecordingProperties
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 40
Arguments
properties
de sortie
Propri&eacute;t&eacute;s de
l’enregistrement sous
la forme d’une struc&reg;
ture MATLAB , avec les
entr&eacute;es suivantes:
properties.fileName
Le nom du fichier
d'enregistrement y
compris le format du
fichier de sortie primaire
properties.directory
R&eacute;pertoire du fichier
d’enregistrement
properties.fileFormat
Format du fichier
d’enregistrement; les
informations textes suivantes sont possibles:
ETASBinary
#DiademATF
ETASAscii
ETASGroupAscii
ETASMATLABMFILE
ETASGroupMatlabM
FamosRecord
ETASMDF
ETASMDF4
pro-
Incr&eacute;ment auto-
perties.autoIncrement
matique du nom du
fichier
d’enregistrement
0 : Pas
d’incr&eacute;mentation
automatique
1 : Incr&eacute;mentation
automatique
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 41
Commentaire de
properties.comment
l’ent&ecirc;te du fichier
d’enregistrement. Il ne
doit pas exc&eacute;d&eacute; 1024
caract&egrave;res moins les
caract&egrave;re utilis&eacute;s pour
les commentaire par
d&eacute;fauts.
pro-
Commentaire par
perties.defaultComment
d&eacute;faut g&eacute;n&eacute;r&eacute; par
INCA de l’ent&ecirc;te du
fichier
d’enregistrement
properties.company
Nom de la soci&eacute;t&eacute; dans
l’ent&ecirc;te du fichier
d’enregistrement
properties.project
Nom du projet dans
l’ent&ecirc;te du fichier
d’enregistrement
properties.user
Nom de l’utilisateur
dans l’ent&ecirc;te du fichier
d’enregistrement
properties.vehicle
Nom du v&eacute;hicule dans
l’ent&ecirc;te du fichier
d’enregistrement
Arguments
none
d’entr&eacute;e
Exemples
4.4.7
properties = IncaGetRecordingProperties;
R&eacute;gler les propri&eacute;t&eacute;s de l’enregistrement (INCA-MIP Evolu&eacute;e)
Nom
IncaSetRecordingProperties
Description
Cette fonction permet de r&eacute;gler les propri&eacute;t&eacute;s du prochain enregistrement
Syntaxe
IncaSetRecordingProperties(properties)
Arguments
none
de sortie
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 42
Arguments
properties
d’entr&eacute;e
Propri&eacute;t&eacute;s de
l’enregistrement sous
la forme d’une structure MATLAB, avec les
entr&eacute;es suivantes:
properties.fileName
Nom du fichier
d’enregistrement
properties.directory
R&eacute;pertoire du fichier
d’enregistrement
properties.fileFormat
Format du fichier
d’enregistrement; les
informations textes suivantes sont possibles:
ETASBinary
#DiademATF
ETASAscii
ETASGroupAscii
ETASMATLABMFILE
ETASGroupMatlabM
FamosRecord
ETASMDF
ETASMDF4
pro-
Incr&eacute;ment automatique
perties.autoIncrement
du nom du fichier
d’enregistrement
0 : Pas
d’incr&eacute;mentation
automatique
1 : Incr&eacute;mentation
automatique
properties.comment
Il ne doit pas exc&eacute;d&eacute;
1024 caract&egrave;res moins
les caract&egrave;re utilis&eacute;s
pour les commentaire
par d&eacute;fauts.
properties.company
Commentaire par
d&eacute;faut g&eacute;n&eacute;r&eacute; par INCA
de l’ent&ecirc;te du fichier
d’enregistrement
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 43
Nom du projet dans
properties.project
l’ent&ecirc;te du fichier
d’enregistrement
Nom de l’utilisateur
properties.user
dans l’ent&ecirc;te du fichier
d’enregistrement
Nom du v&eacute;hicule dans
properties.vehicle
l’ent&ecirc;te du fichier
d’enregistrement
Exemples
properties.user = ’Michael’;
properties.project = ’K70’;
IncaSetRecordingProperties(properties);
Note
Lorsque vous d&eacute;finissez l'enregistrement avec IncaSetRecordingProperties, vous ne devez pas terminer un enregistrement
avec IncaStopRecording. Au lieu de cela, il est possible d’utiliser
IncaSetTrigger. Vous pouvez utiliser aucune condition de trigger
pour finir l’enregistrement.
Exemple:
Finir l’enregistrement apr&egrave;s une dur&eacute;e fixe:
TIMEDURATION_SECONDS = 25 ;
IncaSetTrigger('none', 'none', 'none', 'none',
TIMEDURATION_SECONDS) ;
IncaStartRecording ;
% L'enregistrement s'arr&ecirc;te automatiquement apr&egrave;s
TIMEDURATION_SECONDS secondes
Finir l’enregistrement apr&egrave;s un trigger manuel:
IncaSetTrigger('none', 'manual');
IncaStartRecording;
% Do anything until the stop trigger condition is met
...
IncaExecuteManualTrigger('stop');
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 44
4.4.8
Mode Lecture Enregistrement (INCA-MIP Evolu&eacute;e)
Nom
IncaGetRecordingMode
Description
Indique si un signal est enregistr&eacute; ou non dans
l'enregistreur par d&eacute;faut.
Syntaxe
IncaGetRecordingMode(deviceName,
signalName)
Arguments
mode d'enregistrement
de sortie
pour l'enregistreur par
d&eacute;faut :
0 : le signal n'est pas
enregistr&eacute; dans
l'enregistreur par d&eacute;faut
1 : le signal est enregistr&eacute; dans l'enregistreur
par d&eacute;faut
Arguments
deviceName
Nom du dispositif
signalName
Nom du signal de mesure.
d’entr&eacute;e
Pour les scalaires, le nom
est suffisant. Pour les vecteurs et matrices, l’index au
format [n] ou [n,m] doit
&ecirc;tre accol&eacute; au nom. Le premier &eacute;l&eacute;ment a l’index
&quot;z&eacute;ro&quot;.
Exemples
m = IncaGetRecordingMode('ETK:1', 'hfm');
mode = IncaGetRecordingMode('CalcDev',
'MyCalcSig1');
Note
Avant d'utiliser IncaSetRecordingMode, le signal doit &ecirc;tre ajout&eacute; avec
IncaAddMeasureElement.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 45
4.4.9
Set Recording Mode (INCA-MIP Evolu&eacute;e)
Nom
IncaSetRecordingMode
Description
Active ou d&eacute;sactive l'enregistrement d'un signal dans
l'enregistreur par d&eacute;faut. L'enregistrement peut uniquement &ecirc;tre d&eacute;sactiv&eacute; pour des signaux qui sont affich&eacute;s dans l'exp&eacute;rimentation INCA.
Avant d'ex&eacute;cuter cette commande, le signal doit &ecirc;tre
ajout&eacute; &agrave; l'exp&eacute;rimentation avec IncaAddMeasureSignal.
Syntaxe
IncaSetRecordingMode(deviceName,
signalName, recordingMode)
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
signalName
Nom du signal de mesure.
d’entr&eacute;e
Pour les scalaires, le nom
est suffisant. Pour les vecteurs et matrices, l’index au
format [n] ou [n,m] doit
&ecirc;tre accol&eacute; au nom. Le premier &eacute;l&eacute;ment a l’index
&quot;z&eacute;ro&quot;.
recordingMode
mode d'enregistrement
pour l'enregistreur par
d&eacute;faut :
0 : la variable de mesure
est supprim&eacute;e dans
l'enregistreur par d&eacute;faut
1 : le signal de mesure
est ajout&eacute; &agrave;
l'enregistreur par d&eacute;faut
Exemples
IncaSetRecordingMode(’ETK:1’, ’hfm’, 1);
IncaSetRecordingMode('DispCalc',
'MonSigCalc1', 0);
Note
Avant d'utiliser IncaSetRecordingMode, le signal doit &ecirc;tre ajout&eacute; avec
IncaAddMeasureElement.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 46
4.4.10
D&eacute;marre l’enregistrement
Nom
IncaStartRecording
Description
Cette fonction permet de d&eacute;marrer l'enregistrement
dans INCA. Cette fonction peut &ecirc;tre utiliser apr&egrave;s ou &agrave;
la place de la fonction IncaStartMeasurement.
Une fois une mesure ou un enregistrement lanc&eacute;/e, les
donn&eacute;es mesur&eacute;es sont &eacute;galement disponibles dans
&reg;
MATLAB .
Syntaxe
IncaStartRecording
Arguments
none
de sortie
Arguments
none
d’entr&eacute;e
Exemples
4.4.11
IncaStartRecording;
Arr&ecirc;ter un enregistrement
Nom
IncaStopRecording
Description
Cette fonction permet d'arr&ecirc;ter l'enregistrement en
cours dans INCA. La mesure continue et doit &ecirc;tre arr&ecirc;t&eacute;e au moyen de la fonction IncaStopMeasurement.
Il est possible d'activer/d&eacute;sactiver cette fonction plusieurs fois au cours de la mesure.
Syntaxe
IncaStopRecording(mdfFileName)
Arguments
none
de sortie
Arguments
d’entr&eacute;e
mdfFileName
Nom du fichier MDF o&ugrave; les donn&eacute;es
sont enregistr&eacute;es. Il faut toujours
sp&eacute;cifier le chemin d'acc&egrave;s entier
du fichier. (ex.
’c:\mydata\store1.dat’).
Exemples
IncaStopRecording
(’c:\mydata\store1.dat’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 47
4.4.12
R&eacute;gler le mode de lecture des donn&eacute;es (Donn&eacute;es Online /
Offline)
Nom
IncaSetMeasureReadMode
Description
Cette fonction API permet de d&eacute;finir la source &agrave; partir
de laquelle les donn&eacute;es mesur&eacute;es sont transmises &agrave;
&reg;
MATLAB . Les donn&eacute;es sont, soit pr&eacute;par&eacute;es dans INCA
&reg;
puis transf&eacute;r&eacute;es &agrave; MATLAB (donn&eacute;es offline), soit
sont lues &agrave; partir du buffer circulaire (donn&eacute;es online).
Pour certains modules, tels que la carte ES1303 et les
modules de s&eacute;rie ES6xx, aucune donn&eacute;e offline n'est
disponible pendant l'affichage des donn&eacute;es mesur&eacute;es.
Il est donc recommand&eacute; d'utiliser les donn&eacute;es online
pendant l'affichage.
Lors de l'enregistrement des donn&eacute;es mesur&eacute;es, les
donn&eacute;es online ou offline sont utilisables. Les donn&eacute;es
online peuvent &ecirc;tre incompl&egrave;tes au moment des chargements importants, alors que les donn&eacute;es offline
sont toujours compl&egrave;tes lorsque les donn&eacute;es mesur&eacute;es sont enregistr&eacute;es. Cependant, les donn&eacute;es offline
peuvent &ecirc;tre transmises avec un certain d&eacute;lai lors
d'importants chargements. Il est recommand&eacute; d'utiliser
uniquement les donn&eacute;es offline lors de
l'enregistrement des donn&eacute;es mesur&eacute;es.
Syntaxe
IncaSetMeasureReadMode(measureReadMode)
Arguments
none
de sortie
Arguments
d’entr&eacute;e
measureReadMode
Param&egrave;tre num&eacute;rique dont la
valeur sp&eacute;cifie la source de
donn&eacute;es. Param&egrave;tres possibles :
1 : Donn&eacute;es offline
0 : Donn&eacute;es online (par
d&eacute;faut)
Exemples
IncaSetMeasureReadMode(0);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 48
4.4.13
Lecture des donn&eacute;es de mesure
Nom
IncaGetRecords
Description
Transf&egrave;re les donn&eacute;es de mesure vers MATLAB . Les
&reg;
donn&eacute;es de mesure de chaque groupe de signaux sont
archiv&eacute;es dans un buffer circulaire d&eacute;di&eacute; pouvant
contenir jusqu'&agrave; 30 secondes de temps de mesure. Les
donn&eacute;es de mesure sont r&eacute;cup&eacute;r&eacute;es par groupes dans
&reg;
MATLAB . Il faudrait donc arr&ecirc;ter l'ex&eacute;cution de votre
&reg;
script dans MATLAB apr&egrave;s avoir r&eacute;cup&eacute;r&eacute; les donn&eacute;es
de mesure. Plus la quantit&eacute; de donn&eacute;es transf&eacute;r&eacute;es
est important &agrave; chaque fois, plus le transfert de donn&eacute;es est efficace.
Cette fonction transmet un nombre sp&eacute;cifi&eacute;
d'enregistrements pour le raster de mesure sp&eacute;cifi&eacute;.
Pour de plus amples informations sur le buffer circulaire, consultez l'entr&eacute;e correspondante dans le
&quot;INCA D&eacute;finitions&quot; &agrave; la page 10.
Syntaxe
[time, data {,state}] = IncaGetRecords
(deviceName, groupName, maxRecords {{,latest{, exact}})
Arguments
time
de sortie
Un vecteur contenant les tampons
d'horodatage des enregistrements
transf&eacute;r&eacute;s. Cette variable contient
un nombre maximal de valeurs m, tandis que m &lt;= maxRecords.
data
Une matrice bidimensionnelle contenant les valeurs de donn&eacute;es pour
chaque variable de mesure dans
l'ordre o&ugrave; elle a &eacute;t&eacute; ajout&eacute;e &agrave;
l'exp&eacute;rimentation par IncaAddMeasureElement. Dans cette matrice,
la dimension m refl&egrave;te le nombre
d'enregistrements transf&eacute;r&eacute;s, tandis que n indique le nombre de raster de mesure.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 49
state
Param&egrave;tre en retour optionnel :
0 : succ&egrave;s. Enregistrements
re&ccedil;us
1: acquisition non op&eacute;rationnelle.
Aucun enregistrement re&ccedil;u
2: enregistrements insuffisants.
Aucun enregistrement re&ccedil;u. Ne
peut &ecirc;tre retourn&eacute; que si exact =
1
Arguments
deviceName
Nom du dispositif
groupName
Nom du raster de mesure
d’entr&eacute;e
Il est possible d'utiliser plusieurs rasters en combinant tout simplement
les noms de raster au moyen d'un
caract&egrave;re &laquo; + &raquo;, p. ex. ’10 ms+100
ms’. L'utilisation d'un tel raster multiple cr&eacute;e un nouveau raster virtuel.
Chaque signal peut uniquement &ecirc;tre
mesur&eacute; dans exactement un raster
ou un raster multiple.
maxRecords
Nombre maximal d'enregistrements
&agrave; transf&eacute;rer. Voir aussi le param&egrave;tre
exact. Ce nombre correspond &agrave; la
dimension m pour la variable de
temps ou de donn&eacute;es dans les
valeurs retourn&eacute;es. Si la dimension
dans les valeurs retourn&eacute;es atteint
la valeur maxRecords, les enregistrements ne seront pas tous lus
et un d&eacute;passement du buffer circulaire peut survenir.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 50
latest
D&eacute;finit si les enregistrements les
plus anciens ou les plus r&eacute;cents
seront re&ccedil;us
exact
D&eacute;finit de recevoir des enregistrements m&ecirc;me si n &lt; maxRecords sont pr&eacute;sents dans le buffer
circulaire ou d&eacute;finit si le buffer circulaire doit rester inchang&eacute;.
Exemples
[t, d] = IncaGetRecords('ETK:1', '100ms',
500);
data = [data; d];
time = [time; t];
[t, d, s] = IncaGetRecords('ETK:1',
'100ms', 25, 1, 1);
Pour un contexte plus large utilisant cette partie de
code, reportez-vous &agrave; &quot;Exemple 2&quot; &agrave; la page 72.
Note
La raster utilis&eacute;e dans IncaGetRecords correspond directement &agrave; la
raster utilis&eacute;e dans IncaAddMeasureElement, &agrave; savoir vous devez utiliser la m&ecirc;me raster ou une raster multiple.
Exemple:
IncaAddMeasureElement('ETK test device:1','RASTER_
A+RASTER_B', 'N')
IncaAddMeasureElement('ETK test device:1','RASTER_
A+RASTER_B', 'n')
[t,d]= IncaGetRecords('ETK test device:1','RASTER_
A+RASTER_B',15)
Pour contr&ocirc;ler les affectations de raster de signaux, vous pouvez utiliser
la commande IncaGetRecordStruct.
Exemple:
l=IncaGetRecordStruct('ETK test device:1', 'RASTER_
A+RASTER_B')
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 51
Note
Les combinaisons de param&egrave;tres suivantes s'ex&eacute;cutent comme suit :
latest = 0, exact = 0: (par d&eacute;faut)
Retourne les enregistrements les plus anciens jusqu'&agrave; maxRecords
depuis le buffer circulaire. Les enregistrements plus r&eacute;cents restent
inchang&eacute;s.
latest = 1, exact = 0:
Retourne les enregistrements les plus r&eacute;cents jusqu'&agrave; maxRecords
depuis le buffer circulaire. Tous les enregistrements plus anciens sont
d&eacute;lib&eacute;r&eacute;ment rejet&eacute;s.
latest = 0, exact = 1:
Retourne les maxRecords plus anciens enregistrements depuis le buffer circulaire. Les enregistrements plus r&eacute;cents restent inchang&eacute;s. Si
seulement n &lt; maxRecords enregistrements sont disponibles dans le
buffer circulaire, rien n'est re&ccedil;u.
latest = 1, exact = 1:
Retourne les maxRecords plus r&eacute;cents enregistrements depuis le buffer circulaire. Tous les enregistrements plus anciens sont d&eacute;lib&eacute;r&eacute;ment rejet&eacute;s. Si seulement n &lt; maxRecords enregistrements
sont disponibles dans le buffer circulaire, rien n'est re&ccedil;u.
4.4.14
R&eacute;initialiser les buffers tournant
Nom
IncaResetRecords
Description
Cette fonction reinitialise le buffer circulaire de toutes
les fr&eacute;quences d’&eacute;chantillonnage. Elle est utilisable
m&ecirc;me en cours de mesure pour r&eacute;initialiser tous les
buffers tournant. Les buffers tournant sont r&eacute;initialis&eacute;s
automatiquement lors du lancement de la mesure ou
de l'enregistrement. Il n'est donc pas n&eacute;cessaire de
sp&eacute;cifier explicitement l'ex&eacute;cution de cette commande.
Pour de plus amples informations sur le buffer circulaire, consultez l'entr&eacute;e correspondante dans le
&quot;INCA D&eacute;finitions&quot; &agrave; la page 10.
Syntaxe
IncaResetRecords
Arguments
none
de sortie
Arguments
none
d’entr&eacute;e
Exemples
IncaResetRecords;
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 52
4.4.15
Lecture de l’&eacute;tat du mat&eacute;riel (INCA-MIP Evolu&eacute;e)
Nom
IncaGetHardwareStatus
Description
Cette fonction permet de conna&icirc;tre l’&eacute;tat du mat&eacute;riel
pendant une mesure ou un enregistrement
Syntaxe
[status, message] = IncaGetHardwareStatus
Arguments
status
de sortie
Etat actuel du mat&eacute;riel
0 : OK
1 : Warning
2 : Erreur
message
Si status renvoit la valeur 1 ou 2, la
valeur message renvoit un texte
d&eacute;crivant le warning ou l’erreur.
Si status renvoit la valeur 1 ou 2, la
mesure ou l’enregsitrement doivent
&ecirc;tre arr&ecirc;ter avant un autre appel de
la fonction IncaGetHardwareStatus.
Voir aussi le script exemple dans le
fichier tHWStatus.m au &quot;Conna&icirc;tre
l’AddOn INCA-MIP gr&acirc;ce &agrave; des
exemples:&quot; &agrave; la page 19
Arguments
none
d’entr&eacute;e
Exemples
4.4.16
[s, m] = IncaGetHardwareStatus;
D&eacute;finir les triggers (INCA-MIP Evolu&eacute;e)
Nom
IncaSetTrigger
Description
Cette fonction permet de d&eacute;finir la condition de trigger
avec le d&eacute;marrage d’une mesure ou d’un enregistrement avec les fonctions IncaStartMeasurement ou IncaStartRecording
Syntaxe
IncaSetTrigger(startTrigger{, stopTrigger
{, preTriggerTime{, postTriggerTime{,
duration}}}})
Arguments
none
de sortie
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 53
Arguments
startTrigger
d’entr&eacute;e
Trigger de d&eacute;but.
manual pour un trigger
manuel
none s’il n’y a pas de trigger
stopTrigger
Trigger de fin.
manual pour un trigger
manuel
none s’il n’y a pas de trigger (par d&eacute;faut)
preTriggerTime
Dur&eacute;e de pr&eacute;-trigger en
seconde
none si non sp&eacute;cifi&eacute; (par
d&eacute;faut)
postTriggerTime
Dur&eacute;e de post-trigger en
seconde
none si non sp&eacute;cifi&eacute; (par
d&eacute;faut)
duration
Dur&eacute;e de l’enregistrement de
la mesure ou de
l’enregistrement en seconde
none si non sp&eacute;cifi&eacute; (par
d&eacute;faut)
dans ce cas, la dur&eacute;e est
infinie.
Exemples
IncaSetTrigger('nmot\ETK:1 &gt; 2000',
'none', 2.0, 3.0)
IncaSetTrigger('none', 'none', 'none',
'none', 360)
Le tableau suivant &eacute;num&egrave;re toutes les combinaisons de param&egrave;tres d'entr&eacute;e qui
sont prises en charge (les autres combinaisons entra&icirc;nent une exception).
INCA-MIP V7.5 | Guide de l'utilisateur
INCA-MIP V7.5 | Guide de l'utilisateur
Combinaisons de param&egrave;tres d'entr&eacute;e
Fonctionnalit&eacute; trigger
startTrigger stopTrigger
preTriggerTime
postTriggerTime
dur&eacute;e
Enregistrement avec dur&eacute;e de temps
'none'
'none'
'none'
'none'
value
Enregistrement avec trigger de d&eacute;part manuel,
'manual'
'manual'
value
'none'
'none'
'manual'
'none'
value
value
'none'
'manual'
value
value
'none'
'none'
'none'
'manual'
'none'
'none'
'none'
value
'none'
'none'
'none'
value
value
'manual'
'none'
'none'
'none'
temps de pr&eacute;-trigger et condition de trigger d'arr&ecirc;t
manuel
Enregistrement avec trigger de d&eacute;part manuel,
temps de pr&eacute;- et post-trigger
Enregistrement avec trigger de d&eacute;part manuel,
temps de pr&eacute;-trigger et condition de trigger d'arr&ecirc;t
Enregistrement avec condition de trigger d'arr&ecirc;t
manuel
Enregistrement avec condition de trigger de
d&eacute;part et dur&eacute;e d'enregistrement
Enregistrement avec condition de trigger de
d&eacute;part et trigger d'arr&ecirc;t manuel
4 Fonctions API | 54
INCA-MIP V7.5 | Guide de l'utilisateur
Fonctionnalit&eacute; trigger
startTrigger stopTrigger
preTriggerTime
postTriggerTime
dur&eacute;e
Enregistrement avec condition de trigger de
value
'manual'
value
'none'
'none'
value
'none'
value
value
'none'
value
value
value
'none'
'none'
d&eacute;part, temps de pr&eacute;-trigger et trigger d'arr&ecirc;t
manuel
Enregistrement avec condition de trigger de
d&eacute;part, temps de pr&eacute;- et post-trigger
Enregistrement avec condition de trigger de
d&eacute;part, temps de pr&eacute;-trigger et condition de trigger d'arr&ecirc;t
4 Fonctions API | 55
4 Fonctions API | 56
4.4.17
Execution du trigger manuel (INCA-MIP Evolu&eacute;e)
Nom
IncaExecuteManualTrigger
Description
Cette commande permet de d&eacute;clencher le trigger
manuel de d&eacute;but ou de fin. Cette fonction n’a d’effet
que si la commande IncaSetTrigger a &eacute;t&eacute; utiliser
avant avec les param&egrave;tres startTrigger ou stopTrigger r&egrave;gler sur manual (manuel).
Syntaxe
IncaExecuteManualTrigger(type)
Arguments
none
de sortie
Arguments
type
d’entr&eacute;e
Type de trigger
start pour d&eacute;clencher le trigger manuel de d&eacute;but
stop pour d&eacute;clencher le trigger
manuel de fin
Exemples
4.4.18
IncaExecuteManualTrigger('start')
Lire l’&eacute;tat d’un enregistrement (INCA-MIP Evolu&eacute;e)
Nom
IncaGetRecordingState
Description
Cette fonction permet d’obtenir l’&eacute;tat de
l’enregistrement en cours.
Syntaxe
result = IncaGetRecordingState
Arguments
result
de sortie
Etats de l’enregistrement
0 : non actif
1 : en attente de trigger ou enregistrement en cours
Arguments
none
d’entr&eacute;e
Exemples
s = IncaGetRecordingState
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 57
4.4.19
Lire la liste des variables de mesure (INCA-MIP Evolu&eacute;e)
Nom
IncaGetRecordStruct
Description
Cette fonction permet de conna&icirc;tre la liste des
variables de mesure de la mesure ou de
l’enregistrement. La liste renvoy&eacute;e contient les noms
des variables de mesure dans le m&ecirc;me ordre o&ugrave; elles
ont &eacute;t&eacute; appel&eacute;es par la commande IncaAddMeasureElement.
Syntaxe
list = IncaGetRecordStruct(device,groupName)
Arguments
none
de sortie
Arguments
device
Nom du dispositif
groupName
Nom de la fr&eacute;quence
d’entr&eacute;e
d’&eacute;chantillonnage
Il est possible d'utiliser plusieurs rasters en combinant tout simplement
les noms de raster au moyen d'un
caract&egrave;re &laquo; + &raquo;, p. ex. ’10 ms+100
ms’.
Exemples
l = IncaGetRecordStruct('ETK:1', '10ms');
list = IncaGetRecordStruct('device1',
'Syncro');
4.5
Calibration
La calibration peut se faire sur des scalaires, courbes et cartographies, notamment des distributions de points d'interruption. Dans chaque exp&eacute;rimentation, il
est possible de d&eacute;finir autant de variables de calibration qu'on le souhaite.
Note
Notez que le nom des variables de calibration est sensible &agrave; la casse.
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 58
4.5.1
Lire les &eacute;l&eacute;ments de calibration (INCA-MIP Evolu&eacute;e)
Nom
IncaBrowseCalibrationElements
Description
Cette fonction permet d’obtenir les &eacute;l&eacute;ments de calibration de l’exp&eacute;rimentation avec un filtre de recherche
et &eacute;ventuellement d’un dispositif.
Syntaxe
[nom, type] = IncaBrowseCalibrationElements (pattern, {deviceName})
nom = IncaBrowseCalibrationElements (pattern, {deviceName})
Arguments
nom
de sortie
Liste des noms des &eacute;l&eacute;ments de calibration.
type
Liste de types de calibration:
Distribution: Axie
de distribution
OneDTable: Courbe
TwoDTable: Cartographie
Scalar: Scalaire
Array: Vecteur
Matrix: Matrice
Arguments
pattern
d’entr&eacute;e
Filtre de recherche &agrave; appliquer sur les &eacute;l&eacute;ments de
mesure. Un ’*’ correspond
&agrave; z&eacute;ro, un ou plusieurs
caract&egrave;res suppl&eacute;mentaires. Un ’#’ correspond uniquement &agrave; un
caract&egrave;re. Tous les autres
caract&egrave;res doivent correspondre avec les &eacute;l&eacute;ments de mesure. Il n’y a
pas de diff&eacute;rence entre
les majuscules et les
minuscules.
deviceName
Exemples
Nom du dispositif
[n,t]=IncaBrowseCalibrationElements
(’MAP*’, ’Device’);
[nom,type]=IncaBrowseCalibrationElements
(’*’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 59
4.5.2
Ajouter un &eacute;l&eacute;ment de calibration
Nom
IncaAddCalibrationElement
Description
Ajoute une variable de calibration &agrave; l'exp&eacute;rimentation
en cours. Les calibrations peuvent &ecirc;tre effectu&eacute;es
avec des scalaires, des courbes caract&eacute;ristiques et
des cartes englobant les distributions de points d'axe
associ&eacute;es. Dans chaque exp&eacute;rimentation, il est possible de d&eacute;finir un nombre quelconque de variables de
calibration. Cette commande prend &eacute;galement en
charge les distributions de points d'axe et les distributions de points d'axe group&eacute;s.
Syntaxe
IncaAddCalibrationElement(deviceName,
calibrationName {, displayMode})
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
calibrationName
Nom de la calibration
displayMode
Mode d’affichage de
d’entr&eacute;e
l’&eacute;l&eacute;ment:
2 : La variable de calibration est affich&eacute;e et
constamment rafra&icirc;chie
(par d&eacute;faut)
1 : La variable de calibration est affich&eacute;e mais
non rafraichie
0 : La variable de calibration n’est pas affich&eacute;e
S&eacute;lectionner 1 (affichage uniquement) peut am&eacute;liorer
consid&eacute;rablement la performance pour de grosse
quantit&eacute; de donn&eacute;es.
Exemples
IncaAddCalibrationElement(’anEtk’,
’Scalar’);
IncaAddCalibrationElement(’anEtk’,
’Curve’);
IncaAddCalibrationElement(’anEtk’,
’Map’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 60
Note
Pour les axes group&eacute;s, aucune interpolation des courbes et des cartes
d&eacute;pendantes n'est ex&eacute;cut&eacute;e.
4.5.3
Lire la valeur de calibration
Nom
IncaGetCalibrationValue
Description
Cette fonction permet de lire la valeur actuelle de la
variable de calibration ou des distributions de points
d'interruption
Syntaxe
value = IncaGetCalibrationValue(deviceName, calibrationName {, start, size}
{, valueType})
Arguments
value
de sortie
La valeur actuelle de la calibration; elle doit correspondre
aux types de donn&eacute;es indiqu&eacute;s ci-dessous:
Scalaires: une matrice (1,1)
Courbes: une matrice (x,1)
Cartographies: une matrice
(x,y)
Distributions de points
d'interruption:
une matrice (x,1)
Arguments
deviceName
Nom du dispositif
calibrationName
Nom d’&eacute;l&eacute;ment de calibration
start
Index de d&eacute;part. Types de don-
d’entr&eacute;e
n&eacute;es support&eacute;es:
Pour les courbes et distributions de points
d'interruption un index de
d&eacute;part x doit &ecirc;tre sp&eacute;cifi&eacute;.
x &gt;= 1
Pour les cartographies, un
index de d&eacute;part [x,y] doit
&ecirc;tre sp&eacute;cifi&eacute;.
x,y &gt;= 1
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 61
size
Nombre de valeur &agrave; lire. Types
de donn&eacute;es support&eacute;es:
Pour les courbes et les distributions de points de rupture, un nombre n doit &ecirc;tre
sp&eacute;cifi&eacute;.
n &gt;= 1
Pour les cartograpies, un
nombre [n,m] doit &ecirc;tre
sp&eacute;cifi&eacute;.
n,m &gt;= 1
valueType
S&eacute;lection de l’argument de
sortie (texte). La fonction renvoie soit la valeur de la
variable de calibration (mode
par d&eacute;faut), soit la distribution
du point d’appui en X ou Y.
Param&egrave;tres possibles :
v: la valeur
x: renvoie le point d’appui
en X (courbes et cartographies)
y: renvoie le point d’appui
en Y (cartographies)
Exemples
aValue = IncaGetCalibrationValue(’anEtk’,
’Scalar’);
aCurve = IncaGetCalibrationValue(’anEtk’,
’Curve’);
aMap = IncaGetCalibrationValue(’anEtk’,
’Map’);
xMap = IncaGetCalibrationValue(’anEtk’,
’Map’, ’x’);
yMap = IncaGetCalibrationValue(’anEtk’,
’Map’, ’y’);
aCurveRange = IncaGetCalibrationValue
(’anEtk’, ’Curve’, 2, 3);
aMapRange = IncaGetCalibrationValue
(’anEtk’, ’Map’, [2,3], [3,4]);
xMapRange = IncaGetCalibrationValue
(’anEtk’, ’Map’, 2, 3, ’x’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 62
4.5.4
Modifier une valeur de calibration
Nom
IncaSetCalibrationValue
Description
Cette fonction permet d'attibuer une valeur &agrave; une
variable de calibration ou &agrave; un point d'interruption
(d’appui).
Syntaxe
IncaSetCalibrationValue( deviceName, calibrationName, value )
IncaSetCalibrationValue( deviceName, calibrationName, value, valueType )
IncaSetCalibrationValue( deviceName, calibrationName, value, start )
IncaSetCalibrationValue( deviceName, calibrationName, value, start, valueType )
result = IncaSetCalibrationValue( deviceName, calibrationName, value )
result = IncaSetCalibrationValue( deviceName, calibrationName, value, valueType
)
result = IncaSetCalibrationValue( deviceName, calibrationName, value, start )
result = IncaSetCalibrationValue( deviceName, calibrationName, value, start,
valueType )
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 63
Arguments
de sortie
result
R&eacute;sultat de la calibration
(facultatif, uniquement en cas
de d&eacute;faillances)
Si aucun bit de r&eacute;sultat n'est
pos&eacute;, c'est que la valeur de
calibration a &eacute;t&eacute; modifi&eacute;e
avec succ&egrave;s. C'est &eacute;galement
le cas si l'un des bits 5 &agrave; 8 est
pos&eacute;, ce qui fournit des informations suppl&eacute;mentaires.
Si toutefois, l'un des bits 0 &agrave; 4
est pos&eacute;, c'est que la calibration a &eacute;chou&eacute;.
Bit 0 actif: Calibration non
faite
Bit 1 actif: Limite logicielle
basse d&eacute;pass&eacute;e
Bit 2 actif: Limite logicielle
haute d&eacute;pass&eacute;e
Bit 3 actif: Limite mat&eacute;rielle
basse d&eacute;pass&eacute;e
Bit 4 actif: Limite mat&eacute;rielle
haute d&eacute;pass&eacute;e
Bit 5 actif: Valeur satur&eacute;e &agrave;
la limite logicelle basse
Bit 6 actif: Valeur satur&eacute;e &agrave;
la limite logicelle haute
Bit 7 actif: Valeur satur&eacute;e &agrave;
la limite mat&eacute;rielle basse
Bit 8 actif: Valeur satur&eacute;e &agrave;
la limite mat&eacute;rielle haute
Il peut y avoir plusieurs raisons pour qu’une calibration
ne soit pas faite. Par exemple
en fonction du mode de calibration actif, si une des limite
a &eacute;t&eacute; d&eacute;pass&eacute;e. Dans ce cas il
y a plus d’information renvoy&eacute;e par les bits 1 &agrave; 4. Une
autre raisons peut &ecirc;tre que
l’&eacute;l&eacute;ment de calibration ou la
page active est prot&eacute;g&eacute; en
&eacute;criture ou que les points
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 64
d’appui x ou y ne sont pas
monotones. Dans tous ces
cas, seul le bit 0 est activ&eacute;.
Arguments
deviceName
Nom du dispositif
calibrationName
Nom de l’&eacute;l&eacute;ment de cali-
d’entr&eacute;e
bration
value
La valeur actuelle de la calibration. Elle doit correspondre
aux types de donn&eacute;es indiqu&eacute;s ci-dessous:
Scalaires: une matrice (1,1)
Courbes: une matrice (x,1)
Cartographies: une matrice
(x,y)
Distributions de points
d'interruption (d’appui) :
une matrice (x,1)
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 65
start
Index de d&eacute;part. Types de donn&eacute;es support&eacute;es:
Pour les courbes et distributions de points
d'interruption un index de
d&eacute;part x doit &ecirc;tre sp&eacute;cifi&eacute;.
x &gt;= 1
Pour les cartographies, un
index de d&eacute;part [x,y] doit
&ecirc;tre sp&eacute;cifi&eacute;.
x,y &gt;= 1
valueType
S&eacute;lection de la valeur de
retour (texte). La fonction renvoie soit la valeur de la
variable de calibration (par
d&eacute;faut) soit la distribution X
ou Y de points d'interruption
(point d’appui). Param&egrave;tres
possibles :
v: valeur
x: point d’appui en x
(courbe et cartographies)
y: point d’appui en y (cartographie)
Exemples
IncaSetCalibrationValue(’anEtk’,
’Scalar’, aValue);
IncaSetCalibrationValue(’anEtk’, ’Curve’,
aCurve);
IncaSetCalibrationValue(’anEtk’, ’Map’,
aMap);
IncaSetCalibrationValue(’anEtk’, ’Map’,
xMap, ’x’);
IncaSetCalibrationValue(’anEtk’, ’Map’,
yMap, ’y’);
IncaSetCalibrationValue(’anEtk’, ’Curve’,
aCurveRange, 2);
IncaSetCalibrationValue(’anEtk’, ’Map’,
aMapRange,[2,3]);
IncaSetCalibrationValue(’anEtk’, ’Map’,
xMapRange, 2, ’x’);
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 66
4.5.5
Assigner un jeu de donn&eacute;es au dispositif (INCA-MIP Evolu&eacute;e)
Nom
IncaSetDatasetInDevice
Description
Cette fonction permet d’assigner un jeu de donn&eacute;e &agrave;
un dispositif dans une exp&eacute;rimentation ouverte
Syntaxe
IncaSetDatasetInDevice(device,dataset)
Arguments
none
de sortie
Arguments
device
Nom du dispositif
dataset
Chemin d’acc&egrave;s du jeu de donn&eacute;es
d’entr&eacute;e
dans la base de donn&eacute;es INCA
Exemples
IncaSetDatasetInDevice
('ETK:1','Ds4711\Ds4711_3')
4.5.6
Lister les jeux de donn&eacute;es d’un dispositif (INCA-MIP Evolu&eacute;e)
Nom
IncaGetDatasetsForDevice
Description
Cette fonction permet d’obtenir la liste des noms de
tous les jeux de donn&eacute;es pour un dispositif
Syntaxe
nom = IncaGetDatasetsForDevice(device)
[nom, properties] = IncaGetDatasetsForDevice(device)
Arguments
nom
de sortie
Liste, avec le chemin d’acc&egrave;s, de
tous les jeux de donn&eacute;es trouv&eacute;s
properties
Liste des propri&eacute;t&eacute;s des jeux de
donn&eacute;es
Les valeurs possibles sont:
'' (champ vide): Jeu de donn&eacute;es
en acc&egrave;s lecture/&eacute;criture
r : Jeu de donn&eacute;es en lecture
seule
m : Jeu de donn&eacute;es ma&icirc;tre en
acc&egrave;s lecture/&eacute;criture
mr : Jeu de donn&eacute;e ma&icirc;tre en lecture seule
Arguments
device
Nom du dispositif
d’entr&eacute;e
Exemples
l = IncaGetDatasetsForDevice('ETK:1')
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 67
4.5.7
Etablir le mode de calibration (INCA-MIP Evolu&eacute;e)
Nom
IncaSetCalibrationMode
Description
Cette fonction permet de fixer le mode de calibration
global valide pour toutes les calibrations d&eacute;finis avec la
fonction IncaSetCalibrationValue. Le mode reste
valide m&ecirc;me apr&egrave;s avoir ferm&eacute; puis r&eacute;ouvert
&reg;
l’exp&eacute;rimentation. En d&eacute;marrant l’interface MATLAB , le
mode par d&eacute;faut pour les limites hautes et basses est :
rejectWeakBoundViolation.
Syntaxe
IncaSetCalibrationMode(lowerLimitMode,
upperLimitMode)
Arguments
none
de sortie
Arguments
lowerLimitMode
d’entr&eacute;e
Le nouveau mode de calibration
pour les limites basses.
upperLimitMode
Le nouveau mode de calibration
pour les limites hautes:
rejectWeakBoundViolation: Rejette compl&eacute;tement la calibration si une
limite logicielle est d&eacute;pass&eacute; au
moins une fois (par d&eacute;faut)
limitToWeakBound: Si les
limites logicielles hautes haute
sont d&eacute;pass&eacute;es, utiliser &agrave; la
place la valeur de la limite logicielle haute ou basse
rejectHardBoundViolation: Ignorer les limites logicielles. Rejetter la calibration si
les limites mat&eacute;rielles sont
d&eacute;pass&eacute;es au moins une fois
limitToHardBound: Ignorer
les limites logicielles. Si les
limites mat&eacute;rielles hautes
haute sont d&eacute;pass&eacute;es, utiliser
&agrave; la place la valeur de la limite
mat&eacute;rielle haute ou basse.
Exemples
IncaSetCalibrationMode
('rejectHardBoundViolation',
'limitToHardBound')
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 68
4.5.8
Groupement des dispositifs (INCA-MIP Evolu&eacute;e)
Nom
IncaGroupDevices
Description
Activer ou d&eacute;sactiver le groupement de dispositif
Syntaxe
IncaGroupDevices(onOff)
Arguments
none
de sortie
Arguments
0 : D&eacute;sactiver le groupement de
onOff
d’entr&eacute;e
dispositif
1 : Activer le groupement de dispositif
Exemples
4.5.9
IncaGroupDevices(1)
Ecrire un fichier DCM (INCA-MIP Evolu&eacute;e)
Nom
IncaWriteToFile
Description
Cette fonction permet &eacute;crire un fichier DCM &agrave; partir
des calibrations de l’exp&eacute;rimentation ouverte
Syntaxe
IncaWriteToFile(format,file,device,
calibs{,options})
Arguments
none
de sortie
Arguments
format
Identificateur du format du fichier:
'DCM': format DCM
file
Chemin d’acc&egrave;s complet du fichier
d’entr&eacute;e
&agrave; &eacute;crire
device
Dispositif des calibrations qui
seront &eacute;crites
calibs
Liste des &eacute;l&eacute;ments de calibration &agrave;
&eacute;crire (tableau)
options
Options utilis&eacute;es pour &eacute;crire au format indiqu&eacute;
Exemples
calibs = {'A0_KW', 'BRABEVI_KL', 'KFZW_
GKF'};
IncaWriteToFile('DCM','C:\DCMOut1.dcm',
'device1', calibs);
IncaWriteToFile('DCM','C:\DCMOut2.dcm',
'ETK:1','A0_KW');
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 69
4.6
Gestion des pages m&eacute;moires
Toutes les fonctions pr&eacute;demment d&eacute;crites sont effectives pour la page actuellement active d'un dispositif. En principe, l'acc&egrave;s &agrave; la calibration est possible &agrave; partir de la page de travail uniquement. Cependant, m&ecirc;me dans ce cas, il est
possible que le droit d'&eacute;criture dans la page de travail de l’ETK soit bloqu&eacute; parce
que les sommes de contr&ocirc;le de la page de travail entre INCA et l’ETK ne correspondent pas.
Les fonctions API suivantes peuvent &ecirc;tre utilis&eacute;es pour la gestion des pages
m&eacute;moires.
4.6.1
Activer une page m&eacute;moire
Nom
IncaSwitchPage
Description
Cette fonction permet d’activer la page m&eacute;moire sp&eacute;cifi&eacute;e
Syntaxe
IncaSwitchPage(deviceName, pageName)
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
pageName
Nom de la page:
wp: Page de travail
d’entr&eacute;e
rp: Page de r&eacute;f&eacute;rence
Exemples
IncaSwitchPage('MyDevice', 'wp');
IncaSwitchPage('Dev', 'rp');
4.6.2
Get Current Page (INCA-MIP Evolu&eacute;e)
Nom
IncaGetCurrentPage
Description
Cette fonction permet de conna&icirc;tre la page m&eacute;moire
actuellement active
Syntaxe
pageName = IncaGetCurrentPage(deviceName)
Arguments
pageName
de sortie
Nom de la page m&eacute;moire active:
wp: Page de travail
rp: Page de r&eacute;f&eacute;rence
Arguments
deviceName
Nom du dispositif
d’entr&eacute;e
Exemples
p = IncaGetCurrentPage('MyDevice');
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 70
4.6.3
V&eacute;rifier la protection en &eacute;criture
Nom
IncaIsPageWriteProtected
Description
Cette fonction permet de v&eacute;rifier si la page m&eacute;moire
sp&eacute;cifi&eacute;e est prot&eacute;g&eacute;e en &eacute;criture
Syntaxe
isRW = IncaIsPageWriteProtected(deviceName, pageName)
Arguments
0 : la page n’est pas prot&eacute;g&eacute;e en
isRw
de sortie
&eacute;criture
not 0 : la page est prot&eacute;g&eacute;e en
&eacute;criture
Arguments
deviceName
Nom du dispositif
pageName
Nom de la page:
wp: Page de travail
d’entr&eacute;e
rp: Page de r&eacute;f&eacute;rence
Exemples
isETK1RW = IncaIsPageWriteProtected
('ETK:1', 'wp');
isETK2RW = IncaIsPageWriteProtected
('ETK:2', 'rp');
4.6.4
T&eacute;l&eacute;charger vers l’ECU la page m&eacute;moire
Nom
IncaDownloadPage
Description
Cette fonction permet de t&eacute;l&eacute;charger la page m&eacute;moire
sp&eacute;cifi&eacute;e dans le calculateur
Syntaxe
IncaDownloadPage(deviceName, pageName)
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
pageName
Nom de la page &agrave; t&eacute;l&eacute;charger
wp: Page de travail
d’entr&eacute;e
rp: Page de r&eacute;f&eacute;rence
Exemples
IncaDownloadPage('ETK:1', 'wp');
IncaDownloadPage('ETK:1', 'rp');
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 71
4.6.5
Copier la page m&eacute;moire
Nom
IncaCopyPageFromTo
Description
Cette fonction permet de copier la page m&eacute;moire sp&eacute;cifi&eacute;e. Actuellement il est uniquement possible de
copier de la page de r&eacute;f&eacute;rence vers la page de travail;
les autres combinaisons de copie entre sources et
cibles ne sont pas support&eacute;es.
Syntaxe
IncaCopyPageFromTo( deviceName, sourcePageName, destinationPageName)
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
sourcePageName
Nom de la page &agrave; copier
d’entr&eacute;e
(source):
wp: Page de travail
rp: Page de r&eacute;f&eacute;rence
destinationPageName
Nom de la page &agrave; &eacute;craser
(cible):
wp: Page de travail
rp: Page de r&eacute;f&eacute;rence
Exemples
4.6.6
IncaCopyPageFromTo('ETK:1', 'rp', 'wp');
T&eacute;l&eacute;charger les diff&eacute;rences
Nom
IncaDownloadDifferences
Description
Cette fonction permet de charger les diff&eacute;rences entre
la page de travail et la page de r&eacute;f&eacute;rence dans le calculateur. Comme sur INCA, ceci n’est valable que si la
page de travail et la page de r&eacute;f&eacute;rence du calculateur
cible correspondent &agrave; la page de r&eacute;f&eacute;rence pr&eacute;sente
sous INCA.
Syntaxe
IncaDownloadDifferences( deviceName )
Arguments
none
de sortie
Arguments
deviceName
Nom du dispositif
d’entr&eacute;e
Exemples
IncaDownloadDifferences('ETK:1');
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 72
4.6.7
T&eacute;l&eacute;charger depuis l’ECU les pages m&eacute;moires (INCA-MIP Evolu&eacute;e)
Nom
IncaUploadPages
Description
Cette fonction permet de r&eacute;cup&eacute;rer sous INCA la page
de r&eacute;f&eacute;rence et de travail du calculateur. Ces nouveaux jeux de donn&eacute;es sont automatiquement assign&eacute;s au dispositif.
Syntaxe
IncaUploadPages(device{,referencePage,
workingPage})
Arguments
none
de sortie
Arguments
device
Nom du dispositif
referencePage
Nom du jeu de donn&eacute;es pour la
d’entr&eacute;e
page de r&eacute;f&eacute;rence r&eacute;cup&eacute;r&eacute;e.
Si non pr&eacute;cis&eacute;, INCA utilise un
nom par d&eacute;faut
workingPage
Nom du jeu de donn&eacute;es pour la
page de travail r&eacute;cup&eacute;r&eacute;e.
Si non pr&eacute;cis&eacute;, INCA utilise un
nom par d&eacute;faut
Exemples
IncaUploadPages('ETK:1');
IncaUploadPages('ETK:1', 'ref_1', 'work_
1');
4.7
Exemples
Exemple 1
% V&eacute;rifier si la page de travail est prot&eacute;g&eacute;e en
% &eacute;criture et envoyer la page si tel est le cas.
if(IncaIsPageWriteProtected (’anEtk’, ’wp’))
IncaDownloadPage(’anEtk’, ’wp’);
end
% Passer &agrave; la page de travail
IncaSwitchPage( ’anEtk’, ’wp’);
Exemple 2
Dans l'exemple ci-dessous, les fonctions sont utilis&eacute;es pour lire les valeurs des
variables de mesure du dispostif MyDevice avec une fr&eacute;quence
INCA-MIP V7.5 | Guide de l'utilisateur
4 Fonctions API | 73
d’&eacute;chantillonnage de 10ms. Pour utiliser cet exemple vous devez d’abord ouvrir
une exp&eacute;rimentation sous INCA qui inclue un dispositif nomm&eacute; MyDevice avec 4
voies nomm&eacute;e : Chan1, Chan2, Chan3, Chan4.
% S&eacute;lectionner les signaux suivant
IncaAddMeasureElement( ’MyDevice’, ’10ms’, ’Chan1’ );
IncaAddMeasureElement( ’MyDevice’, ’10ms’, ’Chan2’ );
IncaAddMeasureElement( ’MyDevice’, ’10ms’, ’Chan3’ );
IncaAddMeasureElement( ’MyDevice’, ’10ms’, ’Chan4’ );
% Maintenant lancer la mesure
data = [];
time = [];
IncaShowMessages(0);
IncaSetMeasureReadMode(0)
IncaStartMeasurement;
deltaT = 0;
% Mesurer pendant 20 secondes
while( deltaT &lt; 20 )
% Faire une pause pendant 0.1 secondes pour avoir
% plus d’un &eacute;chantillon -- % &eacute;conomise le temps
processeur
pause(0.1)
% R&eacute;cup&eacute;rer 500 &eacute;chantillons du groupe 10ms
[ t, d ]=IncaGetRecords( ’MyDevice’, ’10ms’, 500
);
% Ajouter t et d au temps et aux donn&eacute;es
data = [data; d];
time = [time; t];
if( length(time) )
% Calculer le temps de la mesure
deltaT = time( length(time)) - time(1);
end
end
IncaStopMeasurement;
IncaShowMessages(1);
% Tracer le r&eacute;sultat
plot(time, data);
Cet exemple n'utilise qu'une seule fr&eacute;quence d’&eacute;chantillonnage. Il vous est
cependant possible d'utiliser plusieurs fr&eacute;quences et d'effectuer une requ&ecirc;te
pour les donn&eacute;es de chaque fr&eacute;quence.MATLAB
&reg;
INCA-MIP V7.5 | Guide de l'utilisateur
5 Cr&eacute;ation et distribution de fichiers ex&eacute;cutables autonomes &agrave; l'aide du compilateur
5
Cr&eacute;ation et distribution de fichiers ex&eacute;cutables auto&reg;
nomes &agrave; l'aide du compilateur MATLAB
Avec l’AddOn INCA-MIP, vous pouvez cr&eacute;er et compiler des fichiers m contenant
&reg;
des appels aux fonctions API de INCA-MIP, y compris des fonctions MATLAB . Le
r&eacute;sultat est un fichier autonome qui peut &ecirc;tre utilis&eacute; dans n’importe quel envi&reg;
ronnement sans forc&eacute;ment avoir le logiciel MATLAB .
&reg;
Pour la cr&eacute;ation de fichiers ex&eacute;cutables une installation de MATLAB est n&eacute;cessaire. L'ex&eacute;cutable qui en r&eacute;sulte, ainsi que les copies de certaines DLL de
&reg;
&reg;
MATLAB et ETAS, peuvent &ecirc;tre utilis&eacute;s sans installation de MATLAB sur le syst&egrave;me cible.
&reg;
En outre, les biblioth&egrave;ques d'ex&eacute;cution MATLAB peuvent &ecirc;tre n&eacute;cessaires pour
ex&eacute;cuter les ex&eacute;cutables compil&eacute;s sur le syst&egrave;me cible.
&reg;
Reportez-vous &agrave; la documentation de l'utilisateur de MATLAB sous Distribuer
des applications autonomes pour savoir comment installer et utiliser les biblio&reg;
th&egrave;ques d'ex&eacute;cution de MATLAB .
5.1
Compilation des fichiers m
&reg;
Compiler des fichiers m avec le compilateur MATLAB :
1. Copiez tous les fichiers Inca*.dll et Inca.*.mexw64 dans le r&eacute;pertoire
de travail actuel.
&reg;
Assurez-vous que le compilateur MATLAB et les chemins d'acc&egrave;s &agrave; INCAMIP sont ajout&eacute;s &agrave; la variable d'environnement Windows.
Pour d&eacute;finir les variables d'environnement, reportez-vous &agrave; la section Param&egrave;tres syst&egrave;me avanc&eacute;s de la documentation utilisateur Windows.
Ex&eacute;cutez la commande suivante :
mcc -m &lt;m-fichier-script&gt; -a incaRci2Matlab.dll
Exemple:
La commande suivante permet de cr&eacute;er un fichier ex&eacute;cutable autonome &agrave;
partir du fichier testCase2.m:
mcc -m testCase2 -a incaRci2x64Matlab.dll
Le r&eacute;sultat est le fichier testCase2.exe.
&reg;
Le compilateur MATLAB cr&eacute;e un conteneur contenant toutes les DLL de fonctions MEX et les DLL d&eacute;pendantes n&eacute;cessaires &agrave; l'ex&eacute;cution du script compil&eacute;
&reg;
MATLAB . Tous les fichiers Inca *.dll utilis&eacute;s par le script ainsi que le fichier incaRci2x64Matlab.dll doivent faire partie de ce conteneur. Les DLL de la fonction
INCA MEX ont l'extension *.mexw64.
Lorsque le script compil&eacute; est ex&eacute;cut&eacute;, les DLL ne doivent pas &ecirc;tre pr&eacute;sentes sur
le syst&egrave;me.
INCA-MIP V7.5 | Guide de l'utilisateur
5 Cr&eacute;ation et distribution de fichiers ex&eacute;cutables autonomes &agrave; l'aide du compilateur
&reg;
Reportez-vous &agrave; votre documentation utilisateur MATLAB , mot-cl&eacute; MATLAB
&reg;
Compilateur ou mcc pour les versions requises et les param&egrave;tres cor&reg;
respondants du compilateur MATLAB .
Note
&reg;
INCA ne peut &ecirc;tre contr&ocirc;l&eacute; que par une seule session MATLAB &agrave; la fois
La tentative d’ex&eacute;cuter une deuxi&egrave;me fois INCA depuis une deuxi&egrave;me ins&reg;
tance MATLAB ou par l’interm&eacute;diaire d’un fichier ex&eacute;cutable est interrompue avec un message d’erreur.
Note
&reg;
Avec MATLAB R2016a ou une version ult&eacute;rieure, les DLL de la fonction
MEX de INCA ont l'extension *.mexw64.
5.2
Distribution des fichiers ex&eacute;cutables autonome
L'ex&eacute;cution des fichiers ex&eacute;cutables autonomes qui ont &eacute;t&eacute; compil&eacute;s &agrave; l'aide du
&reg;
compilateur MATLAB ne n&eacute;cessite que l'ex&eacute;cutable lui-m&ecirc;me. Une installation
&reg;
de MATLAB ou des copies des biblioth&egrave;ques ne sont pas n&eacute;cessaires.MATLAB
&reg;
Distribuer des fichiers ex&eacute;cutables autonomes compil&eacute;s avec le compilateur
MATLAB
&reg;
Copiez les fichiers ex&eacute;cutables autonomes sur le syst&egrave;me cible.
Ensuite, vous pouvez les ex&eacute;cuter ; aucune autre &eacute;tape n'est n&eacute;cessaire.
INCA-MIP V7.5 | Guide de l'utilisateur
6 Informations des Contacts | 76
6
Informations des Contacts
Support technique
Pour les d&eacute;tails sur vos services de distribution en plus que
votre &eacute;quipe de support et vos hotlines, regardez les pages
d’internet ETAS :
www.etas.com/hotlines
ETAS propose des formations pour ses produits :
www.etas.com/academy
ETAS si&egrave;ge principal
ETAS GmbH
Borsigstra&szlig;e 24
Phone :
+49 711 3423-0
70469 Stuttgart
Fax :
+49 711 3423-2106
Allemagne
Internet :
www.etas.com
INCA-MIP V7.5 | Guide de l'utilisateur
Index | 77
Index
B
Buffer tournant
C
Calibration
D
Dispositif
Donn&eacute;es
Donn&eacute;es de mesure
E
Enregistrement des donn&eacute;es
ETAS
Informations des Contacts
F
fichiers d'&eacute;chantillonnage
fichiers ex&eacute;cutables autonomes
fichiers m
fichiers M
fichiers MEX
Fr&eacute;quence d’&eacute;chantillonnage
G
gestionnaire de pages de m&eacute;moire
I
IncaAddCalibrationElement
IncaAddMeasureElement
IncaBrowseCalibrationElements
IncaBrowseItemsInFolder
IncaBrowseMeasureElements
IncaClose
IncaCopyPageFromTo
IncaDatabaseImport
IncaDownloadDifferences
IncaDownloadPage
IncaExecuteManualTrigger
IncaGetCalibrationValue
IncaGetCurrentPage
IncaGetDatasetsForDevice
IncaGetDeviceProperties
IncaGetDevices
IncaGetHardwareStatus
IncaGetInstalledAddOnInfo
IncaGetInstalledProductInfo
IncaGetMeasureRatesForDevice
IncaGetProperties
10
9
10
8
10
10
76
19
74
9
19
12
11
9
59
36
58
29
35
27
71
28
71
70
56
60
69
66
33
33
52
24
23
36
25
IncaGetRecordingMode
IncaGetRecordingProperties
IncaGetRecordingState
IncaGetRecords
IncaGetRecordStruct
IncaGetVersion
IncaGroupDevices
IncaIsLicenseValid
IncaIsPageWriteProtected
IncaOpen
IncaOpenDatabase
IncaOpenExperiment
IncaResetExperiment
IncaResetRecords
IncaSetCalibrationMode
IncaSetCalibrationValue
IncaSetDatasetInDevice
IncaSetMeasureReadMode
IncaSetProjectAndDatasetInDevice
IncaSetRecordingMode
IncaSetRecordingProperties
IncaSetTrigger
IncaShowMessages
IncaStartMeasurement
IncaStartRecording
IncaStopMeasurement
IncaStopRecording
IncaSwitchPage
IncaUploadPages
IncaWriteToFile
Informations des Contacts
M
mcc
Measuring
R
Raster de mesure
S
scripts MATLAB
Signal
V
Variable de calibration
44
39
56
48
57
25
68
23
70
26
27
31
32
51
67
62
66
47
31
45
41
52
23
38
46
39
46
69
72
68
76
74
9
10
9
11
10
INCA-MIP V7.5 | Guide de l'utilisateur
Fonctionnalités clés

Interface de programmation MATLAB
Contrôle des fonctionnalités INCA
Automatisation des tâches
Calibration et mesure
Gestion des pages mémoire
Manuels associés

Réponses et questions fréquentes

Quelle version de INCA est compatible avec INCA-MIP ?

INCA-MIP V7.5 est compatible avec INCA V7.5 SPx. Assurez-vous que le numéro de version de votre installation INCA correspond à la version de INCA-MIP.
Comment mettre à jour les liens Cache de la boîte à outils MATLAB ?

Après l'installation de INCA-MIP, vous devrez peut-être mettre à jour les liens Cache des répertoires de la boîte à outils MATLAB. Veuillez consulter la documentation utilisateur de MATLAB pour plus d'informations.
De quoi ai-je besoin pour utiliser INCA-MIP ?

Vous aurez besoin d'INCA installé sur votre ordinateur ainsi qu'une licence INCA-MIP valide. Si vous souhaitez développer des scripts MATLAB, vous aurez également besoin d'une licence MATLAB complète.
ETAS INCA-MIP Manuel utilisateur

Fonctionnalités clés

Manuels associés

ETAS

INCA-MIP

ETAS

INCA-MIP

ETAS

INCA V7.5

ETAS

INCA V7.4

ETAS

INCA V7.4

ETAS

INCA V7.5

ETAS

INCA V7.4

ETAS

INCA V7.4

ETAS

INCA V7.4

ETAS

INCA V7.4

ETAS

MDA

ETAS

MDA

Réponses et questions fréquentes

Quelle version de INCA est compatible avec INCA-MIP ?

Comment mettre à jour les liens Cache de la boîte à outils MATLAB ?

De quoi ai-je besoin pour utiliser INCA-MIP ?
