hepialight pour GNU-Linux

Transcription

1 hepialight pour GNU-Linux Installation et prise en main du logiciel LPCXpresso mise en place d'un firmware sur la carte Matériel : Une carte hepia-light Un ordinateur avec GNU-Linux et le logiciel LPCXpresso Un câble mini USB Cette documentation est orientée pour une utilisation avec un environnement GNU-LINUX. Il est possible d'utiliser un environnement Windows ou Mac mais ces cas ne seront pas traités ici. Les commentaires sous forme de notes ne sont pas indispensables, ils sont présents comme indication. 1

2 Table des matières 1. Installation du logiciel Utilisation du logiciel LPCXpresso lancement La page principale de LPCXpresso Importer le projet Hepia Light Le code C Compilation Charger le programme sur la carte hepialight...12 Index des illustrations Illustration 1: Distribution pour Linux...4 Illustration 2: Fenêtre de choix du workspace...5 Illustration 3: message d'activation du logiciel...5 Illustration 4: Page principal de LPCXpresso...6 Illustration 5: Fenêtre d'import du projet...7 Illustration 6: Explorateur de workspace (Project Explorer)...8 Illustration 7: Explorateur de workspace (Project Explorer)...9 Illustration 8: Éditeur de code (en version étendue)...10 Illustration 9: Fenêtre de commande du compilateur...11 Illustration 10: Message d'enregistrement avant la compilation...12 Illustration 11: Console à la fin de la compilation...12 Illustration 12: Reset en connectant USB...12 Illustration 13: Bouton de compilation...13 Illustration 14: Configuration pour transferer le firrmware sur la carte...13 Illustration 15: Reset en connectant USB

3 1. Installation du logiciel Le logiciel LPCXpresso est disponible gratuitement sur : Il faut créer un compte sur le site pour pouvoir télécharger le programme : Entrez une adresse . Allez chercher le code de login dans l' reçu pour vous loguer. Une fois logué, allez sur l'onglet download. 3

4 Téléchargez le logiciel version 5 pour votre machine (Windows, Linux, Mac). Dans cet exemple la version «LPCXpresso v5 build 2065» pour Linux est utilisée. Note : Le logiciel reste le même suivant la plateforme mais l'installation peut être différente. Illustration 1: Distribution pour Linux Installez le logiciel. Il faut décompresser le fichier téléchargé en.gz puis extraire le fichier en.tar dans un dossier. Ensuite il suffit de lancer le logiciel depuis l'exécutable qui se trouve dans le dossier où a été décompressé le fichier. Note : pour les autres plateformes l'installation peut être différente. 4

5 2. Utilisation du logiciel LPCXpresso 2.1 Lancement Au premier lancement de LPCXpresso, il faut choisir le workspace. C'est le dossier où les fichiers sont sauvegardés. Créez-le dans /home/workspace/hepialight Illustration 2: Fenêtre de choix du workspace Note : Il est tout à fait possible d'utiliser un autre dossier comme workspace. A chaque lancement, le logiciel LPCXpresso affichera un message pour inviter à enregistrer le logiciel officiellement. Il suffit de cliquer sur ok et de l'ignorer ou pour une installation personnelle durable de répondre à la requête. Illustration 3: message d'activation du logiciel 5

6 Note : Il est possible d'enregistrer le logiciel sur le site Noter que si le logiciel n'est pas enregistré, il sera impossible de compiler des programmes d'une taille supérieure à 8 ko. 2.2 La page principale de LPCXpresso L'éditeur est divisé en plusieurs fenêtres (ou onglets). L explorateur de workspace, en à gauche, qui liste les fichiers présents dans le dossier workspace. L'éditeur à proprement parler à droite, là où le code est édité. Les commandes du compilateur sont en bas à gauche. La console est en bas à droite. Chacune de ces fenêtres peut être étendue en double-cliquant sur l'onglet de la fenêtre. Note : le logiciel comporte beaucoup d'autres onglets que nous n utiliserons pas dans cet atelier. Le logiciel LPCXpresso étant basé sur l'éditeur Eclipse, toutes les extensions pour Eclipse sont compatibles avec LPCXpresso. Illustration 4: Page principal de LPCXpresso 6

