French Version

GPASM : Prise en Main

GPASM fait partie de la suite d'utilitaires GPUTILS . A la différence de l'utilitaire propriétaire de Windows MPASM, il est disponible pour les principales plate-formes telles que Windows, Linux et MacOS. Du coup, une migration de toutes les applications MIOS a été réalisée pour fonctionner avec ce freeware.

A chaque fois que des modifications sont effectuées dans les codes-source d'une application MIOS, celle-ci doit être re-compilée et convertie en fichier .hex - voici un petit guide pas-à-pas:

Téléchargez et installez le contenu de l'archive GPUTILS disponible sur sourceforge.net; l'archive contient le compilateur GPASM.

Ouvrez votre éditeur de texte habituel, ici vous pouvez voir une capture d'écran d'Emacs, mon éditeur préféré sous Windows et Unix. Si tous ne le trouvent pas forcément ergonomique - il reste l'un des éditeurs les plus performants (avec notament des languages de programmation intégrés et un grand nombre d'extensions : explorateur HTML , mail, "newsreader", jeux... ;-) , mais il requiert une longue pratique pour être utilisé efficacement. La version pour Windows peut être téléchargée ici : emacs@Win.
Sous Windows, vous pouvez utiliser Ultraedit , TextPad ou Notepad++

Utilisateurs Windows : une fois les changements effectués dans le code-source, vous devez lancer le script "make.bat" disponible dans l'archive de l'application. Ce script peut être lancé soit, dans l'explorer, en double-cliquant sur le fichier, ou lancé depuis l'invite de commande comme illustré sur la capture d'écran. Le fichier make.bat contient les commandes "gpasm" avec les paramètres spécifiques à l'application.

Utilisateurs Linux/MacOS/etc..: ouvrez une invite de commande, déplacez vous dans le dossier de l'application et entrez la commande "make" - ceci lancera l'execution du Makefile. Avec "make clean", tous les fichiers temporaires à l'exception des fichiers de dump .hex seront supprimés, avec "make cleanall" tous les fichiers générés seront supprimés.

Si le compilateur ne notifie aucune erreur (*), le nouveau fichier .hex peut être uploadé à l'aide de MIOS Studio (voir aussi cette page).

(*)Si GPASM signale des erreurs ou des avertissements, le fichier .hex file NE SERA PAS mis à jour! Dans ce cas, jetez un oeil dans le fichier .err (par ex. main.err) qui contient tous les messages et références aux parties incorrectes du code. Vopus pouvez aussi vérifier le fichier .lst (par ex. main.lst) qui contient le listing complet - plus les erreurs ou des avertissements. Si vous avez compilé le fichier "main.asm", le nom du fichier d'erreurs sera "main.err". Ou si vous avez compilé "setup_8580.asm", le nom du fichier sera "setup_8580.err", etc...

Last update: 2015-09-24