Procédure d installation d AMESim 4.3.0

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

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

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

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

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 Support.fr@amesim.com 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 broglia@amesim.com www.amesim.com 5

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

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

2.2. Mise à jour des liens 2.2.1. 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

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

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

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

- 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

- 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

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

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

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

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

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

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

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