www.nsi.fr MUXTools Guide Utilisateur 25/04/2006 DUT-MUX-0159 /V2.2 Auteur : Approbation : Cédric Rousset Bruno Dury
Page laissée intentionnellement blanche
I. Contenu I. CONTENU... 1 II. AVERTISSEMENTS... 2 III. BUT DU DOCUMENT... 3 IV. PRESENTATION GENERALE... 4 IV.1 Introduction... 4 V. INSTALLATION... 5 V.1 Configuration requise... 5 V.2 Démarrage... 5 VI. AFFICHAGE DES FICHIERS.BIN... 6 VI.1 Ouverture des fichiers... 6 VI.2 Filtrer les données... 8 VI.3 Regrouper des fichiers... 9 VII. FICHIERS.TXT ET.ASC... 10 VII.1 Générer des fichiers.txt et.asc... 10 VII.2 Ouverture des fichiers... 10 VII.3 Filtrer les données... 11 VII.4 Changer la police de caractère... 12 VII.5 Changer les couleurs... 12 VII.6 Impression... 12 VIII. ANNEXE : EXEMPLE DE FICHIER.TXT... 14 IX. ANNEXE : EXEMPLE DE FICHIER.ASC... 15 avril 2006 DUT-MUX-0159 /V2.2-1 -
II. Avertissements Les éléments contenus dans ce document sont fournis à titre d'information. Ils pourront faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager la société anonyme NSI. La société anonyme NSI ne saurait en aucun cas être tenue pour responsable d'une quelconque erreur contenue dans ce document, ainsi que des éventuelles conséquences pouvant en résulter. Aucune partie de ce document ne peut être reproduite à d'autres fins que l'usage personnel de l'acheteur sans la permission expresse et écrite de la société anonyme NSI. - 2 - DUT-MUX-0159 /V2.2 avril 2006
III. But du document Le but de ce document est de donner à l'utilisateur toutes les informations nécessaires à l'installation et l'utilisation du logiciel MUXtools. avril 2006 DUT-MUX-0159 /V2.2-3 -
IV. Présentation générale IV.1 Introduction MUXtools est un logiciel d'exploitation des fichiers générés par le MUXlog. Il permet de d'afficher des fichiers de type.bin,.txt et.asc. MUXtools est capable de regrouper des fichiers de type.bin issus de différents canaux synchronisés d'une configuration de MUXlog(s). MUXtools est capable de générer des fichiers de type.txt et.asc à partir des fichiers.bin du MUXlog. MUXtools est capable selon les cas de filtrer l'affichage des fichiers en fonction de différents paramètres. - 4 - DUT-MUX-0159 /V2.2 avril 2006
V. Installation V.1 Configuration requise MUXtools fonctionne avec les systèmes d'exploitation PC suivants : Windows 98 Windows 2000 Windows Me Windows XP MuxTools est installé dans le répertoire d'installation du MUXlog par l'assistant d'installation. Le programme se lance à partir du menu démarrer (par défaut dans le groupe \Outils NSI\MUXlog\MuxTools). V.2 Démarrage La fenêtre de l'application MUXtools se présente comme un éditeur de texte classique : avril 2006 DUT-MUX-0159 /V2.2-5 -
VI. Affichage des fichiers.bin Les fichiers BIN sont des fichiers binaires générés : - soit par le MUXlog lors de la récupération d'un enregistrement du MUXlog. - Soit par le logiciel MUXtools lorsque celui réalise un regroupement de plusieurs fichiers BIN (Cf. VI.3) Si le fichier a été généré par le MUXlog, celui-ci contient toutes les informations relatives à la configuration du canal et à l'enregistrement réalisé. Si le fichier a été généré par MUXtools, le fichier contient les informations sur tous les canaux regroupés ainsi que les événements survenus sur l'ensemble des canaux présents. Les fichiers.bin ne sont pas des fichiers Texte et ne peuvent être affichés par un éditeur de texte classique (WordPad, Word, ). VI.1 Ouverture des fichiers Lorsqu'un fichier.bin est ouvert, il est affiché dans une fenêtre spécifique composée : - d un entête décrivant la configuration du ou des canaux ayant réalisés l'enregistrement - d'une liste d'événements observés sur le ou les canaux La partie supérieure de la fenêtre comporte autant d'onglets que le fichier comporte de canaux. Si le fichier a été généré par le MUXlog il n'y a qu'un onglet de visible. Chaque onglet résume la configuration du canal ayant réalisé l'enregistrement des trames circulant sur le bus auquel il était connecté. On retrouve le date d enregistrement, la date du déclenchement, le type de bus ainsi que leur configuration. La condition d'enregistrement comme le délai avant et après déclenchement, les conditions de déclenchement, d'arrêt et de filtrage sont également rappelées. - 6 - DUT-MUX-0159 /V2.2 avril 2006
Dans la liste déroulante sont affichés les événements, organisés par Date, Type, Canal, Identificateur, Dlc et Données. Les trames sont affichées avec les dates absolues (en fonction de la valeur de l'horloge interne du MUXlog) dans l'ordre chronologique. Il est possible d afficher les dates sous le format jj/mm/aaaa hh:mm:ss:ms.us. Pour cela, on utilise la commande Dates Longues du menu Outils (disponible aussi par menu contextuel). Le type d'événement est indiqué dans la deuxième colonne et symbolisé par l'icône en début de chaque ligne pour une meilleure lisibilité. Les différents types d'événement possible sont: IN Appui sur le bouton satellite TRG Condition de déclenchement ou d'arrêt ERR Erreur réseau (CAN, VAN ou LIN). EVT Indication (changement d'état du CAN, information d'une entrée, ) CAN1 Trame provenant d'un réseau CAN (High speed ou Low speed) VAN Trame provenant d'un réseau VAN LIN Trame provenant d'un réseau LIN? Evénement inconnu Le numéro du canal sur lequel l'événement s'est produit est indiqué dans la troisième colonne. La commande Identificateur indique, soit l'événement en clair, soit dans le cas de trames CAN, VAN ou LIN l'identificateur de la trame. Les colonnes suivantes indiquent dans le cas de trames CAN, VAN ou LIN la longueur des données et les données au format hexadécimal. avril 2006 DUT-MUX-0159 /V2.2-7 -
VI.2 Filtrer les données Pour filtrer un fichier, on utilise l icône (disponible également par le menu contextuel). La boîte de dialogue suivante permet de paramétrer un filtrage simple de la liste d'événements affichés : Slot: Permet d'afficher uniquement le ou les slots déterminés. (par exemple : < 2) IN: EVT: CAN1: CAN2: VAN: LIN: PréTrig: PostTrig: Si cette case est cochée, les événements provenant des entrées (TRIG, Réveil ou bouton satellite) sont affichés. Si cette case est cochée, les indications sont affichées. Si cette case est cochée, les trames provenant du réseau CAN1 sont affichées. Si cette case est cochée, les trames provenant du réseau CAN2 sont affichées. Si cette case est cochée, les trames provenant d'un réseau VAN Si cette case est cochée, les trames provenant d'un réseau LIN Si cette case est cochée, les trames précédents le déclenchement sont affichées. Si cette case est cochée, les trames suivants le déclenchement sont affichées. - 8 - DUT-MUX-0159 /V2.2 avril 2006
VI.3 Regrouper des fichiers Pour regrouper des fichiers, on utilise l icône. Dans la boite de dialogue de sélection de fichiers, il est alors possible de sélectionner plusieurs fichiers.bin (de 2 à 8). Attention : Tous les fichiers binaires sélectionnés doivent avoir été créés à partir de canaux chaînés et donc synchronisés (dates absolues identiques). Si un des fichiers n'est pas synchronisé, le regroupement échoue. Le regroupement des fichiers n'altère pas les fichiers initiaux. Un nouveau fichier.bin est crée avec le nom fichier1_fichier2_ _fichier8.bin. Ce nouveau fichier peut être utilisé de nouveau (afficher, filtrer, regrouper avec un autre canal synchronisé) ou converti en.txt ou.asc (Cf. VII.1). avril 2006 DUT-MUX-0159 /V2.2-9 -
VII. Fichiers.TXT et.asc VII.1 Générer des fichiers.txt et.asc Si aucun fichier.bin n'est ouvert, l'utilitaire de conversion est accessible par le menu Fichier, Convertir en.txt ou Convertir en.asc. Il est alors possible de choisir le ou les fichiers.bin à convertir dans une boîte de dialogue de sélection de fichiers. Pour générer des fichiers.txt et.asc à partir d'un fichier.bin déjà ouvert, on utilise : - soit l icône (Rouge) pour générer un.txt - soit l icône (Vert) pour générer un.asc. Les fichiers TXT générés sont des fichiers texte délimités pouvant être ouverts aussi bien par les éditeurs de texte classiques (Word, WordPad, ), que par les tableurs (Excel, ). Les fichiers ASC générés sont des fichiers au format CANalyzer pouvant être ouverts par les applications comme CANalyzer, CANgraph (avec une base de données), Les fichiers ASC et TXT peuvent également être ouverts avec cette application simplement par le menu Fichier, Ouvrir. VII.2 Ouverture des fichiers Les fichiers TXT du MUXlog ont toujours le même format : un bloc d'en-tête les données de l'enregistrement L extension du fichier est *.TXT, il peut être visualisé par n importe quel éditeur de texte (Word, Excel, WordPad, NotePad, ). Pour plus de détails sur ces fichiers, consulter la documentation du MUXlog MUXlog CAN/LIN DUT-MUX-0170-10 - DUT-MUX-0159 /V2.2 avril 2006
VII.3 Filtrer les données Il est possible de filtrer l'affichage d'un fichier TXT ou ASC grâce à la commande Filtrage du menu Outils (disponible aussi par menu contextuel ). Remarque : L'opération de filtrage n'altère pas le fichier original, un nouveau document intitulé "NomFichierOriginal_Filtrage.TXT (ou.asc)" est créé et affiché dans l'application. Il est possible de filtrer à nouveau un document déjà filtré. Filtrage.TXT Filtrage.ASC Filtre Horaire : Définit en secondes une plage d'évènements à afficher. Par défaut, les deux champs sont initialisés aux valeurs extrêmes des datations observées dans le fichier. Filtre Type: Définit les type de trames à faire apparaître (CAN et/ou LIN). Filtre Identificateur : Permet de choisir un ou plusieurs identificateurs à afficher. Il est possible de définir les groupes d'identificateur grâce aux opérateurs =, >, <,!= agissant sur l'identificateur saisi. Le symbole * permet de sélectionner toutes les trames. Filtre DLC : Permet de choisir un ou plusieurs identificateurs à afficher en fonction de la taille de leurs données. Il est possible de définir les groupes d'identificateur grâce aux opérateurs =, >, <,!= agissant sur la taille saisie. Le symbole * permet de sélectionner toutes les tailles. avril 2006 DUT-MUX-0159 /V2.2-11 -
VII.4 Changer la police de caractère La commande Police du menu Format permet de modifier l apparence du texte. (disponible aussi par menu contextuel ). La police de caractère, la taille du texte et la couleur de l entête peuvent aussi être modifiées. VII.5 Changer les couleurs La commande Couleur du menu Format permet de modifier la couleur des trames pour chaque canal ( disponible aussi par menu contextuel ). Cela permet une meilleure lisibilité pour les fichiers regroupés (contenant plusieurs canaux). VII.6 Impression Il est possible d imprimer les fichiers.txt et.asc grâce à l icône. Note : L impression garde les paramètres de police et de couleur. - 12 - DUT-MUX-0159 /V2.2 avril 2006
avril 2006 DUT-MUX-0159 /V2.2-13 -
VIII. Annexe : Exemple de fichier.txt Fichier «.TXT» - 14 - DUT-MUX-0159 /V2.2 avril 2006
IX. Annexe : Exemple de fichier.asc Fichier «.ASC» avril 2006 DUT-MUX-0159 /V2.2-15 -
Historique Version Auteur Date Modifications apportées 1.0 Valère FOREL 02/03/02 Version initiale 1.1 Cédric ROUSSET 18/06/02 Evolutions 2.0 Cédric ROUSSET 02/06/03 Corrections par rapport au 2 e bus CAN 2.1 CB 24/09/03 Changement de modèle 2.2 C. Gallay 25/04/06 Modification du logo - 16 - DUT-MUX-0159 /V2.2 avril 2006