Q-ASN.1: travaillez en toute simplicité avec l’ASN.1 !

L’interface de selection des grammaires compilées.

Cet onglet présente de l’intérêt si vous y avez ajouté vos grammaire ASN.1. Pour ce faire, il vous faudra recompiler l’outil en y intégrant quelques changements. La liste des grammaires compilées se trouve dans le fichier source «ASN1_Qt_gui/UI_GrammarComp.cpp », fonction MakeCompGrammarPane(), ajoutez le nom de votre grammaire à la liste du Combo Box.

Ensuite, dans le fichier «ASN1_Qt_gui/UI_Main.cpp », la fonction CompToObj() devra être étendue avec un appel à la fonction retournant votre structure ASN.1.

Sur l’interface graphique, cliquer sur la flèche vous envoi directement à l’éditeur ASN.1 (quatrième onglet), qui contient maintenant la structure sélectionnée.

L’interface d’édition de grammaire ASN.1.

Celui-ci permet de composer sa structure ASN.1 facilement. Il est nécessaire de connaître un minimum le standard ASN.1 avant de commencer. La structure écrite, plusieurs possibilités s’ offrent à vous:

• charger/sauvegarder, comme leur noms l’indiquent, permettent de sauver votre travail dans un fichier externe. Q-ASN.1 ne sauvegardera rien lui-même.
• convertir en JavaScript. Si la grammaire est correctement lue, il est résultera un script JavaScript qui s’ouvrira directement dans le troisième onglet. S’il y a des erreurs, l’utilisateur sera notifié et renvoyé au script ASN.1 pour correction.
• convertir en C++. Le mécanisme de vérification de la grammaire est le même que pour JavaScript. Si tout est correct, Q-ASN.1 proposera de sauvegarder un fichier C++ réutilisable par ASN1_lib.dll ou par Q-ASN.1.
• la flèche envoi directement l’utilisateur à l’éditeur ASN.1 (quatrième onglet), sans passer par l’étape JavaScript, si la grammaire ne contient pas d’erreur. Derrière la scène, l’outil utilise tout de même JavaScript, mais il peut être pratique de sauter cette étape.

L’interface d’édition de script JavaScript.

L’affichage du code JavaScript peut paraître peu utile au premier abord, mais celui-ci possède deux avantages :

• il est possible de le debugger
• il permet de remplir les données de la structure créée. Le langage ASN.1 possède bien une manière de le faire, mais l’éditeur ASN.1 de cet outil ne supporte pas ces fonctionnalités.

Le panneau de gauche résume les fonctions supportées, avec une description. Il est en effet possible d’écrire directement sa grammaire ASN.1 en JavaScript, plutôt qu’en ASN.1. Cela permet d’être plus proche du code C++, et de debugger, bien que cela ne soit pas très intéressant si on s’en tient à ça : le compilateur ASN.1 génère le script lui-même, et si le script est généré, c’est qu’il n’y a (en théorie) pas d’erreur.

Il est à noter que les propriétés ASN.1 de l’objet structure ne peuvent être modifiées après sa génération (par exemple le tag, l’ordre des objets dans un SEQUENCE). C’est logique puisque la structure est statique. Seules les données changent. En d’autres termes : Un noeud INTEGER ne pourra pas être changé en noeud REAL (il faut régénérer la grammaire si c’est le souhait de l’utilisateur), mais sa valeur pour effectivement passer d’un entier à un autre.

Là ou JavaScript devient donc intéressant, c’est pour remplir ces données. Ce travail fastidieux peut être grandement simplifié par un script.

Lorsque la grammaire est générée, il en résulte un seul objet, la racine de la structure, à partir de laquelle il est possible d’appeler les fonctions « set ».

Les valeurs peuvent ainsi être sauvegardées dans le fichier JavaScript, et réutilisées. L’utilisateur a également la possibilité d’utiliser les fonctionnalités du JavaScript, comme les boucles, conditions, ou même d’y inclure son propre code.

Un point essentiel ici, il ne faut pas oublier d’appeler la fonction registerGrammar() sur le noeud racine. En effet, celui-ci sera le noeud affiché à la racine d’arbre dans l’onglet suivant !

Le debugger JavaScript de Qt peut être lié au besoin avant l’exécution des scripts, en cliquant sur l’option sous la petite roue dans la barre d’action.

Deux boutons d’exécution existent :

• la « flèche », qui instancie un nouveau moteur JavaScript, et donc efface toutes les données des scripts précédents
• le « plus », qui exécute un script additionnel, en conservant les données des scripts précédents. Cela permet, par exemple, d’exécuter un script pour générer la grammaire, puis d’exécuter des scripts additionnels pour remplir des données sur la structure.

Pour un moteur JavaScript, il ne peut y avoir qu’un noeud racine, et donc une seule structure. Celle-ci peut en revanche être réutilisée pour lui appliquer de nouvelles données.

Après l’exécution d’un script, s’il n’y a pas eu d’erreur, l’utilisateur est dirigé vers le quatrième onglet.

Fenêtre d’édition pour un noeud INTEGER.

Cet éditeur sous forme d’arbre est bien un éditeur de données. Il n’est en aucun cas possible de changer la structure des données. Un INTEGER ne pourra pas être transformé en REAL, et son TAG ne pourra pas être changé. Tout comme les objets d’un SEQUENCE ne pourront être réordonnés ou supprimés.

La structure est bien figée à cette étape, seules les données variables peuvent être modifiées. Pour modifier la structure, il faut revenir aux étapes précédentes.

Il est ainsi possible dans l’arbre de :

