Procédure d installation d AMESim 4.3.0

Transcription

1 Procédure d installation d AMESim B2i Automotive Yahia BOUZID 18/07/2006

2 SOMMAIRE SOMMAIRE... 2 LISTE DES FIGURES... 3 HISTORIQUE DES MODIFICATIONS INTRODUCTION OBJET DU DOCUMENT MISE A JOUR DU DOCUMENT PRE-REQUIS CONTACT INSTALLATION D AMESIM INSTALLATION MISE A JOUR DES LIENS Variables d environnement Compilateur (Visual C++) et MATLAB MATLAB LICENCE AMESIM HOST NAME HOST ID INSTALLATION DE LA LICENCE INSTALLATION DU PATCH AMESIM AVANT D INSTALLER LE PATCH INSTALLATION WINDOWS XP/2000/NT INSTALLATION DU MODULE TEMPS-REEL PATCH TEMPS-REEL PC HOTE BIBLOTHEQUES TEMPS-REEL AMESIM SUR CIBLE QNX PROBLEMES RENCONTRES

3 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 FIGURE 6: HOST ID FIGURE 7: FICHIER DE LICENCE FIGURE 8: INSTALLATION LICENCE FIGURE 9: INSTALLATION LICENCE FIGURE 10: INSTALLATION LICENCE FIGURE 11: CONNEXION VIA FTP SUR LA CIBLE FIGURE 12: COPIE DU PACKAGE TEMPS-REEL SUR LA CIBLE FIGURE 13: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX FIGURE 14: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX FIGURE 15: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX FIGURE 16: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX FIGURE 17: INSTALLATION DES BIBLIOTHEQUES SUR CIBLE QNX - FIN DE LA DECOMPRESSION DES FICHIERS

4 Historique des modifications Date Version Auteur Objet 18/07/ Y. Bouzid Création du document 4

5 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 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 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 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 RT-Lab Contact Support Support.fr@amesim.com (STANDARD) Stéphane CLEMENT Arne JANSSON Licences Lionel BROGLIA PATRON Account Manager IMAGINE S.A. - 3 cours Albert THOMAS Lyon Cedex 03 Tel : +33(0) Mob : +33(0) broglia@amesim.com 5

6 2. Installation d AMESim Installation - Insérer le CD d installation d AMESim Attendre quelques secondes que l ordinateur lance automatiquement le setup.exe - Suivre les instruction à l écran jusqu à la fin de l installation 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

7 Figure 2: Sélection du compilateur Sélectionnez le compilateur utilisé (Microsoft Visual C++). 7

8 2.2. Mise à jour des liens Variables d environnement Après l installation d AMESim 4.3.0, il faudra veiller à ce que les variables d environnement suivantes soient bien définies 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; 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

9 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 msv60opts.bat Visual C msv61opts.bat Visual C msv70opts.bat Visual C msv71opts.bat MATLAB Sous Matlab, mettre dans File Set path : C:\AMESim4.3.0\lib Figure 4: MATLAB - Set Path 9

10 3. Licence AMESim 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

11 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

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

13 - Dans l onglet «Config Services», créez un nouveau service, AMED, avec les - caractéristiques suivantes : Figure 9: Installation licence 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 Fermez FlexLM, la machine est configurée 13

14 4. Installation du patch AMESim Le patch nécessaire à l installation de la version d AMESim est disponible dans le répertoire \\Entp02\projets\Interne\OPAL_RT\AmeSim\Patch AMESim Il s agit du fichier «43112_WIN.exe» Avant d installer le patch - Ce patch est un upgrade de la version à la version Il ne s agit pas d un fichier d installation complet d AMESim Il faut donc d abord installer AMESim à partir du CD d installation - La mise à jour de votre version d AMESim ne peut se faire QUE si AMESIm est déjà installé Installation Windows XP/2000/NT - Connectez-vous en tant qu administrateur - Assurez-vous que AMESim (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 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 ne sera remplacée par (répertoire d installation, variables d environnement et raccourcis pointeront vers 4.3.0, mais AMESim sera exécuté de toute façon) 14

15 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 ). 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 PC hôte - Connectez-vous en tant qu administrateur - Assurez-vous que AMESim (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 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

16 5.2. Biblothèques Temps-Réel AMESim 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

17 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

18 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

19 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 Copyright (C) Microsoft Corp 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

20 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 Copyright (C) Microsoft Corp All rights reserved. Select a compiler: [1] Lcc C version 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