Notice préliminaire kit de développement VHAM

Installation du Kit :

   Dézipper l'arborescence. 
   Accepte des répertoires d'accueil "portables" 
   comme Mes documents ou directement sur le bureau.

Environnement de développement Visual HAM :

   Lancer l'application VHAM.exe dans le répertoire vham

Ouvrir un projet ou tester les exemples :

   Menu -> File -> Open Workspace
   Sélectionner un fichier Visual HAM Workspace (*.vhw)
   Les exemples sont dans vham\exemples

   Compiler : touche F5
   Exécuter dans le simulateur VBA : touche F6
   Avant de pouvoir recompiler il faut d'abord fermer VBA

Nouveau projet :

   Commencer par créer un répertoire pour le projet 
   ( avec l'explorateur windows )
   puis dans vham : Menu -> File -> New -> New Project
   Sélectionner armgba
   Donner un nom au projet
   Sélectionner l'emplacement du répertoire [...]

   Pour info, le template armgba est dans vham\templates\project

   Le projet vide doit compiler tel quel (mais ne fait rien)
   Il y a une procédure sans arguments asmProc dans asm.s 
   qui peut être complétée et appelée directement depuis le 
   main avec    asmProc();
   Pour ajouter d'autres sous programmes assembleur dans asm.s 
   utilisables depuis le C il faut ajouter leur prototype dans projet.h
   ( voir exemple_3 )


---------------------------------------------------------------------

Le simulateur VBA :

Pause on/off : ctrl P
Next Frame : ctrl N

Outils à utiliser (menu Tools)

- Disassemble : pour faire de l'exécution pas à pas
  Touche K  (voir Point d'arrêt)

- Logging : ouvre une console qui permet de tracer 
  l'exécution avec les quelques fonctions fournies
  (armgba.h, incarmgba.s ...) voir exemple_3

- Memory Viewer : visualisation et édition mémoire

- Map Viewer : permet de visualiser immédiatement 
  (cliquer sur refresh) le résultat image d'une 
  écriture en RAM vidéo sans avoir à attendre 
  le prochain balayage écran

- IO Viewer : les "registres" d'entrées/sorties
  mappés en mémoire. On utilisera juste pour 
  le mode graphique et l'accès aux touches


---------------------------------------------------------------------

Point d'arrêt (breakpoint) :

Lors d'un appui sur la touche K pendant la simulation
l'exécution est supendue et il est possible d'étudier 
le fonctionnement assembleur instruction par instruction.
Mais il y a peu de chance que l'exécution se trouve au 
niveau du code à étudier.
Le protocole (un peu compliqué) suivant permet d'avoir 
un point d'arrêt au début d'un sous programme assembleur.

VHAM :
Mettre KEYBREAK en début de sous programme assembleur
F5 reconstruire
F6 exécuter
VBA :
L'exécution se trouve suspendue au niveau du keybreak 
Ouvrir IO Viewer et sélectionner 0x4000130-P1 (touches)
Revenir sur la fenêtre VBA principale (cliquer dessus)
Appuyer entrée (laisser enfoncé) appuyer K (Disassemble s'ouvre)
Relacher les touches. 
Cliquer sur Apply dans la fenêtre I/O Viewer.
Revenir sur Disassemble et cliquer next pour 
avancer dans l'exécution en mode pas à pas.
Une fois le bouton Next cliqué on peut utiliser 
la touche entrée pour avancer.
(laisser appuyé pour avance "rapide" dans des boucles)