hepialight pour Windows 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 Windows et le logiciel LPCXpresso -Un câble mini USB Cette documentation est orientée pour une utilisation avec un environnement Windows. Il est possible d'utiliser un environnement Linux ou Mac mais ces cas ne seront pas traités ici. Les commentaires sous forme de note ne sont pas indispensables, ils sont présents comme indication. 1
1. Installation du logiciel Le logiciel LPCXpresso est disponible gratuitement sur : http://lpcxpresso.code-red-tech.com/lpcxpresso/ Il faut créer un compte sur le site pour pouvoir télécharger le programme : -Entrer une adresse e-mail. -Aller chercher le code de login dans l'e-mail reçu pour vous loguer. Une fois logué, aller sur l'onglet download. 2
Télécharger le logiciel version 5 pour votre machine (Windows, Linux, Mac). Dans cet exemple la version «LPCXpresso v5 build 2065» pour Windows est utilisée. Note : Le logiciel reste le même suivant la plateforme mais l'installation peut être différente. Illustration 1: Distribution pour Windows Installer le logiciel. C'est un fichier exécutable. Si vous êtes sur Windows il suffi de double cliquer dessus. Note : pour les autres plateformes l'installation peut être différente. 3
2. Utiliser le logiciel LPCXpresso 2.1 lancement Au premier lancement de LPCXpresso il faut choisir le workspace. C'est le dossier ou on va sauvegarder les fichiers. Créez le dans C:/Documents and Settings/Mes Document/Workspace 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 vous affichera un message pour vous inviter à vous enregistrer. Il suffit de cliquer sur ok et de l'ignorer. Illustration 3: message d'activation du logiciel 4
Note : Il est possible d'enregistrer le logiciel sur le site http://lpcxpresso.code-red-tech.com/lpcxpresso/. 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 haut à gauche, qui liste les fichiers présent dans le dossier workspace. L'éditeur à proprement parler en haut à droite, là où on va modifier le code. Les commandes du compilateur, en bas à gauche. La console 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 utiliseront pas dans cet atelier. Le logiciel LPCXpresso étant basé sur l'éditeur Eclipse, toutes les extensions pour Eclipse sont compatibles avec LPCXpresso. 5
2.3 Importer le projet Hepia Light Pour commencer l'atelier il faut importer un projet d'exemple qui se trouve sur les fichier : 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 6
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 vous retrouverez 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'onglet dans la fenêtre principale. 7
Illustration 7: Explorateur de workspace (Project Explorer) Pour cet 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 microcontôleur. Ensuite, il pourra lancer le code décrivant des exemples se trouvant sur le fichier exemple.c. 8
Vous avez donc la possibilité de modifier le code 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é. 9
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 a mettre 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. 10
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 écrive «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 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 11
La carte apparaîtra sur le bureau de votre PC comme une clé USB. Ensuite, il vous est proposé deux techniques pour programmer la carte : Technique 1 : Copier le fichier Atelier_HEPIA_Light.bin (fichier binaire généré à la compilation) directement sur la carte (effacer le fichier firmware.bin si il y en a déjà un sur la carte) en utilisant l'explorateur de Windows. Note : Le fichier binaire est dans le dossier Debug du workspace, il porte le nom du projet qui a été compilé. Ensuite déconnectez la carte et reconnectez la normalement. Technique 2 :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 14: Bouton de compilation 12
Choisissez «External Tools Configuration». puis entrez les données comme sur l image : Illustration 15: Configuration pour transférer le programme sur hepialight Location : C:\WINDOWS\system32\xcopy.exe (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. (e :). 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. 13
Table des matières 1. Installation du logiciel... 2 2. Utiliser le logiciel LPCXpresso...4 2.1 lancement... 4 2.2 La page principale de LPCXpresso...5 2.3 Importer le projet Hepia Light...6 2.4 Le code C... 7 2.5 Compilation... 10 3. Charger le programme sur la carte hepialight...11 Index des illustrations Illustration 1: Distribution pour Windows...3 Illustration 2: Fenêtre de choix du workspace...4 Illustration 3: message d'activation du logiciel...4 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)...11 Illustration 9: Fenêtre de commande du compilateur...12 Illustration 10: Message d'enregistrement avant la compilation...13 Illustration 11: Console à la fin de la compilation...13 Illustration 12: Copie du firmware sur la carte Hepia Light...15 14