Académique Documents
Professionnel Documents
Culture Documents
Romain DÉOUX
Maître de stage : Christian PERROT
Tutrice enseignante : Isabelle JACQUES
1/46
Remerciements
Mes premiers remerciements vont à l'entreprise Parkeon qui a bien voulu m'accorder
l'opportunité d'accomplir mon stage de fin d'année au sein de leur établissement.
2/46
Sommaire
Remerciements.........................................................................................2
Sommaire................................................................................................3
Introduction.............................................................................................5
1. L'entreprise..........................................................................................6
1.1. Présentation...................................................................................6
2. Contexte de travail.................................................................................7
2.1. Méthodologies.................................................................................7
2.1.1. Méthodes Agiles..........................................................................7
2.1.2. Stand Up meeting.......................................................................8
2.1.3. Revues de code..........................................................................8
2.1.4. Démonstrations..........................................................................8
2.2. Aspects techniques...........................................................................8
2.2.1. Java........................................................................................9
2.2.2. Développement conventionnel assisté par CheckStyle............................9
2.2.3. Tests unitaires avec JUnit............................................................10
2.2.4. Plateforme commune sous Maven...................................................11
2.2.5. Journalisation avec log4j.............................................................11
2.2.6. Contrôle de version avec Subversion...............................................12
2.2.7. Gestion de projet avec Trac..........................................................13
2.2.8. Intégration continue avec Hudson...................................................14
3. États de l'art.......................................................................................15
3.1. Cartes magnétiques.........................................................................15
3.2. CCS 2005 TPX KGB®.........................................................................16
3.2.1. Configuration de la connexion.......................................................16
3.2.2. Définition du protocole...............................................................16
3.2.2.1. Messages courts...................................................................16
3.2.2.2. Messages longs : Généralités...................................................17
3.2.2.3. Messages de configuration et de statut.......................................18
3.2.2.4. Messages opératifs ou exécutables............................................18
3.3. Exemple synthétique........................................................................18
4. Réalisation.........................................................................................20
4.1. Développement modulaire.................................................................20
4.2. Développement du cœur de métier......................................................20
4.2.1. Structures de données................................................................20
4.2.2. Codage/Décodage.....................................................................21
4.3. Développement du pilote..................................................................21
4.3.1. Possibilités offertes....................................................................21
4.3.2. Principe de fonctionnement de la méthode send()...............................22
4.3.3. Défaut de conception : Encodage et décodage des messages..................23
4.4. Développement de l'interface utilisateur................................................23
4.4.1. Possibilités offertes....................................................................23
4.4.2. Défauts de conception................................................................24
4.4.2.1. Acquisition du statut.............................................................24
4.4.2.2. Liens forts.........................................................................25
4.5. Produit fini....................................................................................25
5. Conclusion..........................................................................................26
6. Glossaire............................................................................................27
7. Netographie........................................................................................28
8. Annexes.............................................................................................29
3/46
8.1. Annexe 1 : Description des formats de pistes...........................................29
8.1.1. Format IATA.............................................................................29
8.1.2. Format ABA.............................................................................29
8.1.3. Format THRIFT-TTS....................................................................30
8.2. Annexe 2 : Liste des messages courts....................................................32
8.3. Annexe 3 : Format des trames des messages long......................................33
8.4. Annexe 4 : Algorithme d'un calcul de somme de contrôle LRC.......................34
8.5. Annexe 5 : Liste des messages longs utilisés............................................35
8.5.1. Récupération du statut...............................................................35
8.5.2. Récupération du résultat de la dernière opération..............................35
8.5.3. Récupération des données de la carte.............................................36
8.5.4. Réinitialisation des erreurs du système............................................37
8.5.5. Récupération du statut complet.....................................................37
8.5.6. Évacuation des cartes.................................................................40
8.6. Annexe 6 : Structure d'un message opératif.............................................41
8.7. Annexe 7 : Exemple de scénario d'utilisation du CCS 2005 TXP KGB®..............42
8.8. Annexe 8 : Diagramme de classe de la classe Driver...................................44
8.9. Annexe 9 : Diagramme des classes du noyau............................................45
Résumé.................................................................................................46
8.10. Mots-clés....................................................................................46
Abstract................................................................................................46
8.11. Keywords....................................................................................46
4/46
Introduction
La licence professionnelle Systèmes Informatiques et Logiciels (S.I.L.) option
Conception et Développement Orienté Objet d'Applications Multi-tiers (C.D.O.O.A.M.)
dispensée au département informatique de l'Université de Franche-Comté des Sciences
et Techniques m'a offert l'opportunité d'accomplir un stage d'une durée de trois mois du
8 mars au 7 juin 2010 au sein d'une entreprise.
De renommée internationale, la société Parkeon s'impose comme un acteur clé dans le
secteur de la mobilité urbaine. Elle se spécialise notamment dans la conception de
solutions de stationnement de voirie et d'ouvrage ainsi que dans la mise en place de
systèmes de billettique pour les transports en commun.
Son service de développement conçoit des applications permettant un
fonctionnement, une gestion et un audit efficaces du matériel produit aussi bien pour
l'entreprise que pour leurs nombreux clients. Le projet ArchiPEL constitue l'un des
derniers projets en date de ce service. Conçu dans le but de gérer les transactions de
paiement électronique, ce projet est encore en cours de développement.
C'est donc au sein du service de développement de l'entreprise Parkeon que j'ai eu
l'opportunité d'accomplir ce stage.
L'utilisation de cartes bancaires dans le processus de paiement fait apparaître la
nécessité pour le service « Intégration et AQP » d'encoder des cartes bancaires à des fins
de test du produit. C'est dans cette optique que m'a été confié le développement d'un
pilote capable de générer les pistes magnétiques d'une carte bancaire et de les encoder
sur des cartes de test via un appareil de lecture et d'encodage de cartes : le CCS 2005
TPX KGB®.
Le développement concerne donc la manipulation desdites pistes dans le respect des
normes imposées, la gestion de matériel via une liaison série et l'interfaçage avec
l'utilisateur. Une analyse préalable des spécifications des formats de pistes et du
protocole de liaison avec le matériel a donc été nécessaire.
En premier lieu, je présenterai brièvement l'entreprise Parkeon. Je développerai
ensuite le contexte de travail dans lequel j'ai évolué. L'état de l'art sera alors détaillé et
j'exposerai le travail que j'ai réalisé. Je clorai ce rapport par une conclusion.
5/46
1. L'entreprise
1.1. Présentation
6/46
2. Contexte de travail
2.1. Méthodologies
Mon stage au sein de l'entreprise Parkeon m'a permis de prendre connaissance et
d'appliquer un ensemble de nouvelles méthodologies de travail auxquelles je n'avais
jamais été confronté. Ces méthodologies s'inspirent des méthodes Agiles.
De multiples réunions de travail collectives et individuelles ont facilité le bon
déroulement du projet. Il s'agit des Stand Up meeting, des revues de code et des
démonstrations.
Dans cette partie, je développerai donc le concept de méthodes Agiles ainsi que les
différentes réunions précédemment citées.
7/46
• L'équipe cherche régulièrement à devenir plus efficace et adapte son
comportement dans ce but.
Les deux méthodes les plus répandues en France sont la méthode Scrum (1996) et la
méthode XP pour eXtreme Programming (1999).
L'équipe du service « R&D » n'applique pas systématiquement tous les dogmes décrits
dans Scrum et XP. Par exemple, la programmation en binôme se fait à chaque fois que
c'est utile, mais dans le cas contraire, chaque développeur travaille seul. Une certaine
souplesse est ainsi retenue.
2.1.4. Démonstrations
Durant toute la durée du stage, des réunions ont été fixées entre Mike Andrzejewski,
Christian Perrot, Nicolas Vacelet et moi afin de s'assurer que le projet ne prenne pas une
direction autre que celle initialement déterminée. Dans la mesure des possibilités et
disponibilités, une mise en situation du produit stable participait à l'appréciation de son
état d'avancement et de sa qualité.
Ces réunions d'une trentaine de minutes étaient pour moi l'occasion de présenter l'état
d'avancement du projet de manière plus approfondie. Des conseils avisés ont alors été
donnés quant à l'exploitation de technologies et de méthodologies que j'ignorais à ce
jour.
8/46
• Le projet doit suivre la méthode XP telle qu'elle est pratiquée par le service
« R&D ». Le projet dispose notamment d'un ensemble de tests développés via la
bibliothèque JUnit et d'un système de journalisation permettant un débogage plus
simple grâce à la bibliothèque log4j.
• Le projet doit, comme n'importe quel projet faisant partie d'ArchiPEL, être
accessible en cours de développement d'une part mais aussi facilement
compilable et déployable d'autre part.
La première condition est assurée via le système de contrôle de version
Subversion tandis que la seconde utilise la plateforme Maven.
• Enfin, mon projet doit, avec les autres projets, bénéficier d'un suivi et être
continuellement intégré au projet ArchiPEL.
Le suivi se fait ici grâce au logiciel Trac et l'intégration via Hudson.
Cette partie décrit la liste des technologies énumérées ici.
2.2.1. Java
La majorité du code développé par l'équipe du service « R&D » a été écrit en langage
Java.
Java est un langage orienté objets dont la compilation du code source produit un code
exécutable par la machine virtuelle Java (JVM). Ce code, appelé Java bytecode, permet
une exécution uniforme sur n'importe quelle plateforme exécutant la JVM tout en
conservant une rapidité supérieure aux langages de script comme Ruby ou PHP. Java
dispose d'une bibliothèque de classes standards et de classes utilitaires largement
fournie. Cela favorise évidemment la productivité.
C'est pour des raisons évidentes d'homogénéité et de réutilisation du code qu'il m'a
donc été demandé de développer dans ce langage la réalisation de mon projet. Ce
dernier s'intègre en effet à un vaste ensemble d'utilitaires faisant eux même partie d'un
projet plus conséquent : le projet ArchiPEL.
Afin d'accroitre la productivité, un environnement de développement intégré (ou EDI)
est souhaitable. J'ai choisi NetBeans. Cet EDI est développé par Sun Microsystems :
l'entreprise fondatrice du langage Java. Il est unanimement reconnu et utilisé par
l'ensemble du service « R&D ».
Netbeans fournit un ensemble d'outils permettant un développement plus aisé. Il
permet notamment de formater le code d'après la convention d'écriture propre à Java.
Néanmoins, cette convention est encore trop souple face aux besoins d'uniformisation du
projet. J'ai donc du installer un greffon supplémentaire à Netbeans pour répondre au
mieux à ce besoin.
9/46
Par exemple, il m'a été demandé de développer des méthodes dont la longueur ne
devait pas dépasser la hauteur du moniteur. Cela garantie une appréciation rapide en un
regard du contenu des méthodes et facilite également leur lecture. Cela fait donc partie
du processus de qualité du code auquel j'ai du m'astreindre.
Ce besoin d'une convention de nommage stricte est une pratique d'XP. En effet, XP
affirme que, puisque tous les développeurs interviennent sur le code source, l'utilisation
d'une convention de nommage est indispensable.
La méthode XP contraint donc le développeur à produire du code propre. Mais cela ne
se limite pas seulement à la forme. Comme gage de qualité vis-à-vis du fond, cette
méthode impose de développer prioritairement les tests unitaires avant d'écrire le code
fonctionnel.
10/46
2.2.4. Plateforme commune sous Maven
Hébergé par la fondation Apache, Maven est un outil permettant de compiler et gérer
un ensemble de projets Java organisés dans une arborescence. Chaque projet, dont le
mien, contient un fichier de configuration pom.xml au format XML spécifiant un
ensemble de paramètres dont le nom du projet, la version, l'identifiant de
l'arborescence de projets, l'identifiant du projet, ses dépendances, les serveurs desquels
elles peuvent être récupérées, etc.
Une fois ce fichier de configuration mis en place, le processus de compilation se
trouve grandement simplifié. Maven permet ainsi de :
• Nettoyer le répertoire du projet de ses fichiers générés : Java bytecode, archives
JAR et documentations. (mvn clean)
• Compiler l'ensemble du projet et exécuter les tests unitaires afin de s'assurer que
le nouveau code produit ne comporte pas d'erreurs et qu'il n'y a pas eu de
régression. (mvn test)
• Extraire la documentation à partir du code source. (mvn site)
• Compiler le projet, exécuter les tests unitaires et, si ces tests se déroulent sans
erreurs, copier les archives du projet compilé et des sources dans le dépôt local
de dépendances. (mvn install)
Mon projet fait partie de l'arborescence Maven du projet ArchiPEL, dans un répertoire
dédié aux utilitaires.
12/46
Un système de contrôle de version permet de stocker des données tout en conservant
l'ensemble des modifications qui auront été apportées depuis la mise en place du dépôt.
Subversion conserve donc un historique des fichiers et dossiers ajoutés, supprimés ou
modifiés. Il implémente notamment un système de commentaire de chaque mise à jour
du dépôt, un système de méta données permettant notamment de définir des exceptions
parmi les fichiers et dossiers à prendre en charge ainsi qu'un générateur de fichiers de
différences entre une version et une autre destiné à créer des rustines entre lesdites
versions.
Son architecture centralisée garantie à tous les utilisateurs du système qu'ils
possèdent la dernière et véritable version du projet hébergé.
Subversion permet notamment de :
• Récupérer le contenu d'un dépôt distant via son URL à n'importe quel numéro de
version (ou révision) de la première à la dernière, la révision par défaut étant la
dernière (HEAD).
• Mettre à jour le dépôt local à partir d'une version plus récente ou plus ancienne
que celle présente.
• Mettre à jour le dépôt distant à partir des modifications apportées localement. Le
numéro de version (ou révision) du dépôt distant est alors incrémenté. Comme
convenu, chaque nouvelle fonctionnalité apportée au code est immédiatement
suivie d'une mise à jour du dépôt distant.
• Annuler les modifications apportées localement. Les fichiers ajoutés sont
détruits, les fichiers supprimés sont restaurés et les fichiers modifiés sont écrasés
par leur version précédente. Cette fonctionnalité s'appuie sur des copies des
fichiers concernés dans des répertoires cachés. Il s'agit ni plus ni moins d'une
gestion de sauvegarde locale.
Cette fonctionnalité m'a été utile à des moments où je m'engageais dans des
solutions techniques inappropriées. Elle m'a alors permis de repartir sur une
version stable alors que le développement en cours prenais une direction sans
issue.
Cette solution de sauvegarde est intéressante dans le cas de petits projets. Mais dans
le cas de projets plus conséquents comme ArchiPEL, elle ne suffit plus. Les mise-à-jour
se succèdent et il n'est pas évident de s'y retrouver, surtout en ligne de commande. C'est
pourquoi un gestionnaire de projet a été mis en place. Les mise-à-jour du code sont
toujours disponible mais le tout est plus facilement gérable.
14/46
3. États de l'art
Le développement du projet a nécessité une étude préalable des différents
composants tiers entrant en jeu. Il s'agit notamment du format des cartes magnétiques
manipulées et du protocole de liaison du CCS 2005 TPX KGB®
16/46
• Informer l'ordinateur de l'état courant du périphérique. Le périphérique peut en
effet être prêt, en attente de carte ou en insertion de carte. Ce genre de
message est émis une fois toutes les secondes sauf dans le cas de l'insertion d'une
carte ou il est émis une seule fois au moment de l'insertion.
• Témoigner de la validité et de la viabilité des requêtes de l'ordinateur sur le
périphérique. À chaque requête de la part de l'ordinateur, un message émis par le
périphérique s'acquitte de la validité de la trame contenant le message. Ensuite,
si la trame semble valide, un second message est émis et s'acquitte de la viabilité
de la requête.
La nature des messages courts dépend de la valeur de l'octet émis. Le tableau 2 de
l'annexe 2 fournit la liste de correspondance entre les valeurs de l'octet émis, la nature
du message et sa périodicité.
Voici un exemple d'utilisation des messages courts mettant en scène l'envoi d'une
requête par l'ordinateur :
1. Réception par l'ordinateur d'une série d'octets à chaque seconde signalant que le
périphérique est prêt. (messages courts)
2. Envoi d'une requête de la part de l'ordinateur. (message long)
3. Réception par l'ordinateur d'un message court d'acquittement pour signaler que le
message est correctement formé.
4. Réception par l'ordinateur d'un autre message court d'acquittement pour signaler
que la requête est acceptée.
5. En fonction de la requête…
1. Si la requête requiert une réponse, réception de cette réponse. (message long)
2. Sinon, s'il s'agit d'une demande d'encodage ou de décodage avec insertion de la
carte depuis la façade avant en attente, réception d'une série de messages
courts d'attente d'insertion d'une carte.
3. Sinon, réception d'une série de messages courts de statut « Prêt » ou
« Dernière opération terminée ».
17/46
Les messages de configuration et de statut sont des messages de taille fixés à quatre
octets (trame exclue) pouvant requérir une réponse de la part du périphérique.
Les messages opératifs permettent d'effectuer des opérations de décodage,
d'encodage ou d'impression et ne requièrent pas de réponse.
18/46
Une fois cette piste générée, on peut constituer la requête d'encodage avec les
paramètres suivants :
• Insertion : attente avant
• Éjection : avant haut
• Pistes : 1
• Décodage : Désactivé
• Encodage : IATA
• Impression : Désactivée.
• Donnée supplémentaire : 51040B1234567890123445^DOE/J.^140110111235813
Cette requête est :
161102051040B1234567890123445^DOE/J.^140110111235813
Le tout s'encapsule alors dans une trame :
16 16 16 01 00 38 02 31 36 31 31 30 32 30 35 31 30 34 30 42 31 32
33 34 35 36 37 38 39 30 31 32 33 34 34 35 5E 44 4F 45 2F 4A 2E 5E
31 34 30 31 31 30 31 31 31 32 33 35 38 31 33 03 7D 04
Soit :
[DLE][DLE][DLE][SOH][RCL=0038][STX]161102051040B1234567890123445^DOE/J.^140110111235813[ETX][LRC=7D][EOT]
19/46
4. Réalisation
Pour répondre à la problématique de l'entreprise, j'ai développé une application
graphique capable de générer les trois pistes de cartes magnétiques et de les encoder à
l'aide du périphérique fourni.
Pour répondre à des besoins de testabilité et de clarté du code, j'ai développé le
projet en trois parties. Chaque partie est indépendante et peut donc être utilisée telle
quelle.
Cette partie du rapport développe certains points de la contribution que j'ai apporté à
ce projet après avoir préciser l'enjeu de chacun de ces trois modules.
20/46
Chaque piste possède un constructeur acceptant une liste variable de champs. Cette
signature permet une instanciation de la piste à partir d'un nombre éventuellement
restreint de champs et dans n'importe quel ordre.
Chaque piste est composée d'un objet de la classe TrackHandler dont le rôle est de
contenir les champs. C'est cette classe qui s'occupe de trier les champs admissibles par
la piste. En effet, tous les champs ne sont pas habilités à composer n'importe quelle
piste. Pour une meilleure utilisabilité, les pistes possèdent des accesseurs qui s'occupent
d'aller chercher les champs dans le TrackHandler et de les retourner en les transtypant
dans leur classe réelle. En effet, la classe TrackHandler utilise une collection pour
stocker les champs ; plus précisément, un mappage d'instances de Field.Type vers des
instances d'implémentations de Field correspondant (Map<Field.Type,Field>).
4.2.2. Codage/Décodage
Une fois la structure de donnée mise en place, j'ai du développer trois classes
utilitaires pour convertir les instances des classes Track1, Track2 et Track3 en pistes
brutes utilisables par le contrôleur mais également pour l'opération inverse : IATACodec,
ABACodec et THRIFTCodec.
Ces trois transcodeurs (ou codec) utilisent la classe standard java.io.ByteBuffer dans
leurs méthodes pour encoder ou pour décoder les pistes.
21/46
4.3.2. Principe de fonctionnement de la méthode send()
22/46
4.3.3. Défaut de conception : Encodage et décodage des messages
Un défaut de conception important à été relevé lors du développement du contrôleur
et a fait l'objet d'un remaniement du code. Il s'agit de l'encodage et du décodage des
messages logiques en trames brutes.
Dans un premier temps, j'ai développé une classe mère Message disposant d'une
méthode abstraite getFrame() destinée à retourner un ByteBuffer contenant le message
brut. Cette méthode était alors implémentée pour les classes filles (voir l'illustration 7).
23/46
3. Copie : En lisant les pistes d'une autre carte de paiement.
Un simple clic sur le bouton “Read” (voir l'illustration 9) provoque la lecture d'une carte et
le remplissage des champs bruts par le contenu de la piste.
24/46
4.4.2.2. Liens forts
Afin de faciliter le développement, j'ai d'abord choisi de déclarer une instance
statique du pilote dans la classe principale de l'application. Les composants faisant appel
à ce pilote pouvaient alors y accéder depuis n'importe quel emplacement du
programme.
Cette solution allait à l'encontre des principes de conception tels qu'ils sont appliqués
en XP. Elle impliquait en effet une relation forte des composants concernés à la classe
principale hébergeant le pilote. Une conception appropriée tend justement à éviter la
présence de ce type de lien.
Une opération de remaniement du code à donc été effectuée afin de faire passer le
pilote en tant qu'argument de père en fils lors de la création des composants.
25/46
5. Conclusion
À l'issue de l'accomplissement de trois mois de stage au sein de l'entreprise Parkeon,
j'aurai été capable de développer un pilote fonctionnel et testable en appliquant les
méthodes de travail pratiquées par l'équipe de développement.
Le cœur peut être retravaillé et réutilisé dans le cadre d'autre projets, graphiques,
semi-graphiques ou en ligne de commande. Il peut notamment être complété au niveau
du protocole pour gérer un plus grand jeu de messages. Des témoins d'erreur
supplémentaires placés dans des composants tels que des fenêtres surgissantes peuvent
enrichir l'application graphique existante. Une base de données pourrait également
stocker les pistes générées.
D'un point de vue technique, ce stage m'aura permis de mettre en pratique les
connaissances que j'ai pu acquérir au cours de la licence professionnelle SIL, notamment
vis-à-vis du langage Java omniprésent dans le projet développé. L'entreprise elle-même
m'a apporté des connaissances en méthodologies et technologies Java. J'ai su profiter
avec satisfaction et m'enrichir de l'expérience des personnes qui m'ont encadré,
développeurs ou non, et je les en remercie.
D'un point de vue humain et personnel, ce stage m'a pleinement satisfait en tous
points. J'ai eu la chance d'évoluer au sein d'une entreprise structurée avec un esprit de
compétitivité permanent lui permettant de pérenniser sa position de leader dans son
secteur d'activité tout en conservant une ambiance de travail d'équipe conviviale et je
suis parfaitement conscient de l'enrichissement que ce stage m'aura apporté. Je
conclurai donc en affirmant que je conseillerai vivement cette formation aux étudiants
désireux de suivre un stage de développeur d'application et que je mettrai un point
d'honneur à vanter les bénéfices remarquables que le stage de fin d'année peut apporter
pour monter en compétences professionnelles mais également pour la découverte
concrète du « monde du travail » grâce à cette période d'immersion en entreprise.
26/46
6. Glossaire
ABA (American Banking Association) : Format de la seconde piste magnétique d'une
carte de paiement.
AQP (Assurance Qualité Produit) : Processus visant à assurer aux clients la qualité du
produit qui leur sera livré.
BSD (Berkeley Software Distribution) : Désigne une famille de systèmes d'exploitation
UNIX, développés à l'Université de Californie à Berkeley.
Démon : Un démon est un programme s'exécutant en arrière plan plutôt que sous le
contrôle d'un utilisateur.
EDI : Environnement de Développement Intégré. En anglais : IDE pour Integrated
Development Environment.
IATA (International Air Transport Association) : Format de la première piste
magnétique d'une carte de paiement.
Java bytecode : Il s'agit du code semi-compilé produit par le compilateur Java.
JAR (Java Archive) : Archive compressée utilisée pour stocker l'ensemble des classes
et des fichiers de ressources d'un programme ou d'une librairie Java. Il s'agit ni plus ni
moins d'un fichier zip dont l'extension a été modifiée.
JVM (Java Virtual Machine) : Machine Virtuel Java. Il s'agit de l'environnement
d'exécution des programmes développés en Java. La JVM est la passerelle entre le Java
bytecode et le code exécutable.
LDAP (Lightweight Directory Access Protocol) : Décrit aussi bien un protocole de
service d'annuaire que la norme définissant le système dans son ensemble :
Représentation des données, nommage, sécurité, réplication, etc.
Licence BSD : Licence libre autorisant l'utilisation d'un logiciel dans un contexte de
logiciel libre ou propriétaire.
LRC (Longitudinal Redundancy Check) : Somme de contrôle simple. Son algorithme est
fourni en annexe.
Méthodes Agiles : Procédures de conception logicielle. Ces procédures ont la
particularité de privilégier au maximum l'efficacité de l'avancement et de la qualité du
projet en opposition aux méthodes traditionnelles jugées lourdes et obsolètes.
Open Source : Logiciel ou bibliothèque dont le code source est disponible. Ce code
source n'est pas nécessairement gratuit.
R&D (Research and Development) : Recherche et Développement.
Scrum :Terme emprunté au rugby signifiant mêlée et définissant une méthode Agile.
Son principal atout est la relation d'étroite coopération existant avec le client. Ce
dernier est directement impliqué dans la direction du développement du projet en
imposant notamment les ordres de priorité.
THRIFT-TTS : Format de la troisième piste magnétique d'une carte de paiement.
XP (eXtreme Programming) : Méthode Agile poussant à l'extrême des principes
simples. Par exemple, puisque l'intégration des modifications est importante, elle se fait
plusieurs fois par jour.
27/46
7. Netographie
Les informations à propos de l'entreprise Parkeon sont disponibles sur leur site
officiel :
[fr] http://www.parkeon.com/fr/
Une grande quantité d'informations à propos des méthodes Agiles est issue de
l'encyclopédie en ligne Wikipédia.
[fr] http://fr.wikipedia.org/wiki/Méthode_agile
[fr] http://fr.wikipedia.org/wiki/Scrum
[fr] http://fr.wikipedia.org/wiki/Extreme_programming
D'une manière générale, les informations de chaque technologie ont été récupérées
depuis l'encyclopédie Wikipédia ainsi que depuis les sites web officiels de ces
technologies.
28/46
8. Annexes
Format IATA
La carte ne peut dépasser 79 caractères.
1. STX (Start Sentinel) : Un caractère fixé à “%”.
2. FC (Format Code) : Code du format. Un caractère fixé à “B” pour les transactions
financières.
3. PAN (Primary Account Number) : Numéro de compte primaire. Entre 17 et 19
chiffres.
4. FS (Field Separator) : Séparateur de champs. Un caractère fixé à “^”.
5. CC (Country Code) : Code pays sur trois chiffres. Disponible uniquement si le
champ PAN commence par “59”.
6. NM (Name) : Nom du propriétaire de la carte entre 2 et 26 caractères.
7. FS (Field Separtor) : Séparateur de champs.
8. ED (Expiration Date) : Date d'expiration de la carte sous la forme “YYMM”. “YY”
représente les deux derniers chiffres de l'année. “MM” représente le mois sur
deux chiffres.
9. SC (Service Code) : Code service définit sur 3 chiffres. Chaque chiffre ayant une
signification différente.
10.DD (Discretionary Data) : Données discrétionnaires. Ces données sont à la charge
de l'entreprise qui délivre les cartes magnétiques.
11.ETX (End Sentinel) : Un caractère fixé à “?”.
12.LRC (Longitudinal Redundancy Check) : Somme de contrôle sur un octet.
Format ABA
La carte ne peut dépasser 40 caractères.
1. STX (Start Sentinel) : Un caractère fixé à “;”.
2. PAN (Primary Account Number) : Numéro de compte primaire.
3. FS (Field Separator) : Séparateur de champs. Un caractère fixé à “=”.
4. CC (Country Code) : Code pays sur trois chiffres. Disponible uniquement si le
champ PAN commence par “59”.
5. ED (Expiration Date) : Date d'expiration de la carte sous la forme “YYMM”. “YY”
représente les deux derniers chiffres de l'année. “MM” représente le mois sur
deux chiffres.
29/46
6. SC (Service Code) : Code service définit sur 3 chiffres. Chaque chiffre ayant une
signification différente.
7. DD (Discretionary Data) : Données discrétionnaires. Ces données sont à la charge
de l'entreprise qui délivre les cartes magnétiques.
8. ETX (End Sentinel) : Un caractère fixé à “?”.
9. LRC (Longitudinal Redundancy Check) : Somme de contrôle sur un octet.
Format THRIFT-TTS
La carte ne peut dépasser 107 caractères.
1. STX (Start Sentinel) : Un caractère fixé à “;”.
2. FC (Format Code) : Code format sur deux chiffres. Seuls les codes “01” et “02”
sont supportés.
3. PAN (Primary Account Number) : Numéro de compte primaire. Entre 17 et 19
chiffres.
4. FS (Field Separator) : Séparateur de champs. Un caractère fixé à “=”.
5. CC (Country Code) : Code pays sur trois chiffres.
6. CuC (Currency Code) : Code de la devise sur 3 chiffres.
7. CE (Currency Exponent) : Puissance de dix entre “0” et “5” par lequel les champs
AA et AR doivent être multipliés pour obtenir leur valeur réelle dans la monnaie
spécifiée par le champ CuC.
8. AA (Amount Authorized) : Montant maximum autorisé par période sur 4 chiffres.
9. AR (Amount Remaining) : Montant maximum autorisé pour la période courante sur
4 chiffres.
10.CB (Cycle Begin) : Date de début de la période courante sous la forme “YDDD”.
◦ “Y” représente le dernier chiffre de l'année en cours.
◦ “DDD” représente le numéro du jour dans l'année de “001” à “366”.
11.CL (Cycle Length) : Longueur de chaque période sur deux chiffres.
◦ “00” Période infinie.
◦ “01” ~ “79” Nombre de jours.
◦ “80” ~ “86” Valeurs spéciales
◦ “87” ~ “99” Inutilisés
12.RC (Retry Count) : Nombre de tentatives restantes de saisie du code PIN sur un
chiffre.
13.PINCP (PIN Control Parameters) : Paramètres d'encryptage du code PIN sur six
chiffres.
14.IC (Interchange Control) : Niveau de restriction des échanges sur un chiffre.
◦ “0” Pas de restriction.
◦ “1” Indisponible pour les échanges internationaux.
◦ “2” ~ “8” Échanges limités à un usage local et sous accord.
◦ “9” Échange limités. Recommandé pour des cartes de test.
30/46
15.PANSR (PAN Service Restriction) : Type de compte et restrictions de services sur
deux chiffres.
16.FSANSR (FSAN Service Restriction) : Restriction de services du FSAN.
17.SSANSR (SSAN Service Restriction) : Restriction de services du SSAN.
18.ED (Expiration Date) : Date d'expiration sous la forme “YYMM”.
19.CSN (Card Sequence Number) : Numéro de séquence de la carte sur un chiffre
permettant de différencier des cartes ayant le même PAN.
20.CsCN (Card Security Number) : Numéro de sécurité sur neuf chiffres vérifiant la
concordance entre les pistes magnétiques et le numéro gravé sur la carte.
21.FSAN (First Subsidiary Account Number) : Premier numéro de compte subsidiaire.
22.FS (Field Separator) : Séparateur de champs.
23.SSAN (Second Subsidiary Account Number) : Deuxième numéro de compte
subsidiaire.
24.FS (Field Separator) : Séparateur de champs.
25.RM (Relay Marker) : Définit si les données additionnelles et les données
discrétionnaires doivent être incluses.
◦ “0” si toutes les données discrétionnaires doivent être incluses.
◦ “1” si les données additionnelles doivent être exclues.
◦ “2” si aucune données discrétionnaires de doit être inclue.
26.CCD (Crypto Check Digits) : Contrôle de l'intégrité du contenu de la piste.
27.AD (Additional Data) : Données additionnelles.
28.ETX (End Sentinel) : Un caractère fixé à “?”.
29.LRC (Longitudinal Redundancy Check) : Contrôle de somme sur un octet.
31/46
Annexe 2 : Liste des messages courts
Valeur Description Timing
ACK (0x06) Taille du message, contrôle de somme et trame OK 1s maximum après chaque message
NAK (0x15) Taille du message, contrôle de somme ou trame erronée 1s maximum après chaque message
RQD (0x1A) Requête rejetée et non exécutable Après avoir vérifié un message
DLE (0x10) KGB 2005 TPX a terminé la dernière opération Chaque seconde
DC1 (0x11) KGB 2005 TPX est prêt pour opération Chaque seconde
DC2 (0x12) KGB 2005 TPX attend une carte en façade de la part de l'utilisateur Chaque seconde
DC3 (0x13) L'utilisateur a inséré une carte en façade Une seule fois
Tableau 2: Liste des messages courts
32/46
Annexe 3 : Format des trames des messages long.
7 6 5 4 3 2 1 0
1 SYN (0x16)
2 SYN (0x16)
3 SYN (0x16)
4 SOH (0x01)
7 STX (0x02)
8 Donnée 1
… Donnée …
… Donnée n
9+n LRC
10 + n EOT (0x04)
Tableau 3: Structure de la trame d'un message
Le champ RCL désigne la taille du message (ReCord Lenght). Ce champ prend deux
octets. Il prend en compte les octets allant de STX à EOT.
La somme de contrôle LRC, quant à elle, concerne les octets STX à ETX.
33/46
Annexe 4 : Algorithme d'un calcul de somme de contrôle LRC
package com.archipel.utils.isotrackencoder.utils;
import java.nio.ByteBuffer;
/**
* LRC computer.
*/
public final class LRC {
private LRC() {
}
/**
* Compute a longitudinal redundancy check.
*
* @param byteBuffer Inpup sequence of bytes.
* @return The longitudinal redundancy check byte.
*/
public static byte compute(final ByteBuffer byteBuffer) {
final ByteBuffer workingCopy = byteBuffer.duplicate();
byte lrc = 0;
workingCopy.rewind();
while (byteBuffer.hasRemaining()) {
lrc ^= byteBuffer.get();
}
return lrc;
}
}
34/46
Annexe 5 : Liste des messages longs utilisés.
Récupération du statut
7 6 5 4 3 2 1 0
1 “0” (0x30)
2 “0” (0x30)
3 “0” (0x30)
4 “0” (0x30)
Tableau 4: Requête “GET Status”
7 6 5 4 3 2 1 0
1 “0” (0x30)
Ticket in Ticket in
2 0 0 1 1 System Error System Ready
muzzle system
1 “0” (0x30)
2 “0” (0x30)
3 “0” (0x30)
4 “1” (0x31)
Tableau 6: Réponse “GET Result of last operation”
7 6 5 4 3 2 1 0
1 “1” (0x31)
35/46
Récupération des données de la carte
Ce message n'est appelé qu'après avoir procéder à une opération de lecture.
7 6 5 4 3 2 1 0
1 “0” (0x30)
2 “0” (0x30)
3 “0” (0x30)
4 “2” (0x32)
Tableau 8: Réponse “GET Magnetic data”
7 6 5 4 3 2 1 0
1 “2” (0x32)
6 Donnée 1
… Donnée …
5+k Donnée k
7+k
9+k
10 + k Donnée 1
… Donnée …
9+k+m Donnée m
11 + k + m
13 + k + m
14 + k + m Donnée 1
… Donnée …
13 + k + m + n Donnée n
Tableau 9: Réponse “GET Magnetic data”
36/46
Les identifiants permettent de spécifier le sens de lecture de la piste. “1” (0x31), “2”
(0x32) et “3” (0x33) désignent le sens normal de lecture pour les pistes 1, 2 et 3 tandis
que “9” (0x39), “:” (0x3A) et “;” (0x3B) désignent le sens inverse. Il s'agit en fait de
lever le bit 3 pour signaler le sens contraire de lecture.
Un appel à cette requête sans lecture préalable retournera une carte vide. C'est-à-
dire : “2100020003000”.
7 6 5 4 3 2 1 0
1 “0” (0x30)
2 “0” (0x30)
3 “0” (0x30)
4 “:” (0x3A)
Tableau 10: Requête “Reset system error”
Cette requête ne retourne pas de réponse.
1 “0” (0x30)
2 “2” (0x32)
3 “0” (0x30)
4 “0” (0x30)
Tableau 11: Requête “GET Long status”
7 6 5 4 3 2 1 0
1 “9” (0x39)
Ticket in
2 0 0 1 1 Error Ticket in System No Erro
muzzle
37/46
Capteur photosensible 1 : “0” (éteint) ou “1” (allumé)
6
Emplacement : lecteur, à coté du museau
Si disponible :
Capteur photosensible 0, position de stationnement 1 : “0” (éteint) ou “1” (allumé)
14
Emplacement : position de stationnement, à coté du lecteur
Sinon : “1”
Si disponible :
Capteur photosensible 1, position de stationnement 1 : “0” (éteint) ou “1” (allumé)
15
Emplacement : position de stationnement, vers la sortie
Sinon : “1”
Si disponible :
Capteur photosensible 0, séparation : “0” (éteint) ou “1” (allumé)
16
Emplacement : séparation
Sinon : “1”
Si disponible :
Capteur photosensible 1, séparation : “0” (éteint) ou “1” (allumé)
17
Emplacement : séparation
Sinon : “1”
Si disponible :
Capteur photosensible 2 séparation : “0” (éteint) ou “1” (allumé)
18
Emplacement : séparation
Sinon : “1”
Si disponible :
Capteur photosensible 3, séparation : “0” (éteint) ou “1” (allumé)
19
Emplacement : séparation
Sinon : “1”
Si disponible :
Capteur photosensible 4, séparation : “0” (éteint) ou “1” (allumé)
20
Emplacement : séparation
Sinon : “1”
21 Si disponible :
Capteur photosensible 5, séparation : “0” (éteint) ou “1” (allumé)
Emplacement : séparation
38/46
Sinon : “1”
Si disponible :
Capteur photosensible 6, séparation : “0” (éteint) ou “1” (allumé)
22
Emplacement : séparation
Sinon : “1”
Si disponible :
Capteur photosensible 1, museau : “0” (éteint) ou “1” (allumé)
23
Emplacement : museau, sortie
Sinon : “1”
Si disponible :
Capteur photosensible 0, position de stationnement 2 : “0” (éteint) ou “1” (allumé)
24
Emplacement : position de stationnement, à coté du lecteur
Sinon : “1”
Si disponible :
Capteur photosensible 1, position de stationnement 2 : “0” (éteint) ou “1” (allumé)
25
Emplacement : position de stationnement, vers la sortie
Sinon : “1”
26 – 34 Réservé
47 – 48 Réservé
51 – 60 Réservé
7 6 5 4 3 2 1 0
1 “0” (0x30)
2 “9” (0x39)
3 “0” (0x30)
4 “0” (0x30)
Tableau 13: Requête “Empty system”
Cette requête ne provoque pas de réponse.
40/46
Annexe 6 : Structure d'un message opératif
Octet Fonction “0” “1” “2” “3” “4” “5” “6” “7” “8” “9” “:” “;”
1 Commande “1”
… Données supplémentaires
41/46
Annexe 7 : Exemple de scénario d'utilisation du CCS 2005 TXP KGB®.
Cet exemple présente une opération de lecture de carte.
Dans un premier temps, on s'assure que le système est prêt. S'il n'est pas prêt, on fait
le nécessaire.
Dans le cas présent, la carte n'a pas de piste. Ces pistes n'ont pas encore été encodées
ou la carte a tout simplement été insérée dans le mauvais sens (La piste vers le haut). À
la fin du scénario, le matériel entre en erreur.
Trois niveaux de profondeurs sont affichés. Du niveau le plus bas (en hexadécimal) au
niveau le plus haut (sous forme textuel).
En vert, les messages entrants du périphérique vers l'ordinateur.
En rouge, les messages sortants de l'ordinateur vers le périphérique.
01. 11
02. 16 16 16 01 00 08 02 30 30 30 30 03 01 04
03. 06
04. 08
05. 16 16 16 01 00 07 02 30 31 30 03 30 04
06. 11
07. 16 16 16 01 00 08 02 30 30 30 3A 03 0B 04
08. 06
09. 08
10. 11
11. 16 16 16 01 00 0B 02 31 36 31 37 31 30 30 03 31 04
12. 06
13. 08
14. 12
15. 12
16. 12
17. 13
18. 10
19. 16 16 16 01 00 08 02 30 30 30 32 03 03 04
20. 06
21. 08
22. 16 16 16 01 00 11 02 32 31 30 30 30 32 30 30 30 33 30 30 30 03 33 04
23. 11
42/46
01. DLE
02. “0000”
03. ACK
04. RQA
05. “080”
06. DLE
07. “000:”
08. ACK
09. RQA
10. DLE
11. “1617100”
12. ACK
13. RQA
14. DC2
15. DC2
16. DC2
17. DC3
18. DC1
19. “0002”
20. ACK
21. RQA
22. “2100020003000”
23. 11
43/46
Annexe 8 : Diagramme de classe de la classe Driver
com.archipel.utils.isotrackencoder.controler.Driver
- LOGGER: org.apache.log4j.Logger
- APPLICATION_NAME: java.lang.String
- TIMEOUT: int
- ACK: byte
- NAK: byte
- RQA: byte
- RQD: byte
- DLE: byte
- DC1: byte
- DC2: byte
- DC3: byte
- BYTE_TO_IDLE: java.util.Map<java.lang.Byte, Idle>
- idle: com.archipel.utils.isotrackencoder.controler.Driver.Idle
- responses: java.util.Queue<Object>
- portName: java.lang.String
- serialPort: gnu.io.SerialPort
- input: java.io.InputStream
- output: java.io.OutputStream
+ Driver(port: java.lang.String)
+ close(): void
+ listAvailablePorts(): java.util.List<java.lang.String>
+ getIdle(): com.archipel.utils.isotrackencoder.controler.Driver.Idle
+ send(message: com.archipel.utils.isotrackencoder.controler.protocol.Message):
com.archipel.utils.isotrackencoder.controler.protocol.Message
- connect(portName: java.lang.String): void
+ serialEvent(serialPortEvent: gnu.io.SerialPortEvent): void
- timeoutedExecution(expected: java.lang.Runnable, millis: int): boolean
- byteArrayToHexa(byteArray: byte[]): java.lang.String
- byteBufferToHexa(byteBuffer: java.nio.ByteBuffer): java.lang.String
- byteBufferToString(byteBuffer: java.nio.ByteBuffer): java.lang.String
- setIdle(idle: com.archipel.utils.isotrackencoder.controler.Driver.Idle): void
- sleep(millis: int): void
+ timeoutedExecution(expected: java.lang.Runnable, millis: int): boolean
Tableau 15: Diagramme de classe de la classe Driver
44/46
Annexe 9 : Diagramme des classes du noyau
45/46
Résumé
Ma formation m'a offert l'opportunité d'effectuer un stage en entreprise d'une durée
de trois mois au sein de l'entreprise Parkeon. Cette entreprise est un leader dans le
secteur de la mobilité urbaine. Elle conçoit et met en place des solutions de
stationnement pour des acteurs publics et privés. Ma mission consistait à développer un
pilote pour encoder des pistes magnétiques de cartes de paiement. J'ai d'abord dû faire
quelques recherches sur le format des pistes et sur le protocole de communication entre
l'ordinateur et le périphérique fourni. J'ai ensuite écrit le noyau et l'interface utilisateur
et j'ai progressivement intégré ces deux modules dans le projet ArchiPEL. Cette
expérience professionnelle m'a apporté beaucoup de connaissances et un grand nombre
de méthodes de travail. Ce rapport porte sur ce que j'ai fait et ce que j'ai appris au
cours de cette période de formation.
Mots-clés
Pistes magnétiques, Carte de paiement, Encodage, Port série, Méthodes Agiles, Java
Abstract
My school education gave me the chance to perform a three months internship at the
Parkeon firm. This company is a leader in the urban mobility sector. It designs and
deploys parking solutions for public and private actors. My mission consisted in
developing a driver to encode magnetic tracks of bank cards. I first had to make
researches about the tracks format and about the communication protocol between the
computer and the provided device. Then, I wrote the core and the user interface and I
progressively integrated both modules into the ArchiPEL project. This working
experience gave me much knowledge and a large set of working methods. This report is
about what I did and what I learned during this training period.
Keywords
Magnetic tracks, Bank card, Encoding, Serial port, Agiles methods, Java
46/46