MICROCHIP PICSTART Plus Manuel utilisateur

143
MPLAB
Qu’est-ce que MPLAB
MPLAB est un outil de développement spécifique aux
microcontrôleurs PIC, conçu et fourni gratuitement par Microchip.
Il permet d’écrire, mettre au point et optimiser les programmes,
sous Windows.
En effet, en plus d’un éditeur et d’un assembleur, il inclut un ensemble
d’outils permettant non seulement de fabriquer le code objet d’une
application, mais aussi de simuler le programme, c’est à dire le voir
dérouler à l’écran.
Il supporte plusieurs outils externes, parmi lesquels deux modèles
de programmateurs (PICSTART PLUS et PROMATE 2) et deux
émulateurs (PICMASTER et PICMASTER-CE).
MPLAB est facile à apprendre et à utiliser.
144
Il offre beaucoup de flexibilité aux développeurs, notamment grâce
aux nombreuses fenêtres pouvant être ouvertes à tout moment lors d’une
mise au point, permettant de voir le contenu d’un quelconque emplacement
mémoire et d’un quelconque registre.
145
Comment obtenir MPLAB
MPLAB est téléchargeable à partir du site Internet de Microchip
(www.microchip.com).
Si vous aviez besoin de le copier sur disquettes, prévoyez-en un bon
nombre (il vous en faudra au moins huit).
Vous seriez en possession de fichiers compressés, que vous devriez
décompresser au moyen d’un logiciel adapté (WinZip, par exemple).
Remarquez que MPLAB est un produit en constante évolution, et
qu’en fonction de la version qui vous serait fournie, vous pourriez trouver
un certain nombre de fichiers modifiés ou différents d’une version à l’autre.
La version que Microchip diffuse au moment où j’écris et dont je
me sers dans mes exemples est la version 5.20
146
Caractéristiques requises par le PC pour
l’installation de MPLAB
Pour pouvoir être installé, MPLAB nécessite la configuration
minimale suivante :
- un PC compatible 486 ou mieux ;
- Microsoft Windows depuis 3.1 jusqu’à la version la plus
récente ;
- écran VGA ;
- 8 Méga de mémoire (32 Méga recommandés) ;
- 20 Méga d’espace disponible sur le disque dur ;
- la souris.
147
Comment installer MPLAB
MPLAB s’installe automatiquement.
Pendant la procédure d’installation, qui démarre toute seule,
plusieurs fenêtres vont s’ouvrir.
La première est celle qui vous souhaite la bienvenue et vous
informe que vous vous préparez à installer la version 5.20 de MPLAB .
Cliquez sur le bouton Next.
148
Dans la fenêtre suivante, décochez les éléments que vous ne
souhaitez pas installer.
A moins que vous ayez acheté un simulateur ou un émulateur
(chose dont je doute fort !), vous ne devriez installer que les outils logiciels
courants, et l’aide.
Décochez les autres.
Cliquez ensuite sur le bouton Next.
149
Dans la fenêtre Select Language Components, vous ne devriez
maintenir actif que tout ce qui se rapporte à Windows.
Décochez tout ce qui se rapporte au DOS (Je n’aime pas les
programmes tournant sous DOS. Vous non plus, j’imagine ! ).
150
La fenêtre suivante (Select Destination Directory) vous indique le
chemin que l’installation va prendre dans votre PC.
Acceptez, en cliquant sur Next.
La fenêtre suivante vous demande si vous voulez créer des copies
de sauvegardes des fichiers que l’installation pourrait être amenée à
remplacer.
151
Acceptez la configuration par défaut (No) en cliquant sur Next.
152
Dans la fenêtre suivante (Add to Start Menu ?) acceptez
suggestion Yes .
la
153
Faites la même chose dans la fenêtre suivante :
Acceptez la configuration suggérée, en cliquant sur Next.
154
Puis acceptez encore ce qui vous est proposé dans la fenêtre qui
suit :
155
Vous arrivez enfin à la dernière fenêtre : celle qui vous dit que
maintenant tout est prêt pour que l’installation démarre de vrai !
Cliquez sur Next : c’est parti.
156
Une fois l’installation terminée (Installation Completed !), vous
pouvez ignorer le Readme proposé. Cliquez sur MPLAB.EXE pour créer un
raccourci.
Vous pouvez démarrer.
L’environnement de développement de MPLAB est à vous !
157
Comment désinstaller MPLAB
Le fichier INSTALL.LOG enregistre les noms de tous les fichiers
copiés au cours de la procédure d’installation.
Le jour que l’on souhaite désinstaller MPLAB, la procédure de
désinstallation utilise INSTALL.LOG pour savoir quels sont les fichiers à
supprimer.
Pour la désinstallation, il suffit de lancer UNWISE.EXE se
trouvant dans le répertoire de MPLAB.
158
Comment démarrer avec MPLAB
Tout d’abord une constatation : l’écran de démarrage de MPLAB
ressemble à la plupart des écrans Windows, en ce sens qu’il comporte - en
haut - la barre des menus et la barre d’outils, et - en bas - une barre d’état
informant de la façon dont le système est configuré.
En cliquant sur la toute première icône de la barre d’outils (icône
en couleur représentant trois fiches en perspective : bleu, rouge, jaune):
vous pouvez déjà constater la présence d’autres barres d’outils (il y
en a quatre) :
Comme l’on sait que dans tout logiciel bien conçu plus il y a
d’outils disponibles et plus le travail est facile, la première évidence est que
MPLAB est un logiciel sympathique.
A ajouter aussi que MPLAB est un logiciel sûr, et qu’il possède plusieurs
points d’entrée.
159
MPLAB est un logiciel sûr : vous pouvez l’utiliser sans vous faire
le moindre souci, car il ne vous laissera jamais modifier ou supprimer quoi
que ce soit présentant le moindre danger pour l’intégrité des fichiers sans
vous mettre en garde et vous demander de confirmer la commande;
MPLAB possède plusieurs points d’entrée : en ce sens que vous
pouvez effectuer la même tâche en empruntant des chemins différents, sans
obligatoirement obéir à un mode d’emploi préétabli. Il suffit, la plupart des
fois, d’adapter et de croiser les grilles écran ouvertes sur le bureau.
Eu égard à cette souplesse, c’est-à-dire : étant donné qu’il est
possible d’emprunter différents chemins pour accomplir la même tâche, la
manière d’écrire un programme et de l’assembler que je vais vous indiquer,
est seulement l’une des manières possibles. Au fur et à mesure que vous
vous familiariserez avec MPLAB, vous en découvrirez d’autres.
160
Première étape : création du projet
Créer un projet
Pour pouvoir aboutir à un programme, MPLAB a besoin de
naviguer entre plusieurs fichiers.
Pour cette raison, avant de vous autoriser à écrire un programme,
MPLAB vous oblige à créer un projet.
Créer un projet revient à définir entre autres:
1) le nom que va porter le programme ;
2) les fichiers que MPLAB devra utiliser au cours du
développement.
Un projet comporte un nom, avec extension .pjt
Convenons d’appeler notre projet phase1
Le nom du projet sera donc : phase1.pjt
161
Comment créer un projet
Lancez MPLAB, puis allez dans :
Project
↓
New Project
Une fenêtre s’ouvre (New Project) :
MPLAB vous rappelle que le nom du projet doit impérativement
être suivi de l’extension .pjt
162
Dans le champ File Name entrez le nom que vous voulez donner à
votre projet (nous avons convenu de l’appeler phase1) suivi de .pjt
(phase1.pjt).
Puis cliquez sur OK.
Cette manœuvre ouvre une autre fenêtre (Edit Project):
163
Dans cette fenêtre :
a) le Target Filename (le nom du fichier cible, c’est à dire
celui auquel vous voulez aboutir) doit correspondre à celui que vous voulez
créer, portant donc l’extension .hex (phase1.hex) ;
164
b) le Development Mode se rapporte bien au MPLABSIM Simulator PIC 16F84 et non pas à un autre mode de développement
(sinon cliquez sur la touche Change et modifiez en conséquence; puis
cliquez en répondant toujours OK) ;
b) le Language Tool Suite doit être celui de Microchip.
Après ces vérifications, cliquez sur la touche OK.
Dès lors, le projet est créé.
Il contient les paramètres qui lui sont nécessaires, et vous pourrez
vous y référer par la suite.
165
Deuxième étape :
écriture du programme source
Pour taper votre programme, allez dans :
File
↓
New
C’est à partir de maintenant que l’écriture à proprement parler des
instructions du programme peut démarrer.
166
La fenêtre d’accueil est Untitled1 :
C’est celle de l’éditeur de texte de MPLAB.
Elle est prête à recevoir les lignes de votre programme.
Agrandissez-la à plein écran, et commencez la frappe.
Pour séparer les champs (labels, instructions, opérandes et
commentaires) servez-vous de la touche de tabulation.
N’oubliez pas
commentaires.
d’insérer des
; (point-virgule)
avant
les
167
Lorsque toutes les lignes du programme ont été saisies, allez dans :
File
↓
Save As...
Une fenêtre s’ouvre (Save File As):
168
Dans le champ File Name demandant le nom sous lequel vous
voulez sauvegarder le fichier, tapez le nom du programme - qui doit être
impérativement le même que celui du projet, suivi de l’extension .asm ainsi
que MPLAB vous le rappelle (phase1.asm) - ou allez le chercher dans la
liste déroulante, au moyen de l’ascenseur. Puis terminez en cliquant sur la
touche OK.
Dès lors, ce fichier à extension .asm contient le « programme
source », que l’on appelle plus couramment « fichier source », ou tout
simplement « source ».
Ce fichier est sauvegardé.
Notez ou retenez bien son nom (phase1.asm), car vous aurez
l’occasion d’y revenir.
169
Troisième étape:
conversion du programme source
en programme objet
Le but de cette opération est de convertir le fichier source (celui
dont l’extension est .asm ) en fichier objet, c’est à dire en un fichier ayant
le même nom que celui du fichier source, mais avec extension .hex
Autrement dit : convertir phase1.asm en phase1.hex
Pour cela, allez dans :
Project
↓
Edit Project
170
Une fenêtre s’ouvre :
Vous connaissez cette fenêtre pour l’avoir vue lors de l’ouverture
du projet.
Assurez-vous d’abord que le nom du fichier figurant dans la zone
Target Filename correspond à celui qui vous intéresse (phase1.hex).
Le cas échéant, modifiez en cliquant sur la touche Change.
171
Cette fenêtre comporte déjà le nom du fichier cible (phase1.hex).
Mais, à ce stade, MPLAB demande qu’un nœud soit créé entre le fichier
cible et le fichier source.
En bas, à droite, une touche est disponible : Add Node.
Un clic sur cette touche, ouvre la fenêtre Add Node.
Au moyen de l’ascenseur, cherchez-y le fichier de même nom à
extension .asm (phase1.asm) et cliquez sur ce fichier pour que son nom
s’inscrive dans le champ Nom de fichier.
Puis cliquez sur OK.
172
La fenêtre Edit Project s’ouvre une nouvelle fois :
Mais cette fois, dans la zone Project Files, figurent les noms de
deux fichiers :
- celui à extension .hex
- et celui à extension .asm
173
Cliquez sur OK pour verrouiller le nœud entre MPLAB et
MPASM (un autre utilitaire de l’environnement intégré) et lier ainsi ces
deux fichiers.
Puis allez dans :
Project
↓
Build All
Dès lors, la compilation démarre: les instructions du fichier
phase1.asm écrites en langage assembleur (celui utilisant les
mnémoniques) sont transformées en une suite de 0 et de 1 (seul langage
compréhensible par le 16F84) pour constituer le fichier phase1.hex
174
Il arrive qu’une compilation soit bonne du premier coup.
A supposer que tel soit le cas, vous devriez voir s’ouvrir la fenêtre
suivante :
Par le message : « Build completed successfully » (la compilation
s’est achevée avec succès), cette fenêtre vous informe que l’assemblage de
votre fichier à extension .asm (phase1.asm) a aboutit à un fichier à
extension .hex (phase1.hex)
Félicitations ! Cela veut dire que dans votre programme source
vous n’avez commis aucune erreur.
175
Vous pourriez - tout au plus - voir apparaître des « messages » ou
des « warnings », c’est à dire des avertissements, des mises en garde.
Bien que les messages et les warnings n’empêchent pas le
déroulement d’un programme, il est tout de même bon de leur jeter un coup
d’œil et d’en comprendre les raisons.
Il suffit de demander à MPLAB de numéroter les lignes de votre
programme (en cliquant sur l’icône dans l’une des barres des outils, en haut
de l’écran)
Puis, de vous reporter à la ligne mentionnée par chaque message
ou warning et de l’examiner attentivement. A cette ligne le compilateur
assembleur de MPASM n’a pas trouvé une erreur à proprement parler, mais
une sorte d’ambiguïté, une anomalie, et il vous prévient que cela pourrait
conduire à une exécution défaillante de votre programme.
176
Quatrième étape:
correction des erreurs
Si votre programme contient des erreurs, la compilation n’aboutit
pas.
Avec le message Build failed (construction ratée), vous verriez
apparaître des messages mentionnant la ou les erreurs.
Dans ce cas, il faut impérativement revenir au fichier à extension
.asm et corriger les erreurs.
Puis, relancer la compilation depuis le début par :
Project
↓
Make Project
Vous revenez ainsi à la fenêtre Build Results.
Cela autant de fois que nécessaire, jusqu’à lire le message :
« Build completed successfully ».
177
Cinquième étape:
simulation du programme
Disons-le tout de suite : cette étape est facultative, car elle
concerne la simulation.
La simulation est une sorte de vérification virtuelle permettant de
voir à l’écran ce qui se passe lorsque les instructions sont exécutées par le
microcontrôleur.
On peut la faire de différentes façons :
- en mode pas à pas
- en mode step over
- en mode exécution automatique
- avec ouverture de fenêtres.
178
Mode pas à pas
Pour simuler un programme en mode pas à pas, appelez à l’écran
le fichier à extension .asm
Puis allez dans :
Debug
↓
Run
↓
Reset
(ou tapez le raccourci clavier F6) :
Cette manœuvre effectue un Reset logiciel du programme qu’on
veut simuler.
En effet, le Program Counter est mis à zéro (adresse
correspondant au vecteur Reset du 16F84).
179
La ligne de programme se trouvant à cette adresse passe en
surbrillance, tandis que dans la barre d’état (située en bas de l’écran) PC
prend la valeur 00.
Ensuite allez dans :
Debug
↓
Run
↓
Step
En tapant sur le raccourci clavier F7 le PC (Program Counter)
avance d’un pas à la fois, ainsi que vous pouvez le constater en lisant la
valeur du Program Counter dans la barre d’état.
C’est l’exécution en mode pas à pas.
180
Vous pouvez aussi vous
servir de la souris, en cliquant
sur l’icône :
(Deux empreintes de pas: Pas à pas : F7)
Icône située dans la barre des outils, en haut de l’écran.
Devant une boucle, vous pourriez stopper la simulation soit en
tapant sur le raccourci clavier F5, soit en cliquant sur l’icône du feu rouge :
(Feu rouge : Halt : F5)
181
Mode Step Over
Lorsque dans le programme il y a des boucles, l’exécution peut
prendre beaucoup de temps.
Dans ce cas, il existe la possibilité de demander au simulateur
d’ignorer les boucles.
C’est le mode Step Over.
Pour ce type d’exécution il faut choisir le chemin :
Debug
↓
Run
↓
Step Over
182
Pour faire avancer le programme dans ce mode, tapez sur le
raccourci clavier
F8 ou cliquez de façon répétée sur l’icône montrant deux
empreintes de pas entrecoupées :
Le programme s’exécute alors selon un mode qui - en apparence ressemble au mode pas à pas, mais qui en réalité ignore toutes les boucles.
De ce fait, le temps de son exécution est considérablement plus court.
L’arrêt de la simulation peut se faire à tout moment, soit en
cliquant sur l’icône du feu rouge, soit en tapant sur la touche F6.
L’on revient alors au début du programme.
183
Mode exécution automatique
Au lieu de faire du pas à pas, on peut faire exécuter le programme
en entier, automatiquement, sans avoir besoin ni de cliquer sur une
quelconque icône, ni de taper sur une quelconque touche de raccourci.
Il suffit d’aller dans :
Debug→Run→Animate :
L’arrêt de la simulation peut se faire à tout moment, soit en
cliquant sur l’icône du feu rouge
soit en tapant sur la touche F6.
Dans les deux cas l’on revient au début du programme.
184
Ouverture de fenêtres
En complément à la simulation, vous pourriez avoir besoin de voir
de plus près comment évolue une variable, une adresse, le contenu d’un
compteur ou d’une quelconque zone mémoire.
Pour ce genre d’observation, MPLAB met à disposition un grand
nombre de fenêtres (Windows) spécifiques.
Il suffit d’aller soit dans :
Window
Cette fenêtre permet d’ouvrir les trois fenêtres principales : celle
relative à la pile (Stack Window), celle relative à la RAM (File Register
185
Window), ou celle relative aux registres à usage spécial (Special Function
Register Window).
Sinon on peut aller dans :
Window
↓
Watch Windows
↓
New Watch Window
186
Cette manœuvre ouvre une fenêtre comportant tous les noms des
registres et variables utilisé dans votre programme :
Il suffit de cliquer sur ce qui vous intéresse, pour aussitôt voir
s’ouvrir la fenêtre correspondante, dans laquelle toute variable subissant
une modification au cours de l’exécution du programme, change de
couleur, attirant votre attention.
Il est même possible de suivre l’évolution de plusieurs variables et
d’avoir sous vos yeux, constamment ouvertes, plusieurs fenêtres.
Pour cela, au moyen de l’ascenseur, sélectionnez la ligne
correspondant à ce que vous voulez observer, et terminez - après avoir
éventuellement sélectionné d’autres registres encore - en cliquant sur le
bouton Add, puis sur le bouton Close.
Dès lors, plusieurs fenêtres se positionnent sur l’écran, rangée
l’une derrière l’autre, comme les cartes dans la main d’un joueur, que vous
pouvez rendre actives à souhait.
Faites ensuite avancer le programme en mode pas à pas (F7).
">