Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Manuel de conception des scripts V1.2.x HILD Gérald – Manuel de conception des

Manuel de conception des scripts V1.2.x HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 2 sur 30 Sommaire I ) L’architecture du fichier de script ....................................................................................... 4 1-1) Généralités d’écriture ............................................................................................................... 4 1-2) Architecture générale................................................................................................................ 4 II) Le champ <CONNECTION> .............................................................................................. 5 2-1) La zone de configuration .......................................................................................................... 5 2-2) Le champ <COMMAND> ........................................................................................................ 6 III) Le champ <MENU=….>.................................................................................................... 8 3-1) La fenêtre de type CONFIRM ................................................................................................. 9 3-1-1) La zone de configuration .................................................................................................................... 9 3-1-2) Le champ <KWP>............................................................................................................................ 10 3-2) La fenêtre de type ONEVALUE ............................................................................................ 10 3-2-1) La zone de configuration .................................................................................................................. 10 3-2-2) Le champ <KWP>............................................................................................................................ 11 3-3) La fenêtre de type MULTIVALUE........................................................................................ 12 3-4-1) La zone de configuration .................................................................................................................. 13 3-4-2) Le champ <KWP>............................................................................................................................ 13 3-4) La fenêtre de type GRID......................................................................................................... 15 3-4-1) La zone de configuration................................................................................................................ 15 3-4-2) Le champ <CLICK>....................................................................................................................... 16 3-4-3) Le champ <KWP> .......................................................................................................................... 26 IV) Le champ <EXMENU= ….>............................................................................................ 29 HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 3 sur 30 Introduction Le logiciel DiagKWP utilise pour diagnostiquer un fichier de configuration. Ce fichier permet de configurer les menus apparents mais aussi les fenêtres qui peuvent apparaître. Ce document vous explique en détail comment rédiger un script de diagnostique valide pour le programme. HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 4 sur 30 I ) L’architecture du fichier de script 1-1) Généralités d’écriture Les fichiers de script doivent impérativement être placés dans le répertoire « vehicule » du logiciel. Il a pour extension « .veh ». Il a une architecture très proche du XML avec des balises qui ouvre un champ et d’autre qui les referment. Vous pouvez sauter des lignes, ajouter des commentaires par les doubles //. Exemple : // all this command must send at the begining of the connection <COMMAND> REPEAT=0; <KWP> CDE=12 01 00; // on cherche le nombre d'IOU TR=[1]/VAR=1; // on place la valeur dans la variable numéro 1 </KWP> </COMMAND> Dans cet exemple, nous voyons que nous commençons un champ COMMAND, à l’intérieur, il y a une instruction et il y a un champ KWP avec d’autres instructions. Le premier champ KWP est fermé par <\KWP> et le champ COMMAND doit être fermé par le champ <\COMMAND> Les // permettent de placer derrière des commentaires ou en première ligne. Toutes les lignes d’instruction doivent être finies par un « ; ». C’est impératif. A la fin des champs, il ne faut pas mettre de point virgule. 1-2) Architecture générale Tous les scripts doivent contenir : • Un champ <CONNECTION> : Ce champ donne les opérations à effectuer pour se connecter et les actions à effectuer après la réussite de la connexion mais avant de donner la main à l’utilisateur. • Un ou plusieurs champs <MENU> ou <EXMENU> Ce sont les champs qui donnent les instructions à exécuter lorsque l’on clique sur le menu. Ils définissent les actions mais aussi les différentes traductions des retours du calculateur. HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 5 sur 30 II) Le champ <CONNECTION> Le champ <CONNECTION> est défini par une zone de configuration et un ou plusieurs champs de commandes Exemple : <CONNECTION> // Début de la zone de configuration INIT=5Baud; ECU_ID=E6; TOOL_ID=F0; SPEED=10400; // // Fin de la zone de configuration <COMMAND> REPEAT=0; <KWP> CDE=12 01 00; TR=[1]/VAR=1; </KWP> </COMMAND> <COMMAND> REPEAT=0; <KWP> CDE=12 07 00 01; TR=[4-19]/TABLE=1; </KWP> </COMMAND> <\CONNECTION> 2-1) La zone de configuration La zone de configuration permet de régler les paramètres indispensables d’une connexion ISO 9141 ou 14230. Elle contient les instructions suivantes : • INIT=5Baud; Cette instruction permet de configurer le mode de connexion à utiliser pour se connecter au calculateur. Il peut prendre pour valeur : o 5Baud : Le logiciel va effectuer une connexion à l’aide du code à 5 baud défini dans la norme ISO 9141 o FAST : Le logiciel va se connecter en respectant la procédure de connexion rapide. HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 6 sur 30 • ECU_ID=E6; Cette instruction permet de fixer l’adresse du calculateur à diagnostiquer. La valeur est écrite en hexadécimal. Elle est donnée par la documentation constructeur. • TOOL_ID=F0; Cette instruction permet de fixer l’adresse du logiciel de diagnostique. La valeur est écrite en hexadécimal. Elle est donnée par la documentation constructeur. • SPEED=10400; Cette instruction permet de fixer la vitesse à adopter après une connexion réussie. La valeur est donnée en bauds. La valeur de 10400 baud est la vitesse normale donnée par la norme. Elle n’est donc pas à changer 2-2) Le champ <COMMAND> Ce champ permet d’exécuter une ou plusieurs commandes dans le but de mémoriser des informations qui pourront servir pour l’affichage ou dans la condition de répétition de menu du champ <EXMENU=…> Il est formé comme dans l’exemple suivant : <COMMAND> REPEAT=0; COND=[3]/=1; // on répète l'opération tant que l'octet n°3 est = à 1 <KWP> CDE=12 07 81; // on récupère les noms des entrées sortie TR=[4-19]/TABLE=1; // on place la valeur dans la TABLE numéro 1 </KWP> </COMMAND> • REPEAT=0 ; Cette instruction permet de configurer la période de répétition inconditionnelle des commandes des champs <KWP>. Dans ce cas, la valeur est nulle de manière à n’exécuter la/ les commandes qu’une seule fois. Sinon, la valeur est indiquée en ms. Ce délai représente le délai d’attente entre la dernière commande et la première à recommencer. • COND=[3]/=1 Cette instruction indique que la (les) commande KWP doivent être exécuter tant que la valeur entre crochet est égale à 1. HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 7 sur 30 • KWP Le champ KWP contient la commande à exécuter et la (les) façon de traduire les valeurs renvoyées par le calculateur. Le champ <KWP> contenu dans un champ <COMMAND> ne fait JAMAIS de référence à une valeur à afficher. Il est différent en ce sens d’un champ <KWP> contenu dans les champs <MENU=….> Le champ <KWP> contient les informations suivantes : o CDE=12 07 81 ; Cette instruction est la commande à envoyer au calculateur. Les valeurs sont obligatoirement séparées par des espaces. Toutes les valeurs sont écrites en hexadécimal. o TR=[4-19]/TABLE=1 ; L’instruction TR= est la ligne qui explique au logiciel que faire des données renvoyées par le calculateur. Dans le champ KWP d’un champ COMMAND, les seules actions possibles sont de mémoriser les données dans une table ou dans une variable. TABLE= Le logiciel possède 9 tables de texte numérotées de 1 à 9. Ces tables permettent de mémoriser une liste de texte que peut envoyer un calculateur. Dans l’exemple, le calculateur revoie le nom de ses entrées et de ses sorties. A chaque fois que la commande est envoyée, le calculateur répond par un nom d’une entrée qui est mémorisé dans la table n°1 les une à la suite des autres. VAR= Le logiciel possède 9 variables entières. Elles sont là pour mémoriser une valeur Le caractère / Dans les lignes d’instructions, il permet de séparer les données ou instruction. Dans cet exemple, on sépare [4-19] de TABLE=. [4-19] Les valeurs contenu entre crochet doivent toujours être placée juste après la commande TR=. Il permet au programme d’interpréter la valeur renvoyée par le calculateur qui peut être contenu dans une plage d’octets ou une plage de bits. Dans cet exemple, on place dans la TABLE n°1, les octets N°4 à 19 qui représente des codes ASCII. Mais cet exemple est simple. La traduction peut être plus complexe comme celle-ci : R5[8|5-7]L : • R5 défini que l’on doit répéter la traduction sur tous les octets de la trame en partant de l’octet n°5 et ceci jusqu’à la fin de la trame reçu. • [8|5-7] défini une plage de bit dans un octet. Donc on récupère la valeur contenu dans l’octet 8, sur la plage de bit de 5 à 7. • L indique que les octets sont écris en mode Octet de poids faible puis octet de poids fort. L’inverse est le mode par défaut, on n’indique rien, sinon, on le précise par H. HILD Gérald – Manuel de conception des scripts édition du 10/05/2009 Page 8 sur 30 III) Le champ <MENU=….> Le champ menu permet d’indiquer au programme la ou les actions à exécuter par le logiciel. Ici, tout est défini pour l’affichage au contraire des ligne de traduction de <COMMAND>. Exemple : <MENU=Lecture-ecriture de liste de parametres> ICO=8; TYPE=MULTIVALUE; TITLE=Lecture d'une liste de parametres EEPROM; REPEAT=0; LABEL_READ=Lecture; LABEL_WRITE=Ecriture; <KWP> CDE_READ=L21 40; CDE_WRITE=L3B 40; TR=[1-64]L/TX=VALUE; </KWP> </MENU> Tous les champs <MENU=..> contiennent toujours les informations suivantes : • ICO=.. ; Cette instruction permet de définir l’icône associée au menu. Ils sont au nombre de 10 numérotés de 0 à 9. L’icône a pour numéro 0 L’icône a pour numéro 1 L’icône a pour numéro 2 L’icône a pour numéro 3 L’icône a pour numéro 4 L’icône a pour numéro 5 L’icône a pour numéro 6 L’icône uploads/Ingenierie_Lourd/ manuel-de-conception-des-scripts-v1-2-x.pdf