7 2.3 Importer le projet Hepia Light Pour commencer l'atelier il faut importer un projet d'exemple qui se trouve sur le site : atelier hepia_light (disponible en format.zip). Pour importer aller dans le menu file->import (ou bien cliquer import projects en bas à gauche dans les commandes). Dans la fenêtre qui apparaît choisissez l'onglet general->existing project into workspace cocher select archive file, ensuite cliquer sur browse et choisir dans vos dossier le fichier hepia_light.zip à importer. Cliquer sur finish. Illustration 5: Fenêtre d'import du projet 7

8 Une fois importés, les projets apparaissent dans la fenêtre de gauche qui s'appelle Project Explorer. Illustration 6: Explorateur de workspace (Project Explorer). Un projet contient plusieurs fichiers, parmi lesquels se trouve le code C qui décrira le programme à être exécuté par le micro-contrôleur. 2.4 Le code C Pour commencer à coder, il faut choisir le fichier à modifier en double cliquant dessus. On peut en ouvrir autant qu'on veut en même temps. Ils apparaitront sous forme d'onglets dans la fenêtre principale. 8

9 Illustration 7: Explorateur de workspace (Project Explorer) Pour ce document on se limitera au fichier main.c et exemple.c. Le code sur main.c sera toujours exécuté lors du démarrage du microcontrôleur. Ensuite, il pourra lancer le code décrivant des exemples se trouvant sur le fichier exemple.c. 9

10 Le code peut être modifié dans la fenêtre principale (l'éditeur de code). Illustration 8: Éditeur de code (en version étendue) L'éditeur de code se comporte comme un éditeur de texte standard. La coloration est présente pour différencier les éléments du code. L'éditeur s'occupe aussi de noter les éventuels erreurs dans le cas de lignes de code qui ne correspondraient pas à la syntaxe du langage choisi ou d'erreurs qui empêcheraient la compilation du programme. Il est possible d'afficher le message d'erreur en pressant la touche F2 en ayant la souris pointée sur la partie soulignée en rouge. Une petite icône d'erreur apparaît aussi dans la marge. Pour cet atelier on utilisera le langage C. Note : L'éditeur peut avoir des couleurs différentes, suivant comment il a été configuré. 10

11 2.5 Compilation Une fois le code modifié, il faut le compiler pour générer une représentation compréhensible par le micro-contrôleur. Cette représentation est un fichier appelé Atelier_HEPIA_Light.bin à charger sur la carte. Pour compiler, il faut aller dans la fenêtre en bas à gauche et cliquer sur build atelier hepia_light. Illustration 9: Fenêtre de commande du compilateur Attention : le code ne se compilera pas s il comporte des erreurs. Si vous observez des message d'erreur il faudra les lire, les comprendre et (bien évidement) les corriger. Le programme demandera une nouvelle fois de l'enregistrer. Cliquer simplement sur ok et ignorer-le. 11

12 Illustration 10: Message d'enregistrement avant la compilation Des lignes de code vont apparaître dans la fenêtre en bas (console). Il faut attendre qu'il affiche «Build finished» tout en bas. Il faudra vérifier qu'il n'y ait pas d'erreur de compilation!!! Illustration 11: Console à la fin de la compilation(ici avec erreur) 3. Charger le programme sur la carte hepialight Il faut connecter la carte tout en appuyant sur le bouton principal. Attention!! Appuyer sur le bouton AVANT de connecter la carte. Illustration 12: Reset en connectant USB 12

13 La carte apparaîtra sur le bureau de votre PC comme une clé USB. Pour copier le firmware sur la carte il faut configurer le logiciel LPCXpresso pour qu'il le fasse automatiquement après la compilation. Cliquer sur la petite flèche à coté du bouton vert (le 2ème depuis la gauche). Illustration 13: Bouton de compilation Choisissez «External Tools Configuration». puis entrez les données comme sur l image. Illustration 14: Configuration pour transférer le programme sur hepialight 13

14 Location : /bin/dd (commande de copie). Working Directory : entrez le chemin d'accès du dossier debug du projet qui se trouve dans votre workspace. Argument : le nom du fichier.bin obtenu a la compilation (le fichier porte le même nom que le projet et le chemin d'accès à la carte HepiaLight. (CRP DISABLD). Une fois cette manœuvre effectuée il suffira de cliquer sur le bouton vert (le 2ème depuis la gauche) pour que le projet se compile et se copie sur la carte automatiquement. Attention : veillez à connecter la carte au pc avant de compiler. Note : la configuration à besoin d'être effectuée qu'une fois. Ensuite déconnectez la carte et reconnectez-la normalement. 14