• changer une valeur. Par exemple, un IA5String peut être modifié pour passer de « aaa » à « bbb »
• ignorer un noeud optionnel. En effet, si la grammaire accepte que le noeud soit présent ou non (OPTIONAL), la structure n’est pas modifiée, il s’agit en quelque sorte d’une valeur « nulle ».
• ajouter des objets aux SEQUENCE OF. Ici encore, l’ajout d’objet ne modifie pas la structure de données, qui elle indique une liste, sans en préciser le nombre d’éléments. Le nombre d’éléments ainsi que leur valeurs sont bien des données.
• réordonner les éléments dans un SEQUENCE OF
• choisir le choix pour un CHOICE
• remplir le champ « description », qui n’est pas lié au standard ASN.1 et ne sera pas sérialisé. Il peut cependant faciliter le travail de l’utilisateur, par exemple en affichant de manière claire à quoi correspond le noeud.

La fenêtre se compose de deux panneaux. A gauche, l’arbre, et à droite, un champ de texte.

Le champ de texte ne peut contenir que des caractères hexadécimaux. Il affichera la sortie de sérialisation, mais servira également d’entrée pour la désérialisation. Il convient donc de prendre soin de copier ses données dans un éditeur de texte externe pour éviter les écrasements. Dans la barre d’action, un menu propose d’ouvrir un fichier contenant de l’hexadécimal, ou de sauvegarder le contenu du champ.

Pour sérialiser, il faut cliquer sur l’action correspondante (la petite feuille avec du binaire). Tout l’arbre est sérialisé et le résultat s’affiche dans le champ texte. Il est possible de ne sérialiser qu’une branche de l’arbre par un clic droit sur un noeud de l’arbre, en sélectionnant l’action pour sérialiser à partir de ce noeud.

Pour désérialiser, il faut cliquer sur le livre dans la barre d’action. Le contenu du champ texte est alors lu par l’arbre qui va tenter d’en extraire les données. Cette opération peut échouer si le contenu lu n’a pas été généré par la même structure de données, et peut donc renvoyer une erreur. Si l’opération est un succès, les valeurs lues sont directement visible dans l’arbre. De la même manière que pour la sérialisation, il est possible de ne lire qu’à partir d’une branche. Le champ texte ne doit alors contenir que le contenu attendu par la branche.

L’ASN.1 travaillant avec des octets (deux chiffres hexadécimaux), si le champ texte comporte un nombre impair de caractères, il sera proposé à l’utilisateur d’ajouter un 0 au début (ce 0 n’a pas pour but de rendre la valeur correcte. Seulement la rendre utilisable. Mais il y a de fortes chances que ça ne fonctionne pas, et que la valeur ait été partiellement effacée…)

La troisième action (les deux fichiers avec les flèches), permet de comparer le contenu du champ texte avec le contenu de l’arbre. Ni l’arbre ni le champ texte ne seront modifiés. Si les deux sont égaux, un petit message l’indique dans la barre d’état en bas de la fenêtre. Si la comparaison trouve des différences, elles seront indiquées dans une fenêtre pop-up.

La boîte à outil permet de calculer rapidement le résultat d’une conversion « type ASN.1 » vers hexadécimal ou vice versa, sans avoir à passer par une grammaire. Ici, seule la valeur est convertie, il n’y a ni tag, ni longueur. Il n’est pas possible de convertir des noeuds complexes, puisque ceux-ci nécessiteraient une grammaire pour les définir…

L’arbre propose plusieurs fonctionnalités :

• la recherche. Si la checkbox contenu n’est pas sélectionnée, la valeur sera recherchée dans le nom, tag et description. Ceci permet par exemple, si on recherche un tag en particulier, disons ’81’, de ne pas le noyer dans les données, qui pourraient contenir de multiples fois ’81’, sans que ça n’ait de rapport avec le tag recherché.
• afficher ou cacher les noeuds CHOICE. En effet, si l’utilisateur ne souhaite pas modifier les CHOICE, ceux-ci peuvent devenir encombrants et compliquer la lecture. Cette option les cache, mais les noeuds restent bien présents, et toujours éditables si on les ré-affiche.
• étendre ou réduire l’arbre
• exécuter des actions spécifiques à chaque noeud. Les actions des SEQUENCE OF et CHOICE possèdent des raccourcis dans le panneau gauche de l’arbre, si un noeud d’un de ces types est sélectionne. Ces actions sont aussi accessible par clic droit sur un de ces noeuds dans l’arbre. Le CHOICE propose de choisir un élément parmi sa liste de choix. Le SEQUENCE OF permet de déplacer un noeud de sa liste vers le haut ou le bas, de le supprimer, ou d’en ajouter un.

En double cliquant sur un noeud dans l’arbre, on ouvre la fenêtre d’édition de la valeur. S’il s’agit d’un CHOICE ou d’un SEQUENCE OF, les actions citées ci-dessus sont retrouvées ici. Pour les autres types, il y aura un champ pour éditer leur valeur, qui sera différent en fonction du type. Il n’est pas possible de modifier directement la valeur en hexadécimal. Pour les noeuds optionnels, la checkbox ’ignorer la valeur’, la retirera lors de la sérialisation. Les liens vers les noeuds enfants ou parent permettent une visualisation en lecture seulement, pour les éditer, il faut les ouvrir directement depuis l’arbre.

Enfin, par un clic droit sur un noeud, un menu propose un raccourci vers l’outil de conversion correspondant au type de noeud. La valeur du noeud n’est pas affectée par ce que l’utilisateur saisi dans le convertisseur, il ne s’agit que d’un raccourci qui peut s’avérer pratique.