Wiki MSX Village

Les compilateurs

Fri, 05 Oct 2018 08:20:20 +0200

Les compilateurs assembleur

Il existe plusieurs compilateurs pour assembleur Z80, soit fonctionnant sur MSX, soit fonctionnant sur une machine non MSX, ces derniers étant appelés "cross-compiler" ou "cross-compilateur" (en franglais).

Voici quelques-uns des compilateurs pour langage assembleur :

Assembleurs sur MSX

Compass
HiSoft Development Pack (Gen80)
M.A.D. paru dans Hebdogiciel n°119 et n°120
WBASS2

Cross assembleurs

Grâce à la puissance des ordinateurs actuels, l'assemblage est pratiquement instantané, ce qui constitue un avantage considérable par rapport aux assembleurs MSX natifs. De même, il n'y a aucune restriction sur la taille du code source et il peut être modifié avec n'importe quel éditeur ou traitement de texte.

Pour plus d'informations, voir ce sujet sur les cross-assembleurs

D'autre part cette page fourni un nombre impressionnant d'outils pour le Z80.

Assembleur en ligne

Il existe également cet assembleur Z80 en ligne :
clrhome.org

asMSX

AsMSX est un cross assembleur qui a été développé en langage C par Eduardo A. Robsy Petrus à l'origine en 2000.
Comme son nom l'indique il est spécialisé pour générer des exécutables (.BIN, .ROM, .COM) sur MSX, ce qui est assez rare pour être souligné.

Les sources étant disponibles le compilateur a évolué en passant par différents mainteneurs et donnant lieu à des versions divergentes.
Une version est disponible dans notre village avec quelques corrections et améliorations.

Manuel asMSX

Vous trouverez ici le Manuel asMSX v0.18.5

Versions disponibles

Ci-dessous asMSX disponible en version 0.18.5 pour Linux Ubuntu et Windows 64 bits :

asmsx_v_0_18_5_ubuntu64
asmsx_v_0_18_5_windows64

Caractéristiques

Parmi les points forts de cette version d’asMSX, on peut citer les suivants :

supporte toutes les instructions officielles du Z80 avec la syntaxe de ZILOG.
assemble toutes les instructions non-officielles documentées par Sean Young
comprend la syntaxe de la norme Z80 (accumulateur implicite)
compatible avec différents systèmes de numération (décimal, hexadécimal, octal et binaire)
opérations arithmétiques et logiques, y compris au niveau des codes source
prise en charge des nombres décimaux à virgule flottante, converti en virgule fixe
fonctions mathématiques réelles : trigonométriques, puissances, etc.
accepte de multiples fichiers via des inclusions
inclusion de tout ou partie de ces fichiers binaires
étiquettes locales ou générales pour le code source
déclaration interne des étiquettes routines du Bios du MSX avec leur nom officiel
déclaration interne des étiquettes des variables système du MSX avec leur nom officiel
génération automatisée de fichiers binaires exécutables depuis le Basic
production automatisée de fichiers ROM
supporte 4 types distincts de megaROM : Konami, Konami SCC, ASCII 8 bits et 16 bits
utilisation de variables numériques à l'intérieur de l'assembleur
assemblage de fichiers COM (pour MSX-DOS)
export de la table des symboles
impression de textes indicatifs depuis le code
intégration avec le débogueur de BlueMSX
amélioration de l'assemblage conditionnel
génération de fichiers CAS ou WAV pouvant être chargés sur MSX

Il manque pour l'instant la possibilité de créer des Macros.

Pratique de l'assembleur sur MSX

Fri, 05 Oct 2018 08:14:54 +0200

Introduction

But de cet article

Le but de la section est de permettre à ceux que n'ont pas d'expérience sur la programmation en assembleur sur MSX de trouver les outils, les exemples et les explications permettant de débuter et pour ceux qui pratiquent déjà, d'approfondir leurs connaissances et de participer à l'amélioration et l'enrichissement de ce wiki afin de réunir une base de connaissance sur le sujet.

Pour ceux qui n'ont aucune expérience en programmation l'assembleur n'est pas le langage idéal pour obtenir des résultats spectaculaires rapidement et un gros investissement de temps et de travail de recherche les attend. Il faut donc soit être passionné par la logique et la compréhension de la programmation au plus proche du microprocesseur soit avoir un besoin bien précis et connaître déjà un autre langage de programmation et avoir eu une approche de la logique informatique.

Pourquoi programmer en assembleur sur MSX?

Lorsque nous voulons créer une application, un jeu, réaliser son idée de programme, plusieurs solutions s'offrent à nous ; Le MSX Basic, le C, le Pascal et d'autres.
Le plus facile à mettre en œuvre est le MSX Basic puisqu'il est présent nativement, disponible à l'allumage de l'ordinateur et suffira pour de très nombreux besoins.

Cependant le Basic MSX nécessite la présence en mémoire de l'interpréteur, donc une perte d'espace mémoire, une ressource relativement limitée sur les MSX, d'autant plus que le programme Basic doit être également stocké.
Le Basic MSX étant interprété il nécessitera également un temps de transformation à la volée, c'est à dire lors de l'exécution du programme, ce qui vient grever l'autre ressource limitée des MSX, le temps d'exécution des instructions.

Un programme en langage machine permet donc :
- de disposer de plus de mémoire pour ses besoins,
- de pouvoir accéder à toutes les ressources, dont les périphériques, du MSX,
- de permettre une vitesse d'exécution des instructions au maximum des possibilités de la machine,
- de programmer ses propres commandes DOS,
- de programmer des jeux nécessitant de plus de mémoires (megarom par exemple).

Les compilateurs assembleur

Compilateurs

Les environnements de développement

Environnements de développement

