Procédure d`installation d`AMESim 4.3.0 - Opal-RT

Transcription

Procédure d`installation d`AMESim 4.3.0 - Opal-RT
Procédure d’installation d’AMESim 4.3.0
B2i Automotive
Yahia BOUZID
18/07/2006
Procédure d’installation d’AMESim 4.3.0 – Y.B.
SOMMAIRE
SOMMAIRE .......................................................................................................................................................... 2
LISTE DES FIGURES ......................................................................................................................................... 3
HISTORIQUE DES MODIFICATIONS ............................................................................................................ 4
1. INTRODUCTION ............................................................................................................................................. 5
1.1. OBJET DU DOCUMENT ................................................................................................................................... 5
1.2. MISE A JOUR DU DOCUMENT ......................................................................................................................... 5
1.3. PRE-REQUIS ................................................................................................................................................... 5
1.4. CONTACT ...................................................................................................................................................... 5
2. INSTALLATION D’AMESIM 4.3.0 ............................................................................................................... 6
2.1. INSTALLATION .............................................................................................................................................. 6
2.2. MISE A JOUR DES LIENS ................................................................................................................................. 8
2.2.1. Variables d’environnement ................................................................................................................... 8
2.2.2. Compilateur (Visual C++) et MATLAB ................................................................................................ 9
2.2.3. MATLAB................................................................................................................................................ 9
3. LICENCE AMESIM 4.3.0 .............................................................................................................................. 10
3.1. HOST NAME ................................................................................................................................................ 10
3.2. HOST ID ...................................................................................................................................................... 10
3.3. INSTALLATION DE LA LICENCE .................................................................................................................... 11
4. INSTALLATION DU PATCH AMESIM 4.3.1 ............................................................................................ 14
4.1. AVANT D’INSTALLER LE PATCH................................................................................................................... 14
4.2. INSTALLATION WINDOWS XP/2000/NT ...................................................................................................... 14
5. INSTALLATION DU MODULE TEMPS-REEL ........................................................................................ 15
5.1. PATCH TEMPS-REEL 4.3.1 PC HOTE ............................................................................................................ 15
5.2. BIBLOTHEQUES TEMPS-REEL AMESIM 4.3.1 SUR CIBLE QNX ................................................................... 16
6. PROBLEMES RENCONTRES ..................................................................................................................... 19
2
Procédure d’installation d’AMESim 4.3.0 – Y.B.
Liste des figures
FIGURE 1: SELECTION DU REPERTOIRE DE LA LICENCE ............................................................................................ 6
FIGURE 2: SELECTION DU COMPILATEUR ................................................................................................................. 7
FIGURE 3: VARIABLES D'ENVIRONNEMENT .............................................................................................................. 8
FIGURE 4: MATLAB - SET PATH............................................................................................................................. 9
FIGURE 5: HOST NAME .......................................................................................................................................... 10
FIGURE 6: HOST ID ................................................................................................................................................ 10
FIGURE 7: FICHIER DE LICENCE .............................................................................................................................. 11
FIGURE 8: INSTALLATION LICENCE - 1 ................................................................................................................... 12
FIGURE 9: INSTALLATION LICENCE - 2 ................................................................................................................... 13
FIGURE 10: INSTALLATION LICENCE - 3 ................................................................................................................. 13
FIGURE 11: CONNEXION VIA FTP SUR LA CIBLE ...................................................................................................... 16
FIGURE 12: COPIE DU PACKAGE TEMPS-REEL SUR LA CIBLE ................................................................................... 16
FIGURE 13: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - 1 ..................................................................... 17
FIGURE 14: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - 2 ..................................................................... 17
FIGURE 15: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - 3 ..................................................................... 17
FIGURE 16: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - 4 ..................................................................... 18
FIGURE 17: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - FIN DE LA DECOMPRESSION DES FICHIERS ...... 18
3
Procédure d’installation d’AMESim 4.3.0 – Y.B.
Historique des modifications
Date
Version
Auteur
Objet
18/07/2006
1.0
Y. Bouzid
Création du document
4
Procédure d’installation d’AMESim 4.3.0 – Y.B.
1. Introduction
1.1. Objet du document
Ce document a pour but de donner l’ensemble des étapes permettant l’installation de
l’application AMESim 4.3.0, ainsi que le patch 4.3.1.
Il donne de même la procédure d’installation de la licence.
Il recense aussi l’ensemble des problèmes rencontrés au cours de l’installation.
1.2. Mise à jour du document
Le document sera mis à jour suivant les nouvelles difficultés rencontrées lors de
l’utilisation d’AMESim 4.3.0(1), si ces dernières sont en relation avec le processus
d’installation.
1.3. Pré-requis
Les applications suivantes sont nécessaires pour le fonctionnement global des modèles
Simulink/AMESim. On respectera l’ordre d’installation donné ci-dessous :
-
Microsoft Visual C++ (versions 6.0, 6.1, 7.0 ou 7.1)
Matlab 7.1 (installer dans un répertoire ne contenant pas d’espaces. Ex : C:\MATLAB71)
Amesim 4.3.0
RT-Lab 8.0.2
1.4. Contact
Support
[email protected]
04 77 23 60 30 (STANDARD)
Stéphane CLEMENT
Arne JANSSON
Licences
Lionel BROGLIA PATRON
Account Manager
IMAGINE S.A. - 3 cours Albert THOMAS
69416 Lyon Cedex 03
Tel : +33(0)4 37 69 72 37 | Mob : +33(0)6 08 25 16 59
[email protected] | www.amesim.com
5
Procédure d’installation d’AMESim 4.3.0 – Y.B.
2. Installation d’AMESim 4.3.0
2.1. Installation
-
Insérer le CD d’installation d’AMESim 4.3.0
Attendre quelques secondes que l’ordinateur lance automatiquement
setup.exe
Suivre les instruction à l’écran jusqu’à la fin de l’installation
le
On donne ci-dessous quelques détails sur le processus d’installation
Figure 1: Sélection du répertoire de la licence
Cliquez sur « Next » sans vous soucier du répertoire sélectionné. L’installation de la
licence est décrite plus loin dans ce document.
6
Procédure d’installation d’AMESim 4.3.0 – Y.B.
Figure 2: Sélection du compilateur
Sélectionnez le compilateur utilisé (Microsoft Visual C++).
7
Procédure d’installation d’AMESim 4.3.0 – Y.B.
2.2. Mise à jour des liens
2.2.1. Variables d’environnement
Après l’installation d’AMESim 4.3.0, il faudra
d’environnement suivantes soient bien définies
veiller
à
ce
que
Nom de la variable
MATLAB
Valeur de la variable
C:\MATLAB71
Nom de la variable
AME
Valeur de la variable
C:\AMESim4.3.0
Nom de la variable
PATH
Valeur de la variable
… ;C:\Windows\system32; …
les
variables
La configuration se fait à partir de la fenêtre de propriétés système (Panneau de
configuration Performances et maintenance Système)
Figure 3: Variables d'environnement
8
Procédure d’installation d’AMESim 4.3.0 – Y.B.
2.2.2. Compilateur (Visual C++) et MATLAB
-
Aller dans le répertoire C:\MATLAB71\bin\win32\mexopts
Copier le fichier msvXXopts.bat dans le répertoire C:\AMESim\lib
Faire un drag and drop sur « install_big_simulink_interface.exe »
Le fichier msvXXopts.bat à utiliser dépend de la version de Visual C++ :
Visual C++ 6.0
msv60opts.bat
Visual C++ 6.1
msv61opts.bat
Visual C++ 7.0
msv70opts.bat
Visual C++ 7.1
msv71opts.bat
2.2.3. MATLAB
Sous Matlab, mettre dans File Set path : C:\AMESim4.3.0\lib
Figure 4: MATLAB - Set Path
9
Procédure d’installation d’AMESim 4.3.0 – Y.B.
3. Licence AMESim 4.3.0
La création d’un fichier de licence de la part de la société IMAGINE nécessite l’envoi du
host name et du host ID de la machine sur laquelle sera installé AMESim :
3.1. Host Name
-
Lancez une fenêtre MS-DOS
Tapez la commande hostname
Le Host Name s’affiche (ici Host Name = PC271)
Figure 5: Host Name
3.2. Host ID
-
Lancez une fenêtre MS-DOS
Tapez la commande ipconfig/all
Le Host ID est en fait l’adresse MAC de la carte réseau, sans les tirets (-). Elle
correspond au champ « Adresse Physique » (ici Host ID = 00123F7B630B)
Figure 6: Host ID
10
Procédure d’installation d’AMESim 4.3.0 – Y.B.
3.3. Installation de la licence
Le fichier de licence « license.dat », utilisé pour l’intégration du banc HIL Delphi, se
trouve dans le répertoire
\\Entp02\projets\Conf\DELPHI\AMESim\Licence
AMESim 4.3 PC271
Ce fichier « license.dat » est le fichier de licence pour AMESim 4.3.0, associé
exclusivement au PC271.
Réception de la licence le 17/07/2006.
Limite de Validité: 15/09/2006.
Host Name
Host ID
Figure 7: Fichier de licence
11
Procédure d’installation d’AMESim 4.3.0 – Y.B.
-
FlexLM doit être installé sur la machine
Connectez-vous en tant qu’administrateur
Vérifiez que la variable d’environnement AME est définie, et qu’elle pointe bien sur
le répertoire d’installation d’AMESim
Copier le fichier « license.dat » fourni par IMAGINE dans le répertoire
\AMESim4.3.0\licensing
Ouvrir le menu DEMARRER Programmes AMESIm FlexLM Tool
Dans l’onglet « Service/License File », sélectionner le bouton « Configuration
using Services »
Figure 8: Installation licence - 1
12
Procédure d’installation d’AMESim 4.3.0 – Y.B.
-
Dans l’onglet « Config Services », créez un nouveau service, AMED, avec les
caractéristiques suivantes :
-
Figure 9: Installation licence - 2
-
Sauvegardez le service AMED en cliquant sur « Save Service »
Dans l’onglet « Start/Stop/Reread », sélectionnez le service AMED dans la liste
et cliquez sur « Start Server »
Si la barre de statut indique que le serveur tourne déjà, cliquez sur « Reread
License File »
Figure 10: Installation licence - 3
-
Fermez FlexLM, la machine est configurée
13
Procédure d’installation d’AMESim 4.3.0 – Y.B.
4. Installation du patch AMESim 4.3.1
Le patch nécessaire à l’installation de la version 4.3.1 d’AMESim est disponible dans le
répertoire \\Entp02\projets\Interne\OPAL_RT\AmeSim\Patch AMESim 4.3.1. Il
s’agit du fichier « 43112_WIN.exe ».
4.1. Avant d’installer le patch
-
Ce patch est un upgrade de la version 4.3.0 à la version 4.3.1. Il ne s’agit pas
d’un fichier d’installation complet d’AMESim 4.3.1
Il faut donc d’abord installer AMESim 4.3.0 à partir du CD d’installation
La mise à jour de votre version d’AMESim ne peut se faire QUE si AMESIm 4.3.0
est déjà installé.
4.2. Installation Windows XP/2000/NT
-
Connectez-vous en tant qu’administrateur
Assurez-vous que AMESim 4.3.0 (ou AMESet, AMERun, AMECustom) est fermé
avant de lancer l’installation du patch
Veillez à ce que le fichier « 43112_WIN.exe » ne soit pas dans le répertoire
d’AMESim
Exécutez le fichier « 43112_WIN.exe »
L’application
d’installation
demande
alors
de
sélectionner
le
fichier
« AMEcompile42.bat » situé dans le répertoire C:\AMESim 4.3.0
Sélectionnez le fichier et continuez
L’installation commence. Attendez jusqu’à l’affichage du message de fin
d’installation.
Redémarrez votre machine. La mise à jour est terminée.
NOTE: après l’installation du patch, aucune référence à la version 4.3.0 ne sera
remplacée par 4.3.1 (répertoire d’installation, variables d’environnement et
raccourcis pointeront vers 4.3.0, mais AMESim 4.3.1 sera exécuté de toute façon)
14
Procédure d’installation d’AMESim 4.3.0 – Y.B.
5. Installation du module Temps-Réel
Les module Temps-Réel d’AMESim n’est pas distribué dans le CD d’installation standard
d’AMESim, mais un CD à part (ou via FTP ou e-mail). Cette partie décrit le processus
d’installation des bibliothèques temps réel, qui se fait en deux temps :
-
sur le PC hôte
sur la cible QNX
5.1. Patch Temps-Réel 4.3.1 PC hôte
-
Connectez-vous en tant qu’administrateur
Assurez-vous que AMESim 4.3.0 (ou AMESet, AMERun, AMECustom) est fermé
avant de lancer l’installation du patch
Veillez à ce que le fichier « 43120_WIN.exe » ne soit pas dans le répertoire
d’AMESim
Exécutez le fichier « 43120_WIN.exe »
L’application
d’installation
demande
alors
de
sélectionner
le
fichier
« AMEcompile42.bat » situé dans le répertoire C:\AMESim 4.3.0.
Sélectionnez le fichier et continuez
L’installation commence. Attendez jusqu’à l’affichage du message de fin
d’installation.
Redémarrez votre machine. La mise à jour est terminée.
15
Procédure d’installation d’AMESim 4.3.0 – Y.B.
5.2. Biblothèques Temps-Réel AMESim 4.3.1 sur cible QNX
L’installation des bibliothèques Temps-Réel standard AMESim se fait en deux temps :
- copie sur la cible du fichier *.tar
- décompression du fichier dans la cible
Les bibliothèques en question se trouvent dans le fichier « amesim_qnx.tar » .
Se connecter à la cible via ftp : ouvrir
une fenêtre Windows et taper dans la
barre d’adresses
ftp://’adresse IP de la cible’
Figure 11: Connexion via ftp sur la cible
Copier sur la cible le fichier « amesim_qnx.tar »
Figure 12: Copie du package temps-réel sur la cible
16
Procédure d’installation d’AMESim 4.3.0 – Y.B.
Ouvrir l’invite de commandes MS-DOS
Lancer une session telnet sur la cible
telnet ‘adresse IP de la cible’
Figure 13: Installation des bibliothèques sur cible QNX - 1
Se loguer sur la cible en tant qu’administrateur
Login : root
Figure 14: Installation des bibliothèques sur cible QNX - 2
Vérifier que le fichier « amesim_qnx.tar »
se trouve dans le répertoire /home/ntuser
cd /home
cd ntuser
ls
Figure 15: Installation des bibliothèques sur cible QNX - 3
17
Procédure d’installation d’AMESim 4.3.0 – Y.B.
Se placer dans le répertoire usr
cd /usr
Créer un répertoire « amesim » et se
placer dans ce répertoire
mkdir amesim
cd amesim
Créer un répertoire « v431 » et se
placer dans ce répertoire
mkdir v431
cd v431
Figure 16: Installation des bibliothèques sur cible QNX - 4
Décompresser le fichier
« amesim_qnx.tar » dans
/usr/amesim/v431
tar –xvf/home/ntuser/amesim_qnx.tar
Les fichiers décompressés s’affichent sur la fenêtre MS-DOS. Le processus dure quelques
secondes.
Figure 17: Installation des bibliothèques sur cible QNX - Fin de la décompression des fichiers
18
Procédure d’installation d’AMESim 4.3.0 – Y.B.
6. Problèmes rencontrés
PROBLEME
Lors de la compilation d’un modèle AMESim contenant un bloc d’interfaçage avec
Simulink, on obtient le message suivant :
Setting environment for using Microsoft Visual C++ tools.
Microsoft (R) Program Maintenance Utility Version 6.00.8168.0
Copyright (C) Microsoft Corp 1988-1998. All rights reserved.
cl.exe -c -DWIN32 -DAMESIMULINK -IC:\Program Files\MATLAB71/extern/include IC:\Program Files\MATLAB71/simulink/include -nologo -DWIN32 -MT -W3 -GX -Od -D
"_MBCS" -o skyhook_.obj skyhook_.c
Command
line
warning
D4024
:
unrecognized
source
file
type
'Files\MATLAB71/extern/include', object file assumed
Command line warning D4027 : source file 'Files\MATLAB71/extern/include'
ignored
Command
line
warning
D4024
:
unrecognized
source
file
type
'Files\MATLAB71/simulink/include', object file assumed
Command line warning D4027 : source file 'Files\MATLAB71/simulink/include'
ignored
skyhook_.c
skyhook_.c(1067) : warning C4101: 'rdummy' : unreferenced local variable
skyhook_.c(1210) : warning C4101: 'i' : unreferenced local variable
skyhook_.c(1557) : fatal error C1083: Cannot open include file: 'simstruc.h': No
such file or directory
NMAKE : fatal error U1077: 'cl.exe' : return code '0x2'
Stop.
System build error!
SOLUTION
Matlab est installé dans le répertoire "Program Files". Le chemin d'accès à Matlab
contient donc un espace. Le compilateur AMESim considère donc que le répertoire est
"C:\Program" et que le fichier est "Files\MATLAB71/extern/include".
Installer Matlab dans un répertoire ne contenant pas d'espaces (ex : C:\Matlab71)
19
Procédure d’installation d’AMESim 4.3.0 – Y.B.
PROBLEME
Lors de la compilation d’un modèle AMESim contenant un module d’interfaçage avec
Simulink, la fenêtre de compilation d’AMESim se bloque, avec affichage des informations
suivantes :
Setting environment for using Microsoft Visual C++ tools.
Microsoft (R) Program Maintenance Utility Version 6.00.8168.0
Copyright (C) Microsoft Corp 1988-1998. All rights reserved.
…
…
…
Select a compiler:
[1] Lcc C version 2.4.1 in C:\MATLAB71\BIN\WIN32\\..\..\sys\lcc
[2] Microsoft Visual C/C++ version 6.0 in C:\PROGRA~1\MICROS~3
[0] None
SOLUTION
AMESim attend que l’utilisateur choisisse un compilateur.
- Cliquez droit en bas de la fenêtre de compilation
- Un menu « Interactive compilation » apparaît
- Sélectionner ce menu. Un champ vide apparaît en bas de la fenêtre de compilation
- Ecrivez le numéro d’index correspondant au compilateur utilisé
- La compilation commence
20