Modèles pour commencer un programme (asMSX)

Modèles pour commencer un programme

Les environnements de développement intégrés (IDE)

Thu, 04 Oct 2018 22:08:47 +0200

Environnements de développement MSX

OpCode IDE

Voici l'atelier de développement OpCode IDE de nos amis brésiliens Objectware Br.
La version 0.2.02 de OpCode IDE est disponible ici : http://www.objectware.net

Il existe trois versions téléchargeables, Windows, Linux et Mac OS. La version Windows s'installe sans problème mais le fichier d'installation Linux est corrompu. Pour installer OpCode sur Linux il faut utiliser l'archive pour Mac OS.

Opcode IDE utilise NetBeans et Glass Z80 assembler/compiler, un compilateur écrit en Java, qui font partie du package d'installation.

Configuration du projet

Le compilateur peut soit être celui par défaut, c'est à dire Glass Z80, soit celui de son choix moyennant la modification de configuration.
Dans "Build and Run options" et "Build Sequence".
Pour générer un fichier .ROM remplir ainsi le paramètre "Enbedded Compiler Arguments" :

Compilation

Voici la compilation du code proposé comme exemple avec l'outil :
Il est nécessaire de se positionner au niveau projet, donc dans l'exemple sur "[sylv]", puis de cliquer sur le marteau "Build project" (ou appuyer sur F11).

Notez que la compilation a fourni ici un exécutable "main.bin" car la compilation a été lancée alors que le fichier "main.asm" était sélectionné.

On obtient alors un fichier "main.rom" comme demandé dans la configuration projet réalisée précédemment.

Modèles de programmes pour démarrer (asMSX)

Thu, 04 Oct 2018 21:48:20 +0200

But de l'article

Cet article présente des modèles de codes source assembleur pour démarrer un programme destiné à être compilé avec asMSX.

Modèle pour créer un exécutable .BIN

Les fichiers .BIN sont exécutables depuis MSX-BASIC

Code ASM :

 
; squelette de départ pour programme BINAIRE
; exécutable à partir du BASIC MSX
; chargement des étiquettes BIOS
; et variables RAM si version asMSX >= 0.18.5
    .BIOS
    .ORG 0xC000
    .BASIC
    .START depart
; début des données du programme = adresse indiquée par .ORG
debut:
    nop ; remplacer 'nop' par des routines si besoin, peut être supprimé
; point d'entrée du programme indiqué par .START
depart:
    nop ; remplacer 'nop' vos instructions d'initialisation si besoin
; boucle infinie à remplacer par votre code
boucle:
    jr boucle

Modèle pour créer un exécutable .COM

Les fichiers .COM sont exécutables depuis MSX-DOS

Code ASM :

 
; squelette de départ pour programme MSX-DOS
; chargement des étiquettes BIOS
; et variables RAM si version asMSX >= 0.18.5
    .BIOS
; directive MSX-DOS origine = 0100h
    .MSXDOS
; début des données et point d'entrée du programme = 0100h
depart:
    nop ; remplacer 'nop' par vos instructions d'initialisation si besoin
; boucle infinie à remplacer par votre code
boucle:
    jr boucle

Modèle pour créer un exécutable .ROM (non Megarom)

Les fichiers .ROM sont destinés à être intégrés aux cartouches pour MSX, cependant ils peuvent être exécutés avec différents outils depuis le MSX-BASIC ou le MSX-DOS.

Code ASM :

 
; squelette de départ pour programme ROM
; chargement des étiquettes BIOS
; et variables RAM si version asMSX >= 0.18.5
    .BIOS
; implémentation du code en page 1
; à modifier selon votre besoin
; .PAGE 0 équivaut à .ORG 0000h
; .PAGE 1 équivaut à .ORG 4000h
; .PAGE 2 équivaut à .ORG 8000h
; .PAGE 3 équivaut à .ORG C000h
    .PAGE 1
    .ROM
    .START depart
; début des données du programme = adresse indiquée par .PAGE + 16 octets (entête ROM)
debut:
    nop ; remplacer 'nop' par vos instructions d'initialisation si besoin
; point d'entrée du programme indiqué par .START
depart:
; search, si page 1 (4000h) est utilisée,
; permet de chercher automatiquement le slot primaire
; et le slot secondaire de la page 2 correspondante (8000h).
    .search
; boucle infinie à remplacer par votre code
boucle:
    jr boucle

Modèle pour créer un exécutable .ROM (Megarom)

Les fichiers .ROM sont destinés à être intégrés aux cartouches pour MSX, cependant ils peuvent être exécutés avec différents outils depuis le MSX-BASIC ou le MSX-DOS.
Les fichiers Megarom nécessitent que la machine dispose de plus de 128 ko de RAM

Code ASM :

 
; squelette de départ pour programme MEGAROM
; chargement des étiquettes BIOS
; et variables RAM si version asMSX >= 0.18.5
    .BIOS
; implémentation du code en page 1
; à modifier selon votre besoin
; .PAGE 0 équivaut à .ORG 0000h
; .PAGE 1 équivaut à .ORG 4000h
; .PAGE 2 équivaut à .ORG 8000h
; .PAGE 3 équivaut à .ORG C000h
    .PAGE 1
    .MEGAROM
    .START depart
; début des données du programme = adresse indiquée par .PAGE + 16 octets (entête ROM)
debut:
    nop ; remplacer 'nop' par vos sous routines si besoin
; point d'entrée du programme indiqué par .START
depart:
; search, si page 1 (4000h) est utilisée,
; permet de chercher automatiquement le slot primaire
; et le slot secondaire de la page 2 correspondante (8000h).
    .search
; boucle infinie à remplacer par votre code
boucle:
    jr boucle